ssoclrestore <BackupDirectory>
This command restores Interstage Single Sign-On environments that have been backed up with the ssoclbackup command.
The following are restored:
The following Interstage Single Sign-On servers:
Repository server
Authentication server
Business Server
SSO repository
Interstage HTTP Server
Interstage certificate environment
When executing this command, one of the situations below must apply to the SSO repository and Interstage HTTP Server.
SSO repository (*1)
A repository with the same name as the SSO repository that was backed up exists and it has the same configurations for the following (*2):
Database storage directory
Public directory
User password encryption scheme
A repository with the same name as the SSO repository that was backed up does not exist
Interstage HTTP Server (*3)
The backed up operating environment, number of Web servers, and the names of the Web servers all match (*4)
No Web servers exist
Immediately after installing the product
*1: Check the status of the repository configuration in [System] - [Services] - [Repository] - [repository name] - [Settings] in Interstage Management console
*2: Refer to information which was saved when the ssoclbackup command was executed for information on SSO repository name of SSO repository and the setting information when they were backed up..
*3: Check the status of Interstage HTTP Server configuration by the ihsdisp command. Refer to "Web Server Operation Edition" in the "Interstage Application Server Reference Manual (Command Edition)" for information on the ihsdisp command.
*4: Refer to the list of Web server names for the Interstage HTTP Server saved when the ssoclbackup command was executed to find out the configuration status of the Interstage HTTP Server that was backed up.
Option | Description | |
|---|---|---|
BackupDirectory | Specify the directory where the resources were backed up using the ssoclbackup command, using a full path. Specify the path using no more than 100 bytes. [Windows] The following characters cannot be used in the backup directory name. The colon can be used to indicate the drive letter and the backslash can be used as the directory separator.
|
Execute the command as an Administrator.
If the backup destination is /backup
$ su - Password: <Password for the superuser> # /opt/FJSVcfmg/sso/bin/ssoclrestore /backup
Note
Do not execute more than one of these commands at the same time.
Backup and restore can only be performed on the same operating systems.
Specify the same LANG environment variable as when the backup was made.
Do not restore if backup or restore is being performed on the same server.
Before restoring, use the ssoclservicectl command to stop all services connected to Interstage Single Sign-On. Refer to "Interstage Single Sign-On Start and Stop Command" for information on the ssoclservicectl command.
This command will end with an error if there are insufficient backup resources in the backup directory. Refer to "Interstage Single Sign-On Backup Command" for information on the backup resources.
When restoring a backed up repository, the repository name, database storage directory, and access log storage directory will be the same as the original environment where the backup was made. If there is no path to the database storage directory and access log storage directory, create the paths before restoring.
If there are contents or CGI outside of the directories specified by the Interstage HTTP Server DocumentRoot directive, use one of the following methods to restore these separately.
copy command or Explorer
When restoring using this command after reinstalling this product, follow the precautions below:
The ssoclsetup command does not need to be used for setup.
Install the product on a machine that has the same disk configuration as when the backup was made
Install the product using the same path as when the backup was made.
If there are services that fail to be restored after executing this command, refer to the messages output, solve the problem, and then execute the command again.
If processing is interrupted after this command has been executed but before the processing has completed, restore will not have been completed. If this occurs, execute the command again.
A list of the backup resources in the backup directory will be displayed as follows when this command is executed. Then a message will be displayed asking whether to proceed with the restoration. Confirm the items in the list, then enter "yes" to proceed. The meaning of each resource is shown in the following table.
Resource name | Resource description |
|---|---|
Repository Server | Repository server resources |
Authentication Server | Authentication server resources |
Business Server | Business Server resources |
Web Server | Interstage HTTP Server resources |
SSO Repository (Repository name) | SSO repository resources |
Interstage Certificate Environment | Interstage certificate environment resources |
