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.
Before performing this procedure
If the Manager/Proxy 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.
Note
If the command is executed when Manager/Proxy Manager service or daemon is running, performance data might not be collected.
Format
[Windows]
<Installation directory>\bin\sqcAgentlessCleanUp.exe [-h <host name>] |
[UNIX]
/opt/FJSVssqc/bin/sqcAgentlessCleanUp.sh [-h <host name>] |
Function
The agent for Agentless Monitoring management collection script deletion command deletes script files for agent for Agentless Monitoring management collection that have been deployed to a managed server.
The -h option can be used to specify the managed server of the script files to be deleted.
Note
Do not execute multiple sqcAgentlessCleanUp command simultaneously.
Information
The agent for Agentless Monitoring management collection script is deployed by restarting the service of the Manager or Proxy Manager.
Options
Specify the identifier of the managed server that you want to delete.
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 (delete failed): 1
Note
The following directory is not deleted when the managed server is Windows.
%USERPROFILE%\sqc_temp directory
(%USERPROFILE% : user profile folder path name
Execution results/Output format
The following normal completion message will be sent to standard output.
(Success):sqcAgentlessCleanUp.exe succeeded. |
C:\Program Files\SystemwalkerSQC\bin>sqcAgentlessCleanUp.exe The script for Agent for Agentless Monitoring management collection of the following servers is deleted. server1 : OK server2 : OK server3 : OK (Success):sqcAgentlessCleanUp.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. |
030 | Failure file delete. | File deleting error | Refer to "detail" of the message displayed in advance of this message and clear it up, then re-execute the command. |
100 | System error. | Other error | Collect maintenance information and contact a Fujitsu SE |
If the agent for Agentless Monitoring management collection script deletion command is performed using the following definition
[Identifier of the managed serve]
server1
server2
server3
[Sample error]
If the sqcAgentlessCleanUp command fails for file deletion Server2
C:\Program Files\SystemwalkerSQC\bin>sqcAgentlessCleanUp.exe The script for Agent for Agentless Monitoring management collection of the following servers is deleted. server1 OK server2 NG : detail=*****dsa_telnet***** ===== Connect Error ===== server: TestServer2 [Server2] SOCKET Message: The requested name is valid, but no data of the requested type was found. State: Start connection: Resolve host address server3 OK (Error 030): Failure file delete. |
Usage Example
[Windows]
C:\Program Files\SystemwalkerSQC\bin>sqcAgentlessCleanUp.exe The script for Agent for Agentless Monitoring management collection of the following servers is deleted. server1 : OK server2 : OK server3 : OK (Success):sqcAgentlessCleanUp.exe succeeded. |
[UNIX]
#cd /opt/FJSVssqc/bin #./sqcAgentlessCleanUp.sh The script for Agent for Agentless Monitoring management collection of the following servers is deleted. server1 : OK server2 : OK server3 : OK (Success):sqcAgentlessCleanUp succeeded. |
