Hitachi

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


Cluster setup information file (jimdbclustersetupinfo.conf)

Organization of this page

Format

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=value
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=value
#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Port Number
IMDBPORT=value
#IM DATABASE SERVICE - Data Storage Directory (Local Work Area)
IMDBDIR=Manager-path\db
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREDBDIR=shared-directory\db
#IM DATABASE SERVICE - Online Host Name
ONLINEHOSTNAME=value
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Manager-path\dbms

File

jimdbclustersetupinfo.conf (cluster setup information file)

jimdbclustersetupinfo.conf.model (model file for the cluster setup information file)

Storage directory

In Windows

Manager-path\conf\imdb\setup\

In UNIX

/etc/opt/jp1imm/conf/imdb/setup/

Description

This file specifies the IM database size for a logical host, or the directory for storing data of the IM database for a logical host when the integrated monitoring database and IM Configuration Management database are set up in a cluster environment.

The cluster setup information file is shared during setup of the integrated monitoring database and IM Configuration Management database. If you have set up one of the databases (integrated monitoring database or IM Configuration Management database) first and then are creating the other one, you must specify for the second database the same values as were specified for the first database. If you are configuring a cluster environment, when you set up the secondary node, copy the cluster setup information file used for the primary node. If you set up multiple logical hosts on the same host, you must copy jimdbclustersetupinfo.conf (cluster setup information file) under a different name and change the settings.

The table below describes the approximate amount of disk space used per size of the IM database, which you must specify in the cluster setup information file.

Note that, in addition to the areas described in the table below, approximately 0.2 gigabytes of free space is required in the directory in which to install the IM database (IMDBENVDIR), whatever the size of the IM database. For details about the specific amount of disk space used, see the Release Notes for JP1/IM - Manager. We recommend that you use the values provided in the Release Notes for JP1/IM - Manager when you estimate the amount of disk space used.

Table 2‒83: Sizes of databases that are created

Size

Local disk

Shared disk

System database area (local disk)#1 (gigabytes)

System database area (shared disk)#2 (gigabytes)

Integrated monitoring database area#2 (gigabytes)

IM Configuration Management database area#2 (gigabytes)

Total (gigabytes)

S

0.1

2

9

2

13

M

0.1

3

33

2

38

L

0.2

7

98

11

116

#1

The system database area (local disk) is created immediately under the local database storage directory (IMDBDIR) specified in the cluster setup information file.

#2

The system database area (shared disk), the integrated monitoring database area, and the IM Configuration Management database area are created immediately under the shared database storage directory (SHAREDBDIR) specified in the cluster setup information file.

When the definitions are applied

The contents of this file are loaded during setup, and the IM database environment for a logical host is configured based on the value specified for each item.

Information that is specified

LOGICALHOSTNUMBER

Specify a value from 1 to 9 as the number to identify a logical host in the IM database for a logical host.

If you add a logical host, you must specify a different number. Specify the same number for both primary and secondary nodes.

LOGICALHOSTNAME

Specify the name of a logical host. This must be a logical host name that can be resolved, and specified in the jp1cohasetup and jp1cc_setup_cluster commands. The IM database does not reference the jp1hosts and jp1hosts2 files. Therefore, for LOGICALHOSTNAME, specify a logical host name whose name is in the hosts file or can otherwise be resolved using the OS's name resolution capability. The permitted value is a string of no more than 32 characters, consisting of alphanumeric characters, _, -, /, . (period), and @. The logical host name is case sensitive. As the logical host name, specify the logical host name set in JP1/Base in the correct format, especially case. For details on how to set up JP1/Base on a logical host, see the sections below in the JP1/Integrated Management 2 - Manager Configuration Guide:

  • In Windows

    See 7.3.3(2) Setting up JP1/Base

  • In UNIX

See 8.3.3(2) Setting up JP1/Base

IMDBSIZE

Specify the size of the IM database for a logical host to be created by using uppercase letters S, M, or L. The default is S.

IMDBDIR

Specify the absolute path of the directory in which data of the IM database for a logical host is to be stored. Do not specify the shared disk in a cluster. JP1/IM creates the imdb directory immediately under the specified directory, and then stores the IM database file (for a local work area).

  • In Windows:

    An error results if a network drive or Windows reserved device file is specified. If the specified directory does not exist, command execution fails. Make sure that you create the directory before you execute the command.

  • In UNIX:

    Specify a directory that is in mounted status. Do not specify a directory that is easily unmounted. If the directory is unmounted during operation, database startup and access will fail. If the specified directory does not exist, command execution fails. Make sure that you create the directory before you execute the command.

    The following table describes the directory permissions.

    Table 2‒84: Correspondence between OS and directory permissions

    OS

    Permission

    Linux

    Owner: root

    Group: root

    Mode: 755

The following shows the character string that can be used in the absolute path format:

  • In Windows:

    A string of no more than 95 characters, consisting of alphanumeric characters, _, \, (, ), and . (period). This character string must begin with the drive name.

  • In UNIX:

    A string of no more than 95 characters, consisting of alphanumeric characters, _, /, and . (period). This character string must begin with the path delimiter (/).

IMDBPORT

Specify the port number used by the IM database for a logical host. The permitted value range is from 5001 to 65535.

This port number must be different from any of the following port numbers:

  • Port numbers specified when other logical hosts were set up

  • Port numbers specified in the services file#

  • Port numbers used in other products' HiRDB installation

  • Temporary port numbers used by other products and the OS

#: Make sure that you do not specify the port number set in IMDBPORT in the services file.

SHAREDBDIR

Specifies the absolute path of the directory in which data of the IM database for a logical host that is shared by the primary and secondary nodes in a cluster configuration is to be stored. Specify a directory on a shared disk. JP1/IM creates the imdb directory immediately under the specified directory, and stores the IM database files (for the shared data area) for a logical host.

The following shows the character string that can be used in the absolute path format:

  • In Windows:

    A string of no more than 95 characters, consisting of alphanumeric characters, _, \, (, ), and . (period). This character string must begin with the drive name.

    An error results if a network drive or Windows reserved device file is specified. If the specified directory does not exist, command execution fails. Make sure that you create the directory before you execute the command.

  • In UNIX:

    A string of no more than 95 characters, consisting of alphanumeric characters, _, /, and . (period). This character string must begin with the path delimiter (/).

    Specify a directory that is in mounted status. Do not specify a directory that is easily unmounted. If the directory is unmounted during operation, database startup and access will fail. If the specified directory does not exist, command execution fails. Make sure that you create the directory before you execute the command. For details about the necessary directory permissions, see Table 2-84Correspondence between OS and directory permissions.

ONLINEHOSTNAME

Specifies the host name of the primary node. Specify a host name that can be resolved for the primary node. The permitted value is a string of no more than 32 characters, consisting of alphanumeric characters, _, -, /, . (period), and @. The executing host name is also case sensitive. Specify the executing host name in the correct form, especially case.

IMDBENVDIR

Specify the absolute path of the directory in which the IM database for a logical host is to be installed. Do not specify a shared disk in the cluster. Create a directory (JMn: n matches LOGICALHOSTNUMBER) immediately under the specified directory, and then install the IM database for a logical host. The default is as follows:

  • In Windows: Manager-path\dbms

    An error results if a network drive or Windows reserved device file is specified. If the specified directory does not exist, command execution fails. Make sure that you create the directory before you execute the command.

  • In UNIX: /var/opt/jp1imm/dbms

    Specify a directory that is in mounted status. Do not specify a directory that is easily unmounted. If the directory is unmounted during operation, database startup and access will fail. If the specified directory does not exist, command execution fails. Make sure that you create the directory before you execute the command.

    For details about the necessary directory permissions, see Table 2-84 Correspondence between OS and directory permissions.

The following shows the character string that can be used in the absolute path format: In addition, do not specify a path that contains a symbolic link.

  • In Windows:

    A string of no more than 195 characters, consisting of alphanumeric characters, _, \, (, ), and the space. This character string must begin with the drive name.

  • In UNIX:

    A string of no more than 123 characters, consisting of alphanumeric characters, _, /, and . (period). This character string must begin with the path delimiter (/).

Example definition

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=1
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=host1
#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Data Storage Directory (Local Work Area)
IMDBDIR=Manager-path\db
#IM DATABASE SERVICE - Port Number
IMDBPORT=20750
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREDBDIR=shared-directory\db
#IM DATABASE SERVICE - Online Host Name
ONLINEHOSTNAME=host_H1
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Manager-path\dbms