Upgrading AOC via command-line

Preparations before the upgrade

Before upgrading, log in to the AOC virtual machine and run the following commands to confirm the current AOC version and the operating system to prepare for the upgrade along with the server CPU architecture of the cluster running AOC. Replace USER_NAME with the default account name of the AOC virtual machine guest operating system and AOC_IP with the IP of the AOC instance to be upgraded.

ssh USER_NAME@AOC_IP
sudo su
# check aoc version
/usr/share/arcfra/tower/installer/binary/installer info
# check os release version
cat /etc/os-release | grep ^NAME

Download the upgrade package in the tar.gz format based on the server CPU architecture of the cluster running AOC and the host operating system of the AOC virtual machine.

Upgrade steps

The following is an example of upgrading AOC with the upgrade package aoc-0_x_x-v4.8.0.upgrade.centos7.x86_64.tar.gz after downloading it to your local computer. When performing the upgrade, replace aoc-0_x_x-v4.8.0.upgrade.centos7.x86_64.tar.gz with the actual file name of the installation package.

1. Open the terminal command-line tool and run the SCP command to upload the upgrade package to the /usr/share/arcfra folder on the AOC virtual machine to be upgraded. Replace USER_NAME with the default account name of the AOC virtual machine guest operating system and AOC_IP with the IP of the AOC instance to be upgraded.

   scp aoc-0_x_x-v4.7.1.upgrade.centos7.x86_64.tar.gz USER_NAME@AOC_IP:~/
   ssh USER_NAME@AOC_IP
   sudo su
   mv aoc-0_x_x-v4.7.1.upgrade.centos7.x86_64.tar.gz /usr/share/arcfra
   cd /usr/share/arcfra/
   tar xvf aoc-0_x_x-v4.7.1.upgrade.centos7.x86_64.tar.gz

2. Run the following command to upgrade the kernel.

   sh ./4_2_x_upgrade_kernel.sh

   If it returns kernel has been upgraded, skip upgrade, you can proceed directly to step 3. Otherwise, run reboot to restart the virtual machine.

3. Run the following commands to complete the upgrade of AOC.

   ssh USER_NAME@AOC_IP
   sudo su
   cd /usr/share/arcfra/
   sh ./upgrade-cloudtower.sh

   After running the above commands, the system will first pre-check the upgrade environment.

   • If it passes the check, the system will start upgrading AOC.

   • If it fails to pass the check, a failure message will be prompted on the page. In this case, follow the solutions listed in the table below to solve the problem and then upgrade AOC again.

     Failure message	Cause	Solution
     checkDiskSpace	The AOC virtual machine has insufficient disk space.	Free up disk space. You can clear the installation package file named aoc-0_x_x-xxxxx.tar.gz in the path /usr/share/arcfra. run the following commands to upgrade AOC: cd /usr/share/arcfra/ sh ./upgrade-cloudtower.sh
     checkPkgArchDist	The host operating system and CPU architecture of the AOC installation or upgrade file do not match the Linux distribution and the host CPU architecture of the AOC virtual machine.	Run the following commands in sequence to view the Linux distribution version and host CPU architecture of the AOC virtual machine, and re-upload the upgrade file accordingly that meets the requirements. Then follow Step 1-3 again to upgrade AOC. cat /etc/os-release | grep ^ID= arch
     checkVmSpec	The CPU and memory allocated to the AOC virtual machine do not meet the requirements.	Based on the planned AOC configuration level, increase the allocated CPU and memory to the required specifications. Run the following commands to upgrade AOC: cd /usr/share/arcfra/ sh ./upgrade-cloudtower.sh
     checkPackageVersion	The version of the AOC upgrade file is earlier than the current AOC version.	Obtain an AOC upgrade file that is later than the current version and execute the upgrade steps 1-3 again to complete the upgrade.
     checkCAPPDirectoryUsage	The directory in AOC for storing certain system service installation packages exceeds 20 GB.	After deleting the unused system service installation packages on AOC, execute the upgrade steps again to complete the upgrade.
     checkIOWait	AOC virtual machine I/O latency exceeds 30 ms.	After resolving the I/O performance issue, execute the upgrade steps again.
     checkConflictingProcess	The AOC virtual machine contains conflicting process.	After manually terminating the conflicting process on AOC, execute the upgrade steps again to complete the upgrade.
     checkMagicPatch	There are temporary patches in AOC.	After removing temporary patches in AOC, execute the upgrade steps again to complete the upgrade.

   The upgrade process takes approximately 1 hour. During the upgrade process, you can check the upgrade progress and view the logs generated during the process by following the prompt on the top of the AOC homepage to navigate to a standalone upgrade page.

   Once the upgrade is done, you can view the upgrade log in the /var/arcfra/cloudtower/ folder on the AOC virtual machine. If the AOC version is 4.7.0 or later before the upgrade, the upgrade logs will be displayed in the Upgrade history tab on the Arcfra Operation Center upgrade page after the update is completed.

   Information:

   • The default account name of the AOC virtual machine is cloudtower.
   • If the AOC version is 4.6.0 or later before the upgrade, during the upgrade process, the top of the AOC mainpage will prompt Arcfra Operation Center is upgrading. Once the upgrade is completed, you can visit AOC as normal.