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 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.
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.
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 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-88 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‒88: 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 and JP1/OA running on another host. If there is no linkage with JP1/IM - MO and JP1/OA on other hosts, do not define the line that specifies this item.
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=