Skip to main content

ARO Client Installation and Initialization Tutorial

This tutorial guides you through the process of installing and initializing the ARO Client software image in a virtual machine environment. ARO Client is a software image designed for X86 architectures, and this tutorial focuses on a Linux environment.

Before preparing the virtual machine environment, review the recommended system requirements for running the ARO Client image on this page.

Part 1: Preparing the Virtual Machine Environment​

To run the ARO Client image, you need a virtualization environment. Below are the recommended preparation steps:

  1. Choose a Virtualization Platform
    Select one of the following virtualization platforms (or other Linux-compatible solutions):

    • Proxmox VE: Free, open-source and flexible, suitable for budget-conscious users or those preferring open-source solutions, supports containers and broad hardware based on Debian Linux.
    • Hyper-V: A native hypervisor developed by Microsoft that allows users to create and run virtual machines on x86-64 systems running Windows. Hyper-V is best for Windows ecosystems, ideal for enterprises or users with existing Windows Server licenses, but management tools are Windows-dependent.
    • VMware: Enterprise-grade, preferred for large-scale, complex, or high-availability environments, but costly.
    • VirtualBox: Lightweight, ideal for individual developers, testing environments, or cross-platform (Windows, Linux, MacOS, Solaris, etc.) needs, but less robust than enterprise solutions, yet easy to use.

  2. Install the Virtualization Platform
    Follow the official documentation for your chosen platform to complete the installation. For example:

  3. Verify the Environment

    • Ensure sufficient disk space (at least 50GB recommended).
    • Verify network connectivity to allow the virtual machine to access external networks (required for initialization).

Note: This tutorial assumes you are familiar with installing and configuring your chosen virtualization platform. Refer to the platform’s official documentation for detailed guidance if needed.

Part 2: Selecting the Image and Allocating Resources​

After preparing the virtual machine environment, you need to select the ARO Client image and allocate appropriate resources.

Step 1: Obtain and Select the ARO Client Image​

  1. Download the Image
    Download the latest ARO Client image (in .iso format).
  2. Select the Image
    • Proxmox VE: Log in to the Proxmox web interface, navigate to storage (e.g., local), and upload the .iso file.
    • VirtualBox: Create a new virtual machine, select “Use an existing virtual hard disk file,” and point to the ARO Client .iso file.
    • VMware Workstation/Player: Create a new virtual machine, select “Use ISO image file,” and specify the ARO Client .iso file.
  3. Verify the Image
    Ensure the image file is not corrupted by verifying its checksum (e.g., MD5 or SHA256).

Step 2: Create the Virtual Machine and Allocate Resources​

  1. Create the Virtual Machine
    In your virtualization platform, create a new virtual machine and select the ARO Client .iso file as the boot medium.
  2. Resource Allocation Recommendations
    To ensure smooth operation of ARO Client, allocate the resources according to this recommendation.
  3. Save Configuration
    Confirm the virtual machine settings and save them before starting.

Note: Adjust resource allocation based on your hardware capabilities and ARO Client’s requirements. For complex tasks, consider increasing CPU and memory.

Part 3: Running the Image and Performing Initial Edge Node Setup​

This section describes how to run the ARO Client image and configure the Edge Node for initial use.

  1. Start the Software Image
    After setting up the virtual machine, launch it to start the ARO Client software image.
    Loading Screen
    The loading process will begin automatically and may take a few minutes. Do not interrupt this process.

  2. Configure the Network
    Once the loading process is complete, a network configuration page will appear.
    Network Configuration
    Select option 1 (the default option).
    IP Configuration
    Configure the IP settings:

    • Select 1 for DHCP to automatically assign an IP address.
    • Select 2 for a static IP if you need to manually configure the network.

    After successful network and IP configuration, the system will perform an automatic ping test. If the test succeeds, you will proceed to the Edge Node activation process.

  3. Initialize the Activation Process
    Terms of Service
    Review the Terms of Service and Privacy Policy. Select Agree and Continue to proceed.
    Virtual Serial Number
    The 19-digit Virtual Serial Number for this Edge Node will appear on the screen. Record this number, as it is critical for activation.
    Add New Node
    Add New Node_SN
    Open the ARO Dashboard. Navigate to ARO Nodes > Add an ARO Client, follow steps and enter the 19-digit Virtual Serial Number.
    Device Recognition
    The dashboard will recognize the software image instance and display its information. Confirm to continue.

    Important: Ensure the software image is online during activation. If it is offline, the activation or node addition process may fail.

    Region Selection
    Select the appropriate region and assign a name to your new node.

  4. Verify Running Status
    Activation Complete
    Congratulations! You have successfully set up your new ARO Client. The CMD console will return to the main menu, displaying real-time network status and activation status. If activation status shows 'Activated' together with your bound account in green, and network status shows 'Connected', then your ARO Client is running successfully.

FAQ​

  • What network ports should be open?
    To ensure proper connectivity and performance, please configure your firewall to allow the following inbound and outbound ports:

    ✅ Inbound Ports

    • UDP: All ports
    • TCP: 80, 443, 9500–9700

    🚀 Outbound Ports

    • UDP: 40001–40100
    • TCP: 443, 30002, 40001–40100