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: (Required) Specifies the truststore password.
-c | --oc-url operations_center_url: Specifies the IP address or hostname for the registered IBM Storage Protect Operations Center.
-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.