dcli server register

Use this command to register an IBM® Storage Protect server to IBM Storage Defender® Data Management Service.

The dcli server register command is used for the initial registration of an existing IBM Storage Protect server to Data Management. For more information, see Connecting an IBM Storage Protect server to Data Management.

Parameters

-a | --admin admin_name
(Required) Specifies the IBM Storage Protect server administrator name that is used to authorize the server registration to Data Management. The administrator must have system privilege on the IBM Storage Protect server.
-p | --password admin_password
Specifies the IBM Storage Protect server administrator password.
-m | --prompt-password
Specifies whether to prompt for the IBM Storage Protect server administrator password from the command-line.
-d | --address ip_address
(Required) Specifies the IP address or hostname for the IBM Storage Protect server.
-o | --portport_number
Specifies the port number for the IBM Storage Protect server. The default value is 1500.
-n | --name server_nickname
(Required) Specifies a user-specified nickname for the IBM Storage Protect server that will be displayed in Data Management.
-t | --truststore-password truststore_password
Specifies the truststore password.
-c | --oc-url operations_center_url
Specifies the IP address or hostname for the registered IBM Storage Protect Operations Center.
-y | --yes
Specifies yes for all yes/no prompts that are displayed when the command runs.
-h | --help
Displays help information for the command.

Example: Register a server

Register an IBM Storage Protect server by specifying server name server1 at address server1.mycity.mycompany.com and port 1500. Specify admin Larry, password myp@ssword, and truststore password secretpassword.
dcli server register --address server1.mycity.mycompany.com --port 1500 --name server1 --admin larry -password myp@ssword --truststore-password secretpassword
Register Server
===============
Successful
       id: 1
     name: server1
    admin: larry
  address: server1.mycity.mycompany.com
     port: 1500
clusterID: 8094343462909
timestamp: Mon May 15 12:04:09 EDT 2023

Field descriptions

ID
The ID for the IBM Storage Protect server.
Name
The user-specified nickname for the IBM Storage Protect server.
Admin
The new administrative user named ibm-eagle-agent-admin that is created on the IBM Storage Protect server after the dcli server register command runs.
Address
The IP address or hostname for the IBM Storage Protect server.
Port
The port number for the IBM Storage Protect server.
ClusterID
The cluster ID number that is assigned to the IBM Storage Protect server.
Timestamp
The date and time that the IBM Storage Protect server was registered.

Related commands

Table 1. Commands related to dcli server register
Command Description
dcli Starts the IBM Storage Defender command-line interface (CLI).
dcli server delete Deletes a registered IBM Storage Protect server.
dcli server query Displays information about a registered IBM Storage Protect server.
dcli server register Registers an IBM Storage Protect server.
dcli server update Updates an IBM Storage Protect server registration.
dcli server updateuser Updates an IBM Storage Protect server user.