Help Center/ Cloud Bastion Host/ User Guide/ Installing an Application Server/ Upgrading the RemoteApp or app_publisher Program
Updated on 2025-09-29 GMT+08:00

Upgrading the RemoteApp or app_publisher Program

After the CBH instance is upgraded, you need to upgrade RemoteApp on Windows application servers or app_publisher on Linux application servers to the new version. Otherwise, the application publishing function cannot work properly. This section describes how to upgrade RemoteApp and app_publisher.

The procedure for upgrading the RemoteApp and app_publisher is as follows: Uninstall the old version and then install the new version.

Prerequisites

Upgrading RemoteApp (for Windows Application Publishing Servers)

  1. Log in to the Windows application publishing server, choose Control Panel > Programs > Programs and Features, and uninstall the earlier version RemoteApp.

    Log in to the bastion host instance and choose Resources > Application > AppServer to view the Windows application server address.

  2. After the uninstallation, upload and decompress the new version RemoteApp installation package.
  3. Double-click setup.exe in the decompressed package to start the installation and complete the installation.

Upgrading app_publisher (for Linux Application Servers)

  1. Log in to the Linux application publishing server, upload the app_publish installation package of the new version, and decompress it.

    tar -zxvf app_publisher_V1.xxxxxxxxxx.tar.gz

    Log in to the bastion host instance and choose Resources > Application > AppServer to view the Linux application server address.

  2. Run the following commands to uninstall the Docker image of the earlier version:

    1
    docker rmi $(docker images -q)
    

    If the message "Error response from daemon: conflict: unable to delete 4852fb6f5512 (cannot be forced) - image is being used by running container xxxx" is displayed when you uninstall an image:

    Run the following commands in sequence to delete container sessions and uninstall the image again:

    1
    2
    docker rm -f $(docker ps -aq)
    docker rmi $(docker images -q)
    

  3. After the uninstallation is complete, run the following commands to install the installation package and image in the app_publish directory of the new version:

    1
    2
    cd app_publisher_V1.xxxxxxx
    ./install.sh
    

    After the installation is complete, if the current bastion host version is 3.3.38.0 or earlier and the app_publisher version is V1.2.0 or earlier, update app_publish to a version later than 1.2.0. Then run the following commands in sequence to manually update the Docker certificate time:

    1
    2
    docker swarm update --cert-expiry 867240h0m0s
    docker swarm ca --rotate