Oracle® Fusion Middleware

SmartUpgradeユーザーズ・ガイド

11g リリース2(11.1.2.1.0)

B61426-02(原本部品番号:E15878-03)

2011年9月

Oracle Fusion Middleware SmartUpgradeユーザーズ・ガイド, 11g リリース2(11.1.2.1.0)

B61426-02

Copyright © 2011, Oracle and/or its affiliates.All rights reserved.

原本著者: Shynitha K S

原本協力者: Brian Lininger、Cecilia Broadaway、Clyde Iwamoto、Frances Zhao、Gavin Steyn、Jason Minton、John Bracken、Lixin Zheng、Michael Rubino、Nilesh Junnarkar、Olga Peschansky、Pascal Filion、Peter LaQuerre、Reza Shafii、Robert St. Jean、Roger Striffler、Sitaraman Swaminathan、Showvik Roy Chowdhuri、Velmurugan Subramanian、Wendy Puckett

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、Oracleまでご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 Oracle WebLogic Server SmartUpgraderの紹介

- 1.1 Oracle WebLogic Server SmartUpgradeとは

- 1.2 Oracle Fusion Middlewareアップグレードの一環としてのSmartUpgradeの使用

- 1.3 SmartUpgradeレポートについて

- 1.4 SmartUpgradeアーティファクト生成について

- 1.4.1 デプロイメント記述子の生成

- 1.4.2 Webサービス・アーティファクトの生成

- 1.4.3 EJBアーティファクトの生成

- 1.5 SmartUpgrade Oracle JDeveloper統合およびコマンドライン・インタフェース

- 1.6 SmartUpgradeのダウンロードとインストール

- 1.6.1 SmartUpgrade ZIPファイルの取得

- 1.6.2 Oracle JDeveloper SmartUpgrade拡張機能のインストール

- 1.6.3 SmartUpgradeコマンドライン・インタフェースのインストール

- 1.6.4 最新ドキュメントの取得

2 Oracle JDeveloperでのSmartUpgradeの使用

- 2.1 Oracle JDeveloperのインストールと構成

- 2.2 Oracle JDeveloper SmartUpgrade拡張機能のインストールの検証

- 2.3 Java EEアップグレード・ウィザードの起動と使用

- 2.3.1 Java EEアップグレード・ウィザードの起動

- 2.3.1.1 Java EEアップグレード・アプリケーション・ウィザードの使用

- 2.3.1.2 Java EEアップグレード・プロジェクト・ウィザードの使用

- 2.3.2 Java EEアップグレード・ウィザードの使用

- 2.3.2.1 Java EEアップグレード・ウィザード・ページの概要

- 2.3.2.2 SmartUpgrade Oracle JDeveloper拡張機能でサポートされるアーカイブとプロジェクトのタイプ

- 2.3.2.3 特定のSmartUpgradeルール・カテゴリへの分析の制限

- 2.3.2.4 Oracle Application Server 10g リリース2(10.1.2)にデプロイされたアプリケーションの分析

- 2.3.3 必須入力ページのプロパティの設定

- 2.3.3.1 Webサービスの各アーティファクト生成オプションの習得

- 2.3.3.2 パフォーマンス分析用計測コードの生成

- 2.3.4 アーティファクト生成時のアップグレードの続行

- 2.4 SmartUpgradeレポートの使用

- 2.4.1 SmartUpgradeレポートの表示

- 2.4.2 各結果で入手可能な情報

- 2.4.3 アップグレード結果ツールバーを使用したSmartUpgrade結果のフィルタ処理

- 2.4.4 構造ウィンドウを使用したSmartUpgrade結果のソートとフィルタ処理

- 2.4.5 結果ステータスを使用した作業の追跡

3 SmartUpgradeコマンドラインの使用

- 3.1 SmartUpgrade Javaコマンドラインの使用

- 3.1.1 前提条件の確認とsmartupgrade.jarファイルの検索

- 3.1.2 SmartUpgradeコマンドライン・インタフェースの基本構文

- 3.1.3 SmartUpgrade実行時のオプションによるJavaヒープ・サイズの増加

- 3.1.4 SmartUpgradeコマンドライン・オプションのヘルプの取得

- 3.1.5 SmartUpgradeコマンドライン・オプションの概要

- 3.1.5.1 SmartUpgradeコマンドライン・インタフェース・オプションのリスト

- 3.1.5.2 SmartUpgradeロケータの特定

- 3.1.5.3 SmartUpgradeコマンドラインでの複数のロケータの指定

- 3.1.5.4 オプションのSmartUpgradeコマンドライン・オプションの概要

- 3.1.6 アーティファクト生成に固有のSmartUpgradeコマンドライン・オプションの概要

- 3.1.7 SmartUpgradeコマンドライン・インタフェースの使用例

- 3.1.7.1 Oracle WebLogic Serverホーム・ディレクトリの特定

- 3.1.7.2 SmartUpgradeコマンドライン・インタフェースを使用したエンタープライズ・アーカイブ(EAR)・ファイルの分析

- 3.1.7.3 SmartUpgradeコマンドライン・インタフェースを使用したOracle WebLogic Serverアーティファクトの生成

- 3.1.7.4 SmartUpgradeコマンドライン・インタフェースを使用したHTMLレポートの生成

- 3.1.7.5 SmartUpgradeコマンドライン・インタフェースの特定のルール・カテゴリへの結果の制限

- 3.1.7.6 SmartUpgradeコマンドライン・インタフェースを使用した10g リリース2(10.1.2)アプリケーションの分析

- 3.1.8 SmartUpgrade結果情報とエラー・レポートの出力の制御

- 3.2 SmartUpgradeとApache Antの統合

4 SmartUpgrade生成アーティファクトの使用

- 4.1 SmartUpgrade生成アーティファクトの使用に必要な手順の概要

- 4.2 SmartUpgradeで生成されるWebサービス・アーティファクトに関するその他の情報

- 4.2.1 OC4J WebサービスとOracle WebLogic Server Webサービスの相違

- 4.2.2 SmartUpgrade Webサービス・アーティファクト生成の機能

- 4.2.3 SmartUpgradeで生成されるWebサービスglueコードによるパフォーマンスの影響の分析

A SmartUpgradeで生成される出力ディレクトリ

はじめに

内容は次のとおりです。

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

対象読者

このマニュアルは、以前にOracle Containers for Java EEアプリケーションにデプロイしたアプリケーションをアップグレードし、Oracle WebLogic ServerおよびOracle Fusion Middleware 11gにアプリケーションを再デプロイするJava EEアプリケーション開発者を対象としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportから電子サポートにアクセスできます。詳細については、http://www.oracle.com/support/contact.htmlにアクセスしてください。障害のあるお客様は、http://www.oracle.com/accessibility/support.htmlにアクセスしてください。

関連ドキュメント

詳細は、Oracle Fusion Middleware 11gドキュメント・ライブラリで入手可能な次の関連ドキュメントを参照してください。

- アップグレード関連ドキュメント

- 『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』

- 『Oracle Fusion Middleware Java EEアップグレード・ガイド』

- 『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』

- 『Oracle Fusion Middleware管理者ガイド』

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

斜体

イタリックは、ユーザーが特定の値を指定するプレースホルダー変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 Oracle WebLogic Server SmartUpgradeの紹介

この章では、Oracle WebLogic Server SmartUpgradeソフトウェアを紹介します。内容は次のとおりです。

- WebLogic Server SmartUpgradeとは

- Oracle Fusion Middlewareアップグレードの一環としてのSmartUpgradeの使用

- SmartUpgradeレポートについて

- SmartUpgradeアーティファクト生成について

- SmartUpgrade Oracle JDeveloper統合およびコマンドライン・インタフェース

- SmartUpgradeのダウンロードとインストール

1.1 Oracle WebLogic Server SmartUpgradeとは

Oracle WebLogic Server SmartUpgradeは、Oracle JDeveloperの拡張機能であり、OC4Jに以前にデプロイしたアプリケーションを分析するコマンドライン・ユーティリティです。これは、Oracle WebLogic Serverにアプリケーションを正常に再デプロイするのに役立つアドバイスを提供し、アクションを実行します。

アプリケーション・アーカイブを分析したり、Oracle JDeveloperで開いたアプリケーションやプロジェクトを分析できます。さらに、SmartUpgradeは、アプリケーションをデプロイしたOC4Jサーバーを分析し、Oracle WebLogic Serverに同様の構成を設定する方法に関するアドバイスを提供できます。

SmartUpgradeは、各アプリケーションに関する固有の結果を含む包括的なレポートを提供する他に、一部のアップグレード・タスクを自動化します。たとえば、特定のタイプのアプリケーション・アーティファクトを生成し、そのアーティファクトをエンタープライズ・アーカイブとして自動的にパッケージ化します。このアーカイブを起点としてOracle WebLogic Serverにアプリケーションをデプロイできます。

1.2 Oracle Fusion Middlewareアップグレードの一環としてのSmartUpgradeの使用

Oracle WebLogic Server SmartUpgradeは、Oracle Application ServerまたはOracle WebLogic Serverの環境全体をOracle Fusion Middleware 11gにアップグレードする場合に役立つOracleソフトウェア・ツールの1つです。

そのため、環境のアップグレード手段の一環としてSmartUpgradeを使用できます。SmartUpgradeを、アップグレード関連のその他のOracle Fusion Middlewareドキュメント・リソースと併用することをお薦めします。

詳細は、次のドキュメントを参照してください。

- アプリケーション・サーバーのすべてのコンポーネントとミドルウェア環境のアップグレードについては、『Oracle Fusion Middlewareアップグレード・プランニング・ガイド』を参照してください。

- Java EEアプリケーションおよびOracle Application Server 10g環境のOracle WebLogic Serverへのアップグレードについては、『Oracle Fusion Middleware Java EEアップグレード・ガイド』を参照してください。

1.3 SmartUpgradeレポートについて

SmartUpgradeが、選択されたエンタープライズ・アーカイブまたはOracle JDeveloperのアプリケーションやプロジェクトを分析すると、アプリケーション・アップグレード・レポートが生成されます。Oracle WebLogic Serverにアプリケーションをデプロイする前に、レポートを参照して潜在的な問題を特定できます。各問題は「結果」と呼ばれます。

それぞれの結果には、優先度や複雑性のレベルなどの各種属性が割り当てられます。優先度と複雑性の属性は、アプリケーションの変更やOracle WebLogic Serverへのアプリケーションの再デプロイに必要な作業の計画作成に役立ちます。

詳細は、2.4項「SmartUpgradeレポートの使用」を参照してください。

1.4 SmartUpgradeアーティファクト生成について

SmartUpgradeは、アップグレード・レポートの他に、Oracle WebLogic Serverデプロイメント記述子、データ・ソース構成、Webサービス、EJBアーティファクトなどの特定のタイプのアプリケーション・アーティファクトをオプションで生成できます。

レポートの結果を確認してこうしたアーティファクト自体を作成するのではなく、SmartUpgradeを使用してアーティファクトを生成できます。この場合、Oracle WebLogic Serverのアプリケーションのアップグレードに費やす時間や労力を節約できます。

詳細については、以下の節を参照してください。

- デプロイメント記述子の生成

- Webサービス・アーティファクトの生成

- EJBアーティファクトの生成

1.4.1 デプロイメント記述子の生成

通常のJava EEアプリケーションのアーティファクトを生成するようにSmartUpgradeを構成する場合、SmartUpgradeはアプリケーション内のOC4Jデプロイメント記述子を分析します。 OC4Jに固有のデプロイメント記述子内の特定の要素については、Oracle WebLogic Serverにアプリケーションをデプロイするために使用可能な同等のデプロイメント記述子要素を含むサンプル・ファイルを生成します。

生成されたデプロイメント記述子を起点として、アップグレードされるアプリケーションに必要なOracle WebLogic Serverデプロイメント記述子を作成できます。

アップグレード・ドキュメントと、アップグレード・レポート結果で入手可能なアドバイスの確認に加えて、Oracle WebLogic Server Webアプリケーション ・デプロイメント記述子要素を生成するようにSmartUpgradeを構成することもできます。

特に、アーティファクトを生成するようにSmartUpgradeを構成し、ソフトウェアがアプリケーション内でorion-web.xmlファイルを識別する場合、SmartUpgradeは、対応するOracle WebLogic Serverデプロイメント記述子要素をサンプルweblogic.xmlファイルに自動で生成します。

- virtual-directory

- resource-eve-ref-mapping

- ejb-ref-mapping

- default-char-set

- jsp-print-nulls

- default-mime-type

- directory-browsing

- persistence-path

- session-tracking

- expiration-setting

アプリケーションでsession-tracking要素とexpiration-setting要素を使用する場合、SmartUpgradeで生成されるアーカイブ・ファイルに自動的に含まれるラッパーJavaクラスが生成されます。

詳細は、第4章「SmartUpgrade生成アーティファクトの使用」および付録A「SmartUpgradeで生成される出力ディレクトリ」を参照してください。

1.4.2 Webサービス・アーティファクトの生成

SmartUpgradeでは、Oracle WebLogic ServerにWebサービスをすばやく効率的にアップグレードしてデプロイすることができる一方で、既存のURLを維持しながら環境内のリモート・アプリケーションと相互運用します。

Webサービス・アプリケーションのアーティファクトを生成するようにSmartUpgradeを構成する場合、SmartUpgradeはOC4J Webサービスを分析し、3つの個別タスクを自動的に実行します。

1. Oracle Weblogic Serverサービス生成ツールを使用して、アプリケーションのWSDLごとにサービス・スケルトン・アーティファクトを生成します。
スケルトンには次のようなものがあります。

- 値のタイプまたはデータ転送オブジェクトの新しいセット

- 新しいサービス・エンドポイント・インタフェース(SEI)およびスケルトンWebサービス

- Oracle WebLogic Serverデプロイメント記述子

2. スケルトンWebサービスの実装を提供します。この実装は「glueコード」と呼ばれ、Oracle WebLogic Serverでサポートされる必須のアノテーションで生成されます。

3. 生成されたスケルトンWebサービスの「glueコード」は、リクエストを元のWebサービス実装クラス(アップグレードされるOC4Jアプリケーションの一部)にディスパッチします。このタスクを実行するには、新しい値のタイプを元の値のタイプに変換します。

SmartUpgradeでは、元のOC4J Webサービスの既存のクライアントはアップグレードによる影響を受けません。元のWSDL契約が保存され、既存のクライアントは、Oracle WebLogic Serverに生成された新しいWebサービスと引き続き相互運用できます。

生成されたWebサービスのglueコードには、必須のアノテーションが含まれることに注意してください。

SmartUpgradeは、次のWebサービスの機能のアップグレードをサポートします。

- ステートレス・サービスとステートフル・サービス

- EJB 2.0 WebサービスとEJB 3.0 Webサービス

- RPCリテラルとDocリテラルのWebサービス

- WebサービスJAX-RPCクライアント(OC4J WSAユーティリティで生成されるスタブベース・クライアント)

- JAX-RPCハンドラで実装されるSOAP添付ファイル

- SOAPメッセージ転送最適化メカニズム(MTOM)

- WSセキュリティ

注意:

OC4Jは、クライアントjavaとロード・サービスの両方をサポートします。Oracle WebLogic Serverではクライアントjavaのみをサポートします。ロード・サービスをOracle WebLogic Serverでコールしようとすると、次のエラー・メッセージが表示されます。
java.lang.Error: JAX-RPC 1.1メソッドは、WLS 8.1クライアントではサポートされません。OC4J 10.1.3 JAX-RPCクライアントをWLSで実行する場合、詳細はWebサービス移行ガイドを参照してください。

at weblogic.webservice.core.rpc.ServiceFactoryImpl.loadService(ServiceFactoryImpl.java:65)

loadServiceなどのJAX-RPC APIを使用している場合、次の例に示すようにコードを変更してwsa.jar生成のクライアント・クラスを使用する必要があります。

変更前

DocLitLogger service = (DocLitLogger) m_factory.loadService ( new URL(m_serviceURL),DocLitLogger.class, null);

LoggingFacilityLogPortType port = service.getDocLitLoggerPort();

変更後

DocLitLoggerPortClient client = new DocLitLoggerPortClient();

LoggingFacilityLogPortType port = client.getPort();

詳細は、第4章「SmartUpgrade生成アーティファクトの使用」を参照してください。

1.4.3 EJBアーティファクトの生成

アプリケーションにEnterprise Java Beans (EJB)が含まれる場合、SmartUpgradeはアプリケーションを分析し、Oracle WebLogic Serverにデプロイできる同等のアーティファクトを生成しようとします。

具体的には、OC4J Native CMPアプリケーションとその他のEJBタイプのEJBアーティファクトを生成しますが、次の例外があります。

- 自動生成主キーは部分的にサポートされます。SmartUpgradeでは、移行の一環としてデフォルトでOracleの順序に設定しますが、必要に応じて自動生成キーを手動で構成することをお薦めします。

- TopLink CMPアプリケーションのEJBアーティファクトの生成はサポートされません。TopLink BMPまたはWeblogic CMPをお薦めしますが、これらの要素のアップグレードは、ユーザーが手動で行う必要があります。

- 一部のEJB機能はプラットフォーム間で転送できません。特定のアプリケーションに関してアップグレードされない機能の詳細は、SmartUpgradeアップグレード・レポートを参照してください。

- OC4J NativeメッセージドリブンBean (MDB)のアップグレードのみがサポートされます。

1.5 SmartUpgrade Oracle JDeveloper統合およびコマンドライン・インタフェース

SmartUpgradeは、Oracle JDeveloperの「更新のチェック」機能を使用してインストールできるOracle JDeveloper拡張機能として利用できます。また、コマンドライン・ツールとしても利用できます。

詳細は、次のリソースを参照してください。

- Oracle JDeveloper拡張機能の使用については、第2章「Oracle JDeveloperでのSmartUpgradeの使用」を参照してください。

- コマンドライン・インタフェースの使用については、第3章「SmartUpgradeコマンドラインの使用」を参照してください。

1.6 SmartUpgradeのダウンロードとインストール

SmartUpgradeのダウンロードとインストールの詳細は、次の項を参照してください。

- SmartUpgrade ZIPファイルの取得

- Oracle JDeveloper SmartUpgrade拡張機能のインストール

- SmartUpgradeコマンドライン・インタフェースのインストール

- 最新ドキュメントの取得

1.6.1 SmartUpgrade ZIPファイルの取得

次のいずれかの方法でSmartUpgradeを取得できます。

- Oracle Fusion Middleware CD-ROMパックに含まれるOracle Fusion Middleware Companion CD-ROM

- Oracle Technology Network (OTN)

たとえば、OTNからSmartUpgrade ZIPファイルをダウンロードして解凍するには、次の操作を行います。

1. Webブラウザを使用して、OTNの次のURLに移動します。

http://www.oracle.com/technology/products/middleware/upgrade/index.html

OTNに初めてアクセスする場合、登録が必要です。登録は無料で、OTNのすべてのリソースにアクセスできます。

2. Oracle WebLogic Server SmartUpgradeをダウンロードするリンクをクリックします。
このドキュメントの公開時、SmartUpgradeダウンロード・リンクは、ページの右側の無料ダウンロード・イメージの下にありました。

3. 画面の手順に従って、必要なSmartUpgradeファイルがすべて含まれるZIPファイルをダウンロードします。

4. ローカル・ディスクの一時ディレクトリにZIPファイルを解凍します。
表1-1は、ZIPファイルの内容の説明です。

表1-1 SmartUpgrade ZIPファイルの内容

ファイル

説明

readme.txt

ZIPファイル内のファイルを説明するテキスト・ファイル。

smartupgrade.zip

SmartUpgradeコマンドライン・インタフェースの使用に必要なファイルが含まれるZIPファイル。

releasenotes.txt

該当のSmartUpgradeダウンロードに関する最新情報をが記述されたテキスト・ファイル。

jdeveloper_smartupgrade.zip

SmartUpgrade Oracle JDeveloper拡張機能のインストールに必要なファイルが含まれるZIPファイル。

1.6.2 Oracle JDeveloper SmartUpgrade拡張機能のインストール

ダウンロード可能なZIPファイルの内容からOracle JDeveloper SmartUpgrade拡張機能をインストールするには、次の操作を行います。

1. 現在Oracle JDeveloper 11gが実行していることを確認します。
必要に応じて、OTNの次の場所からOracle JDeveloper 11gをダウンロードしてインストールします。

http://www.oracle.com/technology/products/jdev/index.html

Oracle JDeveloperのインストール手順については、『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』を参照してください。

2. Oracle JDeveloperを起動します。

3. 「ヘルプ」メニューから「更新のチェック」を選択します。

4. 更新のチェック・ウィザードの「ようこそ」ページで「次へ」をクリックします。

5. 「ソース」ページで「ローカル・ファイルからインストール」を選択します。

6. 「参照」をクリックし、1.6.1項「SmartUpgrade ZIPファイルの取得」で取得および解凍したjdeveloper_smartupgrade.zipファイルを見つけて選択します。

7. 「終了」をクリックしてSmartUpgrade拡張機能をインストールします。

8. Oracle JDeveloperを再起動します。
Oracle JDeveloperを再起動したら、第2章「Oracle JDeveloperでのSmartUpgradeの使用」を参照してください。

注意:

Oracle JDeveloperの今後の更新を入手するには、更新のチェック・ウィザードの「更新センターの検索」のオプションが利用可能な場合はそのいずれかを選択します。

1.6.3 SmartUpgradeコマンドライン・インタフェースのインストール

SmartUpgrade Oracle JDeveloper拡張機能をインストールすると、コマンドライン・インタフェースの実行に必要なファイルが自動的にインストールされます。

コマンドライン・インタフェースがインストールされたことを確認するには、SmartUpgrade拡張機能のインストール後に次のディレクトリでsmartupgrade.jarファイルを見つけます。

MW_HOME\jdeveloper\jdev\extensions\oracle.jdeveloper.smartupgrade.weblogic\

Oracle JDeveloper拡張機能をインストールせず、SmartUpgradeコマンドライン・インタフェースのみをインストールする場合、ダウンロード可能なZIPファイルや、Oracle Fusion Middleware 11g リリース1(11.1.1.2.0)のCompanion CD-ROMで入手可能なSmartUpgradeファイルからインストールできます。

Oracle JDeveloperを使用せずにSmartUpgradeコマンドライン・インタフェースをインストールして構成するには、次の操作を行います。

1. 次のいずれかの前提条件をインストールして構成していることを確認します。

- Java 2 Standard Editionまたは Enterprise Editionバージョン1.6以上
詳細は、次のWebサイトでJava 1.6 Software Development Kit (SDK)またはJava Runtime (JRE)のダウンロードに関する情報を参照してください。

http://www.oracle.com/technetwork/java/index.html

- Apache ANTバージョン1.7以上
Apache Ant 1.7 は、Oracle WebLogic Server 11gインストールの一部としてインストールされます。また、次のURLからダウンロードすることも可能です。

http://ant.apache.org/

2. プログラムを実行する永続ディレクトリにsmartupgrade.zipファイルを解凍します。
Oracleにはsmartupgrade.zipファイルが含まれます。このファイルは、Oracle Technology Network (OTN)のSmartUpgradeダウンロードに含まれ、Oracle Fusion Middleware 11g リリース1(11.1.1.2.0) Companion CD-ROMにもあります。

3. 次のファイルがディレクトリに解凍されていることを確認します。

- smartupgrade.jar

- Manifest.mf

- readme.txt

4. コマンドライン・インタフェースの使用を開始するには、第3章「SmartUpgradeコマンドラインの使用」を参照してください。

1.6.4 最新ドキュメントの取得

チュートリアル、データ・シート、このガイドの最新バージョンなどのSmartUpgradeに関する最新情報については、 Oracle Technology Network (OTN)のOracle Fusion Middlewareアップグレード・ページを参照してください。

http://www.oracle.com/technetwork/middleware/upgrade-092995.html

2 Oracle JDeveloperでのSmartUpgradeの使用

この章では、Oracle JDeveloper内でのSmartUpgradeの使用方法について説明します。詳細は、次の項を参照してください。

- Oracle JDeveloperのインストールと構成

- Oracle JDeveloper SmartUpgrade拡張機能のインストールの検証

- Java EEアップグレード・ウィザードの起動と使用

- SmartUpgradeレポートの使用

2.1 Oracle JDeveloperのインストールと構成

Oracle JDeveloperでSmartUpgradeを使用するには、Oracle JDeveloper 11g リリース2(11.1.2.1.0)以上をインストールする必要があります。

Oracle JDeveloper 11gをインストールする場合、Oracle JDeveloperインストール・パッケージに含まれるOracle WebLogic Serverソフトウェアもインストールする必要があります。SmartUpgradeでは、Oracle JDeveloperと一緒にインストールするOracle WebLogic Serverソフトウェアの必要なライブラリとその他のソフトウェアを自動的に使用します。

2.2 Oracle JDeveloper SmartUpgrade拡張機能のインストールの検証

はじめに、Oracle JDeveloper SmartUpgrade拡張機能がインストールされて構成されていることを確認します。

1. Oracle JDeveloperを起動します。

2. 「ファイル」→「新規」を選択します。

3. 「新規ギャラリ」の「カテゴリ」ツリーで、「一般」→「アプリケーション」を選択します。

4. 図2-1に示すように、「項目」リストで、項目のリストにJava EEアップグレード・アプリケーション・オプションが表示されていることを確認します。
このオプションがリストに表示されない場合、1.6項「SmartUpgradeのダウンロードとインストール」を参照してください。

図2-1 「新規ギャラリ」ダイアログのJava EEアップグレード・アプリケーション項目

2.3 Java EEアップグレード・ウィザードの起動と使用

SmartUpgradeレポートを生成したり、アプリケーションのアップグレードに役立つアーティファクトをオプションで生成したりするには、Java EEアップグレード・ウィザードを使用します。

詳細は、次の項を参照してください。

- Java EEアップグレード・ウィザードの起動

- Java EEアップグレード・ウィザードの使用

- 必須入力ページのプロパティの設定

- アーティファクト生成時のアップグレードの続行

2.3.1 Java EEアップグレード・ウィザードの起動

Java EEアップグレード・ウィザードを起動するには2つの方法があります。このウィザードでは、SmartUpgradeによるアプリケーションの分析プロセスのガイドが行われます。

次の項でこの2つの方法について説明します。

- Java EEアップグレード・アプリケーション・ウィザードの使用

- Java EEアップグレード・プロジェクト・ウィザードの使用

2.3.1.1 Java EEアップグレード・アプリケーション・ウィザードの使用

Java EEアップグレード・ウィザードを起動して、結果を新しいOracle JDeveloperアプリケーションに保存するには、次の操作を行います。

1. 「ファイル」→「新規」を選択して「新規ギャラリ」を表示します。

2. 「カテゴリ」ツリーで、「一般」→「アプリケーション」を選択します。

3. 「項目」リストで、Java EEアップグレード・アプリケーションをダブルクリックします(図2-1)。

2.3.1.2 Java EEアップグレード・プロジェクト・ウィザードの使用

Java EEアップグレード・ウィザードを起動して、既存のOracle JDeveloperアプリケーション内の新しいプロジェクトに結果を保存するには、次の操作を行います。

1. 「ファイル」→「新規」を選択して「新規ギャラリ」を表示します。
既存のプロジェクトを右クリックして、コンテキスト・メニューから「新規」を選択することもできます。

2. 「カテゴリ」ツリーで、「一般」→「プロジェクト」を選択します。

3. 「項目」リストで、Java EEアップグレード・プロジェクトをダブルクリックします(図2-2)。

図2-2 「新規ギャラリ」ダイアログのJava EEアップグレード・プロジェクト項目

2.3.2 Java EEアップグレード・ウィザードの使用

Java EEアップグレード・ウィザードの使用については、次の項を参照してください。

- Java EEアップグレード・ウィザード・ページの概要

- SmartUpgrade Oracle JDeveloper拡張機能でサポートされるアーカイブとプロジェクトのタイプ

- 特定のSmartUpgradeルール・カテゴリへの分析の制限

- Oracle Application Server 10g リリース2(10.1.2)にデプロイされたアプリケーションの分析

2.3.2.1 Java EEアップグレード・ウィザード・ページの概要

表2-1は、Java EEアップグレード・ウィザードのページの説明です。表示されるページは、ウィザードの起動方法や、生成するレポートのタイプによって異なる点に注意してください。

表2-1 Java EEアップグレード・アプリケーション・ウィザード・ページの概要

ページ名

説明

追加情報

アプリケーション名

Java EEアップグレード・アプリケーション・ウィザードを使用する場合にのみ表示されます。

OC4Jアプリケーションの分析後にSmartUpgradeで作成される新しいOracle JDeveloperアプリケーションの名前を入力します。

生成されるアップグレード・レポートは、アプリケーション内部のプロジェクトに保存されます。

[F1]を押すか、ウィザード・ページで「ヘルプ」をクリックします。

プロジェクト名

選択したアプリケーションまたはプロジェクトの分析後にSmartUpgradeで作成されるデフォルト・プロジェクトの名前を入力します。

生成されるアップグレード・レポートは、該当プロジェクトに保存されます。

[F1]を押すか、ウィザード・ページで「ヘルプ」をクリックします。

アップグレード・レポート・タイプ(図2-3)

作成するアップグレード・レポートのタイプを選択します。

新しいアプリケーションを作成する場合、既存のアプリケーションを分析するオプションはページ上に表示されません。

1つ以上の既存のOracle JDeveloperプロジェクトを分析するには、Java EEアップグレード・プロジェクト・ウィザードを使用する必要があります。

[F1]を押すか、ウィザード・ページで「ヘルプ」をクリックします。

OC4Jアーティファクト(図2-4)

このページの内容は、前のページで選択したアップグレード・レポート・タイプによって異なります。

分析するエンタープライズ・アーカイブ、Oracle JDeveloperプロジェクト、またはOC4Jサーバー・ディレクトリを選択し、ページで使用可能な関連オプションを指定します。

また、以下のことを行うことができます。

- アップグレード・レポートの他にアーティファクトを生成するかどうかを指定します。

- 特定のSmartUpgradeルールに分析を限定し、使用しているOC4Jのバージョンを示すには、「詳細」をクリックします。

[F1]を押すか、ウィザード・ページで「ヘルプ」をクリックします。

2.3.2.2項「SmartUpgrade Oracle JDeveloper拡張機能でサポートされるアーカイブとプロジェクトのタイプ」

2.3.2.3項「特定のSmartUpgradeルール・カテゴリへの分析の制限」

2.3.2.4項「Oracle Application Server 10g リリース2(10.1.2)にデプロイされたアプリケーションの分析」

必須入力(図2-5)

このページは、次の条件が当てはまる場合に表示されます。

- OC4Jアーティファクト・ウィザード・ページでアーティファクトの生成を選択します。

- SmartUpgradeでアップグレード可能なWebサービス、データ・ソース、EJB、その他のアーティファクトがアプリケーションに含まれます。

- ルール管理ダイアログで選択したルール・カテゴリには、SmartUpgradeでアーティファクトを生成できるオブジェクト・タイプが含まれます。ダイアログ・ボックスを表示するには、必須入力ページで「詳細」をクリックします。

2.3.3項「必須入力ページのプロパティの設定」

2.3.2.2項「SmartUpgrade Oracle JDeveloper拡張機能でサポートされるアーカイブとプロジェクトのタイプ」

図2-3 Java EEアップグレード・アプリケーション・ウィザード - アップグレード・レポート・タイプ・ページ

図2-4 Java EEアップグレード・アプリケーション・ウィザード - エンタープライズ・アーカイブを分析する場合のOC4Jアーティファクト・ページ

図2-5 Java EEアップグレード・アプリケーション・ウィザード - 必須入力ページ

2.3.2.2 SmartUpgrade Oracle JDeveloper拡張機能でサポートされるアーカイブとプロジェクトのタイプ

Oracle JDeveloperからSmartUpgradeを実行する場合、次の内容を分析できます。

- 既存のエンタープライズ・アーカイブ(EAR)・ファイル、Webアーカイブ(WAR)・ファイル、Javaアーカイブ(JAR)・ファイル、またはWinRAR (RAR)・ファイル。

- 現在のOracle JDeveloperアプリケーション内の1つ以上のOracle JDeveloperプロジェクト

アプリケーション内のWebサービスを分析する場合、EARファイルを選択する必要があります。Oracle JDeveloperの開いているアプリケーションやプロジェクト内のWebサービスのアーティファクトを分析または生成することはできません。

2.3.2.3 特定のSmartUpgradeルール・カテゴリへの分析の制限

SmartUpgradeがデフォルトでレポートを生成し、オプションでアーティファクトを生成するには、選択したアーカイブまたはOC4Jサーバー構成にすべてのルール・カテゴリを適用します。

ただし、レポートのサイズを制限する場合や、アプリケーションの特定の面に焦点を当てる場合、特定のSmartUpgradeルール・カテゴリに分析を限定できます。

たとえば、myApp.earアプリケーションのデータ・ソース構成のみを分析する場合は次のようになります。

1. 2.3.1項「Java EEアップグレード・ウィザードの起動」の説明に従い、Java EEアップグレード・ウィザードを起動します。

2. ウィザードのOC4Jアーティファクト・ページで「詳細」をクリックして、ルール管理ダイアログ・ボックスを表示します。

3. チェック・ボックスを使用して、現在のアプリケーションの分析でSmartUpgradeが使用するルール・カテゴリを選択します。

レポートを生成し、オプションでアプリケーション・アーティファクトを生成する場合に適用可能なSmartUpgradeルール・カテゴリの説明については、表3-4を参照してください。

2.3.2.4 Oracle Application Server 10g リリース2(10.1.2)にデプロイされたアプリケーションの分析

SmartUpgradeは、Oracle Application Server 10g リリース3(10.1.3)に以前にデプロイされたアプリケーションを分析するようにデフォルトで構成されます。ただし、10g リリース2(10.1.2)からアップグレードする場合、使用している特定のバージョンのOC4Jを指定できます。

1. 2.3.1項「Java EEアップグレード・ウィザードの起動」の説明に従い、Java EEアップグレード・ウィザードを起動します。

2. ウィザードのOC4Jアーティファクト・ページで「詳細」をクリックして、ルール管理ダイアログ・ボックスを表示します。

3. ダイアログ・ボックスのOC4J Serverバージョン・セクションで「10.1.3」または「10.1.2」を選択します。

2.3.3 必須入力ページのプロパティの設定

アップグレードするアプリケーションに、SmartUpgradeでアーティファクトを生成できるWebサービス、データ・ソース、EJB、その他のオブジェクト・タイプが含まれる場合、Java EEアップグレード・ウィザードでは、通常、必須入力ページ(図2-5)が表示されます。

このページのオプションの設定については、次の項を参照してください。

- Webサービスの各アーティファクト生成オプションの習得

- パフォーマンス分析用計測コードの生成

2.3.3.1 Webサービスの各アーティファクト生成オプションの習得

次のリソースを参考にページのオプションについて学ぶことができます。

- ページのオプションを選択し、「説明」フィールドのテキストを確認します。

- 表3-2「オプションのSmartUpgradeコマンドライン・オプションの概要」

- 表3-3「アーティファクト生成に固有のコマンドライン・オプションの概要」

2.3.3.2 パフォーマンス分析用計測コードの生成

パフォーマンス・データを収集し、アップグレードされたアプリケーションに対して生成される追加コードのパフォーマンスの影響を表示するHTMLレポートを生成する場合、必須入力ウィザード・ページの「パフォーマンス分析用計測コードの生成」プロパティを選択します。

アップグレードされたWebサービスをOracle WebLogic Serverにデプロイすると、glueコードによるパフォーマンスの影響をまとめたHTMLレポートが生成されます。Webサービスが複数ある場合、複数のレポート・ファイルが生成されます。

詳細は、4.2.3項「SmartUpgradeで生成されるWebサービスglueコードによるパフォーマンスの影響の分析」を参照してください。

2.3.4 アーティファクト生成時のアップグレードの続行

SmartUpgradeがアプリケーションのアーティファクトを分析する場合、アプリケーション・アーティファクトをアップグレードする前に手動による手順が必要になる場合があります。また、指定しなかったプロパティが必要になる場合もあります。

このような場合、「Webサービス・アーティファクト生成10.1.3」または「Webサービス・アーティファクト生成10.1.2」というアップグレード・レポートに結果が表示されます。この結果には、アップグレード・プロセスの状態がまとめられ、ユーザーが行う必要がある手順が示されます。

Oracle JDeveloperウィンドウの下部にあるSmartUpgradeログ・ウィンドウに警告も表示されることに注意してください。

「Webサービス・アーティファクト生成」の結果には、Webサービス・アップグレードを続行する前に行う必要がある追加の手順が示される場合があります。

SmartUpgradeを再実行して、Webサービス・アップグレード・プロセスを続行するには、次の操作を行います。

1. Oracle JDeveloperアプリケーション・ナビゲータでアップグレード・レポートを右クリックし、コンテキスト・メニューから「再生成」を選択します(図2-6)。
Oracle JDeveloperに「レポート生成」ダイアログ(図2-7)が表示されます。このダイアログを使用して、レポートの元の結果が以降のSmartUpgrade実行で上書きされるかどうかを制御します。

2. 結果のステータスを使用して、どの結果が実装されたか、どの結果が現在進行中かを追跡する場合、「すべて」または「変更あり」を選択します。
「すべて」または「変更あり」を選択しない場合、レポート全体が再生成され、各結果に選択したステータス設定が失われます。

詳細は、2.4.5項「結果ステータスを使用した作業の追跡」を参照してください。

3. 「次へ」をクリックして必須入力ダイアログ・ボックスを表示します。
Oracle JDeveloperには必須入力ダイアログが表示されます。このダイアログは、SmartUpgradeを最初に実行したときに表示された必須入力ウィザード・ページと同様です。ただし、最初に指定したプロパティと、アップグレード・プロセスの続行に必要な追加プロパティのみが含まれる点を除きます。

4. 欠落しているプロパティ値を指定して、「OK」をクリックします。
SmartUpgradeは、アプリケーションのWebサービスを再度分析し、アーティファクト生成を完了しようとします。追加プロパティが必要な場合、アップグレード・プロセスの再続行が求められます。

図2-6 アップグレード・レポートのコンテキスト・メニューの 「再生成」の選択

図2-7 SmartUpgradeレポートを再生成する場合に表示されるレポート生成画面

2.4 SmartUpgradeレポートの使用

Oracle JDeveloperでSmartUpgradeアップグレード・レポートを生成すると、結果をソートしてフィルタ処理できます。この機能を使用して、最初に最も重要な結果に焦点を当てることができます。

詳細は、次の項を参照してください。

- SmartUpgradeレポートの表示

- アップグレード結果ツールバーを使用したSmartUpgrade結果のフィルタ処理

- 構造ウィンドウを使用したSmartUpgrade結果のソートとフィルタ処理

2.4.1 SmartUpgradeレポートの表示

アップグレード・レポートを表示するには、アプリケーション・ナビゲータを使用して、Java EEアップグレード・ウィザードで作成したプロジェクトを開きます。プロジェクトの「アプリケーション・ソース」フォルダの下にあるアップグレード・レポートを探し、そのアップグレード・レポートを選択します(図2-8)。

レポートは次の3つのタブに分類されます。

- 「レポート」タブ。レポートの概要と、選択したアプリケーションについてSmartUpgradeで生成される各結果を含むリストがあります。

- 「カテゴリ」タブ。レポートの生成時に適用されたSmartUpgradeルールのカテゴリが示されます。

- 「リソース」タブ。レポートを生成する際にSmartUpgradeで分析されたアーカイブまたはプロジェクトが示されます。

「レポート」タブの各結果に関して入手可能な情報のタイプについては、2.4.2項「各結果で入手可能な情報」を参照してください。

図2-8 Oracle JDeveloperのSmartUpgrade レポート

2.4.2 各結果で入手可能な情報

SmartUpgradeにより、SmartUpgradeレポート内の各 結果で次の情報が提供されます。

- 結果の理由。
理由は、結果がなぜ存在するのかを定義します。アプリケーション・アーカイブのデプロイメント記述子やOC4Jサーバーの構成ファイルの特定の要素または属性を特定する場合もあります。また、アプリケーションで使用される依存性API (Oracle WebLogic Serverにアプリケーションをデプロイする前に変更する必要がある)も特定します。

- 問題の解決方法に関するアドバイス。
アドバイスは、結果で特定された問題を解決するために行う必要があるアクションです。アドバイスには、アプリケーションやOracle WebLogic Server環境を適宜変更する場合に役立つ手順やドキュメントの参照などがあります。

- 結果の関連事項。関連事項はオプションであり(常に表示されるわけではありません)、動作の相違(ある場合)を示します。これは、結果のアドバイスに伴い、アップグレードされたアプリケーションで通知されます。

- 結果に関連する生成アーティファクトのリンク。たとえば、一部のデータ・ソースの場合、Oracle WebLogic Serverにアプリケーションをデプロイするときにアプリケーションでデータ・ソースを定義できるXMLコード例が生成されます。詳細は、第4章「SmartUpgrade生成アーティファクトの使用」を参照してください。

図2-9は、SmartUpgradeレポート内のサンプル結果を示しています。

図2-9 SmartUpgradeレポートのサンプル結果

2.4.3 アップグレード結果ツールバーを使用したSmartUpgrade結果のフィルタ処理

レポートの結果リストが長い場合、アップグレード結果ツールバーを使用してリストのグループ化やフィルタ処理を簡単に行うことができます(図2-10)。

図2-10 アップグレード結果ツールバーの使用

表2-2は、アップグレード結果ツールバーで利用可能な各アイコンとメニューの説明です。

表2-2 アップグレード結果ツールバーのオプションの概要

アイコンまたはメニュー

説明

レポートの内容を通常のテキスト形式でクリップボードにコピーするには、このアイコンをクリックします。その後、別のドキュメントやプログラムに内容を貼り付けることができます。

すべての結果を折りたたむには、このアイコンをクリックします。スクロールして各結果の主な見出しを確認できます。ただし、詳細は確認できません。

すべての結果を展開するには、このアイコンをクリックします。レポートのすべての結果の詳細が表示されます。

グループ

アーティファクト、カテゴリ、複雑性、または優先度別に結果をグループ分けするには、このサブメニューを使用します。

たとえば、優先度別に結果をグループ分けする場合、最初にすべての必要な結果がレポートに表示され、次にSmartUpgradeによって推奨事項と見なされる結果が続き、最後に情報となる結果がすべて表示されます。

グループを昇順または降順でソートするかどうかも制御できます。たとえば、結果をカテゴリ別にグループ分けする場合、どのカテゴリの結果がレポートの最上部に表示されるかを決定できます。

フィルタ

タイプ、優先度、またはカテゴリ別に結果をフィルタ処理するには、このサブメニューを使用します。

このメニューから項目を選択する場合、選択した基準を満たさない結果はすべて非表示になります。

たとえば、必要な結果以外のすべての結果をフィルタ処理できます。

2.4.4 構造ウィンドウを使用したSmartUpgrade結果のソートとフィルタ処理

Oracle JDeveloperナビゲーション・ペインの下の「構造」ウィンドウ(図2-11)には、レポートの構造が表示されます。この「構造」ウィンドウを使用して、レポートの結果をフィルタ処理できます。

図2-11 SmartUpgrade レポートの「構造」ウィンドウ

このデフォルト・ビューでは、特定の優先度のすべての結果がすぐに表示されます。たとえば、「必須」をクリックすると、「必須」とマークされた結果のみが表示されます。

「構造」ビューの「ソート」メニューを使用してリストを変更することもできます。たとえば、「ソート」メニューで「複雑度」を選択すると、複雑度カテゴリのリストが表示されます。その後、いずれかのカテゴリを選択して、「レポート」ウィンドウの該当カテゴリの結果のみを表示できます。

「構造」ビューのルート・ノード(図2-11のUpgradeReport)をクリックして、いつでもレポートのすべての結果を表示できます。

2.4.5 結果ステータスを使用した作業の追跡

アップグレード・レポートを確認する際に、結果のステータス・メニュー(図2-12)を使用して進捗状況を追跡できます。

図2-12 結果のステータス・メニュー

たとえば、実装を完了した結果ごとに「完了」を選択します。実装されない結果の場合、「無視」、「不完全」、または「処理中」の設定を使用します。レポートをスキャンして、残りの作業がどの程度必要かをすぐに確認できます。

レポートを再生成する必要がある場合、新しいレポートでステータス設定を上書きしないときは「レポート生成」ダイアログで「すべて」または「変更あり」を選択する必要があります。

詳細は、2.3.4項「アーティファクト生成時のアップグレードの続行」を参照してください。

3 SmartUpgradeコマンドラインの使用

SmartUpgradeを統合Oracle JDeveloper拡張機能として使用する他に、SmartUpgradeコマンドライン・インタフェースを使用することもできます。

コマンドライン・インタフェースは、Javaコマンドラインを使用して実行するか、Apache Antタスクとして実行できます。

SmartUpgradeコマンドラインでは、スクリプトを使用して複数のアプリケーションのアーティファクトの分析と生成の自動化を検討できます。

詳細については、以下の節を参照してください。

- SmartUpgrade Javaコマンドラインの使用

- SmartUpgradeとApache Antの統合

3.1 SmartUpgrade Javaコマンドラインの使用

次の項では、SmartUpgradeのコマンドライン・インタフェースの使用方法について説明します。

- 前提条件の確認とsmartupgrade.jarファイルの検索

- SmartUpgradeコマンドライン・インタフェースの基本構文

- SmartUpgradeコマンドライン・オプションのヘルプの取得

- SmartUpgradeコマンドライン・オプションの概要

- アーティファクト生成に固有のSmartUpgradeコマンドライン・オプションの概要

- SmartUpgradeコマンドライン・インタフェースの使用例

3.1.1 前提条件の確認とsmartupgrade.jarファイルの検索

SmartUpgradeコマンドライン・インタフェースを実行する前に、次の操作を行います。

1. 1.6.3項「SmartUpgradeコマンドライン・インタフェースのインストール」の説明に従い、必要なJavaソフトウェアをインストールしたことを確認します。
システムのどの場所からもjavaコマンドを実行できるように、Java binディレクトリが現在のPATH変数の一部として定義されていることも確認する必要があります。定義されていない場合、SmartUpgradeソフトウェアを実行するたびにjavaコマンドのパスを指定する必要があります。

2. サポート対象バージョンのOracle WebLogic Serverがインストールされていることと、ローカルのOracle WebLogic Serverホーム・ディレクトリにアクセスできることを確認します。
-targetStackHomeコマンドライン・オプションを使用して、Oracle WebLogic Serverホーム・ディレクトリの場所を指定します。

詳細は、表3-3「アーティファクト生成に固有のコマンドライン・オプションの概要」を参照してください。

3. 1.6項「SmartUpgradeのダウンロードとインストール」の手順を使用してインストールしたsmartupgrade.jarファイルを探します。

この章の手順と例は、smartupgrade.jarが存在するディレクトリからSmartUpgradeを実行していることを前提とします。

3.1.2 SmartUpgradeコマンドライン・インタフェースの基本構文

SmartUpgradeコマンドライン・インタフェースを使用するには、ダウンロードされたsmartupgrade.zipファイルの内容を解凍したディレクトリに移動して次の構文を使用します。

java -jar smartupgrade.jar options

詳細は、3.1.5項「SmartUpgradeコマンドライン・オプションの概要」を参照してください。

3.1.3 SmartUpgrade実行時のオプションによるJavaヒープ・サイズの増加

他のJavaプログラムと同様に、SmartUpgradeの実行時にJavaヒープ・サイズを制御できます。

ヒープ・サイズを増やすと、特に大規模なアプリケーションや複雑なアプリケーションをアップグレードする場合に役立ちます。このような場合、SmartUpgradeには次のようなメッセージが表示されます。

java.lang.OutOfMemoryError: Java heap space

この問題を回避するには、標準のJavaコマンドラインを使用してJavaヒープ・サイズを増やします。例:

java -Xmx512M -jar smartupgrade.jar options

3.1.4 SmartUpgradeコマンドライン・オプションのヘルプの取得

使用可能なオプションのリストを表示するには、次のいずれかのコマンドを入力します。

java -jar smartupgrade.jar -help
java -jar smartupgrade.jar -help locator
java -jar smartupgrade.jar -help category
java -jar smartupgrade.jar -help option

詳細は、3.1.5項「SmartUpgradeコマンドライン・オプションの概要」を参照してください。

3.1.5 SmartUpgradeコマンドライン・オプションの概要

コマンドラインからSmartUpgradeを実行する場合に使用可能なオプションの詳細は、次の項を参照してください。

- SmartUpgradeコマンドライン・インタフェース・オプションのリスト

- SmartUpgradeロケータの特定

- SmartUpgradeコマンドラインでの複数のロケータの指定

- オプションのSmartUpgradeコマンドライン・オプションの概要

3.1.5.1 SmartUpgradeコマンドライン・インタフェース・オプションのリスト

次の例は、SmartUpgradeコマンドライン・ユーティリティの実行時に使用可能なオプションを示しています。

java -jar smartupgrade.jar --LOCATOR_NAME path_or_list_of_file_names
-category list_of_categories
-generate
-html
-target OC4J_version

前述の例では次のようになります。

- LOCATOR_NAMEを、SmartUpgradeアップグレードで分析できる有効なロケータに置き換えます。詳細は、3.1.5.2項「SmartUpgradeロケータの特定」を参照してください。

- LOCATOR_NAMEを特定するには2つのダッシュ(--)が必要です。LOCATOR_NAMEの先頭は2つのダッシュにしてください。その他の引数に必要なダッシュは1つのみです。

- LOCATOR_NAME以外の値はすべてオプションです。

- 例に示すその他のオプションの詳細は、表3-2を参照してください。

3.1.5.2 SmartUpgradeロケータの特定

ロケータは、SmartUpgradeで分析するオブジェクトを特定する一般的な用語です。ロケータは、1つ以上のアプリケーション・アーカイブ(EARファイル、WARファイル、JARファイル、またはRARファイル)になります。また、アーカイブが格納されるディレクトリ・パスや、OC4Jサーバーの構成ディレクトリにもなります。

表3-1は、LOCATOR_NAMEコマンドライン・オプションに使用可能な値の説明です。

アップグレードするファイルまたは構成のタイプに一致しないLOCATOR_NAMEオプションを使用する場合、SmartUpgradeでは不完全な出力や無効な出力が生成される場合があります。たとえば、LOCATOR_NAMEの値--earsを使用し、EARファイルではなくJARファイルの名前を指定した場合、出力は不完全または無効になる可能性があります。

表3-1 SmartUpgrade LOCATOR_NAMEオプションのサポートされる値

LOCATOR_NAMEの値

説明

例

--ears

分析する1つ以上のエンタープライズ・アーカイブ(EAR)・ファイルを特定します。

複数のEARファイルのパスを指定する場合、-earオプションの後にスペース区切りのリストを使用します。

java -jar smartupgrade.jar
--ears myApp.ear
java -jar smartupgrade.jar
--ears C:\samples\App3.ear
java -jar smartupgrade.jar
--ears myApp.ear App3.ear

--wars

分析する1つ以上のWebアーカイブ(WAR)・ファイルを特定します。

複数のWARファイルのパスを指定する場合、-earオプションの後にスペース区切りのリストを使用します。

java -jar smartupgrade.jar
--wars payroll.war
java -jar smartupgrade.jar
--wars C:\samples\Webapp3.war
java -jar smartupgrade.jar
--wars payroll.war C:\samples\Webapp3.war

--jars

分析する1つ以上のJavaアーカイブ(JAR)・ファイルを特定します。

複数のJARファイルのパスを指定する場合、-earオプションの後にスペース区切りのリストを使用します。

java -jar smartupgrade.jar
--jars myProj.jar
java -jar smartupgrade.jar
--jars C:\samples\App3.jar
java -jar smartupgrade.jar
--jars myApp.jar C:\samples\App3.jar

--rars

分析する1つ以上のRARアーカイブ・ファイルを特定します。

複数のRARファイルのパスを指定する場合、-earオプションの後にスペース区切りのリストを使用します。

java -jar smartupgrade.jar
--rars myApp.rar
java -jar smartupgrade.jar
--rars C:\samples\App3.rar
java -jar smartupgrade.jar
--rars myApp.rar C:\samples\App3.rar

--server-config

既存のOC4Jサーバーの構成ディレクトリを特定します。

SmartUpgradeはOC4Jサーバーの構成を分析し、同様の方法でアドバイスとOracle WebLogic Serverの構成を提供します。

java -jar smartupgrade.jar --server-config
C:\Oracle\AppServ1\j2ee\home\config
java -jar smartupgrade.jar --server-config
/dua1/Oracle/AppServ1/j2ee/home/config

--archive-homes

分析するアーカイブ・ファイル(EARファイル、WARファイル、RARファイル、またはJARファイル)を含む1つ以上のディレクトリを特定します。

SmartUpgradeはディレクトリをスキャンし、ディレクトリ内のアーカイブをすべて分析します。

java -jar smartupgrade.jar --archive-home
C:\projects\myEARfiles\
java -jar smartupgrade.jar --archive-home
/dua1/projects/myEARfiles/

--application-jars

分析するアプリケーションで必要な(または参照される)jarファイルの場所を特定します。指定したファイルはSmartUpgradeで分析されません。

この機能を使用して、分析するアプリケーションで必要なサード・パーティ・ライブラリを特定できます。

java -jar smartupgrade.jar
--application-jars C:\projects\myApp\lib\
java -jar smartupgrade.jar
--application-jars /dua1/projects/myApp/lib/

3.1.5.3 SmartUpgradeコマンドラインでの複数のロケータの指定

コマンドラインで複数のLOCATOR_NAMEを指定できます。

たとえば、エンタープライズ・アーカイブと、そのアーカイブがデプロイされたLinux上のOC4Jサーバーの構成を分析するには、次のコマンドを使用します。

java -jar smartupgrade.jar --ears myApp.ear
--server-config /dua1/Oracle/AppServ1/j2ee/home/config

3.1.5.4 オプションのSmartUpgradeコマンドライン・オプションの概要

SmartUpgradeロケータを特定する以外に、オプションの各種コマンドライン・オプションを使用してSmartUpgradeの動作を制御することもできます。

表3-2は、使用可能なオプションのコマンドライン・オプションの説明です。

表3-2 オプションのSmartUpgradeコマンドライン・オプションの概要

オプション

説明

詳細情報

-category

アプリケーションの分析をSmartUpgradeルールの特定のカテゴリに限定するには、このオプションを使用します。

たとえば、レポートを、選択したアプリケーション・アーカイブのデータ・ソース構成に関する結果に限定できます。

アーティファクトを生成する場合、-categoryオプションの使用に注意してください。-categoryオプションと-generateオプションをどちらも使用する場合、指定したカテゴリのアーティファクトのみが生成されます。

3.1.7.5項「SmartUpgradeコマンドライン・インタフェースの特定のルール・カテゴリへの結果の制限」

-generate

特定のタイプのOracle WebLogic Serverアーティファクト(アプリケーションのOracle WebLogic Serverデプロイメント記述子など)を生成するには、このオプションを使用します。

アーティファクトを起点としてOracle WebLogic ServerにOC4Jアプリケーションをデプロイできます。

3.1.7.3項「SmartUpgradeコマンドライン・インタフェースを使用したOracle WebLogic Serverアーティファクトの生成」

-html

HTML形式の出力を生成するには、このオプションを使用します。このオプションを使用すると、生成されたレポートをHTMLファイルにリダイレクトできます。

3.1.7.4項「SmartUpgradeコマンドライン・インタフェースを使用したHTMLレポートの生成」

-target

Oracle Application Server 10g リリース2(10.1.2)アプリケーションを分析するように指定するには、このオプションを使用します。

デフォルトでは、以前に10g リリース3(10.1.3)にデプロイしたアプリケーションの分析が前提となります。

3.1.7.6項「SmartUpgradeコマンドライン・インタフェースを使用した10g リリース2(10.1.2)アプリケーションの分析」

-output

アップグレード結果をすべてファイルに出力するには、このオプションを使用します。

3.1.8項「SmartUpgrade結果情報とエラー・レポートの出力の制御」

3.1.7.4項「SmartUpgradeコマンドライン・インタフェースを使用したHTMLレポートの生成」

-quiet

SmartUpgradeでエラーまたは診断情報が出力されないようにするには、このオプションを使用します。

3.1.8項「SmartUpgrade結果情報とエラー・レポートの出力の制御」

3.1.6 アーティファクト生成に固有のSmartUpgradeコマンドライン・オプションの概要

例3-1は、SmartUpgradeコマンドライン・ユーティリティを実行してアーティファクトを生成する際に使用可能なオプションを示しています。

SmartUpgradeで生成されるアーティファクトの使用の詳細は、第4章「SmartUpgrade生成アーティファクトの使用」を参照してください。

各オプションの説明は、表3-3「アーティファクト生成に固有のコマンドライン・オプションの概要」を参照してください。

Webサービス・アーティファクトを生成する場合、LOCATOR_NAMEの値、-generateオプション、および-targetStackHomeオプションは必須になります。

LOCATOR_NAMEを、SmartUpgradeアップグレードで分析できる有効なロケータに置き換えます。詳細は、3.1.5.2項「SmartUpgradeロケータの特定」を参照してください。

例3-1 アーティファクト生成時のコマンドライン・オプションのリスト

java -jar smartupgrade.jar --LOCATOR_NAME path_to_application_archive_or_directory
-generate
-category category_name
-acceptDuplicates
-additionalClassPath
-autoWrap
-continue
-dateFormat
-debug
-ejbLookupName
-ejbNewWarBase
-ejbNewWarContextRoot
-evaluate
-javaHome
-jdevProject
-logLevel
-logWrap
-logWrapLength
-packLibs
-processTimeout
-propertyFile
-qos
-resolveMapAmbiguity
-sessionImplKey
-sessionTimeoutSecs
-skipGlueCode
-stopAtTargetPlan
-targetStackHome
-useJSF
-useJSTL
-wrapperNullAllowed

表3-3 アーティファクト生成に固有のコマンドライン・オプションの概要

コマンドライン・オプション

Java EEアップグレード・ウィザードの対応オプション

説明

-acceptDuplicates

重複クラスの許容

コマンドラインで-acceptDuplicates(または-acceptDuplicates true)を渡すか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

このオプションは、重複クラスのエラーを無視して引き続きglueコードを生成するかどうかを示します。

このオプションを有効にするのは、重複クラスが同一であることを確認した場合のみです。

-additionalClassPath

追加クラスパス

JARファイルとクラス・ディレクトリを含む追加クラスパスです。Webサービスが依存するすべてのライブラリが入力アプリケーションに含まれない場合にこのオプションが必要になります。

このオプションを使用して、JARファイルに挿入される、欠落したWSDLファイルのパスを指定することもできます。

-autoWrap

パラメータ・ラッピングの生成

コマンドラインで-autoWrap(または-autoWrap true)を渡すか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

このオプションが有効な場合、生成される内部タイプに対するパラメータ・ラッピングが可能になります。

既存のビジネス・メソッドは、生成される新しいインタフェースや値タイプを認識しません。

このオプションを指定しない場合、その値は、既存のビジネス・パラメータがラップされるかどうかで定義されます。

-continue

1. SmartUpgradeの「レポート」コンテキスト・メニューから「再生成」を選択します。

2. 必須入力画面で「Webサービス・アップグレードの続行」を選択します。

このオプションは、特にWebサービスのアーティファクト生成に適用されます。カテゴリ「web-services」が有効な場合、「-generate」引数と一緒に使用してください。

このオプションでは、Webサービス・アップグレードは、SmartUpgradeの以前の起動で開始されたアップグレード生成プロセスを再開します。

詳細は、2.3.4項「アーティファクト生成時のアップグレードの続行」を参照してください。

-dateFormat

日付-文字列変換用フォーマット

java.lang.Stringとjava.util.Dateの変換にglueコードで使用される日付フォーマット。

WebLogic Webサービス生成ツールでjava.util.Date値タイプを生成し、元のアプリケーション・メソッドがjava.lang.Stringを使用することが検出された場合、SmartUpgradeはglueコードに変換メソッドを追加します。

ただし、この変換には文字列フォーマットが必要になります。そのため、OC4Jアプリケーションを調べて、既存のビジネス・ロジックがその日付値に予測する特定の文字列フォーマットを判断する必要があります。

-debug

デバッグ情報の出力

コマンドラインで-debug(または-debug true)を渡すか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

有効な場合、デバッグ・レベル・メッセージが出力されます。デバッグ・メッセージは、INFOレベル・メッセージよりも詳細なレベルのメッセージになります。

デフォルト値はfalseです。

-ejbLookupName

EJB参照名

EJB WebサービスがアップグレードされるPOJOベースのWebサービスで使用されるEJB 2.xルックアップ名。

このオプションを使用するのは、アプリケーションにEJB Webサービスが1つある場合のみです。複数のEJB Webサービスがある場合、サービスごとに生成されたアップグレード・プランを編集します。

アップグレード・プランの検索の詳細は、付録A「SmartUpgradeで生成される出力ディレクトリ」を参照してください。

-ejbNewWarBase

WARベース名

生成されるWARファイルのベース名。

EJBベースのWebサービスがPOJOベースのWebサービスにアップグレードされる場合、新しいWARファイルが生成されます。このオプションの値が新しいWARファイルのベース名になります。

EJB Webサービスが複数ある場合、EJB Webサービスごとに異なる値でこのプロパティを追加するようにソースのアップグレード・プランを編集します。

アップグレード・プランの検索の詳細は、付録A「SmartUpgradeで生成される出力ディレクトリ」を参照してください。

-ejbNewWarContext

WARコンテキスト・ルート

生成されるWARファイルのコンテキスト・パス。

EJBベースのWebサービスがPOJOベースのWebサービスにアップグレードされる場合、新しいWARファイルが生成されます。このオプションの値が新しいWARファイルのコンテキスト・ルートになります。

EJB Webサービスが複数ある場合、EJB Webサービスごとに異なる値でこのプロパティを追加するようにソースのアップグレード・プランを変更します。

アップグレード・プランの検索の詳細は、付録A「SmartUpgradeで生成される出力ディレクトリ」を参照してください。

-evaluate

パフォーマンス分析用計測コードの生成

コマンドラインで-evaluate(または-evaluate true)を渡すか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

このオプションを有効にすると、生成されたラッパー(glue)・コードはパフォーマンス分析用にインストゥルメントされます。

このオプションのデフォルト値はfalseです。

このオプションはアプリケーションのテストにのみ該当するもので、本番環境には適していません。

詳細は、2.3.3.2項「パフォーマンス分析用計測コードの生成」を参照してください。

-javaHome

ターゲット・サーバー・ツールのJDKホーム

SmartUpgradeがターゲット・サーバーでのWebサービス・ツールの実行に使用するJDKホーム。ターゲット・サーバーと一緒にインストールされたJDKが自動的に検索されます。

この動作をオーバーライドするには、このオプションの値にJDKホームを指定します。

このオプションを指定しない場合や、JDKホームがターゲット・サーバーの一部としてインストールされない場合、このアップグレード・ツールの実行には現在のJDKホームが使用されます。

-jdevProject

適用なし

Oracle内部使用限定のオプションです。

-logLevel

ロギング・レベル

ロギング出力のレベルを設定するには、このオプションを使用します。

このオプションは、Webサービスのアップグレードでのロギング出力のレベルを示します。

ログ・レベルは、INFO、FINE、DEBUG、TRACEを指定できます。

デフォルト値はINFOです。警告とエラーは無条件でレポートされます。すべてのログ・メッセージは1つのログ・レベルに属し、そのログ・レベルがリクエストされる場合のみ出力されます。

ログに含めるレベルは縦棒(|)区切りで指定します。たとえばINFO|DEBUGのようになります。

注意: このオプションは検証されません。無効な値はすべて無視されます。

-logWrap

ログ出力の余白

コマンドラインで-debugWrap(または-debugWrap true)を渡すか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

有効な場合、診断出力は調整されるため、読みやすくなります。

デフォルト値はtrueです。logWrapLengthオプションを使用して、列幅を調整できます。

-logWrapLength

ログの行幅

テキストを複数行にわけずにログが記録されるテキストの最大長を設定するには、このオプションを使用します。このオプションを使用して調整を保存します。

これはlogWrapオプションがtrueに設定されている場合にのみ適用可能です。デフォルト値は80です。

-packLibs

パッケージ化の内容

パス・セパレータ区切りのJARファイルのリスト。

Windowsの場合のセパレータはセミコロン(;)、UNIXシステムの場合はコロン(:)になります。

特定されたJARファイルは、生成された最終アーカイブに自動でパッケージ化されます(最終アーカイブがEARファイルまたはWARファイルの場合)。

この値は、アーティファクト生成時の参照でライブラリを使用するようにadditionalClassPathオプションの値にも追加されます。

-processTimeout

タスク生成のタイムアウト(秒)

SmartUpgradeがWSDLドキュメントの処理を続行してアーティファクトを生成する秒数。タイムアウトにより、SmartUpgradeはWSDL URLからのレスポンスの待機中にハングしなくなります。

タスクのタイムアウトのデフォルトは300秒です。別の値を設定するには、このコマンドライン・オプションを使用するか、Oracle JDeveloperのウィザード・ページに正数を指定するか、SmartUpgradeの起動前に次の環境変数を設定します。

GENERATION_TASKS_TIMEOUT

-propertyFile

プロパティ・ファイル

このオプションは、特にWebサービスのアーティファクト生成に適用されます。カテゴリ「web-services」が有効な場合、「-generate」引数と一緒に使用してください。

キーがSEIクラス名、値がWSDLファイルのパスで、欠落したWSDLの場所を通常定義するプロパティ・ファイルの場所。

その他のプロパティは、「日付-文字列変換用フォーマット」、「ラッパーNull値許可」、「EJB参照名」、「EJB WebサービスのWARベース名」、「EJB WebサービスのWARコンテキスト・ルート」、「ステートフルWebサービスのセッション・バインド・キー」、「ステートフルWebサービスのセッション・タイムアウト(秒)」などの個別オプションを使用するのではなく、このファイルで定義できます。

-qos

サービス品質ポリシー

このオプションはポリシーのタイプ(サービス品質)を示し、生成されるターゲットのWebサービスで有効にする必要があります。

トークンは、MTOM、WSS_UNT、CONVERSATIONAL、STATEFUL、またはRM11を指定できます。

コンマ(,)区切りで複数の値を渡すことができます。

-resolveMapAmbiguity

マッピングのあいまいさの解決

値をtrueに設定するか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

このオプションを有効にすると、マッピングのあいまいさが自動的に解決されます。

このオプションは、マッピング・ファイルまたはアノテーションのいずれかでマッピング情報が検出されない場合にのみ適用可能です。

デフォルト値はfalseです。

SmartUpgradeを信頼してあいまいさを解決する場合、このオプションを有効にします。

-sessionImplKey

ステートフルWebサービスのセッション・バインド・キー

このオプションは、特にWebサービスのアーティファクト生成に適用されます。カテゴリ「web-services」が有効な場合、「-generate」引数と一緒に使用してください。

ステートフルWebサービスの場合に、ビジネス実装をHTTPセッションにバインドするために使用されるバインド・キーです。デフォルト値は、生成された実装クラスから導出されます。デフォルト値はWebサービス・レベルでオーバーライドできます。

-sessionTimeoutSecs

ステートフルWebサービスのセッション・タイムアウト(秒)

このオプションは、特にWebサービスのアーティファクト生成に適用されます。カテゴリ「web-services」が有効な場合、「-generate」引数と一緒に使用してください。Webサービスのセッション・タイムアウト(秒単位)です。

この値がアプリケーションのHTTPセッション・タイムアウトを超えることはありません。デフォルト値は1,200です。

-skipGlueCode

glueコード生成のスキップ

値をtrueに設定するか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

このオプションが有効な場合、glueコード生成をスキップする必要があります。有効な場合、ターゲット・プランの生成もスキップされます。生成されたglueコードを変更し、アプリケーションのコンパイルとパッケージ化が必要な場合にこのオプションを使用します。

-stopAtTargetPlan

アップグレード・ターゲット・プラン生成後に停止

このオプションは、特にWebサービスのアーティファクト生成に適用されます。カテゴリ「web-services」が有効な場合、「-generate」引数と一緒に使用してください。

glueコード生成を行う必要があるかどうかを示すフラグ(true/false)。デフォルト値はfalseで、glueコード生成が行われます。オプションの値がtrueの場合、ターゲット・アップグレード・プランが生成されると、Webサービス・アップグレードは停止します。

ソース・アップグレード・プランは、(スキップされないかぎり)ターゲット・アップグレード・プランの生成前に生成されます。このオプションは、ユーザーがターゲット・アップグレード・プランを編集し、別の手順でglueコードを生成する場合に使用されます。

-targetStackHome

適用なし

ターゲットWebLogic Serverホームの指定に使用される必須のコマンドライン・プロパティ。例:

C:\Oracle\Middleware\wlserver_10.3

大量のアプリケーションを移行する場合、Oracle JDeveloperの起動前に環境変数WL_HOMEを設定しておけば、このプロパティを繰り返し指定しなくて済みます。

WL_HOME環境変数に設定した値は、アップグレード・プロセスですべてのアプリケーションに適用されます。

このプロパティはOracle JDeveloperの使用時は必要ありません。SmartUpgrade Oracle JDeveloper拡張機能により、Oracle JDeveloperと一緒にインストールされたOracle WebLogic Server環境のライブラリとその他の必要なファイルが自動的に使用されるためです。

詳細は、3.1.7.1項「Oracle WebLogic Serverホーム・ディレクトリの特定」を参照してください。

-useJSF

最新のJSFライブラリを使用する

JSFライブラリはWebアプリケーション・ライブラリとして提供され、JSF機能を使用する該当のWebアプリケーションのWLSにデプロイする必要があります。

-useJSTL

最新のJSTLライブラリを使用する

JSTLライブラリはWebアプリケーション・ライブラリとして提供され、JSTL機能を使用する該当のWebアプリケーションのWLSにデプロイする必要があります。

-wrapperNullAllowed

ラッパーNull値許可

このオプションは、特にWebサービスのアーティファクト生成に適用されます。カテゴリweb-servicesが有効な場合、-generate引数と一緒に使用してください。

コマンドラインで-wrapperNullAllowed(または-wrapperNullAllowed true)を渡すか、OC4J Webサービス・アップグレード・ウィザードのページでチェック・ボックスを選択してこのオプションを有効にします。

有効な場合、Null値は、アップグレード前にアプリケーションにすでに存在するラッパー・タイプに対して許可されます。

デフォルト値はfalseです。この場合、ラッパー・タイプのNull値は空のオブジェクトで表されます。

WebLogic Server JAX-RPC Webサービスでは、ラッパー・タイプにNull値は許可されないことに注意してください。

3.1.7 SmartUpgradeコマンドライン・インタフェースの使用例

次の項では、Oracle WebLogic Serverへのアプリケーションのアップグレードに役立つSmartUpgradeコマンドライン・オプションの使用例を示します。

- Oracle WebLogic Serverホーム・ディレクトリの特定

- SmartUpgradeコマンドライン・インタフェースを使用したエンタープライズ・アーカイブ(EAR)・ファイルの分析

- SmartUpgradeコマンドライン・インタフェースを使用したOracle WebLogic Serverアーティファクトの生成

- SmartUpgradeコマンドライン・インタフェースを使用したHTMLレポートの生成

- SmartUpgradeコマンドライン・インタフェースの特定のルール・カテゴリへの結果の制限

- SmartUpgradeコマンドライン・インタフェースを使用した10g リリース2(10.1.2)アプリケーションの分析

3.1.7.1 Oracle WebLogic Serverホーム・ディレクトリの特定

SmartUpgradeの多くの操作では、Oracle WebLogic Serverで提供される特定のライブラリやリソースが必要になります。

SmartUpgradeをOracle JDeveloperの拡張機能として実行する場合、SmartUpgradeは、Oracle JDeveloperインストーラでインストールするOracle WebLogic Serverソフトウェアを使用してこれらのファイルを自動的に探します。詳細は、2.1項「Oracle JDeveloperのインストールと構成」を参照してください。

ただし、コマンドラインでは、環境変数WL_HOMEを定義するか、-targetStackHomeオプションを使用して、この目的で使用するOracle WebLogic Serverホーム・ディレクトリの場所を指定する必要があります。

たとえば、WL_HOME変数を定義する場合、次のようになります。

set WL_HOME=c:\middleware\wlserver_10.3

-targetStackHomeオプションを使用するには、次の例を参照してください。

java -jar smartupgrade.jar
--ears myApp.ear
-generate
-category web-services
-targetStackHome c:\middleware\wlserver_10.3

3.1.7.2 SmartUpgradeコマンドライン・インタフェースを使用したエンタープライズ・アーカイブ(EAR)・ファイルの分析

特定のエンタープライズ・アーカイブ(EAR)・ファイルのSmartUpgradeレポートを生成するには、次のコマンド構文を使用します。

java -jar smartupgrade.jar --ears path_of_ear_file.ear

たとえば、myApp.earというEARファイルがあり、このファイルがC:\MyAppsというディレクトリに存在する場合、次のコマンドを使用します。

java -jar smartupgrade.jar --ears C:\MyApps\myApp.ear

SmartUpgradeは、最後のウィンドウに書き込まれるレポートを生成します。レポート結果を保存するには、出力をファイルにリダイレクトします。たとえば、次の例は、report.txtというファイルへの出力のリダイレクト方法を示しています。

- Windowsオペレーティング・システムの場合:

java -jar smartupgrade.jar --ears C:\MyApps\myApp.ear > account_report.txt

- UNIXオペレーティング・システムの場合:

java -jar smartupgrade.jar --ears /home/MyApps/myApp.ear > account_report.txt

3.1.7.3 SmartUpgradeコマンドライン・インタフェースを使用したOracle WebLogic Serverアーティファクトの生成

SmartUpgradeはレポートを生成する他に、限定数のアーティファクトを生成することもできます。限定されたアーティファクトにより、アプリケーションの更新がさらに容易になるため、Oracle WebLogic Serverにアプリケーションを正常にデプロイできます。

少なくとも、次の操作を行う必要があります。

- -generateオプションを使用して、アーティファクトを生成します。

- ターゲット・サーバーのホーム・ディレクトリを特定する必須の-targetStackHomeオプションを指定します。

たとえば、myApp.earというアーカイブに関してSmartUpgradeレポートの他にアーティファクトを生成するには、次のコマンドを使用します。

java -jar smartupgrade.jar
--ears archive_name
-generate
-targetStackHome c:\middleware\wlserver_10.3

別の例として、次の操作を実行するとします。

- Oracle WebLogic Serverホームを指定します。

- アップグレードのアーティファクトの生成をWebサービス・アーティファクトのみに限定します。

- アプリケーション・アーカイブには含まれなくてもクラスのロードに必要な追加ライブラリのクラスパスを指定します。

- SmartUpgradeでパフォーマンス分析用計測コードが生成されるように指定します。

この場合、次のコマンドを入力します。

java -jar smartupgrade.jar
--ears archive_name
-generate
-category web-services
-targetStackHome c:\middleware\wlserver_10.3
-additionalClassPath path_to_libraries
-evaluate

この分析結果については、第4章「SmartUpgrade生成アーティファクトの使用」を参照してください。

3.1.7.4 SmartUpgradeコマンドライン・インタフェースを使用したHTMLレポートの生成

SmartUpgradeコマンドライン・インタフェースは、デフォルトでテキスト形式のレポートを生成し、そのレポートは現在のマシンの標準出力に書き込まれます。ほとんどの場合、出力は最後のウィンドウに書き込まれます。

オプションでHTML形式のレポートを生成できます。HTML形式のレポートには、出力が読みやすくなるように見出しとリストが含まれます。さらに、オペレーティング・システムのコマンドを使用して、出力をファイルにリダイレクトできます。生成されたHTMLファイルは、HTMLの読取りが可能なWebブラウザやその他のツールで読み取ることができます。

たとえば、account_mgmt.earというEARファイルがあり、このファイルがC:\MyAppsというディレクトリに存在する場合、次のコマンドを使用してaccount_mgmt_report.htmlというHTMLファイルを生成します。

java -jar smartupgrade.jar --ears myApp.ear -html > account_mgmt_report.html

関連情報については、3.1.8項「SmartUpgrade結果情報とエラー・レポートの出力の制御」を参照してください。

3.1.7.5 SmartUpgradeコマンドライン・インタフェースの特定のルール・カテゴリへの結果の制限

SmartUpgradeがデフォルトでレポートを生成し、オプションでアーティファクトを生成するには、選択したアーカイブまたはOC4Jサーバー構成にすべてのルール・カテゴリを適用します。

ただし、レポートのサイズを制限する場合や、アプリケーションの特定の面に焦点を当てる場合、特定のSmartUpgradeルール・カテゴリに分析を限定できます。

たとえば、myApp.earアプリケーションのデータ・ソース構成のみを分析する場合は次のようになります。

java -jar smartupgrade.jar --ears myApp.ear -category data-sources

複数のカテゴリを適用するには、カテゴリをスペースで区切ります。例:

java -jar smartupgrade.jar --ears myApp.ear -category data-sources web-app

表3-4は、レポートを生成し、オプションでアプリケーション・アーティファクトを生成する場合に適用可能なSmartUpgradeルール・カテゴリの説明です。

注意:

アーティファクトを生成する場合、-categoryオプションの指定に注意してください。-categoryオプションと-generateオプションをどちらも使用する場合、指定したカテゴリのアーティファクトのみが生成されます。

表3-4 SmartUpgradeルール・カテゴリのリスト

ルール・カテゴリ

カテゴリを使用して分析する内容

adf

Oracle Application Development Framework (Oracle ADF)に固有のアーティファクト。

api

アプリケーションで使用される標準アプリケーション・プログラミング・インタフェース(API)。このルール・カテゴリは、Oracle WebLogic ServerでサポートされないOC4Jおよびサード・パーティのAPIをチェックします。

app-client

アプリケーション内のクライアント・インタフェース。

classloading

アプリケーションで使用されるクラスロード構成と共有ライブラリ。

cluster

アプリケーションのクラスタ固有の構成設定。

data-sources

OC4J固有のデータ・ソースの構成設定。

ejb

アプリケーションで使用されるEnterprise Java Beans。

jca

J2EE Connector Architecture (JCA)の構成設定とアーティファクト。

jms

Java Messaging Serverの構成設定とアーティファクト(Oracle Enterprise Messaging Service (OEMS)の使用を含む)。

jmx

アプリケーションで使用されるJava Management Extensions (JMX)。

jndi

Javaネーミング・ディレクトリ・インタフェース(JNDI)の構成設定とアーティファクト。

jta

JavaトランザクションAPI (JTA)の構成設定とアーティファクト。

rmi

リモート・メソッド呼出し(RMI)の構成設定とアーティファクト。

security

セキュリティの構成設定とアーティファクト。

soa

サービス指向アーキテクチャ(SOA)の構成設定とアーティファクト。

web-app

Webアプリケーションの構成設定とアーティファクト。

web-services

Webサービスの構成設定とアーティファクト。

webcache

Oracle Web Cacheの構成設定。

3.1.7.6 SmartUpgradeコマンドライン・インタフェースを使用した10g リリース2(10.1.2)アプリケーションの分析

デフォルトでは、アップグレードするアプリケーションが、以前にOracle Application Server 10g リリース3(10.1.3)にデプロイされていたことが前提となります。

ただし、SmartUpgradeが10g リリース2(10.1.2)に固有の機能、構成設定、またはアーティファクトに関してアプリケーションを分析するように指定するには、-targetオプションを使用します。

Oracle Application Server 10g リリース2(10.1.2)インストールの一部としてOC4Jに以前にデプロイされたアプリケーションをアップグレードする場合、-targetオプションを次のように使用します。

java -jar smartupgrade.jar --LOCATOR_NAME -target 10.1.2

例:

java -jar smartupgrade.jar --ears C:\myApps\my1012App.ear -target 10.1.2

3.1.8 SmartUpgrade結果情報とエラー・レポートの出力の制御

SmartUpgradeは、stdout出力ストリームとstderr出力ストリームをどちらも使用します。

SmartUpgradeはすべての結果情報をstdoutに出力します。使用するオペレーティング・システムやコマンドライン・シェルのルールに従ってこの出力をファイルにリダイレクトできます。

また、-output output_fileオプションを使用して、指定のファイルにストリームを出力できます。次の例を検討してください。

java -jar smartupgrade.jar -output report.txt
java -jar smartupgrade.jar -html -output report.html

SmartUpgradeはstderrストリームを使用して、コマンドラインでステータスと診断をレポートします。-quietフラグにより、stderrへの出力が停止します。-quietオプションを指定する場合、ステータス・メッセージや診断メッセージは出力されません。

-quietオプションと-outputオプションを組み合せて使用すると、SmartUpgradeの個別の内部動作の特徴を管理し、SmartUpgradeによる出力の生成を制御できます。

関連情報については、3.1.7.4項「SmartUpgradeコマンドライン・インタフェースを使用したHTMLレポートの生成」を参照してください。

3.2 SmartUpgradeとApache Antの統合

開発環境でApache Antを使用する場合、例3-2に示すカスタムAntタスクを使用して、SmartUpgradeと既存のAnt環境を統合できます。

例3-2 SmartUpgradeのカスタムAntタスク

<taskdef
name="SmartUpgrade"
classname="oracle.smartupgrade.UpgradeTask"
classpath="${basedir}/smartupgrade.jar"/>

例3-2に示すように、taskdefを定義すると、Antスクリプト内からSmartUpgradeを実行できます。

例3-3は典型的な例で、demoディレクトリ内のすべてのEARファイルを再帰的に探し、SmartUpgradeを実行して各ファイルを調べます。例3-3のupgrade locator要素に使用される有効な値は、JavaコマンドラインのLOCATOR_NAMEに使用される値と同じです。

詳細は、3.1.5.2項「SmartUpgradeロケータの特定」を参照してください。

例3-3 Apache Ant内でのSmartUpgradeカスタムAntタスクの使用

<target name="test" depends="declare">
<SmartUpgrade flags="-quiet"
<upgrade locator="ears">
<fileset dir="${basedir}/demo">
<include name="**/*.ear" />
</fileset>
</upgrade>
</SmartUpgrade>
</target>

4 SmartUpgrade生成アーティファクトの使用

SmartUpgradeは、アップグレード・レポートを生成する他に、次のようなアーティファクトを 生成できます。

- Webアプリケーション・デプロイメント記述子ファイル

- データ・ソース構成ファイル

- Oracle WebLogic ServerでのWebサービスの実行に必要なマッピング・ファイルとタイプ・クラス

- Oracle WebLogic ServerへのEJBアーティファクトのデプロイに必要なEJB構成ファイル

生成されたデプロイメント記述子の場合、生成されたOracle WebLogic Server要素を確認し、その要素を起点としてアプリケーションをアップグレードできるため、Oracle WebLogic Serverにアプリケーションを正常にデプロイできます。

次の項では、Oracle WebLogic Serverにアプリケーションをデプロイできるように、SmartUpgradeで生成されるアーティファクトを使用してアプリケーションをアップグレードする方法について説明します。

- SmartUpgrade生成アーティファクトの使用に必要な手順の概要

- SmartUpgradeで生成されるWebサービス・アーティファクトに関するその他の情報

4.1 SmartUpgrade生成アーティファクトの使用に必要な手順の概要

ほとんどの場合、アプリケーションをOracle Containers for Java EE (OC4J)からOracle WebLogic Server 11gにアップグレードするプロセスは反復プロセスになります。

1. SmartUpgradeを一度実行して、レポートと一部の初期Oracle WebLogic Serverアーティファクトを生成します。

2. レポートを確認して変更を行い、SmartUpgradeを再実行します。

3. Oracle WebLogic Serverにアプリケーションをデプロイする準備ができるまでプロセスを繰り返します。

図4-1は、アプリケーションの分析、レポートの確認、Oracle WebLogic Serverへのアプリケーションの最終デプロイ前に反復変更を行う手順のフロー・チャートです。

表4-1は、フロー・チャートに示す各手順の説明です。

図4-1 SmartUpgradeプロセスのフロー・チャート

表4-1 SmartUpgradeプロセスのフロー・チャートの手順の説明

ステップ

説明

JDevでSmartUpgradeウィザードを実行するか、コマンドラインを使用する

2.3項「Java EEアップグレード・ウィザードの起動と使用」の説明に従い、Oracle JDeveloperでJava EEアップグレード・ウィザードを起動します。

第3章「SmartUpgradeコマンドライン・インタフェースの使用」の説明に従い、コマンドライン・インタフェースでコマンドライン引数を実行します。

アップグレード・レポートを確認する

Oracle JDeveloperを使用している場合は、2.4項「SmartUpgradeレポートの使用」を参照してください。

コマンドラインを使用している場合は、生成されたレポートをテキスト・エディタで開くか、適切なコマンドライン引数を使用して、Webブラウザで確認できるHTMLレポートを生成します。

詳細は、3.1.7.4項「SmartUpgradeコマンドライン・インタフェースを使用したHTMLレポートの生成」を参照してください。

どちらの場合も、結果に対してアーティファクトが生成されたかどうかが示されます。この情報は、提案された変更をアプリケーションに実装する方法を決定する際に後ほど役立ちます。

変更点を決定する

レポート結果には、Oracle WebLogic Serverにアプリケーションを正常にデプロイする前にアプリケーションに加える必要がある変更点に関する提案が含まれる場合があります。

特定された変更点を元のアプリケーションに加えた方が良くなる場合と、SmartUpgradeで生成されたファイルで開始した方が簡単な場合があります。

レポートの各結果により、結果に対してアーティファクトが生成されたかどうかが示されます。

元のプロジェクトを開き、提案された変更を加える

結果により、元のソースに対して実行可能な変更点が推奨された場合、元のプロジェクトを開いて変更を加えます。

変更を加える、またはWebサービスの追加情報を提供する(あるいはその両方)

結果またはSmartUpgrade出力メッセージにより、Webサービスに固有のエラーや推奨事項が特定された場合、変更を加えてからアップグレード・プロセスを再生成または続行するよう求められます。

たとえば、Oracle JDeveloperを使用している場合、アップグレード・レポートにWebサービス・アーティファクト生成10.1.3という結果が表示されます。この結果では、アップグレード・レポートのコンテキスト・メニューから「再生成」を選択し、特定のアーティファクト生成オプションを選択することが推奨されます。

SmartUpgradeのログ・ウィンドウには警告メッセージも表示されます。

Jdevで「再生成」→「Webサービス・アップグレードの続行」を選択するか、コマンドラインで-continueを使用する

詳細は、次を参照してください。

- Oracle JDeveloperを使用している場合は、2.3.4項「アーティファクト生成時のアップグレードの続行」を参照してください。

- SmartUpgradeコマンドライン・インタフェースを使用している場合は、表4-1の引数-continueに関する情報を参照してください。

生成されたEARファイルを探す

SmartUpgradeがアーティファクトを生成すると、アーティファクトは有効なEARファイル構造に編成され、新しいEARファイルがアーカイブされます。EARファイルは、新しいプロジェクト・ディレクトリの次のディレクトリにあります。

- Oracle JDeveloperを使用し、SmartUpgradeのデフォルト出力ディレクトリを使用している場合は次の場所になります。

gen_src/app_name_ear.d/final/

- コマンドライン・インタフェースを使用している場合は、次の場所になります。

upgrade/app_name_ear.d/final/

詳細は、付録A「SmartUpgradeで生成される出力ディレクトリ」を参照してください。

生成されたEARファイルをFINALディレクトリで解凍する

生成されたEARファイルを解凍する場合、Oracle WebLogic Serverにアプリケーションをデプロイするには、生成されたアーティファクトを参照して、ファイルに加えられた変更点を確認できます。

このEARファイルは、Oracle WebLogic Serverに現状のままデプロイするか、内容を起点としてさらに変更を加えることができます。変更を加えるには、EARファイルの各アーティファクトを確認または変更します。

Oracle JDeveloperを使用している場合、アプリケーション・ナビゲータでEARファイルの内容を参照することもできます。

提案された変更を加える

Oracle WebLogic Serverにアプリケーションをすでにデプロイした場合、この手順を使用して、SmartUpgradeレポートの結果で提案された変更を加えることができます。

Oracle WebLogic ServerにアプリケーションEARファイルをデプロイしようとする際にエラーが発生した場合、この手順を使用して、Oracle WebLogic Serverデプロイメント・エラーで提案された変更を加えることができます。

EARファイルを再パッケージ化する

SmartUpgradeで生成された解凍済EARファイルに変更を加えたら、適切なJavaコマンドまたはその他のユーティリティを使用してEARファイルを手動で再アーカイブできます。

4.2 SmartUpgradeで生成されるWebサービス・アーティファクトに関するその他の情報

次の項では、SmartUpgradeで生成されるWebサービス・アーティファクトに関するその他の情報を示します。

- OC4J WebサービスとOracle WebLogic Server Webサービスの相違

- SmartUpgrade Webサービス・アーティファクト生成の機能

- SmartUpgradeで生成されるWebサービスglueコードによるパフォーマンスの影響の分析

4.2.1 OC4J WebサービスとOracle WebLogic Server Webサービスの相違

OC4J WebサービスとOracle WebLogic Server Webサービスの相違に関する全般情報については、次のリソースを参照してください。

- 『Oracle Fusion Middleware Java EEアップグレード・ガイド』の「タスク6: アプリケーションWebサービスのアップグレード」

- 『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの紹介』の「WebLogic Webサービスの概要」

4.2.2 SmartUpgrade Webサービス・アーティファクト生成の機能

Oracle WebLogic Server Webサービス・アーティファクトを生成する場合、SmartUpgradeは次のOC4J WebサービスをOracle WebLogic Server 10.3 JAX-RPC Webサービスにアップグレードします。

- OC4J 10g リリース3(10.1.3) Webサービス

- OC4J 10g リリース3(10.1.3) EJB 2.1 Webサービス

- OC4J 10g リリース3(10.1.3) EJB 3.0 Webサービス

- OC4J 10g リリース2(10.1.2) Webサービス

アップグレードされたWebサービスは、OC4J 10g Webサービスと同じcontextpathとコンテキストURIを使用します。たとえば、OC4J 10g リリース3(10.1.3) WebサービスのURIは次のようになっていました。

http://locahost:8888/contextpath/soap11
http://locahost:8888/contextpath/soap12

アップグレード後は、次のURIを使用してOracle WebLogic Serverドメインの同じWebサービスにアクセスできるようになります。

http://locahost:7001/contextpath/soap11
http://locahost:7001/contextpath/soap12

SmartUpgradeは、アップグレード・プロセス時にWebサービス関連のデプロイメント・ディスクリプタ(web.xmlやweblogic-webservices.xmlなど)を自動的に更新し、アップグレードされたWebサービスが既存のリモート・エンドポイントと通信できるglueコードを生成します。

SmartUpgradeによって実行されるWebサービス・アップグレード・タスクについては、1.4.2項「Webサービス・アーティファクトの生成」を参照してください。

アプリケーションを具体的に分析し、生成されたglueコードによるパフォーマンスの影響を判断するようにSmartUpgradeをオプションで構成できます。詳細は、4.2.3項「SmartUpgradeで生成されるWebサービスglueコードによるパフォーマンスの影響の分析」を参照してください。

4.2.3 SmartUpgradeで生成されるWebサービスglueコードによるパフォーマンスの影響の分析

OC4J WebサービスをOracle WebLogic Serverにアップグレードするために、SmartUpgradeは、「glueコード」というJavaプログラミング・コードを生成します。このglueコードを使用すると、アップグレードされるWebサービスは、新しいサーバーにデプロイされる間に既存のビジネス・ロジック・コードを引き続き使用できます。

生成されたglueコードによるパフォーマンスの影響を判断するには:

1. SmartUpgradeを使用してアプリケーションをアップグレードし、Webサービス・アーティファクトを生成する場合、次のいずれかのオプションを選択します。

- Oracle JDeveloperを使用している場合、Java EEアップグレード・ウィザードのOC4J Webサービスのアップグレード・ページで「パフォーマンス分析用計測コードの生成」を選択します。

- SmartUpgradeコマンドライン・インタフェースを使用している場合、-evaluateコマンドライン・オプションを使用します。

このオプションを有効にすると、SmartUpgradeはパフォーマンス分析用に生成されたラッパー(glue)・コードをインストゥルメントします。

このオプションはアプリケーションのテストにのみ該当するもので、本番環境には適していません。

2. アプリケーションのアップグレードを実行し、Oracle WebLogic Serverにアプリケーションをデプロイします。

3. アプリケーションがデプロイされ、Oracle WebLogic Serverで正常に実行した後、Oracle WebLogic Serverドメイン・ディレクトリで次のHTMLファイルを探します。

MW_HOME/user_projects/domains/domain_name/webservice_port_name.html

4. HTMLファイルをブラウザで開きます。
ブラウザにglueコードのパフォーマンス分析ページが表示されます。デプロイメントの直後は、表の各列にデータは表示されません。

5. Webサービスを実行して、一部のパフォーマンス・データを生成します。
Oracle WebLogic Server管理コンソールまたはOracle Enterprise Manager Fusion Middleware Controlを使用して、Webサービスをテストできます。

詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』の「Webサービスのテスト」を参照してください。

6. glueコードのパフォーマンス分析ページが表示されるブラウザをリフレッシュします。
Webサービスをテストするたびに、glueコードのパフォーマンス・ページにエントリが追加されます。このページのデータを使用して、Webサービスのパフォーマンスに対するglueコードの影響を測定します。

注意:

パフォーマンス・メトリックの分析が終了したら、次のオプションでSmartUpgradeを再実行して本番環境用のアプリケーションを再生成します。

- Oracle JDeveloperを使用している場合、プロセスを最初から繰り返します。ただし、「パフォーマンス分析用計測コードの生成」は選択しないでください。

- コマンドライン・インタフェースを使用している場合、SmartUpgradeの実行時に-evaluate falseオプションを使用します。

図4-2 SmartUpgrade Webサービスのアップグレード - glueコードのパフォーマンス分析ページ

A SmartUpgradeで生成される出力ディレクトリ

この付録では、SmartUpgradeを使用してアプリケーションをアップグレードする際に生成される出力ディレクトリについて説明します。

SmartUpgradeは、生成されたアーティファクトをデフォルトでディスク上の一連のディレクトリに保存します。Oracle JDeveloperを使用している場合、ディレクトリはプロジェクト・ディレクトリと相対的になります。コマンドライン・インタフェースを使用している場合、ディレクトリは、コマンドライン・インタフェースを実行しているディレクトリと相対的になります。

さらに具体的には次のようになります。

- Oracle JDeveloperを使用している場合、出力ディレクトリは、デフォルトで新しいプロジェクト・ディレクトリ内の/gen_src/ディレクトリ下になります。ただし、Java EEアップグレード・ウィザードのOC4Jアーティファクト・ページとは別の場所を定義できます。その場所は、SmartUpgradeがアップグレード・レポートを保存するプロジェクト・ディレクトリと相対的になります。

- SmartUpgradeコマンドライン・インタフェースを使用している場合、出力ディレクトリは、コマンドライン・ツールを呼び出したディレクトリ内のアップグレード・ディレクトリに作成されます。

図A-1は、ディスク上の出力ファイルの編成を示しています。

表A-1は、生成される主要ディレクトリの説明と目的を示しています。

表A-2は、Webサービス・アーティファクト生成に固有の出力ディレクトリの説明です。

図A-1 生成されるアーティファクトの出力ディレクトリ

表A-1 SmartUpgrade出力ディレクトリの概要

ディレクトリ

説明

final

SmartUpgradeツールの最終出力を表すアーカイブが含まれます。

(app_name_ear.dディレクトリの)ルート・ディレクトリの場合、SmartUpgrade生成アーティファクトがすべて含まれるアーカイブ一式を表します。

classes

アーティファクトのコンパイルと生成に使用されるクラス・ファイルが含まれます。

source

アーティファクトのコンパイルと生成に使用されるソース・ファイルが含まれます。

staging

アプリケーション全体をルート・ディレクトリ内のfinalディレクトリにアーカイブする前に、アプリケーションのサブコンポーネントのステージングに使用されるディレクトリです。

static

SmartUpgradeで生成されるデータ・ソース構成ファイルなどの静的アーティファクトが含まれます。

表A-2 Webサービスに固有の 出力ディレクトリの概要

ディレクトリ

説明

いつ作成または上書きされるか

final

アップグレードされた、デプロイ可能な最後のWebサービス・アプリケーションが含まれます。

アプリケーションは、パッケージ化されたエンタープライズ・アーカイブ・ファイルの形式でディスクに展開されます。

Webサービス・アーティファクトを生成するオプションでSmartUpgradeを実行するたびに上書きされ、再作成されます。

特に、SmartUpgradeの「レポート」コンテキスト・メニューの「再生成」オプションを使用してアーティファクトを再生成する場合や、コマンドライン引数を引き続き使用する場合に上書きされます。

explodedディレクトリとintermediateディレクトリの内容をマージすると再作成されます。

intermediate

デプロイ可能な最後のアプリケーション・アーカイブにまだパッケージ化されていない、アップグレード済のWebサービス・アーティファクトとglueコードが含まれます。

Webサービス・アーティファクトの中間情報のみが含まれます。

Webサービスの glueコードを生成するように構成されるSmartUpgradeを実行するたびに上書きされ、再作成されます。

glueコードの生成を省略するオプションを有効にすると、このディレクトリは上書きされません。その後、生成されたコードを手動でさらに変更できます。

exploded

元の入力アプリケーション・アーカイブが含まれます。これは現状のままディスクに展開され、変更はありません。

ソース・アップグレード・プランを生成するように構成されるSmartUpgradeを実行するたびに上書きされ、再作成されます。

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2013, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。