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 Managers and Proxy Managers.
Format
[Windows]
<Installation directory>\bin\sqcRemoteCheck.exe [-h <hostname>] |
[UNIX]
/opt/FJSVssqc/bin/sqcRemoteCheck.sh [-h <hostname>] |
Function
The agent for Agentless Monitoring management communication confirmation command confirms whether communication is possible between a managed server that has been set up using agent for Agentless Monitoring management and a Manager or Proxy Manager.
The -h option can be used to specify the managed server for which communication is to be confirmed.
Note
Do not execute multiple sqcRemoteCheck command simultaneously.
Options
Specifies the identifier of the managed server for which communication is to be confirmed.
If this option is omitted, all managed servers being managed using agent for Agentless Monitoring management will be targetted by the command.
Point
In the identifier of the managed server, specify the HOSTNAME string in the remote monitoring configuration file (remoteAgent.txt).
Return values
Normal termination: 0
Abnormal termination: 1
Execution results/Output format
The following normal completion message will be sent to standard output.
(Success): sqcRemoteCheck succeeded. |
C:\Program Files\SystemwalkerSQC\bin>sqcRemoteCheck.exe Server1 OK Server2 OK Server3 NG detail=*****dsa_telnet***** ===== Connect Error ===== server: TestServer3 [Server3] SOCKET Message: The requested name is valid, but no data of the requested type was found. State: Start connection: Resolve host address (Success): sqcRemoteCheck.exe succeeded. |
An error message will be sent to standard error output:
(Error error number):Message |
The error numbers, content, and action corresponding to the error messages are as shown below.
Error number | Message | Content | Corrective measure |
---|---|---|---|
010 | Parameter error. | Parameter specification error | Correct the parameter and re-execute the command. |
020 | invalid argument to '-h' | -h option specification error | Correct -h option's parameter and re-execute the command. |
100 | System error. | Other error | Collect maintenance information and contact a Fujitsu SE. |
If the agent for Agentless Monitoring management communication confirmation command is performed using the following definition
[Identifier of the managed server]
server1
server2
server3
[Sample error]
If the sqcRemoteCheck command ends with an error
(Error 100):System error. |
Usage example
[Windows]
C:\Program Files\SystemwalkerSQC\bin>sqcRemoteCheck.exe Server1 OK Server2 OK Server3 NG detail=*****dsa_telnet***** ===== Connect Error ===== server: TestServer3 [Server3] SOCKET Message: The requested name is valid, but no data of the requested type was found. State: Start connection: Resolve host address (Success):sqcRemoteCheck.exe succeeded. |
[UNIX]
#cd /opt/FJSVssqc/bin #./sqcRemoteCheck.sh Server1 OK Server2 OK Server3 NG detail=*****dsa_telnet***** ===== Connect Error ===== server: TestServer3 [Server3] SOCKET Message: Temporary failure in name resolution State: Start connection: Resolve host address (Success):sqcRemoteCheck succeeded. |