前のトピック: アップグレード前のタスクの実行次のトピック: CA Strong Authentication データベースの移行


共通コンポーネント データベースの移行

CA Strong Authentication が使用する共通コンポーネント データベースを移行するには、以下の手順に従います。

次の手順に従ってください:

  1. アップグレードするシステム上の一時的な場所にアップグレード ディレクトリをコピーします。

    このフォルダには、この移行パスに適用可能な以下の ZIP ファイルが含まれます。

  2. ca-common-upgrade-1.0.x-2.0.zip ファイルを $ARCOT_HOME ディレクトリにコピーします。
  3. このディレクトリで、ca-common-upgrade-1.0.x-2.0.zip ファイルの内容を抽出します。
  4. 以下のディレクトリに移動します。
    %ARCOT_HOME%/tools/common/upgrade/
    

    このディレクトリで、arcot-common-db-upgrade zip ファイルの内容を抽出します。

  5. 以下に示されているファイル名の、各データベース用のデータベース jar ファイルを、%ARCOT_HOME%/tools/common/upgrade/lib/ ディレクトリにコピーします。
  6. libArcotAccessKeyProvider.so ファイルを <アプリケーション サーバで使用する JAVA_HOME>/jre/sbin にコピーします。 例: CA Strong Authentication リリース 6.x では、libArcotAccessKeyProvider.so ファイルは <ARCOT_HOME>/java/ext/<プラットフォーム名>/<32bit または 64bit> にあります。
  7. $ARCOT_HOME/java/lib/arcot-crypto-util.jar ファイルを以下の場所にコピーします。

    コピー先:

    JAVA_HOME-used-by-App-Server/jre/lib/ext
    
  8. LD_LIBRARY_PATH を、libArcotAccessKeyProvider.so をコピーしたディレクトリに設定してエクスポートします。
  9. 作業ディレクトリを以下に変更します。
    $ARCOT_HOME/tools/common/upgrade/
    
  10. 以下のコマンドを使用して、arcot-common-upgrade-framework.jar ファイルを実行します。
    java [JVM_Options] -jar arcot-common-upgrade-framework.jar [--log-file <log-file-name>] [--log-level <log-level>][--commit-batch-size <batch_size>] [--product-name common][--prompt][--mst]
    

    以下の表に、この JAR でサポートされているオプションの説明を示します。

オプション

説明

JVM-Options

以下の JVM オプションは、LDAP 組織が設定されている場合のみ必要です。

  • -Xmx1024m: 最大ヒープ サイズを 1 GB に設定します。 100,000 人を超えるユーザが設定済みの LDAP に存在する場合は、ヒープ サイズを 2,048 MB (2 GB)に増やすことを強く推奨します。
  • -Dcom.arcot.ldap.migration.timeout=<duration>: LDAP 組織の移行が失敗としてマークされるまでの時間(分単位)。 100,000 人のユーザの LDAP 移行のタイムアウトは、約 240 分(4 時間)です。 ただし、使用しているハードウェア構成のタイプによって異なります。 このパラメータのデフォルト値は 240 分です。

log-file

ログ ファイルへのパスを指定します。

  • 値を指定しない場合、arcot_common_upgrade.log ファイルは %ARCOT_HOME%\logs\ ディレクトリに作成されます。
  • 絶対パスを指定すると、ログ ファイルは指定した場所に作成されます。
  • ファイル名を指定すると、ログ ファイルは指定したファイル名で %ARCOT_HOME% に作成されます。

-log-level

ログ レベルを指定します。 値を指定しない場合、アップグレード ログ レベルは INFO に設定されます。

commit-batch-size

COMMIT ステートメントが発行される前に、データベースに発行されるトランザクションの数を指定します。

product-name

移行する必要がある製品の名前を指定します。 デフォルト値は common です。

prompt

各段階が正常に完了した後に、先に進むかどうかを確認するためのプロンプトを表示します。 後でツールを実行して、停止した場所から続行することを選択できます。 このオプションを指定しない場合、アップグレード ツールは、アップグレード プロセスが完了するまでプロンプトを表示せずに実行されます。

mst

Monitoring Sleep Time (スリープ時間のモニタ)を意味します。 このオプションを指定すると、アップグレード ツールは、指定した期間(分単位)スリープした後にアップグレード中の進捗状況を示す診断メッセージを出力します。デフォルト値は 2 分です。

12. $ARCOT_HOME/logs/arcot_common_upgrade.log ログ ファイルを確認して、共通データベースの移行が成功したことを確認します。

重要: データベースの移行中に、手順を間違って実行してしまったためにエラーが発生した場合は、以前に作成したデータベース バックアップをリストアしてください。 データベースが正しくリストアされたことを確認した後、データベースの移行手順を再試行します。