jpctool db import

Organization of this page

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

Format

Format 1

jpctool db import    -key service-key
                     [-inst instance-name]
                     [-lhost logical-host-name]
                     [-force]
                     -d backup-directory[-add]

Format 2

jpctool db import    -key service-key
                     [-inst instance-name]
                     [-lhost logical-host-name]
                     [-force]
                     -clear

To Page Top

Function

The jpctool db import command imports backup data into the Store database.

The jpctool db import command can be used only when the Store version of the target Store service is 2.0.

To Page Top

Hosts that can execute the command

PFM - Manager
PFM - Agent
PFM - RM

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

`-key` `service-key`

Specifies the service key of the Store service into which backup data is imported. A product name can also be specified when the product name display functionality is enabled. You can specify only the service key of PFM - Agent or PFM - RM here. For details about the service key of the PFM - Agent or PFM - RM, see the naming rules described in the appendix of the JP1/Performance Management Planning and Configuration Guide.

`-inst` `instance-name`

Specifies the name of the instance into which backup data is imported. For instance-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters.

This option must be specified when the target Store service is on a multi-instance agent. You cannot specify this option for single-instance agents.

`-lhost` `logical-host-name`

Specifies the logical host name of the Store service into which backup data is imported. For logical-host-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters.

If you omit this option, the setup is performed for the Store service on the physical host.

`-force`

When you specify this option, a confirmation message does not appear.

`-d` `backup-directory`

Specifies the name of the backup directory containing the data to be imported. You can specify only a directory on the local disk. You cannot specify the following characters in the backup directory name:

; , * ? ' " < > |

Use 1 to 214 bytes (but none of the above characters) to specify a relative path or the full path. When you specify a relative path, specify the path from the directory that is the current directory when the command is executed.

`-add`

When you specify this option, new data is imported without affecting existing imported data. If you omit this option, existing import data is deleted when new data is imported.

`-clear`

Deletes the imported data.

To Page Top

Notes

An error occurs if the product ID or the data model version is not the same for the specified Store service and the backup directory.
When execution of the jpctool db import command attempts to overwrite or delete imported data, the following confirmation message appears:

KAVE05874-Q If you continue the processing, the import data will be initialized. Do you want to continue? (Y/N)

Processing continues only when you enter y or Y. However, when the -force option is specified, the command is executed without displaying a confirmation message.
When this command is executed, the PFM - Agent or PFM - RM service specified by the service key must be running.

To Page Top

Return values

`0`	The command ended normally.
`1`	An argument is specified incorrectly.
`2`	The user does not have execution permission for the command.
`3`	The specified service is not running.
`5`	The specified PFM - Agent or PFM - RM has not been installed.
`10`	The command is being executed.
`11`	The user canceled the processing.
`12`	Importing is disabled for the specified version of the Store service.
`100`	The Performance Management environment is invalid.
`102`	The specified logical host or instance is not set up.
`104`	The specified Store service is being backed up or is exporting data.
`200`	A memory shortage occurred.
`210`	A disk space shortage occurred.
`211`	The file or directory cannot be accessed.
`222`	A communication processing error occurred.
`255`	An unexpected error occurred.

To Page Top