Preface
Overview of the Server Manager Command Line Interface
Usage Scenario: Using Server Manager CLI Commands to Run Replications
- Prerequisite Tasks for Running Replication Jobs from the Server Manager CLI
- Using the Server Manager CLI to Run Replications
  - Running a Scheduled Replication Job in Interactive Mode
  - Running a Scheduled Replication Job in Non-interactive Mode with Scripts
Command Reference

Command Line Interface for the Server Manager

9.7.0 HotFix 1

Back Next

connect

Connects to the Server Manager Main server on a specific host.

You must connect to the Server Manager Main server before you can run any other commands.

After you connect to the Server Manager Main server, the idrcmd application stores the session information in the following manner:

In interactive mode, the idrcmd application stores the session information in the application memory.

In non-interactive mode, the idrcmd application stores the session information in the state.dat file.

Syntax

connect hostport login=user_name passwd=user_password [protocol={http|https}] [pathToCert=path_to_certificate] [pathToTruststore=path_to_java_truststore] [storepass=password_to_java_truststore]

Parameters

The following table describes the command parameters:

Parameter	Description
host	The host name or IP address of the system with the Server Manager Main server instance.
port	The port number of the Server Manager Main server instance. Valid values are integers from 1 through 65535.
login	A user name that has the authority to connect to the specified Server Manager Main server instance.
passwd	A valid password for the specified login user. If a password is not required for the login user, enter passwd= , without any spaces or characters after the equals sign.
protocol	The type of protocol that the Server Manager Main Server uses for connections. Valid values are: HTTP HTTPS Default value: HTTP
pathToCert	If the protocol parameter is set to HTTPS, the full path to the cert.pem certificate file.
pathToTruststore	If the protocol parameter is set to HTTPS, the full path to the TrustStore file that Java uses to store trusted certificates.
storepass	If the protocol parameter is set to HTTPS, the password for the Java TrustStore.

Example

The following command establishes a connection to the Main server that runs at the specified IP address and port for the idradmin user with a blank password:

connect 192.168.1.11 8088 login=idradmin passwd=

The following command establishes an initial HTTPS connection to the Main server that runs at the specified IP address and port for the demo user:

connect 192.168.1.12 8090 login=demo passwd=demo protocol=https pathToCert=C:\mycert.pem pathToTruststore=C:\Program Files\Java\jre1.8.0_40\lib\security\cacerts storepass=changeit

The following considerations pertain to HTTPS connections to the Main server:

To add a certificate for the first time, enter the pathToCert, pathToTruststore, and storepass parameters.

If the certificate is already in the default Java TrustStore directory, you do not need to specify the pathToCert, pathToTruststore, or storepass parameters. You can use the default location of the Java TrustStore file, which is either

JAVA_HOME/jre/lib/security/cacerts

for the JDK or

JAVA_HOME/lib/security/cacerts

for the JRE.

If the certificate is already in a Java TrustStore directory that is different from the default directory, specify the pathToTruststore parameter the first time you connect to the Main server.

For later connections to the same Main server, you do not need to specify these parameters again.

Rename Saved Search

Table of Contents

Command Line Interface for the Server Manager

Command Line Interface for the Server Manager

connect

connect

Syntax

Parameters

Example