jpctool config mgrimport

Format

jpctool config mgrimport    -d import-source-directory
                            [-noprogress]

To Page Top

Function

The jpctool config mgrimport command imports a definition information file of the PFM - Manager in a multiple-monitoring environment from a specified directory.

The definition information that can be imported is as follows:

• Alarm information (alarm and action definitions)

• Bind information

• Report definition

• Business group definition

• Performance Management user account information (including the information about agent hierarchy [User Agents])

• Auto alarm bind setting

Before importing the definition information, the jpctool config mgrimport command checks whether the definition information specified by the -d option matches that stored in the import-destination directory. For details about checking the definition information, see Appendix F. Checking the Definition Information.

To Page Top

Hosts that can execute the command

PFM - Manager

To Page Top

Execution permission

In Windows:

User with Administrators permissions (When the UAC of Windows is enabled, execute this command from the administrator console.)

In UNIX:

User with root user permissions (user with uid = 0)

To Page Top

Installation directory

In Windows:

\installation-folder\tools\

In UNIX:

/opt/jp1pc/tools/

To Page Top

Arguments

To Page Top

Notes

• Before executing the command in UNIX, the current directory must be changed to the command's installation directory.

• This command requires the version of PFM - Manager on the execution host to be 10-10 or later.

• This command cannot be executed together with the start or stop command or any other setup command on the same host.

• This command must be executed in a multiple-monitoring environment.

• The definition information specified by the -d option must match the definition information stored in the import-source directory. If discrepant definition information is found, a KAVE06142-E message will be output. If this occurs, check the error content, and then re-execute this command.

• The jpctool config mgrimport command must not be executed concurrently.

• Before executing this command, you must execute the jpctool config mgrexport command to export the definition information.

• The versions of the PFM - Manager on the primary host and secondary host must be the same.

• The PFM - Manager service on the execution host must not be running.

• Before executing this command, make sure that there is enough disk space available. As a rule of thumb, each of the following drives must have as much available disk space as the space used for the definition information exported by the jpctool config mgrexport command.

  • Drive that includes the directory specified by the -d option

  • Drive that includes the PFM - Manager environment running on the execution host

  If the above two drives are located on a single drive, the single drive must have space available that is two times as large as the space used for the definition information to be imported.

• If an error occurs during command execution, a backup file might be left in the PFM - Manager installation directory.

• If processing is canceled during command execution, the PFM - Manager environment might become invalid.

• You cannot specify a write-protected medium, such as a CD or DVD, as import-source-directory in the -d option.

• Do not cancel processing during command execution by pressing Ctrl+C.

To Page Top

Return values

To Page Top

Usage example

This example imports definition information from the /tmp/pfmimport directory.

jpctool config mgrimport -d /tmp/pfmimport

To Page Top

Output examples

The following shows an example of messages output to the standard output when the import of definition information has succeeded:

KAVE06139-I Import of the multiple monitoring definitions will now start.
KAVE06143-I Import of the definitions will now start. (config=alarm definitions)
KAVE06144-I Import of the definitions ended normally. (config=alarm definitions)
KAVE06143-I Import of the definitions will now start. (config=action definitions)
KAVE06144-I Import of the definitions ended normally. (config=action definitions)
KAVE06143-I Import of the definitions will now start. (config=bind information)
KAVE06144-I Import of the definitions ended normally. (config=bind information)
KAVE06143-I Import of the definitions will now start. (config=report definitions)
KAVE06144-I Import of the definitions ended normally. (config=report definitions)
KAVE06143-I Import of the definitions will now start. (config=tenant group definitions)
KAVE06144-I Import of the definitions ended normally. (config=tenant group definitions)
KAVE06143-I Import of the definitions will now start. (config=PFM user account information)
KAVE06144-I Import of the definitions ended normally. (config=PFM user account information)
KAVE06140-I Import of the multiple monitoring definitions ended normally.

KAVE06142-E The specified definition differs from the PFM - Manager definition. (Configure the health check function)
KAVE06142-E The specified definition differs from the PFM - Manager definition. (jpccomm.ini, section=Common Section, label=Multiple Alarm Table Bind)
KAVE06142-E The specified definition differs from the PFM - Manager definition. (HealthCheck, Property=Detail Records->PD->Log)

To Page Top