Updated on 2024-06-17 GMT+08:00

Managing Nodes in an On-Premises Cluster

This section describes how to use ucs-ctl to manage nodes in an on-premises.

ucs-ctl is a command-line tool for managing UCS on-premises clusters. For details about ucs-ctl, see Using ucs-ctl to Manage On-Premises Clusters.

Adding a Node to an On-Premises Cluster

  1. Run the ./ucs-ctl config generator -t node -o node.csv command on the executor to generate the configuration file used for managing nodes.
  2. Write the parameters of the required node to the configuration file and use commas (,) to separate the parameters. Table 1 describes the parameters.

    Table 1 Parameters in the configuration file

    Parameter

    Description

    Node IP

    Node IP

    User

    Username for SSH connection

    Password

    Password for SSH connection

    Example:

    Node IP,User,Password
    123.45.6.789,root,********
    123.45.6.890,root,********

  3. Run the ./ucs-ctl create node -c [Cluster name] -m node.csv command on the executor to manage the node.

The node.csv file contains keys. Keep the file secure.

Deleting a Node from an On-Premises Cluster

  • Method 1:

    Run the following command on the executor:

    ./ucs-ctl delete node -c [Cluster name] -n [node ip1],[node ip2],...

    -n specifies IP addresses. Use commas (,) to separate the IP addresses.

  • Method 2:

    Run the following command on the executor:

    ./ucs-ctl delete node -c [Cluster name] -m node.csv

    -m specifies the configuration file used for managing nodes. You can delete all nodes at a time.

If nodes fail to be deleted from an on-premises cluster, perform operations in How Do I Manually Clear Nodes of an On-premises Cluster?