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. Three Harmony Controller 2000 Appliance
    Three total VMs: 1 in each appliance
  3. One Harmony Controller 8000 Appliance
    One VMs inside the appliance
  4. Three Harmony Controller 8000 Appliance
    Three total VMs: 1 in each 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.2.1p1.
  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@<Node0_VM_IP>” from the appliance to login to the Node0. 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.1p2/
    # cd /a10data/upgrade_4.2.1p2/
    
  4. Untar the upgrade file using:

    # tar -xvf HarmonyController-4.2.1p2-upgrade-HC-4.2.1p2.tar.gz
    
  5. Run load_docker_images.sh script to load the images:

    # ./load_docker_images.sh -m HarmonyController-4.2.1p2-management-HC-4.2.1p2.tar.gz -a HarmonyController-4.2.1p2-analytics-HC-4.2.1p2.tar.gz -t rel-4.2.1p2
    
  6. Run upgrade script:

    # cd /a10data/ upgrade_4.2.1p2/upgrade_package/
    # ./upgradehc.sh -t rel-4.2.1p2
    

Note: Harmony Controller services will be unavailable during upgrade. It may take about 10 to 15 minutes. Importing upgrade image might take around 30 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.2.1p1.
  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@<Node0_VM_IP>” from the appliance to login to the Node0 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 for all the nodes:

    # mkdir /a10data/upgrade_4.2.1p2/
    # cd /a10data/upgrade_4.2.1p2/
    
  4. Untar the upgrade file on all the nodes using:

    # tar -xvf HarmonyController-4.2.1p2-upgrade-HC-4.2.1p2.tar.gz
    
  5. Run load_docker_images.sh script on all the nodes to load the images:

    # ./load_docker_images.sh -m HarmonyController-4.2.1p2-management-HC-4.2.1p2.tar.gz -a HarmonyController-4.2.1p2-analytics-HC-4.2.1p2.tar.gz -t rel-4.2.1p2
    
  6. Run upgrade script only on Node0:

    # cd /a10data/ upgrade_4.2.1p2/upgrade_package/
    # ./upgradehc.sh -t rel-4.2.1p2
    

Note: Harmony Controller services will be unavailable during upgrade. It may take about 10 to 15 minutes. Importing upgrade image might take around 30 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.2.1p1.
  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@<Node0_VM_IP>” from the appliance to login to the Node0 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.1p2/
    # cd /a10data/upgrade_4.2.1p2/
    
  4. Untar the upgrade file using:

    # tar -xvf HarmonyController-4.2.1p2-upgrade-HC-4.2.1p2.tar.gz
    
  5. Run load_docker_images.sh script to load the images:

    # ./load_docker_images.sh -m HarmonyController-4.2.1p2-management-HC-4.2.1p2.tar.gz -a HarmonyController-4.2.1p2-analytics-HC-4.2.1p2.tar.gz -t rel-4.2.1p2
    
  6. Run upgrade script:

    # cd /a10data/ upgrade_4.2.1p2/upgrade_package/
    # ./upgradehc.sh -t rel-4.2.1p2
    

Note: Harmony Controller services will be unavailable during upgrade. It may take about 10 to 15 minutes. Importing upgrade image might take around 30 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.2.1p1.
  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@<Node0_VM_IP>” from the appliance to login to the Node0 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 for all the nodes:

    # mkdir /a10data/upgrade_4.2.1p2/
    # cd /a10data/upgrade_4.2.1p2/
    
  4. Untar the upgrade file on all the nodes using:

    # tar -xvf HarmonyController-4.2.1p2-upgrade-HC-4.2.1p2.tar.gz
    
  5. Run load_docker_images.sh script on all the nodes to load the images:

    # ./load_docker_images.sh -m HarmonyController-4.2.1p2-management-HC-4.2.1p2.tar.gz -a HarmonyController-4.2.1p2-analytics-HC-4.2.1p2.tar.gz -t rel-4.2.1p2
    
  6. Run upgrade script only on Node0:

    # cd /a10data/ upgrade_4.2.1p2/upgrade_package/
    # ./upgradehc.sh -t rel-4.2.1p2
    

Note: Harmony Controller services will be unavailable during upgrade. It may take about 10 to 15 minutes. Importing upgrade image might take around 30 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