機能説明
ssoclbackupコマンドでバックアップしたInterstage シングル・サインオンの環境のリストアを行います。リストア対象は以下のとおりです。
Interstage シングル・サインオンの以下のサーバ
リポジトリサーバ
認証サーバ
業務サーバ
SSOリポジトリ
Interstage HTTP Server
Interstage 証明書環境
ただし、本コマンド実行時、SSOリポジトリとInterstage HTTP Serverが、以下のいずれかの状態である必要があります。
【SSOリポジトリ】(注1)
バックアップを行ったSSOリポジトリと同名のリポジトリが存在しており、以下の設定がバックアップを行ったSSOリポジトリと一致している。(注2)
データベース格納先
公開ディレクトリ
ユーザーパスワード暗号化方式
バックアップを行ったSSOリポジトリと同名のリポジトリが存在しない。
【Interstage HTTP Server】(注3)
バックアップした運用環境と、Webサーバの数、およびWebサーバ名がすべて一致する。(注4)
Webサーバが1つも存在しない。
製品のインストール直後である。
(注1) リポジトリの構築状態については、ireplistコマンドで確認してください。また、SSOリポジトリの設定内容については、irepconfigコマンドでサブコマンドに“print”を指定して確認してください。ireplistコマンド、およびirepconfigコマンドについては、“Interstage Application Server/Interstage Web Server リファレンスマニュアル(コマンド編)”の“シングル・サインオン運用編”の“Interstage ディレクトリサービス運用コマンド”を参照してください。
(注2) バックアップ時のSSOリポジトリのSSOリポジトリ名、およびSSOリポジトリの設定情報については、ssoclbackupコマンド実行時に保存された情報を参照してください。
(注3) Interstage HTTP Serverの構築状態についてはihsdispコマンドで確認してください。ihsdispコマンドについては、“Interstage Application Server/Interstage Web Server リファレンスマニュアル(コマンド編)”の“Webサーバ運用編”の“Interstage HTTP Server運用コマンド”を参照してください。
(注4) バックアップ時のInterstage HTTP Serverの構築状態については、ssoclbackupコマンド実行時に保存されたInterstage HTTP ServerのWebサーバ名一覧を参照してください。
記述形式
ssoclrestore 退避先ディレクトリ |
オプション
ssoclbackupコマンドでバックアップ資源を格納したディレクトリを絶対パスで指定します。100バイト以内のパスを指定してください。
【Windows】
退避先ディレクトリ名には、以下の文字は使用できません。ただし、“:”(コロン)についてはドライブ文字を指定する場合、“\”(エンマーク)についてはディレクトリのセパレータとして指定する場合は使用可能です。
: ; / * ? \ < > | " ,
【Linux】
退避先ディレクトリ名に“/”(スラッシュ)を指定する場合、ディレクトリのセパレータとして扱われます。
メッセージ
本コマンドを実行すると、指定したバックアップディレクトリにバックアップされた資源の一覧が以下のように表示されます。その後、資源のリストアを行うかどうか問い合わせるメッセージが表示されるので、資源の一覧を確認し、リストアを継続する場合は“yes”を入力してください。資源の意味は以下のとおりです。
資源の名前 | 資源の説明 |
|---|---|
Repository Server | リポジトリサーバの資源 |
Authentication Server | 認証サーバの資源 |
Business Server | 業務サーバの資源 |
Web Server | Interstage HTTP Serverの資源 |
SSO Repository (リポジトリ名) | SSOリポジトリの資源 |
Interstage Certificate Environment | Interstage証明書環境の資源 |
復帰値
正常終了
異常終了
コマンド格納場所
【Windows】
[Systemwalker Runbook Automation管理サーバのインストールディレクトリ]\sso\bin |
【Linux】
/opt/FJSVswrbam/sso/bin |
実行に必要な権限/実行環境
【Windows】
Administrator権限が必要です。ご利用OSがWindows Server 2008の場合は、管理者として実行してください。
Systemwalker Runbook Automationが停止している必要があります。
管理サーバで実行可能です。
【Linux】
システム管理者(スーパーユーザー)のみが実行できます。
Systemwalker Runbook Automationが停止している必要があります。
管理サーバで実行可能です。
注意事項
本コマンドは複数同時に実行しないでください。
同一のOS間でのみバックアップ・リストアが可能です。
環境変数(LANG)は、バックアップ時と同じ値にしてください。
同一サーバ上でバックアップ、またはリストア中の場合は、リストアを行わないでください。
リストアを行う前に、ssoclservicectlコマンドを使用し、Interstage シングル・サインオンに関わるすべてのサービスを停止してください。ssoclservicectlコマンドについては、“1.3.4 ssoclservicectl(Interstage シングル・サインオンの起動停止コマンド)”を参照してください。
退避先ディレクトリ配下のバックアップ資源に不足がある場合、本コマンドはエラーで終了します。バックアップ資源については、“1.5.7 ssoclbackup(Interstage シングル・サインオンのバックアップコマンド)”を参照してください。
バックアップしたリポジトリをリストアする際、リポジトリ名、データベース格納先、アクセスログ格納先は、バックアップした環境と同じとなります。データベース格納先、およびアクセスログ格納先パスがない場合は、パスを作成後、リストアしてください。
Interstage HTTP ServerのDocumentRootディレクティブで指定したディレクトリ配下以外のコンテンツや、CGIなどがある場合、別途それぞれについて該当するファイルを以下の方法でリストアしてください。
【Windows】copyコマンド、またはエクスプローラ
【Linux】cpコマンド
製品の再インストール後に本コマンドでリストアを行う場合、以下の点に注意してください。
ssoclsetupコマンドによるセットアップは不要です。
製品をインストールするマシンは、バックアップ時と同じディスク構成にしてください。
製品のインストールパスはバックアップ時と同じパスを設定してください。
本コマンド実行後、リストアに失敗したサービスがあった場合は、出力されるメッセージから問題を解決し、再度コマンドを実行してください。
本コマンド実行後、処理が完了する前に処理を中断した場合、リストアが正常に完了していない状態になります。このような場合、再度本コマンドを実行してください
使用例
【Windows】
バックアップ先が、X:\backupの場合
> ssoclrestore X:\backup Repository Server Authentication Server Business Server Web Server SSO Repository (rep001) Interstage Certificate Environment Are you sure to restore the Single Sign-on system? (yes/no)yes IHS: 情報: ihs81407: リストア処理を開始しました。 IHS: 情報: ihs81408: リストア処理を正常に完了しました。
【Linux】
バックアップ先が、/backupの場合
> /opt/FJSVswrbam/sso/bin/ssoclrestore /backup Repository Server Authentication Server Business Server Web Server SSO Repository (rep001) Interstage Certificate Environment Are you sure to restore the Single Sign-on system? (yes/no)yes IHS: INFO: ihs81407: The restore processing has commenced. IHS: INFO: ihs81408: The restore processing has been completed normally.
