Upgrading to the latest release level

Updates to Z APM Connect V6.1.1 are delivered as cumulative fix packs. These fixes provide changes to Z APM Connect Distributed Gateway that resolve known issues, add new functionality, enhance secure communications, and improve application scalability. You can download the fix packs from IBM Fix Central.

To upgrade Z APM Connect Distributed Gateway, follow the steps below.

Note: If you are upgrading from any release level lower than V6.1.0 fix pack 8, uninstall that fix pack first and then install the latest V6.1.1 fix pack. It is recommended that you first back up any certificates and configuration files before installing the latest release. After you complete the backup and uninstall the previous fix pack, see How-to Guide to install and configure the latest release.

Procedure

  1. Download the latest fix pack and move it to the directory where the previous version is installed.

    The installation directory /opt/ibm is used as an example.

    mv ./6.1.1-TIV-INSTANA-FP00007-standalone.tar.gz  /opt/ibm/
    cd /opt/ibm
  2. Extract the tar file by running the following command:

    tar -xvzf 6.1.1-TIV-INSTANA-FP00007-standalone.tar.gz 
  3. Install the latest version with the following command:

    sudo ./zapmctl install --update

    The above command will add all of the latest Z APM Connect images to the local image repository and will ask about restarting the Z APM for Instana DG. It will not remove any previous configuration, certificates, or saved logs.

    For more details on the install --update subcommand usage, see Subcommand: install --update.