test

Sun Identity Manager 8.1 アップグレード

Identity Manager 製品のアップグレード

Identity Manager 製品をアップグレードするには、次のいずれかの方法を使用できます。

両方の方法の結果は同じです。

注 –

一部の環境では、手動アップグレード手順が望ましい場合があります。たとえば、次のとおりです。

Identity Manager 製品のアップグレードにより、Identity Manager リポジトリオブジェクト、および .jsp ファイル、Identity Manager 製品の JAR、他社製の JAR などファイルシステムの一部のアーティファクトが変更されることがあります。.

Identity Manager 製品をアップグレードするときには、次の点に注意してください。

ProcedureIdentity Manager インストーラの使用法

Identity Manager のインストールおよびアップグレードのプログラムを使用して、開発環境をアップグレードします。

  1. インストーラを起動するには、次のいずれかの方法を使用します。

    • GUI インストーラを使用するには、 install.bat ( Windows) または install (UNIX) を実行します。

      インストーラの開始画面が表示されます。

    • nodisplay モードでインストーラを起動するには、ソフトウェアのあるディレクトリに移動して、次のコマンドを入力します。

      install -nodisplay

      インストーラの開始テキストが表示され、次に GUI インストーラと同じ順序で、インストール情報を収集するための質問リストが表示されます。

      ディスプレイ装置がない場合は、インストーラはデフォルトで nodisplay オプションを使用します。

      インストーラは、ソフトウェアの旧バージョンを新バージョンの後にインストールしません。この場合、エラーメッセージが表示され、インストーラは終了します。

  2. 開始画面の「次へ」をクリックします。

  3. 「Install or Upgrade?」画面の「アップグレードする」を選択して、「次へ」をクリックします。

  4. 「インストールディレクトリを選択します」画面で、Identity Manager の旧バージョンがあるディレクトリを選択して、「次へ」をクリックします。

    インストーラにアップグレード前処理とアップグレード後処理の進捗バーが表示され、その後「インストール構成の確認」画面に進みます。

  5. インストールの詳細については、「詳細」をクリックしてログファイルを表示し、その後「閉じる」をクリックしてインストーラを終了します。

  6. アプリケーションサーバーの作業ディレクトリからコンパイル済みの Identity Manager ファイルをすべて削除します。

手動によるアップグレード

一部の環境では、Identity Manager のインストールおよびアップグレードのプログラムを使用せずに、手動でアップグレードを実行する場合があります。

注 –

この節の操作方法は、Identity Manager を Tomcat アプリケーションサーバーにインストールする場合のものです。使用しているアプリケーションサーバーにより、多少異なるコマンドの使用が必要な場合があります。

アプリケーションサーバーに固有の操作方法については、『Sun Identity Manager 8.1 Installation』のパート II「Installing Identity Manager」の該当する章を参照してください。

ProcedureWindows プラットフォームで手動アップグレードを実行するには

サポートする Windows プラットフォームで Identity Manager を手動でアップグレードするには、次の手順を実行します。

  1. アプリケーションサーバーと Gateway を停止します。.

  2. Identity Manager のデータベースを更新します。

  3. 次のコマンドを入力して、環境を設定します。


    set ISPATH=Path-to-install-software 
set WSHOME=Path-to-Identity-Manager-Installation  OR Staging-Directory set TEMP=Path-to-Temporary-Directory
    注 –

    Identity Manager のインストールディレクトリへのパスにスペースがある場合は、次の例に示すように、WSHOME 環境変数を二重引用符 (") で囲まずに指定する必要があります。

    パスにスペースがない場合でも、パスを指定するときには、末尾にバックスラッシュ (\) を使用しないでください。


    set WSHOME=c:\Program Files\Apache Group\Tomcat 6.0\idm

    または 


    set WSHOME=c:\Progra~1\Apache~1\Tomcat~1\idm

    次のパスの指定は正しくありません。


    set WSHOME="c:\Program Files\Apache Group\Tomcat 6.0\idm"

  4. 前処理を実行します。 


    mkdir %TEMP%
cd /d %TEMP%
jar -xvf %ISPATH%\IDM.WAR\
WEB-INF\lib\idm.jar WEB-INF\lib\idmcommon.jar
set TMPLIBPTH=%TEMP%\WEB-INF\lib
set CLASSPATH=%TMPLIBPTH%\idm.jar;\
%TMPLIBPTH%\idmcommon.jar;
java -classpath %CLASSPATH% -Dwaveset.home=%WSHOME%\
   com.waveset.install.UpgradePreProcess

  5. ソフトウェアをインストールします。


    cd %WSHOME%
jar -xvf %ISPATH%\IDM.WAR

  6. 後処理を実行します。 


    java -classpath %CLASSPATH% -Dwaveset.home=%WSHOME%
   com.waveset.install.UpgradePostProcess
    注 –

    • アップグレードの後処理ステップは、個別の Java 仮想マシンで実行されます。このステップのデフォルトのヒープサイズは 1024 Mバイトです。 このステップでメモリ不足の例外が発生する場合は、ヒープサイズの最大値を高く設定してください。カスタム値を設定するには、—Xmx <heap size> の書式を使用して、JAVA_OPTS 環境変数を設定します。「heap size」は、2048m のような値です。たとえば、-Xmx2048m のように指定します。

    • インストーラは、デフォルトの Configurator アカウントの名前が変更されていたり、アカウントが削除されていたり、無効になっていたりするインストール環境に対してもアップグレードインストールをサポートしています。

      アップグレードの後処理で、 update.xml をインポートするために、インストーラはユーザー名とパスワードの入力を要求します。ユーザー名またはパスワードが正しく入力されない場合、正しいユーザー名またはパスワードを入力するように要求されます (最大 3 回)。このエラーは、インストーラのテキストボックスに表示されます。

      手動インストールの場合、 -U username -P password のフラグを指定して、認証情報を UpgradePostProcess 手続きに渡す必要があります。

  7. ステージングディレクトリにインストールした場合は、アプリケーションサーバーへの配備用 .war ファイルを作成します。

  8. アプリケーションサーバーの作業ディレクトリから Identity Manager のファイルを削除します。

ProcedureUNIX プラットフォームで手動アップグレードを実行するには

サポートする UNIX プラットフォームで Identity Manager を手動でアップグレードするには、次のステップを実行します。

  1. アプリケーションサーバーと Gateway を停止します。.

  2. Identity Manager のデータベースを更新します。

  3. 環境を設定します。 


    export ISPATH=Path-to-Install-Software export WSHOME=Path-to-Identity-Manager-Installation-or-Staging Directory 
export TEMP=Path-to-Temporary-Directory

  4. 前処理を実行します。 


    mkdir $TEMP
cd $TEMP
jar -xvf $ISPATH/idm.war \
WEB-INF/lib/idm.jar WEB-INF/lib/idmcommon.jar
CLASSPATH=$TEMP/WEB-INF/lib/idm.jar:\
$TEMP/WEB-INF/lib/idmcommon.jar:
java -classpath $CLASSPATH -Dwaveset.home=$WSHOME \
com.waveset.install.UpgradePreProcess

  5. ソフトウェアをインストールします。


    cd $WSHOME
jar -xvf $ISPATH/idm.war

  6. 後処理を実行します。 


    java -classpath $CLASSPATH -Dwaveset.home=$WSHOME
  com.waveset.install.UpgradePostProcess
    注 –

    • アップグレードの後処理ステップは、個別の Java 仮想マシンで実行されます。このステップのデフォルトのヒープサイズは 1024 Mバイトです。 このステップでメモリ不足の例外が発生する場合は、ヒープサイズの最大値を高く設定してください。カスタム値を設定するには、—Xmx <heap size> の書式を使用して、JAVA_OPTS 環境変数を設定します。「heap size」は、2048m のような値です。たとえば、-Xmx2048m のように指定します。

    • インストーラは、デフォルトの Configurator アカウントの名前が変更されていたり、アカウントが削除されていたり、無効になっていたりするインストール環境に対してもアップグレードインストールをサポートしています。

      アップグレードの後処理で、 update.xml をインポートするために、インストーラはユーザー名とパスワードの入力を要求します。ユーザー名またはパスワードが正しく入力されない場合、正しいユーザー名またはパスワードを入力するように要求されます (最大 3 回)。このエラーは、インストーラのテキストボックスに表示されます。

      手動インストールの場合、 -U username -P password のフラグを指定して、認証情報を UpgradePostProcess 手続きに渡す必要があります。

  7. ディレクトリを $WSHOME/bin/solaris または $WSHOME/bin/linux に変更し、そのディレクトリ内のファイルを実行できるように、それらのファイルのアクセス権を設定します。

  8. ステージングディレクトリにインストールした場合は、アプリケーションサーバーへの配備用 .war ファイルを作成します。

  9. アプリケーションサーバーの作業ディレクトリから Identity Manager のファイルを削除します。

アップグレードのトラブルシューティング

アップグレード時に問題が発生した場合は、$WSHOME/patches/ logs ディレクトリにあるアップグレードのログファイルをチェックします。ログファイルの名前は、アップグレードのタイムスタンプとステージに基づきます。