Systemwalker Runbook Automation Reference Guide

1.5.7 ssoclbackup (Interstage Single Sign-On Backup Command)

Description

The environment created by the configuration command (ssoclsetup) in Interstage single sign-on is backed up.

The backup resources, the files and the stored destination are as follows:

Resources	Files (Note 1)	Stored destination (Note 2) (upper line [Windows] lower line [Linux])
Interstage Single Sign-on	The definition file of the repository server	<Backup directory>\ssoroot\SSO\sv_back
		<Backup directory>/ssoroot/FJSVsso/sv_back
	The definition file of authentication server The message file displayed on Web browser of the authentication server.	<Backup directory>\ssoroot\SSO\ac_back
		<Backup directory>/ssoroot/FJSVsso/ac_back
	The definition file of the business server Message file displayed on Web browser of business server.	<Backup directory>\ssoroot\SSO\az_back
		<Backup directory>/ssoroot/FJSVsso/az_back
Interstage HTTP Server	The following files in all Web servers. The environment definition file in Interstage HTTP Server Password file Root directory for publishing.	<Backup directory>\ssoroot\IHS\
		<Backup directory>/ssoroot/FJSVihs/
Interstage Directory Service	The following files of repositories using as SSO repository. The repository The repository data Access log	<Backup directory>\ssoroot\IDS\rep_back\
		<Backup directory>/ssoroot/FJSVirep/rep_back.tar.gz
Interstage Certificate Environment	The file for the certificate environment SSL definition file	<Backup directory>\ssoroot\SCS\
		<Backup directory>/ssoroot/FJSVisscs/

Additionally, the backed up environment information is stored in the following files.

Stored information	Details	Stored destination (upper line [Windows] lower line[Linux])
SSO repository name	The backed up SSO repository name is stored by text format.	<Backup directory>\ssoroot\info\rep_name.txt
		<Backup directory>/ssoroot/info/rep_name.txt
Setting information of SSO repository	The setting information of the backed up SSO repository	<Backup directory>\ssoroot\info\rep_config.txt
		<Backup directory>/ssoroot/info/rep_config.txt
The list of Interstage HTTP Server Web server names	The list of the backed up Web server names is stored by text format.	<Backup directory>\ssoroot\info\web_server_list.txt
		<Backup directory>/ssoroot\info/web_server_list.txt

Note 1) Refer to "Maintenance (Resource Backup)" - "Backup and Restore Resources" - "Resources that can be Backed Up and Restored" in Interstage Application Operator's Guide for details on files.

Note 2) This is a destination to store each backup resource. Specify this path when only a part of resources is restored individually. Refer to "Maintenance (Resource Backup)" - "Backup and Restore Resources" in Interstage Application Operator's Guide for information on restoring individually.

Synopsis

ssoclbackup backup directory

Options

Backup directory

The directory which stores backup resources is specified by the absolute path. Specify a path with up to 100 bytes. When the specified backup directory doesn't exist, a directory is created.

[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.

Return Values

0:

Normal termination

2:

Abnormal termination

Command Location

[Windows]

<Systemwalker Runbook Automation installation directory>\sso\bin
Note: The default location is C:\Fujitsu\Systemwalker\SWRBAM

[Linux]

/opt/FJSVswrbaa/sso/bin

Privilege Required/Execution Environment

[Windows]

• This command requires administrator privileges. When using Windows Server 2008 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 restoring can be done only on the same OS.

• Do not back up during backup or restoring on the same server.

• Before starting backup, stop all services related to Interstage single sign-on. Refer to "1.3.4 ssoclservicectl (Interstage Single Sign-On Start and Stop Command)" for information about ssoclsericectl command.

• This command ends with error when backup resources under backup directories ("ssoroot" directory) exist.

• Execute this command only for the environment created by the command (ssoclsetup) that configures Interstage single sign-on system. When the single sign-on system created by not using configuration command is backed up, back up referring to "Maintenance (Resource Backup)" - "Backup and Restore Resources" in Interstage Application Operator's Guide.

• When there are contents and CGI, etc. except under the directory specified by DocumentRoot Directive of Interstage HTTP Server, back up corresponding files for each of them separately by the following methods.
  [Windows]
  copy command or explorer
  [Linux]
  cp command

• After starting this command, if the process is interrupted before the process is completed, the backup

  
  

Example

[Windows]

For example: restore "C:\backup"

ssoclbackup C:\backup

[Linux]

For example: restore "/usr/backup"

/opt/FJSVswrbam/bin/ ssoclbackup /usr/backup