コメントありがとうございます。

サポートされている電話は、Webex Callingプロビジョニングツールによって自動的に作成され 、ユーザーに割り当てられます。 「デバイス移動ツールでサポートされています」欄に「はい」と記載されている電話も、 デバイス移動ツールを実行すると、Cisco Webex Calling BroadWorksまたはBroadCloudからに自動的に移動されます。 その列に「いいえ」と記されている電話では、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

ダウンロードしたら、移行ツールのバイナリを抽出してください。

実行手順

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

ウィンドウズ:

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を使用して一般設定を構成します。

CLIで次のコマンドを実行して、一般設定ディレクトリに変更してください。

AS_CLI> cd /Applications/OpenClientServer/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が展開されていない、 またはまだ起動していない場合は、次のコマンドを使用してセカンダリアプリケーションサーバーに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. 抽出されたデータファイルを、 リクエスト送信日から最大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. [送信] をクリックして、 現在のサービスプロバイダのすべてのお客様とその所在地を対象に抽出リクエストを開始します。

シスコ・ブロードワークスの場合は、Webexの場合はブロードワークスです

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

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

前提条件

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

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

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

   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からブロードワークスへの移行に必須です。

5. Cisco BroadWorks アプリケーションサーバ JDK/JRE のセカンダリ環境パスがファイルと異なる場合は、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_.zip<timestamp>) ファイルは、同じ抽出ツールディレクトリにあります。 次のコマンドを使用して、 トランスフォームツールの入力用の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_プロキシ_HOST の値を次のように設定します。

   HTTPS_PROXY_HOST=<proxy-host>

4. HTTPS_PROXY_PORT変数を見つけてコメントを解除します（先頭の＃を削除してください）。
5. HTTPS_プロキシ_PORTの値を次のように設定します。

   HTTPS_PROXY_PORT=<proxy-port>

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

   ./export.sh

エンゲージメントフォーム：

抽出ツール（BroadCloudとBroadWorks）は、実行中にエンゲージメントフォーム SUA.xlsx というタイトルの統合XLSXファイルを自動的に生成するようになりました。 このファイルには、関連するワークシートで入手可能なすべてのデータが事前に入力されているため、 パートナーとの取引を効率的かつ迅速に完了できます。

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

前提条件

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

1. conf/partner.cfg ファイルに REFRESH_TOKEN（トークンジェネレーターツールからコピーしたトークン） とNAME_OF_MAIN_LOCATIONを設定します。

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. オプションで、conf/partner.cfg ファイルに PROVISIONING_ID（パートナーハブのテンプレートからコピー）を設定します。

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   顧客のメールアドレスをより完全に確認するには、オプションでPROVISIONING_IDを設定できます。
3. 不足している情報がある場合は、input/customers.csv ファイル（次のセクションを参照）に設定してください。
4. input/users.csv ファイルにエンドユーザーのメールアドレスを追加します。
5. 新しい電話を用意する場合は、 ユーザーの新しい電話のMACアドレスとメールアドレスを input/newphones.csv ファイルに追加してください。 これは、 パートナー管理者がホールセール通話で新しい電話をプロビジョニングする場合にのみ必要です。
6. input/cxessentials.csv ファイルを使用して、ブロードワークスのコールセンターを xEssentials に変換してください。
7. オプションで、UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALSプロパティを有効にして、すべてのコールセンターをエッセンシャルに変換します。
8. input/locations.csv ファイルを使用して、 管理者が顧客の拠点を場所ごとに移行できる大規模企業の移行をサポートしてください
9. オプションで、 CiscoBroadWorksデバイスプロファイルでMACアドレスが使用できない場合は、SIP REGISTERメッセージのユーザーエージェントヘッダーからMACアドレスを使用できるようにしてください。 conf/partner.cfg ファイルの USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes という行のコメントを解除してください
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 ファイルに追加してください。 また、 ユーザーがプライマリーオーナーなのか共有ユーザーなのか（共有通話の場合）も記載してください。 これは、 パートナー管理者がWholesale Callingで汎用ゲートウェイデバイスを使用する予定がある場合にのみ必要です。

    この機能は、 BroadCloudからWholesaleへの移行では使用できません。

12. ブロードクラウドへの移行では、メッセージングステーションタイプのすべてのユーザーをvoice_mail_groupに変換するには、 リアルトステーションタイプがメッセージングしている行のWholesale Packageの値を voice_mail_groupに置き換えて 、 conf/rialto_station_type_to_wholesale_package.csv ファイルを更新してください。

    オプションで、partner.cfg の COMMON_VOICE_MAIL_GROUP_PASSCODE プロパティを有効にして、ボイスメールグループのデフォルトPINを設定してください。

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

13. 一般的な連絡先をに移行するには Webex Calling

    これは、企業レベルとサイトレベルの共通の連絡先を管理するための拡張機能です。 これらの連絡先は、構成設定に基づいて、組織の連絡先（ 組織の連絡先）または仮想内線番号として移行できるようになりました。 以下は、この移行プロセスのガイドとなる詳細です。

    キー構成:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGEという新しいプロパティが partner.cfg ファイルに導入されました。 このプロパティは、 一般的な連絡先をリアルトからに移行する方法を決定します。Webex Calling

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_EXTENSION_START_RANGE を設定せずに

      一般的な連絡先は、 組織の連絡先（組織の連絡先）として移行されます。

      追加の設定は必要ありません。

      連絡先には組織レベルで引き続きアクセスできます。

    • 共通の電話リストと仮想内線番号の開始範囲が設定されている場合

      一般的な連絡先は仮想内線番号として移行されます。

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

      仮想拡張は、連絡先の範囲に応じて、 組織レベルと場所レベルの両方でサポートされています。

14. デフォルトの通話録音ベンダーをWebexに有効にします。

    このステップは、 Dubberで構成されたユーザーの通話録音設定を、 WebexのCiscoネイティブ通話録音に移行する場合にのみ必要です。

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

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

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

15. 選択した電話番号を移行から除外します：

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

    • 最初に変換ツールを初めて実行します。 完了すると、ツールは output/timestamp/ ディレクトリ内に telephone_numbers_inventory.csv という名前のファイルを生成します。 お客様はこのファイルを確認し、 今後の移行から除外すべき各電話番号の「Drop Tn's」列に「はい」と答える必要があります。
    • 適切な除外フラグで telephone_numbers_inventory.csv ファイルを更新した後、 変換ツールがもう一度実行されます。 更新されたファイルは、 次の形式で引数として渡す必要があります。

      。/transform.sh -extract=input/extracted_data_1747640608219.zip-廃止番号= {filepath/telephone_numbers_inventory.csv}

16. オプションで、ALLOW_RESTRICT_BY_PARTNER_MODEプロパティをOFFに設定して、 顧客管理者がコントロールハブでパートナー定義の設定を変更できるようにします。
17. ブロードクラウドからに携帯電話番号（BroadWorks Mobility）を移行する場合 Webex Calling

    このセクションでは、BroadWorks Mobility（お客様の携帯電話番号）機能を BroadCloud（モバイルネットワーク統合）からWholesale Webex Calling（Webex Go モバイルネットワークオペレーター）に移行する方法について説明します。

    前提条件- 移行プロセスを開始する前に、 パートナー管理者はCiscoアカウントチームに連絡して、Cloud Connected PSTN（CCP）ベンダーとカスタムキャリアリスト（CCL）の設定を行う必要があります。

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

    • この機能は、 ブロードクラウドからホールセールへの移行でのみサポートされています。
    • Wholesale Webexでは、BroadCloudとは異なり、 エンドユーザーは携帯電話番号またはPSTN番号（両方ではない）のいずれかを持つことができます。
    • 携帯電話番号がユーザーに割り当てられると、 そのユーザーのプライマリPSTN番号がセカンダリ（代替）番号になります。
    • ワークスペースまたは仮想回線に変換中のユーザーの携帯電話番号は移行できません。
    • Wholesale Webexで携帯電話番号が割り当てられると、 コントロールハブではアクティブと表示されます。 このステータスは、 その番号がすぐに電話を受ける準備ができているという意味ではありません。 通話機能は、 移行が完全に完了した後にのみ利用可能になります。
    • コーリング・ユーザー・ポータル（CUP） でエンドユーザーが設定した携帯電話の統合設定は移行されません。 移行後、電話番号、携帯電話番号、 または内線に電話をかけると、ユーザーのすべてのデバイスが鳴ります。

18. お客様の移行中にオプションでパッケージの数量制限を設定するには、input/package_quantity.csv ファイルに各パッケージの数量を指定します。 設定するパッケージの数量は、 ユーザー/ワークスペースに割り当てられたパッケージの数以上でなければなりません。

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

    変換ツールを実行するときは、 更新されたファイルを入力パラメータとして指定します。<extract_zip_file>/transform.sh-extract= -パッケージ制限=入力/パッケージ_数量.csv。

19. Broadworks/Broadcloudの複数の顧客のサイトを、卸売業の単一の顧客に移行します Webex Calling
    • トランスフォームツールに新しいランタイムモードであるConsolidatedMigrationが導入されました。これは、 単一の卸売顧客組織の下で複数の顧客サイトをBroadcloud/BroadworksからWebex Wholesaleプラットフォームに移行できるようにするためのものです。 このモードを有効にすると、 ツールは複数の顧客サイトを1つの卸売顧客組織に統合します

      -consolidatedMigration

    • -ConsolidatedMigrationと一緒に指定できるオプション引数は他にもあります。

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

    • -targetEnterpriseIDが指定されていて、 そのIDが抽出ツールの出力ファイルに存在する場合、 それを使用して卸売顧客組織が作成され、IDが見つからない場合は、 ツールは抽出ツールの出力ファイルから入手可能な顧客の詳細をフォールバックして使用します。
    • -solidatedExternalIDが指定されている場合、顧客の外部IDが設定されます。指定されていない場合、ツールはフォールバックして外部IDに既存のフローを使用します。
    • <timestamp>統合されたJSON（customer.json）ファイルは、 出力/統合ディレクトリにあります。

input/customers.csv を記入しています

input/customers.csv ファイルには、 シスコ・ブロードワークスやブロードクラウドにはないかもしれないデータが含まれています。 必須情報がすべて揃っている場合は、このファイルを空のままにしておくことができます。 すべての列に記入する必要はありません。 欠落している情報だけが必須です。

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

input/users.csv を記入しています

input/users.csv ファイルには、 シスコ・ブロードワークスやブロードクラウドにはないかもしれないデータが含まれています。 必須情報がすべて揃っている場合は、このファイルを空のままにしておくことができます。 すべての列に記入する必要はありません。 欠落している情報だけが必須です。

実行手順

Transform Toolはどのオペレーティングシステムでも実行できます。 以下の手順を使用して、 WindowsとmacOSでツールを実行してください。

ウィンドウズ

以下のコマンドを実行して、Windowsでトランスフォームツールを実行します。

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

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

Transform Toolは、潜在的なプロビジョニングの問題を検出するためにWebexへのAPI呼び出しを行います。 デフォルトでは、お客様の住所とメインのEメールが検証されます。 PROVISIONING_IDの値が conf/partner.cfg ファイルに指定されている場合は、位置情報も検証されます。 事前チェックの結果は例外レポートに含まれます。

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

事前チェック

Transform Toolは、顧客情報の事前チェック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>変換ツールは、 output/ /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

出力

<timestamp><groupid>出力されるJSON（customer.json）ファイルは、 output/ ディレクトリにあります。 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 Public 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 
     

   • パートナーがユーザーにウェルカムメールを送信したくない場合は、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. 卸売割引を適用するには、 移行を開始する前にパートナー管理者がシスコアカウントチームに連絡する必要があります。

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

8. （オプション）PSTN接続を明示的に設定してください

   メインの場所を含め、移行中にプロビジョニングされるすべての場所の PSTN 接続を指定するには、partner.cfg ファイルに次のプロパティを追加します。

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   プロパティが設定されていないかコメントアウトされている場合、 プロビジョニングツールはデフォルトのPSTN接続選択プロセスを使用します。

実行手順

WindowsとmacOSでツールを実行するには、次の手順を実行してください。

ウィンドウズ

Windows OSでツールを実行するには、次の手順を実行してください。

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

macOSでツールを実行するには、次の手順を実行してください。

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

ブロードワークスへの移行のための Webex の前提条件

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

Webex for BroadWorks Onboardingテンプレートが移行をサポートするように更新されたら、Ciscoアカウントチームに、パートナーレベルで 「卸売-パートナーブレンディング対応」機能の切り替えを有効にするよう依頼してください。 この設定により 、プロビジョニングツールはプロビジョニング中に既存の Webex for BroadWorks のお客様に自動的に卸売パッケージを追加します。

引数を追加してプロビジョニングツールを実行してください。

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

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

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

ターミナルログ

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

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 ****************

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

出力

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

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

プロビジョニングツールはまた、 出力/solidated_reports/ディレクトリにProvisioning_Statistics_*.csvファイルを生成します。 このレポートには、顧客、場所、ユーザー、デバイス、 およびグループ機能のプロビジョニングに成功したものと失敗したものの数が含まれています。

パートナー管理者は、 パートナーハブとコントロールハブのポータルでカスタマープロビジョニングを確認できます。 パートナーハブとコントロールハブのポータルにある以下の図を参照してください。

図 8: パートナーハブ

図 9: コントロールハブ

図 10: デバイス

図 11: 通話

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

BroadCloudへの移行のためのプロビジョニングが完了すると、 次のアクションはブロックされます。

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

BroadCloudからホールセールへの移行 — デバイス登録の制限

同じ地域内のBroadCloudからWholesaleに顧客を移行するパートナー管理者の場合、プロビジョニングツールを実行した後にデバイスをWholesaleに追加できます。 ただし、 それらのデバイスは、 対応する場所の移行（デバイスの移動）が完了した後にのみ、Webex プラットフォームに登録できるようになります。

この制限は以下には適用されません。

• ブロードワークス/W4Bからホールセールに移行するお客様。
• さまざまな地域にわたるブロードクラウドから卸売への移行。

推奨ガイダンス

デバイス登録の問題を回避するには、 同じリージョンのBroadCloudからWholesaleへの移行のためにデバイスをWebexプラットフォームに登録する前に、ロケーションレベルのデバイス移動移行を完了してください。

ブロードクラウド用

BroadCloudパートナーの場合は、サービスプロバイダーポータルを使用して 、番号、デバイス、 共有コールアピアランス（SCA）の移行リクエストを送信してください。

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

管理者は conf/partner.cfg ファイルに rollback_to_Broadcloud=TRUE を設定することで自動ロールバックを有効にできます。これにより、移行後にデバイスがブロードクラウドに戻ります。 NS Syncでは、 同じ地域の移行と異なる地域の移行の両方をサポートしていますが、移行が成功した場合のみです。 失敗したものについては、Cisco TAC 管理者はロールバックをリクエストする前にaを上げる必要があります。

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

• 移行 — このオプションを選択すると、番号、 デバイス、共有コールアピアランス（SCA）の移行リクエストが開始されます。
• デバイスのステータス — このオプションを選択すると、 BroadCloudとCalling上のデバイスの現在の状態が表示されます。

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

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

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

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

customer.jsonファイルにリストされている特定の場所のサブセットへの移行を開始するには、リクエストに locations.csv ファイルを含めてください。 このCSVには、 移行する予定の場所だけを記載してください。

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

図 14: 場所を CSV 形式でエクスポートする

番号を切断するオプションを有効にしてください

Webex CallingとBroadCloud Carrierで同じSIPトランクを使用する場合、管理者は番号の切断オプションを使用する必要があります。 これにより、BroadCloudへの移行後、 着信から電話番号が削除されます。

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

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

番号の接続を解除できない場合は、Cisco TACにリクエストしてください。

シスコ・ブロードワークスの場合は、Webexの場合はブロードワークスです

シスコブロードワークスとWebex for BroadWorksの移行では、ツールはパートナーネットワーク内のセカンダリCisco BroadWorksアプリケーションサーバー上で動作し、OCI-Pを介してASに接続します。 トランスフォームツールの出力JSON（customer.json） ファイルを入力として使用し、OCI-Pコマンドを実行してデバイスとソフトクライアントを移行します。

正常に動作すると、デバイス移動ツールは次のことを行います。

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

6. 管理者が企業のプロキシの背後でツールを操作している場合は、 以下の手順に従ってプロビジョニングスクリプトを設定して実行してください。

   設定手順

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

   3. プロキシ_HOSTの値を次のように設定してください:

      PROXY_HOST=<proxy-host>

   4. PROXY_PORT変数を見つけてコメントを解除します（devicemove.sh の先頭の #を削除します）。

   5. プロキシ_PORTの値を次のように設定してください:

      PROXY_PORT=<proxy-port>

   6. PROXY_SCHEME変数を見つけてコメントを外してください（devicemove.sh の先頭の #を削除してください）。 このステップはオプションです。コメントを付けたままにしておくと、 PROXY_SCHEMEのデフォルト値はHTTPになります。

   7. プロキシスキームの値を次のように設定します。

      PROXY_SCHEME=<proxy-scheme>

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

   11. スクリプトを実行してください:

       ./devicemove.sh

SCP と SSH

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

前提条件

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

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

4. JDK/JRE環境パスが devicemove.sh で正しいことを確認してください

   JAVA_HOME=/usr/local/java/java_base

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

ポリコムの携帯電話

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

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

Polycom電話の移行プロセス：

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

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

実行手順

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

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

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -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

出力

デバイスの移行後、 デバイスはオンラインになり、電話をかけたり受けたりできるようになりました。 デバイスの状態の例を見るには図15を参照してください。

図 15: デバイスの状態

デバイスの移行後、 番号が有効になりました。 どの番号が使われているかの例を見るには、図16を参照してください。

図 16: アクティブな番号

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

devicemoveスクリプトを設定して実行する手順

1. devicemove.sh ファイルを開きます。
2. HTTPS_PROXY_HOST変数を見つけてコメントを解除します（先頭の＃を削除してください）。

3. HTTPS_プロキシ_HOST の値を次のように設定します。

   HTTPS_PROXY_HOST=<proxy-host>

4. HTTPS_PROXY_PORT変数を見つけてコメントを解除します（先頭の＃を削除してください）。
5. HTTPS_プロキシ_PORTの値を次のように設定します。

   HTTPS_PROXY_PORT=<proxy-port>

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

   ./devicemove.sh

元に戻す操作は、一度に1つの企業に対して実行する必要があります。

ブロードクラウドキャリア用

管理者は conf/partner.cfg で rollback_to_Broadcloud=TRUE を設定して、自動ロールバックを有効にすることができます。 これにより、NS Syncを使用して同じリージョンまたはクロスリージョンで正常に移行した後、デバイスはBroadCloudに戻ります。 移行に失敗した場合は、Cisco TACロールバックをリクエストする前に連絡してください。

シスコ・ブロードワークスの場合は、Webexの場合はブロードワークスです

シスコ・ブロードワークスとWebex for BroadWorksの復帰プロセスは次のとおりです。

1. でチケットを開いて、Cisco TACデバイスの復帰をリクエストしてください。
2. デバイスの移行を元に戻すには、 セカンダリBroadWorksアプリケーションサーバーでデバイス移動ツールをリバートモードで実行してください。 これにより、DMS URLがCisco BroadWorksのデバイスプロファイルのサービスプロバイダーのDMS URLに戻り、電話番号が再び有効になります。
3. Webex Callingチームは、DMS URLを、 のデバイスプロファイルのサービスプロバイダーのDMS URLに戻します。Webex Calling
4. パートナー管理者は、Control Webex Calling Hubポータルからにある電話番号を無効にするか削除する必要があります。
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

ターミナルログ

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

プロファイルを元に戻す

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