マイグレーション・ウィザードを使用して、WebSphere Application Server バージョン 5.x または 6.0.x アプリケーション・サーバーからバージョン 6.1 アプリケーション・サーバーにマイグレーションします。
始める前に
マイグレーション、共存、およびインターオペラビリティーの概要
および事前マイグレーションの考慮事項
を参照してください。
マイグレーション・ウィザードの使用前に、
バージョン 6.1 をインストールしておく必要があります。製品および追加のソフトウェアのインストール
を参照してください。
最初にプロファイル管理ツールを使用して、
有効な新規ターゲットのバージョン 6.1 アプリケーション・サーバー・プロファイルを作成することができます (存在していない場合)。
または、後でマイグレーション・ウィザードを使用してターゲット・プロファイルを作成することができます。グラフィカル・ユーザー・インターフェースによるプロファイルの作成
を参照してください。
WebSphere Application Server 基本製品は、インストール中にスタンドアロン・アプリケーション・サーバーに有効なバージョン 6.1 プロファイルを作成します。
ヒント: マイグレーション後に構成を以前の状態に復元する場合は、WebSphere Application Server バージョン 5.x または 6.0.x アプリケーション・サーバーをマイグレーションする前に、
backupConfig コマンドまたは設定済みバックアップ・ユーティリティーを使用して既存の構成をバックアップしてください。
backupConfig コマンド
を参照してください。
このバックアップ構成の正確な名前と位置を記録しておく必要があります。
このタスクについて
マイグレーション・ウィザードは、WebSphere Application Server バージョン 6.0 で導入されました。このウィザードは、
主なバージョン 6.1 コマンド行マイグレーション・ツール (WASPreUpgrade コマンド
および
WASPostUpgrade コマンド
) に対応するグラフィカル・インターフェースです。
マイグレーション中に必要なすべての情報を収集後、ウィザードを使用して、WebSphere Application Server バージョン 5.x または 6.0.x アプリケーション・サーバーをバージョン 6.1 スタンドアロン・アプリケーション・サーバーにマイグレーションします。
マイグレーション時の問題のトラブルシューティングのヘルプについては、マイグレーションのトラブルシューティング
を参照してください。
プロシージャー
- マイグレーション・ウィザードを始動します。
以下のいずれかのアクションを実行して、
マイグレーション・ウィザードにアクセスします。
「スタート」>「プログラム」>「IBM WebSphere」>「Application Server V6.1 」に進み、「マイグレーション・ウィザード」をクリックします。
- 以下のコマンドを実行します。
- ウェルカム・パネルを読んで、マイグレーション・プロセスについて確認し、「次へ」をクリックします。
- マイグレーション元の以前のバージョンの WebSphere Application Server を選択または指定して、「次へ」をクリックします。
選択リストに以前のインストールの位置が表示されない場合、
チェック・ボックスを選択して、以前のインストールの位置を入力します。
- 以前のバージョンの構成のコピーを配置するマイグレーション・バックアップ・ディレクトリーを指定して、「次へ」をクリックします。
このディレクトリーが存在しない場合、ディレクトリーが作成されます。ディレクトリーが存在する場合、
バックアップ・オペレーションは既存のバックアップ・ファイルを上書きするためディレクトリーは空である必要があります。
- マイグレーションするソース・プロファイルを選択して、「次へ」をクリックします。
- インストールに有効なプロファイルのリストからターゲット・プロファイルを選択するか、または「Create new profile」を選択して、「次へ」をクリックします。
ソース・プロファイルのマイグレーションの前に、チェック・ボックスを選択して、ターゲット・プロファイルの構成のバックアップ・コピーを作成します。チェック・ボックスを選択すると、
ターゲット・プロファイルのバックアップ・コピーが、profile_root/temp/MigrationBackup.time_stamp.zip に書き込まれます。
- 最後のパネルで「Create new profile」を選択した場合、
新規プロファイル作成用のパラメーターを入力して、「次へ」をクリックします。
- ソース・プロファイルにインストールされたアプリケーションのマイグレーション用オプションの 1 つを選択して、「次へ」をクリックします。
アプリケーションでは、
以下のいずれかを選択して実行することができます。
- アプリケーションをインストールするオプションを選択した場合、マイグレーションされたアプリケーションが配置される位置を指定して、「次へ」をクリックします。
以下のオプションのいずれかを選択することができます。
- アプリケーションが現在配置されているのと同じディレクトリーにアプリケーションを保持します。
制約事項: このオプションを選択する場合、
この位置は既存の WebSphere Application Server バージョン 5.x または 6.0.x のインストールおよびバージョン 6.1 のインストールと共用になります。マイグレーションされたアプリケーションを以前のバージョンのアプリケーションと同じ位置に保持する場合、以下の制約事項が適用されます。
- WebSphere Application Server バージョン 6.1 混合ノードのサポート制限に従う必要があります。つまり、wsadmin コマンドを呼び出す場合に以下のサポートは使用できません。
- プリコンパイル JSP
- バイナリー構成の使用
- EJB のデプロイ
- バージョン 5.x または 6.0.x のインストールを管理 (アンインストールなど) する際にこれらの位置から後でアプリケーションを削除する場合、マイグレーションしたアプリケーションを不意に失う危険があります。
- ターゲットのバージョンのデフォルトのディレクトリーでアプリケーションのインストールを選択します。
- マイグレーションしたアプリケーションをインストールするディレクトリーを指定します。
- ポート値割り当てのオプションの 1 つを選択して、「次へ」をクリックします。
ポート値では、以下のいずれかを選択して実行することができます。
- マイグレーションしてスクリプト互換性をサポートする場合はチェック・ボックスを選択して、「次へ」をクリックします。
このオプションを選択する場合、
マイグレーションにより以下のバージョン 5.x または 6.0 の構成定義が作成されます。
- トランスポート
- ProcessDef
- バージョン 5.x または 6.0.x の SSL
- バージョン 5.x または 6.0.x の ORB サービス・スレッド・プール
以下のバージョン 6.1 の構成定義の代わり:
- チャネル
- ProcessDefs
- バージョン 6.1 の SSL
- バージョン 6.1 の ORB サービス・スレッド・プール
既存の管理スクリプトへの影響を最小化するためにこのオプションを選択します。例えば、既存の wsadmin スクリプトがある場合、またはサード・パーティーの構成 API を使用してバージョン 5.x または 6.0.x 構成定義を作成または変更するプログラムがある場合、マイグレーション中にこのオプションを選択することができます。
注: このことは、
環境のすべてのノードがバージョン 6.1 レベルに達するまで一時的移行を提供することを意味します。すべてバージョン 6.1 レベルに達した場合、
以下のアクションを実行する必要があります。
- 管理スクリプトを変更して、すべての バージョン 6.1 設定を使用します。
- convertScriptCompatability コマンドを使用して、バージョン 6.1 設定のすべてに一致するように構成を変換します。
convertScriptCompatibility コマンド
を参照してください。
- 「サマリー」パネルの情報をチェックして、情報が正しいことを確認します。次に「次へ」をクリックしてマイグレーションを開始します。
オプションを選択して新規ターゲット・プロファイルを作成する場合、
パネルには作成の開始および結果が表示されます。
パネルにはマイグレーション・プロセスの進行が表示されます。
マイグレーションが失敗すると、ウィザードには「失敗」パネルが表示されます。マイグレーションの一部が成功すると、ウィザードには「警告」パネルが表示されます。
問題を修正し、マイグレーションを再試行します。
事後マイグレーションが成功すると、ウィザードには成功の標識が表示されます。
- 「終了」をクリックして、マイグレーション・ウィザードを終了します。
結果
これで、WebSphere Application Server バージョン 6.1 環境内でマイグレーションされたスタンドアロン・アプリケーション・サーバーを開始することができます。
次の作業
マイグレーション・ツールにより自動的に実行されなかったいくつかの事項を実行する必要があるかもしれません。
- WebSphere Application Server バージョン 5.x または 6.0.x で使用した可能性のある Lightweight Third Party Authentication (LTPA) セキュリティー設定をすべて検査し、バージョン 6.1 セキュリティーが適切に設定されていることを確認します。
LTPA (Lightweight Third Party Authentication)
を参照してください。
- マイグレーション・ツールがマイグレーションしなかった JSP オブジェクトの詳細については、logs ディレクトリーの WASPostUpgrade.log ファイルを調べてください。
バージョン 6.1 が JSP オブジェクトが構成されているレベルをサポートしない場合、マイグレーション・ツールは出力内のオブジェクトを認識して、これらを記録します。
- Java 仮想マシン設定を確認して、
始動パフォーマンスの向上のために、
少なくとも 50 のヒープ・サイズを使用していることを確認します。
Java 仮想マシン設定
を参照してください。
これまでに使用したヒープ・サイズがこれより小さい場合は、
デフォルトのヒープ・サイズ (50) を使用できます。
- データベースを使用するように、WebSphere Application Server を構成します。
例えば、DB2 を使用するよう WebSphere Application Server を構成できます。
- 自動 Cloudscape データベースのマイグレーションの結果を検査して、ツールにより自動的にマイグレーションされないすべての Cloudscape データベースを手動でマイグレーションします。
Cloudscape データベースのマイグレーション
を参照してください。