websphereapplication server v8.5for ibm i への移...

© 2012 IBM Japan Systems Engineering Co.,Ltd.

WebSphere Application Server V8.5 for IBM i へのへのへのへの移行移行移行移行ガイドガイドガイドガイド

IBM Power Systems

© 2012 IBM Japan Systems Engineering Co.,Ltd.2

Disclaimer

� この資料は日本アイ・ビー・エム株式会社ならびに日本アイ・ビー・エムシステムズ・エンジニアリング株式会社の正式なレビューを受けておりません。

� 当資料は、資料内で説明されている製品の仕様を保証するものではありません。

� 資料の内容には正確を期するよう注意しておりますが、この資料の内容は2012年12月現在の情報であり、製品の新しいリリース、PTFなどによって動作、仕様が変わる可能性があるのでご

注意下さい。

� 今後国内で提供されるリリース情報は、対応する発表レターなどでご確認ください。

IBM Power Systems


特記事項および商標�本文書の内容は、特に記載の無い限り、2012年12月27日現在に公開されている文書に基づいています。

�本文書において、IBM 製品、プログラム、およびサービスについて言及する場合がありますが、このことはこのような IBM 製品、プログラム、およびサービスが IBM が企業活動を行っているすべての国で使用できることを意味するものではありません。本文書で、IBM 製品、プログラム又はサービスに言及する部分があっても、このことは当該製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらのIBM製品、プログラム、またはサービスに代えて、IBM の知的所有権を侵害することのない機能的に同等のプログラムを使用することができます。

�本文書に記載されている情報の使用または手法の実施は、お客様の評価および使用している動作環境への統合能力にしたがって、お客様の責任で行っていただきます。記載されている情報はいずれもIBMにより、特定の状況における正確さは確認されているはずですが、いかなる環境においてもそれと同じ、あるいは同様な結果が得られるとは限りません。お客様独自の環境において、これらの手法を適用する場合は、お客様の責任で行っていただきます。

�商標- AIX は International Business Machines Corporation の登録商標- AIX 5L はInternational Business Machines Corporation の商標- AIX 6 はInternational Business Machines Corporation の商標- AIX 7 はInternational Business Machines Corporation の商標- IBM はInternational Business Machines Corporation の登録商標- UNIX は、 The Open Group の米国ならびに他の国における登録商標- PowerPC は International Business Machines Corporation の登録商標- POWER4 は International Business Machines Corporation の商標- POWER5 は International Business Machines Corporation の商標- POWER6 は International Business Machines Corporation の商標- POWER7 は International Business Machines Corporation の商標- IBM System は International Business Machines Corporation の商標- IBM eServer は International Business Machines Corporation の商標- Power Systems は International Business Machines Corporation の商標- pSeries は International Business Machines Corporation の商標- BladeCenter は International Business Machines Corporation の商標- IBM i5/OS は International Business Machines Corporation の商標- Systems Director VMControl は International Business Machines Corporation の商標- IBM Systems Director Active Energy Managerは International Business Machines Corporation の商標- Intel, Pentium は Intel Corporation の米国およびその他の国における登録商標- Linux は、Linus Torvalds の米国およびその他の国における登録商標- その他、本文書で使用するシステム名、製品名、会社・団体の名称はそれぞれ各社の商標または登録商標です

IBM Power Systems


更新履歴

� 2012年 12月 27日初版 (Rev. 1.0)

IBM Power Systems


当資料の前提� IBM iで稼動する下記WebSphere Application Server バージョンからの移行を前提としています

- WebSphere Application Server V6.1



- (参考)2012年12月現在サポートされているWASのバージョン

- IBM i におけるWASの各バージョンにおけるサポート情報の詳細• http://www-03.ibm.com/systems/i/software/websphere/index.html

� IBM iにおいては、GUIベースの移行ツールはサポートされていません

- コマンド･ライン･ベースの移行ツールのみ使用可能です

IBM i 7.1

IBM i 6.1

i5/OS 5.4 (2013/9末サポート終了)

7.0

IBM i 7.1

IBM i 6.1

i5/OS 5.4 (2013/9末サポート終了)

6.1

(2013/9末サポート終了)

WebSphere Application Server

製品名製品名製品名製品名

IBM i 7.1

IBM i 6.1

8.5

IBM i 7.1

IBM i 6.1

8.0

バージョンバージョンバージョンバージョンサポートサポートサポートサポートするするするするIBM i ののののバージョンバージョンバージョンバージョン

IBM Power Systems


目次

1. WebSphere Application Server V8.5 for IBM i 移行概要

2. 移行手順

3. 考慮点

IBM Power Systems


第第第第1章章章章WebSphere Application Server V8.5 for IBM i 移行概要移行概要移行概要移行概要

IBM Power Systems


WAS環境の移行概要

� IBM iにおけるWAS環境の移行方法について

- 同一システムで移行

• 複数バージョンのWASを稼働させることが可能

• 使用するポートの区別

• HTTPサーバー

• 新規に作成

• 別ポート使用もしくは本番稼働時にポートを切り替え

• 既存のものを使用

• 本番稼働時にプラグインを切り替え

• (考慮事項考慮事項考慮事項考慮事項) OSのバージョン変更、最新のPTF適用などにより、HTTP

サーバーにも機能的な変更が発生するので、十分に検証を行ってください

- 別システムへ移行

• 既存サーバー環境と同一の構成にて新規導入

• HTTPサーバーも新規に構成

• DNSにて既存システムから新システムにIPアドレス、DNSを切り替え

� アプリケーションの移行

- APIなど変更点に対応し、アプリケーションを修正し新環境に移行(デプロイ)

• バージョン間の変更点を確認できるツールあり

要事前調査

アプリケーション担当者に要確認

WAS6.1

WAS8.5

HTTPサーサーサーサーバーバーバーバー

IBM i


WAS6.1

IBM i


WAS8.5

IBM i


IBM Power Systems


WAS V6.1以前のバージョンから移行する場合の変更点

� IBM i のJVM 変更によって、WASで使用されるデフォルトのJVMが変わります

- WASV6.1以前のWASプロファイルでは、Classic JVMと呼ばれるi5/OS® Java Developer Kit Java

仮想マシンが使用されています

- WAS V7からは、IBM Technology for Java (J9)と呼ばれるIBM ® Java SE 6 32 ビット JVM がデフォルト使用に変更されています(使用されるJVMについては次ページ参照)

• enablejvm(WAS V7以下)/managesdk(WAS V8以上)コマンドで切り替え可能だが、J9 の使用が推奨

• WASV6.1からJ9の選択が可能(デフォルトはClassic JVM)

- (参考)使用しているJVMの確認方法

• WRKACTJOBにて、起動しているサーバーのジョブログを表示

ｼﾞｮﾌﾞ . : SERVER1 ﾕｰｻﾞｰ . : QEJBSVR 番号 . . . : 408427

>> CALL PGM(QWAS7A/QWASSTRSVR) PARM('-profilePath'

'/QIBM/UserData/WebSphere/AppServer/V7/Express/profiles/default' '-server' ‘SERVER1')

408427/QEJBSVR/SERVER1 の ACGDTA がジャーナルできない。理由は 1 です。Java 仮想仮想仮想仮想マシンマシンマシンマシンはははは IBM Technology for Java ですですですです。。。。 PID(656)

プロパティー・ファイルから JVM プロパティーがロードされましたServer starting with user profile QEJBSVR and JDK 1.6.0.

WebSphere application server SERVER1 ready.

IBM i 7.1からClassic JVMなし

例えば、WAS V7 on IBM i 6.1では、Classic JVMの可能性があります

IBM Power Systems


(参考)デフォルトで使用されるJVMの種類

� OSのバージョン、WASのバージョンによって、サーバーで使用されるJVMのデフォルトが異なり

ます

- IBM i 6.1では、Classic JVMの場合、J9の場合の両方が考えられます

- 以下は、OS、WASのバージョンによって、デフォルトで使用されるJVMを示しています

• ただし、個別にJAVA_HOMEを指定している場合、この限りではありません

- 実際にサーバーで使用されているJVMを確認するためには、前ページにあるWRKACTJOBコマンドを

使用します

IBM i 7.1IBM i 6.1i5/OS 5.4WASバージョンバージョンバージョンバージョン

Classic

J9(32bit)

J9(32bit)

J9(32bit)

5761JV1 Opt10

(Classic) 未導入未導入未導入未導入

Classic

J9(32bit)

5761JV1 Opt10

(Classic) 導入済導入済導入済導入済みみみみ

6.1

8.0

7.0

OSバージョンバージョンバージョンバージョン

J9(32bit)J9(32bit)

J9(32bit)Classic

8.5 J9(32bit)

J9(32bit)

※表の見方Classic = i5/OS® Java Developer Kit Java 仮想マシンJ9(32bit) = IBM Technology for Java 仮想マシン 32bit

IBM Power Systems


JVM変更による影響

� JVMの違いによる考慮点

- 64bit Sun互換のJVM (Classic JVM) � IBM仕様のJVM (IBM Technology for Java (J9)) に変更

- 32bitアドレス空間の選択肢が追加

• 32bitを選択した場合、メモリーの制約があるため、OutOfMemoryになる可能性がある

• オブジェクトの参照には4バイトのメモリーを使用

• 64-bit Classic JVM では8バイト

• 実質的な最大ヒープ・サイズは2.5GB以下

• 64-bit Classic JVMでは最大240GB

• アプリケーションの挙動が異なる場合があるため検証が必要

- ガーベッジ･コレクションの実装が異なる

• 最大/初期ヒープ･サイズの指定が必須

• Classic JVMでは、最大ヒープ･サイズに0(サイズ制限なし)を指定するなど、異なります

• ガーベッジ･コレクションは、一部スレッド停止がありうるため、GCポーズのタイミングが異なる

• Classic JVMでは、ガーベッジ･コレクションは非同期で実施するため、スレッド停止のタイミングが極小化さ

れている

現行のメモリーに関する設定、ヒープの利用状況を調査する必要がある

J9 JVMのデフォルトは、32bitアドレス↓↓↓↓

Classic JVM（64bit）上で稼働しているアプリケーションのメモリー状況を要確認

IBM Power Systems


(参考) Classic JVM vs IBM Technology for Java JVM

� “Classic”JVM = i5/OS® Java Developer Kit Java JVM

- OS/400 V4R2からJVMが標準実装 (1998より出荷)

- OS/400 System Licensed Internal Code (SLIC)内に実装

- 64-bit JVM を 64-bit hardware上で実装

- Direct Execution (DE)

• CRTJVAPGMによる実行ファイルの作成

- 並列（非同期）ガーベッジ・コレクション機能

� “IBM Technology for Java” JVM = IBM ® Java SE 6 JVM

- IBM i V5R4よりサポート

- IBM i PASE 上で稼働• AIX アプリケーション用の統合ランタイム環境

- 32-bit、64-bit アドレス空間• IBM i6.1から64-bit アドレス空間サポート

- 様々なガーベッジ・コレクション（GC）の方法を提供• Optimize for throughput

• Optimize for pause time

• Generational concurrent

• Subpooling

IBM i ユニーク

Windows、Unixなど他のOSと同じ実装

IBM Power Systems


その他変更一般� サポートされるAPIの変更

- JDK1.4、JDK5からJDK6、JDK7への変更

- WASの各バージョンと対応するJava EE/Java SE仕様

• Java仕様の変更に伴いアプリケーションの改修が必要か検討してください

• 上位互換はあるが、一部アプリケーションの再コンパイルが必要な場合もあります

• APIの変更については、Information Center及びORACLE Java SE6のサイトを参照してください

- 移行する前に、WebSphere Application Server バージョン 8.5において非推奨(deprecate)となった項目を予め確認してください

• (参考)

• Information Center: API および仕様のマイグレーション

• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.migration.express.iseries.doc/ae/cmig_apispec.html

• ORACLE: Java Compatibility

• http://www.oracle.com/technetwork/java/javase/compatibility-137541.html

• Information Center：非推奨のフィーチャー、安定化されたフィーチャー、および除去されたフィーチャー

• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.express.iseries.doc/ae/rmig_deprecationlist.html

○

Java EE 7

○○○○○8.5

○○○○8.0

○○○7.0

○○6.1

Java SE7Java SE6J2SE 5.0JavaEE 6JavaEE 5J2EE1.4WASバージョンバージョンバージョンバージョン

Java SE仕様仕様仕様仕様Java EE仕様仕様仕様仕様

IBM Power Systems


第第第第2章章章章

移行手順移行手順移行手順移行手順

IBM Power Systems


移行の流れ

� IBM iにおけるWAS V8.5への移行の主な流れは以下の通りです

1. 事前調査

2. WAS V8.5の導入及び新規プロファイルの作成

– 新規システムへの導入

– 同一システムへの導入(複数バージョンの共存)

3. アプリケーション･サーバー(プロファイル)構成の移行– 移行ツール(コマンド･ライン･スクリプト)の使用

– 手動での移行

4. HTTPサーバー構成の移行

5. アプリケーションの移行

� 当当当当ガイドガイドガイドガイドではではではでは計画計画計画計画、、、、テストテストテストテスト、、、、スキルスキルスキルスキル習得習得習得習得などについてはなどについてはなどについてはなどについては触触触触れておりませんがれておりませんがれておりませんがれておりませんが、、、、各各各各プロジェクトプロジェクトプロジェクトプロジェクトでででで個別個別個別個別にににに対応対応対応対応がががが必要必要必要必要ですですですです

= 当ガイドでのご説明範囲

1

5

2～～～～4

IBM Power Systems


1. 事前調査(1)

� WAS V8.5への移行にあたり、以下の項目について事前に調査します

- JVMの最大/初期ヒープサイズの設定

• 管理コンソールからの確認方法(V6.1の場合)

• アプリケーションアプリケーションアプリケーションアプリケーション・・・・サーバーサーバーサーバーサーバー > サーバーサーバーサーバーサーバー名名名名 > プロセスプロセスプロセスプロセス定義定義定義定義 > Java 仮想仮想仮想仮想マシンマシンマシンマシン

• 初期ヒープ･サイズ、最大ヒープ･サイズの設定

最大ヒープ･サイズが”0”となっている場合、Classic JVMが使用されていることを示します

IBM Power Systems


1. 事前調査(2)

- ヒープの使用状況を確認

• verbosegcを設定し、JVMログを確認します

• 管理コンソールからの設定方法(V6.1の場合)

• アプリケーションアプリケーションアプリケーションアプリケーション・・・・サーバーサーバーサーバーサーバー > サーバーサーバーサーバーサーバー名名名名 > プロセスプロセスプロセスプロセス定義定義定義定義 > Java 仮想仮想仮想仮想マシンマシンマシンマシン

• 冗長ガーベッジ･コレクションの設定にチェックをつけます

• 出力されるnative_stdout.logを確認します

• GCのログはPMATなどのツールで確認することができます

• http://www.alphaworks.ibm.com/tech/pmat

PMAT=IBM Pattern Modeling and Analysis Tool for Java Garbage Collector

IBM Power Systems


1. 事前調査(3)

- 既存環境でのサーバー構成• WASサーバーの構成を調査

• パラメーター･シートなどを活用• IHS/WAS V7.0パラメーターシート (WAS-08-057)

• https://www-304.ibm.com/support/docview.wss?uid=jpn1J1006511

• WebSphere Application Server V8.0 パラメーター･シート• http://www.ibm.com/developerworks/jp/websphere/library/was/was8_parameter/

• HTTPサーバー構成を調査(別筐体への移行もしくは、既存環境で新規構築の場合)

• httpd.confの確認

• 上述パラメーター･シートなどを活用

• その他• ホスト名、ネットワーク構成など• デプロイされているアプリケーション(アプリケーションの種類、JDKバージョンなど)

- WASバージョン間での変更点の調査• 調査した現行環境を参考に、バージョン間での変更点による影響を調査

• WAS V6.1=>V7.0 バージョンアップにより変更されたデフォルト値について• http://www-01.ibm.com/support/docview.wss?uid=jpn1J1003639

• WAS V8.0 変更パラメーター一覧(WAS-11-041)

• http://www-01.ibm.com/support/docview.wss?uid=jpn1J1008398

IBM Power Systems


(参考)使用されているポートの確認

� 事前調査を行う際、ポートの競合などを防ぐため事前調査が必要です

- 各WASバージョンで使用されるポートの種類、ポート番号のデフォルト値は以下の通りです

5060506050605060SIP Container Port (SIP_ DEFAULTHOST)

7286728672867286Service Integration Secure Port (SIB_ ENDPOINT_ SECURE_ ADDRESS)

7276727672767276Service Integration Port (SIB_ ENDPOINT_ ADDRESS)

9401940194019401SAS_ SSL_ SERVERAUTH_ LISTENER_ ADDRESS (Deprecated)

9100910091009100ORB Listener Port (ORB_ LISTENER_ ADDRESS)

5578557855785578MQ Transport Secure Port (SIB_ MQ_ ENDPOINT_ SECURE_ ADDRESS)

5558555855585558MQ Transport Port (SIB_ MQ_ ENDPOINT_ ADDRESS)

-963396339633IPC Connector Port (IPC_ CONNECTOR_ ADDRESS)

5557555755575557Internal JMS Server Port (JMSSERVER_ SECURITY_ PORT)

9353935393539353High Availability Manager Communication Port (DCS_ UNICAST_ ADDRESS)

9403940394039403CSIV2 Server Authentication Listener Port (CSIV2_ SSL_ SERVERAUTH_ LISTENER_

ADDRESS)

9402940294029402CSIV2 Client Authentication Listener Port (CSIV2_ SSL_ MUTUALAUTH_ LISTENER_

ADDRESS)

2809280928092809Bootstrap Port (BOOTSTRAP_ ADDRESS)

9443944394439443HTTPS Transport Secure Port (WC_ defaulthost_ secure)

9080908090809080HTTP Transport Port (WC_ defaulthost)

9043904390439043Administrative Console Secure Port (WC_ adminhost_ secure)

9060906090609060Administrative Console Port (WC_ adminhost)

V6.1V7.0V8.0V8.5ポートポートポートポート名名名名

IBM Power Systems


(参考)使用されているポートの確認－つづき

- 確認方法

• QSHELLから以下のスクリプトを実行して確認

• /QIBM/ProdData/WebSphere/AppServer/<version>/<edition>/bin/dspwasinst –profileName <XXXX>

• <version><edition><XXXX>は適宜WASのバージョン、エディション、プロファイル名に置換えて使用

• 管理コンソールから確認(WAS V6.1の場合)

• 「サーバー」→「アプリケーション･サーバー」→「<サーバー名>」→「通信」→「ポート」

8008800880088008IBM HTTPS Server Administration Port

80808080IBM® HTTP Server Port

--11004Administration Overlay TCP Port (OVERLAY_ TCP_ LISTENER_ ADDRESS)

--11003Administration Overlay UDP Port (OVERLAY_ UDP_ LISTENER_ ADDRESS)

8880888088808880SOAP Connector Port (SOAP_ CONNECTOR_ ADDRESS)

5061506150615061SIP Container Secure Port (SIP_ DEFAULTHOST_ SECURE)

V6.1V7.0V8.0V8.5ポートポートポートポート名名名名

IBM Power Systems


2. WAS V8.5の導入及び新規プロファイルの作成

� WAS V8.5を導入し、新規プロファイルを作成します

- 新システムに導入する場合

• 事前調査で確認したポートを指定し、プロファイルを構成します

• 別ポートを使用する場合を除く

• WAS構成情報をWASPreUpgrade/WASPostUpgradeツールを使って移行する場合、プロ

ファイル名を既存環境と新環境で同じにしておく必要がある

- 既存システムに導入し、複数バージョンを共存させる場合

• 既存WAS環境で使用しているポート番号と重複しないようプロファイルを構成します

• 詳細については次ページ参照

� (参考)WebSphere Application Server V8.5 for IBM i 導入・構成ガイド

- http://www.ibm.com/developerworks/jp/websphere/library/was/was85fori_install/

• WAS V6.1、7.0から移行される場合、WAS V8.0以降では導入方法が変更されているため、上記

ガイドを参考にしてください

IBM Power Systems


(参考)複数バージョンの共存

� 複数バージョンの共存- 複数のバージョンの WebSphere® Application Server を、同一システム上で同時に実行できます- 共存する際には、各プロファイル(サーバー)が使用するポートが競合しないよう注意が必要です

� サポートされるバージョンの共存- WebSphere Application Server バージョン 8.5 製品は、ポートの競合が起こらない限り、以下のサ

ポート対象バージョンと共存させることができます• WebSphere Application Server バージョン 6.1

• WebSphere Application Server バージョン 7.0


- ポートの競合を回避するためには、以下の点に注意• 現行機で使用されているポートの洗い出し

• servicetoolsスクリプトにて、サーバー上で構成されているWASプロファイルのポートを確認• (例) QSHELLより• /QIBM/ProdData/WebSphere/AppServer/V85/Express/bin/servicetools -portconflict

-products ALL

• (参考)Information Center: 複数のバージョンのアプリケーション・サーバーの相互運用• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp?topic=%2Fcom.ibm.websphere.migration.e

xpress.iseries.doc%2Fae%2Fcmig_coexist.html

• Information Center:ポート・バリデーター・ツール• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.base.iseries.doc/ae/rxml_p

ortvalidator.html

IBM Power Systems


3. アプリケーション･サーバー構成の移行

� WASのプロファイル構成を移行します

- 手動で構成内容を移行

• 事前調査、計画(設計書)に基づき、新規プロファイルを手動で構成

• 設定を一つずつ洗い出し、バージョン間での違いなどを確認しながら移行が可能

- 移行ツール(コマンド･ライン･スクリプト)を使用して構成内容を移行

• WASPreUpgrade/WASPostUpgrade スクリプトを使用し、既存構成情報を新環境に復元

• スクリプトを使用する場合、前バージョンで使用していた設定の大半がそのまま自動的に移行されるため、移行後、適宜チューニング、調整が必要

• また、移行スクリプトでサポートされない設定(HTTPサーバー、プラグインなど)あるため、その点については手動

で対応が必要

WAS v6.1, v7.0, v8.0

プロファイル構成情報

WASPreUpgrade

移行されたWAS v8.5

プロファイル

WAS v8.5プロファイル

WASPostUpgrade

新規作成

･サーバー構成･アプリケーション・リソース

パラメーター･シートなどの活用

IBM Power Systems


WASPreUpgrade/WASPostUpgrade構成移行スクリプト

- WASPreUpgradeスクリプトを実行し、旧WAS環境の構成情報を抽出• WASV8.5で提供されているWASPreUpgradeスクリプトを使用します

• (注意注意注意注意) 移行元移行元移行元移行元となるとなるとなるとなる環境環境環境環境にもにもにもにも、、、、WAS V8.5をををを導入導入導入導入するするするする必要必要必要必要がありますがありますがありますがあります

- WAS V8.5を導入した新環境にてWASPostUpgradeスクリプトを実行• 予めWAS V8.5のプロファイルを作成しておく必要があります

• 既存のプロファイルに対し、移行元の構成情報を上書きします

• -replacePorts パラメーターでtrueを指定すると、旧環境で使用していたポートを構成で上書きします

• falseを指定すると、ポートは置き換えられない

• -includeApps パラメーターでtrueを指定すると、アプリケーションも移行することができますが、アプリケーションは事前にテストし、そのまま修正なしで移行できることを確認してから実施してください

- 移行元プロファイル名と、移行先プロファイル名は一致させる必要があります• 移行元プロファイルと同じ名前で、WAS V8.5プロファイルを作成し構成情報を移行します

- HTTPサーバー構成、及びプラグインは、移行ツール対象外のため、手動で対応する必要があります

IBM Power Systems


構成移行スクリプトの実行方法 –WASPreUpgrade

- QSHELLよりWASV8.5のWASPreUpgrade/WASPostUpgradeスクリプトを実行

• 実行するユーザー･プロファイルは*ALLOBJ権限が必要

• WASPreUpgrade実行例

• /QIBM/ProdData/WebSphere/AppServer/V85/xxxxx/bin/WASPreUpgrade /temp

/QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/TEST –machineChange

true

• xxxxはエディション Baseの場合Baseをxxxxに置き換え

• backupDirectory：抽出した構成ファイルを出力するディレクトリー。WASの導入ディレクトリー、ユーザー･ディレクトリー/QIBM/xxxxData/WebSphere～を指定することはできません(上記例では、 /temp を使用)

• currentWebSphereDirectory：移行元のWASプロファイルのディレクトリー (上記例では、/QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/TEST を使用)

※※※※(注意注意注意注意)ここでここでここでここで指定指定指定指定するするするするプロファイルプロファイルプロファイルプロファイルとととと、、、、移行先移行先移行先移行先ののののプロファイルプロファイルプロファイルプロファイル名名名名はははは同同同同じであるじであるじであるじである必要必要必要必要があがあがあがあ

りますりますりますります

• -machineChange：別システムでこの構成を復元する場合trueを指定。デフォルトはfalse

• WASPreUpgradeコマンド：http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp?topic=%2Fcom.ibm.websphere.migr

ation.base.iseries.doc%2Fae%2Frmig_WASPreUpgrade.html

IBM Power Systems


構成移行スクリプトの実行結果 –WASPreUpgrade

- WASPreUpgradeスクリプト実行により、指定したディレクトリーに下記ファイルが生成されます

• logsディレクトリー：スクリプト実行時ログを格納

• websphere_backupディレクトリー：プロファイルの構成情報ファイルを格納

• PreUpgradeInfo.propsファイル

• websphere_backup_cmd_line_args.serファイル

• RemoteFileIndex.txtファイル

- 別システムに移行する場合、上記ディレクトリーを全てSAV/RSTで移行します• SAV/RST、、、、FTPなどのなどのなどのなどの際際際際、、、、上記上記上記上記ファイルファイルファイルファイルががががCCSID 1208 (UTF-8) 以外以外以外以外にににに変更変更変更変更されるとされるとされるとされると、、、、移行移行移行移行スクリスクリスクリスクリ

プトプトプトプトをををを実行実行実行実行できないためできないためできないためできないため注意注意注意注意がががが必要必要必要必要ですですですです

- logsディレクトリーに生成できるログから、実行結果を確認できます• WASPreUpgrade.<profile_name>.<timestamp>.log

• profile_name= 実施したプロファイル名

• timestamp =スクリプトを実施した時のタイムスタンプ

• スクリプト成功時ログ

• MIGR0420I: マイグレーションの最初のステップが正常に完了しました。

• 上記以外のメッセージが出力された場合には、前述の実行時ログを確認してください

IBM Power Systems


構成移行スクリプトの実行方法 –WASPostUpgrade

- WASPostUpgrade実行例

• /QIBM/ProdData/WebSphere/AppServer/V85/xxxxx/bin/WASPostUpgrade /temp -profileName TEST –

includeApps false

• xxxxはエディション Baseの場合Baseをxxxxに置き換え

• backupDirectory=抽出した構成ファイルを出力するディレクトリー(事前に、WASPreUpgrade情報をSAV/RSTコマンドで復元しておく必要があります)

• profileName = 構成の復元先となるプロファイル名。例ではTEST という名のプロファイルWASPreUpgradeでででで抽出抽出抽出抽出したしたしたしたプロファイルプロファイルプロファイルプロファイルとととと同名同名同名同名であるであるであるである必要必要必要必要がありますがありますがありますがあります。。。。またまたまたまた指定指定指定指定しないしないしないしない場合場合場合場合、、、、defaultププププ

ロファイルロファイルロファイルロファイルがががが上書上書上書上書きされるためきされるためきされるためきされるため、、、、注意注意注意注意がががが必要必要必要必要ですですですです

• -includeApps true | false | script = アプリケーションも移行するかどうかの有無(太字=デフォルト)

• アプリケーションは別途移行検証を行った上でインストールするため、デフォルトのままではなく”false”(移行しない)と設定することを推奨します

• 上記以外に以下のオプションを指定することもできます(太字太字太字太字がデフォルトの設定です)

• -portBlock port_starting_number = 置き換える場合の最初のポート番号

• -backupConfig true | false = 既存WAS8.5の構成のバックアップ実施有無

• -replacePorts true | false = ポートを置き換えるかどうかの指定

• WASPostUpgradeコマンド：http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp?topic=%2Fcom.ibm.websphere.migration.base.is

eries.doc%2Fae%2Frmig_WASPostUpgrade.html

IBM Power Systems


構成移行スクリプトの実行結果 –WASPostUpgrade

- WASPostUpgradeスクリプトの実行内容については、バックアップ･ディレクトリーのlogsファイルに出力される以下のログ(もしくは、QSHELLでの実行結果) から確認できます

• WASPostUpgrade.<profile_name>.<timestamp>.log

• profile_name =スクリプトを実施した際に指定したプロファイル名

• timestamp =スクリプトを実施した時のタイムスタンプ

• スクリプト成功時ログ

• MIGR0259I: マイグレーションは正常に完了しました。

• 上記以外のメッセージが出力された場合には、前述の実行時ログを確認してください

QSH コマンド入力

> /QIBM/ProdData/WebSphere/AppServer/V85/> /QIBM/ProdData/WebSphere/AppServer/V85/> /QIBM/ProdData/WebSphere/AppServer/V85/> /QIBM/ProdData/WebSphere/AppServer/V85/BASEBASEBASEBASE/bin/WASPostUpgrade /t/bin/WASPostUpgrade /t/bin/WASPostUpgrade /t/bin/WASPostUpgrade /temp emp emp emp ----profileNameprofileNameprofileNameprofileName WAS61 WAS61 WAS61 WAS61 IBM WebSphere Application Server, Release 8.5 Product Upgrade PostUpgrade tool, Version 1.0 Copyright IBM Corp., 1997-2010

MIGR0304I: 前の WebSphere 環境をこのプロファイルにマージしています。The file handle limit is set below the optimum limit of 10,000. If you do notchange the file handle limit to 10,000 or above, then the migration might fail. MIGR0459I: アプリケーション・サーバー構成ファイルはマイグレーション中です。MIGR0367I: 現行のアプリケーション・サーバー環境をバックアップしています。

････(途中省略)・・・・MIGR0307I: 前のアプリケーション・サーバー環境のリストアが完了しました。MIGR02MIGR02MIGR02MIGR0259I59I59I59I: : : : マイグレーションマイグレーションマイグレーションマイグレーションはははは正常正常正常正常にににに完了完了完了完了しましたしましたしましたしました

IBM Power Systems


4. HTTPサーバー構成の移行

� HTTPサーバー構成を移行します- HTTPサーバー構成とプラグインは、スクリプトによる移行ができないため、手動で移行、別システムに

移行する場合は新規に作成する必要があります

- 新規システムにサーバーを作成する場合• 既存システムで使用しているHTTPサーバーの構成を参考に新規作成

• 構成ファイルhttpd.confをSAV/RSTし、システムに依存する部分などを修正

• ホスト名、IPアドレス

• プラグインなど (WebSpherePluginConfig、LoadModule)

- 既存システムにWAS環境を共存させる場合• HTTPサーバーのWAS V8.5に合わせ新規に構築、もしくは既存のものを使用

• 新規HTTPサーバーを構築

• 既存サーバー･ポートとの調整

• WASプラグイン･ファイルに新しいWASV8.5のものを指定

• 既存HTTPサーバーを使用

• テストではWAS内部HTTPサーバー、もしくはテスト用HTTPサーバーを用意

• 本番(既存)HTTPサーバーへの切り替え

• プラグインの変更、再生成

• HTTPサーバーの再起動

� SSL(HTTPS)を使用していた場合は、新環境において再設定が必要です

IBM Power Systems


HTTPサーバー構成ファイル(httpd.conf)抜粋�変更前(移行前)

-WebSpherePluginConfig/QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/WAS61/config/cells/MELON_WAS61/nodes/MELON_WAS61/servers/IHS_WAS61HTTP/plugin-cfg.xml

-LoadModule was_ap20_module /QSYS.LIB/QWAS61A.LIB/QSVTAP22.SRVPGM

-# HTTP server (powered by Apache) configuration

-DocumentRoot /www/was61http/htdocs

-ServerRoot /www/was61http

-Options -ExecCGI -FollowSymLinks -SymLinksIfOwnerMatch -Includes -IncludesNoExec -Indexes -MultiViews

-Listen *:80

-Listen *:443 https• 以下省略

�変更後(移行後)

-WebSpherePluginConfig

/QIBM/UserData/WebSphere/AppServer/V85/Base/profiles/WAS61/config/cells/LUCY04_WAS61/nodes/LUCY04_WAS6

1/servers/IHS_WAS85HTTP/plugin-cfg.xml

-LoadModule was_ap20_module /QSYS.LIB/QWAS85A.LIB/QSVTAP22.SRVPGM

-# HTTP server (powered by Apache) configuration

-DocumentRoot /www/was61http/htdocs

-ServerRoot /www/was61http

-Options -ExecCGI -FollowSymLinks -SymLinksIfOwnerMatch -Includes -IncludesNoExec -Indexes -MultiViews

-Listen *:80

-Listen *:443 https

• 以下省略

� WebSpherePluginConfigの設定を、新しいWAS V8.5

プロファイル用に変更�LoadModule をWAS V8.5用に変更(OS、WASのバージョンによってライブラリー、プログラム名が異なります)

※設定方法は次ページ参照

IBM Power Systems


(参考)HTTPサーバー構成におけるWASの設定

� IBM Web Administration for i から、HTTPサーバーの構成を編集することができます

- WebSphere Application Serverの設定から、使用するプロファイルを指定します

IBM Power Systems


HTTPサーバーとWASプラグインの再構成

� 移行ツールを使用して移行した場合、HTTPサーバーとプラグインの再構成が必要です

- WASPreUpgrade/WASPostUpgradeスクリプトにより、HTTPサーバーの構成情報も新環境に引き継がれたように管理コンソール上見えるが、httpd.confなどはツールでは引き継がれていないため起動し

ません

- IBM Web Administration for i からHTTPサーバーの作成、構成が必要です

• 管理コンソールからHTTPサーバーの定義を

削除･新規作成を行う方法もあります

HTTPサーバーも移行されたように、管

理コンソールからは見えますが、このままでは起動、使用することはできません

IBM Power Systems


HTTPサーバーで定義されているホスト名の修正

� WASPreUpgrade/WASPostUpgradeで移行されたHTTPサーバー情報には、古いホ

スト名が含まれるため修正が必要です

- この作業は管理コンソールからHTTPサーバーの構成情報を削除･再作成する場合は不要

移行前環境のホスト名情報が入っているため、移行先新環境のホスト名に修正する必要があります

IBM Power Systems


5. アプリケーションの移行

� アプリケーションの移行方法

- 適宜API、仕様の変更に対応した改修を実施

• 各WASバージョンでサポートされる仕様

- Application Migration Toolkitを使って移行の分析

- APIの変更などにより、アプリケーションを書き換え、WAS V8.5用のアプリケーション(.ear)を用意

JDBC 4.03.02.13.08.5

JDBC 4.03.02.12.58.0

JDBC 4.03.02.12.57.0

JDBC 3.0

DB Connection

2.12.02.46.1

EJBJSPServlet

WASバージョンバージョンバージョンバージョン

○○○○

Java EE 7

○○○○○○○○○○○○○○○○○○○○8.5

○○○○8.0

○○○7.0

○○6.1

Java SE7Java SE6J2SE 5.0JavaEE 6JavaEE 5J2EE1.4WASバージョンバージョンバージョンバージョン

Java SE仕様仕様仕様仕様Java EE仕様仕様仕様仕様

IBM Power Systems


APIおよび仕様のマイグレーション

� J2EE/Java EEアプリケーションのマイグレーション

- J2EE 1.2から1.3以降へは、基本的な上位互換が保たれている

• ただし、J2EE 1.3から国際化対応の機能が導入されたため、日本語環境のアプリケーションでは

何らか対応が必要となるケースが多い

• 細かい仕様の変更があるため、個別に対応が必要となるケースもあり

- J2EE 1.3から1.4以降へは、高いレベルで上位互換が保たれている

• 多くのアプリケーションは、変更なしに稼動する

• アプリケーションによっては、若干の手直しが必要となるケースもある

- 基本的に、J2EE 1.4アプリケーションであれば、WAS V8.5でそのまま動作可能

• Java EE 5/6 の新機能を使用する場合にはマイグレーションする

- Webサービス

• J2EE 1.3以前では、標準化されていないため、書き換えが必要となるケースが多発

- IBM独自機能を仕様している部分については、書き換えが必要となるケースもある

IBM Power Systems


J2EE/Java EEマイグレーション･ウィザード

� Rational開発ツール(RAD、RBD, etc)を使うことで、DD (Deployment Descriptor)な

どの構成ファイルを自動的に書き換えることも可能

移行先のJava EEバージョン

を指定

対象のプロジェクトを選択

RAD=IBM Rational Application Developer for WebSphere SoftwareRBD=IBM Rational Business Developer

IBM Power Systems


Java SE仕様(J2SE仕様)のマイグレーション

� JDK 1.3/1.4からJDK 5.0/6.0への移行

- バイト･コード･レベルで上位互換が保たれている

• 以前の環境でコンパイルしたClassファイルはほとんどそのまま使用できる

- ソース･コード･レベルでは書き換えが必要なケースも

• 追加された予約語「assert」「enum」の対応

• Genericsへの対応

• 強化されたコード･チェックによる、エラー・警告への対応

• java.lang.reflect.Proxyと同名のjava.net.Proxyが追加

• java.util.Loggerのコンストラクターの変更など

- 詳細については、以下の文書を参照

• http://www.oracle.com/technetwork/java/javase/compatibility-137541.html

IBM Power Systems


Application Migration Toolkit

� アプリケーションの移行をサポートするEclipseベースのツール

- 無償でダウンロード、使用が可能

• Application Migration Toolkit WebSphere Version to Version V3.5 がWebSphere Application

Server V8.5に対応

- 移行のためのコードを分析

• 修正が必要な箇所をリストアップし、修正方法についてのガイドを表示

- コード品質の最適化

- ツールでサポートする移行元バージョン

• WebSphere Application Server バージョン 5.1以上

- ツールでサポートする移行先バージョン

• WebSphere Application Server バージョン 7.0以上



- (参考) WebSphere バージョンのマイグレーション用 Application Migration Tool

• http://public.dhe.ibm.com/software/dw/jp/websphere/was/was_migration_toolkit/ApplicationM

igrationTool_ja_JP.3.5.0_WebSphere_v2v.pdf

IBM Power Systems


新環境へのアプリケーションの移行

� アプリケーションを新環境に移行します

- WAS V8.5の環境でテストされた.earファイルを用意します

� WAS V8.5サーバーへアプリケーション導入時の考慮点

- WAS V5.1から移行する場合には、WAS V7.0と比べて以下の点が異なりますのでご注意く

ださい

• アプリケーション（EAR）のデプロイ時にWARのマップ先として、アプリケーション・サーバーだけではなく、HTTPサーバーも選択します

アプリケーション･サーバーとHTTP

サーバーの両方にマップ

IBM Power Systems


第第第第3章章章章

考慮点考慮点考慮点考慮点

IBM Power Systems


【FAQ】関連データの移行

� Question：：：：IFS上のWAS関連データをSAV/RSTコマンドで移行してよいか- アプリケーションの詳細や、サーバーの設計書がないため、IFS上のデータをSAV/RSTで

移行してもよいでしょうか?

� Answer：：：：同一バージョンであっても、IFSののののディレクトリーディレクトリーディレクトリーディレクトリー全全全全てをてをてをてをSAV/RSTするのはするのはするのはするのは避避避避けてくださいけてくださいけてくださいけてください

• バックアップ･リカバリーという観点を除く

- 新システム、新環境に、旧システムのIFSデータを全てRSTした場合予期しない挙動が考えられます

• RST後、Web Administration for iから構築中のアプリケーション･サーバーを停止したにも関わらず、稼働中の本番サーバーが停止される

• Web Administration for iから、サーバーにアクセスできない(起動･停止ができない)

- 「第2章移行手順」に書かれているように、新規にWASを導入、新規にサーバーを構成した上で、アプリケーションを移行してください

トラブルトラブルトラブルトラブル多発多発多発多発！！！！要注意要注意要注意要注意！！！！

IBM Power Systems


各WASバージョンでの変更点

� IBM iに限らず、他のプラットフォームと共通で、WASのバージョンによって変更点があります

- 「WebSphere Application Server Version 8.5へのマイグレーション･ガイド」にまとめられているものを参照してください

• http://public.dhe.ibm.com/software/dw/jp/websphere/was/was85_migration/WAS85MigrationGuide.pdf

- その他、Information Centerなどに変更点がまとめられていますので、こちらも合わせて参照してください

• WAS V8.5

• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.express.iseries.doc/ae/welc_transition.html

• WAS V8.0

• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r0/topic/com.ibm.websphere.express.iseries.doc/info/iseriesexp/ae/welc_transition.html

• WAS V7.0

• http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/welc_newinrelease.html

• WebSphere Application Server Versions:What’s Different? (for v8.5 and earlier) (英語)

• http://www-01.ibm.com/support/docview.wss?uid=swg27008724&aid=9

IBM Power Systems


構成移行スクリプト使用に関して

� 構成を抽出する際、移行先となるWAS V7のスクリプトを使用して実行してください

- 古いバージョンのスクリプトを使用しても、抽出した情報をWAS V7の復元スクリプトWASPostUpgradeで認識できません

� WASPostUpgradeにてprofileNameを指定しないと、デフォルトではDefaultプロファイ

ルに復元されます

� WASPostUpgradeで復元先となるプロファイルのセキュリティはオフにしておきます

- セキュリティがオンになっているプロファイル･構成を復元することで、自動的にセキュリティはオンになります

IBM Power Systems


参考資料参考資料参考資料参考資料

IBM Power Systems


参考資料 (1)

� マイグレーションについて- WebSphere Application Server Version 8.5 Information Center:マイグレーション、共存、

および相互運用• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.express.i

series.doc/ae/welc6topmigrating.html

- WebSphere Application Server Version 8.5へのマイグレーションガイド• http://public.dhe.ibm.com/software/dw/jp/websphere/was/was85_migration/WAS85

MigrationGuide.pdf

- developerWorks Japan:WebSphere Application Server V7へのマイグレーションのためのクイック・ガイド

• http://www.ibm.com/developerworks/jp/websphere/library/was/was7_mig_quick/

- Knowledge Collection: Migration planning for WebSphere Application Server(USサイト)

• http://www-01.ibm.com/support/docview.wss?uid=swg27008724

- IBM WebSphere Application Server Migration – Planning and Best Practices(USサイト)

• http://www-01.ibm.com/support/docview.wss?uid=swg27008724&aid=7

- WebSphere Application Server V8.5 Migration Guide (USサイト)

• http://www.redbooks.ibm.com/redbooks/pdfs/sg248048.pdf

IBM Power Systems


参考資料 (2)

� WAS V8.5 情報について- WebSphere Application Server V8.5 Information Center

• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp

- WebSphere Application Server V8.5 for IBM i 導入・構成ガイド• http://www.ibm.com/developerworks/jp/websphere/library/was/was85fori_install/

- developerWorks:WebSphere Application Server (WAS)

• http://www.ibm.com/developerworks/jp/websphere/category/was/index.html

- Roadmap for WebSphere Application Server Version 8.5

• http://www.ibm.com/developerworks/websphere/zones/was/roadmaps/was85_roadmap.html

� Javaについて- InformationCenter: Java Platform, Enterprise Edition (Java EE) 6へのマイグレーション

• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.express.iseries.doc/ae/tovr_migrating_javaee.html

- InformationCenter: Java Platform, Standard Edition (Java SE) 6へのマイグレーション• http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.express.i

series.doc/ae/tovr_migratingjava.html

websphereapplication server v8.5for ibm i への移...

Documents