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.1.0p1 or 4.2.0.
  2. You must have root privilege to run the upgrade script.

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.2.1/
    # cd /a10data/upgrade_4.2.1/
    
  4. Untar the upgrade file using:

    # tar -xvf HarmonyController-4.2.1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.2.1/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.1.0p1 or 4.2.0.
  2. You must have root privilege to run the upgrade script.

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.2.1/
    # cd /a10data/upgrade_4.2.1/
    
  4. Untar the upgrade file using:

    # tar -xvf HarmonyController-4.2.1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.2.1/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.1.0p1 or 4.2.0.
  2. You must have root privilege to run the upgrade script.

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.2.1/
    # cd /a10data/upgrade_4.2.1/
    
  4. Untar the upgrade file using:

    # tar -xvf HarmonyController-4.2.1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.2.1/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.1.0p1 or 4.2.0.
  2. You must have root privilege to run the upgrade script.

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.2.1/
    # cd /a10data/upgrade_4.2.1/
    
  4. Untar the upgrade file using:

    # tar -xvf HarmonyController-4.2.1-upgrade.tar.gz
    
  5. Execute the following command to start the upgrade script:

    # cd /a10data/ upgrade_4.2.1/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