Upgrade the App Host

The upgrade procedure applies to both the virtual appliance and stand-alone variations of the App Host.

Before you start the upgrade, verify the version of your App host.
manageAppHost --version

See IBM Support Fix Central to acquire the software package.

If you are upgrading the App Host virtual appliance, the security updates and optional packages are included in the App Host software package by default. However, you can select a different download option so that you can download each package separately.

Note: The V1.6.1 App Host introduces changes to the proxy server setting. If you have a proxy server setting, the upgrade might set the HTTP_PROXY and HTTPS_PROXY to the same value. Make sure that the values are correct after the upgrade.

Complete the following steps to upgrade your App Host platform. You must be the root user to run the commands.

  1. Enter the following command to install the file that you acquired from IBM Security. Enter the actual version number (typically in the format x.x.x) in the file name.
    bash apphost-<version>.run
  2. If you are upgrading the App Host virtual appliance, install the security updates.
    sudo bash apphost-appliance-security-update-<version>.run
  3. When your App Host environment is upgraded, you need to upgrade your instances of App Host as follows.
    manageAppHost upgrade
    If you are upgrading App Host in an air gap environment, you need to enter the URL to the repository, also called a registry. If the private repository requires authentication, use the --user option to enter the account username; you are prompted for the password.
    manageAppHost upgrade registry --registry <registry_URL> --user <username>

    You are prompted to select the instances to upgrade or to upgrade them all.

The upgrade of the App Host proceeds.

The release resolves a potential security issue concerning using root groups to access Kubernetes containers. After upgrading your App Hosts, each app needs to be restarted.