Hitachi

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

Setup information file (jimdbsetupinfo.conf)

Organization of this page

Format

#IM DATABASE SERVICE - DB Size
IMDBSIZE=value
#IM DATABASE SERVICE - Data Storage Directory
IMDBDIR=value
#IM DATABASE SERVICE - Port Number
IMDBPORT=value
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=value
#IM DATABASE SERVICE - Host Name
IMDBHOSTNAME=value

To Page Top

File

jimdbsetupinfo.conf (setup information file)

jimdbsetupinfo.conf.model (model file for the setup information file)

To Page Top

Storage directory

In Windows

Manager-path\conf\imdb\setup\

In UNIX

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

To Page Top

Description

This file specifies setup information, such as the size of the IM database and the directory for storing data for the IM database, when the integrated monitoring database and IM Configuration Management database are set up.

The 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.

The table below describes the approximate amount of disk space used per size of the IM database, which you must specify in the 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‒81: Sizes of databases that are created

Size

System database area#1, #2 (gigabytes)

Integrated monitoring database area#1, #3 (gigabytes)

IM Configuration Management database area#1, #4 (gigabytes)

Total (gigabytes)

S

2

9

2

13

M

3

33

2

38

L

7

98

11

116
#1

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

#2

Area shared by the IM Configuration Management database and integrated monitoring database created during setup of the IM database.

#3

Area created when the jcodbsetup command is executed.

#4

Area created when the jcfdbsetup command is executed.

To Page Top

When the definitions are applied

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

To Page Top

Information that is specified

IMDBSIZE

Specifies the size of the IM database to be created as the uppercase letter S, M, or L. The default is S.

IMDBDIR

Specifies the absolute path of the directory in which data for the IM database is to be stored. JP1/IM creates the imdb directory immediately under the specified directory and then stores the IM database file (area). The default is as follows:

  • In Windows: Manager-path\database

    An error results if a network drive or Windows reserved device file is specified. If the specified directory cannot be found, command execution fails. You must create the directory before executing the command.

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

    Specify a directory whose status is mounted. 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 cannot be found, command execution fails. You must create the directory before executing the command.

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

The following explains 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

Specifies the port number used by the IM database. The permitted value range is from 5001 to 65535. The default is 20700.

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.

IMDBENVDIR

Specifies the absolute path of the directory in which the IM database is to be installed. Creates a directory under the specified directory (JMn: n matches LOGICALHOSTNUMBER), and then install the IM database.

  • 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. In addition, do not specify a path that contains a symbolic link.

    The following table explains the directory permissions.

    Table 2‒82: Correspondence between OS and directory permissions

    OS

    Permission

    Linux

    Owner: root

    Group: root

    Mode: 755

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

  • 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 (/).

IMDBHOSTNAME

Specifies the host name or the IP address to be used for communication with JP1/IM - MO running on another host. If there is no linkage with JP1/IM - MO on another host, this item need not be specified.

By default, a local host name is specified. If this value is omitted, the local host name is assumed. You can specify a maximum of 32 characters. Specifiable characters are alphanumeric characters, the hyphen (-), the underscore (_), the at mark (@), and the period (.).

To Page Top

Example definition

#IM DATABASE SERVICE - DB Size
IMDBSIZE=S
#IM DATABASE SERVICE - Data Storage Directory
IMDBDIR=Manager-path\database
#IM DATABASE SERVICE - Port Number
IMDBPORT=20700
#IM DATABASE SERVICE - DB Install Directory
IMDBENVDIR=Manager-path\dbms
#IM DATABASE SERVICE - DB Host Name
IMDBHOSTNAME=

To Page Top

Copyright (C) 2019, 2020, Hitachi, Ltd.

Copyright (C) 2019, 2020, Hitachi Solutions, Ltd.