1. Oracle User Messaging Serviceの管理
  2. Oracle User Messaging Serviceのトラブルシューティング

7 Oracle User Messaging Serviceのトラブルシューティング

Oracle User Messaging Service (UMS)をデバッグするには、最初にサーバーの診断ログを確認します。ログには、例外、エラーまたは警告メッセージが含まれている場合があり、不正な動作に関する詳細とともに問題を修正するアクションが示されます。表7-1では、一般的なUMSの問題をデバッグするための他の方法について説明します。

表7-1 UMSのトラブルシューティング

症状 考えられる原因 解決策

SSLハンドシェイク・エラー。

WebLogic Serverのデフォルトのキーストア(DemoTrust.jks)が原因でこのエラーが発生している可能性があります。

WebLogic Serverのデフォルトのキーストアを変更します。WebLogic Serverの「カスタムIDとJava標準信頼」キーストアを構成します。

詳細は、Oracle WebLogicリモート・コンソール・オンライン・ヘルプを参照してください。

電子メール通知が送信されない場合

UMS電子メール・ドライバの送信(SMTP)メール・サーバーの設定が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

  • OutgoingMailServer

  • OutgoingMailServerPort

ノート: SMTPサーバー接続用の電子メール・クライアントで、これらを使用して値を検証します。

SMTPサーバーに、認証またはセキュアな接続(TLSまたはSSL)が必要です。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

  • OutgoingUsername

  • OutgoingPassword

  • OutgoingMailServerSecurity

エラー・メッセージ: 送信者アドレス = <アドレス>に対して一致するドライバが見つかりませんのために通知が送信されない場合

該当するチャネルに対するUMSドライバが特定のSenderAddressesリストで構成されていますが、アプリケーションが送信したメッセージに、一致しない送信者アドレスが設定されています。

ノート: UMSサーバーは、アウトバウンド・メッセージの送信者アドレスを使用可能なドライバのSenderAddressesに対して照合(送信者アドレスが設定されている場合)して、メッセージの配信に使用する一致ドライバを検索します。ドライバに1つ以上のSenderAddressesが設定されている場合、UMSサーバーは、一致する送信者アドレスが含まれているメッセージのみをそのドライバに送信します。

  • Oracle Fusion Middleware Controlを使用して、該当するUMSドライバの次の設定を確認します。

    SenderAddresses

    ノート: SenderAddressesのフォーマットは、<配信タイプ>:<アドレス>のカンマ区切りのリストです。

    例:

    EMAIL:sender@example.com, EMAIL:sender@example2.com

  • このドライバで、このチャネル(配信タイプ)のすべての送信者アドレスに対するアウトバウンド・メッセージを処理する場合は、このプロパティを空白のままにします。

  • 構成が異なる同じチャネル(配信タイプ)に対して複数のドライバ・インスタンスがデプロイされている場合は、SenderAddressesを使用して、ドライバ・インスタンスを区別します。たとえば、あるインスタンスは、SenderAddressesに値を指定して、一致する送信者アドレスが含まれているアウトバウンド・メッセージのみを処理するように設定でき、他のインスタンスはSenderAddressesを空白のままにして、送信者アドレスが指定されていないすべてのアウトバウンド・メッセージ、または最初のドライバ・インスタンスと送信者アドレスが一致しないすべてのアウトバウンド・メッセージを処理するようにできます。

  • 構文が正しくないSenderAddresses(<配信タイプ>:が指定されていない場合など)は、ドライバ選択についてはUMSサーバーによって無視されます。

電子メール・クライアントによる通知の受信に矛盾がある場合

UMS電子メール・ドライバの受信メール・サーバーの設定が、通知の送信先と同じ電子メール・アカウントで構成されています。

通知が同じアカウントに送信された場合、電子メール・クライアントが電子メールを表示できるようになる前に、UMS電子メール・ドライバが電子メールをダウンロードして処理する場合があります。

受信メール・サーバーの設定には排他的な電子メール・アカウントを使用してください。Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

  • IncomingMailIDs

  • IncomingUserIDs

アプリケーションが電子メールを受信しない場合

UMS電子メール・ドライバの受信メール・サーバーの設定が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

  • MailAccessProtocol(大文字でIMAPまたはPOP3)

  • ReceiveFolder

  • IncomingMailServer

  • IncomingMailServerPort

  • IncomingMailServerSSL

  • IncomingMailServerSSL

  • IncomingUserIDs

  • IncomingUserPasswords

  • ImapAuthPlainDisable

ノート: IMAPまたはPOP3サーバー接続用の電子メール・クライアントで、これらを使用して値を検証します。

メール・アクセス・プロトコルが正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

  • MailAccessProtocol(大文字でIMAPまたはPOP3)

電子メール・サーバーがSSL対応です。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

  • IncomingMailServerSS

受信フォルダ名が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

  • ReceiveFolder

ノート: 一部の電子メール・サーバーでは、値INBOXをinboxまたはInbox(つまり大/小文字を区別)と記述する必要があります。電子メール・サーバーに応じて適切な値を使用してください。

アプリケーションで対応するAccessPointが登録されませんでした。

UMS APIを使用して、AccessPointを登録します。

詳細は、『Oracle Fusion Middleware Oracle User Messaging Serviceによるアプリケーションの開発』を参照してください。

接続は成功したが、件名が一致していないのですぐに閉じられる

使用されている証明書がその環境では不正です。

各環境(開発、テスト、本番など)は、独自の証明書を使用してプロビジョニングする必要があります。リモート環境に正しい証明書が使用されていることを確認します。

APNS通知が配信されない

本番環境で受信されたデバイス・トークンが、本番以外の環境で使用されている可能性があります。

各環境で受信された正しいデバイス・トークンを使用します。詳細は、https://developer.apple.com/library/ios/technotes/tn2265/_index.htmlを参照してください

PKIXパスのビルドに失敗し、セキュア・モード環境のAPNSドライバに対してリクエストされたターゲットへの有効な証明書パスが見つかりません

関連するAPNS証明書はインポートされません。

リモート通知サーバーを設定するには、APNSへの信頼できる接続を確立する必要があります。この接続を作成するには、AAA証明書サービスのルート証明書を各サーバーにインストールする必要があります。「リモート通知サーバーの設定」から証明書をダウンロードします。

次のコマンドを使用して、ダウンロードした証明書をWebLogicの構成済キーストアにインポートする必要があります。

keytool -importcert -keystore "../fmwhome12/wlserver/server/lib/DemoTrust.jks" -storepass DemoTrustKeyStorePassPhrase -file AAACertificateServices.crt  -alias "AAACertificateServices.crt"

ノート:

環境で構成されたキーストアを選択します。

GCMワークフローでは、テスト接続に成功すると、セキュア・モード環境でメッセージを送信中にエラーがスローされます。

信頼できる証明書がありません

WebLogicのhostnameverifier構成は、ワイルド文字を受け入れません。

WebLogicに構成されたカスタム証明書ストアに、keytoolを使用してグローバル・ルート証明書をインポートする必要があります。

GlobalSignルート証明書は、GlobalSignルート証明書からダウンロードできます。

ランタイムでは、GCMドライバの構成後にエラーがスローされます。

デフォルトの「BEAホスト名の検証」では、ワイルドカードはサポートされていません。

管理対象サーバーのホスト名を検証する必要があります。

次の設定は、ホスト名の検証で機能します。

  1. なし。

  2. ワイルドカード・ホスト名の検証。

次の設定は、ホスト名の検証では機能しません。
  1. BEAホスト名の検証