Description
The environment of Interstage single sign-on which was backed up by the ssoclbackup command is restored. The followings are restored.
The following servers of Interstage single sign-on.
Repository server
Authentication server
Business server
SSO repository
Interstage HTTP Server
Interstage Certificate Environment
However, SSO repository and Interstage HTTP Server have to be one of the following statuses when this command is executed.
[SSO Repository](Note 1)
The repository with the same name as SSO repository which is backed up exists and the following settings are the same as the backed up SSO repository. (Note 2)
Destination to store the database
Published directory
Encryption scheme of the user password
The repository with the same name as SSO repository which is backed up doesn't exist.
[Interstage HTTP Server](Note 3)
All of number of Web servers and Web server names match the backed up operation environment.
(Note 4)
No Web servers exist.
Just after the installation of the product
Note 1) Check the status of the repository configuration in System >> Service >> Repository >> repository name >> Environment setting in Interstage Management console.
Note 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.
Note 3) Check the status of Interstage HTTP Server configuration by the ihsdisp command. Refer to "12 Interstage HTTP Server Operation Commands" in "Web Server Operation Edition" of Interstage Application Server Reference Manual (Command Edition) for information on the ihsdisp command.
Note 4) Refer to the list of Web server names in Interstage HTTP Server which was saved when the ssoclbackup command was executed.
Synopsis
ssoclrestore backup directory |
Options
[Windows]
The following characters cannot be used as a backup directory name. However, ":" (colon) can be used to specify a drive letter and "\" (yen mark) can be used as a separator between directories.
: ; / * ? \ < > | " , |
[Linux]
When "/" (slash) is specified for the backup directory name, it is treated as a separator between directories.
Messages
After executing this command, the list of the resources which were backed up in the specified back up directory is displayed as below. After that, the message appears whether you would like to restore the resources. Check the list and enter "yes" when you continue restoring the process. The meaning of the resources is as follows.
Resource name | Description |
|---|---|
Repository Server | Repository server resource |
Authentication Server | Authentication server resource |
Business Server | Business server resources |
Web Server | Interstage HTTP Server resource |
SSO Repository (Repository name) | SSO repository resource |
Interstage Certificate Environment | Interstage Certificate Environment resource |
Return Values
Normal termination
Abnormal termination
Command Location
[Windows]
<Systemwalker Runbook Automation installation directory>\sso\bin |
[Linux]
/opt/FJSVswrbam/sso/bin |
Privilege Required/Execution Environment
[Windows]
This command requires administrator privileges. When using Windows Server 2008 or later operating system, run as an administrator.
Systemwalker Runbook Automation should been stopped.
This command can be executed on a Management Server.
[Linux]
This can only be executed by a system administrator (superuser).
Systemwalker Runbook Automation should been stopped.
This command can be executed on a Management Server.
Note
Do not execute this command multiple times simultaneously.
Backup and restore can be done only on the same OS.
The environment variable (LANG) must be the same value as that when it is backed up.
Do not restore during backup or restoring on the same server.
Before the restoring is started, stop all services related to Interstage single sign-on by using the ssoclservicectl command. Refer to "1.3.4 ssoclservicectl (Interstage Single Sign-On Start and Stop Command)" for information on ssoclservicectl command.
When backup resources under the backup directory are insufficient, this command ends up with an error. Refer to "1.5.7 ssoclbackup (Interstage Single Sign-On Backup Command)" for information on backup resources.
When the backed up repository is restored, repository name, destination to store database and the destination of access log become the same environment as the backed up environment. When there are no paths of the destinations to store database or to store the access log, restore them after creating the paths.
When there are contents and CGI, etc. except under the directory specified by DocumentRoot Directive in Interstage HTTP Server, restore corresponding files for each of them separately by the following methods.
[Windows]
copy command or Explorer
[Linux]
cp command
Note the following points when the restoring is executed by this command after reinstallation of the product.
Setting up by the ssoclsetup command is not necessary.
The machine installed the product must have the same disk structure as that when it was backed up.
Set the same installation path of the product as that when it was backed up.
When there are any services which failed to restore after this command is executed, solve the problem by checking the output message and execute the command again.
After starting this command, when the process is interrupted before the process is completed, the backup isn't ended normally. In this case, execute the command again.
Example
[Windows]
For example: Backup directory is "X:\backup"
> ssoclrestore X:\backup |
[Linux]
For example: Backup directory is "/backup"
> /opt/FJSVswrbam/sso/bin/ssoclrestore /backup |
