Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference

[Contents][Index][Back][Next]

Cluster setup information file (jimdbclustersetupinfo.conf)

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

Table 2-46 Sizes of databases that are created

Size System database area (local disk)#1 (gigabytes) System database area (shared disk)#1 (gigabytes) Integrated monitoring database area#2 (gigabytes) IM Configuration Management database area#2 (gigabytes) Total (gigabytes)
S 0.05 0.95 9 1 11
M 0.1 1.9 33 1 36
L 0.6 7.4 96 10 114

#1
The system database area (local disk) is created immediately under the local database storage directory (IMMDBDIR) 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. 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

LOGICALHOSTNUMBER
Specifies the number used to identify the logical host for the IM database, expressed as a numeric value in the range from 1 to 9.
If you add a logical host, you must specify a different number. Specify the same number for both primary and secondary nodes.

LOGICALHOSTNAME
Specifies the name of the logical host. This must be a logical host name specified in the jp1cohasetup and jp1cc_setup_cluster commands. The permitted value is a string of no more than 32 characters, consisting of alphanumeric characters, _, -, /, . (period), and @.

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 (for 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 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
Specifies the port number used by the IM database. 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 for storing data for the IM database that is shared by the primary and secondary nodes in the cluster configuration. JP1/IM creates the imdb directory directly under the specified directory and stores the IM database files (for the shared data area).
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.

ONLINEHOSTNAME
Specifies the host name of the primary node. The permitted value is a string of no more than 32 characters, consisting of alphanumeric characters, _, -, /, . (period), and @.

IMDBENVDIR
Specifies the absolute path of the directory in which the IM database is to be installed. JP1/IM creates a directory (JMn: n matches LOGICALHOSTNUMBER) immediately under the specified directory and then installs the IM database. 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.
The following shows 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 (/).

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

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.