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

Deploying AOC on a manually-created virtual machine

Prerequisites

  • The AOC installation file is already downloaded. Ensure that the installation file is in the ISO format.
  • You have planned the IP address, subnet mask, and gateway for 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 navigation bar, select Compute > ISO Image, click Upload ISO Image, and upload the ISO image of AOC.

  3. Create the AOC virtual machine.

    1. In the left navigation bar of the web console, select Compute > VM, click Create VM, and select Create blank VM.

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

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

      Note:

      • When adding virtual disks, make sure to mount the ISO image below other disks.
      • AOC has two configuration levels: Low configurations and High configurations. For the differences, refer to Determining the AOC configuration level.
      • If you need to deploy Arcfra Kubernetes Engine (AKE) or Arcfra File Storage (AFS) in an ACOS cluster through AOC, you must select High configurations as the configuration level.

      If you have no special requirements, it is recommended that vCPU allocated be set to 8 vCPU, Memory allocated be set to 19 GiB, and Capacity of the virtual volume be set to 400 GiB.

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

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

    6. Click Create to complete the virtual machine setup.

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

    • The default username for the virtual machine guest operating 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. In the virtual machine's guest operating system, execute the following commands in sequence to install AOC.

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

    If you cannot access AOC using the default virtual IP (for example, if the virtual machine has multiple IP addresses assigned), you need to run the following command to install AOC. $VM_IP refers to the IP address that can access AOC.

    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 the check passes, the system will start installing AOC.

    • If the check fails, a failure message will be output in the log. Follow the solutions provided in the table below to resolve the issue to solve the problem and install AOC again.

      Failure information 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 0_x_x-xxxxx.tar.gz in the path /usr/share/arcfra.
      2. Execute any of the following commands to reinstall AOC:
        • ./binary/installer deploy
        • ./binary/installer deploy --vip $VM_IP
      check-distribution The host operating system and CPU architecture of the AOC installation file do not match the Linux distribution and the host CPU architecture of the AOC virtual machine.

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

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

        arch

      2. Get the installation file that meets your requirements and reload the ISO image in AOC.
      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 execute any of the following command 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.