Updated on 2025-07-18 GMT+08:00

Upgrading the RemoteApp Program

If RemoteApp needs to be upgraded, perform operations in this section.

For Linux and Windows OSs, uninstall the version in use before the upgrade.

Prerequisites

  • You have obtained the account and its password of the server administrator.
  • The /var/lib directory has enough space to install the package on Linux servers.

Upgrading RemoteApp for a Windows Application Server

  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.

Linux Application Server app_publisher

  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

    On the bastion host web page, 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