Managing Network Storage Objects › Register Windows Computers › Command Line Interface (COMPREG)

Command Line Interface (COMPREG)

The Command Line Interface (COMPREG) is a mechanism that lets you register one or multiple computer(s) from a Windows command line. You can activate the Command Line Interface from the Application Server. It resides in the \SOFTWARE\BIN subdirectory under the directory in which you installed CA SRM.

The Command Line Interface offers the following features:

• Activates a procedure or a service that was defined and executed using the HOLD timing condition
• Provides security consistent with the operating system environment
• Passes EDL parameters to the service being executed
• Provides online help assistance
• Provides error logging to a file

You can execute the Command Line Interface in two modes, each controlled by command line parameters:

• Synchronous mode—In which the Command Line Interface waits until the launched service or procedure terminates. The execution of the Command Line Interface is successful if the specified service or procedure terminates normally. In synchronous mode, the Command Line Interface logs the success or failure of the service or procedure.
• Asynchronous mode—In which the Command Line Interface terminates immediately after the service or procedure is scheduled. The execution of the Command Line Interface is successful if the specified service or procedure was found and started.

If the execution of the Command Line Interface fails, it creates a result file that contains a description of the problem.

The default name of the file is COMPREG.LOG and you can find it in the following directory:

• For 32 bit operating systems: C:\Program Files\CA\Brightstor SRM\Bin.
• For 64 bit operating systems: C:\Program files(x86)\CA\Brightstor SRM folder\Bin

  Note: This directory path for 64-bit operating systems is for fresh installations only.

Command Line Interface Execution

If the Command Line Interface parameters pass verification, the Command Line Interface contacts the Application Server and requests the execution of the service or procedure according to command line parameters. The service or procedure to be invoked must be defined (including clicking EXECUTE) before the Command Line Interface execution. You must use a special timing construct (HOLD keyword) in the service definition. When you see this keyword to specify the timing condition, the service is built but not scheduled.

Note: You can view the services with timing condition HOLD through CA SRM Monitor under Services on Hold.

The Application Server checks whether the requested service or procedure exists. If not, it returns an error. Then the Application Server modifies the timing specified in the Command Line Interface parameters for immediate execution, schedules the service, and returns control to the Command Line Interface.

After the service is scheduled, and if the Command Line Interface was invoked in asynchronous mode, the Command Line Interface deletes the result file and exits. If it was invoked in synchronous mode, the Command Line Interface waits for the service or procedure to complete and deletes or creates the result file depending on the completion code.

Usage:

-s AS -h Host -i IP -d Domain -o System

[-u User] [-p Password] [-t DomainType] [-w timeout] [-b NIS] [-v [St

orageAnalysisFlags]]

Example

The following example illustrates command line interface execution:

For 32-bit: C:\Program Files\CA\BrightStor SRM\Bin>compreg.exe

For 64-bit: C:\Program Files(x86)\CA\BrightStor SRM\Bin>compreg.exe

  -s 155.35.58.50  -h sheko01- 2k3ee -i 155.35.59.104 -d ca.com -o Windows -u ganba01 -p xxxxx -w 5000 -v 11111111111 

Session started at: 08/04/08 12:34:17

Log file name     : C:\BrightStor SRM Data\Database\Log\cse_err.log

Machine name      : ganba01-test01.ca.com

Starting Computer Registration...

Checking local host name and IP address

Checking user security...

Getting information from local BOS

Registering SHEKO01-2K3EE on Application Server 155.35.58.50

Successfully Completed

Note: This directory path for 64-bit operating systems is for fresh installations only.

If the Command Line Interface command line is missing one or more variables, the service is not executed and an error message is written to the log file.

If the Command Line Interface command line contains extra variables, the service executes and an error message displays in the Application Server error log window.