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:

  • One Harmony Controller 2000 Appliance

    One VM inside the appliance

  • Two Harmony Controller 2000 Appliance

    Three total VMs: 2 in one appliance and 1 on other appliance

  • One Harmony Controller 8000 Appliance

    Three VMs inside the appliance

  • 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.

Many components have changed from HC-5.1.0 to HC-5.3.0-P1. Hence, upgrade may take about 1 hour to complete for single node controller installation on a physical or virtual machine.

It is recommended to read the steps completely and plan accordingly. Entire procedure is divided into multiple phases.

Planning Phase

  • Check the Controller version

    You need to have an existing installation of HC-5.1.0 for using these instructions.

    Check the Harmony Controller version in Harmony Portal at Help Center > About Harmony Controller > Version.

  • Check Thunder software version

    It is recommended to upgrade controller only when the new version is compatible with the ACOS version Thunders are running. For compatibility information, refer to Compatibility with Thunder ACOS Versions section.

  • Root privilege on the node

    You must have root privilege to run the upgrade script.

Download Upgrade Bundle

Upgrade script bundle needs to be downloaded from the sharefile location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. 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 Node 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.

For example, all three downloaded files can be placed in /root/a10hc-5.3.0-P1 directory on the Linux machine running Harmony Controller.

Before You Begin

  • Make sure all tasks in Planning Phase are complete and Download Upgrade Bundle is done.

  • Keep following information ready:

    • Password for super-admin

      Any password can be kept as per the password policy displayed.

    • Tar File Path

      Path of the directory where Docker images and other package are kept on the NodeZero.

Upgrade Harmony Controller Software

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

  1. Log in 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:

    $ sudo su
    $ ssh -i /a10data/nodes/keys/id_rsa admin@<MASTER_VM_IP>
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    $ sudo mkdir /a10data/upgrade_5.3.0/
    $ cd /a10data/upgrade_5.3.0/
    
  4. Untar the file using:

    $ sudo tar -zxvf HC-5.3.0-install-GA.tar.gz
    
  5. Execute the following command to start the upgrade script:

    $ cd /a10data/upgrade_5.3.0/a10-harmony-controller-HC-5.3.0/upgrade_package/
    $ sudo ./UpgradeHC.sh
    

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

Note

After upgrade script completes, Harmony Controller services will be available. However, old analytics data will be migrated to new format in the background. This will take long time (a few hours) based on the amount of configuration data.

During the data migration, Harmony portal will display the newly collected data accurately, but old data may not represent the correct state at that point in time because all the data is still not available for display.

Warning

Do not restart or reboot the Harmony Controller when migration is still in progress.

Next Steps

  • If not already done, configure SSL certificates for FQDN using A10 Harmony Controller Operator Console in the Certificate section under Configuration Management.

  • Map FQDN to Node IP address in the DNS manager.

  • Complete Email Server Configuration using A10 Harmony Controller Operator Console in the Email section under Configuration Management.

  • Setup scripts for transferring scheduled backup files to external storage as described in maintenance information.

  • Manually reset the provider-admin password using Adding a Provider, once the upgrade is complete.

  • Back-up all the registered devices.


Software Upgrade of Cluster on three Harmony Controller 2000 Appliances

In case of three 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.

Many components have changed from HC-5.1.0 to HC-5.3.0-P1. Hence, upgrade may take about 3 hours to complete for three node controller installation on a physical or virtual machine.

It is recommended to read the steps completely and plan accordingly. Entire procedure is divided into multiple phases.

Planning Phase

  • Check the Controller version

    You need to have an existing installation of HC-5.1.0 for using these instructions.

    Check the Harmony Controller version in Harmony Portal at Help Center > About Harmony Controller > Version.

  • Check Thunder software version

    It is recommended to upgrade controller only when the new version is compatible with the ACOS version Thunders are running. For compatibility information, refer to Compatibility with Thunder ACOS Versions section.

  • Root privilege on the node

    You must have root privilege to run the upgrade script.

  • Arrange additional storage

    Additional storage space is required as per hardware and storage-setup sections.

Download Upgrade Bundle

Upgrade script bundle needs to be downloaded from the sharefile location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. 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.

For example, all three downloaded files can be placed in /root/a10hc-5.3.0-P1 directory on the Linux machine running Harmony Controller.

Before You Begin

  • Make sure all Planning Phase and Download Upgrade Bundle points are met.

  • Keep following information ready:

    • Password for super-admin

      Any password can be kept as per the password policy displayed.

    • Tar File Path

      Path of the directory where Docker images and other package are kept on the NodeZero. This is asked only when files are not found in the parent directory of the installer.

    • Unmounted partition or disks for NodeZero

      As described in storage-setup, A10 HarmonyTM Controller supports High Availability (HA). This storage partition is to be kept unmounted during installation of Operating System. Unmounted partition or disks where A10 HarmonyTM Controller should be installed is to be provided for NodeZero.

    • Unmounted partition or disks for NodeOne

      As described in storage-setup, A10 HarmonyTM Controller supports High Availability (HA). This storage partition is to be kept unmounted during installation of Operating System. Unmounted partition or disks where A10 HarmonyTM Controller should be installed is to be provided for NodeOne.

    • Unmounted partition or disks for NodeTwo

      As described in storage-setup, A10 HarmonyTM Controller supports High Availability (HA). This storage partition is to be kept unmounted during installation of Operating System. Unmounted partition or disks where A10 HarmonyTM Controller should be installed is to be provided for NodeTwo.

Upgrade Harmony Controller Software

On a working Harmony Controller HC-5.1.0 deployment, follow the below steps:

  1. Log in to the Appliance0.

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

    $ sudo ssh -i /a10data/nodes/keys/id_rsa admin@MASTER_VM_IP
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    $ sudo mkdir /a10data/upgrade_5.3.0/
    $ cd /a10data/upgrade_5.3.0/
    
  4. Untar the file using:

    $ sudo tar -zxvf HC-5.3.0-install-GA.tar.gz
    
  5. Copy the keys using:

    $ sudo mkdir /a10harmony/keys
    $ sudo cp /a10data/keys/id_rsa /a10harmony/keys/
    $ sudo chown admin:admin /a10harmony/keys/id_rsa
    
  6. Copy attach_disk.sh script to all the three appliances using:

    $ scp a10-harmony-controller-HC-5.3.0/upgrade_package/attach_disk.sh admin@<Appliance0_IP>:/home/admin/
    $ scp a10-harmony-controller-HC-5.3.0/upgrade_package/attach_disk.sh admin@<Appliance1_IP>:/home/admin/
    $ scp a10-harmony-controller-HC-5.3.0/upgrade_package/attach_disk.sh admin@<Appliance2_IP>:/home/admin/
    
  7. Log out of Node0 VM using:

    $ exit
    

8a. Log in to Appliance0 and run the command:

$ sudo /home/admin/attach_disk.sh
$ exit

This step will create an unmounted partition (/dev/vdb) to be used during upgrade.

8b. Log in to Appliance1 and run the command:

$ sudo /home/admin/attach_disk.sh
$ exit

This step will create an unmounted partition (/dev/vdb) to be used during upgrade.

8c. Log in to Appliance2 and run the command:

$ sudo /home/admin/attach_disk.sh
$ exit

This step will create an unmounted partition (/dev/vdb) to be used during upgrade.

  1. Log in to Node0 VM and execute the following command to start the upgrade:

    $ cd /a10data/upgrade_5.3.0/a10-harmony-controller-HC-5.3.0/upgrade_package/
    $ sudo ./UpgradeHC.sh
    

Note

For an appliance when prompted to continue, ignore the warning message and choose an option as yes only.

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

Note

After upgrade script completes, Harmony Controller services will be available. However, old analytics data will be migrated to new format in the background. This will take long time (a few hours) based on the amount of configuration data.

During the data migration, Harmony portal will display the newly collected data accurately, but old data may not represent the correct state at that point in time because all the data is still not available for display.

Warning

Do not restart or reboot the Harmony Controller when migration is still in progress.

Next Steps

  • If not already done, configure SSL certificates for FQDN using A10 Harmony Controller Operator Console in the Certificate section under Configuration Management.

  • Map FQDN to Node IP address in the DNS manager.

  • Complete Email Server Configuration using A10 Harmony Controller Operator Console in the Email section under Configuration Management.

  • Setup scripts for transferring scheduled backup files to external storage as described in maintenance information.

  • Manually reset the provider-admin password using Adding a Provider, once the upgrade is complete.

  • Back-up all the registered devices.


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.

Many components have changed from HC-5.1.0 to HC-5.3.0-P1. Hence, upgrade may take about 1 hour to complete for single node controller installation on a physical or virtual machine.

It is recommended to read the steps completely and plan accordingly. Entire procedure is divided into multiple phases.

Planning Phase

  • Check the Controller version

    You need to have an existing installation of HC-5.1.0 for using these instructions.

    Check the Harmony Controller version in Harmony Portal at Help Center > About Harmony Controller > Version.

  • Check Thunder software version

    It is recommended to upgrade controller only when the new version is compatible with the ACOS version Thunders are running. For compatibility information, refer to Compatibility with Thunder ACOS Versions section.

  • Root privilege on the node

    You must have root privilege to run the upgrade script.

Download Upgrade Bundle

Upgrade script bundle needs to be downloaded from the sharefile location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. 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 Node 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.

For example, all three downloaded files can be placed in /root/a10hc-5.3.0-P1 directory on the Linux machine running Harmony Controller.

Before You Begin

  • Make sure all tasks in Planning Phase are complete and Download Upgrade Bundle is done.

  • Keep following information ready:

    • Password for super-admin

      Any password can be kept as per the password policy displayed.

    • Tar File Path

      Path of the directory where Docker images and other package are kept on the NodeZero.

Upgrade Harmony Controller Software

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

  1. Log in 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:

    $ sudo su
    $ ssh -i /a10data/nodes/keys/id_rsa admin@<MASTER_VM_IP>
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    $ sudo mkdir /a10data/upgrade_5.3.0/
    $ cd /a10data/upgrade_5.3.0/
    
  4. Untar the file using:

    $ sudo tar -zxvf HC-5.3.0-install-GA.tar.gz
    
  5. Execute the following command to start the upgrade script:

    $ cd /a10data/upgrade_5.3.0/a10-harmony-controller-HC-5.3.0/upgrade_package/
    $ sudo ./UpgradeHC.sh
    

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

Note

After upgrade script completes, Harmony Controller services will be available. However, old analytics data will be migrated to new format in the background. This will take long time (a few hours) based on the amount of configuration data.

During the data migration, Harmony portal will display the newly collected data accurately, but old data may not represent the correct state at that point in time because all the data is still not available for display.

Warning

Do not restart or reboot the Harmony Controller when migration is still in progress.

Next Steps

  • If not already done, configure SSL certificates for FQDN using A10 Harmony Controller Operator Console in the Certificate section under Configuration Management.

  • Map FQDN to Node IP address in the DNS manager.

  • Complete Email Server Configuration using A10 Harmony Controller Operator Console in the Email section under Configuration Management.

  • Setup scripts for transferring scheduled backup files to external storage as described in maintenance information.

  • Manually reset the provider-admin password using Adding a Provider, once the upgrade is complete.

  • Back-up all the registered devices.


Software Upgrade of Cluster on three Harmony Controller 8000 Appliances

In case of three 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.

Many components have changed from HC-5.1.0 to HC-5.3.0-P1. Hence, upgrade may take about 3 hours to complete for three node controller installation on a physical or virtual machine.

It is recommended to read the steps completely and plan accordingly. Entire procedure is divided into multiple phases.

Planning Phase

  • Check the Controller version

    You need to have an existing installation of HC-5.1.0 for using these instructions.

    Check the Harmony Controller version in Harmony Portal at Help Center > About Harmony Controller > Version.

  • Check Thunder software version

    It is recommended to upgrade controller only when the new version is compatible with the ACOS version Thunders are running. For compatibility information, refer to Compatibility with Thunder ACOS Versions section.

  • Root privilege on the node

    You must have root privilege to run the upgrade script.

  • Arrange additional storage

    Additional storage space is required as per hardware and storage-setup sections.

Download Upgrade Bundle

Upgrade script bundle needs to be downloaded from the sharefile location provided in the email from A10. The sharefile location contains Release Notes and Getting Started guide for the requested version of software. 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.

For example, all three downloaded files can be placed in /root/a10hc-5.3.0-P1 directory on the Linux machine running Harmony Controller.

Before You Begin

  • Make sure all Planning Phase and Download Upgrade Bundle points are met.

  • Keep following information ready:

    • Password for super-admin

      Any password can be kept as per the password policy displayed.

    • Tar File Path

      Path of the directory where Docker images and other package are kept on the NodeZero. This is asked only when files are not found in the parent directory of the installer.

    • Unmounted partition or disks for NodeZero

      As described in storage-setup, A10 HarmonyTM Controller supports High Availability (HA). This storage partition is to be kept unmounted during installation of Operating System. Unmounted partition or disks where A10 HarmonyTM Controller should be installed is to be provided for NodeZero.

    • Unmounted partition or disks for NodeOne

      As described in storage-setup, A10 HarmonyTM Controller supports High Availability (HA). This storage partition is to be kept unmounted during installation of Operating System. Unmounted partition or disks where A10 HarmonyTM Controller should be installed is to be provided for NodeOne.

    • Unmounted partition or disks for NodeTwo

      As described in storage-setup, A10 HarmonyTM Controller supports High Availability (HA). This storage partition is to be kept unmounted during installation of Operating System. Unmounted partition or disks where A10 HarmonyTM Controller should be installed is to be provided for NodeTwo.

Upgrade Harmony Controller Software

On a working Harmony Controller HC-5.1.0 deployment, follow the below steps:

  1. Log in to the Appliance0.

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

    $ sudo ssh -i /a10data/nodes/keys/id_rsa admin@MASTER_VM_IP
    
  3. Create the directory under /a10data/ and download all the upgrade packages under that folder:

    $ sudo mkdir /a10data/upgrade_5.3.0/
    $ cd /a10data/upgrade_5.3.0/
    
  4. Untar the file using:

    $ sudo tar -zxvf HC-5.3.0-install-GA.tar.gz
    
  5. Copy the keys using:

    $ sudo mkdir /a10harmony/keys
    $ sudo cp /a10data/keys/id_rsa /a10harmony/keys/
    $ sudo chown admin:admin /a10harmony/keys/id_rsa
    
  6. Copy attach_disk.sh script to all the three appliances using:

    $ scp a10-harmony-controller-HC-5.3.0/upgrade_package/attach_disk.sh admin@<Appliance0_IP>:/home/admin/
    $ scp a10-harmony-controller-HC-5.3.0/upgrade_package/attach_disk.sh admin@<Appliance1_IP>:/home/admin/
    $ scp a10-harmony-controller-HC-5.3.0/upgrade_package/attach_disk.sh admin@<Appliance2_IP>:/home/admin/
    
  7. Log out of Node0 VM using:

    $ exit
    

8a. Log in to Appliance0 and run the command:

$ sudo /home/admin/attach_disk.sh
$ exit

This step will create an unmounted partition (/dev/vdb) to be used during upgrade.

8b. Log in to Appliance1 and run the command:

$ sudo /home/admin/attach_disk.sh
$ exit

This step will create an unmounted partition (/dev/vdb) to be used during upgrade.

8c. Log in to Appliance2 and run the command:

$ sudo /home/admin/attach_disk.sh
$ exit

This step will create an unmounted partition (/dev/vdb) to be used during upgrade.

  1. Log in to Node0 VM and execute the following command to start the upgrade:

    $ cd /a10data/upgrade_5.3.0/a10-harmony-controller-HC-5.3.0/upgrade_package/
    $ sudo ./UpgradeHC.sh
    

Note

For an appliance when prompted to continue, ignore the warning message and choose an option as yes only.

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

Note

After upgrade script completes, Harmony Controller services will be available. However, old analytics data will be migrated to new format in the background. This will take long time (a few hours) based on the amount of configuration data.

During the data migration, Harmony portal will display the newly collected data accurately, but old data may not represent the correct state at that point in time because all the data is still not available for display.

Warning

Do not restart or reboot the Harmony Controller when migration is still in progress.

Next Steps

  • If not already done, configure SSL certificates for FQDN using A10 Harmony Controller Operator Console in the Certificate section under Configuration Management.

  • Map FQDN to Node IP address in the DNS manager.

  • Complete Email Server Configuration using A10 Harmony Controller Operator Console in the Email section under Configuration Management.

  • Setup scripts for transferring scheduled backup files to external storage as described in maintenance information.

  • Manually reset the provider-admin password using Adding a Provider, once the upgrade is complete.

  • Back up all the registered devices.