Upgrade on A10 Hardware Appliances

Harmony Controller software can be upgraded on the Hardware appliances and Harmony Controller 2000 and Harmony Controller 8000 are the two models available.

Following four combinations of the appliances are possible:

  1. One Harmony Controller 2000 Appliance
    One VM inside the appliance
  2. Two Harmony Controller 2000 Appliance
    Three total VMs: 2 in one appliance and 1 on other appliance
  3. One Harmony Controller 8000 Appliance
    Three VMs inside the appliance
  4. Two Harmony Controller 8000 Appliance
    Three total VMs: 2 in one appliance and 1 on other appliance

Software Upgrade on one Harmony Controller 2000 Appliance

In case of one Harmony Controller 2000, one VM (node) is placed in the appliance and controller software is upgraded in that VM.

Before You Begin

  1. You need to have an existing installation of A10 Harmony Controller version 4.0.0 or 4.0.1.
  2. You must have root privilege to run the upgrade script.

As devices are registered to controller with Master IP address, suggestion is to move that as floating IP address in order to avoid re-registration. A new IP address that you provide is assigned to the nodezero.

Keep following information handy as this will be needed during the upgrade process:

  1. IP address of NodeZero
    This IP address is assigned to the NodeZero after it is created and note that the IP address cannot be changed.
  2. Internal Subnet
    Assign an internal IP address range of 256 IP address to be used for all internal networks.

Download Upgrade Bundle and Other Packages

Upgrade script bundle needs to be downloaded from the share file location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. Please read them carefully as the information (options, requirements, compatibility etc.) specified in Getting Started guide take precedence over the information provided in this documentation.

Required Docker images and other packages also need to be downloaded and placed in the NodeZero before running the upgrade script. To avoid running out of space during upgrade, the downloaded files should be kept in the same storage volume where the upgrade is planned. Download location is available in Getting Started Guide that is at the same place where the installer package is.

Upgrade Harmony Controller Software

Following are the steps to upgrade Harmony Controller Software on appliance:

  1. Login to the appliance.

  2. Invoke “ssh -i /a10data/nodes/keys/id_rsa admin@<MASTER_VM_IP>” from the appliance to login to the Master VM. For Example:

    [root@sjlabd17-hc8000-2 keys]# ssh -i /a10data/nodes/keys/id_rsa admin@10.6.35.246
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    # mkdir /a10data/upgrade_4.1.0-p1/
    # cd /a10data/upgrade_4.1.0-p1/
    
  4. Untar the upgrade file using:

    # tar -zxvf HarmonyController-4.1.0p1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.1.0-p1/upgrade_package/
    # ./upgrade_harmony_controller.sh
    

The script is interactive and will prompt for information. Follow the on-screen instructions and provide the values.

Note: Harmony Controller services will be unavailable during upgrade. It may take about 90 minutes. However, application traffic will not be impacted.

It is recommended to contact the A10 Customer Support in case of any issues during upgrade.

Next Steps


Software Upgrade of Cluster on two Harmony Controller 2000 Appliances

In case of two Harmony Controller 2000 appliances, three VMs (nodes) are placed in the appliances (two nodes on one appliance and one node on other appliance). The controller software is upgraded in those VMs.

Before You Begin

  1. You need to have an existing installation of A10 Harmony Controller version 4.0.0 or 4.0.1.
  2. You must have root privilege to run the upgrade script.

With this upgrade, the concept of Master node will be removed and all three nodes will become equal. Now they will be called nodezero, nodeone and nodetwo in a 3 node controller deployment.

As devices are registered to controller with Master IP address, suggestion is to move that as floating IP address in order to avoid re-registration. A new IP address that you provide is assigned to the nodezero.

Keep following information handy as this will be needed during the upgrade process:

  1. IP address of NodeZero
    This IP address is assigned to the NodeZero after it is created and note that the IP address cannot be changed.
  2. Internal Subnet
    Assign an internal IP address range of 256 IP address to be used for all internal networks.

You will be logged out of this session at this point and IP address changes will be made as per settings provided by you. The upgrade process will continue after you login again with nodezeroip.

Press any key to logout now and login again to node zero with the new IP address.

Download Upgrade Bundle and Other Packages

Upgrade script bundle needs to be downloaded from the share file location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. Please read them carefully as the information (options, requirements, compatibility etc.) specified in Getting Started guide take precedence over the information provided in this documentation.

Required Docker images and other packages also need to be downloaded and placed in the NodeZero before running the upgrade script. To avoid running out of space during upgrade, the downloaded files should be kept in the same storage volume where the upgrade is planned. Download location is available in Getting Started Guide that is at the same place where the installer package is.

Upgrade Harmony Controller Software

Following are the steps to upgrade Harmony Controller Software on appliance:

  1. Login to the appliance.

  2. Invoke “ssh -i /a10data/nodes/keys/id_rsa admin@<MASTER_VM_IP>” from the appliance to login to the Master VM. For Example:

    [root@sjlabd17-hc8000-2 keys]# ssh -i /a10data/nodes/keys/id_rsa admin@10.6.35.246
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    # mkdir /a10data/upgrade_4.1.0-p1/
    # cd /a10data/upgrade_4.1.0-p1/
    
  4. Untar the upgrade file using:

    # tar -zxvf HarmonyController-4.1.0p1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.1.0-p1/upgrade_package/
    # ./upgrade_harmony_controller.sh
    

The script is interactive and will prompt for information. Follow the on-screen instructions and provide the values.

Note: Harmony Controller services will be unavailable during upgrade. It may take about 90 minutes. However, application traffic will not be impacted.

It is recommended to contact the A10 Customer Support in case of any issues during upgrade.

Next Steps


Software Upgrade of Cluster one Harmony Controller 8000 Appliance

In case of one Harmony Controller 8000, three VMs (nodes) are placed in the appliance and controller software is upgraded in those VMs.

Before You Begin

  1. You need to have an existing installation of A10 Harmony Controller version 4.0.0 or 4.0.1.
  2. You must have root privilege to run the upgrade script.

With this upgrade, the concept of Master node will be removed and all three nodes will become equal. Now they will be called nodezero, nodeone and nodetwo in a 3 node controller deployment.

As devices are registered to controller with Master IP address, suggestion is to move that as floating IP address in order to avoid re-registration. A new IP address that you provide is assigned to the nodezero.

Keep following information handy as this will be needed during the upgrade process:

  1. Floating IP Address

    A floating IP address is assigned to the elected master node. In case this node fails, the floating IP address is automatically moved to the next elected master node. All external communication happens through the floating IP address. This IP address must be an unused IP address in the same subnet as nodes.

    If a default floating IP is used, existing Node Zero IP moved as floating IP and a newer IP is assigned to Node Zero IP. In this case we terminate the SSH connection after the old data backup is done. A Thunder registration and deregistration is not required.

  2. IP address of NodeZero

    This IP address is assigned to the NodeZero after it is created and note that the IP address cannot be changed.

  3. Internal Subnet

    Assign an internal IP address range of 256 IP address to be used for all internal networks.

You will be logged out of this session at this point and IP address changes will be made as per settings provided by you. The upgrade process will continue after you login again with nodezeroip.

Press any key to logout now and login again to node zero with the new IP address.

Download Upgrade Bundle and Other Packages

Upgrade script bundle needs to be downloaded from the share file location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. Please read them carefully as the information (options, requirements, compatibility etc.) specified in Getting Started guide take precedence over the information provided in this documentation.

Required Docker images and other packages also need to be downloaded and placed in the NodeZero before running the upgrade script. To avoid running out of space during upgrade, the downloaded files should be kept in the same storage volume where the upgrade is planned. Download location is available in Getting Started Guide that is at the same place where the installer package is.

Upgrade Harmony Controller Software

Following are the steps to upgrade Harmony Controller Software on appliance:

  1. Login to the appliance.

  2. Invoke “ssh -i /a10data/nodes/keys/id_rsa admin@<MASTER_VM_IP>” from the appliance to login to the Master VM. For Example:

    [root@sjlabd17-hc8000-2 keys]# ssh -i /a10data/nodes/keys/id_rsa admin@10.6.35.246
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    # mkdir /a10data/upgrade_4.1.0-p1/
    # cd /a10data/upgrade_4.1.0-p1/
    
  4. Untar the upgrade file using:

    # tar -zxvf HarmonyController-4.1.0p1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.1.0-p1/upgrade_package/
    # ./upgrade_harmony_controller.sh
    

The script is interactive and will prompt for information. Follow the on-screen instructions and provide the values.

Note: Harmony Controller services will be unavailable during upgrade. It may take about 90 minutes. However, application traffic will not be impacted.

It is recommended to contact the A10 Customer Support in case of any issues during upgrade.

Next Steps


Software Upgrade of Cluster on two Harmony Controller 8000 Appliances

In case of two Harmony Controller 8000 appliances, three VMs (nodes) are placed in the appliances (two nodes on one appliance and one node on other appliance). The controller software is upgraded in those VMs.

Before You Begin

  1. You need to have an existing installation of A10 Harmony Controller version 4.0.0 or 4.0.1.
  2. You must have root privilege to run the upgrade script.

With this upgrade, the concept of Master node will be removed and all three nodes will become equal. Now they will be called nodezero, nodeone and nodetwo in a 3 node controller deployment.

As devices are registered to controller with Master IP address, suggestion is to move that as floating IP address in order to avoid re-registration. A new IP address that you provide is assigned to the nodezero.

Keep following information handy as this will be needed during the upgrade process:

  1. Floating IP Address

    A floating IP address is assigned to the elected master node. In case this node fails, the floating IP address is automatically moved to the next elected master node. All external communication happens through the floating IP address. This IP address must be an unused IP address in the same subnet as nodes.

    If a default floating IP is used, existing Node Zero IP moved as floating IP and a newer IP is assigned to Node Zero IP. In this case we terminate the SSH connection after the old data backup is done. A Thunder registration and deregistration is not required.

  2. IP address of NodeZero

    This IP address is assigned to the NodeZero after it is created and note that the IP address cannot be changed.

  3. Internal Subnet

    Assign an internal IP address range of 256 IP address to be used for all internal networks.

You will be logged out of this session at this point and IP address changes will be made as per settings provided by you. The upgrade process will continue after you login again with nodezeroip.

Press any key to logout now and login again to node zero with the new IP address.

Download Upgrade Bundle and Other Packages

Upgrade script bundle needs to be downloaded from the share file location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. Please read them carefully as the information (options, requirements, compatibility etc.) specified in Getting Started guide take precedence over the information provided in this documentation.

Required Docker images and other packages also need to be downloaded and placed in the NodeZero before running the upgrade script. To avoid running out of space during upgrade, the downloaded files should be kept in the same storage volume where the upgrade is planned. Download location is available in Getting Started Guide that is at the same place where the installer package is.

Upgrade Harmony Controller Software

Following are the steps to upgrade Harmony Controller Software on appliance:

  1. Login to the appliance.

  2. Invoke “ssh -i /a10data/nodes/keys/id_rsa admin@<MASTER_VM_IP>” from the appliance to login to the Master VM. For Example:

    [root@sjlabd17-hc8000-2 keys]# ssh -i /a10data/nodes/keys/id_rsa admin@10.6.35.246
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    # mkdir /a10data/upgrade_4.1.0-p1/
    # cd /a10data/upgrade_4.1.0-p1/
    
  4. Untar the upgrade file using:

    # tar -zxvf HarmonyController-4.1.0p1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.1.0-p1/upgrade_package/
    # ./upgrade_harmony_controller.sh
    

The script is interactive and will prompt for information. Follow the on-screen instructions and provide the values.

Note: Harmony Controller services will be unavailable during upgrade. It may take about 90 minutes. However, application traffic will not be impacted.

It is recommended to contact the A10 Customer Support in case of any issues during upgrade.

Next Steps