Connecting a cluster to Data Management

To connect a cluster to Data Management, complete the following steps:

1. After you initiate the Data Protect cluster creation process, wait until the cluster login page is available. Click the URL that is displayed on the Cluster Setup Status page, but do not log in.
2. To connect a cluster to Data Management, follow one of the following procedures depending on the Data Protect version:

   • Procedure for token based claim

     To associate a Data Protect 7.1.1 or later cluster with Data Management, you must run the following steps:
     1. Log in to Data Management and navigate to All Clusters > Settings > Access Management.
     2. Click the Tokens tab.
     3. Click the Create button in the upper right corner of the screen.

        On the Create Token window, specify any name in the Name field for the token that you are generating. For the Type field, select Data Protect from the drop-down. Then select Create, which creates the token.

        Before closing the Create Token window, copy the token by selecting the copy icon.

     4. Download iris_cli to a Mac, Linux, or the system that includes Windows subsystem for Linux.

        Note: This step is not required for Data Protect 7.2 and later versions.

        To download iris_cli for Mac, you can download iris_cli from the https://CLUSTERIP/files/bin/cli/darwin-x86_64/iris_cli. For Linux or the system that includes Windows subsystem for Linux, the iris_cli can be downloaded from https://CLUSTERIP/files/bin/cli/linux-x86_64/iris_cli.

        where in the URLs, you must replace CLUSTERIP with the TCP/IP address of one of the cluster nodes to download iris_cli.
        And then, run the iris_cli command against the Data Protect cluster to enable token-based claim feature flag:

        iris_cli -server CLUSTERIP cluster update-feature-flag feature-flag-name=heliosTokenClaimEnabled is-approved=true is-ui-feature=true reason="Use token based claim"

     5. Sign in to Data Protect cluster by using web browser.
     6. Click the icon on the navigation menu.
     7. Paste the Token key that is created in step 2.c., then click Connect button.
     8. To verify that the cluster was successfully connected, log in to Data Management and navigate to All Clusters > Settings > Clusters. The Cluster Management page is displayed.

        If the cluster connection is successful, the Connection column displays the Connected status with green checkmark icon for the cluster.

   • Procedure for script based claim

     To associate any cluster older than Data Protect 7.1.1 with Data Management, you must run the claim_to_ibm script by completing these steps:
     1. Download the claim_to_ibm.tar script from IBM® Documentation by right-clicking claim_to_ibm.tar and saving it to the Downloads directory on your local system.
        Note: The claim_to_ibm.sh script runs on Linux, Mac OS X, and Windows Subsystem for Linux®. This script uses cURL, which is an open source REST command-line tool that can be downloaded from the internet at no cost.
     2. Install cURL. To check whether cURL is already installed, issue the command curl -V from the terminal. If a version number is returned, cURL is already installed.
     3. Extract the claim_to_ibm.tar file that you downloaded in step 2.a. by issuing the following command from the terminal:

        tar xvf claim_to_ibm.tar

     4. Run the claim_to_ibm.sh script by issuing the following command from the terminal:

        ./claim_to_ibm.sh -s=cluster_ip_address

        where cluster_ip_address is the IP address for the cluster.
        Example:

        ./claim_to_ibm.sh -s=mycluster.mycompany.com

        Tip: If you previously logged in to the cluster and changed the default password, use the -p parameter to specify your updated password.

        Example:

        ./claim_to_ibm.sh -s=mycluster.mycompany.com -p=NewPassword

        where NewPassword is your updated password.
     5. When the script is run, a cluster URL is displayed.
     6. From a web browser, open the cluster URL and refresh the page.
        • If you previously logged in to the cluster URL and you already changed the default password, complete the following steps:
          1. Sign in to the cluster by entering your credentials.
          2. Click the icon on the navigation menu and then click Register with Helios.
          3. On the Helios page, click the Connect to Helios toggle to Enable a connection.
          4. Skip to the step step 2.g.
        • If this is your first time signing in, complete the following steps:
          1. Sign in by using the default credentials:
             • Username: admin
             • Password: admin
          2. Review and accept the End User License Agreement.
          3. From the Cluster Management page, select Manage in Helios SaaS and click Connect to Helios.
          4. From the License page, select Full Access Permissions, and click Continue.
          5. Continue to step step 2.g.
     7. From the Cohesity Support Portal page, click MyCohesity Login. Specify the login credentials for the cluster management account.
        Important: To log in and associate a cluster with Data Management, you must specify the cluster management account credentials that were originally used to register with IBM Storage Defender. You cannot connect a cluster to Data Management by using any other credentials.
     8. You are prompted to change the default password.

        The Summary page for the Data Protect cluster is displayed.

     9. To verify that the cluster was successfully connected, log in to Data Management and click Settings > Clusters. The Cluster Management page is displayed.

        If the cluster connection was successful, the Connection column displays a Connected status for the cluster.

3. Repeat this procedure on each cluster that you want connected to Data Management.