Help Center/ Host Security Service/ User Guide/ Installation and Configuration on Containers/ Managing Cluster Agents
Updated on 2025-09-08 GMT+08:00
View PDF
Share

Managing Cluster Agents

You can upgrade the agent or uninstall it from a cluster.

Prerequisites

The cluster is running.

Constraints

The agent can be upgraded only on CCE clusters. To use the latest HSS version for other types of clusters, uninstall the agent and connect it to the clusters again. For details, see Uninstalling the Agent from a Cluster and Installing an Agent in a Cluster.

Upgrading the Cluster Agent

HSS is periodically updated to improve its capabilities. You are advised to upgrade the agent to the latest version in a timely manner.

If the agent has not been upgraded for more than six months, HSS will automatically upgrade it to the latest version. In the latest version, the known issues in earlier versions are fixed, and the threat detection and defense capabilities are enhanced to improve overall security. The upgrade is performed by HSS in the time window from 22:00 to 06:00 the next day. It does not affect your services.

  1. Log in to the HSS console.
  2. Click in the upper left corner and select a region or project.
  3. In the navigation pane, choose Installation & Configuration > Container Install & Config.
  4. Click the Cluster tab.
  5. In the Operation column of a cluster, click Upgrade Agent.

    To upgrade the agent on CCE clusters in batches, select all target CCE clusters and click Upgrade Agent.

  6. Confirm the upgrade information and click OK.

    Wait for 5 to 10 minutes. If the agent version in the cluster list is the latest and the Upgrade Agent button is grayed out, the upgrade is successful.

Uninstalling the Agent from a Cluster

  1. Log in to the HSS console.
  2. Click in the upper left corner and select a region or project.
  3. In the navigation pane, choose Installation & Configuration > Container Install & Config.
  4. Click the Cluster tab.
  5. In the Operation column of a cluster, click Uninstall Cluster.

    To uninstall CCE clusters in batches, select all target clusters and click Uninstall Agent. Clusters of other types cannot be uninstalled in batches.

  6. Confirm the uninstallation information and click OK.

    Wait for 5 to 10 minutes. If the cluster is not displayed in the cluster list, the agent has been uninstalled.

Parent Topic: Installation and Configuration on Containers