Sun Java ロゴ     前へ      目次      索引      次へ     

Sun ロゴ
Sun Java System Messaging Server 6 2004Q2 管理ガイド 

付録 B
Messaging Server の Event Notification Service (ENS) を管理する

この付録では、Event Notification Service Publisher (ENS Publisher) を有効にし、Messaging Server の Event Notification Service (ENS) を管理するために必要な事柄について説明します。

この付録には、以下の節があります。

ENS および ENS API の詳細は、Sun Java System Calendar Server のマニュアルの Web ページ (http://docs.sun.com/db/prod/entsys?l=ja) および Messaging Server のマニュアルの Web ページ (http://docs.sun.com/db/prod/entsys?l=ja) にある『Event Service Notification Manual for Sun Java System Communications Services』を参照してください。


Messaging Server に ENS Publisher をロードする

Event Notification Service (ENS) (ENS) は、基礎となる発行および購読サービスです。ENS は、Sun Java System アプリケーションが関係する特定のタイプのイベントの収集の中心点として使用するディスパッチャとして機能します。イベントは、リソースの 1 つまたは複数のプロパティの値に変更されます。このようなタイプのイベントが発生する時期を知る必要があるアプリケーションを、ENS に登録します。ENS は、イベントを順番に識別し、通知と購読を照合します。

ENS と iBiff (Messaging Server の ENS Publisher) は、Messaging Server に含まれています。デフォルトでは、ENS は有効になっていますが、iBIFF はロードされていません (「Messaging Server に ENS Publisher をロードするには」を参照)。

Messaging Server で通知を購読するには、Messaging Server ホストに libibiff ファイルをロードしてから、Messaging Server を停止し、再起動します。

Messaging Server に ENS Publisher をロードするには

コマンド行から以下の手順を実行します。以下の手順では、Messaging Server のインストールディレクトリの位置は msg_svr_base で、Messaging Server ユーザーは inetuser です。これらの変数の一般的な値は、前者は /opt/SUNWmsgsr、後者は inetuser です。

  1. inetuser として、configutil ユーティリティを実行して libibiff ファイルをロードします。
  2. cd msg_svr_base

    ./configutil -o "local.store.notifyplugin" -v "msg_svr_base/lib/libibiff"

  3. root として、Messaging Server をいったん停止してから再起動します。
  4. cd msg_svr_base/sbin

    ./stop-msg

    ./start-msg

  5. これで、ENS によって通知を受け取る準備ができました。詳細は、「Event Notification Service (ENS)のサンプルプログラムを実行する」を参照してください。


Event Notification Service (ENS)のサンプルプログラムを実行する

Messaging Server には、通知の受信方法を学習するためのサンプルプログラムが含まれています。これらのサンプルプログラムは、msg_svr_base/examples ディレクトリにあります。

ENS のサンプルプログラムを実行するには

  1. msg_svr_base/examples ディレクトリに変更します。
  2. C コンパイラを使用して、Makefile.sample ファイルを使用する apub および asub の例をコンパイルします。msg_svr_base/examples ディレクトリを含むように、ライブラリ検索パスを設定します。
  3. プログラムをコンパイルしたら、それらを以下のように別々のウィンドウで実行することができます。
  4. apub localhost 7997

    asub localhost 7997

    apub ウィンドウで入力するものはすべて、asub ウィンドウに表示されます。また、デフォルト設定を使用している場合は、すべての iBiff 通知が asub ウィンドウに表示されます。

  5. iBiff が発行した通知を受け取るには、asub.c と同様のプログラムを記述します。
  6. サンプルプログラムの詳細と ENS のプログラムを独自に記述する方法については、『iPlanet Event Notification Service for Messaging and Collaboration Manual』を参照してください。


    msg_svr_base/lib ディレクトリを含むようにライブラリ検索パスを設定すると、その後はディレクトリサーバーを停止して再起動することはできなくなります。これを回避するには、ライブラリ検索パスからエントリを削除します。



Event Notification Service (ENS) を管理する

ENS の管理は、サービスの起動と停止、および、ENS の iBiff publisher の動作を制御するための設定パラメータの変更によって行います。

ENS を起動および停止する

ENS サーバーを起動および停止するには、start-msg ens および stop-message ens コマンドを使用します。これらのコマンドは、root として実行する必要があります。

ENS を起動および停止するには

iPlanet Event Notification Service設定パラメータ

いくつかの設定パラメータが iBiff の動作を制御します。これらのパラメータを設定するには、configutil ユーティリティプログラムを使用します。

表 B-1 iBiff 設定パラメータ 

パラメータ

説明

local.store.notifyplugin.maxHeaderSize

通知とともに送信されるヘッダーの最大サイズをバイト単位で指定する。デフォルトは 0 バイト

local.store.notifyplugin.maxBodySize

通知とともに送信される本文の最大サイズをバイト単位で指定する。デフォルトは 0 バイト

local.store.notifyplugin.eventType.enable

指定のイベントタイプが通知を生成するかどうかを指定する。ReadMsgNewMsg などのさまざまな eventTypes については、『Messaging Server for Messaging and Collaboration Manual』を参照。正当な値は 1 (有効にする) および 0 (無効にする)。デフォルト値は 1。つまり、local.store.notifyplugin.ReadMsg.enable0 に設定すると、ReadMsg 通知が無効になる

local.store.notifyplugin.ensHost

ENS サーバーのホスト名を指定する。デフォルトは 127.0.0.1

local.store.notifyplugin.ensPort

ENS サーバーの TCP ポートを指定する。デフォルトは 7997

local.store.notifyplugin.ensEventKey

ENS 通知用に使用するイベントキーを指定する。デフォルトは enp://127.0.0.1/store。イベントキーのホスト名部分は、ENS ホストの判別には使用されない。これは単に、ENS が使用する一意の識別子である

このキーは、このキーと一致するイベントを通知するために、サブスクライバが購読する



前へ      目次      索引      次へ     


Copyright 2004 Sun Microsystems, Inc. All rights reserved.