ヘッダーをスキップ
Oracle® Fusion Middleware Oracle ADFアプリケーションの管理
12c (12.2.1)
E70025-02
  目次へ移動
目次

前
次
 

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

この章では、ターゲット・アプリケーション・サーバーにEARファイルとしてパッケージ化されたOracle ADFアプリケーションをデプロイする方法を説明します。本番および後のステージでのテストのためのADFアプリケーションのデプロイに焦点を当てます。ここでは、ADFランタイムをインストールしてアプリケーション・サーバーのデプロイを準備する方法について説明します。また、デプロイに使用できるツール(Oracle Enterprise Manager Fusion Middleware Control、スクリプト、Antなど)についてもいくつか説明します。

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

開発のためのADFアプリケーションのデプロイについては、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』を参照してください。

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

デプロイとは、アプリケーションのファイルおよびアーティファクトをパッケージ化し、実行するターゲット・アプリケーション・サーバーに転送するプロセスです。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アプリケーションをステージング・アプリケーション・サーバーにデプロイできます。

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

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

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

  • OWSM: Oracle Web Services Manager

  • JRF: Java Required Files

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

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

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

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

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

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

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

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

  • 既存のOracle Fusion Middleware環境にパッチを適用するためのOPatchの詳細は、『Opatchによるパッチ適用』を参照してください。

  • スキーマの作成およびロードの詳細は、『リポジトリ作成ユーティリティを使用したスキーマの作成』を参照してください。

  • Oracle Application Development FrameworkおよびOracle JDeveloperの最新情報は、Oracle Technology NetworkのOracle JDeveloperリリース・ノートを参照してください。

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

アプリケーション・サーバーは、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のインストール』を参照してください。

4.2.1.1 Oracle Fusion Middleware Infrastructureのインストールの使用

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

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

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

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

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

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

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

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

4.2.2 関連するパッチのインストール

パッチおよびその他の更新をソフトウェア配布にインストールする必要が生じる場合があります。詳細は、OPatchを使用したパッチ適用を参照してください。

4.2.3 Oracle WebLogic Serverドメインの作成と拡張

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

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

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

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

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

Oracle ADF用にWebLogic Serverドメインを作成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、「スタンドアロン・アプリケーション・サーバーのデプロイの準備」を参照してください。

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

  1. 『Oracle Fusion Middleware Infrastructureのインストールと構成』の「WebLogicドメインの構成」の章の説明に従って、Oracle Fusion Middleware構成ウィザードを開始します。

    このガイドの指示に従いますが、次の手順を考慮してください。

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

  3. 「テンプレート」ページで、「製品テンプレートを使用してドメインを作成」を選択します。

    オプション基本WebLogic Serverドメイン - 12.1.2.0 [wlserver]がすでに選択されています。

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

  4. 引き続き『Oracle Fusion Middleware Infrastructureのインストールと構成』の指示に従ってください。

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

Oracle ADF用にWebLogic Serverドメインを拡張するときに使用できるオプションについて理解しておくと役立ちます。詳細は、「スタンドアロン・アプリケーション・サーバーのデプロイの準備」を参照してください。

ADFランタイムがインストールされたOracle WebLogic Serverドメインを作成する必要があります。

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

  1. 『Oracle Fusion Middleware Infrastructureのインストールと構成』の「WebLogicドメインの構成」の章の説明に従って、Oracle Fusion Middleware構成ウィザードを開始します。

    このガイドの指示に従いますが、次の手順を考慮してください。

  2. 「ようこそ」ページで、「既存ドメインの更新」を選択します。

  3. Oracle ADF用に更新するドメインの場所を選択し、「次へ」をクリックします。

  4. 「テンプレート」ページで、「製品テンプレートを使用してドメインを更新」を選択します。

    オプション基本WebLogic Serverドメイン - 12.1.2.0 [wlserver]がすでに選択されています。

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

  5. 引き続き『Oracle Fusion Middleware Infrastructureのインストールと構成』の指示に従ってください。

これにより、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.shstopWebLogic.shをそれぞれ使用します。

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

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

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

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

Oracle ADF用にリモートのWebLogic管理対象サーバーを作成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、「スタンドアロン・アプリケーション・サーバーのデプロイの準備」を参照してください。

packunpackコマンドを使用した管理対象サーバーの設定の詳細は、『PackおよびUnpackコマンドによるテンプレートとドメインの作成』を参照してください。

次のタスクを完了する必要があります。

  1. 管理サーバーの位置するホストでOracle ADF用に管理対象サーバーを設定します。

  2. JRFテンプレートを圧縮します。

  3. テンプレートをリモート・ホストにコピーします。

  4. テンプレートを解凍します

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ランタイムをインストールします。インストールの詳細は、「アプリケーション・サーバー・インストールへのADFランタイムのインストール」を参照してください。

  2. Oracle Fusion Middleware構成ウィザードを実行して、新しいOracle WebLogic Serverドメインを作成します。ウィザードでは、「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
    

4.2.4 Oracle WebLogic ServerのJDBCデータ・ソースの作成

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

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. 「新規」をクリックします。
  6. JDBCデータ・ソースのプロパティ・ページで、次の作業を行います。
    • 「名前」フィールドに、JDBCデータ・ソースの名前を入力します。

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

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

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

  7. トランザクション・オプションのページで、デフォルトのオプションをそのまま使用し、「次へ」をクリックします。
  8. 接続プロパティのページで次の作業を行います。
    • データベース名にOracle SIDを入力します。たとえば、orclと入力します。

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

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

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

  9. データベース接続のテスト・ページで、「構成のテスト」をクリックして接続をテストします。
  10. 「ターゲットの選択」ページで、JDBCデータ・ソースをデプロイするサーバーを選択します。
  11. 「終了」をクリックします。

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

4.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の管理』を参照してください。

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

アプリケーションまたはモジュールは、JDeveloper IDEを起動せずにJDeveloperからデプロイできます。WLSTコマンドは、コマンドラインから実行することも、スクリプトで順序付けてバッチとして実行することもできます。

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

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

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

WLSTスクリプトの使用の詳細は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』を参照してください。

4.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を参照してください。

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

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

4.7 Oracle Java Cloud Serviceの使用のデプロイ

次のいずれかのオプションを使用して、Oracle Java Cloud ServiceのWebLogic Serverインスタンスへアプリケーションをデプロイできます。

  • Oracle JDeveloperからセキュアなシェル(SSH)・トンネルを通じて

  • WebLogic Server管理コンソールからOracle Java Cloud Serviceクラウド・ポータルのメニューを通じて

  • WebLogic ServerのOracle Enterprise Manager Fusion Middleware ControlからOracle Java Cloud Serviceクラウド・ポータルのメニューを通じて

  • WebLogic Scripting ToolからSSHクライアントを通じて

詳細は、Oracle Java Cloud Serviceとともに提供されるドキュメントを参照してください。