この章では、ターゲット・アプリケーション・サーバーにEARファイルとしてパッケージ化されたOracle ADFアプリケーションをデプロイする方法を説明します。本番および後のステージでのテストのためのADFアプリケーションのデプロイに焦点を当てます。ここでは、ADFランタイムをインストールしてアプリケーション・サーバーのデプロイを準備する方法について説明します。また、デプロイに使用できるツール(Oracle Enterprise Manager Fusion Middleware Control、スクリプト、Antなど)についてもいくつか説明します。
この章の内容は次のとおりです。
開発のためのADFアプリケーションのデプロイについては、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』を参照してください。
デプロイとは、アプリケーションのファイルおよび成果物をパッケージ化し、実行するターゲット・アプリケーション・サーバーに転送するプロセスです。JDeveloperを使用したアプリケーションのデプロイの際、開発者はJDeveloperインストールに組み込まれている統合WebLogic Serverを使用してアプリケーションをテストできます。または、JDeveloperを使用して直接スタンドアロン・アプリケーション・サーバーにデプロイすることもできます。
アプリケーションの開発が完了すると、管理者は本番のアプリケーション・サーバーにアプリケーションをデプロイできます。本番レベルのデプロイに使用するツールは次のとおりです。
Oracle Enterprise Manager Fusion Middleware Control
WebLogic Scripting Tool (WLST)コマンド
コマンド・スクリプトおよびAntスクリプト
Oracle WebLogic管理コンソール
この章では、管理者がADFアプリケーションのデプロイに使用するツールおよびメソッドについて説明します。JDeveloperを使用した開発およびテストのためのADFアプリケーションのデプロイについては、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』を参照してください。
アプリケーションでカスタマイズを使用している場合、アプリケーション・サーバー内のMDSリポジトリの設定が必要となることがあります。MDSの詳細は、『Oracle Fusion Middlewareの管理』を参照してください。
注意: 開発者、テストおよび品質保証担当者も、この章のツールおよびメソッドを使用して、ADFアプリケーションをステージング・アプリケーション・サーバーにデプロイできます。 |
ADFアプリケーションを実行するには、スタンドアロン・アプリケーション・サーバーをADFランタイムとともにインストールする必要があります。ADFランタイムは、アプリケーション・サーバーの新規インストール時に組み込むことも、既存のアプリケーション・サーバーのインストール先にインストールすることもできます。
図4-1に、スタンドアロン・アプリケーション・サーバーのデプロイの準備のフロー・ダイアグラムを示します。ダイアグラムでは、次の定義が使用されます。
OWSM: Oracle Web Services Manager
JRF: Java Required Files
RCU: リポジトリ作成ユーティリティ
MDS: メタデータ・ストア
次のダイアグラムには、クリック可能なリンクが含まれています。
WebLogic Serverの場合、次の点が該当します。
WebLogic ServerにADFランタイムをインストールしたら、新しいWebLogic Serverドメインを作成するか、既存のWebLogic ServerドメインをOracle ADF用に拡張することができます。
管理対象サーバーが管理サーバーとは異なるホストに位置している場合、追加の構成タスクを実行して、管理対象サーバーがADFアプリケーションをホストできるようにする必要があります。
ADFアプリケーションはJDBCデータ・ソースまたはJDBC URLを使用してデータにアクセスします。Oracle WebLogic Server管理コンソールを使用すれば、WebLogic Serverをデータ・ソースに対して構成できます。
既存のOracle Fusion Middleware環境にパッチを適用するためのOPatchの詳細は、『Opatchによるパッチ適用』を参照してください。
多数のOracle Fusion Middlewareコンポーネントで必要となるスキーマの作成およびロード方法の詳細は、『Repository Creation Utilityによるスキーマの作成』を参照してください。
Oracle Application Development FrameworkおよびOracle JDeveloperの最新情報は、Oracle Technology NetworkのOracle JDeveloperリリース・ノートを参照してください。
アプリケーション・サーバーは、ADFアプリケーションを実行するために、ADFランタイムを必要とします。
JDeveloperを使用して、統合WebLogic Serverでアプリケーションを実行する場合、ADFランタイムをインストールする必要はありません。
WebLogic Serverの場合、ADFランタイムは、次のインストーラを使用してインストールできます。
Oracle Fusion Middleware Application Developer Infrastructure Installer: ADFランタイムおよびOracle Enterprise Managerをインストールします。Oracle Enterprise Managerを使用してスタンドアロンのADFアプリケーション(Oracle SOA SuiteやOracle WebCenter Portalのコンポーネントなし)を管理するには、Oracle Fusion Middleware Infrastructure Installerを使用します。詳細は、『Oracle Fusion Middleware Infrastructureのインストールと構成』を参照してください。
注意: アプリケーション・サーバー・インストールへのADFランタイムのインストールには、Oracle JDeveloper Installerも使用できます。ただし、これには通常本番およびフル・テスト環境に必要なコンポーネントがすべて含まれているわけではありません。したがって、このインストーラは開発目的以外では使用しないでください。インストーラの取得と使用の詳細は、『Oracle Jdeveloperのインストール』を参照してください。 |
Oracle Fusion Middleware Infrastructure Installerを使用して、ADFランタイムとEnterprise Managerをインストールできます。
Oracle WebLogic Serverをインストールします。Oracle Fusion Middleware Infrastructure Installerを入手しておくことも必要です。
『Oracle Fusion Middlewareのインストールのプランニング』の説明に従ってソフトウェアを取得し、インストーラを起動し、インストールを完了します。
インストーラでは、次のタスクを含むいくつかのタスクを実行します。
ソフトウェア更新の追加
インストールのためのWebLogic Serverディレクトリの選択
インストール情報の検証
ADFランタイムをインストールしたら、第4.2.3項の説明に従って、Oracle Fusion Middleware構成ウィザードを使用してOracle WebLogic Serverドメインを作成または拡張します。
パッチおよびその他の更新をソフトウェア配布にインストールする必要が生じる場合があります。詳細は、『Opatchによるパッチ適用』を参照してください。
ADFアプリケーションを使用するには、Oracle WebLogic Serverドメインを作成し、構成する必要があります。ドメインがまだない場合は、作成する必要があります。すでにドメインがある場合、ドメインを拡張して、ADFアプリケーションを実行できるようにする必要があります。
管理対象サーバーを使用してアプリケーションを実行する場合、管理対象サーバーの構成が必要になることがあります。Oracle WebLogic Serverでの管理対象サーバーの構成の詳細は、『構成ウィザードによるWebLogicドメインの作成』を参照してください。
管理対象サーバーが管理サーバーと同じホストに位置している場合に、ADF用に管理対象サーバーを設定するには、この項で説明する手順に従います。
管理サーバーとは異なるホストに位置する管理対象サーバーにデプロイするための設定を行う場合は、第4.2.3.3項の説明に従って追加の手順を実行します。
Oracle ADF用にWebLogic Serverドメインを作成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、4.2項を参照してください。
新しいOracle WebLogic Serverドメインを作成する手順:
『Oracle Fusion Middleware Infrastructureのインストールと構成』の「WebLogicドメインの構成」の章の説明に従って、Oracle Fusion Middleware構成ウィザードを開始します。
このガイドの指示に従いますが、次の手順を考慮してください。
「ようこそ」ページで「新規ドメインを作成」を選択し、「次へ」をクリックします。
「テンプレート」ページで、「製品テンプレートを使用してドメインを作成」を選択します。
オプション基本WebLogic Serverドメイン - 12.1.2.0 [wlserver]がすでに選択されています。
「Oracle JRF - 12.1.2.0 [oracle_common]」を選択します。Oracle Web Servicesを使用している場合は、Oracle WSMポリシー・マネージャ12.1.2.0 [oracle_common]を選択し、「次へ」をクリックします。
引き続き『Oracle Fusion Middleware Infrastructureのインストールと構成』の指示に従ってください。
Oracle ADF用にWebLogic Serverドメインを拡張するときに使用できるオプションについて理解しておくと役立ちます。詳細は、4.2項を参照してください。
ADFランタイムがインストールされたOracle WebLogic Serverドメインが必要になります。
ADF用にOracle WebLogic Serverドメインを拡張する手順:
『Oracle Fusion Middleware Infrastructureのインストールと構成』の「WebLogicドメインの構成」の章の説明に従って、Oracle Fusion Middleware構成ウィザードを開始します。
このガイドの指示に従いますが、次の手順を考慮してください。
「ようこそ」ページで、「既存ドメインの更新」を選択します。
Oracle ADF用に更新するドメインの場所を選択し、「次へ」をクリックします。
「テンプレート」ページで、「製品テンプレートを使用してドメインを更新」を選択します。
オプション基本WebLogic Serverドメイン - 12.1.2.0 [wlserver]がすでに選択されています。
「Oracle JRF - 12.1.2.0 [oracle_common]」を選択します。Oracle Web Servicesを使用している場合は、Oracle WSMポリシー・マネージャ12.1.2.0 [oracle_common]を選択し、「次へ」をクリックします。
引き続き『Oracle Fusion Middleware Infrastructureのインストールと構成』の指示に従ってください。
これにより、manifest
ファイルを使用して、その他のランタイム.jar
ファイルが構成されます。
注意: アプリケーションのEARファイルには、 |
これで、コマンドライン・スクリプト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
を使用します。
WebLogic管理対象サーバーが管理サーバーとは異なるホストに位置している場合、追加のステップを実行する必要があります。
管理サーバーの位置するホストでOracle ADF用に管理対象サーバーを設定してから、JRFテンプレートを圧縮してリモート・ホストにコピーし、解凍する必要があります。
Oracle ADF用にリモートのWebLogic管理対象サーバーを作成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、4.2項を参照してください。
pack
とunpack
コマンドを使用した管理対象サーバーの設定の詳細は、『PackおよびUnpackコマンドによるテンプレートとドメインの作成』を参照してください。
次のタスクを完了する必要があります。
管理サーバーの位置するホストでOracle ADF用に管理対象サーバーを設定します。
JRFテンプレートを圧縮します。
テンプレートをリモート・ホストにコピーします。
テンプレートを解凍します。
Oracle ADF用にリモート管理対象サーバーを設定する手順:
Oracle Installer for JDeveloperを使用して、ローカルとリモート両方のホストにOracle WebLogic Serverをインストールします(まだインストールしていない場合)。JDeveloper Studioをインストールしない場合は、インストーラでApplication Development Frameworkランタイム・オプションを選択する必要があります。ローカル・ホストは、管理サーバーが位置するホストです。
Weblogic Serverがすでにインストールされている場合は、Oracle Installer for JDeveloperを使用し、Application Development Frameworkランタイム・オプションを選択して、両方のホストのWebLogic Serverインストール先にADFランタイムをインストールします。インストールの詳細は、第4.2.1項を参照してください。
Oracle Fusion Middleware構成ウィザードを実行して、新しいOracle WebLogic Serverドメインを作成します。ウィザードで、第4.2.3.1項で説明するように、「Oracle JRF」オプションを選択します。
ローカル・ホストでOracle Fusion Middleware構成ウィザードを実行して、管理対象サーバーを作成します。
ローカル・ホストで、管理サーバーと管理対象サーバーを起動します。
次に例を示します。
cd ORACLE_HOME/user_projects/domain/base_domain/bin ./startWeblogic.sh ./startManagedWebLogic.sh ManagedServer_1 http://localhost:7001
ローカル・ホストで管理対象サーバーの構成情報を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
/
リモート・ホストで、管理対象サーバーの構成JARを解凍します。
次に例を示します。
cd ORACLE_HOME/oracle_common/common/bin ./unpack.sh -domain=../../../user_projects/domains/base_domain -template=../../../base_domain_managed.jar
管理対象サーバーがドメインより後に作成された場合は、unpack
を実行する前に、管理対象サーバーのドメイン構成ディレクトリ全体を削除する必要があります。
リモート・ホストで、ノード・マネージャを起動します。
次に例を示します。
cd ORACLE_HOME/wlserver_10.3/server/bin ./startNodeManager.sh
管理対象サーバーの作成時にJRFテンプレートを適用しなかった場合は、リモート・ホストでapplyJRF
WLSTコマンドを実行し、管理対象サーバーをJRFテンプレートで拡張します。
また、管理対象サーバーがドメインより後に作成された場合は、applyJRF
を実行する前に、管理対象サーバーのドメイン構成ディレクトリ全体を削除する必要があります。
両方のホストで、管理対象サーバーを起動します。
次に例を示します。
cd ORACLE_HOME/user_projects/domains/base_domain/bin./startManagedWebLogic.sh ManagedServer_2 http://<adminServerHost>:7001
Oracle WebLogic Server管理コンソールを使用して、使用しているアプリケーションのWebLogic Serverインスタンス内にJDBCデータ・ソースを設定します。
JDBCデータ・ソースの作成時には使用可能なオプションに関する知識が役立つ場合があります。詳細は、4.2項を参照してください。
JDBCデータ・ソース用にOracle WebLogic Serverを構成する手順:
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インスタンスを右クリックし、「管理コンソールの起動」を選択します。
Windowsの「スタート」メニューから「Oracle Fusion Middleware」→「User Projects」→「Domain」→「Admin Server Console」を選択して、Oracle WebLogic Server管理コンソールを起動します。
Oracle WebLogic Server管理コンソールにログインします。
「WebLogic Server管理コンソール」ページで、「JDBC」→「データ・ソース」を選択します。
「New」をクリックします。
JDBCデータ・ソースのプロパティ・ページで、次の作業を行います。
「名前」フィールドに、JDBCデータ・ソースの名前を入力します。
「JNDI」フィールドに、「jdbc/
connection
DS
」という形式で接続名を入力します。
「データベースのタイプ」には、「Oracle」を選択します。
「データベース・ドライバ」には「Oracleドライバ(シン)」を選択し、「次へ」をクリックします。
トランザクション・オプションのページで、デフォルトのオプションをそのまま使用し、「次へ」をクリックします。
接続プロパティのページで次の作業を行います。
データベース名にOracle SIDを入力します。たとえば、orcl
と入力します。
ホスト名にデータベースのマシン名を入力します。
データベースにアクセスするために使用するポート番号を入力します。
データベースのユーザー名とパスワードを入力して、「次へ」をクリックします。
データベース接続のテスト・ページで、「構成のテスト」をクリックして接続をテストします。
「ターゲットの選択」ページで、JDBCデータ・ソースをデプロイするサーバーを選択します。
「終了」をクリックします。
データ・ソースがOracle WebLogic Serverで作成されたら、アプリケーション・モジュールで使用できます。
Oracle Enterprise Manager Fusion Middleware Controlを使用して、JDeveloperで作成されたEARファイルをデプロイできます。Fusion Middleware Controlは、ファームの監視および管理に使用できるWebブラウザベースのグラフィカル・ユーザー・インタフェースです。Fusion Middleware Controlを使用したデプロイの詳細は、『Oracle Fusion Middlewareの管理』を参照してください。
アプリケーションまたはモジュールは、JDeveloper IDEを起動せずにJDeveloperからデプロイできます。WLSTコマンドは、コマンドラインから実行することも、スクリプトで順序付けてバッチとして実行することもできます。
コマンドラインからデプロイするには、アプリケーションのデプロイメント・プロファイル(EAR)またはプロジェクトのデプロイメント・プロファイル(JARまたはWAR)が必要です。特定のタイプのアプリケーションの場合、JDeveloperはこれらのデプロイメント・プロファイルを自動的に作成しますが、デプロイのコマンドを使用する前に、デプロイメント・プロファイルが存在することを確認することが重要です。プロファイルが存在することを検証するには、JDeveloperの「アプリケーションのプロパティ」または「プロジェクト・プロパティ」から「デプロイメント」ノードを選択します。プロファイルのデプロイの詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』を参照してください。
JDeveloperは、アプリケーションのEAR、WARまたはJARファイルのデプロイにも使用できます。コマンドラインによるデプロイに使用するスクリプトと同じスクリプトを、JDeveloperによるデプロイでも使用しますが、JDeveloperでは構文を作成し、デプロイのためのユーザー・インタフェースを提供します。
ADFアプリケーションの処理に固有のWLSTコマンド(WebLogic)があります。これらのコマンドのリストは、第6章「ADFアプリケーションのためのWLSTコマンド・リファレンス」を参照してください。
WLSTスクリプトの使用の詳細は、『WebLogic Server WLSTコマンド・リファレンス』を参照してください。
コマンドおよびスクリプトを使用してアプリケーションをデプロイできます。ojdeploy
コマンドを使用してアプリケーションをデプロイし、ojaudit
コマンドを使用してアプリケーションのプロジェクト、ワークスペースまたはソース・ファイルを監査するスクリプトを作成します。たとえば開発者が新しい変更をチェックインするたびに自動的に実行されるようにスクリプトを設定することもできます。
ojdeploy
スクリプトおよびAntスクリプトは、一緒に使用することも個別に使用することも可能です。
アプリケーションをコンパイル、パッケージ化およびデプロイするojdeploy
スクリプトを作成します。
アプリケーションをコンパイルおよびパッケージ化するojdeploy
スクリプトを作成します。その後、Antスクリプト(WLDeploy
など)を使用してアプリケーションをデプロイします。
アプリケーションをコンパイル、パッケージ化およびデプロイするAntスクリプトを作成します。このAntではojdeploy
を使用する必要はありません。
ojdeploy
コマンドおよびojaudit
コマンドの詳細は、JDeveloperオンライン・ヘルプを参照してください。
JDeveloperからほとんどのアプリケーション・サーバーにデプロイできます。または、アプリケーション・サーバーのベンダーによって提供されるツールを使用することもできます。Antを使用して、アプリケーションをパッケージ化し、デプロイすることもできます。Antのデプロイメント・コマンドを含むbuild.xml
ファイルは、ターゲット・アプリケーション・サーバーによって異なります。
他のアプリケーション・サーバーへのデプロイについては、アプリケーション・サーバーのマニュアルを参照してください。アプリケーション・サーバーが特定のAntタスクを提供していない場合は、汎用Antタスクを使用できる可能性があります。たとえば、汎用のear
タスクによってEARファイルが作成されます。
Antの詳細は、http://ant.apache.org
を参照してください。
WebLogicの場合、Oracle WebLogic Server管理コンソールを使用して、JDeveloperで作成されたEARファイルをデプロイできます。詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。