1.4 sqcHaSetup (Agent/Proxy Manager Setup Command for Redundant Manager Operation)

Privileges required for execution

[Windows]

The privileges of a user belonging to the "Administrators" group are required to execute this command.

[UNIX]

The privileges of a system administrator (superuser) are required to execute this command.

Execution environment

This command can be executed on an Agent or Proxy Manager.

Before performing this procedure

If the service or daemon for the Agent or Proxy Manager is running, stop the service or daemon by referring to "Chapter 2 Starting and Stopping Resident Processes". Also check that the relevant resident processes have stopped correctly.

Syntax

[Windows]

<Installation directory>\bin\sqcHaSetup.exe -h host name

<Installation directory>\bin\sqcHaSetup.exe -u

<Installation directory>\bin\sqcHaSetup.exe -d

[UNIX]

/opt/FJSVssqc/bin/sqcHaSetup.sh -h <host name>

/opt/FJSVssqc/bin/sqcHaSetup.sh -u

/opt/FJSVssqc/bin/sqcHaSetup.sh -d

Function

If the Manager is to be used in a redundant configuration, the redundancy setup command must be executed on the Manager and Agent/Proxy Manager.

sqcHaSetup (Agent/Proxy Manager Setup Command for Redundant Manager Operation) creates or removes the Agent or the Proxy Manager environment for redundant Manager operations.

Note

Do not execute multiple sqcHaSetup command simultaneously.

Options

-h <host name>: Specify either the host name or the IP address of the Manager that had not been set up when the Agent was first installed. This option cannot be specified together with other options.

-u: This option cancels the redundant Manager operations. This option cannot be specified together with other options.

-d: This option displays the Manager that is currently specified as the connection destination. This option cannot be specified together with other options.
Note
This option can only be specified with "push" operations.

Return values

Normal termination: 0

Abnormal termination: 1

If this command terminates normally, the following message will be output:

Command Succeeded.

If this command terminates abnormally, the following messages will be output:

Usage : sqcHaSetup.exe -h hostname
sqcHaSetup.exe -u
sqcHaSetup.exe -d

(Either an option has not been specified or the command has not been used correctly.)

Failed to write environment settings to DSAconfiguration.txt.
Command failed.

Failed to read environment settings from DSAconfiguration.txt.
Command failed.

Failed to read environment settings from registry.
Command failed.

Failed to create/delete directory.
Command failed.

Failed to get service status.
Command failed.

(Could not get the status of the Systemwalker SQC DCM service. This message is for Windows only.)

DCM is running and so sqcHaSetup can not be run.
Please stop DCM and retry sqcHaSetup.
Command failed.

Systemwalker SQC DCM service/dcmd process is running.

An error occurred. Cause code = XXX
Command failed.

(Another error occurred. "XXX" indicates the error code.)

Usage example

To add a second Manager, execute this command as follows:

[Windows]

C:\>cd C:\Program Files\SystemwalkerSQC\bin

C:\Program Files\SystemwalkerSQC\bin>sqcHaSetup.exe -h hostname

Command succeeded.

C:\Program Files\SystemwalkerSQC\bin>

[UNIX]

# cd /opt/FJSVssqc/bin/

# ./sqcHaSetup.sh -h hostname

Command succeeded.

To cancel redundant Manager operations, execute this command as follows:

[Windows]

C:\>cd C:\Program Files\SystemwalkerSQC\bin

C:\Program Files\SystemwalkerSQC\bin>sqcHaSetup.exe -u

Command succeeded.

C:\Program Files\SystemwalkerSQC\bin>

[UNIX]

# cd /opt/FJSVssqc/bin/

# ./sqcHaSetup.sh -u

Command Succeeded.

To display the Manager that is currently specified as the connection destination, execute this command as below. (For "push" operations only)

[Windows]

C:\>cd C:\Program Files\SystemwalkerSQC\bin

C:\Program Files\SystemwalkerSQC\bin>sqcHaSetup.exe -d

Manager host name 1 : XXXX

Manager host name 2 : YYYY

C:\Program Files\SystemwalkerSQC\bin>

[UNIX]

# cd /opt/FJSVssqc/bin/

# ./sqcHaSetup.sh -d

Manager host name 1 : XXXX

Manager host name 2 : YYYY

"XXXX" and "YYYY" are the host names of the servers that are currently specified as the Managers to connect to. If redundant Manager operations have not been set up, then "Manager host name 2" (the "YYYY" section) will be left blank. Also, even if redundant Manager operations have set up, this section will be left blank for pull operations.

File

If this command is completed successfully, the following file will be edited:

[Windows]

<Variable file storage directory>\control\DSAconfiguration.txt

[UNIX]

/etc/opt/FJSVssqc/DSAconfiguration.txt