7.2 ahsrestore

名前

ahsrestore － Interstage HTTP Server 2.4の資源のリストア／移入

形式

ahsrestore -d directory [-t pass|all] [-h host_table]

機能説明

本コマンドは、ahsbackupコマンドでバックアップ／移出を行ったInterstage HTTP Server 2.4の資源のリストア／移入を行います。

本コマンドのオプションとパラメタを以下に示します。

-d directory

Interstage HTTP Server 2.4資源の格納ディレクトリ名を、256バイト以内で指定します。ahsbackupコマンドで指定したディレクトリ名を指定してください。

Interstage HTTP Server 2.4資源の格納ディレクトリ名を、256バイト以内の絶対パスで指定します。ahsbackupコマンドで指定したディレクトリ名を指定してください。

-t pass|all

リストア／移入の対象とする資源を指定します。ahsbackupコマンド実行時に指定したオプションに応じて、指定可能なオプションを以下の表で確認して指定してください。なお、リストア／移入の対象となる資源については、ahsbackupコマンドのバックアップ・移出対象資源の表を参照してください。

ahsbackupコマンド実行時の指定
-tオプション省略	-t pass	-t all
-tオプション省略	-t pass -tオプション省略	-t all -t pass -tオプション省略

-h host_table

移入時に、ホスト名／IPアドレスを変更する場合、変更前と変更後のホスト名／IPアドレスを記述したファイル名を絶対パスで指定して、移入処理時に自動的にホスト名／IPアドレスを変換します。本オプションを省略した場合は、ホスト名／IPアドレスを変換しません。
指定するファイルは、以下のように記述してください。

コメント行には、各行の先頭にハッシュマーク(#)を記述します。
半角スペース、タブは、無視します。

### Host IP conversion table ###

# IP address conversion definition
  (変換前のIPアドレス) > (変換後のIPアドレス)
               :

# Host name conversion definition
  (変換前のホスト名) > (変換後のホスト名)
               :

例

ホスト名およびIPアドレスを以下のように変換する場合の設定例

変換前	変換後
IPアドレス「192.168.0.1」	IPアドレス「192.168.0.3」
IPアドレス「[2001:db8:0:0:1:0:0:1]」	IPアドレス「[2001:db8:0:0:1:0:0:3]」
ホスト名「www.example.com」	ホスト名「www.example.net」
ホスト名「host1.example.com」	ホスト名「host2.example.com」

### Host IP conversion table ###

# IP address conversion definition
  192.168.0.1 > 192.168.0.3
  [2001:db8:0:0:1:0:0:1] > [2001:db8:0:0:1:0:0:3]

# Host name conversion definition
  www.example.com > www.example.net
  host1.example.com > host2.example.com

注意事項

本コマンドは、管理者権限で実行してください。
本コマンドは、すべてのWebサーバを停止した状態で実行してください。
リストア／移入先にファイルが存在した場合は、ファイルを上書きします。
リストア／移入を行うシステムは、バックアップ／移出を行ったシステムと同じディスク構成である必要があります。
-hオプションで変換の対象となるホスト名／IPアドレスは、以下のディレクティブで指定したホスト名／IPアドレスです。
- Listen
- ServerName
- VirtualHost
-h オプションでIPv6形式を利用する場合は、必ず角括弧で囲み、角括弧内では半角スペース、タブ等は利用しないでください。また、環境定義ファイル（httpd.conf）のIPv6の表記は変更前のIPアドレスの表記と完全に一致する必要があります。同じIPv6アドレスを指している場合でも表記が異なる場合、変更されません。
以下のディレクティブに指定したディレクトリ配下以外のコンテンツやCGIなどは、必要に応じて、別途リストア／移入してください。
- Alias
- DocumentRoot
- ScriptAlias
バックアップ／移出の対象資源をリストア／移入する場合は、以下のどちらかの状態で実行してください。
- デフォルトのWebサーバだけが存在する状態
- バックアップ／移出元とリストア／移入先運用環境において、以下のすべてが一致する状態
  - Webサーバ数
  - 各Webサーバ名 (注1)
  - 各Webサーバの環境定義ファイルパス (注1)(注2)
    注1）
    英字の大文字／小文字も一致する必要があります。
    注2）
    Webサーバ一覧ファイル（servers.conf）に設定している環境定義ファイル（httpd.conf）のパス（8.3形式（ショートネーム）含む）も一致する必要があります。
上記のどちらの状態も、バックアップ／移出元とリストア／移入先運用環境の同一サービス名のサービスにおいて、サービス登録時に指定された環境定義ファイルのパスが同一である必要があります。
ihsbackupコマンドでバックアップ／移出したInterstage HTTP Server資源は、リストア／移入できません。
ahsbackupコマンドでバックアップ／移出したInterstage HTTP Server 2.2資源は、リストア／移入できません。
SSLを使用している場合は、バックアップ/移出した以下の資源を、環境定義ファイル(httpd.conf)の該当ディレクティブで指定されているパスにリストア/移入してください。
- サーバ証明書(SSLCertificateFileディレクティブで指定したファイル)
- サーバ秘密鍵(SSLCertificateKeyFileディレクティブで指定したファイル)
- 認証局証明書(SSLCACertificateFileディレクティブで指定したファイル)
- パスフレーズ管理ファイル(SSLUserPINFileディレクティブで指定したファイル)
Webサーバ一覧ファイル（servers.conf）は、リストア／移入先運用環境のファイル属性（アクセス権限、ファイル所有者、およびファイル所有者が所属するグループ）と同じファイル属性でリストア／移入を行います。バックアップ／移出元とリストア／移入先運用環境のファイル属性が異なる場合は、必要に応じて、バックアップ／移出元のファイル属性に変更してください。
以下のディレクティブにネットワーク上の共有フォルダ（UNCパス）を指定している場合は、必要に応じて、ネットワーク上の共有フォルダ配下のコンテンツやCGIなどをリストア／移入し、ネットワーク上の共有資源へのアクセスを設定してください。ネットワーク上の共有資源にアクセスするための設定方法については、「3.30 ネットワーク上の共有資源へのアクセス設定」の「(2) Webサーバの手順」を参照してください。
- Alias
- AliasMatch
- DocumentRoot
- ScriptAlias
- ScriptAliasMatch

使用例

Interstage HTTP Server 2.4の資源をリストアします。

C:\Interstage\F3FMahs\bin\ahsrestore.exe -d X:\Backup -t all

Interstage HTTP Server 2.4の資源をリストアします。

/opt/FJSVahs/bin/ahsrestore -d /backup -t all