Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager Command, Definition File and API Reference


jcfdbsetup

Organization of this page

Function

This command sets up the IM Configuration Management database for storing configuration information. You must have already specified in advance in the setup information file the database's size, port number, and storage location.

In Windows, if this command is executed in an environment where the integrated monitoring database is not set up, the following services are registered in the OS:

In UNIX, if this command is executed in an environment where the integrated monitoring database is not set up, an entry containing the path to the IM database is added to the /etc/inittab file. The entry is added to the respective physical and logical hosts on which the command was executed. Do not delete, edit, or comment out the entry in the /etc/inittab file that is added when this command is executed.

Format

jcfdbsetup {-f setup-information-file-name|-s}
           [-h logical-host-name -c {online|standby}]
           [-q]

Execution permission

In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)

In UNIX: Superuser permissions

Storage directory

In Windows:

Manager-path\bin\imdb\

In UNIX:

/opt/jp1imm/bin/imdb/

Arguments

-f setup-information-file-name

Specifies the setup information file that contains the requisite information, such as the installation folder and the size of the database area. If neither an IM Configuration Management database nor an integrated monitoring database has been set up, you must specify this option. If the integrated monitoring database has already been set up, specify in this option the setup information file that you specified when you set up the integrated monitoring database. Alternatively, if the integrated monitoring database has already been set up, you can specify the -s option instead. In such a case, the command uses the setup information that was specified when the integrated monitoring database was set up.

This option cannot be specified together with the -s option. Additionally, the -f and -s options cannot both be omitted.

If the path contains a space, enclose the entire path in double-quotation marks ("). If you configure a cluster environment, specify the cluster setup information file name.

-s

If the integrated monitoring database has already been set up, you can specify this option instead of the -f option. When this option is specified, the command sets up the IM Configuration Management database using the setup information that was specified when the integrated monitoring database was set up.

If the integrated monitoring database has not been set up but this option is specified, the command displays the KNAN11193-E message.

This option cannot be specified together with the -f option. Additionally, the -s and -f options cannot both be omitted.

-h logical-host-name

When you are operating in a cluster system, this option specifies the logical host name of the host that executes the command. The command sets up the IM Configuration Management database for the specified logical host. If you do not use a cluster system, specification of this option is not needed. Note that this logical host name cannot be JP1_DEFAULT. In addition, the logical host name is case sensitive. For the logical host name, specify a logical host name set in JP1/Base in the correct form, especially case.

-c {online|standby}

Specifies the setup type in the cluster configuration (primary node or secondary node). If you have specified the -h option, you must specify this option. In addition, if the integrated monitoring database has already been set up on the same host, for the -c option, specify the same value that you used when you created the integrated monitoring database.

  • online: Specifies that the primary node is to be set up.

  • standby: Specifies that the secondary node is to be set up.

If you specify online, mount the shared disk and establish a connection to the logical host. If you are running a logical host in a non-cluster environment, specify online in the -c option.

-q

Specifies that the command is to be executed without requesting confirmation from the user.

Return values

0

Normal termination

1

Abnormal termination

Notes