jpctool service sync
- Organization of this page
Format
jpctool service sync [-lhost logical-host-name]
Function
The jpctool service sync command synchronizes the service information between PFM - Manager and PFM - Web Console.
After the service information about agents registered in Performance Management is deleted on the PFM - Manager host, the change (deletion) is applied to PFM - Web Console when this command is executed.
Hosts that can execute the command
PFM - Manager
Execution permission
- In Windows:
-
User with Administrators permissions
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pc/tools/
Arguments
-lhost logical-host-name
If you execute this command in a logical host environment rather than in a physical host environment, specify this option to specify the name of the logical host. For logical-host-name, specify a string of 1 to 32 bytes, consisting of single-byte alphanumeric characters with no space characters. If you omit this option, the command will be executed on the physical host. Wildcard characters cannot be used.
Notes
-
You can execute this command only when PFM - Manager is running.
-
Agents added to the User Agents tree in PFM - Web Console cannot be deleted by executing this command. The icons of these agents are dimmed when this command is executed. If you do not want these agents to be displayed, delete them manually.
-
To enable the deletion of service information, execute this command, and then perform one of the following operations:
-
When the PFM - Web Console version is earlier than 09-10-05:
Restart PFM - Manager and PFM - Web Console.
-
When the PFM - Web Console version is 09-10-05 or later:
Redisplay the agent hierarchy in the PFM - Web Console window.
-
Return values
|
0 |
The command terminated normally. |
|
1 |
An argument specification is invalid. |
|
2 |
The user does not have execution permission for the command. |
|
4 |
A startup or termination command, or other setup command, has been executed on the same machine. |
|
5 |
PFM - Manager has not been installed. |
|
100 |
The Performance Management environment is invalid. |
|
101 |
The PFM - Manager service has not started. |
|
102 |
The specified logical host has not been set up. |
|
200 |
A memory shortage occurred. |
|
210 |
A disk space shortage occurred. |
|
211 |
A file or directory cannot be accessed. |
|
255 |
An unexpected error occurred. |
Usage example
This example synchronizes agent service information when PFM - Manager is running on a physical host.
jpctool service sync