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

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

Tip   You can use the steps in this example as a guide when upgrading a multi-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:

Example multi-node topology

Summary of steps

The steps required to perform a multi-node upgrade from API Gateway 7.5.1 to API Gateway 7.6.2 are similar to those required for a multi-node upgrade from 7.3.x or 7.4.x versions as detailed in Multi-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 Gateway 7.6.2 on each node (NodeA, NodeB, and NodeC). Perform the same steps detailed in Step 2 – Install API Gateway 7.6.2 on each node 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 on each node (NodeA, NodeB, and NodeC). Perform the same steps detailed in Step 4 – Run export and upgrade on each node with the following differences:
    • If you are using Apache Cassandra, you must still specify the host name or IP address of the existing external Cassandra database cluster to the upgrade command using the --cass_host option. This is necessary for multi-node upgrades from 7.5.x or 7.6.x to enable all API Gateways to communicate with the external Cassandra server.
    • If you are not using Apache Cassandra, you must still run the upgrade command with the --no_cassandra option.
  5. The following example shows how to run the export and upgrade commands on each node:
> cd /opt/Axway-7.6.2/apigateway/upgrade/bin
> ./sysupgrade export --old_install_dir /opt/Axway-7.5.1/apigateway/ --anm_host NodeA
> ./sysupgrade upgrade --cass_host NodeA
  1. Run apply on the first Admin Node Manager node (NodeA). Perform the same steps detailed in Step 5 – Run apply on the first Admin Node Manager (NodeA) 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 on NodeA:
> cd /opt/Axway-7.6.2/apigateway/upgrade/bin
> ./sysupgrade apply --anm_host NodeA
  1. Run apply on the other nodes in turn (NodeB and then NodeC). Perform the same steps as detailed in Step 6 – Run apply on the other nodes.
  2. The following example shows how to run the apply command on each of the other nodes:
> cd /opt/Axway-7.6.2/apigateway/upgrade/bin
> ./sysupgrade apply --anm_host NodeA
  1. Verify the upgrade as detailed in Step 7 – Verify the upgrade.

Related Links