Arcfra logoDocs
API Doc
Search Docs...
⌘ K
OverviewDeploymentManagementOperationReferenceGlossary

Deploying AOC on a manually-created virtual machine

Prerequisite

  • The AOC installation image in iso format has been downloaded in advance based on the server CPU architecture of the cluster to run AOC.
  • You have planned the IP address, subnet mask, and gateway for AOC.

Precaution

Confirm whether the time zone of the cluster running AOC is consistent with the default time zone of AOC Asia/Shanghai (CST +8:00). If not, it is recommended to modify the timezone during deployment, so that it remains consistent with the timezone of the cluster to run AOC.

Procedure

  1. Enter the virtual management IP of any node in the ACOS (AVE) cluster or the cluster management virtual IP (if configured) in the browser and log in to the Web console management page with the Super administrator root account.

  2. In the left sidebar, select ISO Image in the Compute field, click + Upload ISO Image, and upload the ISO image of AOC.

  3. Create the AOC virtual machine.

    1. In the left sidebar of the Web console management page, select VM in the Compute field, click + Create VM > Create blank VM.

    2. In the Create VM dialog box, enter the virtual machine name.

    3. Set the computing resource parameters for the virtual machine and add a virtual disk. You can take various factors into consideration to configure appropriate computing resource parameters for the AOC virtual machine, such as the number of clusters managed by AOC, the number of hosts and virtual machines, along with the CPU utilization, available memory, and available storage capacity of the cluster.

      Information:

      • When adding virtual disks, make sure the ISO image is mounted after other disks in order.
      • AOC offers two levels: Small and Large. For differences, refer to Determining the AOC configuration level.
      • If you need to deploy the Arcfra Kubernetes Engine in an ACOS cluster through AOC, you must select Large as the configuration level.

      If there are no special requirements, it is recommended to set vCPU allocated to 8, Memory allocated to 19 GB, and Capacity of the virtual volume to 400 GB.

    4. Set other parameters. It is recommended to use the default values preset by the system.

    5. Click Load ISO to load the AOC ISO image.

    6. Click Create to complete configuring the virtual machine.

  4. Complete the installation of the guest operating system in the virtual machine.

    • The default username for the virtual machine guest operation system is cloudtower.

  5. Log in to the virtual machine guest operating system. It is recommended to set a static IP for the management NIC and ensure the connectivity between the AOC virtual machine and the node management IP in the ACOS cluster or the ACOS cluster management virtual IP.

  6. Run the following commands in sequence in the guest operating system of the virtual machine to install AOC.

    sudo bash
cd /usr/share/arcfra/tower
sh ./preinstall.sh
cd ./installer
./binary/installer deploy

    If AOC cannot be accessed through the default virtual IP address (for example, if the virtual machine is bound to multiple IP addresses), you need to run the following commands to install AOC, and replace $VM_IP with an IP address from which AOC can be accessed.

    sudo bash
cd /usr/share/arcfra/tower
sh ./preinstall.sh
cd ./installer
./binary/installer deploy --vip $VM_IP

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

    • If it passes the check, the system will start installing AOC.
    • If it fails to pass the check, a failure message will be prompted on the page. In this case, follow the solutions provided in the table below to resolve the issue and try to install AOC again.
    Failure message Cause Solution
    check-disk-free-space The AOC virtual machine has insufficient disk space.
    1. 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.
    2. Run either of the following commands:
      • ./binary/installer deploy
      • ./binary/installer deploy --vip $VM_IP
    check-distribution 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.

    1. Run the following commands in sequence to view the Linux distribution version and host CPU architecture of the AOC virtual machine.

      cat /etc/os-release | grep ^ID=

      arch

    2. Obtain the installation file that meets the requirements and remount the new ISO image in the created AOC virtual machine.
    3. Follow Step 4-6 again to reinstall AOC.
    check-vm-spec The CPU and memory allocated to the AOC virtual machine do not meet the requirements.
    1. Based on the planned AOC configuration level, increase the allocated CPU and memory to the required specifications.
    2. Then run either of the following commands to reinstall AOC:
      • ./binary/installer deploy
      • ./binary/installer deploy --vip $VM_IP

    The installation process takes approximately 30 minutes. Once done, enter the IP address of the AOC virtual machine in the browser. You should see the AOC initialization page.