Alibaba Cloud Linux:How to upgrade components on the Agentic OS image

Prerequisites

• Operating system — Alibaba Cloud Linux 4 Agentic Edition (Agentic OS).

• Permissions — sudo access is required.

• Network — The instance must have access to the Agentic OS software repository.

• Agentic OS CLI version — anolisa --version must return 0.2.7 or later before you upgrade components. If your version is below 0.2.7, upgrade the CLI first (see Step 2).

• Installing new components — To install a component that is not yet present on the image, run dnf install <rpm-package> -y. This tutorial covers upgrading existing components only.

Quick upgrade

If you are familiar with the process, run the following commands in order. For details about each step, see the sections below.

# 1) Upgrade the CLI (RPM is recommended for Alibaba Cloud Linux 4)
sudo dnf --refresh upgrade -y anolisa

# 2) Verify that the version is 0.2.7 or later
anolisa --version

# 3) Check for updates (read-only, no changes are made)
sudo anolisa update --check

# 4) Upgrade components
sudo anolisa upgrade

# 5) Verify the result
sudo anolisa doctor

Step 1: Check the Agentic OS CLI version

Run the following command to check the installed Agentic OS CLI version:

anolisa --version

The output must show anolisa 0.2.7 or later. If the version is earlier than 0.2.7, you must upgrade the CLI first — proceed to Step 2. If the version is 0.2.7 or later, skip to Step 3.

Step 2: Upgrade the Agentic OS CLI (required if below 0.2.7)

If the Agentic OS CLI version is earlier than 0.2.7, upgrade it by using dnf:

# If the CLI is already installed on the older image, upgrade it directly
sudo dnf --refresh upgrade -y anolisa

# If the system returns "package anolisa is not installed", install it instead
sudo dnf --refresh install -y anolisa

Step 3: Check for available updates

Run the following command to check for available updates without modifying the system:

sudo anolisa update --check

The output lists the components that can be upgraded and their target versions.

Step 4: Upgrade components

Run the following command to upgrade all installed components to the latest version:

sudo anolisa upgrade

Agentic OS upgrades all installed components to the latest version and refreshes their status.

A successful run shows 0 error(s) and [ok] in the summary. The number of components and their versions vary depending on the software repository. Refer to the actual output for details.

Step 5: Verify the result

After the upgrade is complete, run the following commands to verify the result:

sudo anolisa update --check
sudo anolisa doctor

Verify the following:

• update --check: The output shows 0 update(s) and 0 error(s).

• doctor: All components show the status ok, and both degraded and failed are 0.

FAQ

# After RPM installation, check whether the command is available
command -v anolisa
# If the command returns no output, verify that the package is installed and find the actual installation path
rpm -q anolisa
rpm -ql anolisa | grep '/anolisa$'

# Add the directory that contains the executable to PATH.
# For example, if the executable is located at /usr/bin/anolisa
export PATH="/usr/bin:$PATH"
hash -r

# If rpm -ql does not find the executable, try reinstalling the package
sudo dnf reinstall anolisa

sudo anolisa upgrade

sudo anolisa status <component>
sudo anolisa repair <component>

# 1. Query the RPM package name for the component
sudo anolisa status <component>

# 2. List all available versions of the RPM package
sudo dnf --showduplicates list <rpm-package>

# 3. Install the specified version
sudo dnf install -y <rpm-package>-<version-release>