このトピックでは、IBM Update Installer for WebSphere
Software を使用して、
暫定修正、修正パッケージ、およびリフレッシュ・パックを
インストールする方法を説明します。
Update Installer for WebSphere Software はまた、アップデート・インストーラー・プログラム、UpdateInstaller プログラム、およびアップデート・インストール・ウィザードとも呼ばれています。
始める前に
適切な許可を使用して、製品の更新を正常にインストールします。
アップデート・インストーラー・プログラムは、root ユーザーとして
(AIX または Linux などのプラットフォームの場合)、
または管理者として (Windows プラットフォームの場合) 使用してください。
重要:
- 更新対象の WebSphere
Application Server 製品をインストールした際のユーザー・アカウントを使用して、
インストール・ウィザードを起動し、
アップデート・インストーラーをインストールする必要があります。
さらに、同じユーザー・アカウントを使用して、
アップデート・インストーラー・プログラムを起動し、
製品を更新する必要があります。
- 異なるユーザー・アカウントが
updi_root
ロケーションを使用している場合、
このユーザー・アカウントには、このロケーションに対する、
読み取りおよび実行のアクセス権が与えられている必要があります。
また、updi_root/logs ディレクトリーと、
そのサブディレクトリーに対する、
書き込みアクセス権も与えられている必要があります。
- 異なるユーザー・アカウントを使用して、WebSphere Application Server 製品の
ターゲット・ロケーションを更新する場合、
このユーザー・アカウントには、
保守パッケージが適用されるターゲット・ロケーションに対する、
全アクセス権限 (読み取り、書き込み、実行) が
与えられている必要があります。
非 root ユーザーが、
アップデート・インストーラー・プログラムを起動する場合、
そのユーザー・アカウントには slibclean コマンドを
実行できる権限が必要です。
そうでない場合は、アップデート・インストーラーが使用されるときに、
常に root ユーザーが slibclean コマンドを
実行しなければいけなくなります。
- すべてのユーザーからのあらゆるプロセスによっても、
保守パッケージがインストールされるターゲット・ロケーション内の
ファイルがロックされないことを確認します。
アップデート・インストーラー・ウィザードは、グラフィカル・ユーザー・インターフェースを使用して実行する、または応答ファイルを使用してサイレント・モードで実行する InstallShield for Multiplatforms ウィザードです。
以下の説明には、WebSphere Application Server 製品およびコンポーネントに、暫定修正、修正パッケージ、およびリフレッシュ・パックをインストールする場合の参照情報が含まれています。
- インストール手順の概説
- アップデート・インストーラーの既存のコピーを更新するには、新規の ZIP ファイルまたは TAR ファイルをインストール・ルート・ディレクトリーにダウンロードする前に、
既存のアップデート・インストーラーの updateinstaller ディレクトリーをバックアップして削除します。
- アップデート・インストーラー、修正パッケージ、またはリフレッシュ・パックの ZIP ファイルまたは TAR ファイルの最新バージョンを、サポート・サイトからインストール・ルート・ディレクトリーにダウンロードします。
- ダウンロードしたファイルをアンパックして updateinstaller ディレクトリーおよびいくつかのサブディレクトリーを作成します。この中には、maintenance ディレクトリーも含まれます。
- 暫定修正のみ: サポート Web サイトから maintenance ディレクトリーへ暫定修正をダウンロードします。
- アップデート・インストーラーを使用して、暫定修正、修正パッケージ、またはリフレッシュ・パックをインストールします。アップデート・インストーラーは、app_server_root/properties/version/update/backupディレクトリーにバックアップ・ファイルを作成します。IBM は、バックアップ・ファイルに行うユーザー変更はサポートしません。
- WebSphere Application Server 製品の既存プロファイルの更新
- アップデート・インストーラーは、WebSphere Application Server 製品のコア・プロダクト・ファイルを更新します。保守パッケージ内のサービスが、インストール・ルート・ディレクトリーの以下のファイルを更新する場合があります。
- java/jre ディレクトリー内の SDK、Java テクノロジー・エディション
- lib ディレクトリー内の JAR ファイル
- bin ディレクトリー内のスクリプト
- プロファイル・テンプレート
幾つかの保守パッケージでは、コア・プロダクト・ファイルに対するサービス加えて、既存プロファイルに対する必要なサービスも提供しています。
プロファイル保守を持つ各保守パッケージは、プロファイルを変更するスクリプトを提供します。
アップデート・インストーラーは、プロファイルの保守を要求した保守パッケージをインストールするときにプロンプトを出して、構成のバックアップを取るよう促します。
幾つかの保守パッケージでは、既存プロファイルに対するオプションのサービスを提供しています。
保守パッケージの README ファイルでは、この保守パッケージに既存プロファイルに対するオプションのサービスが含まれているかどうかを説明しています。
含まれている場合、README ファイルは、保守パッケージで提供されたスクリプトの使用方法を説明します。
保守パッケージによって更新可能な各プロファイルの構成を、backupConfig コマンドを使用してバックアップします。
または app_server_root/profiles ディレクトリーをアーカイブして、すべてのプロファイルを一度にバックアップします。
保守パッケージをアンインストールしても、アップデート・インストーラーは、保守パッケージをプロファイルからアンインストールしません。
保守を除去しない理由は、保守のインストールのあとでプロファイルを構成した可能性があるからです。
元のプロファイルを復元するには、restoreConfig コマンドを使用するか、またはアーカイブされた profile_root ディレクトリーから元のプロファイルをコピーして、変更されたプロファイルを置き換えます。
- 製品の修正レベルの表示
- インストール・ルート・ディレクトリー内の bin ディレクトリーの versionInfo コマンド
および historyInfo コマンド
を使用して、製品の正確な修正レベルとバージョン・レベルを表示します。
ただし、保守パッケージのインストール中またはアンインストール中には、どちらのコマンドも使用しないでください。
- クラスター・メンバーの更新
クラスター内のすべての WebSphere Application Server インストールに、同じ保守パッケージを適用します。クラスター・メンバーがすべて同じサービス・レベルでない場合は、
次の例外が発生する可能性があります。
DRSCacheApp E DRSW0008E:
Exception is: com.ibm.disthub.impl.jms.JMSWrappedException:
{-1361012295|unknown|java.io.OptionalDataException|}
このエラーにより、メモリーの複製が正しく機能しないことがあります。
アップデート・インストーラー・ウィザードの複数コピーを一度に起動しないでください。 アップデート・インストーラー・プログラムの同時起動はサポートされていません。
複数の更新を同時に実行すると、インストールの失敗や不完全なインストールを含む、
予測不能の結果を引き起こす可能性があります。
必須情報。グラフィカル・インターフェースでは、以下の情報を提供する必要があります。
表 1. 保守パッケージのインストール時に必要な情報
フィールド |
有効な値 |
説明 |
WebSphere 製品またはコンポーネントのインストール・ルート・ディレクトリーのファイル・パス。 アップデート・インストーラーのインストール・ルート・ディレクトリー。
|
次のいずれかの製品のインストール・ルート・ディレクトリーを確認します。
- IBM WebSphere Application Server
- IBM WebSphere Application Server - Express
- IBM WebSphere Application Server - Express の組み込みバージョン
- IBM WebSphere Application Server Network Deployment
- IBM WebSphere Extended Deployment
- IBM Application Client for WebSphere Application Server
- IBM WebSphere Business Integration Server Foundation
- WebSphere Application Server の Web サーバー・プラグイン
|
更新しようとするコア・プロダクト・ファイルの各セット内でUpdate Installer for WebSphere Software
をダウンロードおよび解凍します。
アップデート・インストーラー・アプリケーションは、デフォルトでは、その親のディレクトリーにある製品を更新します。
|
インストールする保守パッケージのファイル名。 |
インストールする保守パッケージを maintenance ディレクトリーから選択します。 |
デフォルトの保守パッケージは、最新の日付スタンプおよびタイム・スタンプを持つパッケージです。
|
- root ユーザーとして (AIX または Linux などのオペレーティング・システムの場合)、
または 管理者グループのメンバーとして (Windows システムの場合)、
ログオンします。
- 更新しようとしている製品をインストールします。
現在更新を行っているソフトウェアは、
既にインストール済みであると考えられます。
まだそのソフトウェアがインストールされていない場合は、ここでインストールします。
- 現行のアップデート・インストーラーをダウンロードする前に、旧バージョンのアップデート・インストーラーをバックアップして、削除します。新規バージョンのアップデート・インストーラーを使用するには、最初に旧バージョンを除去する必要があります。
- 必要であれば、app_server_root/updateinstaller/maintenance ディレクトリー内のすべてのファイルおよびサブディレクトリーをバックアップします。
- app_server_root/updateinstaller/maintenance ディレクトリーおよびそのすべてのサブディレクトリーを削除します。
- リフレッシュ・パックおよび修正パッケージのみ: 修正パッケージまたはリフレッシュ・パック・ファイルを、サポート・サイトから一時ディレクトリーにダウンロードします。
リフレッシュ・パックまたは修正パッケージの圧縮ファイルには、アップデート・インストーラーおよび保守パッケージが含まれています。
アップデート・インストーラー・コードの最新バージョンの有無を確認することができます。
Update Installer for WebSphere Software の最新バージョンを含んでいる圧縮ファイルを、以下のいずれかの IBM Web サイトからダウンロードします。
- 暫定修正のみ: アップデート・インストーラーを、サポート・サイトから
一時ディレクトリーにダウンロードします。
Update Installer for WebSphere Software の圧縮ファイルを、以下のいずれかの IBM Web サイトからダウンロードします。
- 圧縮ファイルをアンパックします。
圧縮ファイルを app_server_root ディレクトリーにアンパックします。
ファイルをアンパックすると、以下のディレクトリー構造が作成されます。
app_server_root
/updateinstaller
/framework
/lib
/maintenance
/responsefiles
バージョン情報は、updateinstaller ディレクトリー内の version.txt ファイルに保管されます。
新規修正があった場合、新規バージョンは、その修正に対応して出荷されることがあります。version.txt ファイル内の情報は、ウィザードのタイトル・バーに目立つように表示され、また updatelog.txt ファイル内にも記録されます。
暫定修正をインストールする場合は、常時、アップデート・インストーラー・ウィザード の最新のバージョンをダウンロードし、使用します。
すべてのアプリケーション・サーバーが停止していることを、確認します。
すべての WebSphere
Application Server プロファイル上で、stopServer コマンドを実行します。
- WebSphere Application Server 製品が提供する IBM Software Developer Kit
(SDK) を使用するすべての Java プロセスを停止します。
マシン上で暫定修正、修正パッケージ、またはリフレッシュ・パックをインストールまたはアンインストールする前に、
そのマシン上で、WebSphere Application Server が提供する IBM SDK, Java
Technology Edition を使用する Java プロセスを、すべて停止してください。
アップデート・インストーラー・プログラムが使用されているシステムで実行中の、WebSphere Application Server 関連のすべての Java プロセスを停止します。例えば、Java プロセスには以下のものが含まれます。
- すべての Java 仮想マシン (JVM)
- WebSphere Application Server プロセス:
WebSphere Application Server プロセスには次のようなものがあります。
- アプリケーション・サーバー・プロセス
- アプリケーション・サーバー・ノードがデプロイメント・マネージャー・セルに統合される場合、そのノード上の nodeagent プロセス
- デプロイメント・マネージャー・サーバーの dmgr プロセス
- IBM HTTP Server プロセス
- 更新しているプラグインを使用している Web サーバー・プロセス
- ファースト・ステップ・コンソール
- インストール検証テスト (IVT) プロセス
- プロファイル管理ツール
- その他の InstallShield for Multiplatforms (ISMP) インストール・プログラム
- InstallShield for Multiplatforms アンインストール・プログラム
- IBM Rational Application Developer Agent Controller
必要であれば、すべての Java プロセスを停止します。
WebSphere Application Server 関連の Java プロセスの実行中に暫定修正をインストールする場合、
製品が引き続き正常に (エラーなしで) 稼働することは保証できません。
詳しくは以下の技術情報、Stop all WebSphere Application Server-related
Java processes before using the Update Installer for WebSphere software を参照してください。
- アップデート・インストーラーが使用する、有効な IBM SDK, Java Technology Edition を見つけます。
WebSphere ソフトウェアのアップデート・インストーラーは、WebSphere ソフトウェアで提供される有効な Java ランタイムを必要とします。
アップデート・インストーラー・プログラムが、WebSphere Application Server 製品と共に出荷されているような有効な IBM または Sun SDK を見つけられない場合、アップデート・インストーラーは保守パッケージをインストールすることができません。
Update Installer for WebSphere Software は、適切な IBM SDK を使用するために、既知のロケーションを検索します。
アップデート・インストーラー・ウィザード は順番に、以下のロケーションで有効な Java 仮想マシン (JVM) を探します。
- app_server_root/updateinstaller/java/jre ディレクトリー (製品 SDK を更新する場合)
- ../java/jre ディレクトリー。アップデート・インストーラーをインストール・ルート・ディレクトリーにアンパックした場合、このディレクトリーは、app_server_root/java/jre ディレクトリーとなります。
app_server_root
/updateinstaller
この SDK は優先 SDK です。ただし、アップデート・インストーラー、またはアップデート・インストーラーを組み込んでいる保守パッケージをインストール・ルート・ディレクトリーにアンパックしなかった場合、デフォルトの相対アドレッシング方式は機能しません。そのような場合は、setupCmdLine スクリプトを実行するか、update コマンドで -is:javahome オプションを使用して、正しい JAVA_HOME 変数の設定値を設定します。
AIX または Linux などのシステムにおいて、
以下の環境変数のいずれかによって識別されるディレクトリー。
- JAVA_HOME
- JAVAHOME
- JRE_HOME
- JREHOME
最初の 2 つのロケーションに JVM が存在しない場合、アップデート・インストーラー・ウィザード を指す環境変数の 1 つを
有効な JVM に設定します。
JAVA_HOME 環境変数を設定する優先メソッドは、WebSphere Application Server 製品で提供される setupCmdLine スクリプトを使用することです。
場合によっては、setupCmdLine スクリプトを実行できなかったために、アップデート・インストーラー・プログラムが、説明されている順序とは異なる順序で SDK と一致することがあります。
また、以下のコマンドを使用して、正しい SDK を使用するようにインストールを強制することもできます。
JAVA_HOME 変数を設定するために setupCmdLine スクリプトを使用するには、ご使用のオペレーティング・システムに適切な以下の手順を実行します。
- コマンド・プロンプト・ウィンドウを開きます。
- app_server_root¥bin ディレクトリーに移動します。
- setupCmdLine.bat コマンドを発行します。
- 同じコマンド・プロンプト・ウィンドウを使用して、後のステップの説明に従って、アップデート・インストーラーを開始します。
詳しくは以下の技術情報、Using the setupCmdLine script to set JAVA_HOME
before running the Update Installer for WebSphere software を参照してください。
- 以下の前提条件が満たされていることを確認します。
- updateinstaller
ディレクトリーに移動し、update
コマンドを使用して、保守パッケージをインストールします。
更新しようとする各アプリケーション・サーバー・ノード上に保守パッケージを
インストールする前に、デプロイメント・マネージャー・ノード上に保守パッケージをインストールします。
以下のコマンド構文を使用して、ダウンロードした最新の保守パッケージをインストールします。
アップデート・インストーラー・ウィザードは、2 つのモードで実行します。
バックグラウンド・プロセスとして実行するサイレント・モードと、グラフィカル・ユーザー・インターフェースを使用する通常モードです。
サイレント・モードで実行中の場合、アップデート・インストーラー・ウィザードはグラフィカル・ユーザー・インターフェースを表示しません。
update.bat -silent -options responsefile
./update.sh -silent -options responsefile
または、update
コマンドを発行して、
グラフィカル・ユーザー・インターフェースを開始します。
update.bat
./update.sh
以下の表に、update コマンドを使用するときに使用可能なオプションを示します。
それぞれの最初のテーブルのコマンドは、グラフィカル・ユーザー・インターフェースでアップデート・インストーラー・ウィザードを開始します。
2 番目の表のコマンドは、それぞれアップデート・インストーラー・ウィザードをサイレント・モードで実行します。
表 2. グラフィカル・インターフェースを使用したインストール用のアップデート・インストーラー・コマンド
コマンド例 |
説明 |
update.bat |
保守パッケージ・フィールドを、最新の日付スタンプおよびタイム・スタンプを持つ保守パッケージの名前で
初期設定します。 すべてのデフォルト値を受け入れて、
最新のタイム・スタンプで保守パッケージをインストールします。
|
update.bat -options "responsefiles/file_name" |
オプション応答ファイル内で指定された値で、すべてのグラフィカル・インターフェース値をオーバーライドします。
必ず、updi_root/responsefiles の下の応答ファイルに基づいた応答ファイルを使用してください。
|
update.bat -W maintenance.package="e: ¥IBM¥WebSphere¥AppServer
¥updateinstaller¥maintenance¥ PQ20029.pak" |
保守パッケージの名前を適用してオーバーライドします。 |
update.bat -W product.location="e: ¥IBM¥WebSphere¥AppServer" |
WebSphere ソフトウェアのロケーションを更新してオーバーライドします。
|
update.bat -W product.location="e: ¥IBM¥WebSphere¥AppServer"
-W maintenance.package="e: ¥IBM¥WebSphere¥AppServer ¥updateinstaller¥maintenance¥
PQ20029.pak" |
WebSphere ソフトウェアのロケーションを更新し、保守パッケージの名前を適用してオーバーライドします。
|
update.bat -OPT disableDiskSpaceCheck=true |
ディスク・スペースの前提条件チェックをオーバーライドします。 |
ジョブを異なるサブシステムで実行させる場合は、適切な JOBQ パラメーター値を指定してください。ジョブが実行しているストレージ・プールに、可能な限り多くのメモリーがあることを確認してください。
以下のそれぞれのテーブルのコマンドは、グラフィカル・ユーザー・インターフェースを使用しないでサイレント・モードでアップデート・インストーラー・ウィザードを開始します。
表 3. サイレント・モードでインストールするためのアップデート・インストーラー・コマンド
コマンド例 |
インストールのタイプ |
説明 |
update.bat -silent |
サイレント・モード |
最新のタイム・スタンプを持つ保守パッケージをインストールして、
親ディレクトリー内にインストールされたソフトウェアを更新します。 |
update.bat -silent -W prereqsfailedpanelInstallWizardBean.active=
"false" |
前提条件検査をバイパスするサイレント・モード |
最新のタイム・スタンプを持つ保守パッケージをインストールして、
親ディレクトリー内にインストールされたソフトウェアを更新します。前提条件検査をバイパスします。 |
update.bat -W maintenance.package="e: ¥IBM¥WebSphere¥AppServer
¥updateinstaller¥maintenance ¥PQ20029.pak" -silent |
サイレント・モード |
デフォルトでは、ウィザードは最新の日付スタンプとタイム・スタンプを持つ保守パッケージを
インストールします。 パッケージ・オーバーライドを使用して、別の保守パッケージをインストールします。
応答ファイルは必要ありません。デフォルトのソフトウェアは、親ディレクトリー内にインストールされたソフトウェアです。
|
update.bat -silent -options "responsefiles/file_name" |
オプション・ファイルを持つサイレント・モード |
オプション応答ファイル内で指定された値で、すべてのデフォルト値をオーバーライドします。
updi_root/responsefiles
の応答ファイルに基づいた応答ファイルを、常に使用してください。
|
update.bat -W product.location="e: ¥IBM¥WebSphere¥AppServer"
-silent |
サイレント・モード |
最新の日付スタンプとタイム・スタンプを持つ保守パッケージで、コマンド内で指定された WebSphere ソフトウェアを更新します。
サイレント・インストールは、応答ファイルを参照しません。 |
update.bat -W product.location="e: ¥IBM¥WebSphere¥AppServer"
-W maintenance.package="e: ¥IBM¥WebSphere¥AppServer ¥updateinstaller¥maintenance¥
PQ20029.pak" -silent |
サイレント・モード |
コマンド内で指定された保守パッケージで、コマンド内で指定された WebSphere ソフトウェアを更新します。
サイレント・インストールは、応答ファイルを参照しません。 |
- 保守パッケージが原因でアップデート・インストーラーが Java 2 SDK をコピーする場合は、 「Relaunch」をクリックしてアップデート・インストーラーをもう一度開始します。
保守パッケージに SDK に対するサービスが含まれている場合、アップデート・インストーラーはその SDK をコピーして停止します。「Relaunch」をクリックして、アップデート・インストーラーをもう一度開始してください。これによって、アップデート・インストーラーは、保守パッケージをインストールできます。
次の作業
アップデート・インストーラーの最後のパネルで「Relaunch」をクリックして、2 番目の保守パッケージのインストールを開始します。
すべての保守パッケージをインストールした後、WebSphere ソフトウェアの使用を続行してください。