7.9.3 Backup and recovery of operating environment
When recovering from a failure that has occurred in the operating environment or when migrating the environment by migrating the machine along with the expansion in system scale, you can take the backup of the files required for restoring the environment.
- Organization of this subsection
(1) Backup of operating environment
Execute the cscenvbackup command as follows to take the backup of the latest files required to restore the operating environment.
cscenvbackup -user <login user ID> -pass <login password> -backupdir <Backup files output destination directory>
If the backup files output destination directory is specified in HCSC-Manager definition file, execute the cscenvbackup command as follows:
cscenvbackup -user <login user ID> -pass <login password>
- Reference note
-
You can acquire the operating environment backup files even in the case of automatic backup. The operating environment backup files acquired during the automatic backup are stored at the following directories:
-
Output destination of the environment backup files specified in the HCSC-Manager definition file
-
<Installation directory of Service Platform>\CSC\spool\manager (if the output destination is not specified in the HCSC-Manager definition file (cscmng.properties))
-
You can check the repository information in the backup files for the acquired operating environment backup files with the following command:
cscrepls -user <login user ID> -pass <login password> -envbackfile <Operating environment backup file name>
(2) Restoring the operating environment
You can restore the operating environment from the operating environment back files, by using the cscenvrestore command.
- Reference note
-
The restoration using the cscenvrestore command is suitable in the cases when the operating environment is built on a machine different from the machine with an execution environment.
- Important note
-
Only the operating environment can be restored using the cscenvrestore command. The execution environment cannot be recovered with this command. To recover the execution environment, following the steps specified in the section described below, remove the environment repository information and resources and, re-build the execution environment.
(a) Procedure for recovery from a disk failure
The steps are as follows:
-
Prepare a machine with an installed Service Platform. Install software as needed.
-
Save the acquired operating environment backup files in a location that can be recognized by the computer to be restored.
-
Execute the cscrepls command to check the environment that will be restored by the operating environment backup files.
cscrepls -user <login user ID> -pass <login password> -envbackfile <Operating environment backup file name>
-
Execute the cscenvrestore command to restore environment using the operating environment backup files.
cscenvrestore -user <login user ID> -pass <login password> -restorefile <Operating environment backup file name>
(b) Procedure for migrating the operating machine
The steps are as follows:
-
As needed, use the cscenvbackup command to acquire operating environment backup files that exist before the environment is restored.
If you restore the operating environment with the cscenvrestore command, the operating environment before restoration is destroyed. The content of the environment backup files may differ when the backup is taken automatically and when the backup is taken just before recovery.
-
Prepare a machine with an installed Service platform.
-
Save the acquired operating environment backup files in a location that can be recognized by the machine after migration.
-
Execute the cscrepls command to heck the environment that will be restored by the operating environment backup files.
cscrepls -user <login user ID> -pass <login password> -envbackfile <Operating environment backup file name>
-
Execute the cscenvrestore command to restore the environment using the operating environment backup files.
cscenvrestore -user < login user ID > -pass < login password > -restorefile < Operating environment backup file name >
- Important note
-
The HCSC-Manager definition file (cscmng.properties) is saved in the environment backup acquired by executing the cscenvbackup command or cscrepctl command (-import option). However, when the operating environment is restored with the cscenvrestore command, the HCSC-Manager definition file that exists in the restoration destination is considered as valid and the HCSC-Manager definition file included in the environment backup is restored with an optional name (cscmng_backup.properties). Use cscmng_backup.properties for reference. Also, if this file is not required, it may be deleted.
(c) Automatic backup during recovery
A backup of the environment prior to recovery is automatically performed before recovering from operating environment backup file using the cscenvrestore command. When the environment is recovered from a wrong operating environment backup file, you can use the automatic backup file during recovery and can rollback to environment prior to recovery.
The backup file during recovery is output in the following directory with the file name cscenvrestore_1.zip:
<Installation directory of Service Platform>\csc\spool\manager
You can change the output destination directory of backup file by the cscmng.envbackup.dir parameter or the cscmng.envbackup.dir.envrestore parameter of the HCSC-Manager definition file. When an old backup file exists in the output destination directory, old file is deleted after successful recovery.
You can set whether to perform automatic backup during recovery, in the cscmng.envbackup.autoget parameter or the cscmng.envbackup.autoget.off parameter of the HCSC-Manager definition file.
For details about the HCSC-Manager definition file, see "6.5.3 HCSC-Manager definition file" in "Service Platform Reference Guide".