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

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

パートナー管理者は、移行ツールを実行する前に、このトークン生成ユーティリティツールを少なくとも1回実行する必要があります。このツールを実行するのは、パートナーアカウントが卸売RTMソリューションに登録された後に一度だけ行う作業です。このツールを使用すると、パートナー管理者は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

端末のウェブブラウザでURLを開き、パートナー管理者の認証情報を使用してログインし、トークンを取得してコピーし、以降の利用に使用してください。

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

図 3: Cisco Webexでログイン

図 4: 認証情報ウィンドウ

図 5: トークン生成

セカンダリーBroadWorksサーバーで抽出ツールとデバイス移動ツールを実行する前に、以下の手順を設定してください。

OCI-P接続を有効にする

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

ステップ 1: 一般設定を構成するには、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> 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がデプロイされていない、または起動していない場合は、以下のコマンドを使用してデプロイおよび起動してください。

ステップ 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向け

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

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

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

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

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

CSV抽出リクエスト

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

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

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

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

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

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

   編集後、修正したCSVファイルをアップロードしてください。

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

顧客の所在地CSVデータに対する抽出リクエストを開始する

1. 顧客とダウンロード場所を選択してください

   ドロップダウンメニューから顧客を選択してください。

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

2. ロケーションファイルを編集する

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

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

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

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

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

1. 送信 をクリックすると、現在のサービスプロバイダーの すべての顧客 およびそのすべての拠点 に関する抽出リクエストが開始されます。

Cisco BroadWorksおよびWebex for BroadWorks向け

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

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

前提条件

1. SCPを使用して抽出ツールのバイナリをセカンダリCisco BroadWorksアプリケーションサーバーに転送します。
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 Application Server のセカンダリユーザー 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.
   

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

5. 変更する JDK/JRE セカンダリ Cisco BroadWorks Application Server の場合、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

管理者が企業プロキシの背後でツールを操作している場合は、以下の手順に従ってエクスポートスクリプトを設定および実行してください。

エクスポートスクリプトの設定と実行の手順

1. export.shファイルを開きます。
2. HTTPS_PROXY_HOST 変数を見つけてコメントを解除します（先頭の文字を削除します）。 #).

3. HTTPS_PROXY_HOST の値を次のように設定します。

   HTTPS_PROXY_HOST=

4. HTTPS_PROXY_PORT 変数を見つけてコメントを解除します（先頭の文字を削除します）。 #).
5. HTTPS_PROXY_PORT の値を次のように設定します。

   HTTPS_PROXY_PORT=

6. export.shファイルを保存して閉じます。
7. partner.cfg ファイルを開き、必要な refresh_tokenを追加します。
8. partner.cfgファイル内で、BroadWorksのホスト名、ユーザー名、パスワードが正しく設定されていることを確認してください。
9. スクリプトを実行します。

   ./export.sh

契約申込書：

抽出ツール（BroadCloudおよびBroadWorks）は、実行時に 「 Engagement Form SUA.xlsx 」という名前の統合XLSXファイルを自動的に生成するようになりました。ファイルには関連するワークシート全体にわたる利用可能なデータがあらかじめ入力されているため、パートナーの作業効率化と迅速化に役立ちます。

この変換ツールは、すべての移行に対して実行されます。この変換ツールは、パートナーの管理者用ノートパソコンを含むあらゆるコンピューターで動作し、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. 必要に応じて、プロビジョニング_ID (Partner Hub のテンプレートからコピーしたもの) を次の場所に設定します。 conf/partner.cfg ファイル：

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   顧客のメールアドレスをより完全に検証するために、オプションでプロビジョニング_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. オプションで、ANALOG_USER_TYPE_ENABLE_CALL_WAITING、ANALOG_USER_TYPE [] ENABLE__MUSIC_ON_HOLD、およびANALOG_USER_TYPE_DISABLE_T38 のプロパティを有効にすると、すべてのアナログタイプのユーザーに対して、通話待機、保留音、および T38 無効化の設定を構成できます。

11. 汎用ゲートウェイ デバイスを設定する場合は、デバイスの MAC アドレスとユーザー ID を input/genericgateways.csv ファイル。また、そのユーザーがプライマリーオーナーなのか、共有ユーザーなのか（共有通話表示の場合）も明記してください。これは、パートナー管理者がホールセール通話で汎用ゲートウェイデバイスを使用する予定がある場合にのみ必要です。

    この機能は、BroadCloudからWholesaleへの移行ではご利用いただけません。

12. BroadCloud の移行の場合、メッセージング ステーション タイプが [] であるすべてのユーザーを voice_mail_groupに変換するには、 conf/rialto_station_type_to_wholesale_package.csv ファイルを更新し、 Rialto Station Type がメッセージを配信している行の Wholesale Package の値を voice_mail_group に置き換えます。

    必要に応じて、partner.cfg の COMMON_VOICE_MAIL_GROUP_PASSCODE プロパティを有効にして、ボイスメール グループのデフォルトの PIN を設定します。

    このプロパティが partner.cfgで指定されていない場合は、顧客ごとにcustomers.csvファイルのcommonVoicemailGroupPassCode列に指定する必要があります。

13. 共通連絡先をWebex Callingに移行する場合

    これは、企業レベルおよびサイトレベルの共通連絡先を管理するための機能強化です。これらの連絡先は、構成設定に基づいて、組織連絡先（Org Contacts）または仮想内線として移行できるようになりました。以下に、この移行プロセスを円滑に進めるための詳細情報を示します。

    キー設定:

    • 共通_電話_リスト__]宛先仮想_内線_開始_範囲

      partner.cfg ファイルに新しいプロパティ COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGEが導入されました。このプロパティは、RialtoからWebex Callingへ共通の連絡先を移行する方法を決定します。

    • _共通_電話_リストなし_仮想_内線_番号開始_範囲設定済み

      共通の連絡先は、組織の連絡先（組織連絡先）として移行されます。

      追加の設定は不要です。

      組織レベルでは、連絡先へのアクセスは引き続き可能です。

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE が設定されています

      共通の連絡先は仮想内線として移行されます。

      各連絡先には内線番号が追加され、内線番号の開始範囲は partner.cfg の COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE プロパティで定義されます。

      仮想内線は、契約の範囲に応じて、組織レベルと場所レベルの両方でサポートされます。

14. 通話録音のデフォルトベンダーをWebexに設定する。

    この手順は、Webex で Dubber で設定されているユーザーの通話録音設定を Cisco Native Call Recording に移行する場合にのみ必要です。

    このオプションを有効にするには:

    • partner.cfg ファイルで、次のプロパティ DEFAULT_CALL_RECORDING_VENDOR=Webexを設定します。
    • さらに、プロパティ WEBEX_CALL_RECORDING_STORAGE_REGION を使用してストレージ領域を設定します。

      BroadCloud の オンデマンド 録画オプションは Webex Calling ではサポートされていません。これらの通話録音設定は移行されず、例外レポートに表示されます。

15. 移行対象から除外する電話番号：

    移行プロセスから特定の電話番号を除外するには、変換ツールを使用して以下の2段階の手順に従う必要があります。

    • 最初に変換ツールを実行します。完了すると、ツールは telephone_numbers_inventory.csv という名前のファイルを生成します。 output/timestamp/ ディレクトリ。お客様は、このファイルを確認し、今後の移行から除外する各電話番号について、「削除する電話番号」欄に「はい」と記入する必要があります。
    • 適切な除外フラグを使用して telephone_numbers_inventory.csv ファイルを更新した後、変換ツールが 2 回実行されます。更新されたファイルは、以下の形式で引数として渡す必要があります。

      ./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}

16. 必要に応じて、[ALLOW_RESTRICT_BY_PARTNER_MODE] プロパティを OFF に設定すると、顧客管理者が Control Hub でパートナー定義の設定を変更できるようになります。
17. BroadCloudからWebex Callingへの携帯電話番号（BroadWorks Mobility）の移行について

    このセクションでは 、 BroadWorks Mobility(顧客の携帯電話番号) 機能を BroadCloud (モバイルネットワーク統合) から Wholesale Webex Calling (Webex Go モバイルネットワークオペレーター) に移行する手順の概要を説明します。

    前提条件- 移行プロセスを開始する前に、パートナー管理者は、Cisco アカウント チームに連絡して、クラウド接続 PSTN (CCP) ベンダーとカスタムキャリアリスト (CCL) の構成を行う必要があります。

    partner.cfg ファイルに新しいプロパティ ASSIGN_MOBILE_NUMBERS_TO_USERSが追加されます。このプロパティを有効にすると、携帯電話番号をユーザーに割り当てたり、移行したりできるようになります。

    • この機能は、 BroadCloudから Wholesaleへの移行でのみサポートされています。
    • BroadCloudとは異なり、Wholesale Webexでは、エンドユーザーは携帯電話番号かPSTN番号のどちらか一方しか持つことができません（両方を持つことはできません）。
    • ユーザーに携帯電話番号が割り当てられると、そのユーザーの主要なPSTN番号は、二次（代替）番号になります。
    • ワークスペースまたは仮想回線に移行するユーザーの場合、携帯電話番号は移行できません。
    • 卸売Webexで携帯電話番号が割り当てられると、コントロールハブで「アクティブ」と表示されます。このステータスは、その番号がすぐに電話を受けられる状態であることを意味するものではありません。通話機能は、移行が完全に完了した後にのみ利用可能になります。
    • エンドユーザーが通話ユーザーポータル（CUP）で設定した携帯電話連携設定は移行されません。移行後、電話番号、携帯電話番号、または内線番号に電話がかかると、ユーザーのすべてのデバイスが鳴ります。

18. 顧客移行中にパッケージ数量制限を任意で設定するには、入力package_quantity/[].csvファイルで各パッケージの数量を指定します。設定されたパッケージ数量は、 user/workspace 割り当てられたパッケージ。

    Webex for BroadWorksからWholesaleへの移行では、パッケージ数量制限は現在サポートされていません。

    変換ツールを実行する際は、更新されたファイルを入力パラメータとして指定してください。 ./transform.sh -extract=<extract_zip_file> -packagelimits=input/package_quantity.csv。

19. 複数の顧客からサイトを移行します BroadWorks/BroadCloud 卸売Webex通話で単一顧客へ
    • Transform ツールに新しいランタイム モード -consolidatedMigration が導入され、複数の顧客サイトを移行できるようになりました。 Broadcloud/Broadworks 単一の卸売顧客組織の下で、Webex卸売プラットフォームに移行します。このモードを有効にすると、ツールは複数の顧客サイトを1つの卸売顧客組織に統合します。

      -consolidatedMigration

    • -consolidatedMigration と一緒に指定できるその他のオプション引数には、次のようなものがあります。

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • -targetEnterpriseId が指定され、その ID が抽出ツールの出力ファイルに存在する場合、その ID を使用して卸売顧客組織が作成されます。ID が見つからない場合は、ツールは抽出ツールの出力ファイルから利用可能な顧客の詳細を使用するようにフォールバックします。
    • -consolidatedExternalId が指定されている場合は、顧客の externalId が設定され、指定されていない場合は、ツールは既存のフローを使用して外部 ID を設定します。

満杯にする 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 事前チェック

Transform Toolは、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（トークン生成ツールからコピーしたトークン）を設定します。パートナー管理者は、_プロビジョニングIDを取得するためにアカウントチームに連絡する必要があります。

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

     Webexはエンドユーザーにのみウェルカムメールを送信します。顧客管理者にはウェルカムメールは送信されません。

     米国およびカナダに拠点を置くユーザーと顧客管理者には、RedSkyから別途メール通知が送信されます。RedSky E911プラットフォームは、緊急サービス用の顧客アカウントが作成されたことを確認するために、このメールを送信します。このRedSkyからのメールは、Webexのウェルカムメールとは別個のものであり、Webexのメール設定では制御されません。米国およびカナダの卸売業者の場合、RedSkyは緊急サービスプロバイダーとして自動的に有効化されます。

4. Webex for BroadWorks の移行時に、WEBEX4BWKS_EMAIL_SUBJECT プロパティを使用して、Webex for BroadWorks 加入者に対してパスワード変更リクエストのメール件名を送信します。
5. Webex for BroadWorks の移行では、WEBEX4BWKS_EMAIL_BODY プロパティを使用して、Webex for BroadWorks 加入者に対してパスワード変更要求メールの本文を送信します。
6. 顧客作成後にタグを追加するには、 CUSTOM_TAGS プロパティを使用します。
7. 卸売割引を適用するには、パートナー管理者は移行を開始する前にシスコのアカウントチームに連絡する必要があります。

   partner.cfg に新しいプロパティ APPLY_WHOLESALE_DISCOUNTS が追加されます。このプロパティを有効にすると、ユーザーとワークスペースに割引が適用されます。

実行手順

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=

Webex for BroadWorks移行の前提条件

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

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

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

準備段階： これはデフォルトのフェーズであり、管理者は BroadWorks ユーザーを卸売サブスクライバーとしてプロビジョニングし、Webex for BroadWorks ユーザーを継続して使用できます。

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

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

ターミナルログ

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

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

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

出力

プロビジョニングツールは 、 output/<external_id>内に成功およびエラーレポートを生成します。 /*.success/error ファイル。出力の成功ログとエラーログを確認して、プロビジョニングが正常に完了したことを確認してください。

システムは output/consolidated_reports/ ディレクトリに Provisioning_Report_*.csv ファイルを生成します。このファイルには、各エンティティとその設定に関する成功と失敗の両方の詳細が含まれており、包括的なプロビジョニングレポートを提供します。

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

図 8: Partner Hub

図 9: Control Hub

図 10: デバイス

図 11: 通話

プロビジョニング後の制限

BroadCloud移行のプロビジョニングが完了すると、以下の操作は ブロックされます。 :

• CAPポータル – ユーザーまたは移植されたデバイスの追加。
• SP ポータル – デバイスまたは番号を使用して追加注文を作成します。
• RSB API – デバイスまたは番号を使用してADD注文を作成し、ユーザーを作成します。デバイスまたは番号を使用して行われたRSB ADD注文は拒否されます。

BroadCloud向け

BroadCloudパートナーの方は、サービスプロバイダーポータルを使用して、番号、デバイス、および共有通話表示（SCA）の移行リクエストを送信してください。

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

管理者は、 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形式でエクスポート

切断番号オプションを有効にする

Webex CallingとBroadCloud Carrierで同じSIPトランクを使用する場合は、管理者は Disconnect Numbers オプションを使用する必要があります。これは、BroadCloudへの移行後、電話番号が着信を受け取れないようにするものです。

このオプションを有効にするには、

1. partner.cfg ファイルで、DISCONNECT_NUMBERS_FROM_RIALTO を設定します。 = はい。
2. 同じ customer.jsonファイルと更新されたpartner.cfg ファイルを使用して、移行ツールを再実行します。

番号が切断されない場合は、Cisco TAC にリクエストを送信してください。

Cisco BroadWorksおよびWebex for BroadWorks向け

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. 卸売部門で番号を有効化してください。
5. BroadCloudへの移行のために、ホールセールで共有通話表示を作成します。[This この手順はBroadCloudにのみ適用されます migrations].

SCPとSSH

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

前提条件

1. REFRESH_TOKEN (トークン生成ツールからコピーしたトークン) を conf/partner.cfg ファイル：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Cisco BroadWorks Application Server のセカンダリユーザー ID、パスワード、ホスト名が正しいことを確認してください。 conf/deviceMoveTool.conf ファイル：

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

   管理者が移行中にユーザーに招待メールを送信したい場合は、「SEND_SUBSCRIBERS_WELCOME_」のコメントを解除する必要があります。 EMAIL=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: アクティブな数字

管理者が企業プロキシの背後でツールを操作している場合は、以下の手順に従ってdevicemoveスクリプトを設定および実行してください。

devicemoveスクリプトの設定と実行の手順

1. devicemove.sh ファイルを開きます。
2. HTTPS_PROXY_HOST 変数を見つけてコメントを解除します（先頭の文字を削除します）。 #).

3. HTTPS_PROXY_HOST の値を次のように設定します。

   HTTPS_PROXY_HOST=

4. HTTPS_PROXY_PORT 変数を見つけてコメントを解除します（先頭の文字を削除します）。 #).
5. HTTPS_PROXY_PORT の値を次のように設定します。

   HTTPS_PROXY_PORT=

6. devicemove.sh ファイルを保存して閉じます。
7. partner.cfg ファイルを開き、必要な refresh_tokenを追加します。
8. partner.cfgファイル内で、BroadWorksのホスト名、ユーザー名、パスワードが正しく設定されていることを確認してください。
9. スクリプトを実行します。

   ./devicemove.sh

ロールバック操作は、一度に1つの企業に対してのみ実行する必要があります。

BroadCloudキャリア向け

管理者は、 ROLLBACK_TO_BROADCLOUD=true 内に conf/partner.cfg を設定することで、自動ロールバックを有効にできます。これは、NS Syncを使用して同一リージョンまたは異なるリージョン間での移行が正常に完了した後、デバイスをBroadCloudに戻します。移行が失敗した場合は、ロールバックを要求する前にCisco TACに連絡してください。

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. パートナー管理者は、コントロールハブポータルを通じて、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