前のトピック: アップグレードの準備次のトピック: 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. 既存のインストールで使用されている JAVA_HOME を見つけます。 アップグレード ツールを実行する場合は、同じ JAVA_HOME または最近のサポートされているバージョンの JAVA_HOME を使用することを確認します。
  7. ArcotAccessKeyProvider.dll 共有ライブラリがアプリケーション サーバで設定されていることを確認します。 このファイルを <アプリケーション サーバで使用する JAVA_HOME>\jre\bin\ フォルダにコピーします。
  8. PATH 変数に、ArcotAccessKeyProvider.dll がコピーされるディレクトリを含めます。
  9. コマンド プロンプト ウィンドウを開きます。
  10. 作業ディレクトリを以下に変更します。
    %ARCOT_HOME%\tools\common\upgrade\
    
  11. 以下のコマンドを使用して、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)を確認して、共通データベースのアップグレードが成功したことを確認します。

アップグレード ツールは検証情報も出力します。

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