Upgrading AOC

When upgrading Arcfra Operation Center (AOC), the service needs to be restarted, which temporarily makes AOC inaccessible. However, clusters managed by AOC will have no impact.

Preparations before the upgrade

Before proceeding with the upgrade, log in to the AOC virtual machine and execute the following commands. Then verify the current AOC version and the host operating system, and prepare accordingly based on the cluster's CPU architecture.

Replace USER_NAME with the default account name of the AOC virtual machine guest operating system and AOC_IP with the actual 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, depending on the cluster's CPU architecture and the host operating system of the AOC virtual machine.

Upgrade steps

The following shows how to upgrade AOC using the software upgrade package aoc-0_x_x-v4.4.3.upgrade.centos7.x86_64.tar.gz as an example. Before proceeding, make sure the necessary upgrade package is downloaded. When performing upgrade, replace aoc-0_x_x-v4.4.3.upgrade.centos7.x86_64.tar.gz with the actual software upgrade file name.

1. Open the terminal command line tool and use the SCP command to upload the software upgrade file 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.4.3.upgrade.centos7.x86_64.tar.gz USER_NAME@AOC_IP:~/
   ssh USER_NAME@AOC_IP
   sudo su
   mv aoc-0_x_x-v4.4.3.upgrade.centos7.x86_64.tar.gz /usr/share/arcfra
   cd /usr/share/arcfra/
   tar xvf aoc-0_x_x-v4.4.3.upgrade.centos7.x86_64.tar.gz

2. Execute the following commands to upgrade 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. Execute 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 the check passes, the system will start upgrading AOC.

   • If the check fails, a failure message will be output in the log. Follow the solutions listed in the table below to solve the problem and then upgrade AOC again.

     Failure information	Cause	Solution
     check-disk-free-space	The AOC virtual machine has insufficient disk space.	Clean the disk. You can clean the 0_x_x-xxxxx.tar.gz installation package file in the /usr/share/arcfra path. Execute the following command to upgrade AOC: cd /usr/share/arcfra/ sh ./upgrade-cloudtower.sh
     check-distribution	The host operating system and CPU architecture of the AOC upgrade file do not match the Linux distribution and the host CPU architecture of the AOC virtual machine.	Execute the following commands in sequence to obtain the Linux distribution version and host CPU architecture of the AOC virtual machine, and upload the upgrade file that meets the requirements again. Then repeat Step 1-3 to upgrade. cat /etc/os-release | grep ^ID= arch
     check-vm-spec	The CPU and memory allocated to the AOC virtual machine do not meet the requirements.	According to the planned AOC configuration level, expand the CPU and memory to the required size. Then execute the following command to upgrade AOC: cd /usr/share/arcfra/ sh ./upgrade-cloudtower.sh
     check-pkg-version	The version of the AOC upgrade file is lower than the current version.	Get a AOC upgrade file that is later than the current version and execute the upgrade steps again to complete the upgrade.

   The upgrade process takes approximately 30 minutes. After the upgrade completes, the page will prompt a success message. In addition, you can view the upgrade log in the /var/log/cloudtower/ folder on the AOC virtual machine.

   Note:

   The default account name of the AOC virtual machine is cloudtower.