Connecting a cluster to Data Management
Before you begin
Before you can log in to the cluster for the first time, you must define and create the cluster in IBM Storage Defender Data Protect.
About this task
Connecting a cluster to Data Management is also referred to as a claim. A claim is the process of defining a cluster to Data Management.
Procedure
To connect a cluster to Data Management, complete the following steps:
- 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.
- 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:- Log in to Data Management and navigate to All Clusters > Settings > Access Management.
- Click the Tokens tab.
- 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.
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
where in the URLs, you must replace CLUSTERIP with the TCP/IP address of one of the cluster nodes to downloadiris_cli
for Mac, you can downloadiris_cli
from the https://CLUSTERIP/files/bin/cli/darwin-x86_64/iris_cli. For Linux or the system that includes Windows subsystem for Linux, theiris_cli
can be downloaded from https://CLUSTERIP/files/bin/cli/linux-x86_64/iris_cli.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"
- Sign in to Data Protect cluster by using web browser.
- Click the
icon on the navigation menu.
- Paste the Token key that is created in step 2.c., then click Connect button.
- 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 theclaim_to_ibm
script by completing these steps:- 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: Theclaim_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. - Install
cURL
. To check whethercURL
is already installed, issue the commandcurl -V
from the terminal. If a version number is returned,cURL
is already installed. - 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
- Run the
claim_to_ibm.sh
script by issuing the following command from the terminal:
where./claim_to_ibm.sh -s=cluster_ip_address
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:
where./claim_to_ibm.sh -s=mycluster.mycompany.com -p=NewPassword
NewPassword
is your updated password. - When the script is run, a cluster URL is displayed.
- 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:
- Sign in to the cluster by entering your credentials.
- Click the
icon on the navigation menu and then click Register with Helios.
- On the Helios page, click the Connect to Helios toggle to Enable a connection.
- Skip to the step step 2.g.
- If this is your first time signing in, complete the following steps:
- Sign in by using the default credentials:
- Username: admin
- Password: admin
- Review and accept the End User License Agreement.
- From the Cluster Management page, select Manage in Helios SaaS and click Connect to Helios.
- From the License page, select Full Access Permissions, and click Continue.
- Continue to step step 2.g.
- Sign in by using the default credentials:
- If you previously logged in to the cluster URL and you already changed the default password,
complete the following steps:
- 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.
- You are prompted to change the default password.
The Summary page for the Data Protect cluster is displayed.
- 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.
- Download the
-
- Repeat this procedure on each cluster that you want connected to Data Management.