Oracle® Fusion Middleware Oracle Application Development Framework管理者ガイド

11g リリース2(11.1.2.3.0)

B66159-03(原本部品番号:E16179-04)

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

このガイドでのリリース11.1.2.3.0の新しい内容

第I部 Oracle ADFの概要

1 Oracle ADF管理の概要

- 1.1 Oracle ADFの概要

- 1.2 Oracle ADFアーキテクチャ

- 1.2.1 ADFビジネス・コンポーネント

- 1.2.2 ADF Model

- 1.2.3 ADF Controller

- 1.2.4 ADF Faces Rich Client

- 1.3 Oracle ADFアプリケーションの管理

第II部 ADFアプリケーションの管理

2 ADFアプリケーションのデプロイ

- 2.1 ADFアプリケーションのデプロイの概要

- 2.2 スタンドアロン・アプリケーション・サーバーのデプロイの準備

- 2.2.1 アプリケーション・サーバー・インストールへのADFランタイムのインストール方法

- 2.2.1.1 Oracle Fusion Middleware Application Developer Installerを使用して既存のWebLogic Serverのインストール先にADFランタイムをインストール

- 2.2.1.2 Oracle Fusion Middleware Application Developer Installerを使用して既存のWebSphere Application Serverのインストール先にADFランタイムをインストール

- 2.2.2 Oracle WebLogic Serverドメインの作成および拡張方法

- 2.2.2.1 Oracle ADF用のOracle WebLogic Serverドメインの作成

- 2.2.2.2 Oracle ADF用のOracle WebLogic Serverドメインの拡張

- 2.2.2.3 Oracle ADF用のリモートWebLogic管理対象サーバーの設定

- 2.2.3 Oracle WebLogic Server用のJDBCデータ・ソースの作成方法

- 2.2.4 IBM WebSphere Application ServerのJDBCデータ・ソースの作成方法

- 2.3 Oracle Enterprise Manager Fusion Middleware Controlを使用したデプロイ

- 2.4 スクリプト・コマンドを使用したデプロイ

- 2.5 スクリプトおよびAntを使用したデプロイ

- 2.6 アプリケーション・サーバー管理ツールを使用したデプロイ

3 ADFアプリケーションの監視と構成

- 3.1 ADFアプリケーションの監視と構成の概要

- 3.2 Fusion Middleware Controlを使用したパフォーマンスの監視

- 3.2.1 アプリケーション・モジュールのパフォーマンスの表示方法

- 3.2.2 アプリケーション・モジュール・プールのパフォーマンスの表示方法

- 3.2.3 ADFタスク・フローのパフォーマンスの表示方法

- 3.3 Fusion Middleware Controlを使用したアプリケーション・プロパティの構成

- 3.3.1 ADFビジネス・コンポーネント・パラメータの変更方法

- 3.3.2 接続構成の変更方法

- 3.4 MBeanブラウザを使用したアプリケーション・プロパティの構成

- 3.4.1 MBeanを使用したADFアプリケーション構成の変更方法

- 3.4.2 MBeanを使用したADF接続の変更方法

- 3.4.3 MBeanを使用したADFビジネス・コンポーネント構成の変更方法

- 3.4.4 MBeanを使用したMDS構成の変更方法

- 3.4.5 MBeanを使用したアクティブ・データ・サービス構成の変更方法

- 3.5 アプリケーションとともにデプロイされた資格証明の編集方法

- 3.6 診断フレームワークを使用した問題の診断

- 3.7 DMS SPYによるアプリケーションのメトリック情報の表示

- 3.8 WebSphere Application Serverの構成

- 3.8.1 問合せ結果セットを再利用できるようにWebSphereを構成する方法

4 ADFアプリケーションのためのWLSTコマンド・リファレンス

- 4.1 Oracle ADFのためのカスタムWSLTコマンドの概要

- 4.2 ADF固有のWLSTコマンド

- 4.2.1 adf_createFileUrlConnection

- 4.2.1.1 説明

- 4.2.1.2 構文

- 4.2.1.3 例

- 4.2.2 adf_createHttpUrlConnection

- 4.2.2.1 説明

- 4.2.2.2 構文

- 4.2.2.3 例

- 4.2.3 adf_setURLConnectionAttributes

- 4.2.3.1 説明

- 4.2.3.2 構文

- 4.2.3.3 例

- 4.2.4 adf_listUrlConnection

- 4.2.4.1 説明

- 4.2.4.2 構文

- 4.2.4.3 例

- 4.2.5 getADFMArchiveConfig

- 4.2.5.1 説明

- 4.2.5.2 構文

- 4.2.5.3 例

- 4.2.6 exportJarVersions

- 4.2.6.1 説明

- 4.2.6.2 構文

- 4.2.6.3 例

- 4.2.7 exportApplicationJarVersions

- 4.2.7.1 説明

- 4.2.7.2 構文

- 4.2.7.3 例

- 4.2.8 exportApplicationSelectedJarVersions

- 4.2.8.1 説明

- 4.2.8.2 構文

- 4.2.8.3 例

第III部 付録

A ADFランタイム・ライブラリ

- A.1 JDeveloperを使用したADFランタイム・ライブラリの検索

- A.2 adf.oracle.domain.webapp.warライブラリ

- A.3 adf.oracle.domain.earライブラリ

- A.4 システム・クラスパス

- A.5 adf.desktopintegration.warライブラリ

B ADFアプリケーションのためのwsadminコマンド・リファレンス

- B.1 Oracle ADFのためのカスタムwsadminコマンドの概要

- B.2 ADF固有のWebSphereコマンド

- B.2.1 createFileUrlConnection

- B.2.1.1 説明

- B.2.1.2 構文

- B.2.1.3 例

- B.2.2 createHttpUrlConnection

- B.2.2.1 説明

- B.2.2.2 構文

- B.2.2.3 例

- B.2.3 setURLConnectionAttributes

- B.2.3.1 説明

- B.2.3.2 構文

- B.2.3.3 例

- B.2.4 listUrlConnection

- B.2.4.1 説明

- B.2.4.2 構文

- B.2.4.3 例

- B.2.5 getADFMArchiveConfig

- B.2.5.1 説明

- B.2.5.2 構文

- B.2.5.3 例

C GlassFishサーバーの構成

- C.1 GlassFishの構成の概要

- C.2 GlassFishサーバーおよびOracle ADFランタイムの取得

- C.2.1 GlassFishサーバーの取得方法

- C.2.2 Oracle ADFランタイムの取得方法

- C.3 ADFランタイム・ライブラリを使用したGlassFishの構成

- C.3.1 ADF Shareライブラリを手動でインストールする方法

- C.4 追加の構成タスク

- C.4.1 GlassFish管理コンソール

- C.4.2 GlassFishのデータソースの作成方法

- C.4.3 JVMキャッシュの構成方法

- C.5 ADFアプリケーションのGlassFishへのデプロイ

Oracle® Fusion Middleware

Oracle Application Development Framework管理者ガイド

11g リリース2(11.1.2.3.0)

B66159-03(原本部品番号:E16179-04)

2012年8月

ADFアプリケーションをデプロイ、監視および構成する方法について説明するOracle Application Development Framework (Oracle ADF)管理者向けドキュメント

Oracle Fusion Middleware Oracle Application Development Framework管理者ガイド, 11g リリース2 (11.1.2.3.0)

B66159-03

Copyright (C) 2009, 2012, Oracle and/or its affiliates.All rights reserved.

原本主著者: Peter Jew (Lead), Liza Rekadze

原本協力著者: Odile Sullivan-Tarazi, Himanshu Marathe, Cammy Moore

原本協力者: Lynn Munsinger, Duncan Mills, Dipankar Bajpai, Harry Hsu, Ray Maslinski

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

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

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

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 America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

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

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

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

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

はじめに

Oracle Application Development Framework管理者ガイドへようこそ

対象読者

このドキュメントは、Oracle Application Development Framework(Oracle ADF)を使用してOracle ADFアプリケーションをデプロイ、管理、監視および構成する必要のあるシステム管理者を対象としています。

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

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleカスタマは、My Oracle Supportから電子サポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

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

『Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイド』

Oracle Fusion Middleware管理者ガイド

『Oracle Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』

『Oracle Fusion Middleware Oracle Application Development Frameworkのためのデスクトップ統合開発者ガイド』

『Oracle Fusion Middlewareセキュリティ・ガイド』

Oracle Fusion Middleware WebLogic Scripting Toolのコマンド・リファレンス

『Oracle Fusion Middleware高可用性ガイド』

Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイド

Oracle JDeveloper 11gオンライン・ヘルプ

Oracle JDeveloper 11gリリース・ノート(JDeveloper 11gインストール内およびOracle Technology Networkから入手)

Oracle Fusion Middleware Java API Reference for Oracle ADF Model

Oracle Fusion Middleware Java API Reference for Oracle ADF Controller

Oracle Fusion Middleware Java API Reference for Oracle ADF Lifecycle

Oracle Fusion Middleware Java API Reference for Oracle ADF Faces

Oracle Fusion Middleware JavaScript API Reference for Oracle ADF Faces

Oracle Fusion Middleware Java API Reference for Oracle ADF Data Visualization Components

Oracle Fusion Middleware Java API Reference for Oracle ADF Share

Oracle Fusion Middleware Java API Reference for Oracle ADF Business Components Browser

Oracle Fusion Middleware Java API Reference for Oracle Generic Domains

Oracle Fusion Middleware interMedia Domains Java API Reference for Oracle ADF Business Components

Oracle Fusion Middleware Java API Reference for Oracle Metadata Service (MDS)

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

このガイドでのリリース11.1.2.3.0の新しい内容

このマニュアルは、リリース11.1.2.3.0のいくつかの情報で更新されています。次の表に、追加または変更があった項を示します。

このリリースでOracle JDeveloperおよびOracle Application Development Framework(Oracle ADF)に加えられた変更については、Oracle Technology Networkで新機能に関するページ(http://www.oracle.com/technetwork/developer-tools/jdev/documentation/index.htm)を参照してください。

項

変更の説明

第4章「ADFアプリケーションのためのWLSTコマンド・リファレンス」

第4.2.6項「exportJarVersions」

JARバージョン情報をCSVファイルにエクスポートするために追加された新しいコマンド。

第4.2.7項「exportApplicationJarVersions」

アプリケーションのランタイムJARバージョン情報をCSVファイルにエクスポートするために追加された新しいコマンド。

第4.2.8項「exportApplicationSelectedJarVersions」

選択したJARバージョン情報(versions.xmlファイルを使用して選択)をCSVファイルにエクスポートするために追加された新しいコマンド。

付録C「GlassFishサーバーの構成」

付録C「GlassFishサーバーの構成」

GlassFishサーバーを構成してADFアプリケーションを実行する手順を説明するために追加された新しい付録。

第I部

Oracle ADFの概要

この部の構成は、次のとおりです。

- 第1章「Oracle ADF管理の概要」

1 Oracle ADF管理の概要

この章では、実行可能な管理タスク、およびOracle Application Development Framework(Oracle ADF)用に開発されたアプリケーションのデプロイ、管理、監視および構成に使用できるツールについて説明します。

この章の内容は次のとおりです。

- 第1.1項「Oracle ADFの概要」

- 1.2項「Oracle ADFアーキテクチャ」

- 第1.3項「Oracle ADFアプリケーションの管理」

1.1 Oracle ADFの概要

Oracle Application Development Framework(Oracle ADF)は、JavaプラットフォームEnterprise Edition(Java EE)標準とオープン・ソース・テクノロジを基盤とし、サービス指向アプリケーションの実装のための完全なフレームワークを提供します。このフレームワークを使用して、様々なプラットフォームにわたるエンタープライズ・ソリューションを提供できます。Web、Webサービス、デスクトップまたはモバイル・インタフェースに対して、データを検索、表示、作成、変更および検証するアプリケーションを構築できます。

Oracle JDeveloper 11gをOracle ADFとともに使用して、設計、テストおよびデプロイというデプロイの全ライフサイクルをサポートする環境でアプリケーションを開発します。ADFの開発の詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

テスト環境でADFアプリケーションを開発およびテストしたら、このドキュメントに記載されているツールを使用して、アプリケーションを本番環境にデプロイできます。実行中のアプリケーションのパフォーマンスの監視が可能です。プロパティや属性の管理および構成も可能です。

1.2 Oracle ADFアーキテクチャ

Oracle ADFは、業界標準のモデル・ビュー・コントローラ・アーキテクチャをサポートし、ビジネス・ロジック、ナビゲーションおよびユーザー・インタフェースの分離を実現します。このMVCアーキテクチャは、次のものを提供します。

- データの値を表すモデル・レイヤー

- UIコンポーネントを含むビュー・レイヤー

- 入力およびナビゲーションを処理するコントローラ・レイヤー

- ビジネス・ロジックをカプセル化するビジネス・サービス・レイヤー

Fusion Webアプリケーション・テクノロジ・スタックのコンポーネントは次のとおりです。

- ADF Model: 宣言的データ・バインディング・メタデータへのアクセス用

- ADFビジネス・コンポーネント: ビジネス・サービスの構築用

- ADF Faces Rich Client: JavaServer Faces(JSF)で構築されるWebアプリケーションのAJAX対応のUIコンポーネント用

- ADF Controller: 入力処理、ナビゲーションおよび再利用可能なタスク・フロー用

1.2.1 ADFビジネス・コンポーネント

ADFビジネス・コンポーネントは、サービス指向Java EEアプリケーションの実装に使用できるアプリケーション・オブジェクトです。AD Business Componentsを実装すると、クライアントはビジネス・データの問合せ、挿入、更新および削除が可能となります。Business Componentsに、適切に使用するためのビジネス・ルールを適用できます。ADFビジネス・コンポーネントの主要コンポーネントは、エンティティ・オブジェクト、ビュー・オブジェクトおよびアプリケーション・モジュールです。

エンティティ・オブジェクトは、データベース表の行を表します。ここでは、データ操作言語(DML)操作を使用してデータを変更します。エンティティ・オブジェクトは、他のエンティティ・オブジェクトとともに使用され、データベース・スキーマ内の関連を反映します。

ビュー・オブジェクトは、SQL問合せを表します。SQL言語を使用してデータベースへの問合せを行い、結果を取得します。ビュー・オブジェクトを他のエンティティ・オブジェクトにリンクし、マスター/ディテール階層を作成することもできます。

アプリケーション・モジュールは、UIコンポーネントがデータにアクセスできるようにするトランザクション・コンポーネントです。データ・モデルと、特定のタスクを実行するメソッドを表します。

1.2.2 ADF Model

ADF Modelは、データ・コントロールと呼ばれるサービス抽象化を実装します。データ・コントロールは、メタデータ・インタフェースを使用してビジネス・サービスを抽象化します。このメタデータは、データ・コレクション、プロパティ、メソッドおよびタイプの記述に使用されます。JDeveloperでは、データ・コントロールは「データ・コントロール」パネルに表示されます。属性、コレクションおよびメソッドをページにドラッグ・アンド・ドロップすると、JDeveloperはそのページから関連付けられたサービスへのバインディングを自動的に作成します。

1.2.3 ADF Controller

ADF Controllerは、JSFと連携するナビゲーションおよび状態管理モデルを提供します。特定のタスク・シーケンスをカプセル化する、タスク・フローと呼ばれるナビゲーション・フローを作成できます。

1.2.4 ADF Faces Rich Client

ADF Facesは、そのままWebアプリケーションの作成に使用できる、100を超える豊富なコンポーネントを提供します。ADF Facesコンポーネントは、ページを完全にレンダリングせずにリクエストをサーバーに送信できるようにする組込みのAJAX機能を提供します。JSFは、サーバー側コントロールを提供し、JavaScriptへの依存を低減します。これらのコンポーネントは、スキニング、国際化およびアクセシビリティのオプションを提供します。

ADF Facesには、表、ツリー、ダイアログ、アコーディオンおよび様々なレイアウト・コンポーネントを含む、大規模なコンポーネント・セットがあります。また、グラフ、チャートおよびゲージを表示する、FlashおよびSVG対応のADFデータ視覚化コンポーネントも含まれています。

1.3 Oracle ADFアプリケーションの管理

ADFアプリケーションで様々な管理タスクを実行できます。ADFアプリケーションのデプロイには、Enterprise Manager Fusion Middleware Control、WLSTコマンド、ojdeployコマンド、スクリプト、またはWebLogic管理コンソールを使用できます。

アプリケーションがデプロイされたら、Enterprise Manager Fusion Middleware Controlを使用してアプリケーション・プロパティを構成できます。プロパティの一部は、ADF MBean内の値を変更するMBeanブラウザを使用して構成することもできます。たとえば、Enterprise Manager Fusion Middleware Controlを使用して、URL接続またはWebService接続エンドポイントを変更したり、本番の資格証明をシードできます。

アプリケーションを実行すると、アプリケーション・モジュールのパフォーマンス・データ、アプリケーション・モジュール・プーリングおよびタスク・フローを監視できます。

第II部

ADFアプリケーションの管理

この部の構成は、次のとおりです。

- 第2章「ADFアプリケーションのデプロイ」

- 第3章「ADFアプリケーションの監視と構成」

- 第4章「ADFアプリケーションのためのWLSTコマンド・リファレンス」

2 ADFアプリケーションのデプロイ

この章では、ターゲット・アプリケーション・サーバーにEARファイルとしてパッケージ化されたOracle ADFアプリケーションをデプロイする方法を説明します。スクリプトおよびAntを使用してデプロイ・プロセスを自動化する方法についても説明します。この章では、本番および後のステージでのテストのためのADFアプリケーションのデプロイに焦点を当てます。開発のためのADFアプリケーションのデプロイについては、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

IBM WebSphere Application Serverなどサード・パーティのアプリケーション・サーバーへのデプロイについては、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

この章の内容は次のとおりです。

- 2.1項「ADFアプリケーションのデプロイの概要」

- 第2.2項「スタンドアロン・アプリケーション・サーバーのデプロイの準備」

- 第2.3項「Oracle Enterprise Manager Fusion Middleware Controlを使用したデプロイ」

- 第2.4項「スクリプト・コマンドを使用したデプロイ」

- 第2.5項「スクリプトおよびAntを使用したデプロイ」

- 第2.6項「アプリケーション・サーバー管理ツールを使用したデプロイ」

2.1 ADFアプリケーションのデプロイの概要

デプロイとは、アプリケーションのファイルおよび成果物をパッケージ化し、実行するターゲット・アプリケーション・サーバーに転送するプロセスです。JDeveloperを使用したアプリケーションのデプロイの際、開発者はJDeveloperインストールに組み込まれている統合WebLogic Serverを使用してアプリケーションをテストできます。または、JDeveloperを使用して直接スタンドアロン・アプリケーション・サーバーにデプロイすることもできます。

アプリケーションの開発が完了すると、管理者は本番のアプリケーション・サーバーにアプリケーションをデプロイできます。本番レベルのデプロイに使用するツールは次のとおりです。

- Oracle Enterprise Manager Fusion Middleware Control

- WebLogic Scripting Tool(WLST)コマンドまたはWebSphere Application Server(wsadmin)コマンド

- コマンド・スクリプトおよびAntスクリプト

- Oracle WebLogic管理コンソールまたはWebSphere管理コンソール

この章では、管理者がADFアプリケーションのデプロイに使用するツールおよびメソッドについて説明します。JDeveloperを使用した開発およびテストのためのADFアプリケーションのデプロイについては、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

アプリケーションでカスタマイズを使用している場合、アプリケーション・サーバー内のMDSリポジトリの設定が必要となることがあります。MDSの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

注意:

開発者、テストおよび品質保証担当者も、この章のツールおよびメソッドを使用して、ADFアプリケーションをステージング・アプリケーション・サーバーにデプロイできます。

2.2 スタンドアロン・アプリケーション・サーバーのデプロイの準備

ADFアプリケーションを実行するには、スタンドアロン・アプリケーション・サーバーをADFランタイムとともにインストールする必要があります。ADFランタイムは、アプリケーション・サーバーの新規インストール時に組み込むことも、既存のアプリケーション・サーバーのインストール先にインストールすることもできます。

図2-1に、スタンドアロン・アプリケーション・サーバーのデプロイの準備のフロー・ダイアグラムを示します。ダイアグラムでは、次の定義が使用されます。

- OWSM: Oracle Web Services Manager

- JRF: Java Required Files

- RCU: リポジトリ作成ユーティリティ

- MDS: メタデータ・ストア

次のダイアグラムには、クリック可能なリンクが含まれています。

図2-1 アプリケーション・サーバーの準備のフロー・ダイアグラム

「図2-1 アプリケーション・サーバーの準備のフロー・ダイアグラム」の説明

WebLogic Serverの場合、次の点が該当します。

- WebLogic ServerにADFランタイムをインストールしたら、新しいWebLogic Serverドメインを作成するか、既存のWebLogic ServerドメインをOracle ADF用に拡張することができます。

- 管理対象サーバーが管理サーバーとは異なるホストに位置している場合、追加の構成タスクを実行して、管理対象サーバーがADFアプリケーションをホストできるようにする必要があります。

- ADFアプリケーションはJDBCデータ・ソースまたはJDBC URLを使用してデータにアクセスします。Oracle WebLogic Server管理コンソールを使用すれば、WebLogic Serverをデータ・ソースに対して構成できます。

WebSphere Application Serverの場合、次の点が該当します。

- WebSphere Application ServerにADFランタイムをインストールしたら、新しいWebSphereセルを作成するか、既存のWebSphereセルをADF用に拡張することができます。

- サーバーがデプロイメント・マネージャとは異なるノードに位置している場合、追加の構成タスクを実行して、サーバーがADFアプリケーションをホストできるようにする必要があります。

- ADFアプリケーションはJDBCデータ・ソースまたはJDBC URLを使用してデータにアクセスします。WebSphere管理コンソールを使用して、WebSphere Application Serverをデータ・ソースとともに構成できます。

2.2.1アプリケーション・サーバー・インストールへのADFランタイムのインストール方法

アプリケーション・サーバーは、ADFアプリケーションを実行するために、ADFランタイムを必要とします。

JDeveloperを使用して、統合WebLogic Serverでアプリケーションを実行する場合、ADFランタイムをインストールする必要はありません。

WebLogic Serverの場合、ADFランタイムは、次のインストーラを使用してインストールできます。

- Oracle Fusion Middleware 11g Application Developer Installer: ADFランタイムとOracle Enterprise Managerがインストールされます。Oracle Enterprise Managerを使用してスタンドアロンのADFアプリケーション(Oracle SOA SuiteやOracle WebCenterのコンポーネントを使用しない)を管理する場合は、Oracle Fusion Middleware 11g Application Developer Installerを使用してください。このインストーラを使用するには、Oracle WebLogic Serverがすでにインストールされている必要があります。

注意:

アプリケーション・サーバー・インストールへのADFランタイムのインストールには、Oracle 11g Installer for JDeveloperも使用できます。ただし、これには通常本番およびフル・テスト環境に必要なコンポーネントがすべて含まれているわけではありません。したがって、このインストーラは開発目的以外では使用しないでください。

WebSphere Application Serverの場合、ADFランタイムは、次のインストーラを使用してインストールできます。

- Oracle Fusion Middleware 11g Application Developer Installer: ADFランタイムとOracle Enterprise Managerがインストールされます。このインストーラを使用するには、WebSphere Application Serverがすでにインストールされている必要があります。詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

2.2.1.1 Oracle Fusion Middleware Application Developer Installerを使用して既存のWebLogic Serverのインストール先にADFランタイムをインストール

Oracle Fusion Middleware 11g Application Developer Installerを使用して、ADFランタイムとEnterprise Managerをインストールできます。

Oracle WebLogic Serverをインストールします。Oracle Fusion Middleware 11g Application Developer Installerを入手しておくことも必要です。

『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』の説明に従ってソフトウェアを取得し、インストーラを起動し、インストールを完了します。

インストーラでは、次のタスクを含むいくつかのタスクを実行します。

- ソフトウェア更新の追加

- インストールのためのWebLogic Serverディレクトリの選択

- インストール情報の検証

ADFランタイムをインストールしたら、2.2.2項「Oracle WebLogic Serverドメインの作成および拡張方法」の説明に従って、Oracle Fusion Middleware構成ウィザードを使用してOracle WebLogic Serverドメインを作成または拡張します。

2.2.1.2 Oracle Fusion Middleware Application Developer Installerを使用して既存のWebSphere Application Serverのインストール先にADFランタイムをインストール

Oracle Fusion Middleware 11g Application Developer Installerを使用して、ADFランタイムとEnterprise Managerをインストールできます。

開始する前に、WebSphere Application Serverインストールが存在している必要があります。

『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』の説明に従ってソフトウェアを取得し、インストーラを起動します。

インストーラでは、次のタスクを含むいくつかのタスクを実行します。

- ソフトウェア更新の追加

- インストールのためのWebSphereディレクトリの選択

- インストール情報の検証

ADFランタイムをインストールした後、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドおよびOracle Fusion Middleware WebSphere構成ガイドの手順に従って、セルを構成し、その他のタスクを実行します。

2.2.2 Oracle WebLogic Serverドメインの作成および拡張方法

ADFアプリケーションを使用するには、Oracle WebLogic Serverドメインを作成し、構成する必要があります。ドメインがまだない場合は、作成する必要があります。すでにドメインがある場合、ドメインを拡張して、ADFアプリケーションを実行できるようにする必要があります。

管理対象サーバーを使用してアプリケーションを実行する場合、管理対象サーバーの構成が必要になることがあります。Oracle WebLogic Server上での管理対象サーバーの構成の詳細は、『Oracle Fusion Middleware構成ウィザードによるドメインの作成』を参照してください。

管理対象サーバーが管理サーバーと同じホストに位置している場合に、ADF用に管理対象サーバーを設定するには、この項で説明する手順に従います。

管理サーバーとは異なるホストに位置する管理対象サーバーにデプロイするための設定を行う場合は、第2.2.2.3項「Oracle ADF用のリモートWebLogic管理対象サーバーの設定」の説明に従って追加のステップを実行します。

2.2.2.1 Oracle ADF用のOracle WebLogic Serverドメインの作成

Oracle WebLogic Serverドメインがまだ存在しない場合は、作成する必要があります。

新しいOracle WebLogic Serverドメインを作成する手順:

1. 『Oracle Fusion Middleware Application Developerインストレーション・ガイド』の「Application Developerの構成」の説明のとおり、Oracle Fusion Middleware構成ウィザードを起動します。
このガイドの指示に従いますが、次の手順を考慮してください。

2. 「ようこそ」ページで「新規WebLogicドメインの作成」を選択し、「次へ」をクリックします。

3. 「ドメイン・ソースの選択」ページで、「以下の製品をサポートするために、自動的に構成されたドメインを生成する」を選択します。
オプション「基本WebLogic Serverドメイン(必須)」がすでに選択されています。

Oracle JRFを選択します。Oracle Web Servicesを使用している場合は、Oracle WSMポリシー・マネージャを選択し、「次へ」をクリックします。

2.2.2.2 Oracle ADF用のOracle WebLogic Serverドメインの拡張

事前作業:

既存のOracle WebLogic ServerドメインにADFランタイムがすでにインストールされている必要があります。

ADF用にOracle WebLogic Serverドメインを拡張する手順:

1. 『Oracle Fusion Middleware Application Developerインストレーション・ガイド』の「Application Developerの構成」の説明のとおり、Oracle Fusion Middleware構成ウィザードを起動します。
このガイドの指示に従いますが、次の手順を考慮してください。

2. 「ようこそ」ページで、「既存のWebLogicドメインの拡張」を選択し、「次へ」をクリックします。

3. 「WebLogicドメイン・ディレクトリの選択」ページで、ADF用に構成するドメインの場所を選択し、「次へ」をクリックします。

4. 拡張ソースの選択ページで、「以下の追加製品をサポートするために、自動的にドメインを拡張する:」を選択します。
オプション「基本WebLogic Serverドメイン(必須)」がすでに選択されています。

Oracle JRFを選択します。Oracle Web Servicesを使用している場合は、Oracle WSMポリシー・マネージャを選択し、「次へ」をクリックします。

これにより、manifestファイルを使用して、その他のランタイム.jarファイルが構成されます。

注意:

アプリケーションのEARファイルには、adf.oracle.domain共有ライブラリへの参照を含むweblogic-application.xmlファイルがある必要があります。

これで、コマンドライン・スクリプトORACLE_HOME\user_projects\domains\domain_name\bin\startWebLogic.cmdを実行してOracle WebLogic Serverを起動したり、同じディレクトリでstopWebLogic.cmdスクリプトを使用してサーバーを停止したりできます。Linuxプラットフォームでは、\bin\startWebLogic.shとstopWebLogic.shをそれぞれ使用します。

Oracle WebLogic Server管理コンソールにアクセスするには、URL http://localhost:7001/consoleを使用します。

2.2.2.3 Oracle ADF用のリモートWebLogic管理対象サーバーの設定

WebLogic管理対象サーバーが管理サーバーとは異なるホストに位置している場合、追加のステップを実行する必要があります。

管理サーバーの位置するホストでOracle ADF用に管理対象サーバーを設定してから、JRFテンプレートを圧縮してリモート・ホストにコピーし、解凍する必要があります。

Oracle ADF用にリモート管理対象サーバーを設定する手順:

1. Oracle Installer for JDeveloperを使用して、ローカルとリモート両方のホストにOracle WebLogic Serverをインストールします(まだインストールしていない場合)。JDeveloper Studioをインストールしない場合は、インストーラでApplication Development Frameworkランタイム・オプションを選択する必要があります。ローカル・ホストは、管理サーバーが位置するホストです。
Weblogic Serverがすでにインストールされている場合は、Oracle Installer for JDeveloperを使用し、Application Development Frameworkランタイム・オプションを選択して、両方のホストのWebLogic Serverインストール先にADFランタイムをインストールします。インストールの詳細は、第2.2.1項「アプリケーション・サーバー・インストールへのADFランタイムのインストール方法」を参照してください。

2. Oracle Fusion Middleware構成ウィザードを実行して、新しいOracle WebLogic Serverドメインを作成します。ウィザードでは、2.2.2.1項「Oracle ADF用のOracle WebLogic Serverドメインの作成」の説明に従って、「Oracle JRF」オプションを選択します。

3. ローカル・ホストでOracle Fusion Middleware構成ウィザードを実行して、管理対象サーバーを作成します。

4. ローカル・ホストで、管理サーバーと管理対象サーバーを起動します。
次に例を示します。

cd ORACLE_HOME/user_projects/domain/base_domain/bin
./startWeblogic.sh
./startManagedWebLogic.sh ManagedServer_1 http://localhost:7001

5. ローカル・ホストで管理対象サーバーの構成情報をJARに圧縮し、そのJARをリモート・ホストにコピーします。このJARには、JRFテンプレート情報が含まれます。
次に例を示します。

cd ORACLE_HOME/oracle_home/common/bin

./pack.sh -managed=true -domain=../../../user_projects/domains/base_domain
-template=../../../base_domain_managed.jar -template_name=
"Base Managed Server Domain"

cp ../../../base_domain_managed.jar remote_machine_ORACLE_HOME/

6. リモート・ホストで、管理対象サーバーの構成JARを解凍します。
次に例を示します。

cd ORACLE_HOME/oracle_common/common/bin
./unpack.sh -domain=../../../user_projects/domains/base_domain
-template=../../../base_domain_managed.jar

管理対象サーバーがドメインより後に作成された場合は、unpackを実行する前に、管理対象サーバーのドメイン構成ディレクトリ全体を削除する必要があります。

7. リモート・ホストで、ノード・マネージャを起動します。
次に例を示します。

cd ORACLE_HOME/wlserver_10.3/server/bin
./startNodeManager.sh

8. 管理対象サーバーの作成時にJRFテンプレートを適用しなかった場合は、リモート・ホストでapplyJRF WLSTコマンドを実行し、管理対象サーバーをJRFテンプレートで拡張します。
また、管理対象サーバーがドメインより後に作成された場合は、applyJRFを実行する前に、管理対象サーバーのドメイン構成ディレクトリ全体を削除する必要があります。

9. 両方のホストで、管理対象サーバーを起動します。
次に例を示します。

cd ORACLE_HOME/user_projects/domains/base_domain/bin./startManagedWebLogic.sh ManagedServer_2 http://<adminServerHost>:7001

2.2.3 Oracle WebLogic Server用のJDBCデータ・ソースの作成方法

Oracle WebLogic Server管理コンソールを使用して、使用しているアプリケーションのWebLogic Serverインスタンス内にJDBCデータ・ソースを設定します。

JDBCデータ・ソース用にOracle WebLogic Serverを構成する手順:

1. Windowsの「スタート」メニューから「Oracle Fusion Middleware」→「User Projects」→「Domain」→「Start Admin Server for WebLogic Server Domain」を選択して、Oracle WebLogic Serverを起動します(まだ起動していない場合)。
Linuxの場合は、rootユーザーとしてログインし、次の場所に移動します。

<ORACLE_HOME>/user_projects/domains/MYSOADomain/bin

次のコマンドを実行します。

./startWebLogic.sh

または、アプリケーション・サーバー・ナビゲータで、Oracle WebLogic Serverインスタンスを右クリックし、「管理コンソールの起動」を選択します。

2. Windowsの「スタート」メニューから「Oracle Fusion Middleware」→「User Projects」→「Domain」→「Admin Server Console」を選択して、Oracle WebLogic Server管理コンソールを起動します。

3. Oracle WebLogic Server管理コンソールにログインします。

4. 「WebLogic Server管理コンソール」ページで、「JDBC」→「データ・ソース」を選択します。

5. 「New」をクリックします。

6. JDBCデータ・ソースのプロパティ・ページで、次の作業を行います。

- 「名前」フィールドに、JDBCデータ・ソースの名前を入力します。

- 「JNDI」フィールドに、「jdbc/connection DS」という形式で接続名を入力します。

- 「データベースのタイプ」には、「Oracle」を選択します。

- 「データベース・ドライバ」には「Oracleドライバ(シン)」を選択し、「次へ」をクリックします。

7. トランザクション・オプションのページで、デフォルトのオプションをそのまま使用し、「次へ」をクリックします。

8. 接続プロパティのページで次の作業を行います。

- データベース名にOracle SIDを入力します。たとえば、orclと入力します。

- ホスト名にデータベースのマシン名を入力します。

- データベースにアクセスするために使用するポート番号を入力します。

- データベースのユーザー名とパスワードを入力して、「次へ」をクリックします。

9. データベース接続のテスト・ページで、「構成のテスト」をクリックして接続をテストします。

10. 「ターゲットの選択」ページで、JDBCデータ・ソースをデプロイするサーバーを選択します。

11. 「終了」をクリックします。

データ・ソースがOracle WebLogic Serverで作成されたら、アプリケーション・モジュールで使用できます。

2.2.4 IBM WebSphere Application ServerのJDBCデータ・ソースの作成方法

WebSphere Application ServerにJDBCデータソースを構成するには、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

2.3 Oracle Enterprise Manager Fusion Middleware Controlを使用したデプロイ

Oracle Enterprise Manager Fusion Middleware Controlを使用して、JDeveloperで作成されたEARファイルをデプロイできます。Fusion Middleware Controlは、ファームの監視および管理に使用できるWebブラウザベースのグラフィカル・ユーザー・インタフェースです。Fusion Middleware Controlを使用したデプロイの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

2.4 スクリプト・コマンドを使用したデプロイ

アプリケーションまたはモジュールは、JDeveloper IDEを起動せずにJDeveloperからデプロイできます。コマンドラインからWLSTコマンド(WebLogicの場合)またはwsadminコマンド(WebSphere Application Serverの場合)を実行することも、スクリプトにこれらを並べてバッチとして実行することもできます。

コマンドラインからデプロイするには、アプリケーションのデプロイメント・プロファイル(EAR)またはプロジェクトのデプロイメント・プロファイル(JARまたはWAR)が必要です。特定のタイプのアプリケーションの場合、JDeveloperはこれらのデプロイメント・プロファイルを自動的に作成しますが、デプロイのコマンドを使用する前に、デプロイメント・プロファイルが存在することを確認することが重要です。プロファイルが存在することを検証するには、JDeveloperの「アプリケーションのプロパティ」または「プロジェクト・プロパティ」から「デプロイメント」ノードを選択します。デプロイメント・プロファイルの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

JDeveloperは、アプリケーションのEAR、WARまたはJARファイルのデプロイにも使用できます。コマンドラインによるデプロイに使用するスクリプトと同じスクリプトを、JDeveloperによるデプロイでも使用しますが、JDeveloperでは構文を作成し、デプロイのためのユーザー・インタフェースを提供します。

ADFアプリケーションの処理に固有のWLSTコマンド(WebLogic)があります。これらのコマンドのリストは、第4章「ADFアプリケーションのためのWLSTコマンド・リファレンス」を参照してください。

WLSTスクリプトの使用の詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスを参照してください。

ADFアプリケーションの処理に固有のwsadminコマンド(WebSphere Application Server)があります。これらのコマンドのリストは、付録B「ADFアプリケーションのためのwsadminコマンド・リファレンス」を参照してください。

2.5 スクリプトおよびAntを使用したデプロイ

コマンドおよびスクリプトを使用してアプリケーションをデプロイできます。ojdeployコマンドを使用してアプリケーションをデプロイし、ojauditコマンドを使用してアプリケーションのプロジェクト、ワークスペースまたはソース・ファイルを監査するスクリプトを作成します。たとえば開発者が新しい変更をチェックインするたびに自動的に実行されるようにスクリプトを設定することもできます。

ojdeployスクリプトおよびAntスクリプトは、一緒に使用することも個別に使用することも可能です。

1. アプリケーションをコンパイル、パッケージ化およびデプロイするojdeployスクリプトを作成します。

2. アプリケーションをコンパイルおよびパッケージ化するojdeployスクリプトを作成します。その後、Antスクリプト(WLDeployなど)を使用してアプリケーションをデプロイします。

3. アプリケーションをコンパイル、パッケージ化およびデプロイするAntスクリプトを作成します。このAntではojdeployを使用する必要はありません。

ojdeployコマンドおよびojauditコマンドの詳細は、JDeveloperオンライン・ヘルプを参照してください。

JDeveloperからほとんどのアプリケーション・サーバーにデプロイできます。または、アプリケーション・サーバーのベンダーによって提供されるツールを使用することもできます。Antを使用して、アプリケーションをパッケージ化し、デプロイすることもできます。Antのデプロイメント・コマンドを含むbuild.xmlファイルは、ターゲット・アプリケーション・サーバーによって異なります。

他のアプリケーション・サーバーへのデプロイについては、アプリケーション・サーバーのマニュアルを参照してください。アプリケーション・サーバーが特定のAntタスクを提供していない場合は、汎用Antタスクを使用できる可能性があります。たとえば、汎用のearタスクによってEARファイルが作成されます。

Antの詳細は、http://ant.apache.orgを参照してください。

2.6 アプリケーション・サーバー管理ツールを使用したデプロイ

WebLogicの場合、Oracle WebLogic Server管理コンソールを使用して、JDeveloperで作成されたEARファイルをデプロイできます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

WebSphere Application Serverの場合、IBM WebSphere管理コンソールを使用して、JDeveloperで作成されたEARファイルをデプロイできます。詳細は、http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/com.ibm.websphere.home.doc/welcome.htmlにあるWebSphere Application Serverインフォメーション・センターを参照してください。

3 ADFアプリケーションの監視と構成

この章では、ADFアプリケーションのパフォーマンスの監視方法について説明します。さらに、Oracle WebLogic Serverへのデプロイ後にFusion Middleware Controlを使用してADFアプリケーションのプロパティを構成する方法についても説明します。また、IBM WebSphere Application Serverにデプロイされたアプリケーションに必要な構成タスクについても説明します。

この章の内容は次のとおりです。

- 第3.1項「ADFアプリケーションの監視と構成の概要」

- 第3.2項「Fusion Middleware Controlを使用したパフォーマンスの監視」

- 第3.3項「Fusion Middleware Controlを使用したアプリケーション・プロパティの構成」

- 第3.4項「MBeanブラウザを使用したアプリケーション・プロパティの構成」

- 第3.5項「アプリケーションとともにデプロイされた資格証明の編集方法」

- 第3.6項「診断フレームワークを使用した問題の診断」

- 第3.7項「DMS SPYによるアプリケーションのメトリック情報の表示」

- 第3.8項「WebSphere Application Serverの構成」

3.1 ADFアプリケーションの監視と構成の概要

ADFアプリケーションをOracle WebLogic Serverにデプロイすると、このサーバーでアプリケーションのパフォーマンスを監視したり、アプリケーションのプロパティを構成することができます。これらのタスクはEnterprise Manager Fusion Middleware Controlを使用して実行できます。

Enterprise Manager Fusion Middleware Controlは、パフォーマンス・タスクのユーザー・インタフェースを提供します。表3-1に示すように、一部の構成タスクはユーザー・インタフェースから実行することも、MBeanを構成して実行することもできます。

表3-1 Fusion Middleware Controlを使用した構成タスク

構成タスク

Fusion Middleware Control UI

Fusion Middleware Control MBeanブラウザ

ADFビジネス・コンポーネント

第3.3.1項「ADFビジネス・コンポーネント・パラメータの変更方法」

第3.4.3項「MBeanを使用したADFビジネス・コンポーネント構成の変更方法」

ADF接続

第3.3.2項「接続構成の変更方法」

第3.4.2項「MBeanを使用したADF接続の変更方法」

ADFアプリケーション構成

第3.4.1項「MBeanを使用したADFアプリケーション構成の変更方法」

メタデータ・サービス(MDS)

第3.4.4項「MBeanを使用したMDS構成の変更方法」

アクティブ・データ・サービス(ADS)

第3.4.5項「MBeanを使用したアクティブ・データ・サービス構成の変更方法」

デフォルトで、MBeanを使用して行われたデプロイ後の変更は、レイヤー名adfshareおよびレイヤー値adfshareでMDSに保存されます。特定のレイヤー名を指定するには、アプリケーションのadf-config.xmlでadfAppUIdプロパティを指定します。

例3-1に、adf-config.xml内のadf-properties-childコードを示します。

例3-1 adf-config.xmlファイルのMDSレイヤー

<adf:adf-properties-child xmlns="http://xmlns.oracle.com/adf/config/properties">
<adf-property name="adfAppUID" value="DeptApp.myApp"/>
</adf:adf-properties-child>

テスト・システムから本番システムへの移動などMDSリポジトリ間でデータを移動させる場合は、『Oracle Fusion Middleware管理者ガイド』のOracleメタデータ・リポジトリの管理に関する章、およびOracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのメタデータ・サービスのカスタムWLSTコマンドに関する章で説明しているように、MDSのexportMetadataコマンドおよびimportMetadataコマンドを使用します。

3.2 Fusion Middleware Controlを使用したパフォーマンスの監視

Enterprise Manager Fusion Middleware Controlを使用して、Oracle ADFアプリケーションのパフォーマンスを監視できます。

次のことが可能です。

- アプリケーション・モジュールのパフォーマンスの表示

- アプリケーション・モジュール・プールのパフォーマンスの表示

- タスク・フローのパフォーマンスの表示

3.2.1 アプリケーション・モジュールのパフォーマンスの表示方法

アプリケーション・モジュールに関するパフォーマンス情報を表示できます。アプリケーション・モジュール・コンポーネントを使用すると、複数のブラウザ・ページにまたがる作業ユニットをサポートできます。

事前作業:

Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。

ADFアプリケーション・モジュールのパフォーマンスを表示するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「ADF」→「ADFパフォーマンス」を選択します。
ADFパフォーマンス・ページが表示されます。ここには、アクティブなアプリケーション・モジュール・プールおよびタスク・フローに関するパフォーマンス情報を表示するサブタブが含まれます。

3.2.2 アプリケーション・モジュール・プールのパフォーマンスの表示方法

アプリケーション・モジュール・プールとは、複数のアプリケーション・クライアントによって共有される単一のアプリケーション・モジュール・タイプのインスタンスの集合です。1つのアプリケーション・モジュール・プールは、ADF Webアプリケーション(ADFビジネス・コンポーネント、ADF ControllerまたはADF Faces)が使用する各ルート・アプリケーション・モジュールごとに、各Java仮想マシンで作成されます。各Java仮想マシンでは、そのタイプのルート・アプリケーション・モジュールがADFコントローラ・レイヤーによって使用されます。

事前作業:

Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。

アプリケーション・モジュールのプーリング・パフォーマンスを表示するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「ADF」→「ADFパフォーマンス」を選択します。
ADFパフォーマンス・ページが表示されます。ここには、アクティブなアプリケーション・モジュール・プールおよびタスク・フローに関するパフォーマンス情報を表示するサブタブが含まれます。

6. 「アプリケーション・モジュール・プール」タブをクリックします。

7. 「モジュール」列で、アプリケーション・モジュールを選択すると、「アプリケーション・モジュール・プール」表にその詳細が表示されます。
アプリケーションが実行されていない場合は、「モジュール」列に「使用可能なデータがありません」が表示されます。

8. モジュールをクリックすると、そのモジュールに関して、存続期間、状態の管理、プール使用およびアプリケーション・モジュール・プール・ページなどの詳細情報が表示されます。
アプリケーション・モジュール・プール・ページを使用して、アクティブなアプリケーション・モジュール・プールを表示します。アプリケーション・モジュール・プールは、同じタイプのアプリケーション・モジュール・インスタンスの集合です。アプリケーション・モジュール・プール・ページで、次の操作を行います。

- プール接続に関するサイズおよびパフォーマンスの情報の表示

- アプリケーション・モジュール・プールの動作に影響を与える設定の指定

- アプリケーション・モジュール・プールの資格証明情報の指定

要素

説明

モジュール

アクティブなアプリケーション・モジュール・プール名(例: model.BugTest5PM)が表示されます。

モジュールをクリックすると、そのモジュールに関して、「存続期間」、「状態の管理」、「プール使用」、「アプリケーション・モジュール・プール」などの詳細情報が表示されます。

リクエスト

選択した期間にアプリケーションに対して行われたリクエストの数が表示されます。

平均作成時間(ミリ秒)

アプリケーション・モジュール・プールに対するリクエストの完了に必要となる平均時間(ミリ秒)が表示されます。

最大作成時間(ミリ秒)

アプリケーション・モジュール・プールに対するリクエストの完了に必要となる最長時間(ミリ秒)が表示されます。

空きインスタンス

アプリケーション・モジュール・プールのインスタンスの平均数が表示されます。

3.2.3 ADFタスク・フローのパフォーマンスの表示方法

タスク・フローに関するパフォーマンス情報を表示できます。タスク・フローでは、ナビゲーションおよびアプリケーション制御へのモジュールおよびトランザクション方式のアプローチが提供されます。ほとんどの場合、タスク・フローには各種ページが表示されますが、マネージドBeanのメソッドのコール、EL式の評価または別のタスク・フローのコールを実行するアクティビティも表示され、これらは特定のページを開かなくても実行できます。

事前作業:

Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。

タスク・フローのパフォーマンスを表示するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「ADF」→「ADFパフォーマンス」を選択します。
ADFパフォーマンス・ページが表示されます。ここには、アクティブなアプリケーション・モジュール・プールおよびタスク・フローに関するパフォーマンス情報を表示するサブタブが含まれます。

6. 「タスク・フロー」タブをクリックします。
デフォルトでは、タブ上のタスク・フロー・パフォーマンスのグラフに、直近の15分間のデータが表示されます。別の間隔を設定するには、ページにある時間をクリックするか、またはスライダを別の間隔に移動(例: 午前8時から午前8時半までに移動)できます。

7. TFグラフをクリックします。

- 「リクエスト処理時間」には、選択した期間に実行するすべてのADFタスク・フローの平均リクエスト処理時間が表示されます。

- 「アクティブ・タスクフロー」には、選択した期間の各ADFタスク・フローのアクティブなインスタンスの数が表示されます。

3.3 Fusion Middleware Controlを使用したアプリケーション・プロパティの構成

Enterprise Manager Fusion Middleware Controlを使用して、ADFアプリケーションの構成パラメータを構成できます。構成パラメータは、ADF MBeanに格納されます。Fusion Middleware Controlは、ADFビジネス・コンポーネントおよびADF接続MBeanを構成するためのユーザー・インタフェースを提供します。システムMBeanブラウザを使用して、直接基礎となるMBeanにアクセスし、その値を構成することもできます。基礎となるMBeanへのアクセスの詳細は、第3.4項「MBeanブラウザを使用したアプリケーション・プロパティの構成」を参照してください。

Fusion Middleware Controlでは、次の処理を実行するためのユーザー・インタフェースを提供します。

- ADFビジネス・コンポーネント・パラメータの構成

- 接続パラメータの構成

3.3.1 ADFビジネス・コンポーネント・パラメータの変更方法

アプリケーション・モジュール・プールの実行時動作は、適切な構成パラメータの設定により制御します。Fusion Middleware Controlは、ここで説明するとおり、ADFビジネス・コンポーネントを構成するためのUIを提供します。第3.4.3項「MBeanを使用したADFビジネス・コンポーネント構成の変更方法」で示すように、汎用のMBeanブラウザを使用して、直接ADFビジネス・コンポーネント MBeanを構成することもできます。

事前作業:

Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。

ビジネス・コンポーネント・パラメータを変更するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「ADF」→「ADFビジネス・コンポーネントの構成」を選択します。

6. 「アプリケーション・モジュール」をクリックします。

7. 「プーリングおよびスケーラビリティ」、「コア」、「データベース」または「セキュリティ」タブをクリックし、構成パラメータを更新します。
アプリケーション・モジュールにデータソースが使用される場合、「コア」タブの「データソースの編集」をクリックすることにより、データソースを構成できます。

ADFビジネス・コンポーネントの構成ページは、次のセクションまたはタブで構成されます。

- 「アプリケーション・モジュール」セクション

- 「プーリングおよびスケーラビリティ」タブ - 「アプリケーション・プール・プロパティ」

- 「プーリングおよびスケーラビリティ」タブ - 「接続プール・プロパティ」

- 「コア」タブ

- 「データベース・プロパティ」タブ

- 「セキュリティ・プロパティ」タブ

「アプリケーション・モジュール」セクション

「アプリケーション・モジュール」セクションで、構成するアプリケーション・モジュールを選択します。

要素

説明

アプリケーション・モジュール

アクティブなアプリケーション・モジュール名が表示されます。モジュール名をクリックすると、モジュール内のアプリケーションが表示されます。

「プーリングおよびスケーラビリティ」タブ - 「アプリケーション・プール・プロパティ」

「プーリングおよびスケーラビリティ」タブで、構成するアプリケーション・プール・プロパティを選択します。

要素

説明

AmpoolDoampooling

デフォルトでアプリケーション・モジュール・プーリングを有効化する場合に、選択します。アプリケーションを本番環境にデプロイするときは常に、jbo.ampool.doampoolingをデフォルト設定のtrueにしてアプリケーションを実行します。ただし、テスト環境でアプリケーションを実行するかぎり、テストでは、このプロパティをfalseに設定することで重要な役割を果せます。このプロパティがfalseの場合、実質的にアプリケーション・プールはありません。

AmpoolWritecookietoclient

SessionCookie値をクライアント・ブラウザに書き込む場合に選択します。

AmpoolMaxavailablesize

アプリケーション・プールで参照される使用可能なアプリケーション・モジュールの最大数を入力します。これは、ロードが異常ではない場合に、プールで使用可能なアプリケーション・モジュール・インスタンスの理想的な最大数です。リソースのクリーンアップを実行するためにプールの監視が起動すると、使用可能なアプリケーション・モジュール・インスタンスを削除して、この理想の最大数にまで使用可能なインスタンスの数を下げようと試行されます。アイドル・インスタンス・タイムアウトより長い間使用されていないインスタンスは、この時点でクリーンアップされます。その後、使用可能なインスタンス数をこのサイズまで下げる必要がある場合は、使用可能なインスタンスがさらに削除されます。デフォルトの最大使用可能サイズは25インスタンスです。この値を構成すると、リソース・クリーンアップ後に、指定した最大数の使用可能インスタンスを残すことができます。一般に、値を低くすると、クリーンアップの際にプールから削除されるアプリケーション・モジュール・インスタンスの数が増えます。

AmpoolSessioncookiefactoryclass

カスタムのセッションCookieのファクトリ実装を入力します。このクラスにより、クライアントがステートフル・モードのアプリケーション・モジュールを取得するためのセッションCookieが作成されます。

AmpoolMaxinactiveage

アプリケーション・モジュールをプールから削除する前に非アクティブのまま保持する最大時間(ミリ秒)を入力します。

デフォルト値は、600000ミリ秒(600秒または10分)です。値を低くすると、次回のリソースのクリーンアップで削除する候補としてマークされるアプリケーション・モジュール・インスタンスの数が増えます。値を高くすると、次回のリソースのクリーンアップで削除する候補としてマークされるアプリケーション・モジュール・インスタンスの数が減ります。

AmpoolMinavailablesize

アプリケーション・プールで参照される使用可能なアプリケーション・モジュールの最小数を入力します。これは、リソースのクリーンアップ操作時にプール監視でプールに残す使用可能なアプリケーション・モジュール・インスタンスの最小数です。すべてのインスタンスがクリーンアップ後にアイドル・タイムアウトより長い時間アイドル状態である場合に、含まれるインスタンス数が0になるようプールを縮小するには、0(ゼロ)に設定します。デフォルトは5インスタンスです。

Doconnectionpooling

アプリケーション・プールがチェックイン時にアプリケーション・モジュール接続をリリースするかどうか選択します。これにより、アプリケーション・モジュールがプールにリリースされる際に使用されるJDBC接続を、アプリケーション・モジュール・プールがリリースするよう設定されます。

Recyclethreshold

セッションで作成される次回のリクエストに対するセッション・アフィニティを保持するプール内のアプリケーション・モジュール・インスタンスの最大数を入力します。このセッションは、管理対象状態モードでプールにリリースされる直前に使用されたものです。

AmpoolConnectionstrategyclass

カスタムの接続方法の実装を入力します。たとえば、oracle.jbo.common.ampool.DefaultConnectionStrategyです。これは、接続方法を実装するクラスです。

Maxpoolcookieage

プール状態のアプリケーション・モジュール・セッションに対するブラウザCookieの最大時間を入力します。これは、クライアントがステートフル・アプリケーション・モジュールを取得するために使用できるブラウザのCookieの最大有効時間です。これらのCookieがタイムアウトにならない場合、値は-1です。Cookieの最大時間は必ずセッションCookieの有効時間以下に設定することをお薦めします。デフォルトでそのように設定されています(両方-1)。Cookieの最大時間を変更する場合、セッションCookieの有効時間も同じ値に変更する必要があります。

AmpoolInitpoolsize

プールに作成されるアプリケーション・モジュール・インスタンスの初期数を入力します。これは、プールが初期化される際に作成されるアプリケーション・モジュール・インスタンスの数です。デフォルトは、ゼロ(0)インスタンスです。一般的なガイドラインとして、すべてのユーザーにサービスを実行するために必要とされる同時アプリケーション・モジュール・インスタンス数より10%多く構成してください。初期化時にアプリケーション・モジュール・インスタンスを作成すると、追加のアプリケーション・モジュール・インスタンスが必要となったときにオンデマンドで作成するよりも、アプリケーション・モジュール・インスタンスを作成するCPU処理量が多くなります。

AmpoolDynamicjdbccredentials

アプリケーション・プールが複数のJDBCユーザーをサポートするかどうかを選択します。このプロパティは追加のプーリング・ライフサイクル・イベントを有効にし、新しいユーザーセッションが開始されるたびに開発者が作成したコードを使用してデータベースの資格情報(ユーザー名およびパスワード)を変更して、アプリケーション・モジュールを使用できるようにします。この機能はデフォルトで有効(true)です。ただし、この機能の実現にこの設定は必須ではありますが、これで十分ではありません。機能を実装するための十分な条件が必要で、追加の開発者作成のコードが必要となります。

AmpoolIsuseexclusive

アプリケーション・モジュールの使用が排他的である場合に選択します。

AmpoolResetnontransactionalstate

管理対象外チェックイン時に非トランザクション・アプリケーション・モジュールの状態をリセットする場合に選択します。アプリケーション・モジュールが非管理モード、すなわち「ステートレス」モードプールに解放されたとき、ビュー・オブジェクトのランタイム設定、JDBCプリコンパイル文、バインド変数値のような非トランザクション状態をすべてリセットするように強制します。この機能はデフォルトで有効化されています(true)。この機能を無効化すると、パフォーマンスが向上しますが、バインド変数値がクリアされないため、アプリケーションで体系的にバインド変数値を正しく設定する必要があります。アプリケーションでこのように設定していない場合、この機能は無効となり、ユーザーが別のユーザーのバインド変数値のデータを見ることが可能となってしまいます。

AmpoolMaxpoolsize

プールが割り当てるアプリケーション・モジュール・インスタンスの最大数を入力します。プールでは、この制限値以上のアプリケーション・モジュール・インスタンスは作成されません。デフォルトは5000インスタンスです。一般的なガイドラインとして、この値は、さらなる増加分を見込んで初期プール・サイズより20%大きな値に構成してください。設定値が低すぎると、利用できるアプリケーション・モジュール・インスタンスがないときにアプリケーションにアクセスを試みた場合、エラーが発生することがあります。

AmpoolTimetolive

接続インスタンスの接続プールの存続時間を入力します。これは、プール内のインスタンス数がminavailablesize以下であるかどうかにかかわらず、プール内のアプリケーション・モジュール・インスタンスが、次のリソース・クリーンアップ時に削除候補とみなされてからの時間(ミリ秒)です。デフォルトは、合計存続時間3600000ミリ秒(3600秒、つまり1時間)です。大部分のアプリケーションには、デフォルト値で十分です。

AmpoolMonitorsleepinterval

プール・リソース・クリーンアップ間の時間(ミリ秒)を入力します。

Dofailover

アプリケーション・モジュール・プールへのチェックイン時にフェイルオーバーが発生するかどうかを選択します。この機能により、アプリケーション・モジュールが状態管理モードでプールに解放されるたびに、保留中のトランザクション状態の積極的な非アクティブ化が有効になります。Webアプリケーションは、フェイルオーバーを有効(true)に設定し、その他のアプリケーション・モジュールの状態を常時アクティブにする必要があります。この機能はデフォルトでは無効(false)です。

ベスト・プラクティス: アプリケーション・モジュール状態の非アクティブ化を有効にしている場合は、接続を強制的にプールに復帰させるようにOracle WebLogic Serverを構成していると障害が発生することがあります。このような障害によって、SQLException (Connection has already been closed)が生成されます。この例外はサーバー・ログに保存されます。この例外は、ユーザー・インタフェースを介して報告されません。確実に状態の非アクティブ化を実行し、ユーザーの変更を保存するには、weblogic-application.xmlデプロイメント・ディスクリプタの要素<connection-check-params> pool-paramsにあるパラメータinactive-connection-timeout-secondsに適切な値を設定します。多くの場合、デプロイメント・ディスクリプタのパラメータを数分に設定すると、非アクティブ接続タイムアウトが強制され非アクティブ化の失敗が回避されます。ご使用の環境に合わせて、この設定値を調整してください。

poolClassName

カスタムのアプリケーション・プール実装クラスを入力します。

接続プール・プロパティの表示

現在の拡張接続プール・プロパティを含むフィールドを表示するか、またはフィールドに新しい値を入力する場合に展開します。

接続プール・プロパティの非表示

すべての「接続プール・プロパティ」フィールドを非表示にする場合に、クリックします。

「プーリングおよびスケーラビリティ」タブ - 「接続プール・プロパティ」

「プーリングおよびスケーラビリティ」タブで、構成する接続プール・プロパティを選択します。

要素

説明

Initpoolsize

JDBC接続プールの初期サイズを入力します。これは、プールが初期化される際に作成されるJDBCの接続インスタンスの数です。

デフォルトの初期サイズは0インスタンスです。

Maxpoolsize

JDBC接続プールの最大サイズを入力します。これは、プールによって割り当てられる最大のJDBCの接続インスタンスの数です。この限界値を超える数のJDBC接続がプールによって作成されることはありません。

デフォルトは、5000インスタンスです。

Poolmaxinactiveage

接続をプールから削除する前に非アクティブのまま保持する最大時間(ミリ秒)を入力します。これは、次回のリソース・クリーンアップ時に削除対象の非アクティブなアプリケーション・モジュール・インスタンスとしてみなされる期間です。

デフォルト値は、600000ミリ秒(600秒または10分)です。値を低くすると、次回のリソースのクリーンアップで削除する候補としてマークされるアプリケーション・モジュール・インスタンスの数が増えます。値を高くすると、次回のリソースのクリーンアップで削除する候補としてマークされるアプリケーション・モジュール・インスタンスの数が減ります。

Poolmaxavailablesize

接続プールで参照される使用可能な接続の最大数を入力します。これは、ロードが異常ではない場合に、プールで使用可能なJDBC接続インスタンスの理想的な最大数です。

リソースのクリーンアップを実行するためにプールの監視が起動すると、使用可能なJDBC接続インスタンスを削除して、この理想の最大数にまで使用可能なインスタンスの数を下げようと試行されます。アイドル・インスタンス・タイムアウトより長い間使用されていないインスタンスは、この時点でクリーンアップされます。その後、使用可能なインスタンス数をこのサイズまで下げる必要がある場合は、使用可能なインスタンスがさらに削除されます。

デフォルトの最大使用可能サイズは25インスタンスです(ロードが発生していない場合)。

Poolrequesttimeout

JDBC接続が接続プールにリリースされるまで、リクエストが待機する時間(ミリ秒)を入力します。

Poolminavailablesize

接続プールで参照される使用可能な接続の最小数を入力します。これは、リソースのクリーンアップ操作時に、プール監視でプールに残す使用可能なJDBC接続インスタンスの最小数です。

インスタンスがアイドル・タイムアウトより長い期間アイドルである場合に、プールにインスタンスが1つも含まれないようにするには、ゼロ(0)を設定します。

デフォルトでは、使用可能な最小サイズは5インスタンス以下にできない設定になっています。

Poolmonitorsleepinterval

プール・チェック間に接続プール監視がスリープする時間(ミリ秒)を入力します。これは、プールのリソース・クリーンアップ間の長さ(ミリ秒)です。

プール内のアプリケーション・モジュール・インスタンスの数が最大プール・サイズを超えないかぎり、プールから削除される候補のインスタンスは、アプリケーション・モジュール・プール・モニターが次回ウェイクアップしてそのジョブを実行するまで、クリーンアップされることはありません。

ConnectionPoolManager

使用される接続プール・マネージャの実装を入力します。

Pooltimetolive

アプリケーション・モジュール・インスタンスのアプリケーション・プールの存続時間(ミリ秒単位)を入力します。

「コア」タブ

「コア」タブを使用して、アプリケーション・モジュールのコア・プロパティを表示または編集します。

要素

説明

DefaultLanguage

ロケールの一部である、ビジネス・コンポーネント・セッションのデフォルト言語を入力します。

Passivationstore

アプリケーション・モジュールの非アクティブ化に使用されるストア、ファイルまたはデータベース・ファイルのいずれかのタイプを入力します。

databaseは、デフォルトの選択です。ファイルへの受動化より少し遅くなる場合がありますが、信頼性ははるかに優れています。

fileを選択すると、データベースへのアクセスよりファイルへのアクセスの方が高速なため、パフォーマンスが早くなります。

デフォルトの国

ロケールの一部である、ビジネス・コンポーネント・セッションのデフォルトの国を入力します。

AssocConsistent

エンティティ行セット・アソシエーションに一貫性を持たせるかどうか選択します。

XmlValidation

XMLパーサーに対する検証モードを決定する場合に選択します。選択すると、XMLパーサーでは厳密なXML検証を使用します。

DatabaseConfig

データベースの構成。

名前

アプリケーション・モジュール名を入力します。

OracleSchema

ビジネス・コンポーネント・ランタイム・ライブラリがデプロイされるスキーマの名前を入力します。

アドバンスト・プロパティの表示

現在の拡張コア・プロパティを含むフィールドを表示するか、またはフィールドに新しい値を入力する場合に展開します。

PersMaxRowsPerNode

ビュー行の自動書出し用のノードの最大サイズを入力します。

PassivationTrackInsert

選択すると、アプリケーション・モジュールがアクティブになると、非アクティブのときにデータベースに挿入された行を含むよう、アプリケーション・モジュールが更新されます。

ApplicationPath

EJBデプロイの場合、ビジネス・コンポーネントへのJNDIパスを入力します。

ViewlinkConsistent

選択すると、ビュー・リンク・アクセッサにより取得されたビュー・オブジェクト行セットには、変更がデータベースにポストされていない場合でも、追加された行が含まれます。

ConnectionMode

以前VisiBrokerへのデプロイメント用に使用されていた、推奨されないプロパティ。VisiBrokerデプロイメントは現在サポートされていません。

Maxpassivationstacksize

非アクティブ化スタックの最大サイズ(デフォルトは10)を入力します。

TxnHandleafterpostexc

コミット操作を開始する前に、ADFビジネス・コンポーネントでトランザクションのスナップショットを取得する場合に選択します。データベースに変更がポストされた後例外がスローされると、ADFビジネス・コンポーネントはこのスナップショットを使用して、アプリケーション・モジュールのメモリー状態をコミット操作が開始される前の時点へロールバックします。

SnapshotstoreUndo

UNDOスナップショットのターゲット{一時|永続}を入力します。

プロジェクト

Factory-Substitution-Listが空でない場合、ベース・ビジネス・コンポーネントのかわりとなる拡張ビジネス・コンポーネントを含むプロジェクトの名前を入力します。

Tmpdir

一時Oracle ADFビジネス・コンポーネント・ファイルのディレクトリを入力します。

DeployPlatform

デプロイ・プラットフォーム: LOCAL、EJB_IAS(Oracle Application ServerにデプロイされたEJB用)、またはWLS(Oracle WebLogic ServerにデプロイされたEJB用)

PersMaxActiveNodes

ビュー行の自動書出し用にメモリーにキャッシュされる最大ノード数を入力します。

Saveforlater

「トランザクション存続期間のスナップショットの保存」を選択します。

ViewCriteriaAdapter

ビュー・オブジェクトがビュー基準とビュー・オブジェクトのSQL間の変換に使用するカスタム・クラスを入力します。

Connectfailover

ビジネス・コンポーネントの透過的JDBC接続フェイルオーバーを選択します。

アドバンスト・プロパティの非表示

すべての「接続プール・プロパティ」フィールドを非表示にする場合に、クリックします。

「データベース・プロパティ」タブ

接続情報としてJDBC URLを使用しADFデータベース接続プールを使用する場合は、ここの構成パラメータを使用すると、データベース接続プールの動作をチューニングできます。

要素

説明

MaxCursors

セッションで使用されるカーソルの最大数を入力します。これは、ビジネス・コンポーネントで開くことのできるカーソルの最大数です。カーソル数がこの数値に近づくと、フレームワークでは空のJDBC文がクリーンアップされます。

Sql92DbTimeQuery

データベース・システム時間のSQL問合せ文字列を入力します。

SQLBuilder

SQLBuilderの実装(Oracle、OLite、DB2、または他のSQL92準拠データベースの場合はSQL92)を入力します。

Sql92LockTrailer

ロックするSQL文のトレーラ句を入力します。

JdbcTrace

+ PropertyConstants.JDBC_MARKER +でマークされている行のすべてのJDBCアクティビティをトレースする場合に選択します。

oracleDefineColumnLength

すべてのJDBC CHARまたはVARCHAR2列に対する列の長さを入力します。列の精度をバイト数で設定する場合、as_bytesを使用します。列の精度を文字数で設定する場合、as_charsを使用します。これは、Unicodeなどのサイズの大きなキャラクタ・セットには重要です。

Sql92JdbcDriverClass

sun.jdbc.odbc.JdbcOdbcDriverなどの、JDBCドライバを実装するクラスの名前を入力します。

TypeMapEntries

型マップ実装を入力します。これにより、Java型とSQL型とのカスタム型マップが指定されます。

ControlTableName

永続コレクションの制御表名を入力します。

FetchMode

ビュー・オブジェクトの制御フェッチ動作を入力します(+ PropertyConstants.ENV_FETCH_AS_NEEDED + "|" + PropertyConstants.ENV_FETCH_ALL + )。

AS.NEEDEDに設定すると、要求があった場合にのみ行がビュー・オブジェクトにフェッチされます。ALLに設定すると、問合せの結果全体がフェッチされます。

LockingMode

アプリケーション・モジュールのデフォルトのロック・モードを入力します。アプリケーション・モジュールがプールに解放されるたびに、アプリケーション・モジュール・プールが、行レベル・ロックを使用しているデータベース上にトランザクション保留中の状態を作らないようにします。Fusion Webアプリケーションでは、行レベルのロックの作成を回避するためにロック・モードをoptimisticに設定する必要があります。

JdbcBytesConversion

JDBCのデフォルトのバイト変換を使用するのか、フレームワーク内でこのような変換を実行するのかを示します。

アドバンスト・プロパティの表示

現在の拡張データベース・プロパティを含むフィールドを表示する場合は、フィールドに新しい値を入力する場合に展開します。

TxnSeqInc

永続トランザクション・シーケンス増分を選択します。

UsePersColl

ビュー行の自動書出しを有効にして、大規模な行セットを管理する場合に、選択します。

TxnSeqName

永続トランザクション・シーケンス名を入力します。

アドバンスト・プロパティの非表示

すべての拡張プロパティ・フィールドを非表示にする場合に、クリックします。

「セキュリティ・プロパティ」タブ

「セキュリティ・プロパティ」タブを使用して、アプリケーション・モジュール・セキュリティ情報を構成します。

要素

説明

SecurityContext

JAASコンテキストを入力します。この要素により、特定のJAAS実装が指定されます。

デフォルトは「JAZN」です。

アドバンスト・プロパティの表示

現在の拡張セキュリティ・プロパティを含むフィールドを表示する場合は、フィールドに新しい値を入力する場合に展開します。

UserPrincipal

認証済ユーザー・プリンシパル名を入力します。

SecurityConfig

JAZN構成の完全なパスおよびファイル名、たとえば、k:\j2ee\home\config\jazn.xmlを入力します。

このプロパティ値がnullまたはその長さがゼロの場合、ランタイムではjazn.xmlはjazn.jarと同じパスにあるものとみなし、ログイン・モジュールにアクセスする前に/config/jazn.xmlを追加するか、パーミッション・マネージャを取得するためのJAZNのコンテキストを取得します。

javaNamingSecurityCredentials

EJBデプロイの場合、アプリケーション・サーバー接続のパスワードを入力します。

AppModuleJndiName

EJBデプロイの場合、アプリケーション・モジュール・ファクトリのルックアップに使用されるJNDI名を入力します。

SecurityLoginmodule

認証用カスタム・ログイン・モジュールを入力します。たとえば、oracle.security.jazn.realm.RealmLoginModuleです。

デフォルトはJAZNログイン・モジュールです。

ServerUseNullDbTransaction

データベースに接続していない場合、9.0.2互換oracle.jbo.server.NullDbtransactionImplを使用します。

SecurityEnforce

次のいずれかの値を入力します。

None: 認証を行いません。

Test: 認証が必要です。テスターまたはADF Swingを使用する場合、ログインを求めるダイアログが表示されます。認証が失敗した場合でも、アプリケーション・モジュールはインスタンス化されます。

Must : Testに似ていますが、認証に失敗するとアプリケーション・モジュールはインスタンス化されません。かわりに例外が取得されます。

Auth: Mustに似ていますが、エンティティ・ウィザードの認可エディタを使用してエンティティまたは属性権限を定義した場合、権限がチェックされます。たとえば、Dept.Deptnoの権限update_while_newがロールusersに付与されている場合、usersロールは、行が新しいときにのみDeptno値を設定できます。その他の場合は編集できません。

ウィザードで権限が付与されている場合でも、jbo.security.enforceが「Auth」に設定されていないかぎり実行されません。

javaNamingSecurityPrincipal

EJBデプロイの場合、アプリケーション・サーバー接続のパスワードを入力します。

アドバンスト・プロパティの非表示

すべての拡張プロパティ・フィールドを非表示にする場合に、クリックします。

3.3.2 接続構成の変更方法

接続構成には、クライアント・アプリケーションがADFアプリケーション・モジュールのデプロイ・シナリオを識別する際に使用する情報が含まれます。Oracle Enterprise Manager Fusion Middleware Controlを使用して、次のタスクを実行します。

- バックエンド・サービスの登録および管理(メール、ディスカッション・フォーラム・サーバーなど)

- ユーザーがアプリケーションでの作業中にアクセスする必要がある外部アプリケーションの登録および管理

- アプリケーションが使用するポートレット・プロデューサ、またはユーザーがアクセスする必要があるポートレット・プロデューサの登録および管理

Fusion Middleware Controlは、ここで説明するとおり、ADF接続を構成するためのUIを提供します。第3.4.2項「MBeanを使用したADF接続の変更方法」で示すように、汎用のMBeanブラウザを使用して、直接ADF接続MBeanを構成することもできます。

事前作業:

Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。

ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADF接続属性はMDSに保存されます。

アプリケーションをクラスタ内の複数のノードにデプロイした場合、1つのノードのADF接続に対する変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについて接続に関する単一の情報セットが保存されます。

接続構成を変更するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「ADF」→「ADF接続の構成」と選択します。

6. 「接続タイプ」ドロップダウン・リストで、構成する接続のタイプを選択します。

- ADF BCサービス

- ディスカッションおよびお知らせ

- ファイル・システム

- メール・サーバー

- Secure Enterprise Search

- URL

- Webサービス

Essbase接続は作成できませんが、アプリケーションとともにデプロイされている既存のEssbase接続を編集することはできます。

7. 「接続名」フィールドに、接続構成の一意の名前を入力します。

8. 「接続の作成」をクリックします。
接続構成ページが更新され、選択した接続タイプのオプションを指定できるセクションが表示されます。

サポートされている接続タイプは次のとおりです。

- ADFビジネス・コンポーネント・サービス接続

- Essbase接続

- ディスカッションおよびお知らせ接続

- ファイルシステム接続

- メール・サーバー接続

- Secure Enterprise Search接続

- URL接続

- Webサービス接続

ADFビジネス・コンポーネント・サービス接続

新しいADFビジネス・コンポーネント・サービス接続を作成するか、既存の接続の詳細を変更するには、ADFビジネス・コンポーネントサービス接続ページを使用します。

要素

説明

serviceEndpointProvider

サービス・エンドポイントのプロバイダを入力します。有効なタイプは、ADFBC、Fabric、SOAPです。

serviceConnectionName

サービス接続名を入力します。

jndiName

サービス・インタフェースを実装するEJBのJNDI名を入力します。エンドポイントがADF BCである場合に適用可能です。

jndiFactoryInitial

JNDIルックアップの初期コンテキスト・ファクトリのクラス名を入力します。エンドポイントがADF BCである場合に適用可能です。

jndiProviderURL

JNDIルックアップの構成情報を入力します。エンドポイントがADF BCである場合に適用可能です。

jndiSecurityPrincipal

JNDIルックアップのプリンシパル(ユーザーなど)のアイデンティティを入力します。エンドポイントがADF BCである場合に適用可能です。

jndiSecurityCredentials

JNDIルックアップのプリンシパルの資格証明を入力します。エンドポイントがADF BCである場合に適用可能です。

fabricAddress

SOAコンポジットのサービス名を入力します。エンドポイントがFabricである場合に適用可能です。

serviceInterfaceName

サービス・エンドポイント・インタフェースのクラス名を入力します。

serviceSchemaName

サービス・スキーマ・ファイルの名前を入力します。

serviceSchemaLocation

サービス・スキーマ・ファイルの相対パスを入力します。

Essbase接続

Essbase接続は作成できませんが、アプリケーションとともにデプロイされている既存のEssbase接続を編集することはできます。

要素

説明

ホスト

この接続が表すホストを入力します。

ポート

この接続がEssbaseへの接続に使用するデフォルト・ポートが表示されます。デフォルトのオプションを消去して、デフォルト以外のポートを入力します。

ユーザー名

設計時にEssbaseへの接続が認証されたユーザー名を入力します。このユーザー名は、実行時にアプリケーションで指定されるユーザー名に置換されます。

パスワード

ユーザーのパスワードを入力します。入力した各文字はアスタリスク(*)で表示されます。

ディスカッションおよびお知らせ接続

新しいディスカッション・サーバー接続に接続するか、既存の接続詳細を変更するには、ディスカッション・フォーラム接続ページを使用します。フォーラム接続構成には、名前、接続の詳細および拡張の構成が含まれています。

ディスカッションおよびお知らせ接続 - 名前

要素

説明

名前

接続に一意の名前を入力します。

ディスカッションおよびお知らせ接続 - 接続の詳細

要素

説明

サーバーのURL

ディスカッション・フォーラムをホストしているディスカッション・サーバーのURLを入力します。

例: http://discuss-server.com:8888/owc_discussions

管理者ユーザー名

ディスカッション・サーバー管理者のユーザー名を入力します。

WebCenterのユーザーの代理として操作を実行するため、この接続には管理権限が必要です。

接続タイムアウト

接続タイムアウトを秒単位で入力します。デフォルトは、-1です。

セキュアな接続

ディスカッション・サーバー接続がセキュアであるかどうかを示します。

ディスカッションおよびお知らせ接続 - 拡張構成

要素

説明

キャッシュ・サイズ(MB)

キャッシュに予約する領域(MB)を指定します。

デフォルトは、0です。

キャッシュ有効期限

キャッシュの適切な有効期限を指定します。

キャッシュされたコンテンツが有効な最大時間の長さです(分)。

デフォルトは、0です。

接続タイムアウト

接続の適切な有効期限を指定します。

WebCenterアプリケーションが、接続タイムアウト・メッセージを発行するまで、ディスカッション・サーバーからのレスポンスを待機する時間の長さ(秒)です。

デフォルトは60秒です。

ファイルシステム接続

新規コンテンツ・リポジトリに接続、または既存の接続の詳細を変更するには、コンテンツ・リポジトリ接続の追加/編集のページを使用します。

注意:

すべての構成変更は、MDSリポジトリに格納されます。

ファイルシステム接続の詳細 - ファイルシステム

要素

説明

ルート・パス

コンテンツが配置されているローカル・ファイル・システム上のフォルダのフルパスを入力します。例: C:/MyContent

注意: ファイル・システム・コンテンツは、本番またはエンタープライズ・アプリケーションのデプロイに使用しないでください。この機能は、開発目的のみのために提供されています。

メール・サーバー接続

LDAPおよび拡張メール・サーバー構成を構成するには、メール・サーバー接続ページを使用します。

要素

説明

IMAPホスト

IMAPサービス(Internet Message Access Protocol)が稼働しているマシンのホスト名を入力します。

IMAPポート

IMAPサービスがリスニングしているポートを入力します。

セキュアなIMAP

IMAPを介した受信メールに保護接続(SSL)が必要かどうかを示します。

SMTPホスト

SMTPサービス(Simple Mail Transfer Protocol)が稼働しているマシンのホスト名を入力します。

SMTPポート

SMTPサービスがリスニングするポートを入力します。

セキュアなSMTP

SMTPを介した送信メールに保護接続(SSL)が必要かどうかを示します。

関連付けられている外部アプリケーション

メール・サーバーと外部アプリケーションを関連付けます。外部アプリケーションの資格証明情報は、IMAPサーバーに対する認証に使用します。

メール・サーバー接続 - LDAP構成

要素

説明

LDAPドメイン

LDAPドメインを入力します。

LDAPホスト

LDAP(Lightweight Directory Access Protocol)サーバーのホスト名を入力します。

LDAPポート

LDAPサービスがリスニングしているポートを入力します。

セキュアなLDAP

LDAP接続に保護接続(SSL)が必要かどうかを示します。

LDAP管理者のユーザー名

LDAPサーバー管理者のユーザー名を入力します。

LDAP管理者パスワード

LDAPサーバー管理者のパスワードを入力します。

LDAPベースDN

LDAPスキーマのベース識別名を入力します。

LDAPデフォルト・ユーザー

LDAPデフォルト・ユーザーを入力します。

メール・サーバー接続 - 拡張構成

要素

説明

接続タイムアウト(秒)

接続の適切な有効期限を指定します。

WebCenterアプリケーションが、接続タイムアウト・メッセージを発行するまで、メール・サーバーからのレスポンスを待機する時間の長さ(秒)です。デフォルトは60秒です。

キャッシュ有効期限

キャッシュの適切な有効期限を指定します。

キャッシュされたコンテンツが有効な最大時間の長さです(分)。デフォルト値(-1)はキャッシュが期限切れにならないことを意味します。

Secure Enterprise Search接続

WebCenterアプリケーションを新規Oracle Secure Enterprise Searchサーバーに接続するか、既存の接続の詳細を変更するには、Secure Enterprise Search接続ページを使用します。

Secure Enterprise Search接続プロバイダ構成には、名前、接続の詳細、拡張構成が含まれています。

Secure Enterprise Search接続 - 名前

要素

説明

接続名

接続に一意の名前を入力します。

アクティブな接続

WebCenterアプリケーションの検索関連サービスへの接続に使用する場合、選択します。

Oracle Enterprise Manager Fusion Middleware Controlを介して複数の検索接続を登録できますが、一度にアクディブにできる接続は1つのみです。

Secure Enterprise Search接続 - 接続の詳細

要素

説明

SOAP URL

Oracle Secure Enterprise Searchが検索リクエストを有効にするために公開するWebサービスURLを入力します。

http://<host>:<port>/search/query/OracleSearchの形式を使用します。

たとえば、http://myHost:7777/search/query/OracleSearchです

アプリケーション・ユーザー名

有効なユーザーの名前を入力します。

IDストアのユーザー名を指定できます。ユーザーは、WebCenterアプリケーションに構成されたOracle Identity ManagementサーバーおよびOracle SESに構成されたOracle Identity Managementサーバーの両方に存在する必要があります。

WebCenterユーザーに代わって検索が実行できるようにするため、WebCenterアプリケーションは、信頼済のアプリケーションとして自身をOracle Secure Enterprise Searchに認証する必要があります。

アプリケーション・パスワード

適切なユーザー・パスワードを入力します。

Secure Enterprise Search接続 - 拡張構成

要素

説明

Oracle Secure Enterprise Searchデータ・グループ

検索するSecure Enterprise Searchデータ・グループを入力します。

実行タイムアウト

検索実行タイムアウト(ミリ秒)を入力します。

実行者の準備タイムアウト

検索実行者の準備タイムアウト(ミリ秒)を入力します。

保存済の検索の数

表示される保存済の検索の数を入力します。

単純検索結果の行

各サービスの単純検索で表示する結果の行を入力します。

検索結果の行

各サービスの検索で表示する結果の行を入力します。

グローバル検索結果の行

ツールバー上で各サービスに対して表示された検索結果の数を入力します。

URL接続

URL接続を構成するには、URL接続ページを使用します。

要素

説明

URL

必要なデータ・ストリームのURLを、URLパラメータを省略して入力します。

ユーザー名

Webサイトへのアクセスに必要なユーザー名を入力します。

パスワード

Webサイトへのアクセスに必要なパスワードを入力します。

AuthenticationRealm

HTTP認証のレルムを定義します。保護されているリソースをホスティングしているサーバーによって定義されます。

Proxy

HTTP/HTTPSリソースへの接続に使用するプロキシを定義します。ホスト/ポートおよびプロキシ自体に対する認証に必要なすべての認証詳細を指定します。

ProxyUseDefault

DTまたはRTの両方について、もしくは接続インスタンスがアクティブなときは常に、接続レベルではなくシステム・レベルでデフォルトのプロキシを使用します。設計時、デフォルトのプロキシはJDeveloper IDEプロキシ設定で、実行時はWLSに設定されているプロキシです。

ConnectionClassName

チャレンジ認証のタイプを示します。サポートされている2つのモードは基本およびダイジェスト認証(HTTP基本およびダイジェスト)です。

ChallengeAuthenticationType

ファクトリが接続インスタンスの構築で使用する参照にロードされる接続のクラス名。

Webサービス接続

サービスWSDLに基づくWebサービスMDDSモデルを使用してWebサービスの呼出しおよび起動を行う接続を構成するには、Webサービス接続ページを使用します。

「Webサービスの構成」ドロップダウン・リストを使用して、ポリシーのアタッチおよびデタッチを含むWebサービス・クライアントの構成を行います。Webサービス・ページで構成を終了した後は、ブレッドクラムを使用してADF接続ページに戻ることができます。

要素

説明

Model

サービスWSDLに基づいて生成されたWebサービスMDDSモデル要素を入力します。

WsdlUrl

WebサービスのサービスWSDLのURLを入力します。

DefaultServiceName

サービスWSDLのデフォルトのサービス名を入力します。

3.4 MBeanブラウザを使用したアプリケーション・プロパティの構成

Enterprise Manager Fusion Middleware ControlのMBeanブラウザを使用して、ADFアプリケーションとともにOracle WebLogic ServerにデプロイされたADF MBean内の値にアクセスし、これを変更できます。

表示および変更が可能なものは次のとおりです。

- ADFcConfiguration MBean

- ADF接続MBean

- ADFビジネス・コンポーネント BC4J MBean

- MDS構成MBean

- アクティブ・データ・サービス(ADS) MBean

3.4.1 MBeanを使用したADFアプリケーション構成の変更方法

MBeanブラウザを使用して、ADFアプリケーション構成MBeanを変更できます。

事前作業:

ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADFアプリケーション属性はMDSに保存されます。

アプリケーションをクラスタ内の複数のノードにデプロイした場合、MBeanによる1つのノードに対するADFアプリケーション構成の変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについてADFアプリケーション構成に関する単一の情報セットが保存されます。

MBeanブラウザを使用してADFアプリケーション構成を変更するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「ADF」→「ADFの構成(adf-config)」と選択します。

6. システムMBeanブラウザの左ペインで、親ADF MBean「ADFConfig」を展開してから「ADFConfig」フォルダを展開し、子ADF MBeanを表示します。
子ADF MBean「ADFcConfiguration」および「MDSAppConfig」が表示されます。

7. 左ペインで「ADFcConfiguration」 MBeanを選択し、右ペインで表示または変更する属性を選択します。
図3-1に、Fusion Middleware ControlのMBeanブラウザのADF構成MBeanを示します。

図3-1 ADF構成MBean

8. 属性値を変更し、「適用」をクリックします。

9. 左ペインで、親ADF Mbean「ADFConfig」を選択します。

10. 右ペインで、「操作」タブをクリックし、「保存」をクリックします。
親MBeanから「保存」をクリックした後、編集した新しい値がMDSに書き込まれます。

3.4.2 MBeanを使用したADF接続の変更方法

MBeanブラウザを使用して、ADF接続構成MBeanを変更できます。

第3.3.2項「接続構成の変更方法」で示すように、Fusion Middleware UIを使用して、ADF接続を変更することもできます。

事前作業:

ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADFアプリケーション属性はMDSに保存されます。

アプリケーションをクラスタ内の複数のノードにデプロイした場合、MBeanによる1つのノードに対するADF接続の変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについてADFアプリケーション構成に関する単一の情報セットが保存されます。

MBeanブラウザを使用してADFアプリケーション構成を変更するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「システムMBeanブラウザ」を選択します。

6. 「システムMBeanブラウザ」の左ペインで、「ADFConnections」 MBeanに移動します。MBeanは、oracle.adf.share.connections、サーバー名、アプリケーション名の順に移動した場所にあります。

7. 左ペインでADF接続MBeanを選択し、右ペインで表示または変更する属性を選択します。
図3-2に、Fusion Middleware ControlのMBeanブラウザに表示されたADF接続MBeanを示します。

図3-2 ADF接続MBean

8. 属性値を変更し、「適用」をクリックします。

9. 右ペインで、「操作」タブをクリックし、「保存」をクリックします。
「保存」をクリックすると、編集した新しい値がMDSに書き込まれます。

3.4.3 MBeanを使用したADFビジネス・コンポーネント構成の変更方法

MBeanブラウザを使用して、ADFビジネス・コンポーネント構成MBeanを変更できます。ADFビジネス・コンポーネントの構成情報は、各アプリケーションに固有のMbeanに格納されます。一度に同じアプリケーションのすべてのバージョンに対して構成できるADF接続やADFアプリケーション構成情報とは異なり、ADFビジネス・コンポーネントはアプリケーションのバージョンごとに構成する必要があります。

第3.3.1項「ADFビジネス・コンポーネント・パラメータの変更方法」で示すように、Fusion Middleware UIを使用して、ADFビジネス・コンポーネント構成情報を変更することもできます。

事前作業:

ADFアプリケーションおよび接続構成を変更するには、アプリケーションにMDSが構成されている必要があります。ADFアプリケーション属性はMDSに保存されます。

アプリケーションをクラスタ内の複数のノードにデプロイした場合、MBeanによる1つのノードに対するADFビジネス・コンポーネントの変更は、他のすべてのノードに伝播されます。MDSには、アプリケーションのすべてのバージョンについてADFアプリケーション構成に関する単一の情報セットが保存されます。

MBeanブラウザを使用してADFアプリケーション構成を変更するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「システムMBeanブラウザ」を選択します。

6. 「システムMBeanブラウザ」の左ペインで、BC4J MBeanに移動します。これらのMBeanは、oracle.bc4j.mbean.share、サーバー名、アプリケーション名の順に移動した場所にあります。

7. 左ペインでADF接続MBeanを選択し、右ペインで表示または変更する属性を選択します。

8. 属性値を変更し、「適用」をクリックします。

3.4.4 MBeanを使用したMDS構成の変更方法

MBeanブラウザを使用して、MDSパラメータの拡張構成を実行できます。MBeanを使用したMDSの構成の詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

事前作業:

Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。

MBeanブラウザを使用してMDS構成を変更するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、StoreFrontModule (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「MDS構成」を選択します。

6. 「構成MBeanブラウザ」または「ランタイムMBeanブラウザ」をクリックします。

7. MBeanおよび表示または変更する属性を選択します。
図3-3に、Fusion Middleware ControlのMBeanブラウザのMDS MBeanを示します。

図3-3 MDS MBean

8. 値を変更し、「適用」をクリックします。

3.4.5 MBeanを使用したアクティブ・データ・サービス構成の変更方法

アクティブ・データ・サービス(ADS)フレームワークを使用して、Oracle ADFアプリケーションおよび該当するADF Facesコンポーネントの実行時の動作を制御し、サーバーでデータが変更されると、ADFモデル・レイヤーによってコンポーネントに通知され、コンポーネントが変更されたデータを再度反映するように設定できます。

事前作業:

Oracle ADFアプリケーションにアクセスするには、そのアプリケーションがすでにデプロイされており、Enterprise Manager Fusion Middleware Controlが使用可能である必要があります。

アプリケーションのADF Facesコンポーネントは、ADSを使用するように構成されている必要があります。さらに、アプリケーション・サービスがADSをサポートしていない場合、アプリケーションによってサービス・プロキシを定義して、データがソースで更新されるとコンポーネントがそれを表示できるようにする必要があります。ADSの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の第45章「アクティブ・データ・サービスの使用」を参照してください。

MBeanブラウザを使用してADFアプリケーション構成を変更するには、次の手順を実行します。

1. Fusion Middleware Controlを使用してOracle Fusion Middlewareファームにログインします。

2. 「ファーム」タブをクリックします。

3. 「Farm_domain」ノードを展開します。

4. 「アプリケーションのデプロイ」ノードを展開し、application1 (AdminServer)などのJ2EEアプリケーション・デプロイをクリックします。
アプリケーションを選択すると、アプリケーションのデプロイ・ページが表示されます。

5. 「アプリケーションのデプロイ」をクリックし、ドロップダウン・メニューから「ADF」→「ADFの構成(adf-config)」と選択します。

6. システムMBeanブラウザの左ペインで、親ADF MBean「ADFConfig」を展開してから「ADFConfig」フォルダを展開し、子ADF MBeanを表示します。
子ADF MBean「ActiveDataConfiguration」および「MDSAppConfig」が表示されます。

7. 左ペインで「ActiveDataConfiguration」MBeanを選択し、右ペインで表示または変更する属性を選択します。

属性

説明

Transport

データがクライアントに送信される方法。有効な値は次のとおりです。

- streaming (デフォルト)

- polling

- long-polling

詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』のトランスポート・モードについての項を参照してください。

LatencyThreshold

待機しきい値(ミリ秒単位)。このしきい値よりもネットワーク遅延が大きいアクティブなデータ・メッセージは遅延とみなされます。

KeepAliveInterval

イベントが生成されていないときに、キープアライブ・メッセージを送信する頻度(ミリ秒単位)。

PollingInterval

ポール・リクエストの頻度(ミリ秒)。クライアントでポーリングの使用が設定されている場合のみ使用されます。

MaxReconnectAttemptTime

クライアントが接続を切断された場合に、サーバーへの再接続の試行を続ける最大期間(ミリ秒単位)。

ReconnectWaitTime

再接続の試行の間の間隔(ミリ秒単位)。

図3-4に、Fusion Middleware ControlのMBeanブラウザのActiveDataConfiguration MBeanを示します。

図3-4 ADFアクティブ・データ構成MBean

8. 属性値を変更し、「適用」をクリックします。

9. 左ペインで、親ADF Mbean「ADFConfig」を選択します。

10. 右ペインで、「操作」タブをクリックし、「保存」をクリックします。
親MBeanから「保存」をクリックした後、編集した新しい値がMDSに書き込まれます。

3.5 アプリケーションとともにデプロイされた資格証明の編集方法

Enterprise Manager Fusion Middleware Controlを使用して、ADFアプリケーションとともに資格証明ストアにデプロイされた資格証明を編集できます。新しい資格証明を作成したり、既存の資格証明を削除することもできます。

ADFアプリケーションの場合、次の考慮事項が該当します。

- マップ名は、通常アプリケーションのadf-config.xmlファイルに定義されたadfAppUIdプロパティです。

- キー名は、通常anonymous#connectionの形式となります。ここでconnectionは接続名です。

- 資格証明タイプは汎用で、これはキー/値ペアのハッシュ・マップとしてモデル化されます。

詳細は、『Oracle Fusion Middlewareセキュリティ・ガイド』のFusion Middleware Controlによる資格証明の管理に関する項を参照してください。

3.6 診断フレームワークを使用した問題の診断

Oracle Fusion Middlewareは、アプリケーションの問題の検出、診断および解決を支援する診断フレームワークを提供します。

クリティカル・エラーが発生すると、診断フレームワークは即座に診断データを取得し、そのデータとエラーをインシデント番号と関連付けます。この番号を使用して、自動診断リポジトリ(ADR)から分析のためのデータを取得できます。

Oracle ADFでは、INCIDENT_ERRORメッセージがログに記録されると実行されるADFConfigダンプを提供します。アプリケーションの例外ハンドラでダンプを起動するコードを追加することもできます。例3-2に、ADFConfigダンプを起動するよう、例外ハンドラに追加できるサンプル・コードを示します。

例3-2 例外ハンドラでADFConfig診断ダンプを起動するサンプル・コード

IllegalArgumentException e = new IllegalArgumentException("test exception");
LoggerFactory.getFrameworkLogger().log(ODLLevel.INCIDENT_ERROR,
"Test error message", e);

診断フレームワークの詳細は、『Oracle Fusion Middleware管理者ガイド』の「問題の診断」を参照してください。

IBM WebSphere Application Serverで診断フレームワークを使用している場合は、追加タスクを実行する必要があります。詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

3.7 DMS SPYによるアプリケーションのメトリック情報の表示

DMS Spyサーブレットを使用してアプリケーションのメトリック情報をWebブラウザに表示できます。

詳細は、『Oracle® Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のOracle Fusion Middlewareのモニターに関する項を参照してください。

3.8 WebSphere Application Serverの構成

WebSphere Application Serverを構成するには、WebSphere Application Server管理コンソールを使用します。詳細は、http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/com.ibm.websphere.home.doc/welcome.htmlにあるWebSphere Application Serverインフォメーション・センターを参照してください。

3.8.1 問合せ結果セットを再利用できるようにWebSphereを構成する方法

WebSphere Application Serverは、アプリケーションが生成したリクエスト間で、共有データベース接続を閉じます。結果セットの再利用をできるように2つのプロパティをWebSphereで設定する必要があります。

WebSphere Application Server管理コンソールを使用して、non-transactional datasourceプロパティとDisableMultiThreadedServletConnectionMgmtプロパティを設定します。

WebSphereでプロパティを設定して結果セットを再利用するには、次の手順を実行します。

1. WebSphere Application Server管理コンソールを起動します。

2. 「Data Sources」 > 「DB2 Universal JDBC Driver XA DataSource」 > 「WebSphere Application Server data source properties」にナビゲートして、「Non-transactional data source」を「enabled」に設定します。

3. 構成を保存します。

4. 「Application servers」 > 「server_name」 > 「Web Container」 > 「Custom Properties」にナビゲートして、「DisableMultiThreadedServletConnectionMgmt」を「true」に設定します。

5. 構成を保存します。

6. WebSphere Application Serverを再起動します。

これらの2つのプロパティを設定することにより、デプロイしたアプリケーションが結果セットをリクエスト全体で再利用できるようになります。

4 ADFアプリケーションのためのWLSTコマンド・リファレンス

この章では、Oracle WebLogic ServerでOracle ADFアプリケーションのデプロイ、管理および構成に使用できるWLSTコマンドについて説明します。

IBM WebSphere Application Serverのwsadminコマンドについては、付録B「ADFアプリケーションのためのwsadminコマンド・リファレンス」を参照してください。

この章の内容は次のとおりです。

- 第4.1項「Oracle ADFのためのカスタムWSLTコマンドの概要」

- 第4.2項「ADF固有のWLSTコマンド」

4.1 Oracle ADFのためのカスタムWSLTコマンドの概要

構成またはランタイムBeanの階層の移動、およびプロンプト表示の制御を行うには、ADFベースのURL接続WLSTコマンドを使用します。ADFMArchiveConfigオブジェクトの管理には、getADFMArchiveConfigコマンドを使用します。

Oracle ADFでカスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。カスタムのメタデータ・サービス(MDS)コマンドなど、その他のWLSTコマンドの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスを参照してください。

4.2 ADF固有のWLSTコマンド

ADFアプリケーションには表4-1のコマンドを使用します。

表4-1 WLST構成用の参照コマンド

使用するコマンド

目的

使用するWLSTの動作モード

adf_createFileUrlConnection

新しいADFファイル接続を作成します。

オンラインまたはオフライン

adf_createHttpUrlConnection

新しいADF URL接続を作成します。

オンラインまたはオフライン

adf_setURLConnectionAttributes

新たに作成されたADF接続または既存のADF接続の属性を設定または編集します。

オンラインまたはオフライン

adf_listUrlConnection

新しいURL接続をリストします。

オンラインまたはオフライン

getADFMArchiveConfig

指定されたアーカイブのADFMArchiveConfigオブジェクトにハンドルを戻します。

オンラインまたはオフライン

exportJarVersions

JARバージョンのCSV形式を現在のORACLE_HOMEから指定された場所にエクスポートします。

オフライン

exportApplicationJarVersions

指定されたアプリケーションのJARバージョンのCSV形式を指定された場所にエクスポートします。

オンライン

exportApplicationSelectedJarVersions

Versions.xmlファイルと連携して、JARバージョンのCSV形式を、現在のORACLE_HOMEから指定された場所にエクスポートします。

オンライン

4.2.1 adf_createFileUrlConnection

WLSTとともに、オンラインまたはオフラインで使用します。

4.2.1.1 説明

このコマンドは、oracle.adf.model.connection.url.FileURLConnection接続クラスに基づいて新しい接続を作成する際に使用します。

4.2.1.2 構文

adf_createFileURLConnection(appName, name, URL)

引数

定義

appName

接続を作成するアプリケーション名。

name

新しい接続の名前。

URL

この接続に関連付けられるURL。

4.2.1.3 例

adf_createFileURLConnection('myapp','tempDir','/scratch/tmp')

4.2.2 adf_createHttpUrlConnection

WLSTとともに、オンラインまたはオフラインで使用します。

4.2.2.1 説明

このコマンドは、oracle.adf.model.connection.url.HttpURLConnection接続のtypeクラスに基づいて新しい接続を作成する際に使用します。

4.2.2.2 構文

adf_createHttpURLConnection (appName, name, [URL], [authenticationType], [realm], [user], [password])

引数

定義

appName

接続を作成するアプリケーション名。

name

新しい接続の名前。

url

(オプション) この接続に関連付けられるURL。

authenticationType

(オプション) デフォルトはbasicです。

realm

(オプション) この接続が認証を処理する場合は、これを設定する必要があります。デフォルトは「基本」モードです。

user

(オプション)

password

(オプション)

4.2.2.3 例

adf_createHttpURLConnection('myapp','cnn','http://www.cnn.com')

4.2.3 adf_setURLConnectionAttributes

WLSTとともに、オンラインまたはオフラインで使用します。

4.2.3.1 説明

このコマンドは、新たに作成されたADF接続または既存のADF接続の属性を設定または編集する際に使用します。

4.2.3.2 構文

adf_setURLConnectionAttributes(appname, connectionname, attributes)

引数

定義

appname

アプリケーション名。

connectionname

接続の名前。

attributes

キー/値ペアに設定される属性を含む配列。

4.2.3.3 例

adf_setURLConnectionAttributes ('myapp','cnn','ChallengeAuthenticationType:digest',
'AuthenticationRealm:XMLRealm'

4.2.4 adf_listUrlConnection

WLSTとともに、オンラインまたはオフラインで使用します。

4.2.4.1 説明

このコマンドは、アプリケーションの接続をリストする際に使用します。

4.2.4.2 構文

adf_listURLConnection(appname)

引数

定義

appname

アプリケーション名。

4.2.4.3 例

adf_listURLConnection ('myapp')

4.2.5 getADFMArchiveConfig

WLSTとともに、オンラインまたはオフラインで使用します。

4.2.5.1 説明

指定されたアーカイブのADFMArchiveConfigオブジェクトにハンドルを戻します。戻されるADFMArchiveConfigオブジェクトのメソッドを使用して、アーカイブ内のアプリケーション構成を変更できます。

ADFMArchiveConfigオブジェクトは、次のメソッドを提供します。

- setDatabaseJboSQLBuilder([value]) - データベースのjbo.SQLBuilder属性を設定します。

- getDatabaseJboSQLBuilder() - jbo.SQLBuilder属性の現在の値を戻します。

- setDatabaseJboSQLBuilderClass([value]) - データベースのjbo.SQLBuilderClass属性を設定します。値は、カスタム・ビルダー・クラスのフルネームです。

- getDatabaseJboSQLBuilderClass() - jbo.SQLBuilderClass属性の現在の値を戻します。

- setDefaultRowLimit([value]) - デフォルトのrowLimit 属性を設定します。値は、行の長さ制限を指定します(デフォルトは-1)。

- getDefaultRowLimit() - rowLimit属性の現在の値を戻します。

- save([toLocation]) - toLocationを指定すると、変更はターゲットのアーカイブ・ファイルに保存され、元のファイルは変更されません。これを指定しない場合、変更は元のファイル自体に保存されます。

4.2.5.2 構文

archiveConfigObject = ADFMAdmin.getADFMArchiveConfig(fromLocation)

引数

定義

fromLocation

完全パスを含むearファイルの名前。

setDatabaseJboSQLBuilder([value])の構文は次のとおりです。

archiveConfigObject.setDatabaseJboSQLBuilder([value])

引数

定義

value

jbo.SQLBuilder属性の値。有効な値は、Oracle(デフォルト)、OLite、DB2、SQL92、SQLServer、Customです。Customを指定した場合は、jbo.SQLBuilderClass属性も設定する必要があります。

getDatabaseJboSQLBuilder()の構文は次のとおりです。

archiveConfigObject.getDatabaseJboSQLBuilder()

setDatabaseJboSQLBuilderClass([value])の構文は次のとおりです。

archiveConfigObject.setDatabaseJboSQLBuilderClass([value])

引数

定義

value

jbo.SQLBuilderClass属性の値。

getDatabaseJboSQLBuilderClass()の構文は次のとおりです。

archiveConfigObject.getDatabaseJboSQLBuilderClass()

setDefaultRowLimit([value])の構文は次のとおりです。

archiveConfigObject.setDefaultRowLimit([value])

引数

定義

value

rowLimit属性の値。

getDefaultRowLimit()の構文は次のとおりです。

archiveConfigObject.getDefaultRowLimit([value])

save([toLocation])の構文は次のとおりです。

archiveConfigObject.save([toLocation])

引数

定義

toLocation

変更を保存するファイル名および絶対パス。

4.2.5.3 例

次の例では、jbo.SQLBuilder属性がDB2に設定されています。

wls:/offline> archive =
ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wls:/offline> archive.setDatabaseJboSQLBuilder(value='DB2')
wls:/offline> archive.save()

次の例では、jbo.SQLBuilder属性が削除されており、アプリケーションのデフォルトが使用されます。

wls:/offline> archive =
ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wls:/offline> archive.setDatabaseJboSQLBuilder()
wls:/offline> archive.save(toLocation='/tmp/targetArchive.ear')

次の例では、jbo.SQLBuilder属性がCustomに、jbo.SQLBuilderClass属性がクラスcom.example.CustomBuilderに設定されています。

wls:/offline> archive =
ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wls:/offline> archive.setDatabaseJboSQLBuilder('Custom')
wls:/offline> archive.setDatabaseJboSQLBuilderClass('com.example.CustomBuilder')
wls:/offline> archive.save(toLocation='/tmp/targetArchive.ear')

次の例では、rowLimit属性が100に設定されています。

wls:/offline> archive = getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wls:/offline> archive.setDefaultRowLimit(100)
wls:/offline> archive.save(toLocation='/tmp/targetArchive.ear')

4.2.6 exportJarVersions

WLSTとともにオフラインで使用します。

4.2.6.1 説明

JARバージョンのCSV形式を、現在のORACLE_HOMEから指定された場所にエクスポートするために使用します。エクスポートされたJARバージョン情報は、Oracle OpenOfficeまたはMicrosoft Excelで開くことができます。

4.2.6.2 構文

exportJarVersions(path)

引数

定義

path

JARバージョンを抽出する場所。

4.2.6.3 例

この例は、JARバージョンを/tmp/export-MyApp-Versions.csvにエクスポートする方法を示します。CSVファイルのR/W権限を確認する必要があります。

wls:/offline>exportJarVersions('/tmp/export-MyApp-Versions.csv')

4.2.7 exportApplicationJarVersions

WLSTとともにオンラインで使用します。

4.2.7.1 説明

指定されたアプリケーションのランタイムJARバージョンのCSV形式を指定された場所にエクスポートするために使用します。

4.2.7.2 構文

exportApplicationJarVersions(applicationName, path)

引数

定義

applicationName

JARバージョンをエクスポートするアプリケーション名

path

JARバージョンをエクスポートする場所。

4.2.7.3 例

この例は、MyAppランタイムJARバージョンを/tmp/export-MyApp-Versions.csvにエクスポートする方法を示します。CSVファイルのR/W権限を確認する必要があります。

wls:/DefaultDomain/serverConfig>exportApplicationJarVersions('MyApp',
'/tmp/export-MyApp-Versions.csv')

4.2.8 exportApplicationSelectedJarVersions

WLSTとともにオンラインで使用します。

4.2.8.1 説明

選択したJARのJARバージョンのCSV形式を指定された場所にエクスポートするために使用します。

4.2.8.2 構文

exportApplicationSelectedJarVersions(applicationName, path, jarsLocation)

引数

定義

applicationName

JARバージョンをエクスポートするアプリケーション名。

path

JARバージョンを抽出する場所。

jarsLocation

選択したJARのオプションのリスト。指定しない場合、%WLSDOMAIN%/config/fmwconfig/Versions.xmlのデフォルトのJARランタイム・バージョンのリストがエクスポートされます。

Versions.xmlのselectedJarsプロパティが空の場合、adfm.jar、adf-richclient-impl-11.jar、adf-controller.jar、adf-pageflow-impl.jar、adf-share-support.jarおよびmdsrt.jarのバージョン情報がエクスポートされます。

4.2.8.3 例

この例は、Versions.xmlファイルのselectedJarsプロパティを使用してJARバージョンを/tmp/export-MyApp-Versions.csvにエクスポートする方法を示します。この場合、jarsLocationパラメータが指定されていないため、Versions.xmlファイルのselectedJarsプロパティにリストされているライブラリがエクスポートされます。CSVファイルのR/W権限を確認する必要があります。

wls:/offline>exportApplicationSelectedJarVersions('MyApp',
'/tmp/export-MyApp-Versions.csv')

Versions.xml
<Diagnostics xmlns="xmlns.oracle.com/adf/diagnostics">
<Versions xmlns="xmlns.oracle.com/adf/diagnostics/versions"
exportVersionsOnApplicationStartup="true"
selectedJars="$ORACLE_HOME$/modules/oracle.adf.model_11.1.1/adfm.jar;
$ORACLE_HOME$/modules/oracle.adf.view_11.1.1/adf-richclient-impl-11.jar;
$ORACLE_HOME$/modules/oracle.adf.controller_11.1.1/adf-controller.jar;
$ORACLE_HOME$/modules/oracle.adf.pageflow_11.1.1/adf-pageflow-impl.jar;
$ORACLE_HOME$/modules/oracle.adf.share_11.1.1/adf-share-support.jar;
$ORACLE_HOME$/modules/oracle.mds_11.1.1/mdsrt.jar" />
</Diagnostics>

この例は、jarsLocationパラメータを使用してJARバージョンを/tmp/export-MyApp-Versions.csvにエクスポートする方法を示します。この場合、jarsLocationパラメータで明示的に渡されるライブラリがエクスポートされます。CSVファイルのR/W権限を確認する必要があります。

wls:/offline>exportApplicationSelectedJarVersions('MyApp',
'/tmp/export-MyApp-Versions.csv',
'$ORACLE_HOME$/modules/oracle.adf.model_11.1.1/adfm.jar;$ORACLE_HOME$/modules/oracle.adf.view_11.1.1/adf-richclient-impl-11.jar')

第III部

付録

この部の構成は、次のとおりです。

- 付録A「ADFランタイム・ライブラリ」

- 付録B「ADFアプリケーションのためのwsadminコマンド・リファレンス」

- 付録C「GlassFishサーバーの構成」

A ADFランタイム・ライブラリ

この付録では、Oracle WebLogic Serverにデプロイされ、ADFアプリケーションをサポートするADFランタイム・ライブラリ・コンテンツのリファレンスを提供します。

次のADFランタイム・ライブラリについて説明します。

- 第A.1項「JDeveloperを使用したADFランタイム・ライブラリの検索」

- 第A.2項「adf.oracle.domain.webapp.warライブラリ」

- 第A.3項「adf.oracle.domain.earライブラリ」

- 第A.4項「システム・クラスパス」

- 第A.5項「adf.desktopintegration.warライブラリ」

A.1 JDeveloperを使用したADFランタイム・ライブラリの検索

この付録の内容に加え、JDeveloperを使用してJARの対応するADFランタイム・ライブラリを検索できます。

JARのADFランタイム・ライブラリを検索する方法:

1. JDeveloperで、「ツール」→「ライブラリの管理」を選択します。

2. 「ライブラリの管理」ダイアログの「ライブラリ」タブで、「検索」アイコンをクリックしてドロップダウン・リストから「JAR名」を選択します。

3. 検索フィールドにJARの名前を入力し、「検索」アイコンをクリックします。

A.2 adf.oracle.domain.webapp.warライブラリ

表A-1に、adf.oracle.domain.webapp.warファイルにパッケージ化されるJARファイルと、対応するADFランタイム・ライブラリをリストします。

表A-1 adf.oracle.domain.webapp.warライブラリ

JAR

ADFライブラリ

oracle.adf.controller_11.1.1/adf-controller-api.jar

ADF Controllerランタイム

oracle.adf.controller_11.1.1/adf-controller-rt-common.jar

ADF Controllerランタイム

oracle.adf.controller_11.1.1/adf-controller.jar

ADF Controllerランタイム

oracle.adf.pageflow_11.1.1/adf-pageflow-dtrt.jar

ADF Page Flowランタイム

ADFデザインタイムAPI

oracle.adf.pageflow_11.1.1/adf-pageflow-fwk.jar

ADF Page Flowランタイム

oracle.adf.pageflow_11.1.1/adf-pageflow-impl.jar

ADF Page Flowランタイム

oracle.adf.pageflow_11.1.1/adf-pageflow-rc.jar

ADF Page Flowランタイム

oracle.adf.view_11.1.1/adf-dt-at-rt.jar

ADF Modelランタイム

ADFデザインタイムAPI

oracle.adf.view_11.1.1/adf-dynamic-faces.jar

ADF Faces動的コンポーネント

oracle.adf.view_11.1.1/adf-faces-changemanager-rt.jar

ADF Faces Change Managerランタイム11

oracle.adf.view_11.1.1/adf-faces-databinding-dt-core.jar

ADFデザインタイムAPI

oracle.adf.view_11.1.1/adf-faces-databinding-rt.jar

Trinidadデータバインディング・ランタイム

ADF Facesデータバインディング・ランタイム

oracle.adf.view_11.1.1/adf-faces-templating-dt-core.jar

ADFデザインタイムAPI

oracle.adf.view_11.1.1/adf-faces-templating-dtrt.jar

ADFデザインタイムAPI

oracle.adf.view_11.1.1/adf-richclient-api-11.jar

Trinidadデータバインディング・ランタイム

ADF Facesランタイム11

oracle.adf.view_11.1.1/adf-richclient-automation-11.jar

Oracle拡張Selenium (非推奨)

Oracle拡張Selenium (サーバーを除く)

oracle.adf.view_11.1.1/adf-richclient-impl-11.jar

ADF Facesランタイム11

oracle.adf.view_11.1.1/adf-share-web.jar

該当なし

oracle.adf.view_11.1.1/adf-view-databinding-dt-core.jar

ADFデザインタイムAPI

oracle.adf.view_11.1.1/adf.constants.jar

該当なし

oracle.adf.view_11.1.1/batik-anim.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-awt-util.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-bridge.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-codec.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-css.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-dom.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-ext.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-extension.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-gui-util.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-gvt.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-parser.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-script.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-svg-dom.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-svggen.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-swing.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-transcoder.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-util.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/batik-xml.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/bundleresolver.jar

リソース・バンドル変数リゾルバ

oracle.adf.view_11.1.1/dvt-basemaps.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/dvt-databinding-dt-core.jar

ADFデザインタイムAPI

oracle.adf.view_11.1.1/dvt-databindings.jar

BIデータ・コントロール・ランタイム

ADF DVT Facesデータバインディング・ランタイム

oracle.adf.view_11.1.1/dvt-faces.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/dvt-facesbindings.jar

BIデータ・コントロール・ランタイム

ADF DVT Facesデータバインディング・ランタイム

oracle.adf.view_11.1.1/dvt-jclient.jar

Oracle BIグラフ

ADF DVTコア・ランタイム

ADF Swingランタイム

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/dvt-trinidad.jar

ADF DVTコア・ランタイム

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/dvt-utils.jar

BIデータ・コントロール・ランタイム

Oracle BIグラフ

ADF DVTコア・ランタイム

ADF Swingランタイム

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/inspect4.jar

廃止JDeveloper拡張機能SDK

Oracle JEWT

oracle.adf.view_11.1.1/jewt4.jar

BC4Jテスター

廃止JDeveloper拡張機能SDK

Oracle Help for Java

Oracle JEWT

oracle.adf.view_11.1.1/prefuse.jar

ADF DVT Facesランタイム

oracle.adf.view_11.1.1/trinidad-api.jar

ADF Facesランタイム11

Trinidadランタイム11

oracle.adf.view_11.1.1/trinidad-impl.jar

ADF Facesランタイム11

Trinidadランタイム11

oracle.adf.view_11.1.1/xml-apis-ext.jar

ADF DVT Facesランタイム

oracle.facesconfigdt_11.1.1/facesconfigmodel.jar

ADF Faces Change Managerランタイム11

oracle.facesconfigdt_11.1.1/taglib.jar

ADF Faces Change Managerランタイム11

oracle.xdk_11.1.0/xml.jar

MDSランタイム依存性

Oracle XML Parserバージョン2

XSQLランタイム

velocity-dep-1.4.jar

ADFデザインタイムAPI

A.3 adf.oracle.domain.earライブラリ

表A-2に、adf.oracle.domain.earファイルにパッケージ化されるJARファイルと、対応するADFランタイム・ライブラリをリストします。

表A-2 adf.oracle.domain.earライブラリ

JAR

ADFライブラリ

groovy-all-1.6.3.jar

ADF Modelランタイム

ADF Model汎用ランタイム

BC4Jランタイム

oracle.adf.model_11.1.1/adf-controller-schema.jar

ADF Controllerスキーマ

oracle.adf.model_11.1.1/adf-faces-registration.jar

該当なし

oracle.adf.model_11.1.1/adf-runtime-mbean.jar

該当なし

oracle.adf.model_11.1.1/adf-sec-idm-dc.jar

ユーザーおよびロール・データ・コントロール

oracle.adf.model_11.1.1/adfbcsvc-client.jar

BC4Jサービス・クライアント

oracle.adf.model_11.1.1/adfbcsvc-registration.jar

Kava SDO

oracle.adf.model_11.1.1/adfbcsvc-share.jar

BC4Jサービス・ランタイム

BC4Jサービス・クライアント

BC4Jシステム・カタログ

oracle.adf.model_11.1.1/adfbcsvc.jar

BC4Jサービス・ランタイム

oracle.adf.model_11.1.1/adfdt_common.jar

ADF Modelランタイム

ADFmデザインタイムAPI

oracle.adf.model_11.1.1/adflibfilter.jar

ADF共通Webランタイム

oracle.adf.model_11.1.1/adflibrary.jar

ADF Modelランタイム

ADFmデザインタイムAPI

oracle.adf.model_11.1.1/adfm-debugger.jar

BC4Jテスター

oracle.adf.model_11.1.1/adfm-sqldc.jar

ADF SQLデータ・コントロール・ランタイム

oracle.adf.model_11.1.1/adfm.jar

BC4J EJBクライアント

ADF Modelランタイム

BC4J Oracleドメイン

ADF Model汎用ランタイム

BC4Jランタイム

ADF Swingランタイム

ADFモデルのAPI

BC4J EJBランタイム

BC4Jクライアント

BC4J IASクライアント

oracle.adf.model_11.1.1/adfmportlet.jar

該当なし

oracle.adf.model_11.1.1/adfmweb.jar

ADF Webランタイム

oracle.adf.model_11.1.1/adftags.jar

Oracle ADF DataTag

oracle.adf.model_11.1.1/adftransactionsdt.jar

ADF Modelランタイム

ADFmデザインタイムAPI

ADFデザインタイムAPI

oracle.adf.model_11.1.1/bc4j-mbeans.jar

BC4Jランタイム

oracle.adf.model_11.1.1/bc4jhtml.jar

BC4J Strutsランタイム

oracle.adf.model_11.1.1/bc4jimdomains.jar

Oracle interMedia ADF Swing

Oracle interMedia

oracle.adf.model_11.1.1/bc4jsyscat.jar

BC4Jシステム・カタログ

oracle.adf.model_11.1.1/datatags.jar

該当なし

oracle.adf.model_11.1.1/db-ca.jar

BC4J EJBクライアント

ADF Modelランタイム

BC4Jテスター

BC4Jランタイム

BC4Jクライアント

BC4J IASクライアント

DBランタイム(db-tests)

oracle.adf.model_11.1.1/dvt-databindings-mds.jar

ADF DVT FacesデータバインディングMDSランタイム

oracle.adf.model_11.1.1/jdev-cm.jar

BC4J EJBクライアント

ADF Modelランタイム

BC4Jテスター

BC4Jランタイム

廃止JDeveloper拡張機能SDK

BC4Jクライアント

BC4J IASクライアント

Connection Manager

oracle.adf.model_11.1.1/jmxdc.jar

JMXデータ・コントロール

oracle.adf.model_11.1.1/jr_dav.jar

リソース・カタログ・サービス

oracle.adf.model_11.1.1/mds-dc.jar

該当なし

oracle.adf.model_11.1.1/oicons.jar

ADFmデザインタイムAPI

oracle.adf.model_11.1.1/ordhttp.jar

Oracle interMedia ADF Swing

Oracle interMedia

oracle.adf.model_11.1.1/ordim.jar

Oracle interMedia ADF Swing

Oracle interMedia

oracle.adf.model_11.1.1/rcs-adflib-rt.jar

該当なし

oracle.adf.model_11.1.1/rcsrt.jar

リソース・カタログ・サービス

oracle.adf.model_11.1.1/regexp.jar

BC4Jテスター

oracle.xdk_11.1.0/oraclexsql.jar

該当なし

oracle.xdk_11.1.0/xsqlserializers.jar

XSQLランタイム

A.4 システム・クラスパス

表A-3に、システム・クラスパスにロードされるJARファイルと、対応するADFランタイム・ライブラリをリストします。

表A-3 システム・クラスパス

JAR

ADFライブラリ

features/adf.security_11.1.1.jar

該当なし

features/adf.share_11.1.1.jar

該当なし

features/adf.share.ca_11.1.1.jar

該当なし

oracle.adf.security_11.1.1/adf-controller-security.jar

ADF Modelランタイム

ADF共通ランタイム

oracle.adf.security_11.1.1/adf-share-security.jar

ADF Modelランタイム

BC4Jセキュリティ

ADF共通ランタイム

oracle.adf.share_11.1.1/adf-share-support.jar

MDSランタイム依存性

ADF Model汎用ランタイム

BC4Jランタイム

BC4Jセキュリティ

ADF共通ランタイム

oracle.adf.share_11.1.1/adf-share-wls.jar

該当なし

oracle.adf.share_11.1.1/adflogginghandler.jar

MDSランタイム依存性

BC4Jテスター

ADF Model汎用ランタイム

BC4Jランタイム

ADF共通ランタイム

oracle.adf.share_11.1.1/adfsharembean.jar

BC4Jランタイム

ADF共通ランタイム

oracle.adf.share_11.1.1/commons-el.jar

ADF Modelランタイム

MDSランタイム依存性

ADF Model汎用ランタイム

BC4Jランタイム

oracle.adf.share_11.1.1/jsp-el-api.jar

ADF Modelランタイム

MDSランタイム依存性

ADF Model汎用ランタイム

BC4Jランタイム

oracle.adf.share_11.1.1/oracle-el.jar

ADF Modelランタイム

MDSランタイム依存性

ADF Model汎用ランタイム

BC4Jランタイム

oracle.adf.share.ca_11.1.1/adf-share-base.jar

ADF共通Webランタイム

MDSランタイム依存性

ADF Model汎用ランタイム

BC4Jランタイム

ADF Swingランタイム

BC4Jセキュリティ

ADF共通ランタイム

oracle.adf.share.ca_11.1.1/adf-share-ca.jar

MDSランタイム依存性

ADF Model汎用ランタイム

BC4Jランタイム

BC4Jセキュリティ

ADF共通ランタイム

oracle.javatools_11.1.1/javamodel-rt.jar

Java EE 1.5

J2EE 1.4

JAX-RPCクライアント

oracle.javatools_11.1.1/javatools-jndi-local.jar

該当なし

oracle.javatools_11.1.1/javatools-nodeps.jar

ADF共通Webランタイム

MDSランタイム依存性

Java EE 1.5

ADFmデザインタイムAPI

J2EE 1.4

JAX-RPCクライアント

DBランタイム(db-tests)

oracle.javatools_11.1.1/resourcebundle.jar

ADFデスクトップ統合ランタイム

リソース・バンドル・サポート

BC4Jランタイム

oracle.mds_11.1.1/mdslcm-client.jar

該当なし

oracle.mds_11.1.1/mdslcm.jar

該当なし

oracle.mds_11.1.1/mdsrt.jar

MDSランタイム

oracle.mds_11.1.1/oramds.jar

MDSランタイム依存性

oracle.xmlef_11.1.1/xmlef.jar

MDSランタイム依存性

ADF Faces Change Managerランタイム11

ADF Model汎用ランタイム

廃止JDeveloper拡張機能SDK

oracle.bali.share_11.1.1/share.jar

MDSランタイム依存性

BC4Jテスター

ADF Model汎用ランタイム

Oracle Help for Java

Oracle JEWT

A.5 adf.desktopintegration.warライブラリ

表A-4に、adf.desktopintegration.warファイルにパッケージ化されるJARファイルと、対応するADFランタイム・ライブラリをリストします。

表A-4 adf.desktopintegration.warライブラリ

JAR

ADFライブラリ

oracle.adf.desktopintegration_11.1.1/adf-desktop-integration.jar

ADFデスクトップ統合ランタイム

B ADFアプリケーションのためのwsadminコマンド・リファレンス

この章では、Oracle ADFアプリケーションのデプロイ、管理および構成に使用できるwsadminコマンドについて説明します。wsadminコマンドは、IBM WebSphere Application Serverで使用するためのコマンドです。

この章の内容は次のとおりです。

- 第B.1項「Oracle ADFのためのカスタムwsadminコマンドの概要」

- 第B.2項「ADF固有のWebSphereコマンド」

B.1 Oracle ADFのためのカスタムwsadminコマンドの概要

構成またはランタイムBeanの階層の移動、およびプロンプト表示の制御を行うには、ADFベースのURL接続wsadminコマンドを使用します。ADFMArchiveConfigオブジェクトの管理には、getADFMArchiveConfigコマンドを使用します。

各コマンドはモジュール名で修飾する必要があります。たとえば、モジュールがURLConnection.pyの場合、コマンドはURLConnection.createFileUrlConnectionのように起動できます。モジュールがADFAdmin.pyの場合は、ADFAdmin.getADFArchiveConfigとなります。

B.2 ADF固有のWebSphereコマンド

表B-1のコマンドを使用してADFアプリケーションを管理します。

表B-1 wsadmin構成用の参照コマンド

使用するコマンド

目的

wsadminの使用

createFileUrlConnection

新しいADFファイル接続を作成します。

オンラインまたはオフライン

createHttpUrlConnection

新しいADF URL接続を作成します。

オンラインまたはオフライン

setURLConnectionAttributes

新たに作成されたADF接続または既存のADF接続の属性を設定または編集します。

オンラインまたはオフライン

listUrlConnection

新しいURL接続をリストします。

オンラインまたはオフライン

getADFMArchiveConfig

指定されたアーカイブのADFMArchiveConfigオブジェクトにハンドルを戻します。

オンラインまたはオフライン

B.2.1 createFileUrlConnection

wsadminとともに、オンラインまたはオフラインで使用します。

B.2.1.1 説明

このコマンドは、oracle.adf.model.connection.url.FileURLConnection接続クラスに基づいて新しい接続を作成する際に使用します。

B.2.1.2 構文

URLConnection.createFileURLConnection(appName, name, URL)

引数

定義

appName

接続を作成するアプリケーション名。

name

新しい接続の名前。

URL

この接続に関連付けられるURL。

B.2.1.3 例

URLConnection.createFileURLConnection('myapp','tempDir','/scratch/tmp')

B.2.2 createHttpUrlConnection

wsadminとともに、オンラインまたはオフラインで使用します。

B.2.2.1 説明

このコマンドは、oracle.adf.model.connection.url.HttpURLConnection接続のtypeクラスに基づいて新しい接続を作成する際に使用します。

B.2.2.2 構文

URLConnection.createHttpURLConnection (appName, name, [URL], [authenticationType], [realm], [user], [password])

引数

定義

appName

接続を作成するアプリケーション名。

name

新しい接続の名前。

url

(オプション) この接続に関連付けられるURL。

authenticationType

(オプション) デフォルトはbasicです。

realm

(オプション) この接続が認証を処理する場合は、これを設定する必要があります。デフォルトは「基本」モードです。

user

(オプション)

password

(オプション)

B.2.2.3 例

URLConnection.createHttpURLConnection('myapp','cnn','http://www.cnn.com')

B.2.3 setURLConnectionAttributes

wsadminとともに、オンラインまたはオフラインで使用します。

B.2.3.1 説明

このコマンドは、新たに作成されたADF接続または既存のADF接続の属性を設定または編集する際に使用します。

B.2.3.2 構文

URLConnection.setURLConnectionAttributes(appname, connectionname, attributes)

引数

定義

appname

アプリケーション名。

connectionname

接続の名前。

attributes

キー/値ペアに設定される属性を含む配列。

B.2.3.3 例

URLConnection.setURLConnectionAttributes ('myapp','cnn','ChallengeAuthenticationType:digest',
'AuthenticationRealm:XMLRealm'

B.2.4 listUrlConnection

wsadminとともに、オンラインまたはオフラインで使用します。

B.2.4.1 説明

このコマンドは、アプリケーションの接続をリストする際に使用します。

B.2.4.2 構文

URLConnection.listURLConnection(appname)

引数

定義

appname

アプリケーション名。

B.2.4.3 例

URLConnection.listURLConnection ('myapp')

B.2.5 getADFMArchiveConfig

wsadminとともに、オンラインまたはオフラインで使用します。

B.2.5.1 説明

指定されたアーカイブのADFMArchiveConfigオブジェクトにハンドルを戻します。戻されるADFMArchiveConfigオブジェクトのメソッドを使用して、アーカイブ内のアプリケーション構成を変更できます。

ADFMArchiveConfigオブジェクトは、次のメソッドを提供します。

- setDatabaseJboSQLBuilder([value]) - データベースのjbo.SQLBuilder属性を設定します。

- getDatabaseJboSQLBuilder() - jbo.SQLBuilder属性の現在の値を戻します。

- setDatabaseJboSQLBuilderClass([value]) - データベースのjbo.SQLBuilderClass属性を設定します。

- getDatabaseJboSQLBuilderClass() - jbo.SQLBuilderClass属性の現在の値を戻します。

- setDefaultRowLimit([value]) - デフォルトのrowLimit属性を設定します。値は、行の長さ制限を指定します(デフォルトは-1)。

- getDefaultRowLimit() - rowLimit属性の現在の値を戻します。

- save([toLocation]) - toLocationを指定すると、変更はターゲットのアーカイブ・ファイルに保存され、元のファイルは変更されません。これを指定しない場合、変更は元のファイル自体に保存されます。

B.2.5.2 構文

archiveConfigObject = ADFMAdmin.getADFMArchiveConfig(fromLocation)

引数

定義

fromLocation

完全パスを含むearファイルの名前。

setDatabaseJboSQLBuilder([value])の構文は次のとおりです。

archiveConfigObject.setDatabaseJboSQLBuilder([value])

引数

定義

value

jbo.SQLBuilder属性の値。有効な値は、Oracle(デフォルト)、OLite、DB2、SQL92、SQLServer、Customです。Customを指定した場合は、jbo.SQLBuilderClass属性も設定する必要があります。

getDatabaseJboSQLBuilder()の構文は次のとおりです。

archiveConfigObject.getDatabaseJboSQLBuilder()

setDatabaseJboSQLBuilderClass([value])の構文は次のとおりです。

archiveConfigObject.setDatabaseJboSQLBuilderClass([value])

引数

定義

value

jbo.SQLBuilderClass属性の値。

getDatabaseJboSQLBuilderClass()の構文は次のとおりです。

archiveConfigObject.getDatabaseJboSQLBuilderClass()

save([toLocation])の構文は次のとおりです。

archiveConfigObject.save([toLocation])

引数

定義

toLocation

変更を保存するファイル名および絶対パス。

B.2.5.3 例

次の例で、アーカイブ内のadf-config.xmlファイルにアプリケーションおよび共有メタデータ・リポジトリが定義されていない場合、完全な接続情報を提供する必要があります。

# Open something.ear and return an object which can be used
# manipulate it
archive = ADFMAdmin.getADFMArchiveConfig('/path/to/something.ear')

# Return current JBO SQL Builder value
archive.getDatabaseJboSQLBuilder()

# Change JBO SQL Builder value to Oracle
archive.setDatabaseJboSQLBuilder('Oracle')

# Save the changes back to the original file
archive.save()

archive = ADFMAdmin.getADFMArchiveConfig('/path/to/something.ear')
archive.getDatabaseJboSQLBuilder()

次の例では、jbo.SQLBuilder属性がDB2に設定されています。

wsadmin> archive =
ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wsadmin> archive.setDatabaseJboSQLBuilder(value='DB2')
wsadmin> archive.save()

次の例では、jbo.SQLBuilder属性が削除されており、アプリケーションのデフォルトが使用されます。

wsadmin> archive =
ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wsadmin> archive.setDatabaseJboSQLBuilder()
wsadmin> archive.save(toLocation='/tmp/targetArchive.ear')

次の例では、jbo.SQLBuilder属性がCustomに、jbo.SQLBuilderClass属性がクラスcom.example.CustomBuilderに設定されています。

wsadmin> archive =
ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wsadmin> archive.setDatabaseJboSQLBuilder('Custom')
wsadmin> archive.setDatabaseJboSQLBuilderClass('com.example.CustomBuilder')
wsadmin> archive.save(toLocation='/tmp/targetArchive.ear')

次の例では、rowLimit属性が100に設定されています。

wsadmin:/offline> archive = getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear')
wsadmin:/offline> archive.setDefaultRowLimit(100)
wsadmin:/offline> archive.save(toLocation='/tmp/targetArchive.ear')

C GlassFishサーバーの構成

この付録では、Oracle ADF Essentials用にGlassFishサーバーを構成する方法について説明します。Oracle ADFランタイムを取得する方法、およびこれらのファイルをGlassFishサーバーにインストールする方法について説明します。

この付録の内容は次のとおりです。

- 第C.1項「GlassFishの構成の概要」

- 第C.2項「GlassFishサーバーおよびOracle ADFランタイムの取得」

- 第C.3項「ADFランタイム・ライブラリを使用したGlassFishの構成」

- 第C.4項「追加の構成タスク」

- 第C.5項「ADFアプリケーションのGlassFishへのデプロイ」

C.1 GlassFishの構成の概要

GlassFishサーバーは、Oracle ADFアプリケーションを実行するように構成できるアプリケーション・サーバーです。GlassFishサーバーがインストールされていない場合、GlassFishサーバーをGlassFish Webサイトからダウンロードできます。GlassFishサーバーでADFアプリケーションを実行する前に、Oracle ADFランタイム・ライブラリを使用してGlassFishを構成する必要があります。

GlassFishに対してサポートされているOracle ADF機能のリストは、OTNサイト(http://content.oracle.com/technetwork/developer-tools/adf/overview/adf-essentials-1719844.html)を参照してください。

GlassFishを取得してインストールする手順は、http://glassfish.java.net/downloads/3.1.2-final.htmlを参照してください。

GlassFish用にADFアプリケーションを開発する方法の詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「ADFアプリケーションのGlassFishへのデプロイ」を参照してください。

C.2 GlassFishサーバーおよびOracle ADFランタイムの取得

Oracle ADF Essentialsは、GlassFishサーバーのオープン・ソース・バージョンおよび市販バージョンをサポートしています。どちらのバージョンもフル・プラットフォームの配布が必要です。Webプロファイルの配布はサポートされていません。GlassFishサーバーをインストールした後、ADF Essentialsのadf-essentials.zipファイルをOTNから取得し、この付録の手順に従ってADFランタイム・ライブラリをインストールする必要があります。

このサーバーおよびその他のアプリケーション・サーバーのタスクを起動および停止する方法の詳細は、GlassFishのWebサイトにあるGlassFishのドキュメントを参照してください。

C.2.1 GlassFishサーバーの取得方法

GlassFishのWebサイトからGlassFishサーバーのオープン・ソース・バージョンをダウンロードできます。

http://glassfish.java.net/downloads/3.1.2-final.html

サイトの手順およびドキュメントに従って、GlassFishサーバーをインストールして構成します。

C.2.2 Oracle ADFランタイムの取得方法

GlassFishサーバーでOracle ADFアプリケーションを実行するには、ADFランタイム・ライブラリ・ファイルをGlassFishのインストール・ディレクトリにインストールする必要があります。

Oracle ADF Essentialsのadf-essentials.zipファイルをOracle Technology Network (http://www.oracle.com/go/?&Src=7578263&Act=4&pcode=WWMK12022244MPP044)からダウンロードできます。

adf-essentials.zipファイルをダウンロードした後、必要なファイルをGlassFishインストール・ディレクトリにコピーするために使用できる一時ディレクトリにファイルを抽出できます。

C.3 ADFランタイム・ライブラリを使用したGlassFishの構成

ADFランタイム・ライブラリは次のものから構成されています。

- ADF Shareライブラリ

- ADF Modelライブラリ

- ADF Controllerライブラリ

- ADF Viewライブラリ

ADF Shareライブラリは、GlassFishインストールに手動でインストールする必要があります。オペレーティング・システムのコマンドまたはツールを使用してファイルをコピーします。手順は、第C.3.1項「ADF Shareライブラリを手動でインストールする方法」を参照してください。

ADF Model、ADF ControllerおよびADF Viewの各ライブラリは、デプロイされるアプリケーションとともにGlassFishにロードされ、JDeveloperによって自動的に組み込まれます。

ADFランタイム・ライブラリをインストールする手順:

1. ADF Shareライブラリを構成します。

- ADF Shareライブラリをadf-essentials.zipからGlassFishインストールにコピーします。

2. アプリケーションをEARファイルとしてデプロイします。

C.3.1 ADF Shareライブラリを手動でインストールする方法

始める前に:

GlassFishのADF Shareをマッピングするときに使用できるオプションについて理解しておくと役立ちます。詳細は、第C.3項「ADFランタイム・ライブラリを使用したGlassFishの構成」を参照してください。

次のタスクを完了する必要があります。

- GlassFishサーバーをインストールします。

- adf-community.zipファイルを取得し、一時ディレクトリに解凍します。

ADF Shareランタイム・ライブラリをインストールする方法:

1. 次のADF Shareライブラリ・ファイルを一時ディレクトリから<glassfish>/domains/domain1/libフォルダにコピーまたは移動します。
ADF Shareファイルは、第C.2.2項「Oracle ADFランタイムの取得方法」で説明しているように、adf-essentials.zipファイルを解凍した一時ディレクトリにあるはずです。通常、このディレクトリは<temp>/oracle_common/modulesになります。

oracle.adf.share.ca_11.1.1/adf-share-base.jar
oracle.adf.share.ca_11.1.1/adf-share-ca.jar
oracle.adf.share_11.1.1/commons-el.jar
oracle.adf.share_11.1.1/adf-share-support.jar
oracle.adf.share_11.1.1/adfsharembean.jar
oracle.adf.share_11.1.1/jsp-el-api.jar
oracle.adf.share_11.1.1/adflogginghandler.jar
oracle.adf.share_11.1.1/oracle-el.jar
oracle.mds_11.1.1/mdsrt.jar
oracle.bali.share_11.1.1/share.jar
oracle.xmlef_11.1.1/xmlef.jar
oracle.javatools_11.1.1/resourcebundle.jar
oracle.javatools_11.1.1/javamodel-rt.jar
oracle.javatools_11.1.1/javatools-nodeps.jar
oracle.adf.security_11.1.1/adf-share-security.jar
oracle.adf.security_11.1.1/adf-controller-security.jar
oracle.xdk_11.1.0/xmlparserv2_sans_jaxp_services.jar
oracle.xdb_11.1.0.jar
oracle.jrf_11.1.1/jrf-api.jar
oracle.jdbc_11.1.1/ojdbc6dms.jar
oracle.dms_11.1.1/dms.jar
oracle.odl_11.1.1/ojdl.jar
oracle.odl_11.1.1/ojdl2.jar
oracle.jmx_11.1.1/jmxframework.jar
oracle.jmx_11.1.1/jmxspi.jar
oracle.classloader_11.1.1.jar
oracle.logging-utils_11.1.1.jar
oracle.web-common_11.1.1.jar
oracle.webservices_11.1.1/oc4j-ws-support.jar
org.apache.bcel_5.1.jar
oracle.nlsrtl_11.2.0/orai18n-mapping.jar

2. すべてのライブラリがコピーされたことを確認します。

C.4 追加の構成タスク

ADFランタイムをGlassFishサーバーにインストールした後、GlassFishで追加の構成タスクを実行する必要があります。

構成タスクは次のとおりです。

- 第C.4.1項「GlassFish管理コンソール」

- 第C.4.2項「GlassFishのデータソースの作成方法」

- 第C.4.3項「JVMキャッシュの構成方法」

C.4.1 GlassFish管理コンソール

GlassFish管理コンソールを使用すると、アプリケーション、JDBCプールおよびその他のリソースの管理などについてGlassFishサーバーを構成できます。

GlassFish管理コンソールは次の場所にあります。

http://<machine_name>:4848/

C.4.2 GlassFishのデータソースの作成方法

始める前に:

GlassFishのデータソースを作成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、第C.2項「GlassFishサーバーおよびOracle ADFランタイムの取得」を参照してください。

GlassFish管理コンソールまたはasadminコマンドを使用してデータソースを作成できます。詳細は、GlassFishのドキュメントを参照してください。

asadminコマンドを使用してGlassFishのデータソースを作成する方法:

1. コマンドライン・ウィンドウを開きます。

2. asadminコマンドを起動してGlassFishのデータソースを作成します。
たとえば、次のコマンドでは、アプリケーションのデータソースが作成されます。

asadmin> create-jdbc-connection-pool --datasourceclassname
oracle.jdbc.pool.SampleDataSource
--restype javax.sql.XADataSource
--property user=xyz
:password=xyz:url=jdbc:oracle:thin:@machine.com:1521:machine
--target=server SampleDSPool

asadmin> ping-connection-pool SampleDSPool

asadmin> create-jdbc-resource --connectionpoolid SampleDSPool jdbc/OracleDS

C.4.3 JVMキャッシュの構成方法

JVM設定をsimpleに構成して、メモリー・サイズを192MBから512MBに増加する必要があります。

始める前に:

GlassFishのJVMを構成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、第C.4項「追加の構成タスク」を参照してください。

MDSのJVMキャッシュを構成する方法:

1. GlassFish管理コンソールを起動します。

2. 「構成」→「server-config」→「JVM設定」を選択します。

3. 「JVMオプション」を選択し、-Doracle.mds.cache=simpleおよびXX:MaxPermSize=512mを指定します。

4. 「保存」をクリックします。

5. または、<glassfish>/domains/domain1/config/domain.xmlファイルを開き、次のエントリを編集します。

<jvm-options>-XX:MaxPermSize=512m</jvm-options>
<jvm-options>-Doracle.mds.cache=simple</jvm-options>

C.5 ADFアプリケーションのGlassFishへのデプロイ

アプリケーションでライブラリを参照した後、そのアプリケーションをGlassFishサーバーにデプロイできます。詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「ADFアプリケーションのGlassFishへのデプロイ」を参照してください。

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