Upgrading the App Host

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

Before you begin

Before you start the upgrade, verify the version of your App Host.

sudo 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: App Host V1.15.1.1 does not support RHEL7. To migrate from an older system, see New in 51.0.0.0 Migrating App Hosts between appliances. 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.

About this task

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

Note: If you are also upgrading the system from RHEL 7 to RHEL 8, refer to the Upgrading from RHEL 7 to RHEL 8 document for instructions.

Procedure

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.
```
sudo bash apphost-<version>.run
```
If you are upgrading the App Host virtual appliance, install the security updates.
```
sudo bash apphost-ova-security-update-<version>.run
```
When your App Host environment is upgraded, you need to upgrade your instances of App Host as follows.
```
sudo 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.
```
sudo manageAppHost upgrade registry --registry <registry_URL> --user <username>
```
You are prompted to select the instances to upgrade or to upgrade them all.

Results

The upgrade of the App Host proceeds.

After you upgrade your App Hosts, each app needs to be restarted.