Top
Systemwalker Service Quality Coordinator Reference Guide
Systemwalker

Enterprise Edition1.3 sqcHmSetup (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 a second Manager of the redundant Manager operations for "pull" operation.


Before performing this procedure

If the Manager service or daemon is running, stop it 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\sqcHmSetup.exe [-u]

[UNIX]

/opt/FJSVssqc/bin/sqcHmSetup.exe [-u]


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.

sqcHmSetup (Manager Setup Command for Redundant Manager Operation) creates or removes the Manager environment for redundant Manager operations.

Note

Do not execute multiple sqcHmSetup command simultaneously.

Point

Execute this command on only the second Manager for "pull" operations as described in "Tasks to perform on the second Manager" in the Installation Guide.


Options

-u

This option cancels the redundant Manager 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 : sqcHmSetup.exe [-u]

(The command has not been used correctly.)


Failed to write environment settings to dmcoll.ini.
Command failed.


Failed to read environment settings from dmcoll.ini.
Command failed.


Failed to read environment settings from registry.
Command failed.

(This message is for Windows only.)


Failed to get service status.
Command failed.

(Could not get the status of the Systemwalker SQC sqcschdle service/sqcschdle process.)


"sqcschdle" is running and so sqcHmSetup can not be run
Please stop "sqcschdle" and retry sqcHmSetup.
Command failed.

(Systemwalker SQC sqcschdle service/sqcschdle process is running.)


Usage example

To make a Manager redundant, execute this command as follows:

[Windows]

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

C:\Program Files\SystemwalkerSQC\bin>sqcHmSetup.exe

Command Succeeded.

C:\Program Files\SystemwalkerSQC\bin>

[UNIX]

# cd /opt/FJSVssqc/bin/

# ./sqcHmSetup.exe

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>sqcHmSetup.exe -u

Command Succeeded.

C:\Program Files\SystemwalkerSQC\bin>

[UNIX]

# cd /opt/FJSVssqc/bin/

# ./sqcHmSetup.exe -u

Command Succeeded.

#


File

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

[Windows]

<Variable file storage directory>\control\data\dmcoll.ini

[UNIX]

/etc/opt/FJSVssqc/data/dmcoll.ini