音声とユニファイド コミュニケーション : Cisco Unified Presence Version 8.0

BAT を使用した CUPS ユーザ連絡先リストのインポートの設定例

2015 年 11 月 25 日 - 機械翻訳について
その他のバージョン: PDFpdf | 英語版 (2015 年 8 月 22 日) | フィードバック

概要

このドキュメントでは、Cisco Unity Connection 一括管理ツール(BAT)を使用して Cisco Unified Presence Server(CUPS)にユーザ連絡先リストをインポートする方法について説明します。 BAT を使用すれば、新しい CUPS クライアント ユーザの連絡先リストを事前に生成したり、既存の連絡先リストに追加したりできます。 BAT を使用するには、ユーザ連絡先リストを含む入力ファイルを指定する必要があります。

著者:Cisco TAC エンジニア、Tray Stoutmeyer

前提条件

要件

次の項目に関する知識があることが推奨されます。

  • CUPS バージョン 8.x
  • Cisco Unified Communications Manager(CUCM)バージョン 6.x

使用するコンポーネント

このドキュメントは、特定のソフトウェアやハードウェアのバージョンに限定されるものではありません。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されたものです。 このドキュメントで使用するすべてのデバイスは、クリアな(デフォルト)設定で作業を開始しています。 ネットワークが稼働中の場合は、コマンドが及ぼす潜在的な影響を十分に理解しておく必要があります。

設定

ユーザ連絡先リストをインポートするには、BAT でユーザ連絡先リストを含む入力ファイルを指定する必要があります。

入力ファイルは次の形式のコンマ区切り値(CSV)ファイルにする必要があります。

<User ID>,<User Domain>,<Contact ID>,<Contact Domain>,<Nickname>,<Group Name>

次に、サンプル CSV ファイル エントリを示します。 userA,example.com,userB,example.com,buddyB,General

ユーザ ID

この必須パラメータは、CUPS ユーザのユーザ ID を示します。 これには、最大 132 文字を使用できます。 

User Domain(ユーザ ドメイン)

この必須パラメータは、CUPS ユーザのプレゼンス ドメインを示します。 これには、最大 128 文字を使用できます。

Contact ID(連絡先 ID)  

この必須パラメータは、連絡先リスト エントリのユーザ ID を示します。 これには、最大 132 文字を使用できます。

Contact Domain(連絡先ドメイン)

この必須パラメータは、連絡先リスト エントリのプレゼンス ドメインを示します。 次の制限がドメイン名の形式に適用されます。

  • 128 文字以下にすること
  • 数字、大文字と小文字の英字、およびハイフンのみを使用すること 
  • 先頭と末尾にハイフンを使用しないこと 
  • ラベル長は 63 文字以下にすること
  • 2 文字以上の文字だけのトップ レベル ドメインを使用すること

Nickname(ニックネーム) 

このオプション パラメータは、連絡先リスト エントリのニックネームを示します。 これには、最大 255 文字を使用できます。

[Group Name]

この必須パラメータは、連絡先リスト エントリを追加するグループの名前を示します。 これには、最大 255 文字を使用できます。

インポート前に実行すべきタスク

  1. CUCM 上でユーザをプロビジョニングします。
  2. ユーザがランセンスを得て、CUPS に割り当てられていることを確認します。

: デフォルトの連絡先リストのインポート速度は、サーバ ハードウェアのタイプに基づいています。 連絡先リストのインポート速度を変更するには、[Cisco Unified Presence Administrator] > [System] > [Service Parameters] > [Cisco Bulk Provisioning Service] の順に選択します。 ただし、デフォルトのインポート速度を増やすと、CUPS 上の CPU とメモリの使用率が高くなります。

ユーザ連絡先リストを CUPS にインポートするには、次の手順を実行します。

  1. 連絡先リストの最大サイズを確認します。
  2. BAT を使用して入力ファイルをアップロードします。
  3. 新しい一括管理ジョブを作成します。
  4. 一括管理ジョブの結果を確認します。

連絡先リストの最大サイズの確認

連絡先リストをインポートする前に、CUPS で連絡先リストの最大サイズとウォッチャの最大数の設定を確認することをお勧めします。 連絡先リスト サイズがユーザの制限を超えている場合は、どの連絡先もそのユーザにインポートされません。 連絡先リスト サイズが制限を超えていないことを確認するには、最大連絡先リスト サイズの設定を増やすか、または [unlimited] に変更できます。 無制限に設定すると、すべての連絡先リストが CUPS にインポートされることが保証されます。

最大連絡先リスト サイズと最大ウォッチャ数の両方のシステム デフォルト値は 200 です。

: 連絡先をインポートするユーザを含むクラスタについてのみ、連絡先リストの最大サイズを確認する必要があります。 プレゼンス設定を変更すると、その変更はクラスタ内のすべてのノードに適用されます。 そのため、これらの設定を変更する必要があるのは、クラスタ内の CUPS パブリッシャ ノードのみです。

BAT を使用した入力ファイルのアップロード

この手順では、BAT を使用して CSV ファイルをアップロードする方法について説明します。

  1. [Cisco Unified Presence Administration] > [Bulk Administration] > [Upload/Download Files] の順に選択します。
  2. [Add New] をクリックします。
  3. [Browse] をクリックして、CSV ファイルを探して選択します。
  4. [Target] として [Contact Lists] を選択します。
  5. [Transaction Type] として [Import Users' Contacts - Custom File] を選択します。
  6. [Save] をクリックして、ファイルをアップロードします。

新しい一括管理ジョブの作成

この手順では、CUPS 管理で新しい一括管理ジョブを作成する方法について説明します。

  1. [Cisco Unified Presence Administration] > [Bulk Administration] > [Contact List] > [Update] の順に選択します。
  2. [File Name] ドロップダウン リストから、インポートするファイルを選択します。
  3. [Job Description] フィールドに、この一括管理ジョブの説明を入力します。
  4. 次のオプションのいずれかを選択します。
    • [Run Immediately] は一括管理ジョブを直ちに実行します。
    • [Run Later] は一括管理ジョブの実行時刻をスケジュールします。
  5. [Submit] をクリックします。 ジョブを直ちに実行するように選択した場合は、[Submit] のクリック後にジョブが実行されます。

一括管理ジョブの結果の確認

一括管理ジョブが完了すると、CUPS BAT ツールが連絡先リスト インポート ジョブの結果をログ ファイルに書き込みます。 ログ ファイルには次の情報が含まれています。

  • 正常にインポートされた連絡先の数。
  • 連絡先のインポート時に発生した内部サーバ エラーの数。
  • インポートされなかった(無視された)連絡先の数。 ログ ファイルには、無視されたそれぞれの連絡先の理由がログ ファイルの末尾に記載されます。

連絡先がインポートされない理由には、以下のものがあります。

  • 無効な形式:無効な行形式、必須フィールドの欠落や空白など。
  • 無効な連絡先ドメイン:連絡先ドメインの形式が無効。 連絡先ドメインの有効な形式については「連絡先ドメイン」の項を参照してください。
  • 連絡先として自分自身を追加できない:連絡先がユーザの場合は、その連絡先をユーザとしてインポートできません。
  • ユーザ連絡先リストが制限を超えている:最大連絡先リスト サイズに達しているため、それ以上の連絡先をインポートできません。
  • ユーザはローカル ノードに割り当てられない:ユーザはローカル ノードに割り当てられません
  • BAT ジョブを早期に終了させたエラーが原因で処理されなかった ​​CSV ファイル内の連絡先の数。 このエラーは滅多に起こりません。

ログ ファイルにアクセスするには、次の手順を実行します。

  1. [Cisco Unified Presence Administration] > [Bulk Administration] > [Job Scheduler] の順に選択します。
  2. [Find] をクリックして、連絡先リスト インポート ジョブのジョブ ID を選択します。
  3. ログ ファイル名のリンクをクリックして、ログを開きます。

任意の BAT ジョブの詳細が必要な場合は、一括プロビジョニング サービスのデバッグ ログを参照してください。 これらのログには、次の場所でアクセスできます。  /var/log/active/cm/trace/bps/log4j/bps000*.txt

一括プロビジョニング サービスのデバッグ ロギングは、Cisco Unified Serviceability GUI から有効にできます。

CUPS にログオンする BAT プロビジョニング サービスの設定

この手順では、CUPS にログオンする BAT プロビジョニング サービスを設定する方法について説明します。

  1. [Cisco Unified Serviceability] > [Trace] > [Configuration] の順に選択します。
  2. [Cisco Unified Presence server] を選択して、[Go] をクリックします。
  3. [Service Group] ドロップダウン リストから [Database and Admin Services] を選択して、[Go] をクリックします。
  4. [Service] ドロップダウン リストから [Bulk Provisioning Service] を選択して、[Go] をクリックします。
  5. [Trace On] をクリックします。
  6. [Trace Filter Settings] で、[Debug Trace Level] を選択します。 トレースに対するデバッグ レベルを有効にする場合は、[Debug] をクリックします。
  7. [Save] をクリックします。

確認

現在、この設定に使用できる確認手順はありません。

トラブルシューティング

現在のところ、この設定に関する特定のトラブルシューティング情報はありません。

関連情報


関連するシスコ サポート コミュニティ ディスカッション

シスコ サポート コミュニティは、どなたでも投稿や回答ができる情報交換スペースです。


Document ID: 116226