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

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

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

前提条件

コンピューターに Java 8、11、17、または 21 をインストールします。Java は、以下を含むさまざまなソースから入手できます。

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

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

実行手順

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

Windows:

token_generator.bat

MacOSの場合:

./token_generator.sh

出力：

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

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

参考までに、ユーザー インターフェイスの図を以下に示します。

図 3: Cisco Webexでログイン

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

図 5: トークン生成

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

OCI-P接続を有効にする

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

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

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

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 Proxy に変更します。

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> get
Address Description
========================
127.0.0.1 local as

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
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 entries found.
* Hosted Applications:
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 entries found.

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

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

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

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

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

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

AS_CLI> set dnMode groupAndUserActivationEnabled

ステップ3: 確認プロンプトで「Y」と入力します。

ブロードクラウドの場合

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

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

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

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

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

CSV抽出リクエスト

CSV抽出リクエストを開始する

1. 顧客CSVをダウンロード

   CSV 抽出リクエストの開始 セクションの右上隅にある 顧客 CSV のダウンロード リンクをクリックします。

2. 顧客リストを編集する

   管理者は、この CSV ファイルを編集して、抽出を実行する必要がある顧客のみを含めることができます。

3. アップロードして送信

   編集後、変更したCSVをアップロードします。

   [送信]をクリックして、リストされている顧客とその関連場所の抽出リクエストを開始します。

ロケーションCSVを使用した顧客の抽出リクエストの開始

1. 顧客とダウンロード場所を選択

   ドロップダウンから顧客を選択します。

   対応する locations.csv を 顧客の表示→ サイトタブ → 場所をCSVとしてエクスポートからダウンロードします。

2. 場所ファイルを編集する

   管理者は、抽出したい場所のみを含めるように CSV を編集できます。

3. アップロードして送信

   編集したlocations.csvをアップロードし、 送信をクリックします。

   抽出リクエストには、選択した顧客の指定された場所のみが含まれます。

すべての顧客に対する抽出リクエストの開始

1. [送信]をクリックすると、現在のサービス プロバイダーの下にある すべての顧客 と のすべての場所 の抽出リクエストが開始されます。

Cisco BroadWorksおよびWebex for BroadWorksの場合

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

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

前提条件

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

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

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

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

   JAVA_HOME=/usr/local/java/java_base

実行手順

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

./export.sh

端末ログ

エクスポートが成功すると、ターミナルに次のログが表示されます。BroadSoft データ エクスポート ツールの実行:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting 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
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

出力

出力ZIP (extracted_data_<timestamp>.zip)ファイルは、同じ抽出ツールディレクトリにあります。変換ツールの入力用の ZIP ファイルを表示して使用するには、次のコマンドを使用します。

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

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

前提条件

移行ツールのバイナリをダウンロードして解凍した後、次の前提条件を構成します。

1. REFRESH_TOKEN（トークン生成ツールからコピーされたトークン）とNAME_OF_MAIN_LOCATIONを conf/partner.cfg ファイル：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. オプションで、PROVISIONING_ID（パートナーハブのテンプレートからコピーしたもの）を conf/partner.cfg ファイル：

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   顧客の電子メール アドレスの検証をより完全に行うには、オプションで PROVISIONING_ID を設定できます。
3. 不足している情報を設定する input/customers.csv ファイルがない場合には、次のセクションを参照してください。
4. エンドユーザーのメールアドレスを input/users.csv ファイル。
5. 新しい電話をプロビジョニングする場合は、ユーザーの新しい電話のMACアドレスとメールアドレスを input/newphones.csv ファイル。これは、パートナー管理者がホールセール通話で新しい電話をプロビジョニングする場合にのみ必要です。
6. BroadWorksコールセンターをCxEssentialsに変換するには、 input/cxessentials.csv ファイル。
7. 必要に応じて、UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS プロパティを有効にして、すべてのコール センターを CxEssentials に変換します。
8. 使用 input/locations.csv 管理者が顧客の所在地を場所ごとに移行できるようにする大規模なエンタープライズ移行をサポートするファイル
9. Cisco BroadWorks デバイス プロファイルで MAC アドレスが使用できない場合は、必要に応じて、SIP REGISTER メッセージの User-Agent ヘッダーからの MAC アドレスの使用を有効にします。「USE_MAC_ADDRESS_FROM_SIP_」の行のコメントを解除します。 REGISTER=yes" ファイル内 conf/partner.cfg
10. ネットワーク サーバー同期機能を使用すると、管理者は、同じリージョンの移行時に、電話番号、MAC アドレス、およびユーザーの電子メール アドレスをプロビジョニングできます。有効にするには、[ conf/partner.cfgに USE_NS_SYNC=yes を設定します。

    NS 同期が無効になっている場合、電話番号とデバイスのプロビジョニングはスキップされ、ユーザーは一時的な電子メール アドレスを取得します。

11. オプションで、ANALOG_USER_TYPE_ENABLE_CALL_WAITING、ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD、および ANALOG_USER_TYPE_DISABLE_T38 のプロパティを有効にして、すべてのアナログ タイプのユーザーに対して通話待機、保留音、および T38 設定の無効化を構成します。

満杯にする input/customers.csv

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

以下の表は、 input/customers.csv.

満杯にする input/users.csv

ファイル input/users.csv Cisco BroadWorks または BroadCloud に不足している可能性のあるデータを提供します。必須情報がすべてすでに存在する場合は、このファイルを空のままにしておくことができます。すべての列に入力する必要はありません。不足している情報のみが必須です。

実行手順

任意のオペレーティング システムで変換ツールを実行します。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
   python3 -m pip install phonenumbers
   

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

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

Customer/user 事前チェック

変換ツールは、Webex への API 呼び出しを行って、潜在的なプロビジョニングの問題を検出します。デフォルトでは、顧客の住所とプライマリメールが検証されます。PROVISIONING_ID値が conf/partner.cfg ファイルでは、位置情報も検証されます。事前チェックの結果は例外レポートに含まれます。

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

事前チェック

変換ツールは、顧客情報の事前チェック API を実行するだけでなく、購読者の電子メールの事前チェック API も実行します。

事前チェック情報

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

端末ログ

変換が成功すると、ターミナルに次のログが記録されます。

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

例外レポート

変換ツールは 、出力/<timestamp>内に例外レポートを生成します。 /exception_report.txt ディレクトリ。このレポートを使用すると、移行に影響する問題を特定し、Cisco BroadWorks システムで修正できます。

例外を解決するためにユーザーデータを変更した後、新しいデータを使用して抽出および変換ツールを再実行します。サンプル例外レポート ファイルは次のとおりです。

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

出力

出力JSON（customer.json）ファイルは output/<timestamp>で利用可能になります。 /<groupid> ディレクトリ。サンプルの customer.json ファイルは次のとおりです。

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "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_York",
                    "language": "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+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@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_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": "DEFAULT",
                                "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": "DEFAULT",
                                "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": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "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": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

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

前提条件

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

1. コンピューターに Java 8、11、17、または 21 をインストールします。Java は、以下を含むさまざまなソースから入手できます。
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. 移行ツールのバイナリをダウンロードして解凍した後、MAC の場合は provisioning_tool.sh、Windows の場合は provisioning_tool.bat で JAVA_HOME 環境変数を設定します。
3. partner.cfg ファイル:
   • WHOLESALE_PROVISIONING_IDとREFRESH_TOKEN（トークンジェネレーターツールからコピーされたトークン）を設定します。パートナー管理者は、アカウント チームに連絡して PROVISIONING_ID を取得する必要があります。

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

4. Webex for BroadWorks 移行の WEBEX4BWKS_EMAIL_SUBJECT プロパティを使用して、Webex for BroadWorks 加入者にパスワード変更要求のメール件名を送信します。
5. Webex for BroadWorks 移行の WEBEX4BWKS_EMAIL_BODY プロパティを使用して、Webex for BroadWorks 加入者にパスワード変更要求のメール本文を送信します。
6. ネットワーク サーバー同期機能を使用すると、管理者は、同じリージョンの移行時に、電話番号、MAC アドレス、およびユーザーの電子メール アドレスをプロビジョニングできます。有効にするには、[ conf/partner.cfgに USE_NS_SYNC=yes を設定します。

   NS 同期が無効になっている場合、電話番号とデバイスのプロビジョニングはスキップされ、ユーザーは一時的な電子メール アドレスを取得します。

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

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

BroadCloud の別のリージョンへの移行の場合:

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

実行手順

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

Windows

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

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

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

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

BroadWorks 移行のための Webex の前提条件

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

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

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

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

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

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

端末ログ

プロビジョニングが成功した場合のターミナルのログは次のとおりです。

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : 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
 
********** Completed File : input/customer.json ****************

各実行ごとに作成された場所の数を示す表が印刷されます。

出力

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

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

図 8: Partner Hub

図 9: Control Hub

図 10: デバイス

図 11: 通話

ブロードクラウドの場合

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

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

ネットワーク サーバー同期機能を使用すると、管理者は [ conf/partner.cfgで USE_NS_SYNC=yes を設定することで broadCloud の場所を非アクティブ化し、Webex Calling の場所をアクティブ化することができます。移行後、デバイスと電話番号は Webex Calling の場所でアクティブ化されます。

管理者は、 conf/partner.cfg ファイルで ROLLBACK_TO_BROADCLOUD=true を設定することで自動ロールバックを有効にでき、移行後にデバイスを BroadCloud に戻します。NS Sync では、同じリージョンと異なるリージョンの両方の移行をサポートしますが、移行が成功した場合のみサポートされます。失敗した場合、管理者はロールバックを要求する前に Cisco TAC に連絡する必要があります。

ポータルで移行タイプを選択するには、次の 2 つのオプションがあります。

• 移行 – 番号、デバイス、および共有コールアピアランス (SCA) の移行リクエストを開始するには、このオプションを選択します。
• デバイス ステータス – BroadCloud および Calling 上のデバイスの現在のステータスを表示するには、このオプションを選択します。

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

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

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

選択した場所を移行する (オプション)

customer.json ファイルにリストされている場所の特定のサブセットの移行を開始するには、リクエストに locations.csv ファイルを含めます。この CSV には、移行する予定の場所のみがリストされる必要があります。

利用可能なアクティブサイトのリストをダウンロードするには、 顧客の表示 → 顧客の選択 → 場所を CSV としてエクスポートに移動します。

図 14: 場所をCSVとしてエクスポート

Cisco BroadWorksおよびWebex for BroadWorksの場合

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

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

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

SCP と SSH

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

前提条件

1. REFRESH_TOKEN（トークン生成ツールからコピーされたトークン）を conf/partner.cfg ファイル：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

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

4. 確認する JDK/JRE devicemove.sh の環境パスが正しい

   JAVA_HOME=/usr/local/java/java_base

5. 管理者は、入力ディレクトリの locations.csv ファイルを使用して、企業内のすべてのグループではなく、特定のグループを移行できます。

ポリコム電話

Polycom電話機をCisco BroadWorksからWholesale Callingに移行するには、パートナー管理者が新しい Identity/Device Cisco BroadWorks 各 Polycom デバイス テンプレートのシステム レベルのプロファイル タイプ ファイル。図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. グループ レベルまたはデバイス レベルでデバイス プロファイルを再構築します。
   グループレベルまたはデバイスレベルでの動作は、ファイル内のパラメータdeviceLevelRebuildの設定によって異なります。 device-move-tool/conf/partner.cfg.
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 電話は [ https://plcm.sipflash.com から %BWMACADDRESS%.cfg をダウンロードし、Webex Calling DMS によって管理されます。

図 14: Identity/device プロファイルタイプファイルの追加

実行手順

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

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

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

端末ログ

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

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 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 |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

出力

デバイスの移行後、デバイスはオンラインになり、 make/receive 通話します。デバイスのステータスの例については、図 15 を参照してください。

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

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

図 16: アクティブな番号

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

BroadCloudキャリア向け

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

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

Cisco BroadWorksおよびWebex for BroadWorksの場合

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

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

端末ログ

元に戻す操作のためにデバイス移動ツールを正常に実行すると、ターミナルに次のログが表示されます。

プロフィールを元に戻す

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 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 |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

数字を元に戻す

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully