jslmdbcopy (backs up database)
- Organization of this page
Function
This command backs up the database used in ITSLM.
The database is configured on the host on which ITSLM - Manager is installed. To be prepared for problems that might occur on the host on which ITSLM - Manager is installed, we recommend that you execute this command periodically to back up the database.
Execute this command under the following conditions:
-
The following ITSLM - Manager services are stopped:
-
JP1/ITSLM - Manager Service (service name: JP1_ITSLM_MGR_Service)
-
JP1/ITSLM - Manager Web Service (service name: JP1_ITSLM_MGR_Web_Service)
-
-
The ITSLM - Manager service JP1/ITSLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0) is running.
In the case of a cluster system, in addition to the above services, the ITSLM - Manager service JP1/ITSLM - Manager DB Cluster Service (service name: HiRDBClusterService_JL0) must also be running. In a cluster system, execute this command on the active server (if the command is executed on the standby server, an error will result).
The command's execution results are output to the following file:
ITSLM-Manager-installation-folder\mgr\logs\jslmdbcopy.log
For details about the messages displayed during command execution, see 11.3 Messages.
Format
jslmdbcopy absolute-path-of-backup-file
Execution permission
OS's Administrator account
Storage folder
ITSLM-Manager-installation-folder\mgr\bin\
Arguments
absolute-path-of-backup-file
Specifies, enclosed in double quotation marks ("), the absolute path for the file to which the backup file is to be output.
Note that this absolute path must begin with a drive name (one character from A to Z or a to z or a colon (:)) and must consist of the characters A to Z, a to z, 0 to 9, underscore (_), period (.), parentheses (()), backslash (\), and space. None of the following specifications is permitted:
-
Specification in UNC representation
-
Specification containing a network drive
-
Specification of a drive name only
-
Specification containing any of the following Windows and MS-DOS reserved words in folder and file names:
CON, PRN, AUX, CLOCK$, NUL, COM0, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT0, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
If the backup file destination folder specified as the absolute path does not exist, create the folder before you execute the command.
Make sure that the specification does not include any special characters.
Notes
-
If a file already exists at the location specified in the argument when this command is executed, that file will be overwritten by the backup file output by the command.
-
Do not execute another command, including this command, while this command is executing.
-
If execution of this command is canceled by pressing Ctrl+C, an incomplete backup file might be created under the folder specified in the argument. If this occurs, delete the corresponding file, stop the ITSLM - Manager service JP1/ITSLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0), and then restart the service. To stop and start the service, from the Windows Start menu, select Administrative Tools, and then Services.
-
If this command terminates with an error, stop the ITSLM - Manager service JP1/ITSLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0), and then restart the service. To stop and start the service, from the Windows Start menu, select Administrative Tools, and then Services.
-
If the specified backup file name contains any special character that requires enclosure in quotation marks at the command prompt, a command prompt syntax error message will be displayed and the command might terminate. In such a case, the return value will not necessarily be 1. The following are the applicable special characters: &, ( ), [ ], { }, ^, =, ;, !, ', +, ,, `, ~, < >, @, and |.
-
The backup file name must differ from any folder name under the output destination folder specified in absolute-path-of-backup-file.
-
Do not execute this command when ITSLM - Manager has not been set up.
-
If a backup file obtained in an ITSLM - Manager environment is to be restored in another ITSLM - Manager environment, the absolute path of the source RD area folder from which the backup file was obtained must match the absolute path of the target RD area folder to which the backup file is to be restored.
-
This command does not apply to access logs. Access logs are backed up using the standard OS commands for copying files and folders. For details about how to make backups, see 8.1.3 Backing up the access logs.
Return value
Return value |
Description |
---|---|
0 |
Database backup processing terminated normally. |
1 |
Database backup processing failed. |
Example
C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmdbcopy "C:\Users\Administrator\Desktop\db\ITSLMBK01"