validate_restore を使用してプロジェクトとサーバーの情報を復元する

あるバージョンの validate_backup を使用して作成されたバックアップを異なるバージョンの validate_restore を使用して復元することはできません。たとえば、Validate 24.4 で作成されたバックアップは、Validate 24.3 または 25.1 を使用して復元することはできません。 プロジェクトまたはサーバーをバックアップおよび復元するには、同じバージョンの Validate を使用してください。新しいサーバーバージョンに移行する場合は、互換性の指摘を回避するため、移行が完了してから、新しいプロジェクトとサーバーのバックアップを作成することをお勧めします。

Validate サーバーのインストールの bin ディレクトリにある validate_restore を使用して、プロジェクトとサーバーの両方の情報を復元することができます。

パラメーターは、以下の表のとおりです。

オプション

名前 説明
--db-host データベースサーバーのホスト名をオーバーライドします。指定された値はターゲットプロジェクトルートに書き込まれません。DNS 解決が失敗した場合に使用してください (デフォルトは None)。
--db-password

データベースサーバーのパスワードを指定します (デフォルトは <Empty>)。
--db-port データベースサーバーのポートをオーバーライドします。指定される値はターゲットプロジェクトルートに書き込まれません。設定されたポートが外部ポートと異なる場合に使用してください (デフォルトは None)。
--db-user データベースサーバーのユーザーを指定します (デフォルトは kw)。
--help, -h このヘルプメッセージを表示して終了します。
--log-level ログに記録されるイベントの種類と重大度をフィルタリングするログレベル。許可される値は、DEBUG、INFO、 WARNING、ERROR、CRITICAL です (デフォルトは INFO)。
--restore-server-configuration (サーバーの復元のステップ 1) プロジェクトルートの構成ファイルをターゲットプロジェクトルートにコピーします。ターゲットプロジェクトルートのサーバーを停止する必要があります (デフォルトは False)。
--restore-server-settings

(サーバーの復元のステップ 2) サーバー設定をターゲットプロジェクトルートに復元します。前提条件：--restore-server-configuration の後に実行する必要があり、ターゲットプロジェクトルートのサーバーを起動する必要があります。詳細については、資料を参照してください (デフォルトは False)。
--source

復元する Validate サーバーまたはプロジェクトのバックアップへのパスを指定します (デフォルトは None)。
--ssl ターゲットサーバーで SSL が有効になっているかどうかを指定します。指定された値はターゲットプロジェクトルートに書き込まれません (デフォルトは False)。
--target バックアップの復元先となるターゲットプロジェクトルートのアーカイブへのパスを指定します (デフォルトは None)。
--validate-installation

Validate のインストールディレクトリへのパスを、たとえば、C:\Perforce\Validate_24.4 というように指定します (デフォルトは None)。
--verbose

一部の内部バックアップコマンドの詳細ログを有効にします (デフォルトは False)。
--web-host Validate サーバーのホスト名をオーバーライドします。指定される値はターゲットプロジェクトルートに書き込まれません。DNS 解決が失敗した場合に使用してください (デフォルトは False)。
--web-port Validate サーバーのポートをオーバーライドします。指定される値はターゲットプロジェクトルートに書き込まれません。設定されたポートが外部ポートと異なる場合に使用してください (デフォルトは None)。

プロジェクトの情報の復元

validate_backup を使用して作成されたプロジェクトのバックアップを Validate サーバーに復元することができます。

前提条件:

  • プロジェクトを復元するサーバーが稼働中である
  • プロジェクトがサーバー上に存在していない

以下のパラメーターを指定する必要があります。

  • --source (復元する Validate サーバーまたはプロジェクトのバックアップへのパス)
  • --Target (バックアップの復元先となるターゲットプロジェクトルートのアーカイブへのパス)
  • --validate-installation (Validate インストールディレクトリへのパス)

複数のソースルートから同じターゲットルートに直接プロジェクトを復元することはできません。復元操作に使用されるターゲットプロジェクトルートには、単一のソースプロジェクトルートからのプロジェクトとサーバー構成データのみを含める必要があります。

あるソースルートのデータが既に含まれているターゲットルートに別のソースルートからプロジェクトを復元することは、データの競合やエラーが発生する可能性があるため、サポートされていません。

バックアップされた複数のプロジェクトを異なるソースルートから共有の宛先に復元する必要がある場合は、以下のようにしてください。

  • まず、各プロジェクトを別々のターゲットプロジェクトルートに復元します (--restore オプションを使用)。
  • 次に、復元された各プロジェクトを最終的な復元先である共有プロジェクトルートにインポートします。

プロジェクトの情報を復元するには

次のコマンドを実行します。 

<validate installation>/bin/validate_restore(.cmd) --target <projects root path> --validate-installation <validate installation path> --source <source backup (archive) path>

サーバーの情報の復元

Validate サーバーのプロジェクト以外の構成と情報のバックアップを復元するには、以下の手順を実行してください。

サーバーバックアップを同じサーバーまたは既存のサーバーに復元することはできません。 サーバー情報は新しいプロジェクトルートに復元する必要があります。

サーバーの情報を復元するには

  1. 新しいプロジェクトルート (バックアップを復元する場所) を作成するには、以下のコマンドを実行します。 
    kwservice -r <projects root> setup --restore
    2. 新しいプロジェクトルートを起動したり、ホストとポートの情報以外の追加情報を構成したりしないでください。
  2. (任意) Web、データベース、ライセンスホストサービスのホストとポートの情報を使用して、新しいプロジェクトルートを構成します。例:
    kwservice -r <projects root> set-service-property web port 8082
  3. バックアップからサーバー構成を復元するには、以下のコマンドを実行します。
    <validate installation>/python validate_restore(.cmd) <optional parameters> --restore-server-configuration
  4. IdP によって URL を新しいサーバーにリダイレクトしている場合は、URL が引き続き有効であることを確認してください。
    5. 復元するサーバーが SSL を有効にして  SAML 認証または OIDC 認証される場合は、「SSL を使用して SAML 認証または OIDC 認証されるサーバーを復元する」を参照して、該当の説明に従ってください。
  5. プロジェクトルートを起動するため、以下のコマンドを実行します。
    kwservice <optional parameters> start
  6. 残りのサーバー情報を復元するため、以下のコマンドを実行します。
    <validate installation>/python validate_restore(.cmd) <optional parameters> --restore-server-settings

これで、サーバー情報のコピーが復元されました。このサーバーにプロジェクトを復元するには、「プロジェクトの情報の復元」を参照してください。