外部データベースの IM およびプレゼンス サービスを設定する

この章では、外部データベース接続のための IM and Presence Service の設定について説明します。

外部データベースの割り当てについて

外部データベースとノードの割り当て

IM and Presence Service で外部データベースエントリを設定する場合、次のように外部データベースをクラスター内の 1 つまたは複数のノードに指定します。

  • Message Archiver (コンプライアンス) — クラスターごとに少なくとも 1 つの外部データベースが必要です。 展開の要件に応じて、ノードごとに一意の外部データベースを構成することもできます。

  • 常設グループチャット — ノードごとに固有の外部データベースが必要です。 クラスターの各ノードに固有の外部データベースを構成し、割り当てます。

  • Managed File Transfer - Cisco XCP ファイル転送マネージャー サービスが有効になっている IM and Presence Service クラスター/サブクラスターの各 IM and Presence Service ノードに対し、1 つの一意の論理外部データベースインスタンスが必要です。

  • IM and Presence Service ノードに永続的グループチャット、メッセージアーカイバー、管理ファイル転送の機能を導入する場合、すべてに同じ外部データベースを割り当てることも、任意の組み合わせを割り当てることも可能です。確認してください。

詳細については、次を参照してください。

  • Message Archiver:Cisco Unified Communications Manager 上の IM and Presence Service のインスタントメッセージングに準拠

  • 常設グループチャット:の設定と管理 Cisco Unified Communications Manager 上の IM and Presence Service の設定と管理。

  • マネージドファイル転送:Cisco Unified Communications Manager 上の IM and Presence Service の設定と管理

外部データベース接続

外部データベースエントリが設定されている場合、IM and Presence Service は外部データベースへの接続を確立しません。 この時点では、外部データベースはデータベーススキーマを作成していません。 IM and Presence サービス が外部データベースとの ODBC (Open Database Connectivity) 接続を確立するのは、外部データベースエントリをノードに指定した場合のみです。 IM and Presence Service が接続を確立すると、外部データベースにより IM and Presence Service 用のデータベーステーブルが作成されます。

外部データベースエントリをノードに指定したら、 Cisco Unified CM IM and Presence Service 管理 ユーザインターフェイスのシステムトラブルシューティングを使用して接続を検証できます。

IM and Presence Service の外部データベースエントリをセットアップする

クラスタの IM and Presence Service データベースパブリッシャノードでこの設定を行います。


注意    


IM and Presence Service ノードが IPv6 を使用して外部データベースサーバに接続する場合、エンタープライズパラメータが IPv6 に設定され、Eth0 が IPv6 に設定されていることを各ノードで確認してください。そうしないと、外部データベースサーバへの接続に失敗します。 Message Archiver および Cisco XCP テキスト電話会議マネージャは外部データベースに接続できず、失敗します。 IM and Presence Serviceの IPv6 設定については、 「IM and Presence Serviceの設定と管理 」を参照してください。 Cisco Unified Communications Manager


始める前に

  • 外部データベースをインストールして構成します。

  • 外部データベースのホスト名または IP アドレスを取得します。

  • Oracle を使用している場合、テーブルスペースの値を取得します。 Oracle データベースのテーブルスペースが取得できるかを判断するには、sysdba として次のクエリを実行します。

    SELECT DEFAULT_TABLESPACE FROM DBA_USERS WHERE USERNAME = 'USER_NAME';


    (注)  


    小文字でユーザを定義した場合でも、ユーザ名は大文字でなければならず、一重引用符 (文字列リテラル) で囲んでおく必要があります。

手順


ステップ 1

[Cisco Unified CM IM and Presence Administration] ユーザーインターフェイスにログインします。 [メッセージング(Messaging)] > [外部データベースの設定(External Server Setup)] > [外部データベース(External Databases)] を選択します。

ステップ 2

[新規追加] をクリックします。

ステップ 3

tcmadb など、外部データベースのインストール時に定義したデータベース名を入力します。

ステップ 4

ドロップダウンリストからデータベースの種類を選択します。 Postgres、Oracle、Microsoft SQL Server のいずれかを選択します

ステップ 5

データベースタイプとして Oracle を選択した場合、テーブルスペースの値を入力します。

ステップ 6

外部データベースのインストール時に定義したデータベースユーザ (所有者) のユーザ名を入力します。例: tcuser

ステップ 7

データベースユーザのパスワードを確認入力します (例: mypassword)

(注)  

 

外部データベースのパスワードの長さは 30 文字以下でなければなりません。

ステップ 8

外部データベースのホスト名または IP アドレスを入力します。

ステップ 9

外部データベースのポート番号を入力します。

Postgres(5432)、Oracle(1521)、SSL 対応 Oracle(2484)、および Microsoft SQL Server(1433)のデフォルト ポート番号が [ポート番号(Port Number)] フィールドに自動入力されます。 必要に応じて別のポート番号を入力することもできます。

ステップ 10

データベースの種類として Oracle または Microsoft SQL Server を選択した場合は、[SSLの有効化(Enable SSL)] チェックボックスがアクティブになります。 チェックボックスを選択して SSL を有効にします。

(注)  

 
  • Microsoft SQL Server を データベースタイプとして 選択した場合、cup-xmpp-trust リストのすべての証明書が Microsoft SQL Server から送信された証明書を検証するために使用されるため、[証明書名(Certificate Name)] ドロップダウンリストは非アクティブのままになります。

  • データベースタイプとして Microsoft SQL Server を選択した場合、ホスト名は SQL Server により提示される証明書の 共通名 フィールドのエントリと一致する必要があります。

Oracle をデータベースタイプとして選択した場合、[証明書の名前(Certificate Name)] ドロップダウンメニューがアクティブになります。 ドロップダウン リストから証明書を選択します。

(注)  

 
  • [SSL を有効にする] チェックボックスまたは [証明書] ドロップダウンフィールドが変更されると、外部データベースに割り当てられた対応するサービスを再起動する通知が送信されます。 Cisco XCP Message Archiver または Cisco XCP テキスト電話会議マネージャのいずれかに関するメッセージが生成されます。
  • SSL を有効にする必要がある証明書は、cup-xmpp-trust ストアにアップロードする必要があります。 SSL を有効にする前に、この証明書をアップロードする必要があります。
  • 証明書が cup-xmpp-trust ストアにアップロードされたら、証明書が IM and Presence Service クラスタのすべてのノードに伝達されるまで、15 分間待機する必要があります。 待機しなければ、証明書が伝達されていないノードで SSL 接続は失敗します。
  • 証明書がないか、cup-xmpp-trust ストアから削除されている場合は、XCPExternalDatabaseCertificateNotFound のアラームが Cisco Unified Communications Manager リアルタイム監視ツール(RTMT)で発生します。

    (注)  

     

    選択された外部データベースタイプが Microsoft SQL Server の場合、アラームは発生しません。

  • 次の暗号は、Microsoft SQL Server でテスト済みです。

    • TLS_RSA_WITH_AES_128_CBC_SHA256

    • TLS_RSA_WITH_AES_128_CBC_SHA

    • TLS_RSA_WITH_AES_256_CBC_SHA256

ステップ 11

[保存(Save)] をクリックします。


メッセージ アーカイバのネットワーク遅延

Acrolinx URL は https://ciscoenterprise.acrolinx.cloud

Cisco IM and Presence サービスで、常設チャット、メッセージアーカイブ、コンプライアンスログが有効になっています。 低ネットワーク遅延を維持するために、外部データベース サーバを関連する Cisco IM and Presence サービス サブクラスターと同じ WAN 側に配置することを推奨します。

外部データベースが、関連付けられている Cisco IM and Presence サービス サブクラスターと同じ WAN 側に配置できない場合、以下の考慮事項が展開プロファイルと遅延に関して適用されます。

図 2. WAN を介した外部データベースを持つ Message Archiver
MA 遅延

メッセージ アーカイバの機能は遅延に依存します。 往復時間 (RTT) による許容可能なネットワーク遅延をモデル化する場合、次のパラメータが適用されます。

  • Cisco IM and Presence サービスあたりのユーザ数

  • 時間間隔あたりの平均メッセージ数

  • アクティブなチャットルーム数

  • アクティブなチャット ルーム 1 室あたりの平均ユーザ数

  • 時間間隔あたりのアクティブなチャットルームの平均メッセージ数

  • ユーザあたりの平均ログイン端末数

ネットワーク遅延が増加するにつれて、ユーザ数、デバイス数、ユーザ 1 人当たりのメッセージ数を減らすべきです。

図 3. 最大遅延/RTT のグラフ

最大遅延/RTT の計算

ここで提供されるガイドラインを使用して、最大遅延/RTT を計算します。

ガイドライン

指定の月間アーカイブメッセージ数に対する最大遅延/RTT 時間 (ミリ秒) は、次の式を使用して計算されます。

Max RTT=8∗10⁷∗TMM⁻⁰·⁸⁶⁷

TMM は月ごとにアーカイブされたメッセージの合計数を表します。

外部データベース接続の確認

install_dir/data/pg_hba.conf ファイルまたは install_dir/data/postgresql.conf ファイルの構成を変更した場合、外部データベースを割り当てた後、次の手順を実行します:

手順


ステップ 1

IM およびプレゼンスサービス ノードの外部データベースの割り当てを解除して再割り当てします。

ステップ 2

Cisco XCP Router サービスを再起動します。 Cisco Unified IM and Presence Serviceability のユーザーインターフェイスにログインします。 [ツール] > コントロールセンター - [ネットワークサービス] を選択してこのサービスを再起動してください。


IM およびプレゼンス サービスの外部データベース接続ステータスを確認する

IM & Presence サービス は、外部データベースに関する次の状況情報を提供します:

  • データベースの到達可能性 — IM およびプレゼンスサービス が外部データベースに対して ping を実行できることを確認します。

  • データベース接続 — IM およびプレゼンスサービス が外部データベースとの Open Database Connectivity (ODBC) 接続を正常に確立したことを確認します。

  • データベーススキーマの確認 — 外部データベーススキーマが有効であることを確認します。


注意    


IM and Presence Service ノードが IPv6 を使用して外部データベースサーバに接続する場合、エンタープライズパラメータが IPv6 に設定され、Eth0 が IPv6 に設定されていることを各ノードで確認してください。そうしないと、外部データベースサーバへの接続に失敗します。 メッセージアーカイバー(準拠)と Cisco XCP テキスト会議マネージャは外部データベースに接続できず、失敗します。 IM and Presence Serviceの IPv6 設定については、 「IM and Presence Serviceの設定と管理 」を参照してください。 Cisco Unified Communications Manager


手順


ステップ 1

[Cisco Unified CM IM and Presence Administration] ユーザーインターフェイスにログインします。 [メッセージ] [外部サーバのセットアップ] > [外部データベース] > を選択してください。

ステップ 2

[検索(Find)] をクリックします。

ステップ 3

表示する外部データベースエントリを選択します。

ステップ 4

[外部データベースの状況] セクションで、外部データベースの各結果エントリの隣にチェックマークがあることを確認します。

ステップ 5

[Cisco Unified CM IM and Presence Administration] ユーザー インターフェイスにログインして、[診断(Diagnostics)] > [システム トラブルシューティング(System Troubleshooter)] を選択します。

ステップ 6

[外部データベースのトラブルシューティング] セクションの各外部データベース接続エントリのステータスのとなりにチェック マークがあることを確認します。


トラブルシューティングのヒント

  • 外部データベースへの ODBC が失われた場合、 IM およびプレゼンスサービス はアラームを生成します。

  • IM およびプレゼンス サービスがすでに外部データベースに接続されているときに、外部データベース ユーザのパスワードを変更しても、既存の接続には影響しません。 Cisco XCP Router サービスが再起動されると、既存の接続が破棄され、新しいパスワードは新しい接続の作成に使用されます。

    ユーザ パスワードが外部データベースでのみ変更される場合、外部データベースに依存する設定済みの IM および Presence 機能は、古いユーザ パスワードで確立された既存の接続を使用して引き続き動作します。 しかし、この一時的なフェーズは最小限にとどめ、できるだけ早く IM および Presence サービスのパスワードも更新する必要があります。

  • psql コマンドを使用して、Postgres データベース接続の状況を確認することもできます。 このコマンドを実行するには、リモートサポートアカウントから Linux シェルにログインする必要があります。管理者 CLI からはアクセスできません。 Postgres データベースをインストールした後、ただしデータベースを IM and Presence Service ノードに指定する前に次のコマンドを実行してください。


    重要


    psql を実行するには、まず次の内容を入力して環境変数を設定する必要があります。

    $export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/xcp/lib


    入力:

    $sudo -u xcpuser /usr/local/xcp/bin/psql -Udb_user-hdb_serverdb_name

    次に例を示します。

    $sudo –u xcpuser /usr/local/xcp/bin/psql –Upostgres-hnode1 tcmadb

  • ルートから以下のコマンドを実行することで、Oracle データベース接続の状況を確認することができます。

    export ORACLE_HOME=/usr/lib/oracle/client_1/

    export PATH="$ORACLE_HOME/bin:$PATH"

    export LD_LIBRARY_PATH="$ORACLE_HOME/lib:$LD_LIBRARY_PATH"

    sqlplususername/password@dsn

    dsn の値は、 $ORACLE_HOME/network/admin/tnsnames.ora ファイルから取得できます。

  • ルートから以下のコマンドを実行することで、Microsoft SQL データベース接続の状況を確認することができます。

    $sudo -uxcpuser TDSVER=7.3 /usr/local/xcp/bin/tsql-Hmssql_server_hostname-pportnumber-Uusername-Ddatabasename

  • メッセージアーカイバー(準拠)機能を構成し、Cisco XCP Message Archiver サービスが開始しない場合、または持続的グループ チャット機能を構成し、Cisco テキスト会議マネージャー サービスが開始しない場合は、システム設定トラブルシューター ウィンドウの外部データベーストラブルシューターセクションを確認してください。
    • 外部データベース接続のステータスが [OK] ではないと表示する場合、接続の詳細が正しいことを確認し、ネットワークに問題がないこと、そして IM and Presence Service ノードと外部データベースホスト間に問題がないことを確認します。

    • 外部データベース接続のステータスが OK であるが、しかし、スキーマ検証のステータスがOKではない場合、ノードから外部データベースの割り当てを解除し、再度割り当てを行います。

  • 証明書が cup-xmpp-trust ストアにアップロードされたら、証明書が IM and Presence Service クラスタのすべてのノードに伝達されるまで、15 分間待機する必要があります。 待機しなければ、証明書が伝達されていないノードで SSL 接続は失敗します。
  • 証明書がないか、cup-xmpp-trust ストアから削除されている場合は、XCPExternalDatabaseCertificateNotFound のアラームが Cisco Unified Communications Managerリアルタイム監視ツールRTMT)で発生します。

    (注)  


    選択された外部データベースタイプが Microsoft SQL Server の場合、アラームは発生しません。