管理およびコンフィグレーション ガイド

Oracle CEP スタンドアロンサーバ ドメインの作成と更新

この節では、以下の項目について説明します。

Oracle CEP サーバおよびドメインの概要

Oracle CEP サーバは、論理的に関連したリソースとサービスで構成され、Oracle CEP アプリケーションのデプロイ先となります。サービスには、Jetty (HTTP サーバ)、JDBC データソース、HTTP パブリッシュ/サブスクライブ サーバ、およびロギングがあります。サーバに適用されるすべてのファイルが単一のサーバ ディレクトリに格納されます。サーバのメイン コンフィグレーション ファイルは config.xml と呼ばれます。このファイル内にサーバのサービスをコンフィグレーションし、サーバが属するドメインを指定します。

Oracle CEP ドメインは、一連のサーバからなる管理の単位です。次の 2 種類のドメインがあります。

マルチサーバ ドメインのサーバは、同じコンピュータ上に配置することも、別々のコンピュータ上に配置することもできます。マルチサーバ ドメインのサーバは、同じマルチキャスト アドレスとマルチキャスト ポートを共有し、同じドメインに属することで、互いに関連付けられます。この設定はすべて、サーバの config.xml ファイルでコンフィグレーションされます。

以下に、ドメイン内のサーバの重要なファイルとディレクトリを、サーバ ディレクトリ (メインのドメイン ディレクトリのサブディレクトリ) の相対パスで示します。

Configuration Wizard を使用して既存のサーバを更新し、管理者ユーザ、リスン ポート、および JDBC コンフィグレーションを再コンフィグレーションすることもできます。

Configuration Wizard を使用したスタンドアロンサーバ ドメインの作成

Oracle CEP をインストールした後、Configuration Wizard を使用して新しいドメインを作成し、アプリケーションをデプロイします。Configuration Wizard では、デフォルトにより、ORACLE_CEP_HOME/user_projects/domains ディレクトリにドメインが作成されます。ORACLE_CEP_HOME は d:/oracle_cep などの Oracle CEP インストール ディレクトリです。任意のディレクトリにドメインを作成することもできます。

Configuration Wizard では、ドメイン内に単一のデフォルト サーバが作成されます。サーバ関連ファイルはすべて、サーバと同じ名前のドメイン ディレクトリのサブディレクトリに格納されます。また、Configuration Wizard で以下の処理を実行できます。

Configuration Wizard では、以下のいずれかのモードを利用できます。

グラフィカル モードでのドメインの作成

以下の手順では、Configuration Wizard をグラフィカル モードで起動して使用する方法を示します。Windows または Unix のいずれの場合も、それぞれに該当するコマンド スクリプトを実行します。Windows では、次のように [スタート] メニューを使用して Configuration Wizard を起動することもできます。

[スタート] > [すべてのプログラム] > [Oracle Complex Event Processing 10gR3] > [Tools] > [Configuration Wizard]

グラフィカル モードで Configuration Wizard を起動して使用するには、以下の手順を実行します。

サイレント モードでのドメインの作成

Configuration Wizard をサイレント モードで使用すると、非対話的な方法でドメインを作成およびコンフィグレーションできます。この方法では、コンフィグレーション オプションを選択するために XML プロパティ ファイルを使用する必要があります。サイレント モードを使用して Configuration Wizard を実行するには、以下の手順を実行します。

silent.xml ファイルの作成

サイレント モードで Configuration Wizard を実行する場合、使用するコンフィグレーション オプションは XML ファイル (silent.xml) によって決定します。

silent.xml ファイルを作成するには、以下の手順を実行します。

silent.xml ファイルのサンプル

<?xml version="1.0" encoding="UTF-8"?>

<bea-installer xmlns="http://www.bea.com/plateng/wlevs/config/silent">

  <input-fields>

    <data-value name="CONFIGURATION_OPTION" value="createDomain" />
    <data-value name="USERNAME" value="wlevs" />
    <data-value name="PASSWORD" value="wlevs" />

    <data-value name="SERVER_NAME" value="my_wlevs_server" />
    <data-value name="DOMAIN_NAME" value="mydomain" />
    <data-value name="DOMAIN_LOCATION" value="C:\oracle_cep\user_projects\domains" />

    <data-value name="NETIO_PORT" value="9002" />
    <data-value name="RMI_REGISTRY_PORT" value="9004" />
    <data-value name="RMI_JRMP_PORT" value="9999" />
    <data-value name="KEYSTORE_PASSWORD" value="my_keystore_password" /> 
    <data-value name="PRIVATEKEY_PASSWORD" value="my_privatekey_password" /> 

    <data-value name="DB_URL" value="jdbc:bea:oracle://localhost:1521:XE" />
    <data-value name="DB_USERNAME" value="db_user" />
    <data-value name="DB_PASSWORD" value="db_password" />

  </input-fields>

</bea-installer>

コマンド ウィンドウでの終了コードの戻り値

Configuration Wizard をサイレント モードで実行すると、ドメインの作成とコンフィグレーションが成功したか失敗したかを示す終了コードが生成されます。生成される終了コードを次の表に示します。

コード リスト 2-1 は、サイレント モードで Configuration Wizard を呼び出し、スクリプトを実行したコマンド ウィンドウに終了コードをエコーする Windows コマンド ファイルのサンプルを示しています。

rem Execute the Configuration Wizard in silent mode
@echo off
config.cmd -mode=silent -silent_xml=c:\scripts\silent.xml  -log=C:\logs\create_domain.logs

@rem Return an exit code to indicate success or failure
set exit_code=%ERRORLEVEL%

@echo.
@echo Exitcode=%exit_code%
@echo.
@echo Exit Code Key
@echo ---------------
@echo  0=Configuration Wizard completed successfully
@echo -1=Configuration Wizard failed due to a fatal error
@echo -2=Configuration Wizard failed due to an internal XML parsing error
@echo.

Configuration Wizard を使用した既存のサーバの更新

Configuration Wizard を使用してドメイン内の既存のサーバを更新します。その手順は新しいドメインとデフォルト サーバを作成する手順に似ています。そのため、この節の手順は「Configuration Wizard を使用したスタンドアロンサーバ ドメインの作成」を読んでから実行してください。

ドメイン内の既存サーバのコンフィグレーション オプションのうち、更新できるのは以下のオプションのみです。

わかりやすくするために、この節では、productionServer というサーバを更新し、サーバ関連ファイルは C:\oracle_cep\user_projects\domains\mydomain\productionServer ディレクトリに格納されていると想定します。

グラフィカル モードでの既存サーバの更新

Configuration Wizard をグラフィカル モードで使用してドメイン内の既存のサーバを更新するには、以下の手順を実行します。

サイレント モードでの既存サーバの更新

サイレント モードでドメイン内の既存サーバを更新する手順は、「サイレント モードでのドメインの作成」で説明した新しいドメインの作成手順に似ています。主な違いは、silent.xml ファイルのオプションの値です。特に、以下の情報を入力します。

「Configuration Wizard を使用した既存のサーバの更新」で示した想定に従って、silent.xml ファイルは次のようになります。

<?xml version="1.0" encoding="UTF-8"?>

<bea-installer xmlns="http://www.bea.com/plateng/wlevs/config/silent">

 <input-fields>
  <data-value name="CONFIGURATION_OPTION" value="updateDomain" /> 
  <data-value name="EXISTING_DOMAIN_PATH" value="C:\oracle_cep\user_projects\domains\mydomain\productionServer" /> 

  <data-value name="NETIO_PORT" value="9102" />
  <data-value name="RMI_REGISTRY_PORT" value="9104" />
  <data-value name="RMI_JRMP_PORT" value="9998" />

  <data-value name="DB_URL" value="jdbc:bea:oracle://localhost:1521:XE" />
  <data-value name="DB_USERNAME" value="db_user" />
  <data-value name="DB_PASSWORD" value="db_password" />

 </input-fields>

</bea-installer>

サーバの停止と起動

各 Oracle CEP サーバ ディレクトリには、サーバ インスタンスを起動するコマンド スクリプトが含まれています。デフォルトのスクリプトは startwlevs.cmd (Windows) または startwlevs.sh (UNIX) です。サーバを停止するスクリプトは、stopwlevs.cmd (Windows) または stopwlevs.sh (UNIX) です。

サーバの起動

Oracle CEP のインスタンスを起動するには、以下の手順を実行します。

stopwlevs スクリプトを使用したサーバの停止

実行中の Oracle CEP サーバ インスタンスを停止するには、以下の手順を実行します。

次の手順

独自の Oracle CEP スタンドアロンサーバ ドメインを作成した後、以下の手順を実行できます。