9.5 jslmdbrstr (restores database)

Function

This command restores the database used in SLM.

In the event of a problem on the host on which SLM - Manager is installed, you can restore the environment in effect just before the problem occurred by executing this command.

Execute this command under the following conditions:

• The following SLM - Manager services are stopped:

  • SLM - Manager Service (service name: JP1_ITSLM_MGR_Service)

  • SLM - Manager Web Service (service name: JP1_ITSLM_MGR_Web_Service)

• The SLM - Manager service SLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0) is running.

In the case of a cluster system, in addition to the above services, the SLM - Manager service SLM - 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:

SLM-Manager-installation-folder\mgr\logs\jslmdbrstr.log

For details about the messages displayed during command execution, see 11.3 Messages.

Format

jslmdbrstr absolute-path-of-backup-file

Execution permission

User account belonging to the Administrators group of the OS

Storage folder

SLM-Manager-installation-folder\mgr\bin\

Arguments

absolute-path-of-backup-file

Specifies, enclosed in double quotation marks ("), the absolute path for the backup file that is to be restored.

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

Make sure that the specification does not include any special characters.

Notes

• After this command has executed, the target database contains only the restored data.

• Do not execute commands other than the jslmminfoget command while this command is being executed.

• Do not cancel execution of this command by pressing Ctrl+C. If execution of the command is canceled by pressing Ctrl+C, the database area might become corrupted. If this command is canceled for some reason while its execution is underway, stop the SLM - Manager service SLM - 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 SLM - Manager service SLM - Manager DB Service cannot be restarted successfully or SLM - Manager does not function normally, the database area might have become corrupted. In such a case, set up SLM - Manager again, and then re-execute this command to restore the database.

• If this command terminates with an error, stop the SLM - Manager service SLM - 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 |.

• Do not execute this command when SLM - Manager has not been set up.

• If a backup file obtained in an SLM - Manager environment is to be restored in another SLM - 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.

Return value

Return value	Description
0	Database restore processing terminated normally.
1	Database restore processing failed.

Example

C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmdbrstr "C:\Users\Administrator\Desktop\db\ITSLMBK01"