GlassFish Wiki : M2GMigrateAppJa

アプリケーションのマイグレーション

本項（アプリケーションのマイグレーション）では、以下の手順について説明します：

入力元 Java EE アプリケーションの詳細設定
出力先 Java EE アプリケーションの詳細設定
マイグレーションの実行
自動マイグレーション・プロセス
マイグレーション・レポート
ツールバーの利用
メニューオプションの利用

入力元 Java EE アプリケーション詳細の設定

Source (Input) Applicationのパネルでは、次の項目を指定できます：

移行するアプリケーションが配備されている、移行元のアプリケーションサーバ
移行しようとしている Java EE コンポーネント、あるいはアプリケーションの位置および詳細

移行元サーバの指定

"Source Server" のドロップダウンリストから、移行元サーバを選択します。マイグレーションツールは、入力元として次のプラットフォームをサポートします。

WebLogic Server 5.1/6.0/6.1/8.1
WebSphere Application Server 4.0/5.x
J2EE Reference Implementation Application Server 1.3/1.4　（※Javaリファレンス実装アプリケーションサーバ 1.3/1.4）
JBoss Application Server 3.0
Sun Java System Application Server 7
Sun ONE Application Server 6.5
Tomcat Web Server 4.1

アプリケーションのディレクトリ、またはアーカイブの指定

入力元は以下のいずれかの形で指定できます。

すべてのソースファイルを含む単一のディレクトリ
単一のアーカイブファイル
ディレクトリ内に含まれる特定のファイルタイプ

入力元として複数のアーカイブやディレクトリを指定する場合は "Source" ラジオボタンを、単一のアーカイブを指定する場合は "Archive" ラジオボタンを選択してください。

入力元に単一のアーカイブを指定する

入力元として単一のアーカイブファイルを指定するには：

"Archive" のテキストフィールドにアーカイブのパスを直接入力するか、 "Browse..." ボタンをクリックして対象のアーカイブを選択してください。
"Browse..." ボタンからアーカイブを選択すると、アーカイブへのパスがテキストフィールドに表示されます。

入力元として単一のディレクトリを指定する

入力元として単一のディレクトリを指定する場合、以下のいずれかの手順に従ってください。

単一のディレクトリ内にあるすべてのファイルをマイグレートする：

a. ソースファイルが格納されている単一のディレクトリを選択する場合、"Source" のテキストフィールドにアプリケーションのパスを直接入力するか、 "Browse..." ボタンをクリックして対象のディレクトリを選択してください。
b. "Browse..." ボタンからアーカイブを選択すると、ディレクトリ名がテキストフィールドに表示されます。

単一のディレクトリ内にある特定のタイプのファイルをマイグレートする：

a. 特定のタイプのファイルをマイグレートしたい場合、まずディレクトリを選択し、続いて "Filter..." ボタンを使用します。Filtterボタンを押下すると "Migrate files of type..." というポップアップが表示されますので、ここでマイグレートするファイルタイプを選択してください。選択されたタイプのファイルのみが、ソースファイルを含むディレクトリからマイグレートされます。それ以外のタイプのファイルはすべてそのまま残ります。
b. ディレクトリ内に複数のアーカイブが含まれる場合は、ポップアップで "Archive Files (.jar/.war)" を選択する必要があります。

JAR/WAR/RAR ファイル、あるいは EAR ファイルが入力元として指定されたことをマイグレーションツールが検知すると、ツールはホームディレクトリ内に一時ディレクトリを作成します。ディレクトリ名は "asmt_" で始まり、末尾に "TIMESTAMP" が付加されます。また、 asmt_TIMESTAMP ディレクトリ内には Input_Archives と呼ばれるディレクトリが作成されます。 JAR/WAR/RAR/EAR ファイルは Input_Archives ディレクトリから展開され、この Input_Archives ディレクトリが入力元としてマイグレーションツールに渡されます。

展開された JAR/WAR/RAR/EAR ファイルに何らかの変更を施したい場合は、 Input_Archives 内のファイルを直接操作して構いません。変更を加えたら、改めてマイグレーションツールにそのディレクトリを入力元として登録してください。変更を施すたびにアーカイブを展開する必要はありません。

検証の実施

"Migrate" ボタンを押下すると、マイグレーション・ツールは入力元の詳細について以下の検証を行います：

入力元としてディレクトリを選択した場合、 Java 、JSP 、 XML 、 HTM/HTML 、JAR 、 WAR 、 RAR 、およびサーバ構成ファイルが格納された単一のディレクトリのみが正しい入力元であると判断されます。
入力元としてアーカイブを選択した場合は、単一の EAR 、 JAR 、 WAR および RAR ファイルのみが正しい入力元であると判断されます。
アーカイブファイルは事前に一旦展開されるのに対し、ソースファイルは即時にマイグレートされます。従って、入力元としてアーカイブファイル (JAR/WAR/RAR/EAR) とソースファイル (HTML 、 Java 、 JSP、 XML および構成ファイル) を同時に選択することはできません。
application.xml 内に記載されていない JAR ファイルが EAR ファイル内に見つかると、マイグレーション・ツールはそれらの JAR ファイルを Input_Archives ディレクトリ内の Utilities ディレクトリに移動します。
アーカイブファイルを正しく展開するため、マイグレーションツールは出力先ディレクトリ名に不適切なスペースが含まれていると展開を中断して警告を表示します。
入力元には JAR/WAR/RAR を指定することができますが、複数のアーカイブ（ EAR ファイル）を入力元として指定することはできません。
"Migrate" ボタンが押下されると、マイグレーションツールは選択された全てのファイルを順に処理していきます。前の画面で指定したアプリケーション・サーバとは関係のないファイルを検出した場合、ツールは cross-server 入力に関する確認画面を表示します。ここで処理の続行を選択すると、適合しないファイルは無視されます。たとえば、移行元サーバに WebSphere アプリケーション・サーバ 4.0 を選択したのに入力元のディレクトリ／ファイルの中に weblogic.xml が含まれる場合、 "Migrate" ボタンを押下すると次のようなメッセージダイアログが表示されます:
```
"Warning: Found following proprietary file(s) [weblogic.xml] in the input source code. 
Source server selected is WebSphere Application server 4.0 whose proprietary files would be migrated. 
The artifacts for the other appservers would not be migrated. Do you
want to continue ?"
```
空のディレクトリをマイグレートすることはできません。

出力先 Java EE アプリケーションの詳細設定

アプリケーションのマイグレート先アプリケーションサーバ、およびマイグレーション・ツールが移行対象のソースファイルを書き出す出力先ディレクトリの指定は、 "Output Java EE Appkication Details （出力先 Java EE アプリケーションの詳細設定）" パネルで行います。
マイグレーションツールがサポートするマイグレート先アプリケーションサーバは、 Sun Java Application Server のみとなっています。出力先アプリケーションサーバに加えて、マイグレーションに関するいくつかの高度なオプションを指定することも可能です。

出力先ディレクトリの指定

出力先ディレクトリのパスを "Directory" のテキストフィールドに直接入力するか、"Browse" ボタンを押下して出力先のディレクトリを選択します。マイグレーション・ツールは、このディレクトリにデータを書き出し、ファイル類をマイグレートします。

ターゲットサーバの指定

"Target Server" のドロップダウンリストには、Java EE アプリケーションのマイグレート先となるターゲット・アプリケーションサーバが入っています。といっても、実際に選択できるのは Sun Java Application Server ただひとつです。選択肢は一つしかありませんが、それでもドロップダウンメニューから選択してください。

高度なマイグレーション・オプションの指定

"Advanced" ボタンを押下して、 "Advanced Migration Options" のダイアログを表示してください。このダイアログでは、次のようなオプション指定を行うことができます。

"Migrate CMPs from EJB1.1 to 2.0 specs" （CMP の EJB1.1 を 2.0 の仕様に合わせてマイグレートする）

このオプションを選択すると、マイグレーションツールは入力元アプリケーションに含まれる EJB 1.1 準拠の CMP エンティティ Bean を、EJB 2.0 CMP の仕様にアップグレードします。はじめに、マイグレーションツールは入力元ソースの中の CMP エンティティ Bean が EJB 2.0 CMP の仕様にアップグレード可能かどうかを検証します。

なお、ツールは以下の項目については変換を行いません：

（ Remote インタフェース、 Home インタフェース、およびプライマリ･キー・クラスから構成される） Bean の remoteAPI
Bean のビジネス・ファンクション

次に、マイグレーション・ツールは第一段階においてアップグレード可能であるとみなされた全ての Bean を、実際に EJB 2.0 準拠のエンティティ Bean にアップグレードします。また、アップロードできない Bean に対しては、アプリケーション・サーバへの配備を可能にするため、最小限の修正が加えられます。なお、このオプションを選択下場合は、次の二つのオプションを指定することが可能です。

"Overwrite conflicting accessors （競合するアクセサを上書きする） "

この "forced migration （強制マイグレーション）" を選ぶと、第一段階で行われる検証のうちの一つがスキップされます。このオプションを選択すると、移行中のアプリケーションに影響が及びます。

"Comment out setters of primary key fields（setter およびプライマリ・キー・フィールドをコメントアウトする） "

この "forced migration" オプションも、第一段階で行われる検証のうちの一つをスキップさせます。このオプションを選択した場合も、移行中のアプリケーションに影響が及びます。

Java2DB Tool Invocation （Java2DB ツールの起動）
Java2DB ツールを使用するにはこのオプションを選択し、マイグレーションがアウトプットを生成するように設定します。このオプションを選択した場合は、以下の設定も行えます：

"Create tables at deploy" オプションにチェックを入れて、配備時に自動的にテーブルを作成できます。
"Delete tables at undeploy" にチェックを入れて、アプリケーションの配備解除時に自動的にテーブルを削除できます。
"Database vendor name （データベース・ベンダ名）" を指定できます。何も指定しない場合は、デフォルトのデータベース (SQL-92) になります。

Java2DB サポートにより、 EJB モジュールが ejb-jar.xml 配備記述子、 sun-ejb-jar.xml 配備記述子、および CMP Bean クラスやインタフェースのみで構成される場合も、アプリケーションは首尾よくアプリケーション・サーバ上に配備されます。
なお、この際に生成される sun-cmp-mappings 配備記述子、 ddl ファイル、およびデータベース・メタデータに関するファイル (.dbschema) を操作して、自動生成されたマッピング情報を変更することも可能です。

検証の実施

"Migration" ボタンを押下すると、マイグレーション・ツールは出力項目の詳細について、以下の検証を実施します：

正しい出力先ディレクトリが指定されているかを確認。
指定されたディレクトリが存在しない場合、ツールは新規ディレクトリを作成するか（ディレクトリは書き込み許可となります）、もしくは別のディレクトリを指定するよう促します。
新しいディレクトリを作成するよう指定した場合、マイグレーション・ツールにより出力用のディレクトリが作成されます。

注意 - 次に示す特殊文字を含む名前でディレクトリを作成することはできません：アスタリスク , 小なり (<), 大なり (>), アンパサンド (&), 垂直バー (|), 感嘆符 , シャープ (#), セミコロン (, コロン (, 空白, 単一引用符（開始） (`), 単一引用符（終了） ('), ドルマーク ($), バックスラッシュ () 。
ただし、これらの特殊記号を含む名前の既存ディレクトリを選択することは可能です。

指定されたディレクトリが空ではない場合、警告メッセージを表示します。
マイグレーション・ツールを一度呼び出すだけで、複数のマイグレーション・プロセスを同時に実行することが可能です。ただし、連続したセッションにおいて同一の入力元／出力先ディレクトリを指定した場合、ツールが警告メッセージを表示します。
直前のマイグレーション・セッションをキャンセルした場合（そして、同じ出力先ディレクトリを再度指定した場合）、マイグレーション・ツールは出力されたファイルが上書きされる可能性があるという警告メッセージを表示します。

マイグレーションの実行

このエリアにあるボタンには、入力元および出力元に関する設定をすべて終えた後に実行可能となるさまざまなアクションが割り付けられています。

このエリアには 4 つのボタンがあります。それぞれの機能は以下の通りです：

"Migrate" ボタンは、実際にアプリケーションのマイグレーションを開始するためのものです。ツールはマイグレーションを開始する前に、入力元、および出力先に関する詳細設定が妥当であるかどうかの検証を行います。ここでは、 "入力元 Java EE アプリケーションの詳細設定" および "出力先 Java EE アプリケーションの詳細設定" で解説されているような事項がチェックされます。ユーザが入力した入力元および出力先に関する詳細設定の検証が完了すると、自動マイグレーション進行プロセスがスタートします。
プロジェクトのマイグレーションが完了していれば、 "View Report（レポートを見る）" ボタンで現在開いているプロジェクトのマイグレーション・レポートを閲覧できます。詳しいマイグレーション・レポートは、独立した別のウィンドウに表示されます。レポートには、マイグレーションツールにより処理されたファイルのステータスが記載されています。また、マイグレーションツールが生成したビルドスクリプトやその他のファイルについての情報も含まれます。各ファイルへのフルパス名は HTML のハイパーリンクになっていますので、 Migration Report Window （マイグレーションレポート・ウィンドウ）でリンクをクリックして、マイグレートされたファイルのソースコードを見ることができます。なお、マイグレーションが実行されていない場合、あるいはマイグレーション・ファイルが削除され、プロジェクトファイルで指定された場所にマイグレーションレポートのファイルが存在しない場合は、このボタンは使用不可となります。
"Reset Fields （フィールドのリセット） " ボタンは以下の処理を行い、マイグレーションツールの再初期化を行います：

すべてのテキストフィールドをクリアする
全てのドロップダウン・リストを初期状態に戻す
"Advanced Migration Options" で指定された全てのオプションを解除する
入力元として指定された単一ディレクトリユーザの選択を解除し、別のアプリケーションのマイグレーションを行えるようにする
このボタンを使って、新規マイグレーションプロジェクトを開くことはできません。

"Exit" ボタンを押下すると、マイグレーションツールを終了します。終了時にはプロジェクトファイルを保存するかの確認ダイアログが表示されます。

自動マイグレーションプロセス

Automatic Migration Progress （自動マイグレーションプロセス）のスクリーンには、マイグレーションの進行状況が表示されます。スクリーンにはプログレスバー（進捗バー）が表示され、マイグレーションツールが現在実行している処理が示されます。プログレスバーの他には Java EE アプリケーションの構成要素をあらわす一連のチェックボックスがあり、マイグレーションの進捗にあわせてこれらがチェックされていきます。
プログレスバーのラベルには、マイグレーション・プロセスのうちのどのステージにあるのかがリアルタイムに表示されます。マイグレーション・プロセスには、以下の 3 つのフェーズがあります：

Pre-Processing （前処理中） : プリプロセッシング段階における進捗状況を示します。このフェーズが完了すると、プログレスバーは次のマイグレーション・ステージに備えて再度初期化されます。プリプロセッシング・ステージでは、ユーザ入力をパースしたり、入力元ディレクトリ内のコンテンツを出力先ディレクトリにコピーしたり、必要なデータ構造を準備したりといった作業が行われます。
Migrating （移行中）: 入力元（ソース）の移行フェーズは複数のステージで構成され、各ステージにおいていくつかのカテゴリのファイルが処理されます：
チェックボックスはそれぞれのステージに対応しています。個々のチェックボックスの背景色は、初期状態ではグレイに設定されています。
各ステージの処理が開始すると、そのステージに対応するチェックボックスが黄色くハイライト表示されます。
全ての処理が完了すると、そのステージに対応するチェックボックスがチェック済みとなります（チェックマークが表示されます）。
選択された入力元に所定の種類のファイルが含まれない場合、そのファイルタイプに対応するステージはスキップされ、チェックボックスはグレイのまま残ります。
入力元としてディレクトリやファイルが指定された場合、以後のステージで HTML 形式のマイグレーション・レポートが作成されます。
入力元にディレクトリ、またはファイルを指定した場合、次のステージでは HTML 形式のマイグレーションレポートが作成されます。入力元にアーカイブ（ JAR/WAR/RAR/EAR ファイル）が指定された場合、最終ステージは Building Migrated Output （マイグレート対象物のビルド）が実行されます。このステージにおいて、マイグレーションツールは自動生成されたビルドスクリプトを内部的に実行します。このステージも、やはりチェックボックスで表されています。

注意 - Building Migrated Output （マイグレート対象物のビルド）ステージは入力元にアーカイブを指定した場合のみ可視状態となり、以後、この状態変化を示す自動マイグレーションの画面が示されます。なお、マイグレーションが完了すると、ツールにより JSP バリデータが自動的に起動されます。

JSP バリデータ

自動 JSP バリデータは、タグライブラリに基づき、 JSP ファイル内に登場するタグを検証するためのエンジンです。具体的にいうと、このエンジンは JSP ファイル内にのタグの大文字・小文字表記が TDL ファイル内に定義されているものと異なるかどうかをチェックします。 JSP バリデータはこの検証を一連の JSP ファイルに対して行い、一致しないものが見つかった場合はそのタグを修正します。この機能は配備に関連して移行後に実行されるものなので、現状、JSP バリデータの処理結果はマイグレーション・レポートには含まれません。かわりに JSP バリデータにより独立した XML 形式のレポートが生成され、このこのレポートへのリンクがマイグレーションレポートの目次内に入ります。レポートの名前は、たとえば JSPValidator_TIMESTAMP.xml のように、マイグレーション・レポートと同じ書式でつけられます。なお、デフォルトの設定ではレポートは出力先ディレクトリに書き出されます。また、レポートの構造は以下のようになります：

 
        &lt;validator>
  
       
     &lt;file path="E:\output\iBank\docroot\ShowTransactionHistory.jsp" usesTagLib="true">
        &lt;tld path="/WEB-INF/TMBHisto.tld">
           &lt;tag changed="false">
              &lt;name>printTransactionHistory&lt;/name> 
           &lt;/tag> 
        &lt;/tld> 
     &lt;/file> 
       
     &lt;file path="E:\output\iBank\docroot\TestShowTransactionHistory.jsp" usesTagLib="true">
        &lt;tld path="/WEB-INF/TMBHisto.tld">
           &lt;tag changed="false">
               &lt;name>printTransactionHistory&lt;/name> 
           &lt;/tag> 
        &lt;/tld> 
     &lt;/file> 
       
     &lt;file path="E:\output\iBank\docroot\TransferCheckFailed.jsp" usesTagLib="false"/>
  
       
     &lt;file path="E:\output\iBank\docroot\TransferFunds.jsp" usesTagLib="false"/>
  
  &lt;/validator> 
       

このレポートの表示には Swing で作られたカスタムコンポーネントが利用され、全ての XML のノードを展開したり、折りたたんだりすることが可能となっています。

マイグレーション・プロセスの中断

マイグレーション・プロセスを中断する必要がある場合は、進捗バーの下の "Cancel" ボタンを押下してください。ボタンを押下すると、本当に中断して良いかの確認ダイアログが表示されます。
マイグレーション・プロセスのポップアップには、マイグレーションの終了後にポップアップをどうするのかを指定するチェックボックスがあります。自動的にポップアップを閉じるか、もしくは開いたままにするかをここで選択することができます。

マイグレーション・レポート

マイグレーション・ツールは、実行された全てのマイグレーションについてマイグレーション・レポートを生成します。このレポートには、マイグレートされたアプリケーションの状態に関する説明が含まれます。また、システム管理者が実行する次のステップへの道しるべを示し、マイグレートされたアプリケーションのスムーズな配備を手助けします。レポートを閲覧するには、 "Actions" パネル上の "View Report" ボタンをクリックしてください。レポート内では、マイグレーションプロセスがどのように実施され、なぜそのような結果になったのかが説明されています。レポートは以下のような論理セクションに分割され、成功した全てのマイグレーションプロセスが重要度に応じて並べられます。

The Migration Summary （マイグレーションの要約）
Files That Failed to Migrate （マイグレーションに失敗したファイル）
Files Partially Migrated （部分的にマイグレートされたファイル）
Files Changed and Successfully Migrated （変更後、マイグレーションに成功したファイル）
Files Unchanged and Migrated （変更されずにマイグレートされたファイル）
Build Scripts Generated （生成されたビルドスクリプト）

各セクションのヘッダは、信号と同じカラー体系で塗り分けられます。また、レポートには以下の項目へのリンクも挿入されます：

JSP Validator （ JSP バリデータ）
Logging （ロギング）
マイグレーション後の処理

The Migration Summary （マイグレーションの要約）

マイグレーションのサマリーはマイグレーションプロセスの概要をあらわすもので、マイグレーションプロセスの詳細がテーブル状にまとめられています。以下、このサマリーの内容を示します。

Migration date: 2003-8-6 Time: 4: 31: 43 PM.
Source Application Server: J2EE Reference Implementation 1.4
Destination Application Server: Sun Java System Application Server Platform Edition 8
Input Directory: C:\DOCUME~1\JASPRE~1\LOCALS~1\Temp\asmt_2003_8_6_At_4_31_34_500_PM\Input_Archives
Output Directory: >e:\output\j2eeri1.4\hellodb\Input_Archives
*Input Archive: E:\work\iasmt3\examples\j2ee_ri_1_4\HelloWorld\HelloWorld.ear

*Output Archive Directory: e:\output\j2eeri1.4\hellodb\Input_Archives\build_ear.cmd

Input Component —>	Java	JSP	XML/XMI	HTML
Failed	0	0	0	0
Partially Migrated	0	0	0	0
Successfully Migrated	0	0	4	0
Unchanged	7	1	0	1
Total	7	1	4	1

このフィールドは、入力元が JAR/WAR/RAR/EAR いずれかの形式のアーカイブである場合にのみ表示されます。

Files That Failed to Migrate （マイグレーションに失敗したファイル）

このセクションには、移行に失敗したファイルのリストが処理された順に表示されます。

設定ファイル：以下のような場合に、設定ファイルの移行に失敗することがあります。
- 選択された入力元サーバが設定ファイルに適合しない場合。たとえば、入力元サーバに IBM WebSphere 4.0 にもかかわらず weblogic.properties ファイルが存在するなど。
- 設定ファイルの書式が正しくない場合。たとえば server-cfg.xml に整形 XML ではない内容が含まれるなど。

XML ファイル：以下のような場合、 XML ファイルのマイグレーションに失敗することがあります。
- XML ファイルのマイグレーションに際して、他の XML ファイルや Java ファイルを必要とするにもかかわらず、それらのファイルが入力元のディレクトリ構造内に存在しない。この場合、必要とされるファイルのパスおよび名前が表示されます。
- あるアプリケーションサーバに対して正しく適用可能な XML ファイルが、別のアプリケーションサーバに対してはマイグレーションを失敗させる原因となることがあります。このような場合、マイグレーションツールは問題の XML ファイルの変換に関するエラーメッセージを表示し、改めて入力元アプリケーション・サーバを選択するよう求めてきます。
- 入力元 XML ファイルが well-formed XML （整形式 XML ）ではない場合
- 入力元 XML が valid XML （妥当な XML ）ではない場合；すなわち DTD に適合した形になっていない場合
JSP ファイル：以下のような場合、 JSP ファイルのマイグレーションに失敗する場合があります。
- JSP ファイルのマイグレーションには、いくつかの独立した変更処理が必要となります。マイグレーションツールはこうした変更処理の大半をサポートしていますが、必要とされる全ての変更処理をカバーしているわけではありません。入力元の JSP ファイル内に含まれる変更がサポート対象外のものばかりであった場合、ツールはそのファイルをマイグレートを行わず、サポート対象外の変更点が全てリストアップされます。

　解決策：マイグレーションを実行するには、出力された JSP ファイルを手動で編集してください。

- （入力元として）単一の JSP ファイルが指定される場合、当該ファイルにタグライブラリへの参照が記述されていることがあります。このような場合ツールはタグライブラリ（ .jsp ファイル内で参照されている）に対応した web.xml を見つけることができません。従って、こういった単一の JSP ファイルは正しくマイグレートされません。

Java ファイル：以下のような場合、Java ファイルのマイグレーションに失敗する場合があります：
- Java ファイルのマイグレーションには、いくつかの独立した変更処理が必要となります。マイグレーションツールはこうした変更処理の大半をサポートしていますが、必要とされる全ての変更処理をカバーしているわけではありません。入力元の Java ファイル内に含まれる変更がサポート対象外のものであった場合、ツールはそのファイルをマイグレートを行わず、サポート対象外の変更点が全てリストアップされます。

　解決策：マイグレーションを実行するには、出力された Java ファイルを手動で編集してください。

Files Partially Migrated （部分的にマイグレートされたファイル）

入力元のファイルに要求された変更に対して一部のみ対応可能である場合、マイグレーションは部分的に実行されます（ Partial migration )。マイグレーションツールは、変更に成功した項目、および変更を試みたが失敗に終わった項目を全てリストアップします。

解決策：マイグレーションを完全に実行するには、出力されたファイルを参考にして、マイグレートされなかった項目を手動で編集してください。

設定ファイル：以下のような場合、設定ファイルは部分的にマイグレートされます。
- マイグレーションツールはサポートされるプロパティを変換することができますが、全てがサポートされるわけではありません。

JSP ファイル：以下のような状況において、 JSP ファイルの部分的なマイグレーションが発生する場合があります。
- JSP ファイルのマイグレーションには、いくつかの独立した変更処理が必要となります。マイグレーションツールはこうした変更処理の大半をサポートしていますが、必要とされる全ての変更処理をカバーしているわけではありません。入力元の JSP ファイル内にサポート対象の変更と対象外の変更とが混在する場合、ツールはサポート対象の箇所のみを変更し、サポート対象外の変更全てをリストアップします。

　解決策：マイグレーションを実行するには、出力された JSP ファイルを手動で編集してください。以下に部分的なマイグレーションの例を示します：

入力元アプリケーションサーバとして WebLogic 5.1 が選択され、マイグレーション対象の JSP ファイル内から weblogic.servlet.security および weblogic.db.jdbc の二つのパッケージを参照している場合。 weblogic.db.jdbc はマイグレーションツールのサポート対象、そして weblogic.servlet.security は対象外であるため、この JSP ファイルは 'Files Partially Migrated' のセクションに表示されます。

Java ファイル

　部分的なマイグレーションにおいて、 Java ファイルは JSP ファイルと同様に扱われます。

Files Changed and Successfully Migrated （変更後、マイグレーションに成功したファイル）

これが表示された場合、マイグレーションツールにより全てのファイルが正しく変更され、マイグレーション先のアプリケーションに移行可能な状態になっていると考えることができます。

設定ファイル：入力元ファイル内から次のようなプロパティを含むファイルが検出され、それが対象サーバのフォーマットに正しくマイグレートされた場合は、このセクションに表示されます。
- アプリケーションが使用するデータソース (DataSources)
- StartupClass プロパティ
- ThreadPool settings
- スレッドプール (ThreadPool) の設定

XML ファイル：次のような場合、このセクションにファイルが表示されます：
- 入力元 XML ファイルが、対象アプリケーションサーバの DTD フォーマットに適合するよう変更された場合。

JSP ファイル：次のような場合、このセクションにファイルが表示されます：
- 移行元サーバのパッケージに所属する全ての固有クラスが、対象アプリケーションサーバのクラスおよびパッケージ構造に完全に適合するよう正しく変更された場合。

Java ファイル：次のような場合、このセクションにファイルが表示されます：
- JSP ファイルの場合と同様。

Files Unchanged and Migrated （変更されずにマイグレートされたファイル）

入力元ファイルを対象サーバに適応するにあたって変更すべき箇所がない場合、ファイルはそのまま出力先ディレクトリにコピーされます。

設定ファイル：次のような場合、設定ファイルは変更されることなくマイグレートされます。
- 入力元サーバ固有のプロパティが含まれない場合

XML ファイル：次のような場合、XML ファイルは変更されることなくマイグレートされます。
- 入力元の XML ファイルが対象アプリケーションサーバに適合している場合。

JSP ファイル：次のような場合、JSP ファイルは変更されることなくマイグレートされます。
- 入力元の JSP ファイル内において、移行元アプリケーションサーバ固有のクラスが使用されていない場合

Java ファイル：次のような場合、Java ファイルは変更されることなくマイグレートされます。
- 入力元の Java ファイル内において、移行元アプリケーションサーバ固有のクラスが使用されていない場合

Build Scripts Generated （生成されたビルドスクリプト）

移行可能なファイル類を指定されたディレクトリにマイグレートした後、ツールは全ての Java EE コンポーネントについて、対応する XML ファイルを生成します。この XML ファイルには、所定のアーカイブファイルを生成するための http://jakarta.apache.org/ant への指示が書き込まれています。
この Ant 用の XMLファイルに加え、ツールは更に二つのスクリプトを生成します。一つは Soralis 用の (build_xxx.sh) ファイル、そしてもう一つは Windows 用の (build_xxx.cmd) ファイルです。これらのスクリプトを実行して Ant を起動します。生成されるファイルの詳細を以下に示します：

DD ファイルが ejb-jar.xml の場合
- build_jar.xml
- build_jar.sh
- build_jar.cmd
DD ファイルが web.xml の場合
- build_war.xml
- build_war.sh
- build_war.cmd
DD ファイルが application.xml の場合
- build_ear.xml
- build_ear.sh
- build_ear.cmd

各ビルドファイルに含まれる deploy ターゲットを指定すると（任意）、生成されたアーカイブを配備することができます。たとえば build_ear.cmd deploy コマンドを実行すると EAR ファイルが生成され、生成された EAR ファイルが GlassFish アプリケーション・サーバ上に配備されます。

なお、移行元アプリケーション・サーバが WebLogic 5.1 の場合は、少し事情が異なります。
WebLogic 5.1 は application.xml を使用しないため、マイグレーションツールは application.sasmt というファイルを生成します。この application.sasmt ファイルが、対象アプリケーション・サーバ用の EAR ファイルを生成するために使用されます。
JAR 、 WAR 、および EAR ファイルの名前は、対応する DD ファイル内で指定された display name と同じもにになります。 display name が指定されていない場合は、最初に見つかった ejb-name 、および servlet-name の値が、 JAR ファイルと WAR ファイルの名前にそれぞれ割り当てられます。 DD ファイル内に複数の EJB あるいはサーブレットが存在する場合、ファイル名に "andothers" が付加されます。

application.xml が既に存在する場合、 JAR/WAR ファイルの名前は application.xml ファイル内で指定されているモジュール名となります。
アプリケーションに複数の JAR および WAR ファイルが含まれる場合、マイグレーションツールは build_ear ファイルと同じディレクトリの中に build.properties ファイルを作成します。

DD ファイル内の display-name タグで指定されている名前に対応するモジュールが application.xml ファイル内に見つからない場合、 build_ear (.sh .cmd) などのファイルを実行する前に build.properties を修正する必要があります。

build.properties に対して前述のような修正を行う必要があるのは、application.xml ファイル内で指定されているモジュール名と実際のモジュールファイルが存在するディレクトリとがマッピングされていないためです。

application.xml に JAR あるいは WAR モジュールが一つだけ含まれる場合は、 application.xml 内の JAR/WAR 名と ejb-jar.xml/web.xml ファイルを含むディレクトリとを結びつけるデフォルトの one-to-one マッピングが有効となります

このような場合、 build.properties ファイルは生成されません。
build.properties ファイルには、application.xml で指定された名前を適切なモジュールに割り当てるためのプロパティが含まれます。build.properties ファイルのサンプルを以下に示します。

 
        ################################################################################
# Modules found in application.xml are
# --->customerEjb.jar&lt;---     
# --->inventoryEjb.jar&lt;---     
# --->petstore.war&lt;---     
################################################################################     
################################################################################     
# Deployment Descriptors have been found in the following directories,    
# please enter a module name from the application.xml that should be given     
# to the module generated from the files inside these directories.     
################################################################################     

# ejb-jar.xml was found in the directory /temp/components/ejb1/src, enter the module name after "=" temp_components_ejb1_src=     

# ejb-jar.xml was found in the directory /temp/components/ejb2/src, enter the module name after "=" temp_components_ejb2_src= 

# web.xml was found in the directory /temp/web/src, the module name     
# has been assigned by the tool from application.xml     

temp_web_src_war=petstore.war 
       

各々のプロパティに適切なモジュール名を割り当て、以下のコマンドでビルドを実行して下さい。
Soralis 用： % sh build_ear.sh -Dp=y
Windows用 : PROMPT> build_ear -Dp=y

プロパティに対して適切なモジュール名が割り当てられなかった場合、生成された EAR ファイルを配備することはできません。

weblogic.properties 、 config.xml 、あるいは server-cfg.xml ファイルが存在する場合は以下のファイル類が生成されます：
- buildconfig.xml
- buildconfig.sh (for Solaris)
- buildconfig.cmd (for Windows)
  　このビルドスクリプトは DataSource を登録し、アプリケーション・サーバに StartupClass を再配備します。

config.xml ファイル内に JMS 設定に関する要素が含まれる場合、以下のファイル類が生成されます：
- buildjms.xml
- buildjms.sh (for Solaris)
- buildjms.cmd (for Windows)
  　このビルドスクリプトは config.xml で定義されている Destination JMS リソースを登録します。

config.xml に含まれる個々の Connection ファクトリに対し、それぞれ二つの xml ファイルが生成されます。たとえば Connection ファクトリの名前が testConn である場合、ビルドスクリプトは以下のようなファイルを生成します：
Queue Connection ファクトリ登録用：

buildjmstestConnqf.xml
buildjmstestConnqf.sh (for Solaris)
buildjmstestConnqf.cmd (for Windows)

Topic Connection ファクトリ登録用：

buildjmstestConntf.xml
buildjmstestConntf.sh (for Solaris)
buildjmstestConntf.cmd (for Windows)

注意 -

要求に応じて、これらのスクリプトのうち一つだけを実行するようにしてください。
以下のコマンドで、リソース類をアプリケーション・サーバに登録するための設定ビルドファイルを
実行することができます：

Soralis の場合： % sh filename -Du=<username> -DH=<hostname> -Dp=<portno> -Di=<instancename> -Dw=<passwordfile>
Windowsの場合： PROMPT> filename -Du=<username> -DH=<hostname> -Dp=<portno> -Di=<instancename> -Dw=<passwordfile>

ツールバーを使用する

マイグレーションツールには、よく使う三つの機能を起動するためのアイコンをのせたツールバーが搭載されています。

新規マイグレーションプロジェクトを開くには、 "New" アイコンを押してください。既にマイグレーションプロジェクトが開かれている場合は、先に開いているプロジェクトのファイルを保存するよう促されます。新しいプロジェクトを開くと、全てのマイグレーション・アクションが起動されます。
以前に保存したプロジェクトファイルを開くには、 "Open" アイコンを押下します。にマイグレーションプロジェクトが開かれている場合は、先に開いているプロジェクトのファイルを保存するよう促されます。ファイルが保存されるとダイアログボックスが表示されますので、開きたいプロジェクトのファイルを選択してください。
フィールドに入力した値をプロジェクトファイルに保存するには、 "Save" アイコンを押下します。ファイルは .prj という拡張子をつけて保存されます。

メニューバーを使用する

メニューバーには以下に示すようなメニュー項目があります。

Project （プロジェクト）
Edit （編集）
Help （ヘルプ）

Project （プロジェクト）メニュー

プロジェクトメニューからは以下のような機能にアクセスできます：

新規移行プロジェクトを開くには "New" を選択します。既に移行プロジェクトが開いている場合には、開いているプロジェクトを保存するか聞かれます。
既存のプロジェクトファイルを開くには、"Open" を選択します。既に移行プロジェクトが開いている場合には、開いているプロジェクトを保存するか聞かれ、続いて、新たに開くプロジェクトを選択するよう、ダイアログボックスが表示されます。
入力フィールドをプロジェクトファイル (.prj 拡張子のファイル) に保存するには、"Save" を選択します。
プロジェクトファイルを別名もしくはオリジナルと違う場所に保存するには、"Save As" を選択します。
マイグレーションツールを閉じるには、"Exit" を選択します。

Edit （編集）メニュー

設定を変更するには、編集メニューを利用します。"Preferences" サブメニューを選択すると、設定ダイアログが表示されます。設定ダイアログには 2 つの設定画面があります: "Logging（ログ）" と "Miscellaneous（その他）" です。

"Logging" 画面では、どの情報をログに記録させるかを選択します:
"Tool Migration Log" には、ユーザにとって興味のある、移行に関係する情報が含まれます。
"Tool Debugging Log" には、移行処理時に生成されたデバッグ情報が含まれます。この情報は、開発者の視点から移行の流れを追跡する上で有用です。この 2 種類のログについてさらに知りたい場合は、マイグレーションツールで可能なことページ、「ログ」の節を参照下さい。
"Logging Type" セクションでは次の設定をします:
- 生成するログは、2 つのどちらか、もしくは両方か。
- 新しいログ情報を、既存のログファイルに追加していくか、もしくは、既存のログを新しいログ情報で上書きするか。Overwrite（上書き）モードでは、両方のログを生成すべきです。変更された設定はツールを再起動した際有効になります。
"Miscellaneous" 画面では、次回ツールを起動した際にマイグレーションツールのスプラッシュスクリーンを表示させるか否かを指定します。

Help （ヘルプ）メニュー

ヘルプメニューからは以下のような機能にアクセスできます：

サブメニューの "User Guide" を選択すると、マイグレーションツールの様々な機能に関するオンラインヘルプを表示できます。
"About Migration Tool" を選択すると、マイグレーションツールのバージョンおよび著作権情報が表示されます。

前へ次へ

日本語翻訳: Kana. Kotake

英文 (翻訳したバージョン: 8)

アプリケーションのマイグレーション

入力元 Java EE アプリケーション詳細の設定

移行元サーバの指定

アプリケーションのディレクトリ、またはアーカイブの指定

入力元に単一のアーカイブを指定する

入力元として単一のディレクトリを指定する

検証の実施

出力先 Java EE アプリケーションの詳細設定

出力先ディレクトリの指定

ターゲットサーバの指定

高度なマイグレーション・オプションの指定

検証の実施

マイグレーションの実行

自動マイグレーションプロセス

JSP バリデータ

マイグレーション・プロセスの中断

マイグレーション・レポート

The Migration Summary （マイグレーションの要約）

Files That Failed to Migrate （マイグレーションに失敗したファイル）

Files Partially Migrated （部分的にマイグレートされたファイル）

Files Changed and Successfully Migrated （変更後、マイグレーションに成功したファイル）

Files Unchanged and Migrated （変更されずにマイグレートされたファイル）

Build Scripts Generated （生成されたビルドスクリプト）

ツールバーを使用する

メニューバーを使用する

Project （プロジェクト）メニュー

Edit （編集） メニュー

Help （ヘルプ）メニュー

Edit （編集）メニュー