修正パッケージ(Fix Pack) 適用ガイド WebSphere Application Server V6.1
by user
Comments
Transcript
修正パッケージ(Fix Pack) 適用ガイド WebSphere Application Server V6.1
WebSphere Application Server V6.1 修正パッケージ(Fix Pack) 適用ガイド V1.1 2007 年 11 月 日本アイ・ビー・エム株式会社 ソフトウェア事業 目次 1. はじめに ...............................................................................................................................................2 1-a. WAS V6.0/V6.1 のバージョン表記について .....................................................................................2 1-b. Fix のインストール・アンインストールの順序 .....................................................................................2 1-c. 本ガイドで修正パッケージを適用するにあたって ..............................................................................3 2. Update Installer のダウンロード .............................................................................................................4 3. Update Installer のインストール .............................................................................................................5 4. Refresh Pack/Fix Pack のダウンロード ..................................................................................................9 5. Refresh Pack のインストール...............................................................................................................11 6. Fix Pack のインストール.......................................................................................................................12 7. Fix Pack インストール後の確認............................................................................................................16 8. Refresh Pack/Fix Pack のアンインストール..........................................................................................17 9. Refresh Pack/Fix Pack アンインストール後の確認 ...............................................................................20 変更履歴 2007/11/26 Fixpack ファイルダウンロードに関する補足項目を追加。V1.1 としてリリース。 ・ 「.pak」拡張子が「.pak.zip」に変更されてしまう問題 (Technote : http://www.ibm.com/support/docview.wss?rs=180&uid=swg21256778) 1 1. はじめに WebSphere Application Server(以下WAS)では、定期的に修正パッケージ(Fix)を、以下の製品サポート Webサイトで公開しています。 http://www.ibm.com/software/webservers/appserv/was/support/ 本ガイドは、WAS V6.1の修正パッケージ(Refresh PackとFix Pack)の導入を手順書化したものです。 1-a. WAS V6.0/V6.1 のバージョン表記について WAS V6.0/V6.1では、バージョンを 「V6. x. y. z」 というように、4つの数字の組み合わせで表記します。 各数字は、下表のFixレベルを表します。また、単体の個別Fixのことを単に“Fix”、あるいは“Interim Fix”、 “iFix”とと呼びます。 Fixレベル 表記例 修正(Fix)の内容 Release 「x」 V6.0 大きな機能の追加や変更。 (リリースアップにはパスポート・アドバンテージ契約が必要) Refresh Pack 「y」 V6.0.2 機能の追加や前提条件の更新を含み、その以前に出ている Refresh Packを含んだ修正)の集合。 (V5.0/V5.0では、Fix Packと呼ばれていたもの。) Fix Pack 「z」 V6.0.2.2 複数のFixがまとめて定期的に公開されたもの。その以前に出て いるFix Packを含みます。前提のRefresh Packは別途導入が必 要です。 (例えば、V6.0.2.18の適用には、事前にV6.0.2が導入 されている必要があります。) Fix V6.0.2.2 「PQ00000」や「PK00000」などの個別のFix。 + PQ00000 “Interim Fix”、“iFix”とも表記されます。 例えば、V6.0.2.2とは、V6.0を導入後、Refresh Pack 2とFix Pack 2を適用した環境のことを指します。 1-b. Fix のインストール・アンインストールの順序 Fix Packをインストールする際、前提のRefresh Packがインストールされている必要があり、Interim Fixをイン ストール際には、前提のRefresh Pack + Fix Packの環境である必要があります。そのため、Fixのインストー ルは、「Refresh packのインストール」→「Fix packのインストール」→「Interim Fixのインストール」の順序で 行います。また、WASのRefresh Pack/Fix Packは累積Fixですので、適用Fix以前に出荷されているFixはイン ストールする必要はありません。(たとえば、V6.0.2.3を適用する場合、V6.0.2にFix Pack 1(V6.0.2.1)、Fix Pack 2(V6.0.2.2)をインストールする必要はなく、V6.0.2にFix Pack 3 (V6.0.2.3)のみを適用します。) Fixのアンインストールでは、インストールと逆の順序でアンインストールします。「Interim Fixのアンインストー ル」→「Fix Packのアンインストール」→「Refresh Packのアンインストール」の順序で行います。 2 WAS V6.0/V6.1のバージョン表記のストラテジーについては、以下のWebサイトの情報もご参照ください。 Update Strategy for WebSphere Application Server V6.0 release http://www.ibm.com/support/docview.wss?rs=180&uid=swg21191989 本ガイドでは、“Refresh Pack”、“Fix Pack”の適用手順について記述します。 1-c. 本ガイドで修正パッケージを適用するにあたって WebSphere Application Server (以下WAS)ではFixの導入のために Update Installer という ツールを 用意しています。Fixを導入したり、既に導入済みのFixの情報を参照、あるいは削除したりする事が可能です。 但し、適用するFixの前提条件等もありますので、適用時には各FixのReadmeもご参照の上、適用をお願いし ます。 本文中で使用されている<WAS_ROOT>とは、WASのインストールディレクトリーのことであり、 各プラットフォームのデフォルトは、以下のディレクトリーとなります。 [AIX 環境] :/usr/WebSphere/AppServer [Linux/Solaris/HP-UX 環境] :/opt/WebSphere/AppServer [Windows 環境] :C:¥Program Files¥WebSphere¥AppServer 各コマンドやツールの詳細な情報については、適用するFix/Update Installerのreadmeや、infocenterを 合わせてご参照ください。 また、本文中のURLおよびWebサイトの画面イメージは、2006年9月現在のものであり、将来変更される場合 がありますのでご注意ください。 3 2. Update Installer のダウンロード 修正パッケージの更新・削除に使用するツールの Update Installer は、下記 Web サイトよりダウンロードして導 入します。 Update Installer for WebSphere Application Server V6.1 releases http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24012718 既に Update Installer を導入されている場合も、最新版の Update Installer のご利用ください。 1. 上記 URL より Update Installer ダウンロードサイトに移動します。下の画面で「Download package」の欄 からお使いのプラットフォームの「Download Options」(“FTP”もしくは“DD”)を選択し、クリックします。 2. ライセンスについての説明が表示されたら、内容を確認して“I agree”をクリックします。 ファイルのダウンロード・ウィンドウが表示されますので、任意のディレクトリーに保存します。 4 3. ダウンロードした Update Installer の zip ファイルを任意のディレクトリーに保管します。 (例 : /tmp/wasfix/update/download.updii.6100.linux.ia32.zip) 以上で Update Installer のダウンロードは完了です。 3. Update Installer のインストール Update Installer をインストールします。 1. “2. Update Installer のダウンロード”でダウンロードした Update Installer の zip ファイルを任意のディレ クトリーに解凍し展開します。(例 : /tmp/wasfix/update/) 2. コマンドプロンプトを立ち上げ、Update Installer を展開したディレクトリーの UpdateInstaller ディレクトリー に移動し、install コマンドを実行します。 例) # cd /tmp/wasfix/update/UpdateInstaller # ./install 3. Update Installer のインストール・ウィザードが起動します。“次へ”をクリックします。 5 4. “ソフトウェア・ライセンス情報”では使用条件に同意して“次へ”をクリックします。同意いただけない場合は、 Update Installer を使用することができません。 5. ”システム前提条件の検査”が始まりますのでそのまま待ちます。正常に終了したら”次へ”をクリックしま す。 6 6. 「インストール・ディレクトリー」で Update Installer の導入先を指定します。デフォルトのまま、または必要に 応じて書き換えて「次へ」をクリックします。 【インストール・ロケーション設定例】 [AIX 環境] :/usr/WebSphere/UpdateInstaller [Linux/Solaris/HP-UX 環境] :/opt/WebSphere/UpdateInstaller [Windows 環境] :C:¥Program Files¥WebSphere¥UpdateInstaller 7. “インストールの要約”が表示されます。内容を確認し“次へ”をクリックします。インストールが開始されま す。 7 8. インストールが終了すると、“インストール完了”が表示されます。内容を確認し“終了”をクリックします。 以上で Update Installer のインストールは完了です。 8 4. Refresh Pack/Fix Pack のダウンロード Refresh Pack/Fix Pack は、製品サポート・サイトよりダウンロードして導入します。 1. 製品のサポート・サイトで、最新 Fix を調べます。下記 Web サイトにアクセスし、「Download」の 「Recommended fixes」をクリックしてください。 http://www.ibm.com/software/webservers/appserv/was/support/ 2. 各バージョンの最新 Fix 情報一覧が表示されます。「Version 6.1」をクリックすると、最新 Fix 一覧表に移動 します。ご使用の OS プラットフォームのリンクをクリックし、ダウンロードページに移動します。 9 3. 適用する Refresh Pack/Fix Pack をダウンロードします。ダウンロードページで、「Download package」の 「Download Options」の“FTP”もしくは“DD”をクリックします。 (“FTP”, “DD”のどちらを選択していただいても同じモジュールをダウンロードできます。) 4. ライセンスについての説明が表示されます。内容を確認して“I agree”をクリックします。 10 5. Refresh Pack/Fix Pack ファイルのダウンロード・ウィンドウが表示されますので任意のディレクトリーに一 旦保管し、以下のようにファイルを配置します。 • WAS V6.1 の Refresh Pack/Fix Pack ファイルは、.pak 拡張子のファイル形式で提供されています。 (例:6.1.0-WS-WAS-LinuxX32-FP0000002.pak) • .pak ファイルを任意のディレクトリーに保存します。 Update Installer の導入ディレクトリーの下の maintenance ディレクトリーへの保存を推奨します。 (例: /opt/IBM/WebSphere/UpdateInstaller/maintenance/6.1.0-WS-WAS-LinuxX32-FP0000002.pak) 次のステップの“6. Fix Pack のインストール”では、導入する Fix を指定する際に、この.pak ファイルを指定し ます。 以上で Refresh Pack/Fix Pack のダウンロードは完了です。 5. Refresh Pack のインストール 2006 年 9 月 28 日現在、V6.1 の最新 Fix レベルは V6.1.0.2 で、Refresh Pack はまだ提供されておりません。 Refresh Pack の適用作業は不要ですので、次のステップ“6. Fix Pack のインストール“にお進み下さい。 ※当ガイドでは Refresh Pack 公開後、適用手順を追記いたします。 11 6. Fix Pack のインストール ●インストールを行う前の注意事項 導入前にすべての WAS, IHS が停止していることを確認してください。 1. また、WAS 以外で稼動している java プロセスについても停止する必要があります。 2. AIX 環境では不要なライブラリをアンロードするため、root で slibclean を実行してください。 3. ファイルシステムのスペースに不足がないことを確認してください。 ・[AIX] : /tmp、/usr に各々約 400M ・[Linux および AIX 以外の UNIX ベースのプラットフォーム] : /tmp、/opt に各々約 400M (上記のプラットフォームにおける /usr 、/opt 配下に必要とされるスペースは WAS のインストー ルディレクトリーに依存します。インストールディレクトリーを変更している場合は、そのファイルシ ステムのスペースを確保してください。) ・[Windows] : インストールを実行するディスクに約 800M ●インストール時の注意事項/推奨事項 ・ WebSphere Application Server Network Deployment ( WAS ND ) を 導 入 さ れ て い る お 客 様 は 、 DeploymentManager の Fix レベルが AppServer より高く(新しく)なければなりません。WAS ND を導入 されているお客様は、まず先に Fix を DeploymentManager へ適用し、その後、AppServer へ適用をお願 いします。 ・ アップデート・インストーラー・プログラムを並行して起動することはできません。複数の更新を同時に実行 すると、インストールの失敗や不完全なインストールを引き起こす可能性があります。 ・ テスト環境下での適用確認を 実行してからの本番環境での適用を推奨します。 ・ Fix 適用前に Back-up などをとり、問題発生時にすばやく対処できるよう対策をとることを推奨します。 ● Update Installer にはウィザード(GUI)モードとサイレント(CUI)モードがあります。本ガイドででは、GUI モ ードのインストール手順を示します。 1. Update Installer を起動します。コマンドプロンプトを立ち上げ、以下のコマンドを実行してください。 • Update Installer をインストールしたディレクトリーに移動します。 update.bat (あるいは、update.sh)を実行します。 例) # cd /opt/IBM/WebSphere/UpdateInstaller # ./update.sh 12 2. ウィザード形式の Update Installer が起動します。”次へ”をクリックします。 3. 更新する WAS のインストールディレクトリー(<WAS_ROOT>)を入力し、 “次へ”をクリックします。 13 4. “保守パッケージのインストール”を選択し”次へ”をクリックします。 5. インストール Refresh Pack のファイル名を入力し、“次へ”をクリックします。 「Refresh pack のファイル名」とは、.pak 拡張子のファイルを指定します。“4. Refresh Pack/Fix Pack の ダウンロード”の“手順5.”でダウンロードし保存した.pak ファイルです。 (例:/opt/IBM/WebSphere/UpdateInstaller/maintenance/6.1.0-WS-WAS-LinuxX32-FP0000002.pak ) ※[補足] V6.1 では Fix ファイルをダウンロードする場合、ダウンロードを行ったブラウザーによっては、ファ イル拡張子が 「.pak」だったものが、「.pak.zip」に変更されてしまう場合があります。この場合、インストー ルやアンインストールに問題が発生しますので、必ず、ダウンロードしたファイル名をご確認いただき、拡 張子が異なる場合はリネームしてください。以下の Technote 文書もあわせてご参照ください。 UpdateInstaller for version 6.0 or 6.1 is unable to uninstall fix due to a ".pak.zip" file extension http://www.ibm.com/support/docview.wss?rs=180&uid=swg21256778 14 6. 更新内容の確認画面が表示されます。内容を確認し、”次へ”をクリックします。インストールが開始しま す。 7. インストールが完了したら“終了”をクリックします。 以上で、Fix Pack のインストールは完了です。 15 7. Fix Pack インストール後の確認 <WAS_ROOT>¥bin¥versionInfo.bat あるいは versionInfo.sh を実行し、Fix レベルを含めたバージョン を確認します。 ● versionInfo.bat(sh)の実行結果例 (V6.1 に Fix pack 2 をインストールした例) WVER0010I: Copyright (c) IBM Corporation 2002, 2005; All rights reserved. WVER0012I: VersionInfo reporter バージョン 1.15.1.13、日付 3/29/06 -------------------------------------------------------------------------------IBM WebSphere Application Server 製品インストール状況レポート -------------------------------------------------------------------------------日時 2006/09/26 11:37:10 JST におけるレポート インストール -------------------------------------------------------------------------------製品ディレクトリー /opt/IBM/WebSphere/AppServer バージョン・ディレクトリー /opt/IBM/WebSphere/AppServer/properties/version DTD ディレクトリー /opt/IBM/WebSphere/AppServer/properties/version/dtd ログ・ディレクトリー /opt/IBM/WebSphere/AppServer/logs バックアップ・ディレクトリー /opt/IBM/WebSphere/AppServer/properties/version/nif/backup TMP ディレクトリー /tmp Product List -------------------------------------------------------------------------------ND インストール済み インストール済み製品 -------------------------------------------------------------------------------名前 IBM WebSphere Application Server - ND バージョン 6.1.0.2 ID ND ビルド・レベル cf20633.22 ビルド日 8/18/06 -------------------------------------------------------------------------------インストール状況レポートの終了 -------------------------------------------------------------------------------- 適用したFixが適用され、“インストール済み製品”の“バージョン”が更新されていれば正しくアンインストールさ れています。 問題が発生した場合には<WAS_ROOT>¥logs¥updateにあるlogファイルを確認してください。 16 8. Refresh Pack/Fix Pack のアンインストール 一度適用した Refresh Pack/Fix Pack は、以下の手順でアンインストールすることができます。 ●アンインストール時の注意事項 WebSphere Application Server Network Deployment(WAS ND)では、DeploymentManager の Fix レベルが AppServer より高く(新しく)なければなりません。WAS ND を導入されているお客様は、 AppServer に適用した修正、DeploymentManager に適用した修正の順でアンインストールを実行して 下さい。 1. Update Installer を起動します。“6. Fix Pack のインストール”の“手順 1“から”手順 3” までと同じ手順を 実行します。そちらをご参照ください。”手順 4 “の画面で”保守パッケージのアンインストール“を選択し“次 へ”をクリックします。 17 2. インストール済みの修正が一覧表示されます。表示されている修正のリストの中からアンインストールする Refresh Pack あるいは Fix Ppack を選択し、“次へ”をクリックします。 3. アンインストールについての確認画面が表示されます。内容を確認し、誤りがなければ “ 次 へ”を クリックします。アンインストールが開始されます。 18 4. アンインストールが完了したら“終了”をクリックします。 以上で、Refresh Pack/Fix Pack のアンインストールは完了です。 19 9. Refresh Pack/Fix Pack アンインストール後の確認 <WAS_ROOT>¥bin¥versionInfo.bat あるいは versionInfo.sh を実行し、Fix レベルを含めたバージョン を確認します。 ● versionInfo.bat(sh)の実行結果例 (V6.1.0.2 から Fix pack 2 をアンインストールした例) WVER0010I: Copyright (c) IBM Corporation 2002, 2005; All rights reserved. WVER0012I: VersionInfo reporter バージョン 1.15.1.13、日付 3/29/06 -------------------------------------------------------------------------------IBM WebSphere Application Server 製品インストール状況レポート -------------------------------------------------------------------------------日時 2006/09/26 11:15:07 JST におけるレポート インストール -------------------------------------------------------------------------------製品ディレクトリー /opt/IBM/WebSphere/AppServer バージョン・ディレクトリー /opt/IBM/WebSphere/AppServer/properties/version DTD ディレクトリー /opt/IBM/WebSphere/AppServer/properties/version/dtd ログ・ディレクトリー /opt/IBM/WebSphere/AppServer/logs バックアップ・ディレクトリー /opt/IBM/WebSphere/AppServer/properties/version/nif/backup TMP ディレクトリー /tmp Product List -------------------------------------------------------------------------------ND インストール済み インストール済み製品 -------------------------------------------------------------------------------名前 IBM WebSphere Application Server - ND バージョン 6.1.0.0 ID ND ビルド・レベル b0620.14 ビルド日 5/16/06 -------------------------------------------------------------------------------インストール状況レポートの終了 -------------------------------------------------------------------------------- Fixがアンインストールされ、“インストール済み製品”の“バージョン”が更新されていれば正しくアンインストー ルされています。 問題が発生した場合には<WAS_ROOT>¥logs¥updateにあるlogファイルを確認してください。 20