jpctool config alarmsync
- Organization of this page
Format
jpctool config alarmsync [-noprogress] [-target alarm-application-status]
Function
This command applies alarm information to services whose alarm application status is Failed (failed to be applied) or Uncertain (status unknown). You can also target execution to only those services whose status is Failed (failed to be applied) or to only those services whose status is Uncertain (status unknown). After executing the jpctool config alarmsync command, execute the jpctool alarm unapplied command to verify whether the alarm information was properly applied.
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
-noprogress
If this option is specified, the progress of the application processing is not output.
-target alarm-application-status
Specify this option if you want to target execution to only services whose status is Failed (failed to be applied) or only services whose status is Uncertain (status unknown). Specify the alarm application status to be targeted in alarm-application-status.
Notes
-
Multiple instance of this command cannot be executed concurrently.
-
This command cannot be executed concurrently with the command jpctool config sync on the same host.
-
When performing multiple monitoring, you cannot execute this command from the secondary PFM - Manager host.
-
This command cannot be used if the PFM - Manager service (Master Manager and View Server services) is not running.
-
This command cannot be executed on a standby node in a logical host environment.
-
This command terminates successfully even when the alarm application status is not finalized as a result of executing the command.
-
This command terminates successfully even when executed in a situation in which there is no service whose alarm application status is Failed (failed to be applied) or Uncertain (status unknown).
-
If the PFM - Manager service stops while this command is being executed, or if execution of this command is interrupted by a signal or by pressing Ctrl + C, this command stops executing. Re-execute the command to make sure the alarm information is correctly applied.
-
If the system environment is large, it might take a long time to apply the alarm information.
The required processing time can be estimated as follows:
(number of Collector services that are application targets#) × 4 + (number of Action Handler services that are application targets) × 2 + 300 seconds
For example, in a situation where the number of Agent Collector services is 2,500 and the number of Action Handler services is 2,500, the estimated processing time will be about 255 minutes.
#: Collector services include Agent Collector services and Remote Monitor Collector services.
Return values
0 |
The command terminated normally. |
1 |
The command line format is invalid. |
2 |
The user does not have execution permission for the command. |
5 |
The command was executed on a host that was not the PFM - Manager host. |
12 |
The command jpctool config sync or jpctool config alarmsync is currently executing. |
17 |
This command was executed from the secondary PFM - Manager in a multiple-monitoring environment. |
101 |
The Master Manager service is not running. |
200 |
A memory shortage occurred. |
211 |
A file or directory cannot be accessed. |
221 |
An attempt to acquire information on the alarm application status from the Master Manager service failed. |
222 |
An error occurred during communication processing. |
237 |
A timeout occurred while determining the results of applying the alarm information. |
255 |
An unexpected error occurred. |
Usage example
>jpctool config alarmsync KAVE06201-I Application processing of the alarm definition and action definition will now start. [50/50] KAVE06205-I Processing of the application results judgment will now start. KAVE06206-I Processing of the application results judgment ended normally. KAVE06202-I Application processing of the alarm definition and action definition ended normally.