jimgndbsetup
- Organization of this page
Function
Set up (install and build databases) Intelligent Integrated Management Database and Trend Data Management Services.
Also, if set up already, check and modify Setup of the database.
Format
jimgndbsetup {-f setup-information-file-name [-h logical-host-name -c {online|standby}] [-q] | -display [-h logical-host-name] }
The command arguments are in no particular order.
Execution permission
In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)
In Linux: Superuser permissions
Storage directory
- In Windows:
-
Manager-path\bin\imgndb\
- In Linux:
-
/opt/jp1imm/bin/imgndb/
Arguments
- -f setup-information-file-name
-
Specifies the directory where Intelligent Integrated Management Database is installed and setup information file for the IM database that describes Port number. Depending on the configuration of Intelligent Integrated Management Database, specify the following File:
- When building in a physical host environment
-
Intelligent Integrated Management Database Setup Information File Name
- When building in a cluster environment
-
Cluster Environment Intelligent Integrated Management Database Setup Information File Name
The file name is specified in the form of a full path or a path relative to where this command is run. If the path contains spaces, enclose it in """.
- -h logical-host-name
-
If the cluster environment Intelligent Integrated Management database setup information file name is specified on the -f option, a logical host name is required. For the logical host name, specify the logical host name set in JP1/Base exactly, including uppercase and lowercase letters.
Sets up the Intelligent Integrated Management database for the specified logical host. If you are not using a cluster system, you do not need to specify it.
Note that JP1_DEFAULT cannot be specified for the logical host name.
- -c {online|standby}
-
When the -h option is specified, the setup type of the execution system and the standby system of the cluster configuration is specified as required. The following are the setup types that you can specify:
-
online
Specify to set up an execution system.
-
standby
Specify to set up a standby system.
Only install Intelligent Integrated Management Database and skip building databases.
If standby is specified on the -c option on both the execution system and the standby system, the database will not be built. In this case, unset after the command ends, and then rerun the command.
Also, when operating a logical host in a non-clustered environment, specify online.
-
- -q
-
Specifies that the command is to be executed without user confirmation.
- -display
-
Specify if you want to check if Intelligent Integrated Management Database and Trend Data Management Services are built.
If it is already built, the following setup setting information is output as a KNAN12094-I message.
-
Port number of the intelligent integrated management database
-
Trend Data Management Service port number
-
Data storage directory
-
Installation directory
-
Data retention period
-
Return values
0 |
Normal termination |
1 |
Abnormal termination |
2 |
Abnormal termination (If you suspect that a file or process may remain) |
3 |
Canceled by user (if you enter N/n in KNAN12009-Q Message and Stopped the operation) |
Log output
This command outputs the following trace log for each process: The integrated trace log is not output.
-
File name
jimgndbsetup{1|2}.log#
#: {1|2} is a number of faces of the file.
-
File size (number of faces)
256KB (2 faces)
-
Output destination
- In Windows:
-
Physical host and Logical host
Manager-path\log\imgndb\
- In Linux:
-
Physical host and Logical host
/var/opt/jp1imm/log/imgndb/
-
Notes
-
The contents of the executable and standby cluster environment intelligent integrated management database setup information files must be the same. When setting up the standby system, copy and use the cluster environment intelligent integrated management database setup information file used in the execution system. If the contents of the file specified in the execution system and the standby system are different, after unsetting on the standby system, copy the cluster environment intelligent integrated management database setup information file from the execution system and reexecute the command.
-
When executing a command with the -c option, do not switch servers during execution. If you switch servers while running, unset them up after the command ends, and then rerun the command.
-
The following are precautions when processing is aborted by pressing Ctrl + C or Ctrl + Break during command execution.
- Ensure that the pg_ctl, postgres, and promscale processes are not running, run the jimgndbunsetup command, and rerun the command. If these processes are running, wait some time for them to end and rerun this command.
- Processing is aborted, but messages may be output corrupted.
- If you want to execute the command again after stopping the process, check the directory specified in the entry "IMGNDBDIR" of the Intelligent Integrated Management Database Setup Information File or the entry "SHAREGNDBDIR" of the Cluster Environment Intelligent Integrated Management Database Setup Information File, and if the file or directory exists, Remove them and empty them before running.
-
This command cannot be multiplexed. It cannot be run concurrently with other operational commands in the Intelligent Integrated Administration database.
For details about Intelligent Integrated Management Database operation command multiplexing execute, see About multiple execution of the commands related to the Intelligent Integrated Management Database.
-
If you change the logical host settings with this command, the service remains stopped without restarting. In this case, you must manually start the service after running the command.
-
Since the Intelligent Integrated Management Database communicates with localhost, the IP address of localhost must be resolvable. Otherwise, setup fails.
Example 1
-
In case of successful completion
>jimgndbsetup -f intelligent-integrated-management-database-setup-information-file-name KNAN12005-I The Intelligent Integrated Management Database will be set up. KNAN12088-I Intelligent Integrated Management Database installation directory : directory-name KNAN12006-I Data storage directory for the Intelligent Integrated Management Database : directory-name KNAN12007-I Port number for the Intelligent Integrated Management Database : port-number KNAN12008-I Data retention period for the Trend Data Management Database : data-saved-period KNAN12009-Q Do you want to continue processing? (Y/N) :Y KNAN12010-I Setup for the Intelligent Integrated Management Database will now start. KNAN12020-I Please wait. KNAN12089-I The Intelligent Integrated Management Database will be installed. KNAN12090-I The Intelligent Integrated Management Database has been installed. KNAN12013-I The Intelligent Integrated Management Database will be configured. KNAN12014-I The Intelligent Integrated Management Database was configured. KNAN12012-I Setup for the Intelligent Integrated Management Database ended normally.
-
In case of an abend (when the required fields in the Intelligent Integrated Management database setup information file are not specified)
>jimgndbsetup -f intelligent-integrated-management-database-setup-information-file-name KNAN12005-I The Intelligent Integrated Management Database will be set up. KNAN12022-E One or more required items are not specified in the database setup information file. (item name : item-name)
Example 2
-
If you want to check the configured information
>jimgndbsetup -display KNAN12094-I The Intelligent Integrated Management Database is already set up. Port number for the Intelligent Integrated Management Database : port-number Port number for the trend data management service : port-number Data storage directory : directory-path Installation directory : directory-path Trend data retention period : retention-period
Example 3
-
If you want to change the settings
>jimgndbsetup -f intelligent-integrated-management-database-setup-information-file-name KNAN12005-I The Intelligent Integrated Management Database will be set up. KNAN12088-I Intelligent Integrated Management Database installation directory : /var/opt/jp1imm/dbms KNAN12006-I Data storage directory for the Intelligent Integrated Management Database : /var/opt/jp1imm/database KNAN12007-I Port number for the Intelligent Integrated Management Database : 20705 KNAN12008-I Data retention period for the Trend Data Management Database : 64 KNAN12015-I The settings of the Intelligent Integrated Management Database will be changed. The Integrated Management Database will restart after the settings are changed. KNAN12009-Q Do you want to continue processing? (Y/N) : Y KNAN12020-I Please wait. KNAN12016-I The settings of the Intelligent Integrated Management Database were changed.