Single-node upgrade example (upgrades from 7.5.x or 7.6.x)

This topic provides an example of a single-node domain upgrade from API Gateway version 7.5.x or 7.6.x (in this case, 7.5.1) to API Gateway7.6.2.

Tip   You can use the steps in this example as a guide when upgrading a single-node domain from API Gateway 7.5.x or 7.6.x to 7.6.2. However, you must remember to modify the steps appropriately for your version and topology.

Sample upgrade topology

The sample topology used in this example is as follows:

Single-node topology

Summary of steps

The steps required to perform a single-node upgrade from API Gateway 7.5.1 to API Gateway 7.6.2 are similar to those required for a single-node upgrade from 7.3.x or 7.4.x versions as detailed in Single-node upgrade example (upgrades from 7.3.x or 7.4.x), with a few significant differences. This section summarizes the steps and highlights the differences:

  1. Perform the checks on your old API Gateway 7.5.1 installation, as detailed in Checklist for the old API Gateway installation.
    • No Apache Cassandra checks are necessary on the old installation, as the external Cassandra configuration is retained when upgrading from 7.5.x or 7.6.x.
  2. Install API Gateway7.6.2. Perform the same steps detailed in Step 2 – Install API Gateway 7.6.2 with the following differences:
    • Do not select Cassandra in the Custom installation.
  3. When the installation is complete, perform the new installation checks detailed in Checklist for the new API Gateway 7.6.2 installation.
  4. Run the export and upgrade commands. Perform the same steps detailed in Step 4 – Run export and upgrade commands with the following differences:
    • If you are using Apache Cassandra, you do not need to specify the host name or IP address of the existing external Cassandra database cluster to the upgrade command (the Cassandra configuration is retained when upgrading from 7.5.x or 7.6.x).
    • If you are not using Apache Cassandra, you do not need to run the upgrade command with the --no_cassandra option
  5. The following example shows how to run the export and upgrade commands:
> cd /opt/Axway-7.6.2/apigateway/upgrade/bin
> ./sysupgrade export --old_install_dir /opt/Axway-7.5.1/apigateway/
> ./sysupgrade upgrade
  1. Run the apply command. Perform the same steps detailed in Step 5 – Run apply command with the following differences:
    • You do not need to update the cassandra.yaml file or start Cassandra, as Cassandra should already be running.
  2. The following example shows how to run the apply command:
> cd /opt/Axway-7.6.2/apigateway/upgrade/bin
> ./sysupgrade apply
  1. Verify the upgrade as detailed in Step 6 – Verify the upgrade.

Related Links