Loading...

Registering the Client Using the Command Line

When you install SnapProtect in decoupled mode, the client does not establish connections with the CommServe computer. You must register the client to complete the installation.

You can register the client by running a command from the command-line interface.

Before You Begin

  • The SnapProtect software must be already installed on the client.
  • If you installed a laptop package on Linux or Macintosh computers as a non-root user, you must run the following commands before registering the client.
    • The cvprofile command:

      . /opt/snapprotect/Base/cvprofile

    • The galaxy_vm command:

      . /opt/snapprotect/galaxy_vm

    Note: When you run the commands, make sure to notice the dot space before the /opt directory.

Procedure

On the computer where you installed SnapProtect, open the command line prompt and do the following:

  • On Windows Computers

    Go to the Installation_Directory_Path/Base directory and run the following command after substituting the parameter values:

    SIMCallWrapper.exe -OpType 1000 -CSHost CommServe_hostname -clientname client_name -output XML_file_location

  • On UNIX, Linux, and Macintosh Computers

    Go to the Installation_Directory_Path/Base directory and run the following command after substituting the parameter values:

    ./SIMCallWrapper -OpType 1000 -CSHost CommServe_hostname -clientname client_name -output XML_file_location

The SIMCallWrapper command supports a variety of parameters:

SIMCallWrapper -OpType 1000 [-instance instance_name] [-user user_name] [-password password] [-passwordEncrypted] [-CSName CommServe_name] [-CSHost CommServe_hostname] [-ClientName client_name] [-ClientHostName client_hostname] [-ClientGroup client_group] [-subclientPolicy subclient_policy] [-StoragePolicy storage_policy] [-overwriteClientInfo] [-resetNetworkPassword] [-regPath alternate_registry_path] [-instanceFor1Touch instance_name] -output XML_file_location [-skipCertificateRevoke] [-restartServices]

The following table describes all of the parameters supported by the command. The required parameters have a Required tag in the description. Other parameters are optional.

Parameter Description of Parameter Values
-opType 1000 Required. Name of the operation type to register the client to the CommServe computer.
-clientName Required. Name of the computer that you want to register.
-output Required. Directory path where you want to save the output XML file. For example:
  • On Windows, C:\temp\output.xml
  • On UNIX, /tmp/output.xml

The SIMCallWrapper command saves the success or error messages in XML format.

-instance CommCell instance on which the command runs. For example, Instance001.
-user User name of your CommCell user account. If the user is part of a domain, specify the user name as 'domain\user'.

Notes:

  • If you installed a laptop package, this parameter is required. You must specify the user name of your Web Console account.
  • If user authentication for installing agents is enabled on the CommCell environment, this parameter is required.
-password Password for the user account provided. This parameter is required if you used the -user parameter.
-CSName Name of the CommServe computer.
-CSHost Required. Host name of the CommServe computer.
-clientHostName Host name of the computer that you want to register.
-clientGroup Name of the client group that you want to associate with the computer.
-subclientPolicy Name of the subclient policy that you want to associate with the computer.
-storagePolicy Name of the storage policy that you want to associate with the computer.
-overwriteClientInfo Overwrites the computer's client name and host name that were provided during the installation with the ones you provide in the SIMCallWrapper command.

Valid values are ON and OFF.

-regPath Name of the alternative registry path.
-instanceFor1Touch Name of the instance for 1-Touch.
-restartServices Restarts SnapProtect services on the client.

Use this parameter if you installed the SnapProtect software from a custom package that did not include CommServe details in its configuration.