Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Integrated Management - 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

File

jimdbsetupinfo.conf (setup information file)

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

Storage directory

In Windows

Manager-path\conf\imdb\setup\

In UNIX

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

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 following table shows the sizes of the databases as specified in the setup information file and the actual sizes of the databases that are created.

Table 2‒69: Sizes of databases that are created

Size

System database area# (gigabytes)

Integrated monitoring database area# (gigabytes)

IM Configuration Management database area# (gigabytes)

Total (gigabytes)

S

1.4

8.3

1.1

10.8

M

2.7

32.5

1.1

36.3

L

6.8

97.1

10.4

114.3

#

The system database area, the integrated monitoring database area, and the IM Configuration Management database area are created immediately under the database storage directory (IMMDBDIR) specified in the setup information file. The capacity required for installation is 110 megabytes.

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.

Information that is specified

IMDBSIZE

Specifies the size of the IM database to be created as the upper-case 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-70.

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‒70: Correspondence between OS and directory permissions

    OS

    Permission

    AIX

    Owner: root

    Group: system

    Mode: 755

    Linux

    Owner: root

    Group: root

    Mode: 755

    Linux (IPF)

    Owner: root

    Group: root

    Mode: 755

    Solaris

    Owner: root

    Group: sys

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

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=