Adding nodes to the existing CE and NGCE clusters

Edit online

You can add nodes to the existing Cloud Edition (CE) and Next-Gen Cloud Edition (NGCE) clusters that are deployed through Data Management Service to increase the overall storage capacity of a cluster.

About this task

Note: The feature is supported only for clusters that are deployed from Data Management Service. It is not supported for clusters that are initially deployed by using the CLI and later claimed to Data Management Service.

Procedure

  1. Log in to the Data Management Service.
  2. Click Settings > Data Platform for Cloud.
  3. Click the cluster to which you want to add nodes.
  4. In the Cloud Deployment Job tab, click Add Node at the upper-right corner of the page.
  5. Based on your cluster type, enter the same credentials information that was used during the deployment of the cluster.
  6. For AWS NGCE CE and NGCE cluster, complete the following steps:
    1. In the AWS Credentials section, provide the following details:
      • Access Key ID - Enter the access key ID of the AWS IAM user used to deploy the cluster.
      • Secret Access Key - Enter the secret access key of the AWS IAM user.
    2. Click Verify.
    Note: IBM® Data Management Service allows the addition of nodes to an existing AWS cluster only by using the IAM user authentication method. If you initially deployed the AWS CE or NGCE cluster by using the IAM role authentication method, you must create an IAM user with the necessary permissions to add nodes.
  7. For Azure CE and NGCE cluster, complete the following steps:
    1. In the Azure Credentials section, provide the following details:
      • Subscription ID- Enter the subscription ID for the subscription used to store the resources of the IBM cluster.
      • Application ID- Enter the application ID assigned by Azure during the creation process of service principal.
      • Application Key- Enter the application key generated by Azure during the service principal creation process that is used for authentication.
      • Tenant ID- Enter the unique Tenant ID assigned by Azure.
    2. Click Verify.
  8. For GCP CE and NGCE cluster, complete the following steps:
    1. In the GCP Credentials section, upload file by either dropping the file in the Service Account JSON key file drop box or by clicking Choose a file.
    2. Click Verify.
  9. In the Node Details section, choose one of the following methods to add nodes:
    • Using Iris Credentials - Data Management Service uses your CLI (Iris) credentials to securely access the cluster. This method automatically fetches the current cluster version and adds the nodes to the cluster. The process is fully automated. No manual intervention is required to join the nodes.
    • Manual - Select the option if you prefer not to share your CLI credentials. In this method, you must specify the same build version as the existing cluster for which you are creating the nodes. Data Management Service creates the nodes only if the provided build version matches that of the existing cluster. After the node creation task completes, you must manually add the nodes to the cluster by running the following CLI command.
      iris_cli --username=<username> --password=<password> --skip_
password_prompt=true --server<cluster_ip_address> cluster cloud-join
node-ips=<nodeip_adresses>

      Where,

      <username>
      Specify the username for accessing the cluster through CLI credentials.
      <password>
      Enter the password for the specified CLI user.
      <cluster_ip_address>
      Specify the IP address of the cluster.
      <nodeip_adresses>
      Specify the IP addresses of the nodes created.

      When a node is created or added, you can obtain the cluster IP address and node IP address from the Viewing log details page for running the CLI commands.

  10. Provide the following information based on your selection.
    FieldDescription
    Username Username for accessing the cluster through Iris credentials.

    Applies to Using Iris Credentials method only.
    Password Password for the specified Iris user.

    Applies to Using Iris Credentials method only.
    Build Version From the list, select the cluster version. Verify that it matches with the version of the existing cluster for which you are creating the nodes. Node creation fails when the selected version does not match with the existing cluster version.

    Applies to Manual method only.
    Node Size From the list, select the node configuration. Make sure to choose the same configuration as the existing cluster for which you are creating or adding nodes. The process fails when the selected configuration does not match with the existing cluster configuration.

    Applies to Using Iris Credentials and Manual methods.
    Number of new nodes Specify the total number of nodes to add to the cluster. You can add up to eight nodes.

    Applies to Using Iris Credentials and Manual methods.
    Notify me when task is complete Enable this option to receive an email notification when node creation is completed. Enter a comma-separated list of email addresses in the Recipient Emails field.

    Applies to Using Iris Credentials and Manual methods.
  11. Click Add.
    The node creation or addition process is initiated.
    • To monitor progress and review logs, see Viewing log details.
    • If you selected the Manual method, only node creation occurs; to add the nodes to the cluster, you must run the CLI command as mentioned in step 9.
    • The new nodes inherit all resource tags or labels from the existing cluster.