BroadWorks、BroadWorks 版 Webex、BroadCloud から Wholesale RTM ソリューションへの移行ツール

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

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

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

前提条件

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

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

• マック: 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 Web ブラウザで URL をロードします。http://localhost:8080。 

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

ユーザーインターフェースの図は、参考のために以下に示されています。

図 3: Cisco Webex でログイン

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

図 5: トークンの生成

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

OCI-P 接続を有効にする

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

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

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

AS_CLI> cd /アプリケーション/OpenClientServer/一般設定

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

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

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

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

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

AS_CLI> cd /アプリケーション/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 プロビジョニングを設定します。

Provisioning ディレクトリへの変更:

AS_CLI> cd /System/NetworkAccessLists/OCI/プロビジョニング

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> 取得する Address Description ======================== 127.0.0.1 local as 

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

 AS_CLI/Maintenance/ManagedObjects>でbroadworksを取得し、出力がOKに見えるか確認します。サンプル出力については以下を参照してください。AS_CLI/Maintenance/ManagedObjects>はbroadWorksのBroadWorks管理オブジェクト========================== *サーバーを取得します。アイデンティティ..............: ASバージョン...............: Rel_21.sp1_1.551の管理状態: ロック解除*アプリケーション: Name Version Deployed Administrative State Effective State ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked FlashPolicy 21.sp1_1.551 false Unlocked Stopped OpenClientServer 21.sp1_1.551 true Unlocked Unlocked WebContainer 21.sp1_1.551 true Unlocked Unlocked 4 件のエントリが見つかりました。 * ホステッドアプリケーション: Name Version Context Path Deployed ================================================================== 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 件のエントリが見つかりました。 

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

次のコマンドを使用して、セカンダリ アプリケーション サーバで Open Client Server が展開されていないか、まだ開始されていない場合、デプロイして起動します。

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

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

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

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

番号のアクティベーションを有効にする

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

ステップ1: 番号アクティベーションコマンドを実行します。

AS_CLI> cdサブスクライバ管理/番号アクティベーション

ステップ2: 有効化コマンドを実行します。

AS_CLI> dnMode groupAndUserActivationEnabledを設定する

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

BroadCloud の場合

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

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

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

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

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

Cisco BroadWorks および BroadWorks 版 Webex の場合

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

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

前提条件

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

   ServiceProviderID-A: - グループID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B: - すべて 

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = LOCALHOST REFRESH_TOKEN = Token Generatorツールからコピーされたパートナー管理者の更新トークン。移行_モード = サポートされる値はwebex_for_broadworks_to_wholesaleです。デフォルト値はbroadworks_to_wholesaleです。BroadWorks 版 webex_for_broadworks_to_wholesale Webex の移行に使用します。 

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

5. セカンダリ Cisco BroadWorks Application Server JDK/JRE 環境パスがファイルと異なる場合、export.sh ファイルの JDK/JRE 環境パスを変更します。

   JAVA_HOME=/usr/local/java/java_base

実行する手順

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

./export.sh

端末ログ

エクスポートに成功した端末では、次のログを使用できます。BroadSoft データエクスポートツールの実行:

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

出力

出力 ZIP (extracted_data_.zip) ファイルは、同じ抽出ツールディレクトリに格納されます。以下のコマンドを使用して、変換ツール入力の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 を使用します。抽出ツール出力 ZIP (extracted_data_.zip) ファイルを入力として読み込み、raw XML をプロビジョニングツールで使用される JSON 形式に変換します。

前提条件

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

1. conf/partner.cfgファイルのREFRESH_TOKEN（Token Generator Toolからコピーされたトークン）とNAME_OF_MAIN_LOCATIONを設定します。

   更新トークン_=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 名前_of_MAIN_LOCATION=Main 

2. 必要に応じて、conf/partner.cfg ファイルのプロビジョニング_ID（Partner Hub のテンプレートからコピー）を設定します。

   プロビジョニング_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

入力/customers.csvを充填する

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

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

実行する手順

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

Windows

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

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 を呼び出します。デフォルトでは、顧客のアドレスとプライマリ メールが検証されます。conf/partner.cfg ファイルで PROVISIONING_ID 値が指定されている場合、ロケーション情報も検証されます。事前チェック結果は例外レポートに含まれます。

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

プレチェック

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

プレチェッキンフォ

デフォルトでは、例外レポートには、事前チェックエラー (プロビジョニングをブロックする問題) のみが含まれます。このフラグを追加すると、プリチェックの成功結果も表示されます (たとえば、Webex 組織がすでに存在していて、自動的に添付できる場合)。

端末ログ

成功したトランスフォームのターミナルで次のログを記録します。

移行に成功できる BroadWorks 企業の概要レポート: 1 移行できない BroadWorks 企業: 正常に移行できる BroadWorks ユーザー 0 名: 移行できない 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": "!!!!!!!!!!REPLACE_と_PROVISIONINGID!!!!!!!!!!", "パッケージ": [ "webex_calling"、"common_area_calling" ]、"externalId": "external_id_engg_grp1", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "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/New_ヨーク "言語": "en_us", "番号": ["+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } } } , "broadworks_info「: {」service_provider_id": "collabmigrationtestSP_engg"、"group_id": "collabmigrationtestGRP_engg" }, "subscriber": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_と_CUSTOMERID!!!!!!!!!!", "電子メール": "amareswaranvel+benjaminjack@gmail.com"、"パッケージ": "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": "デフォルト", "numberOfRings": 3 }、"messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_WITH_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": "デフォルト", "numberOfRings": 3 }、"messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_WITH_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": "デフォルト", "numberOfRings": 3 }、"messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "devices": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_WITH_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": "デフォルト", "numberOfRings": 3 }、"messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_と_PERSONID!!!!!!!!!!", "product": "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"、"extension": "1105" } ]、"shared_call_appearances": []、"business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Enggデバイスプロファイル" ]、 "connect_client_to_upgrade_to_webex_app": [], "ロケーション": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ]、 "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg"、"hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

プロビジョニング ツールは、通常 (パートナーの管理者のラップトップ) 任意のマシンで実行でき、Webex パブリック API を使用します。変換ツール出力 JSON (customer.json) ファイルを入力として読み取り、Webex Wholesale 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. 移行ツールのバイナリをダウンロードして抽出した後、provisioning_tool.sh for MACおよびprovisioning_tool.bat for WindowsでJAVA_HOME環境変数を設定します。
3. partner.cfg ファイル:
   • WHOLESALE_PROVISIONING_IDとREFRESH_TOKEN（トークンジェネレータツールからコピーされたトークン）を設定します。パートナー管理者は、アカウントチームに連絡してプロビジョニング_IDを取得する必要があります。

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

   • パートナーがユーザーにウェルカム メールを送信しない場合は、[_管理者_招待_メールを許可] を false に設定します。デフォルト値は true です。

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

BroadCloud 移行の場合、同じリージョン:

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

BroadCloud 移行では、別のリージョン:

1. ツールは、番号、デバイス、共有コール アピアランスをプロビジョニングします。
2. ツールは、実際の電話番号と内線番号を持つユーザーと仮想ユーザーを作成します。
   すべてのEurope 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 から Wholesale への移行に関する追加の引数でプロビジョニング ツールを実行します。

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

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

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

端末ログ

以下は、プロビジョニングの成功時の端末のログです。

ツール名: プロビジョニング ツールのバージョン: 1.15.0 ********** ファイルの処理を開始しました: input/customer.json **************** Provisioning Customer external_id_engg_grp1 がプロビジョニングを完了するのを待機しています... 顧客 external_id_engg_grp1 がプロビジョニングを完了するのを待っています... 顧客external_id_engg_grp1のステータス: provisioned Provisioning Numbers Provisioning Users Provisioning User Features Provisioning Greetings Provisioning Schedules Provisioning Devices Provisioning Shared Call Appearances Provisioning Auto Attendants Provisioning Call Queues Provisioning Hunt Groups Provisioning Group Pagings Provisioning Call Parks Provisioning Call Pickups Provisioning Voice Portal ********** 完了ファイル: 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 および Webex for BroadWorks 移行では、このツールはパートナー ネットワーク内のセカンダリ Cisco BroadWorks アプリケーション サーバで実行され、OCI-P 経由で AS に接続されます。Transform Tool 出力 JSON (customer.json) ファイルを入力として使用し、OCI-P コマンドを実行してデバイスとソフト クライアントを移行します。

正常に動作すると、デバイスの移動ツールは次のようになります。

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

SCP および SSH

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

前提条件

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

   更新トークン_=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. conf/deviceMoveTool.conf ファイルで、セカンダリ Cisco BroadWorks アプリケーション サーバ ユーザ ID、パスワード、およびホスト名が正しいことを確認します。

   BROADWORKS_ユーザー_ID = admin BROADWORKS_パスワード = admin BROADWORKS_HOST_NAME = localhost 

3. devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Polycom フォン

Polycom 電話を Cisco BroadWorks から Wholesale Calling に移動するには、パートナー管理者は、Cisco BroadWorks 各 Polycom デバイス テンプレートのシステム レベルで新しい Identity/Device Profile Type ファイルを作成する必要があります。図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 の設定によって異なります。
3. デバイスの移動ツールは、Cisco BroadWorks アプリケーション サーバに、グループ レベルまたはデバイス レベルで電話機を再起動するように要求します。
4. 再起動要求後、Polycom電話のダウンロードと処理% BWMACADDRESS%.cfg。Polycom電話にダウンロードと処理migration_%BWMACADDRESS%.cfgを要求し、device.prov.serverNameをhttps://plcm.sipflash.com.に設定します。
   https://plcm.sipflash.com 米国地域については、他の地域では異なる URL があります。
5. Polycom 電話は %BWMACADDRESS%.cfg をダウンロードhttps://plcm.sipflash.com し、Webex Calling DMS によって管理されます。

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

実行する手順

DMT を呼び出すには 2 つの方法があります。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 | バージョン | Email | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@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_engg の下で Business Communicator のプロファイルの変更に成功しました 顧客組織 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 から削除されます。
   • 電話番号、alternatedIds として使用されるメールアドレス、および電話は BroadCloud で再作成されます。
   • 電話は再起動されます。
3. パートナー管理者は、PSTN 電話番号を BroadCloud キャリアに戻す必要があります。

Cisco BroadWorks および BroadWorks 版 Webex の場合

Cisco BroadWorks および BroadWorks 版 Webex の復帰プロセスは次のとおりです。

1. Cisco TAC でチケットを開き、デバイスの復帰を要求します。
2. セカンダリ BroadWorks アプリケーション サーバの復帰モードでデバイスの移動ツールを実行して、デバイスの移行を元に戻します。これにより、DMS URL が Cisco BroadWorks のデバイス プロファイルのサービス プロバイダー 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= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

番号を元に戻す

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

端末ログ

復帰操作のためのデバイス移動ツールを正常に実行すると、端末に次のログが表示されます。

プロファイルを元に戻す

ツール名: デバイス移動ツールのバージョン: 1.15.0 復帰プロセスのためのデバイス ツールが開始されました... Webex Calling から BroadWorks に移行できるデバイス: - ------------------------------------------------------------------------------------------------------------------- | デバイスタイプ | Mac | バージョン | Email | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@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]esまたは[N]o): Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] 復帰の開始 groupId に対して broadworks 電話番号プロセスをアクティブ化します。collabmigrationtestGRP_engg groupId で完了した broadworks 電話番号プロセスをアクティブにします。collabmigrationtestGRP_engg デバイスの移行を元に戻すプロセスが正常に完了しました