Cluster environment Intelligent Integrated Management Database setup information file (jimgndbclustersetupinfo.conf)

Format

#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=logical-host-name-of-the-intelligent-integrated-management-database
#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=port-number-for-intelligent-integrated-management-database
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=trend-data-management-service-port-number
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREGNDBDIR=data-storage-directory-for-intelligent-integrated-management-database
#IM GNDATABASE SERVICE - Data Base Binary 
IMGNDBENVDIR=directory-where-intelligent-integrated-management-database-is-installed
#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=logical-host-number
#IM GNDATABASE SERVICE - Retention
RETENTION=retention-period-of-time-series-data-in-trend-data-management-DB
#IM GNDATABASE SERVICE - Username
USERNAME=user-name-of-OS-used-to-start-intelligent-integrated-management-database
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=max-disk-requirements-of-trend-data-management-database
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=truncation-duration-when-trend-data-is-deleted

To Page Top

File

jimgndbclustersetupinfo.conf^#

jimgndbclustersetupinfo.conf.model (model file)

#: The installer creates it from a duplicate of the model file by deleting extension ".model".

To Page Top

Storage directory

In Windows

Manager-path\conf\imgndb\setup\

In UNIX

/etc/opt/jp1imm/conf/imgndb/setup/

To Page Top

Description

This file describes the definitions required when setting up a clustered environment for the Intelligent Integrated Management database.

To Page Top

Character code

ASCII (You cannot specify multi byte characters.)

To Page Top

When the definitions are applied

When setting up a clustered environment (when execution of jimgndbsetup command (with -h option specified)), this file is read and value specified for the items builds Intelligent Integrated Management Database environment for logical host.

To Page Top

Information that is specified

LOGICALHOSTNAME=logical-host-name-of-the-intelligent-integrated-management-database

Specifies the logical host name of the Intelligent Integrated Management database.

You can specify a character string of up to 63 bytes consisting of single-byte alphanumeric characters and hyphens (-). Uppercase and lowercase letters are sensitive.

If the value is empty or omitted, the value specified on the -h option of the jimgndbsetup command is used when the jimgndbsetup command is run.

Also, the logical host name must be a host name that can be resolved on the OS.

There is no default value.

IMGNDBPORT=port-number-for-intelligent-integrated-management-database

Specifies port number used by Intelligent Integrated Management Database.

The port number specified must be unique for each host that Setup creates.

There is no default value. This specification is not optional.

If you want to change the setting during operation, change this value and run the jimgndbsetup command. In a logical host environment, the service remains stopped rather than restarted due to command extensions, so you must manually start the service after running the command.

TDMSPORT=trend-data-management-service-port-number

Specifies the port number used by the Trend Data Management Service.

The port number that you specify must be unique for each system and host that Setup creates.

There is no default value. This specification is not optional.

If you want to change the setting during operation, change this value and run the jimgndbsetup command. In a logical host environment, the service remains stopped rather than restarted due to command extensions, so you must manually start the service after running the command.

SHAREGNDBDIR=data-storage-directory-for-intelligent-integrated-management-database

Specifies the absolute-path directory on the shared disk of the cluster environment where Intelligent Integrated Management Database for Logical host is stored.

• In Windows

  Specify a character string of up to 100 single-byte alphanumeric characters, including "_" (underscore), "\", "(", ")", and "." (period), and single-byte spaces.

• In Linux

  Specify a character string of up to 100 single-byte alphanumeric characters, including "_" (underscore), "/" (slash), and "." (period).

During setup, a directory with imgndb+logical-host-number is created directly under the specified directory, and Intelligent Integrated Management Database is constructed. If you have already built Intelligent Integrated Management Database, you cannot change it from the specification at the time of the build.

There is no default value. This specification is not optional.

IMGNDBENVDIR=directory-where-intelligent-integrated-management-database-is-installed

Specifies the absolute-path directory on the local disk where you want to install Intelligent Integrated Management Database for Logical host. Do not specify a shared disk in a clustered environment.

• In Windows

  Specify a character string of up to 200 single-byte alphanumeric characters, including "_" (underscore), "\", "(", ")", and "." (period), and single-byte spaces.

• In Linux

  Specify a character string of up to 200 single-byte alphanumeric characters, including "_" (underscore), "/" (slash), and "." (period).

When setting up, create a directory of imgndbbin+logical-host-number directly under the specified directory, and extract Intelligent Integrated Management Database. If you have already built Intelligent Integrated Management Database, you cannot change it from the specification at the time of the build.

The defaults are following:

In Windows: Manager-path\dbms

In Linux: /var/opt/jp1imm/dbms

If omitted, the default value is assumed.

LOGICALHOSTNUMBER=logical-host-number

Specifies the number to identify Logical host in Intelligent Integrated Management Database for logical host as a one-byte number from 1 to 9.

If you are adding a logical host, you cannot specify the same number as a number that already exists.

Specify the same number for the execution system and the standby system.

If you have already built Intelligent Integrated Management Database, you cannot change it from the specification at the time of the build.

There is no default value. This specification is not optional.

RETENTION=retention-period-of-time-series-data-in-trend-data-management-DB

Specify the retention period (unit: days) of the data stored in the trend data management DB.

The range is 1 to 1096.

The default is 32. If omitted, the default value is assumed.

If you want to change the setting during operation, change this value and run the jimgndbsetup command. In a logical host environment, the service remains stopped rather than restarted due to command extensions, so you must manually start the service after running the command.

USERNAME=user-name-of-OS-used-to-start-intelligent-integrated-management-database

Specifies OS username under which Intelligent Integrated Management Database is launched in Linux, that is, the user who actually exists for a user other than root and who can login it. If specified in Windows configuration, it is ignored.

There is no default value. This specification is not optional.

If you want to change the setting during operation, change this value and run the jimgndbsetup command. In a logical host environment, the service remains stopped rather than restarted due to command extensions, so you must manually start the service after running the command.

TDDBDISKMAX=max-disk-requirements-of-trend-data-management-database

Specifies the upper limit (in gigabytes) of the disk space required for Trend data Management Database. Automatic Delete occurs when Trend data Management Database disk requirements exceed 90% of this Value. If 0 is specified, the upper limit is not Setup.

The range is 0 or 10 to 131,072.

The default is 150. If the specification is omitted, the default value is assumed.

If you want to change setup during operation, change this value and execute jimgndbsetup command. Restart the service with the extension of the command. It will be reflected.

Notes

When using Monitoring Trend data Management Database Disk Requirements feature, we recommend that you specify a value that exceeds the 10-day data size of the trend data stored in Trend data Management Database.

TDDBCUTOFFTERM=truncation-duration-when-trend-data-is-deleted

Specifies the duration (in days) of the trend data to delete when Trend data Management Database disc requirements reach 90% of the size specified for TDDBDISKMAX. If TDDBDISKMAX is 0, this field is ignored.

The range is 1 to 31.

The default is 7. If the specification is omitted, the default value is assumed.

If you want to change setup during operation, change this value and execute jimgndbsetup command. Restart the service with the extension of the command. It will be reflected.

To Page Top

Example definition

• In Windows

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=1
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=
#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=5433
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=5434
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREGNDBDIR=S:\share\JP1IMM\gndb
#IM GNDATABASE SERVICE - Data Base Binary 
IMGNDBENVDIR=C:\Program Files (x86)\Hitachi\JP1IMM\dbms
# IM GNDATABASE SERVICE - Retention
RETENTION=32
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=764
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=7

• In Linux

#IM DATABASE SERVICE - Logical Host Number
LOGICALHOSTNUMBER=1
#IM DATABASE SERVICE - Logical Host Name
LOGICALHOSTNAME=
#IM GNDATABASE SERVICE - Port Number
IMGNDBPORT=5433
#TREND DATA MANEGEMENT SERVICE - Port Number
TDMSPORT=5434
#IM DATABASE SERVICE - Data Storage Directory (Shared Data Area)
SHAREGNDBDIR=/share/jp1imm/gndb
#IM GNDATABASE SERVICE - Data Base Binary 
IMGNDBENVDIR=/var/opt/jp1imm/dbms
# IM GNDATABASE SERVICE - Retention
RETENTION=32
# IM GNDATABASE SERVICE - Username
USERNAME=USER01
# TREND DATA DATABASE - MAX DISK SIZE [GB]
TDDBDISKMAX=764
# TREND DATA DATABASE - CUT-OFF TERM [Days]
TDDBCUTOFFTERM=7

To Page Top