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.

AOC_IP refers to the IP address of the AOC virtual machine that you intend to upgrade.

ssh arcfra@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.0.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.0.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. AOC_IP refers to the IP address of the AOC virtual machine that you intend to upgrade.

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

2. Execute the following commands to upgrade Kernel.

   sh ./4_2_x_upgrade_kernel.sh
   reboot

   Note:

   If the message kernel has been upgraded, skip upgrade appears, proceed directly to Step 3. Otherwise, you need to execute the reboot command to restart the virtual machine.

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

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

   After executing the above commands, the system will pre-check the upgrade environment. You can enter the command tail -f nohup.out to view the update log in real time.

   • 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/smartx path. Execute the following command to upgrade AOC: cd /usr/share/smartx/ nohup 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/smartx/ nohup 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.

   After the upgrade is successful, the log will output Update AOC Applications Successfully. After the upgrade is complete, you can view the upgrade log in the /var/arcfra/cloudtower/ folder on the AOC virtual machine.

   Note:

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