サポートされている電話は、プロビジョニング ツールによって自動的に作成され、Webex Calling のユーザーに割り当てられます。「デバイス移動ツールでサポートされている」列で「はい」とマークされた電話も、デバイス移動ツールが実行されているときに、Cisco BroadWorks または BroadCloud から Webex Calling に自動的に移動します。その列で「いいえ」とマークされた電話機は、Cisco BroadWorks デバイス テンプレートまたは電話機自体の DMS URL を変更するために手動による介入が必要です。

最後の列は、ファイル transform-tool/input/newphones.csv の「デバイス タイプ」列への電話機モデルのマッピングを示します。(newphones.csv の詳細については、この記事の変換ツール セクションを参照してください)。

パートナー管理者は、移行ツールの実行を開始する前に、少なくとも 1 回このトークン ジェネレータ ユーティリティ ツールを実行します。このツールの実行は、パートナー アカウントがホールセール RTM ソリューションにオンボードされた後、1 回限りのアクティビティです。このツールにより、パートナー管理者は Web ブラウザからログインして、移行ツールのパートナー構成ファイルへの更新に必要な一意のトークンを取得できます。

前提条件

ダウンロードしたら、移行ツールのバイナリを抽出します。

MAC の場合は token_generator.sh、Windows の場合は token_generator.bat で JRE/JDK 環境パスを設定します。JAVA_HOME パスがすでに存在する場合、ツールによって再利用されます。

• Mac: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

実行する手順

トークン ジェネレーター ディレクトリ内のターミナルで、次のコマンドを実行します。

Windows:

token_generator.bat

macOS:

./token_generator.sh

出力:

ツール名: トークン生成ツールのバージョン: 1.13.0 ウェブブラウザに URL をロードします。http://localhost:8080 

端末の Web ブラウザで URL を開き、パートナー管理者の資格情報でログインしてトークンを取得し、さらに使用するために同じものをコピーします。

ユーザーインターフェイスの図は、参照のために以下に示します。

図 3: Cisco Webex でログイン

図 4: 資格情報ウィンドウ

図 5: トークンの生成

セカンダリ BroadWorks サーバで抽出ツールとデバイス移動ツールを実行する前に、次の手順を設定します。

OCI-P 接続を有効にする

デバイス移動ツールは OCI-P コマンドを使用して、OCI-P 接続を有効にするために、以下の手順を使用します。

ステップ1: CLI を使用して全般設定を構成します。

CLI で次のコマンドを実行して、GeneralSettings ディレクトリに変更します。

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings

現在の GeneralSettings を取得するには、CLI で次のコマンドを実行します。

AS_CLI/Applications/OpenClientServer/GeneralSettings> get clientPort = 2208 clientPortEnabled = true secureClientPort = 2209 secureClientPortEnabled = true systemDomain = <> 

設定が上記と一致しない場合は、set コマンドを使用して設定を再構成してください。

ステップ 2: CLI を使用して OCI プロキシを設定します。

ディレクトリを OCI プロキシに変更します。

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

以下の CLI を実行して現在の設定を取得します。以下が表示されます。

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enableResponseCaching = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 messageQueueCapacity = 50 messageQueueTimeoutSeconds = 1800 

設定が上記と一致しない場合は、set コマンドを使用して設定を再構成してください。

ステップ 3: CLI を使用して OCI プロビジョニングを設定します。

プロビジョニング ディレクトリに変更します。

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

現在の OCI プロビジョニング設定を取得するには、次のコマンドを実行します。

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> 住所の説明 ======================== 127.0.0.1 をローカルで次として取得する 

ステップ 4: CLI で以下のコマンドを実行して、設定が正しいことを確認します。

 AS_CLI/Maintenance/ManagedObjects> は Broadworks を取得し、出力が OK であることを確認します。サンプルの出力については、以下を参照してください。AS_CLI/Maintenance/ManagedObjects> は BroadWorks BroadWorks 管理対象オブジェクトを取得します ========================== * サーバー: アイデンティティ..............: バージョン...............: Rel_21.sp1_1.551 管理状態... ロック解除済み * アプリケーション: 名前 バージョン 展開された管理状態 Effective State ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true ロック解除済み ロック解除済み FlashPolicy 21.sp1_1.551 false ロック解除済み OpenClientServer 21.sp1_1.551 true ロック解除済み ロック解除済み WebContainer 21.sp1_1.551 true ロック解除済み 4 エントリが見つかりました。 * ホストされたアプリケーション: 名前 バージョン コンテキスト パス 展開済み ================================================================== CommPilot 21.sp1_1.551 / true DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true JWSFiles 21.sp1_1.551 /FileRepos true MediaFiles 21.sp1_1.551 /media true OCIFiles 21.sp1_1.551 /ocifiles true 5 エントリが見つかりました。 

オープン クライアント サーバーが展開され、アクティブであることを確認します

セカンダリ アプリケーション サーバが展開されていないか、まだ起動していない場合は、以下のコマンドを使用して、オープン クライアント サーバを展開して起動します。

ステップ1: 次の CLI コマンドを使用してサーバを展開します。

AS_CLI/Maintenance/ManagedObjects> アプリケーション OpenClientServer の展開

ステップ 2: 次のコマンドでサーバを起動します。

AS_CLI/Maintenance/ManagedObjects> アプリケーション OpenClientServer の開始

番号のアクティベーションを有効化

CLI で次のコマンドを実行して、番号のアクティベーションを有効にします。

ステップ1: number activation コマンドを実行します。

AS_CLI> cd SubscriberMgmt/NumberActivation

ステップ 2: アクティベーション対応コマンドを実行します。

AS_CLI> set dnMode groupAndUserActivationEnabled

ステップ 3: 確認プロンプトで、Y を入力します。

BroadCloud の場合

抽出 ツールは、BroadCloud サービス プロバイダー ポータルに統合されています。サービス プロバイダーの管理者は次のことを実行できます。

1. 1 リクエストあたり最大 50 人の顧客の抽出リクエストを送信します。
   同じ顧客に対して 1 日に 10 回以上抽出リクエストを送信することはできません。
2. 抽出したデータファイルをZIP形式でダウンロードし、リクエスト送信日から28日以内で完了します。

以下の図は、サービス プロバイダー ポータルを示しています。

図 6: サービス プロバイダー ポータル

図 7: サービス プロバイダー ポータル

Cisco BroadWorks および BroadWorks 版 Webex

1. extract ツールは、パートナー ネットワーク内のセカンダリ Cisco BroadWorks アプリケーション サーバで実行され、OCI-P 経由で接続します。
2. このツールは、未加工のエンタープライズ、グループ、番号、ユーザー、サービス、デバイス、およびソフト クライアントのデータを Cisco BroadWorks または BroadCloud プラットフォームから取得し、このデータを XML ファイルに出力し、変換ツールの入力を提供します。

次のセクションでは、抽出ツールのインストールと設定方法について説明します。

前提条件

1. セカンダリ Cisco BroadWorks アプリケーション サーバに展開ツール バイナリを SCP します。
2. SSH をセカンダリ Cisco BroadWorks アプリケーション サーバに転送して、前提条件を設定し、extract ツールを実行します。
3. conf/exportTool.yml で Cisco BroadWorks から抽出するサービス プロバイダーとグループ ID を設定します。以下の YAML スニペットを参照してください。

   サービス プロバイダー ID-A: - GroupID-A1 - GroupID-A2 - GroupID-A3 サービス プロバイダー ID-B: - すべて 

4. セカンダリ Cisco BroadWorks アプリケーション サーバのユーザー ID、パスワード、およびホスト名が正しいことを確認してください。conf/partner.cfg ファイル:

   BROADWORKS_USER_ID = ADMIN BROADWORKS_PASSWORD = ADMIN BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = トークンジェネレーターツールからコピーされたパートナー管理者の更新トークン。MIGRATION_MODE = サポートされている値は webex_for_broadworks_to_wholesale です。デフォルト値は broadworks_to_wholesale です。BroadWorks 版 Webex の移行に webex_for_broadworks_to_wholesale を使用します。 

   REFRESH_TOKEN プロパティは、BroadWorks 版 Webex の移行に必須です。

5. セカンダリ Cisco BroadWorks アプリケーション サーバ JDK/JRE 環境パスがファイルと異なる場合は、export.sh ファイルの JDK/JRE 環境パスを変更します。

   JAVA_HOME=/usr/local/java/java_base

実行する手順

抽出ツール ディレクトリからセカンダリ Cisco BroadWorks アプリケーション サーバで以下のコマンドを実行します。

./export.sh

ターミナル ログ

エクスポートの成功時にターミナルで次のログを利用できます。BroadSoft データエクスポートツールを実行中:

 BroadSoft データエクスポートツールの実行中 ************************************************ エクスポートツール v の開始: 1.15.0 SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg のエクスポートが開始されました SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg のエクスポートが完了しました SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg のエクスポートが完了しました SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg のエクスポートが完了しました Export Dump Zip Directory : output/20221017223452_ExportTool Export Dump Zip ファイル名:extracted_data_1666060500618.zip という名前の Zip ファイル extracted_data_1666060500618.zip が作成されました ZIP ファイル作成プロセスが完了し、エクスポートされたファイルを ZIP ファイルとして変換しました ************************************************** 

出力

出力 ZIP (extracted_data_.zip) ファイルは、同じ extract ツール ディレクトリで使用できます。以下のコマンドを使用して、変換ツールの入力に ZIP ファイルを表示し、使用します。

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 10月4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 10 月4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 10 月4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 10 月5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 10 月 17 22:34 output/ drwxrwxr-x 2 bwadmin bwadmin 4096 10 月 17 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 10 月 17 22:35 extracted_data_1666060500618.zip 

このトランスフォーム ツールは、すべての移行に対して実行されます。トランスフォーム ツールは、パートナーの管理者のラップトップを含む任意のコンピュータ上で実行され、Webex パブリック API を使用します。extract ツール出力 ZIP (extracted_data_.zip) ファイルを入力として読み取り、プロビジョニング ツールによって使用される JSON 形式に変換します。

前提条件

移行ツールのバイナリをダウンロードして抽出したら、次の前提条件を設定します。

1. conf/partner.cfg ファイルで、更新トークン (トークン ジェネレータ ツールからコピーされたトークン) とメインロケーションの名前を設定します。____

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 名前__MAIN_LOCATION=メイン

2. 必要に応じて conf/partner.cfg ファイルで PROVISIONING_ID (Partner Hub のテンプレートからコピー) を設定します。

   プロビジョニング_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   顧客のメール アドレスをより完全に確認するには、オプションで PROVISIONING_ID を設定できます。
3. 不足している場合は、input/customers.csv ファイルで不足している情報を設定します (次のセクションを参照)。
4. input/users.csv ファイルにエンド ユーザーのメール アドレスを追加します。
5. 新しい電話をプロビジョニングする場合は、ユーザーの新しい電話機の mac アドレスとメール アドレスを入力/newphones.csv ファイルに追加します。これは、パートナー管理者がホールセール コールで新しい電話機をプロビジョニングする場合にのみ必要です。
6. input/cxessentials.csv ファイルを使用して、BroadWorks コール センターを CxEssentials に変換します。
7. オプションで、UPGRADE_ALL_CALL_CENTERS_ TO_CX_ESSENTIALS プロパティを有効にして、すべてのコール センターを CXEssentials に変換します。
8. input/locations.csv ファイルを使用して、管理者が顧客のロケーションをロケーションごとに移行できる大企業の移行をサポートします。
9. 必要に応じて、Cisco BroadWorks デバイス プロファイルで MAC アドレスが使用できない場合に、SIP REGISTER メッセージの User-Agent ヘッダーから MAC アドレスの使用を有効にします。ファイル conf/partner.cfg で「USE_MAC_ADDRESS_from_SIP_REGISTER=yes」の行にコメントを解除します。

入力/customers.csv を記入する

ファイル input/customers.csv は、Cisco BroadWorks または BroadCloud で欠落している可能性のあるデータを提供します。すべての必須情報がすでにある場合、このファイルは空のままにしておくことができます。すべての列に入力する必要はなく、欠落している情報だけが必須です。

以下の表では、input/customers.csv の最も重要な列について説明します。

実行する手順

任意のオペレーティング システムでトランスフォーム ツールを実行します。以下の手順を使用して、Windows および macOS でツールを実行します。

Windows

以下のコマンドを実行して、Windows で変換ツールを実行します。

transform.bat -extract= -customers= -users= -newphones=

macOS

macOS で変換ツールを実行するには、次の手順を実行します。

1. 仮想環境を作成し、依存関係をインストールして、Python を使用して変換ツールを実行します。

   python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. 変換ツールを実行します:

   ./transform.sh -extract= -customers= -users= -newphones=

顧客/ユーザーの事前チェック

トランスフォーム ツールは、潜在的なプロビジョニングの問題をキャッチするために、Webex への API コールを行います。デフォルトでは、顧客のアドレスとプライマリ メールを検証します。PROVISIONING_ID 値が conf/partner.cfg ファイルで指定されている場合、ロケーション情報も検証します。事前チェックの結果は例外レポートに含まれます。

また、トランスフォーメーション ツールの実行時に、次のオプションパラメータを追加できます。

プレチェック

顧客情報のプリチェック API を実行することに加えて、トランスフォーム ツールはサブスクライバ メールのプリチェック API も実行します。

チェックイン

デフォルトでは、例外レポートにはエラーの事前チェックのみが含まれます (つまり、プロビジョニングをブロックする問題)。このフラグを追加すると、正常な事前チェック結果も含まれます (例: 自動的に添付できる Webex 組織がすでに存在する場合など)。

ターミナル ログ

変換の成功時にターミナルに次のログがあります。

正常に移行可能な BroadWorks エンタープライズの概要レポート: 移行できない 1 つの BroadWorks 企業: 正常に移行可能な 0 BroadWorks ユーザー: 移行できない 4 つの BroadWorks ユーザー: 正常に移行可能な 0 台の電話: Webex Calling と互換性のない 3 台の電話: 0 

例外レポート

Transform Tool は、output//exception_report.txt ディレクトリ内で例外レポートを生成します。このレポートを使用して、移行に影響を与える問題を特定し、Cisco BroadWorks システムで修正できます。

例外を解決するためにユーザー データを変更した後、新しいデータを使用して Extract and Transform Tools を再実行します。例外のレポートファイルは次のとおりです。

例外レポート Tue Oct 18 08:12:09 2022 コミュニケーション除外機能の推奨事項: Control Hub の ________________________________________________________________________________ collabmigrationtestGRP_engg 

出力

出力 JSON (customer.json) ファイルは output// ディレクトリで入手できます。サンプル customer.json ファイルの例:

{ "customer": { "provisioningId": "!!!!!!!!!!置き換え_で_PROVISIONINGID!!!!!!!!!!", "パッケージ": [ "webex_calling「、」common_area_calling" ], "externalId": "external_id_engg_grp1", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "customerInfo": { "name": "Engineering Group - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "location": { "name": "Main", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/N"ew_ヨーク", "言語": "en_us", "numbers": ["+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110"], "mainNumber": "+15205551101" } } } } }, "broadworks_info「: {」service_provider_id": "collabmigrationtestSP_engg「、」group_id": "collabmigrationtestGRP_engg" }, "subscribers": [ { "amareswaranvel+benjamin injack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_で_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjamin injack@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true、"sendBusyCalls": { "enabled": true、"greeting": "DEFAULT" }、"sendUnansweredCalls": { "enabled": true、"greeting": "DEFAULT"、"numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true、"storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_で_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_で_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true、"sendBusyCalls": { "enabled": true、"greeting": "DEFAULT" }、"sendUnansweredCalls": { "enabled": true、"greeting": "DEFAULT"、"numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true、"storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_で_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_で_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Leo", "lastName": "Jackson", "primaryPhoneNumber": "+15205551104", "extension": "1104" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true、"sendBusyCalls": { "enabled": true、"greeting": "DEFAULT" }、"sendUnansweredCalls": { "enabled": true、"greeting": "DEFAULT"、"numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true、"storageType": "external", "externalEmail": "engineeringmacpc@mailnator.com" } } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_で_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true、"sendBusyCalls": { "enabled": true、"greeting": "DEFAULT" }、"sendUnansweredCalls": { "enabled": true、"greeting": "DEFAULT"、"numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true、"storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_で_PERSONID!!!!!!!!!!", 「製品」:「DMS Cisco 8811」、「mac」:「F87B204E4066」 } ] } } ]auto_attendants「: []、」call_queues「: []、」hunt_groups": [], "スケジュール": [], "call_parks「: []、」call_pickups「: []、」paging_groups「: []、」voice_portals": [ { "name": "自動音声ポータル", "firstName": "自動化", "lastName": "音声ポータル", "languageCode": "en_us", "phoneNumber": "+15205551105", "内線": "1105" } ], "shared_call_appearances「: []、」business_communicator_desktop_to_upgrade_to_webex_app": ["PC Comm - Engg Device Profile"], "connect_client_to_upgrade_to_webex_app": [], "locations": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

プロビジョニング ツールは、通常 (パートナーの管理者ラップトップ) 任意のマシンで実行でき、Webex パブリック API を使用します。変換ツールの出力 JSON (customer.json) ファイルを入力として読み取り、Webex ホールセール RTM ソリューションで顧客、ロケーション、番号、ユーザー、サービス、デバイスをプロビジョニングします。

前提条件

プロビジョニング ツール ディレクトリ内で次の前提条件を設定します。

1. コンピューターに Java 8、11、または 17 をインストールします。Java は、以下を含む多くのソースから入手できます。
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. 移行ツールのバイナリをダウンロードして展開した後、MAC 版 provisioning_tool.sh および Windows 版 provisioning_tool.bat で JAVA_HOME 環境変数を設定します。
3. partner.cfg ファイル:
   • ホールセール_プロビジョニング_ID と更新_トークンを設定します (トークン ジェネレータ ツールからコピーされたトークン)。パートナー管理者は、アカウント チームに連絡して、プロビジョニング_ID を取得する必要があります。

     ホールセール_プロビジョニング_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 更新_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • パートナーがユーザーにウェルカム メールを送信したくない場合は、[_ADMIN_INVITE_] メールを false に設定します。デフォルト値は true です。

4. BroadWorks 版 Webex の移行の WEBEX4BWKS_EMAIL_SUBJECT プロパティを使用して、BroadWorks 版 Webex サブスクライバのパスワード変更要求メールの件名を送信します。
5. BroadWorks 版 Webex の移行の WEBEX4BWKS_EMAIL_BODY プロパティを使用して、BroadWorks 版 Webex サブスクライバー用のパスワード変更要求のメール本文を送信します。

BroadCloud 移行で同じリージョン:

1. このツールは、番号、デバイス、共有コールアピアランスのプロビジョニングをスキップします。
2. このツールは、内線と一時的な内線を持つユーザーと仮想ユーザーを作成します。

BroadCloud 移行別の地域の場合:

1. このツールは、番号、デバイス、共有コールアピアランスをプロビジョニングします。
2. このツールは、実際の電話番号と内線番号を持つユーザーと仮想ユーザーを作成します。
   すべてのヨーロッパの BroadCloud 移行は別の地域への移行です。

実行する手順

Windows および macOS でツールを実行するには、次の手順を使用します。

Windows

Windows OS でツールを実行するには、次の手順を実行します。

単一顧客をプロビジョニングするには: provision.bat -input= 複数の顧客をプロビジョニングするには: provision.bat -input= 

macOS

次の手順を実行して、macOS でツールを実行します。

単一の顧客をプロビジョニングするには: ./transform.sh -input= 複数の顧客をプロビジョニングするには: ./transform.sh -input= 

BroadWorks 版 Webex 移行の前提条件

パートナー管理者は、BroadWorks 版 Webex の共存機能の BroadWorks オンボーディング テンプレートを更新する必要があります。次の画像を参照してください。

移行をサポートするために BroadWorks 版 Webex オンボーディング テンプレートが更新されたら、Cisco アカウント チームに「wholesale-partner-blending-enabled」機能を有効にするようリクエストします。これにより、プロビジョニング中にホールセール パッケージを BroadWorks 版 Webex の既存顧客組織に追加できるようになります。

追加の引数でプロビジョニング ツールを実行します。

準備段階: は、管理者が BroadWorks ユーザーをホールセール サブスクライバーとしてプロビジョニングし、BroadWorks 版 Webex ユーザーを続行できるデフォルトのフェーズです。

メンテナンスフェーズ: は、管理者が既存の BroadWorks 版 Webex ユーザーにホールセール ライセンスを割り当てることができる第 2 段階です。メンテナンスという引数を伴うプロビジョニング ツールを実行する必要があります。

移行後のフェーズ: 管理者が BroadWorks をホールセールに完全に変換できる最終段階です。移行後の引数を伴うプロビジョニング ツールを実行する必要があります。

ターミナル ログ

以下は、プロビジョニングの成功時にターミナル内のログです。

ツール名: プロビジョニング ツール バージョン: 1.15.0 ********** ファイルの処理を開始しました: input/customer.json **************** プロビジョニング 顧客待ち external_id_engg_grp1 でプロビジョニングを完了します... 顧客 external_id_engg_grp1 がプロビジョニングを完了するのを待っています... 顧客 external_id_engg_grp1 のステータス: プロビジョニング番号 プロビジョニング ユーザー プロビジョニング ユーザー機能 プロビジョニング グリーティング プロビジョニング スケジュール プロビジョニング デバイス プロビジョニング 共有コールアピアランス プロビジョニング 自動音声応答 プロビジョニング コール キュー プロビジョニング ハント グループ プロビジョニング グループ ページング プロビジョニング コール パーク プロビジョニング コール ピックアップ プロビジョニング 音声ポータル ********** 完了したファイル: input/customer.json **************** 

各実行に作成されたロケーションの数を示す表が印刷されます。

出力

プロビジョニング ツールは、output/<external_id>/*.success/error ファイル内で成功レポートとエラーレポートを生成します。出力の成功とエラー ログを確認して、プロビジョニングが成功していることを確認します。

パートナー管理者は、Partner Hub と Control Hub ポータルで顧客のプロビジョニングを確認できます。Partner Hub と Control Hub ポータルから次の図を参照してください。

図 8: パートナー ハブ

図 9: Control Hub

図 10: デバイス

図 11: 発信しています

BroadCloud の場合

BroadCloud パートナーの場合、サービス プロバイダー ポータルを使用して、番号、デバイス、および SCA 移行に関する移行リクエストを送信します。

サービス プロバイダー ポータル内で、移行リクエストには、最大 50 人の顧客を含めることができます。1 日以内に最大 10 件のリクエストを送信できます。

以下の図は、サービス プロバイダー ポータルを示しています。

図 12: サービス プロバイダー ポータル

図 13: サービス プロバイダー ポータル

Cisco BroadWorks および BroadWorks 版 Webex

Cisco BroadWorks および BroadWorks 版 Webex の移行では、このツールはパートナー ネットワーク内のセカンダリ Cisco BroadWorks アプリケーション サーバー上で実行され、OCI-P を通じて AS に接続します。Transform Tool 出力 JSON (customer.json) ファイルを入力として使用し、OCI-P コマンドを実行して、デバイスとソフト クライアントを移行します。

操作が成功すると、デバイス移動ツールは次のことを実行します。

1. Cisco BroadWorks からデバイスを登録解除し、ホールセールに登録します。
2. UC-One クライアントを使用するユーザーは、初回サインイン時に Webex アプリにリダイレクトされます。
3. Cisco BroadWorks から電話番号を無効にするか、BroadCloud から電話番号を削除します。
4. ホールセールで番号を有効にします。
5. BroadCloud 移行用のホールセールで共有コール アピアランスを作成します。[この手順は、BroadCloud の移行にのみ適用されます]。

SCP および SSH

1. SCP デバイス移動ツールをセカンダリ Cisco BroadWorks アプリケーション サーバに移動します。
2. セカンダリ Cisco BroadWorks アプリケーション サーバへの SSH で前提条件を設定し、デバイス移動ツールを実行します。

前提条件

1. conf/partner.cfg ファイルで REFRESH_TOKEN (トークン ジェネレータ ツールからコピーされたトークン) を設定します。

   更新_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. セカンダリ Cisco BroadWorks アプリケーション サーバのユーザー ID、パスワード、およびホスト名が正しいことを確認してください。

   BROADWORKS_ユーザー_ID = ADMIN BROADWORKS_パスワード = admin BROADWORKS_ホスト_NAME = localhost 

3. アクティベーション メールを再送信するには、conf/partner.cfg ファイルで RESEND_INVITATION_EMAILS=true を設定する必要があります。

   管理者が移行中にユーザーに招待メールを送信したい場合は、conf/partner.cfg ファイルの「RESEND_INVITATION_EMAILS=true」プロパティへのコメントを解除する必要があります。それ以外の場合は、プロパティは変更されません。

4. devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

   で JDK/JRE 環境パスが正しいことを確認します。
5. 管理者は、入力ディレクトリから locations.csv ファイルを使用して、企業内のすべてのグループではなく、特定のグループを移行できます。

Polycom 電話

Polycom 電話を Cisco BroadWorks からホールセール コールに移行するには、パートナー管理者が Cisco BroadWorks 各 Polycom デバイス テンプレートで、システム レベルで新しい ID/デバイス プロファイル タイプ ファイルを作成する必要があります。図 14 を参照し、カスタム ファイル device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg をアップロードします。新しいデバイス ファイルをアップロードした後、新しく作成されたファイルがグループ レベルで存在することを確認します。また、ファイル migration_%BWMAC ADDRESS%.cfg がシステム内の既存のファイルと競合していないことを確認してください)。

これは、デバイス移動ツールによって内部で使用されます。

Polycom 電話の移行プロセス:

1. デバイス移動ツールは、デバイス レベルの %BWMACADDRESS%.cfg を polycom_vvx2.cfg に置き換えます。このファイルは migration_%BWMACADDRESS%.cfg を参照します。
2. デバイス プロファイルをグループ レベルまたはデバイス レベルで再構築します。
   グループ レベルまたはデバイス レベルでの動作は、ファイル device-move-tool/conf/partner.cfg の deviceLevelRebuild のパラメータ deviceLevelRebuild の設定によって異なります。
3. デバイス移動ツールは、Cisco BroadWorks アプリケーション サーバに、グループ レベルまたはデバイス レベルで電話機を再起動するように要求します。
4. リブート要求の後、Polycom 電話機は % BWMACADDRESS%.cfg をダウンロードして処理します。これにより、migration_%BWMACADDRESS%.cfg は device.prov.serverName を https://plcm.sipflash.com. に設定します。
   https://plcm.sipflash.com 米国地域の場合、他の地域には異なる URL があります。
5. Polycom 電話は %BWMACADDRESS% から https://plcm.sipflash.com .cfg をダウンロードし、Webex Calling DMS により管理されます。

図 14: ID/デバイス プロファイル タイプ ファイルの追加

実行する手順

DMT を呼び出すには 2 つの方法があります。1 つは一度に 1 つの顧客を通して呼び出し、もう 1 つは複数の顧客を同時に実行することです。

デバイス移動ツールは、デバイス移動ツール ディレクトリ内のセカンダリ Cisco BroadWorks アプリケーション サーバから実行されます。

デバイスの場合、単一の顧客を移動します。 ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json デバイスの場合、複数の顧客を移動します。 ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/customer1.json customer2.json customer3.json さらに、デバイス移動ツールは 1.35.0 リリースからの単一または特定の電話機の移行をサポートしています。以下のコマンドを使用します。 ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

ターミナル ログ

以下は、デバイス移行のためにデバイス移動ツールを正常に実行したときの端末のログです。

ツール名: デバイス移動ツールのバージョン: 1.15.0 デバイス ツールの開始... 移行のための有効なデバイス: ------------------------------------------------------------------------------------------------------------------- | デバイス タイプ | Mac | バージョン | メール | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjamin injack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- すべてのデバイスを移行しますか? ([Y]ES または [N]o) はい DMS Cisco MPP LC のデバイス プロファイルのアップロード デバイスプロセスの再構築開始 デバイスプロセスの再構築が正常に完了しました 再起動プロセスが正常に完了しました グループ collabmigrationtestGRP で Business Communicator のプロファイルを変更する_engg 顧客の組織 Id に対して開始された webex 電話番号のアクティベート: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c 顧客の組織 ID に対して完了した Webex 電話番号のアクティベート プロセス: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c groupId に対して開始された BroadWorks 電話番号の非アクティブ化プロセス: collabmigrationtestGRP_engg groupId に対して完了した BroadWorks 電話番号の無効化プロセス: collabmigrationtestGRP_engg デバイスの移行が完了しました 

出力

デバイスの移行後、デバイスはオンラインになり、通話の受発信の準備が整いました。デバイス ステータスの例については、図 15 を参照してください。

図 15: デバイスのステータス

デバイスの移行後、番号がアクティブになります。アクティブになっている番号の例については、図 16 を参照してください。

図 16: アクティブな番号

元に戻す操作は、一度に 1 つのエンタープライズに対して実行する必要があります。

BroadCloud 通信事業者

BroadCloud パートナーの元に戻すプロセスは次のとおりです。

1. Cisco TAC でチケットを開き、デバイスの復帰をリクエストします。
2. リセット モードでデバイス移動ツールを実行します。
   • 電話番号は Webex Calling から割り当て解除され、ユーザーとサービスには内線のみが残ります。
   • Webex Calling のメール アドレスは一時メール アドレスに戻ります。
   • 電話は Webex Calling から削除されます。
   • 電話番号、alternatedId として使用されるメール アドレス、および電話は BroadCloud で再作成されます。
   • 電話が再起動されます。
3. パートナー管理者は、PSTN 電話番号を BroadCloud キャリアに戻す必要があります。

Cisco BroadWorks および BroadWorks 版 Webex

Cisco BroadWorks および BroadWorks 版 Webex の元に戻すプロセスは次のとおりです。

1. Cisco TAC でチケットを開き、デバイスの復帰をリクエストします。
2. セカンダリ BroadWorks アプリケーション サーバで、デバイス移動ツールをリセット モードで実行して、デバイスの移行を元に戻します。これにより、Cisco BroadWorks のデバイス プロファイルのサービス プロバイダー DMS URL に DMS URL を再設定し、電話番号を再アクティベートします。
3. Webex Calling チームは、Webex Calling のデバイス プロファイルのサービス プロバイダー DMS URL を DMS URL に戻します。
4. パートナー管理者は、Control Hub ポータルを通じて Webex Calling の電話番号を無効化または削除する必要があります。
5. パートナー管理者は、PSTN 電話番号を Cisco BroadWorks に戻す必要があります。

リセット モードでデバイス移動ツールを実行する手順

リセット モードでデバイス移動ツールを実行するには、以下の手順に従います。

デバイス移動ツール ディレクトリ内のセカンダリ Cisco BroadWorks アプリケーション サーバで、以下のコマンドを実行します。

プロファイルを元に戻す

./devicemove.sh -input=  -revertProfiles

番号を元に戻す

./devicemove.sh -input=  -revertNumbers

ターミナル ログ

元に戻す操作のためにデバイス移動ツールを正常に実行すると、ターミナルで次のログを取得します。

プロファイルを元に戻す

ツール名: デバイス移動ツールのバージョン: 1.15.0 デバイスツールが復帰プロセスを開始しました... Webex Calling から BroadWorks に戻すことができるデバイス: - ------------------------------------------------------------------------------------------------------------------- | デバイス タイプ | Mac | バージョン | メール | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjamin injack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- これらのデバイスを Webex Calling から BroadWorks に戻しますか? （はい、Y、いいえ、N）: はい DMS Cisco MPP LC のデバイス プロファイルのアップロード デバイス プロセスの再構築開始 デバイスの再構築が正常に完了しました 再起動プロセスが開始されました 再起動プロセスが正常に完了しました デバイスの移行が正常に完了しました 

番号を元に戻す

ツール名: デバイス移動ツールのバージョン: 1.15.0 BroadWorks への番号の復帰を続行しますか? ([Y]または[N]o): Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] 元に戻す groupId に対して開始された BroadWorks 電話番号のアクティベート プロセスを開始します。collabmigrationtestGRP_engg groupId に対して完了した BroadWorks 電話番号プロセスをアクティブ化します。collabmigrationtestGRP_engg デバイス移行のリvert プロセスが正常に完了しました