jpctool config alarmsync

Organization of this page

Format
Function
Hosts that can execute the command
Execution permission
Installation directory
Arguments
Notes
Return values
Usage example

Format

jpctool config alarmsync     [-noprogress]
                             [-target alarm-application-status]

To Page Top

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.

To Page Top

Hosts that can execute the command

PFM - Manager

To Page Top

Execution permission

In Windows:: User with Administrators permissions
In UNIX:: User with root user permissions

To Page Top

Installation directory

In Windows:: installation-folder\tools\
In UNIX:: /opt/jp1pc/tools/

To Page Top

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.

To Page Top

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.

To Page Top

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.

To Page Top

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.

To Page Top