jimgndbbackup
- Organization of this page
Function
This command backs up intelligent integrated management database.
The purpose of backup and the types of data that can be acquired are shown below.
- Backup for disaster recovery
-
Backs up your data regularly to recover your database in the event of a database failure. The backed up areas are Trend data Management Database space, Integrated agent host Administration Database space, Dashboard Management Database space, and Response Action results management database space in the database.
- Migration backup
-
Backs up the data to migrate the definition information in the database when migrating JP1/IM - Manager to another host. The backed up areas are Trend data Management Database space, Dashboard Management Database space, and Integrated agent host Administration Database space in the database.
The following shows Execute conditions for this command:
-
There is sufficient free space on the destination drive to store the backup file to be created when this command is run.
You must have at least as much free space as the data files for the Intelligent Integrated Management database. For details about the data files for the Intelligent Integrated Management database, see Data file storage of the Intelligent Integrated Management database section of 2.7.1(1)(d) Where related files are stored in the JP1/Integrated Management 3 - Manager Overview and System Design Guide.
-
Stopping the following services:
-
JP1/IM3-Manager
-
JP1/IM3-Manager Intelligent Integrated DB Server
-
JP1/IM3-Manager Trend Data Management Service
-
-
Stopping the following services when using cluster systems:
-
JP1/IM3-Manager_logical-host-name
-
JP1/IM3-Manager Intelligent Integrated DB Server_logical-host-name
-
JP1/IM3-Manager Trend Data Management Service_logical-host-name
-
-
If this command is run with the MAINT option for argument -m, a backup of the IM database must have been taken using the jimdbbackup command (with the MAINT option specified for the -m argument).
Format
jimgndbbackup -o backup-filename -m {MAINT|TRANSF} [-h logical-hostname] [-q]
Execution permission
In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)
In UNIX: Superuser permissions
Storage directory
- In Windows:
-
Manager-path\bin\imgndb\
- In UNIX:
-
/opt/jp1imm/bin/imgndb/
Arguments
- -o backup-filename
-
Specifies the absolute pathname of file to which the database to be backed up is to be exported. For the backup file, specify the local drive. This option cannot be omitted.
Error if a network drive is specified, UNC path is specified, and reserved device File is specified in Windows. If the specified backup file already exists, it is overwritten.
The backup-filename must include file pathname. The characters that can be used are alphanumeric characters, underscore "_", dot ".", sharp "#" and at sign "@". Characters depend on OS and must be enclosed in double quotes if they contain single-byte spaces or parentheses "(", ")". Also, the maximum length of a File is subject to OS limitations.
- -m {MAINT|TRANSF}
-
Specifies the database backup format. Half-width capital alphabet. This option cannot be omitted.
-
MAINT: Execute the backup for disaster recovery.
-
TRANSF: Execute the backup for migration.
-
- -h logical-hostname
-
Specifies Logical host name of the host that Execute the command when operating in a cluster system. Backs up Intelligent Integrated Management Database corresponding to the specified Logical host. If this option is omitted, Logical host named in the environment variable JP1_HOSTNAME is assumed. If JP1_HOSTNAME is not specified, Physical host is assumed. If you are not using a cluster system, you do not need to specify it. Note that JP1_DEFAULT cannot be specified in a Logical host.
- -q
-
Specifies when you execute the command without user-confirmation.
Return values
0 |
The backup terminated normally |
1 |
The backup terminated abnormally |
3 |
Canceled by user (if you enter N/n in KNAN12009-Q Message and Stopped the operation) |
Notes
-
Before you Execute this command, make sure that Execute conditions for this command and jimgndbrestore command are met.
-
Do not start services or execute commands of other JP1/IM - Manager or JP1/IM - Agent while this command is working, Execute may fail because this command changes the database to read/write disabled mode.
-
Do not press the Ctrl + C keys or the Ctrl + Break keys while this command is working. To execute the backup in the background, pressing Ctrl + C keys or Ctrl +Break keys will not stop the backup process. If you immediately start a Execute a command or start service for another JP1/IM - Manager or JP1/IM - Agent after pressing Ctrl + C keys or Ctrl + Break keys, execute or service for those commands may fail.
-
If the Ctrl + C keys or the Ctrl + Break keys are used to abort the process while commands are working, the process is turned Stopped, but output Message may be corrupted.
-
Because the backup file cannot be distinguished between disaster recovery and migration, we recommend that you specify a distinguishable character for each File.
The access permissions for the backup file are printed in Status that the user can access. After making a backup, we recommend that you change the access permissions or move them to a location where users cannot access them.
-
You cannot execute this command in multiple execution or concurrently with Intelligent Integrated Management Database operation commands. 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.