この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
ユーザを作成し、このユーザのサービスを自動的にプロビジョニングするには、バッチ プロビジョニングを使用します。バッチ プロビジョニングを使用すると、新しい事業所の展開やレガシー システムからの移行を簡単に行うことができます。
バッチ プロビジョニングを実行するには、次の操作を実行する必要があります。
1. ユーザとプロビジョニングするサービスを記述したスプレッドシートを作成し(通常は電話機と回線を含めます)、そのスプレッドシートをタブ区切りのテキスト ファイル(バッチ処理ファイルと呼びます)に変換します。
2. バッチ処理ファイルを プロビジョニング のバッチ プロジェクトにアップロードします。
3. バッチ プロジェクトを実行するか、後で実行するためにスケジュール設定します。プロビジョニング では、ファイルに記述されたデータに基づいて、ユーザの作成と回線および電話機のプロビジョニングが行われます。
スケジュール設定したプロジェクトのリスト、および実行中のプロジェクトの詳細を表示することもできます。
(注) オーダーのプロビジョニング中は、ステータスが [Completed] と表示されます。[Completed] リンクをクリックして、デバイスに関連する更新を表示します。
バッチ処理ファイルには、カラム ヘッダーを 1 行含める必要があります。データ カラムは任意の順序でかまいませんが、タブ区切りテキスト ファイルに保存する必要があります。データの編集には、最終的にここで示すガイドラインに準拠したファイルが作成されさえすれば、どのようなテキスト エディタを使用してもかまいません。たとえば、Microsoft Excel でバッチ ファイルを作成し、それをタブ区切りファイルとしてエクスポートできます。
プロビジョニング には、よく使用されるほとんどの処理を含むサンプル ファイルが付属しています。これらのサンプル ファイルは、\sep\ipt\config\sample\batchProvisioning フォルダにあります。
表 6-1 に、どのバッチ処理ファイルにも必要なカラムの説明を示します。
表 6-2 に、ユーザを新規作成するときに使用される追加のカラムを示します( 表 6-1 は、すべてのバッチ処理ファイルに必須のカラムです)。
|
|
---|---|
(任意)新規ユーザの加入者タイプ。1 人の加入者に複数の加入者タイプを追加できます(加入者タイプをセミコロンで区切ります)。 (注) ドメインでサポートされていない加入者タイプは無視されます。有効な加入者タイプが加入者に割り当てられていない場合、その加入者は作成されず、バッチ オーダーは失敗します。 |
|
表 6-3 に、ユーザを削除するときに使用される追加のカラムを示します( 表 6-1 は、すべてのバッチ処理ファイルに必須のカラムです)。
表 6-4 に、ユーザを削除するときに使用される追加のカラムを示します( 表 6-1 は、すべてのバッチ処理ファイルに必須のカラムです)。
表 6-5 に、デバイスの追加で使用する追加カラムを示します
|
|
---|---|
Capability<number> が Unified Communications Manager の場合、次のヘッダーが有効です。 |
|
|
|
---|---|
|
|
---|---|
既存の [Analog Voice Gateway Reference] を交換する [New Analog Voice Gateway Reference] フィールド。 |
|
|
|
---|---|
帯域幅不足が原因でコールがブロックされた場合に、収集された(発信側)番号の他のルーティング方法を決定するために検索されるルート パーティションのコレクションを指定します。 |
(注) サンプルのバッチ ファイルが用意されています。ファイルは、プロビジョニング システムで、/opt/cupm/sep/ipt/config/sample/batchProvisioning フォルダにあります。サンプルのバッチ ファイルには、必要に応じて追加のカラムを追加できます。
バッチ アクション ファイルを作成する場合は、次のガイドラインに従います。
• バッチ処理の値を作成する際に、複数の値を入力するにはコロン デリミタを使用する必要があります。たとえば、複数のルート パーティションを含む新しい CallingSearchSpace を作成する際には、RP1:RP2:RP3 を使用します。
• 作成するユーザにセルフケア アカウントを与える場合は、該当するすべてのドメインについて CreateSelfCareAccounts ルールを有効にする必要があります。
• ProductName が Phone(または Phone を含むバンドル)で、なおかつ Phone Type が仮想電話(CTI Port など)でない場合は、MAC アドレスが必要です。
• 電話機を変更するときは、新しい MAC アドレスが必要です。
• 製品をキャンセルするときは、Object Name が必要です(Line 製品と Extension Mobility Line 製品を除く)。
• Line 製品または Extension Mobility Line 製品をキャンセルするときは、ディレクトリ番号とルート パーティションが必要です。
• VG202 製品、VG 204 製品および VG 224 製品を削除すると、デバイスおよび Provisioning のすべての電話機が削除されます。削除に関する警告メッセージが表示されます。メッセージの確認後にのみ、電話機が削除されます。電話機に関連付けられたカスタマー レコードを消去するには、ドメイン同期化を実行する必要があります。
• ProductName が Phone(または Phone を含むバンドル)または Extension Mobility Access(または Extension Mobility Access を含むバンドル)で、Phone Type が仮想電話(CTI Port)でなく、なおかつ Cisco Unified Communications Manager だけに関連付けられたサービス エリアでオーダーされた場合は、Phone Button Template が必要です。
• Cisco Unity デバイス(Cisco Unity、Cisco Unity Connection、Cisco Unity Express)では、一部の製品とサービスはサポートされていません。指定されたサービス エリアのデバイスでサポートされていない製品がバッチ処理ファイルに設定されている場合、バッチ プロビジョニングは失敗します。
• 手動オーダー入力プロセスでユーザが入力する必要がある製品属性は、バッチ プロジェクトで同等のオーダーを正常に完了するためにも必要となります。次に例を示します。
– Phone Type:オーダーする製品が Phone または Phone を含むバンドルの場合は、電話機のタイプ(Cisco 7960 や Cisco 7912 など)を指定します。
– Line Type:オーダーする製品が Line または Line を含むバンドルの場合は、回線のタイプ(Auto-Assigned Line や Chosen Line など)を指定します。
– Directory Number:ProductName が Line で Type が Chosen Line の場合は必須です。また、そのオーダーだけでは依存関係が満たされない製品をオーダーする場合は(たとえば、単一の Line をオーダーする場合など)、従属オブジェクトを指定するカラムが必要です。
– Route Partition:ProductName が Line で Order Type が Change の場合は必須です。
• オーダーする製品に、そのオーダーだけでは満たされない依存関係がある場合は(たとえば、単一の Line をオーダーする場合など)、従属オブジェクトを指定するカラムが必要です。次に例を示します。
– SelectedPhone:回線を追加する電話機の MAC アドレス。
– SelectedLine:ボイスメールを追加する回線のディレクトリ番号。
– SelectedVoicemail:ユニファイド メッセージングを追加するボイスメールのディレクトリ番号。
– SelectedEM_Access:EM_Line を追加する EM_Access(デバイス プロファイル)の名前。
バンドルに基本製品のインスタンスが複数含まれている場合は、属性のカラム名の末尾に (1)、(2)、などを付ける必要があります (たとえば、Line Type(1) や Directory Number(1) など)。
• バンドル製品で、製品属性名が別の基本製品のものと同一である場合は、区別するために製品名を属性に付加します。
たとえば、コーリング サーチ スペースという属性は、Phone と Line の両方にあります。Phone Service という製品に対しては、[Phone Calling Search Space] と [Line Calling Search Space] を指定できます。
– 直接:1 つのカラムで情報を指定する場合に使用します。カラム ヘッダーは「Speed Dial Info」です。必要な形式は index:number:label で、これをセミコロンで区切って短縮ダイヤルごとに繰り返します。index は短縮ダイヤルの位置(1、4、5 など)、number は電話番号、label は短縮ダイヤル名です。たとえば、1:8675306:Joe;4:888:Voicemail のようになります。
この形式を使用して追加の回線を追加する場合は、それまでにカラムに入力した短縮ダイヤル情報をすべて再入力して、新しい短縮ダイヤル情報を追加する必要があります。
この形式は、短縮ダイヤルの初期設定時に使用することを推奨します。既存の短縮ダイヤルのリストに短縮ダイヤルを追加する場合は、次の項目で説明する形式を使用する必要があります。
– 一致するカラムのセット:「Speed Dial n」( n は短縮ダイヤルの位置)と「Speed Dial n Name」という 1 組のカラムを使用します。この形式を使用すると、既存の短縮ダイヤル リストの末尾に新しい短縮ダイヤルが追加されます。
Speed Dial 1 Speed Dial 1 Name Speed Dial 4 Speed Dial 4 Name
• 回線グループ情報を指定する際は、LineGroupName:position という形式を セミコロンで区切って回線グループごとに繰り返します。LineGroupName は回線グループの名前です。position は選択した回線グループ内のディレクトリ番号の位置で、値として last(または LAST)、または 1 ~ 100 の数字を指定できます。たとえば、LG1:1;LG2:5;LG3:last のようになります。
追加の回線を追加する場合は、すべての回線グループ情報を入力する必要があります。回線グループのカラム ヘッダーは、「Line Groups(1)」や「Line Groups(2)」のようにする必要があります。
• カラムのインスタンスが複数ある場合(たとえば、ディレクトリ番号が複数ある場合など)は、各インスタンスのカラム名の末尾に (1) や (2) などを指定する必要があります(たとえば、Directory Number(1) や Directory Number(2) など)。
• Cisco Unified Communications Manager Express の電話機および回線設定テンプレートでは、区切り文字としてチルダ(~)を使用する必要があります。たとえば、
username AAAAA password BBBBBBBB~pin 676771 のようになります。この属性のカラム ヘッダーは、「CME Phone Configuration Template」です。
• Cisco Unified Communications Manager 内で数値が指定されているプロビジョニング属性の値の設定を解除するには、値として 0 を入力する必要があります。値を空にするだけでは、Cisco Unified Communications Manager でプロビジョニング属性は設定解除されません。
• ボイスメール アカウントをオーダーするときに、[Chosen Line] オプションを使用し、E.164 形式のディレクトリ番号を選択した場合、Provisioning は、ディレクトリ番号から + 記号を削除して、内線番号を設定します。ただし、[Alternate Extension] フィールドは、自動的に入力されません。バッチ ファイルの [Alternate Extension] フィールドに、(+ 記号付きで)ディレクトリ番号を入力する必要があります。
特定の機能を実行するには、バッチ処理ファイルで次のキーワードを使用します。
• CUPM_BLANK:Add オーダー タイプの場合は、その属性に対して値はプロビジョニングされません。Change オーダー タイプの場合は、現在の属性値がクリアされるか(該当する場合)、プロセッサによって要求されるデフォルト値に設定されます。
(注) 設定専用属性に対して Change オーダー タイプを使用するときに、属性が列挙型であり、有効値のスタティック リストをサポートする場合は(たとえば [Calling Search Space Activation Policy])、CUPM_BLANK は効果を持たなくなり、古い値が維持されます。
• CUPM_SKIP:処理ファイルの処理時にこのプロビジョニング属性をスキップします。この属性は、オーダー中に設定されません。前の設定値が保持されます。
(注) CUPM_SKIP を Add オーダー タイプとともに使用するときは、すべての属性がスキップ可能とは限りません。次に示す属性はスキップされません。
• 必須属性(たとえば [Device Pool] や [Location])はスキップされません。このような属性には、サービス エリア レベルのプロビジョニング属性設定が使用されます。
• [Device Description] と [Display (Internal Caller ID)]。これらの設定にはルールがあるため、そのルールに基づく値が使用されます。
バッチ処理ファイル内の属性の値は、次の優先順位に基づいて解析および適用されます。
3. 上記がどちらも適用されていない場合は、デフォルト設定が適用されます。
updatePA という名前の新しいバッチ テンプレートは、異なるレベル(サービス エリア、ドメイン、および加入者ロール)におけるプロビジョニング属性の更新をサポートします。バッチ テンプレートには、異なるレベルでプロビジョニング属性を設定するように定義されている、新しいカラム [Target Level] が含まれています。[OrderType] フィールドで updatePA を指定する必要があります。
Provisioning では、updatePA はサービス エリア レベルでのみサポートされています。次の表に、updatePA バッチ ファイルのフィールドの説明を示します。
|
|
---|---|
Cisco Unity Connection 7.1.x または 8.x から 9.x バージョンにアップグレードする場合は、[Voicemail Alternate Extension] フィールド値を [Extension] フィールドに移動するために、バッチ プロジェクトを実行する必要があります(詳細については、を参照してください)。このバッチ プロジェクトは、アップグレード プロセス後に実行する必要があります。
表 6-10 に、バッチ ファイルに含める必要があるカラムを示します。
バッチ プロビジョニング サポートは、Unified Communications Manager、Unity Connection、および Unity のすべてのインフラストラクチャ製品に提供されています。管理ロールを持つユーザは、バッチ プロビジョニングを使用してインフラストラクチャ製品をプロビジョニングできます。次を実行できます。
(注) すべてのインフラストラクチャ製品のサンプル バッチ ファイルは、opt\cupm\sep\ipt\config\sample\batchProvisioning\infrastructureProducts フォルダにあります。
バッチ プロビジョニング サポートは、Unified Communications Manager、Unity Connection、Unity、Presence Processor、Unity Express、Call Manager Express、および Generic IOS Router のすべてのデバイスに提供されています。管理ロールを持つユーザは、バッチ プロビジョニングを使用してデバイスをプロビジョニングできます。
(注) すべてのデバイスのサンプル バッチ ファイルは、opt\cupm\sep\ipt\config\sample\batchProvisioning フォルダにあります。
バッチ処理ファイルを作成したら、そのファイルが属するバッチ プロジェクトを作成する必要があります。バッチ処理ファイルをアップロードすると、その内容がバッチ処理に変換され、バッチ処理ファイル内のすべてのバッチ処理に共通するカラムが表示されます。
(注) バッチ処理ファイルは、バッチ処理間の依存関係に従って正しい順序でアップロードする必要があります。これらの依存関係の詳細については、「バッチ処理ファイルの作成に関するガイドライン」を参照してください。
ステップ 1 [Deploy] > [Batch Provisioning] を選択します。
ステップ 2 [Configure a Batch Project] ページで、[New] アイコン( )をクリックします。
ステップ 3 [Create a New Batch Project] ページで、名前を入力して、バッチ プロジェクトの注釈を追加します。
ステップ 4 [Create] をクリックします。バッチ プロジェクトの作成後、バッチ プロジェクトに 1 つまたは複数のバッチ処理ファイルをアップロードできます。
ステップ 5 [Configure a Batch Project] 画面で、[Upload a Batch Action File] をクリックします。
ステップ 6 [Upload a Batch Action file] ページで、次のいずれかを実行します
• [File to Upload] フィールドに、アップロードするファイルの完全なディレクトリ パスとファイル名を入力します。
• [Browse] をクリックし、アップロードするファイルを探してクリックします。
• 別のバッチ処理ファイルをアップロードします(この手順を繰り返します)。
• バッチ プロジェクトをすぐに実行します(「バッチ プロジェクトの実行」を参照)。
• バッチ プロジェクトを後で実行するためにスケジュール設定します(「バッチ プロジェクトのスケジュールの設定または再設定」を参照)。
プロビジョニング では現在、バッチ プロジェクトまたはバッチ処理ファイルの編集はできません。その代わりに、バッチ処理ファイルを手動で更新してからそのファイルを新しいバッチ プロジェクトにアップロードし、不要になったバッチ プロジェクトを削除できます。
ステップ 1 [Deploy] > [Batch Provisioning] を選択します。
ステップ 2 [Configure a Batch Project] ページで、[Chooser] アイコン( )をクリックします。
ステップ 4 [Configure a Batch Project] ページで、バッチ プロジェクト名の横の [Delete] アイコン( )をクリックします。
ステップ 5 確認メッセージ ボックスで、[OK] をクリックしてバッチ プロジェクトを削除します。
バッチ プロジェクトはすぐに実行することも、特定の時間に実行するためにスケジュール設定することもできます。現在実行中のバッチ プロジェクトを一時停止してから再開またはキャンセルすることも可能です。プロジェクトをスケジュール設定した後、一時停止または完全にキャンセルできます。また、たとえば予定されているメンテナンス停止期間の前にプロジェクトを確実に一時停止する場合など、プロジェクトを後で一時停止するようスケジュール設定することも可能です。
ステップ 1 [Deploy] > [Batch Provisioning] を選択します。
ステップ 2 [Configure a Batch Project] ページで、[Chooser] アイコン( )をクリックします。
ステップ 4 [Project Schedule] ペインで、[Project Start Date/Time] の横の [Now] をクリックします。
ステップ 5 [OK] をクリックします。バッチ プロジェクトが開始され、ステータスが [In Progress] に変わります (画面をリフレッシュするには、[Refresh] アイコン( )をクリックします)。バッチ プロジェクトが完了したら、ステータスが Complete に変わります。
バッチ プロジェクトをスケジュールまたは再スケジュールするには、次の手順を実行します。
ステップ 1 必要なバッチ プロジェクトを選択します(「バッチ プロジェクトの実行」を参照)。
ステップ 2 [Project Schedule] ペインで [Project Start Date/Time] の横の [Chooser] アイコン( )をクリックします。
ステップ 3 確認メッセージ ボックスで [OK] をクリックします。
ステップ 4 表示されるダイアログボックスに、日付と時刻、および必要に応じて協定世界時(UTC)オフセットまたは場所を指定し、[Select] をクリックします。
時計アイコン( )が [Status] セクションに表示され、バッチ プロジェクトがスケジュール設定されたことを示します。
(注) インフラストラクチャ設定用に作成されたバッチ プロジェクトは、エラーがあると再起動できません。
実行中のバッチ プロジェクトをキャンセル(中止)できます。プロビジョニング で進行中の処理はすべて完了しますが、残りの処理は実行されません。
バッチ プロジェクトをキャンセルするには、次の手順を実行します。
ステップ 1 必要なバッチ プロジェクトを選択します(「バッチ プロジェクトの実行」を参照)。
ステップ 2 [Project Schedule] ペインで、[Abort] をクリックします。
ステップ 3 バッチ プロジェクトを キャンセルするには、 [OK] をクリックします。
バッチ プロジェクトを一時停止すると、プロビジョニング で進行中の処理はすべて完了しますが、それ以上の処理は行われません。
バッチ プロジェクトを一時停止するには、次の手順を実行します。
ステップ 1 必要なバッチ プロジェクトを選択します(「バッチ プロジェクトの実行」を参照)。
ステップ 2 [Project Schedule] ペインで [Project Pause Date/Time] の横の [Pause] をクリックします。
ステップ 3 確認メッセージ ボックスで [OK] をクリックします。バッチ プロジェクトが一時停止したことを示すメッセージが表示されます。
ステップ 4 [Refresh] アイコン( )をクリックします。プロジェクトのステータスが [Paused] に変わります。
• バッチ プロジェクトを再開するには、[Restart] をクリックします。バッチ プロジェクトが再開されます。
• バッチ プロジェクトをキャンセルするには、[Abort] をクリックします。バッチ プロジェクトがキャンセルされます。
バッチ プロジェクトの一時停止をスケジュール設定できます。これはたとえば、バッチ プロジェクトを後で開始するためにスケジュール設定した後、そのプロジェクトを予定されているメンテナンス停止期間の前に確実に停止させる場合などに役立ちます。
バッチ プロジェクトを一時停止するようにスケジュールするには、次の手順を実行します。
ステップ 1 必要なバッチ プロジェクトを選択します(「バッチ プロジェクトの実行」を参照)。
ステップ 2 [Configure a Batch Project] ページの [Pause Execution] セクションで [Project Pause Date/Time] の横の [Chooser] アイコン( )をクリックします。
ステップ 3 [OK] をクリックして確定します。 [Select Date and Time] ダイアログボックスが表示されます。
ステップ 4 日付と時刻、および必要に応じて UTC オフセットまたは場所を指定し、[Select] をクリックします。日付と時刻が [Pause Execution] の横に表示され、バッチ プロジェクトの一時停止がスケジュール設定されたことを示します。
スケジュール設定したバッチ プロジェクトは、まだ処理が開始されていない場合、キャンセルできます。
スケジュールされたバッチ プロジェクトをキャンセルするには、次の手順を実行します。
ステップ 1 必要なバッチ プロジェクトを選択します(「バッチ プロジェクトの実行」を参照)。
ステップ 2 [Configure a Batch Project] ページで、[Project Schedule] ペインの下にある [Project Start Date/Time] の横の [Clear] アイコン( )をクリックします。
バッチ プロジェクトのスケジュール設定された一時停止をキャンセルするには、次の手順を実行します。
ステップ 1 必要なバッチ プロジェクトを選択します(「バッチ プロジェクトの実行」を参照)。
ステップ 2 [Project Schedule] セクションで、[Clear] アイコン( )をクリックします。
ステップ 3 [OK] をクリックして確定します。バッチ プロジェクトに対してスケジュール設定された一時停止がクリアされます。
バッチ プロジェクト処理の詳細を表示して、バッチ プロジェクトの詳細を確認できます。
(注) バッチ プロビジョニングでは、加入者ロールを持つユーザは、電話のオーダー中に新しい電話を追加できます。疑似ユーザであっても電話を追加できます。
バッチ プロジェクトの詳細を表示するには、次の手順を実行します。
ステップ 1 必要なバッチ プロジェクトを選択します(「バッチ プロジェクトの実行」を参照)。
ステップ 2 [Batch Project Actions] ペインで [View] をクリックします。
[View Batch Action Details] ページが表示されます。このページには、バッチ プロジェクト処理の設定情報がすべて表示されます。
実行中のバッチ プロジェクトのステータスを確認できます。プロビジョニング では、バッチ プロジェクトが進行するにつれてバッチ処理のステータスが更新されます。現在実行中の処理とそのステータスが一目でわかります。
バッチ プロジェクトの現在のステータスを表示するには、次の手順を実行します。
ステップ 1 [Deploy] > [Batch Provisioning] を選択します。
ステップ 2 [Configure a Batch Project] ページで、[Chooser] アイコン( )をクリックします。
[Choose a Batch Project] ダイアログボックスが表示されます。バッチ プロジェクト内の単一の実行中オーダーの詳細を表示する場合、管理者は、[My Activities]([Deploy] > [Order Management] > [My Activities])を使用して、ワークフローで実行中に各オーダーを表示することもできます。
[Configure a Batch Project] ページが表示されます。[Batch Project Actions] ペインに、各バッチ処理プロジェクトのステータスが表示されます。バッチ プロジェクトが完了した後、ユーザの加入者レコードをチェックして、オーダーが処理されたことを確認できます。