1.2 sqcEmSetup (Two-tier Manager Setup Command)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
These commands can be executed on Manager.
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\sqcEmSetup.exe -h host name [-s on|off] [-m on|off] <Installation directory>\bin\sqcEmSetup.exe -u <Installation directory>\bin\sqcEmSetup.exe -d |
[UNIX]
/opt/FJSVssqc/bin/sqcEmSetup.sh -h <host name> [-s on|off] [-m on|off] /opt/FJSVssqc/bin/sqcEmSetup.sh -u /opt/FJSVssqc/bin/sqcEmSetup.sh -d |
Function
To centrally manage the entire system using an Enterprise Manager, the Two-tier Manager Setup Command must be executed on each Manager after they are installed.
sqcEmSetup (Two-tier Manager Setup Command) creates or removes an environment for two-tier Manager operations where an Enterprise Manager has been installed.
Note
Do not execute multiple sqcEmSetup command simultaneously.
Options
Specify either the host name or the IP address of the Enterprise Manager. This option cannot be specified at the same time as the "-u" or "-d" option.
If the "-h" option has been specified, this option specifies whether an operation management client will connect to this Manager in order to perform management operations for each department. If this option is not specified, the default value is "off".
On: Connects an operation management client to this Manager.
Off: Does not connect an operation management client to this Manager.
Point
If "on" is specified for this option, the Enterprise Manager can be used to manage the entire system while each Manager can be used to perform management operations for each section.
Specify whether to save summary data in the Manager when the operation management client is connected to the Manager and management is performed by Manager.
This option is available when the "-h" option and "-s on" options are specified.
If this option is not specified, then the default value is "on".
on: Summary data stored in the Enterprise Manager
off: Summary data stored in each Manager.
The number of Managers to be managed by the Enterprise Manager can be increased if the "-m off" option is specified.
When the "-m off" option is specified, the summary data displayed in the Operation Management Client while connecting to the Enterprise Manager is collected from each Manager.
This option cancels the two-tier Manager operation. This option cannot be specified at the same time as the "-h" or "-d" option.
This option displays the Enterprise Manager that is currently set up. This option cannot be specified at the same time as the "-h" or "-u" option.
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 : sqcEmSetup.exe -h hostname [ -s on|off ] [-m on|off] |
When either an option has not been specified or the command has not been used correctly, command help will be displayed.
Failed to write environment settings to DSAconfiguration.txt. |
Failed to read environment settings from DSAconfiguration.txt. |
Failed to read environment settings from registry. |
Failed to get service status. |
(Could not get the status of the Systemwalker SQC DCM service. This message is for Windows only.)
DCM is running and so sqcEmSetup can not be run. |
(The Systemwalker SQC DCM service/dcmd process is running.)
An error occurred. Cause code = XXX |
(Another error occurred. "XXX" indicates the error code.)
Usage example
To set up an environment for two-tier Manager operations, execute this command as shown below.
[Windows]
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcEmSetup.exe -h hostname Command Succeeded. C:\Program Files\SystemwalkerSQC\bin> |
[UNIX]
# cd /opt/FJSVssqc/bin/ # ./sqcEmSetup.sh -h hostname Command Succeeded. # |
To connect an operation management client to the Manager and perform management operations for each section, execute this command as shown below.
[Windows]
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcEmSetup.exe -h hostname -s on Command succeeded. C:\Program Files\SystemwalkerSQC\bin> |
[UNIX]
# cd /opt/FJSVssqc/bin/ # ./sqcEmSetup.sh -h hostname -s on Command succeeded. # |
To cancel an existing two-tier Manager operation, execute this command as shown below.
[Windows]
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcEmSetup.exe -u Command succeeded. C:\Program Files\SystemwalkerSQC\bin> |
[UNIX]
# cd /opt/FJSVssqc/bin/ # ./sqcEmSetup.sh -u Command succeeded. # |
To display the Enterprise Manager that has been set up, execute this command as shown below.
[Windows]
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcEmSetup.exe -d Enterprise manager host name : XXXX C:\Program Files\SystemwalkerSQC\bin> |
[UNIX]
# cd /opt/FJSVssqc/bin/ # ./sqcEmSetup.sh -d Enterprise Manager host name : XXXX # |
"XXXX" is the IP address or host name of the server that is currently specified as the Enterprise Manager. If two-tier Manager operations have not been set up, or if there is no Enterprise Manager, the "XXXX" host name section will be left blank.
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 |
