#Installing

#Upload and Extract Installation Package

Upload the Core Package installation package to any machine of the global cluster control plane nodes, and extract it according to the following command:

# Assume that the /root/cpaas-install folder already exists on the machine
tar -xvf {Path to Core Package File}/{Core Package File Name} -C /root/cpaas-install
cd /root/cpaas-install/installer || exit 1

#Prepare the Required Aligned Extension Packages

Copy each of the eight packages listed in Required Aligned Extensions into the plugins/ directory of the extracted Core Package. Run the following command once for each package:

cp <path-to-extension-package> /root/cpaas-install/installer/plugins/

Confirm that the directory contains the eight required packages before starting the installer:

ls -1 /root/cpaas-install/installer/plugins/

Do not copy other packages from Common ACP Extensions into this directory. The installer processes only the packages that you manually place in plugins/; it does not download packages from the Customer Portal.

#Start the Installer

Choose the command that matches the platform image source. After the installer starts successfully, the terminal outputs the web console access address.

After waiting for about 5 minutes, you can use a browser on your PC to access the web console provided by the installer.

For the platform built-in Registry:

bash setup.sh

For an external registry that permits anonymous pull:

bash setup.sh --registry "<registry-address>"

For an authenticated external registry, provide the pull username and password together. The pull account used by setup.sh can be different from the push account used to upload the payload:

export REGISTRY_ADDRESS="registry.example.com"
export REGISTRY_USERNAME="<registry-pull-username>"
read -rsp "Registry password: " REGISTRY_PASSWORD
export REGISTRY_PASSWORD
printf '\n'

bash setup.sh \
  --registry "$REGISTRY_ADDRESS" \
  --username "$REGISTRY_USERNAME" \
  --password "$REGISTRY_PASSWORD"

unset REGISTRY_PASSWORD

The registry address must use the form <host-or-IP>[:port] without http:// or https://. Do not provide only one of --username and --password.

#IP Family

bash setup.sh --ip-family ipv6

If you plan to create a global cluster with Single-stack Network IPv6, you must explicitly specify --ip-family ipv6 when starting the installer. Without this parameter, the global cluster created by the installer will support Single-stack Network IPv4 and Dual-stack Network by default.

#Parameter Configuration

Configure the installation in the Web UI, review every value, and then confirm the installation. Use Installer Parameters for the field-by-field reference.