29 Oracle User Messaging Serviceの管理

この章では、Oracle User Messaging Serviceの管理方法について説明します。

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

第29.1項「ドライバのデプロイ」
第29.2項「ドライバのアンデプロイおよび登録解除」

29.1 ドライバのデプロイ

Oracle UMSをインストールすると、事前にインストールされているドライバが組み込まれます（電子メール、XMPP、SMPPおよびVoiceXML）。この中で、WebLogic Serverにデプロイされるのは電子メール・ドライバのみです。他のドライバをデプロイするには、そのドライバをWebLogic Serverにデプロイしてください（WebLogic管理コンソールを使用するか、またはOracle Fusion Middleware構成ウィザードを使用してドメインを作成または拡張する際にドライバをデプロイできます）。

UMSとワークリストの統合を使用する場合は、ワークリスト・ドライバをSOAサーバーにデプロイする必要があります。この統合には複数のJEEアプリケーションおよびSOAコンポジットが含まれているため、この機能を1ステップで使用可能にするには、特別な拡張テンプレートを使用する必要があります。詳細は、「ワークリスト・ドライバのインストール」を参照してください。

追加のドライバは様々な方法でデプロイでき、WLSTコマンド（推奨）、Oracle Enterprise ManagerおよびOracle Fusion Middleware構成ウィザードを使用する方法があります。

注意:

特定のドライバEARの2つ以上のドライバ・インスタンスをデプロイするには、$ORACLE_HOME/communications/plansで入手できるカスタムのデプロイ・プラン・テンプレートを使用する必要があります。WLSTコマンドではデプロイ・プランが自動的に変更されるため、これらのコマンドを使用したドライバのデプロイをお薦めします。他の方法を使用する場合は、デプロイ・プランを手動で変更する必要があります。

29.1.1 WLSTコマンドを使用したドライバのデプロイ

WLSTコマンドdeployUserMessagingDriverを使用してドライバをデプロイできます。

29.1.1.1 deployUserMessagingDriver

コマンド・カテゴリ: UMS

WLSTでの使用: オンライン

29.1.1.1.1 説明

deployUserMessagingDriverは、ユーザー・メッセージング・ドライバの追加インスタンスをデプロイするために使用されます。新しいドライバ・デプロイメントのベース・ドライバ・タイプ（例: email、xmpp、voicexmlなど）および短縮名を指定します。指定したアプリケーション名の前に、文字列usermessagingdriver-が付加されます。deployコマンドに対して有効な任意のパラメータを指定でき、パラメータはドライバがデプロイされる際に渡されます。

29.1.1.1.2 構文

deployUserMessagingDriver(baseDriver, appName, [targets], [stageMode], [options])

引数定義

引数	定義
`baseDriver`	ベース・メッセージング・ドライバ・タイプを指定します。 'email'、'proxy'、'smpp'、'voicexml'または'xmpp'などの既知のドライバ・タイプを指定する必要があります。
`appName`	新しいデプロイメントの短い記述名です。指定した値の前に、文字列usermessagingdriver-が付加されます。
`targets` `stageMode` `options`	オプション。deployコマンドに対して有効な追加の引数を指定できます。引数は新しいドライバがデプロイされる際に渡されます。

baseDriver

ベース・メッセージング・ドライバ・タイプを指定します。

'email'、'proxy'、'smpp'、'voicexml'または'xmpp'などの既知のドライバ・タイプを指定する必要があります。

appName 新しいデプロイメントの短い記述名です。指定した値の前に、文字列usermessagingdriver-が付加されます。

targets

stageMode

options

オプション。deployコマンドに対して有効な追加の引数を指定できます。引数は新しいドライバがデプロイされる際に渡されます。

29.1.1.1.3 例

myEmailという名前の電子メール・ドライバの2番目のインスタンスをデプロイする場合

wls:/base_domain/serverConfig> deployUserMessagingDriver(baseDriver='email', appName='myEmail')

デプロイメント・ターゲットを指定して、電子メール・ドライバの2番目のインスタンスをデプロイする場合

wls:/base_domain/serverConfig> deployUserMessagingDriver(baseDriver='email', appName='email2', targets='server1,server2')

29.1.2 Oracle Enterprise Managerを使用したドライバのデプロイ

Oracle Enterprise Managerを使用してドライバをデプロイする手順は、次のとおりです。

デプロイメント・テンプレート（例: ORACLE_HOME/communications/plans）を取得します。
プランを目的の場所（同じディレクトリまたは他のディレクトリ）にコピーします。
プランを編集します。

「DriverDeploymentName」を、使用する名前に置き換えます（名前のすべてのインスタンスを確実に置き換えてください）。

「DriverShortName」を任意の名前に置き換えます。
Oracle Enterprise Managerを起動します。
.earファイルの場所を入力します（図29-1）。
デプロイ・プランの場所を入力します（図29-1）。

図29-1 Oracle Enterprise Managerを使用したUMSドライバのデプロイ

「図29-1 Oracle Enterprise Managerを使用したUMSドライバのデプロイ」の説明

「ターゲットの選択」画面が表示されます。

図29-2 「ターゲットの選択」画面

「図29-2 「ターゲットの選択」画面」の説明
SOAターゲットを選択します。
「アプリケーション属性」画面でアプリケーション名を入力します。アプリケーション名は、「デプロイ・プラン」で指定したDriverDeploymentName（前述の手順3）に使用した文字列と正確に一致する必要があります。一致しない場合、デプロイメントおよびアクティブ化は失敗します。「デプロイ設定」画面が表示されます。

図29-3 「デプロイ設定」画面

「図29-3 「デプロイ設定」画面」の説明
「デプロイ」をクリックします。「デプロイが完了しました」画面が表示されます。

図29-4 「デプロイが完了しました」画面

「図29-4 「デプロイが完了しました」画面」の説明
結果（デプロイされたドライバ）を確認するには、SOAサーバーを起動します。

29.1.3 Oracle Fusion Middleware構成ウィザードを使用したドライバのデプロイ

SMPP、XMPPおよびVoiceXMLの各ドライバをインストールするには、$ORACLE_HOME/common/templates/applications/oracle.ums.drivers_template_11.1.1.jarで入手できる拡張テンプレートを使用してドメインを拡張します。Oracle Fusion Middleware構成ウィザードを使用してドメインを拡張する手順は、次のとおりです。

Oracle Fusion Middleware構成ウィザードを起動します（$ORACLE_HOME/common/bin/config.sh?U???I%ORACLE_HOME%\common\bin\config.cmd）。
「既存のWebLogicドメインの拡張」オプションを選択します。
UMSが含まれている目的のドメインのディレクトリを選択します。
「既存の拡張テンプレートを使用してドメインを拡張する」オプションを選択します。
「参照」をクリックし、$ORACLE_HOME/common/templates/applicationsに移動します。
「oracle.ums.drivers_template_11.1.1.jar」を選択します。
Oracle Fusion Middleware構成ウィザードの残りのステップを完了し、必要なドライバを目的のWebLogicサーバーまたはクライアント（あるいはその両方）に確実にデプロイします。
適切なWebLogicサーバーを再起動します。

29.2 ドライバのアンデプロイおよび登録解除

メッセージング・ドライバは標準のJEEアプリケーションであるため、管理コンソールやWLSTなどの標準のOracle WebLogicツールを使用して、Oracle WebLogic Serverからアンデプロイできます。

ただし、UMSサーバーは、登録されたメッセージング・ドライバを永続ストア（データベース）に記録し続けるため、UMSサーバーによって公開されているランタイムMBeanを使用して、別の手順でこの登録を解除する必要があります。これをOracle Enterprise Managerから実行する手順は、次のとおりです。

UMSサーバーが使用可能であることを確認します。
Oracle Enterprise Managerで、ドメイン内の任意のusermessagingserverターゲットを選択します。
ターゲットのメニューから、「システムMBeanブラウザ」を選択します。
システムMBeanブラウザで、usermessagingserverのComponentAdministration MBeanを検索します。

フォルダ「com.oracle.sdp.messaging」→「Server」（Server: soa_server1など）→「SDPMessagingrun time」→「ComponentAdministration」を開きます。
操作listDriverInstancesを起動します。
1. 「操作」タブをクリックします。
2. 操作「listDriverInstances」をクリックします。
3. 「呼出し」をクリックします。
4. 登録解除するドライバの名前を識別し、コピーします（例: /Farm_soa_bam_domain/soa_bam_domain/soa_server1/usermessagingdriver-email:oracle_sdpmessagingdriver_email#Email-Driver）。
図29-5 ドライバ・インスタンスのリスト

「図29-5 ドライバ・インスタンスのリスト」の説明
「戻る」をクリックします。
目的のドライバ名を指定して、操作unregisterDriverInstanceを起動します。
1. 操作「unregisterDriverInstance」をクリックします。
2. ドライバ名を「値」フィールドに貼り付けます（例: /Farm_soa_bam_domain/soa_bam_domain/soa_server1/usermessagingdriver-email:oracle_sdpmessagingdriver_email#Email-Driver）。
3. 「呼出し」をクリックします。
図29-6 ドライバ・インスタンスの登録解除

「図29-6 ドライバ・インスタンスの登録解除」の説明
確認ダイアログで処理が成功したことを確認します。

これで、指定したドライバのUMSサーバーからの登録解除が完了し、今後のメッセージ配信で使用されなくなります。