Les téléphones pris en charge seront automatiquement créés et attribués aux utilisateurs dans Webex Calling par l'outil de provisionnement. Les téléphones marqués « oui » dans la colonne « Pris en charge dans l’outil de déplacement d’appareil » seront également automatiquement déplacés de Cisco BroadWorks ou BroadCloud vers Webex Calling lorsque l’outil de déplacement d’appareil est exécuté. Les téléphones marqués « Non » dans cette colonne nécessitent une intervention manuelle pour modifier l’URL DMS dans le modèle de périphérique Cisco BroadWorks ou dans le téléphone lui-même.

La dernière colonne fournit le mappage des modèles de téléphone à la colonne « Type d'appareil » du fichier transform-tool/input/newphones.csv. (Voir la section Outil de transformation de cet article pour plus d'informations sur newphones.csv).

Les administrateurs partenaires exécutent cet outil utilitaire de génération de jetons au moins une fois avant de commencer à exécuter les outils de migration. L'exécution de cet outil est une activité ponctuelle après l'intégration du compte partenaire dans la solution Wholesale RTM. Cet outil permet aux administrateurs partenaires de se connecter via un navigateur Web pour obtenir le TOKEN unique nécessaire à la mise à jour des fichiers de configuration partenaires pour les outils de migration.

Prérequis

Installez Java 8, 11, 17 ou 21 sur l’ordinateur. Java est disponible à partir de nombreuses sources, notamment :

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

Après le téléchargement, extrayez les binaires de l'outil de migration.

Instructions pour exécuter

Exécutez la commande suivante dans le terminal à l’intérieur du répertoire du générateur de jetons :

Windows :

token_generator.bat

macOS :

./token_generator.sh

Sortir:

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

Ouvrez l'URL dans le navigateur Web sur le terminal, connectez-vous avec les informations d'identification de l'administrateur partenaire pour obtenir le TOKEN et copiez-le pour une utilisation ultérieure.

Les illustrations de l'interface utilisateur sont données ci-dessous à titre de référence :

Figure 3 : Connectez-vous avec Cisco Webex

Figure 4 : Fenêtre d'informations d'identification

Figure 5 : Génération de jetons

Configurez les étapes suivantes avant d’exécuter les outils d’extraction et de déplacement de périphérique sur le serveur BroadWorks secondaire.

Activer la connectivité OCI-P

L'outil de déplacement de périphérique communique avec BroadWorks via les commandes OCI-P. Pour activer la connectivité OCI-P, suivez les étapes ci-dessous :

Étape 1: Utilisez l’interface de ligne de commande pour configurer les paramètres généraux.

Exécutez la commande suivante dans la CLI pour accéder au répertoire GeneralSettings :

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Exécutez la commande suivante dans la CLI pour obtenir les paramètres généraux actuels :

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

Si vos paramètres ne correspondent pas à ceux ci-dessus, utilisez la commande set pour reconfigurer vos paramètres.

Étape 2: Utilisez l'interface de ligne de commande pour configurer le proxy OCI.

Changez le répertoire vers OCI Proxy :

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Exécutez l’interface de ligne de commande suivante pour obtenir les paramètres actuels. Vous devriez voir ce qui suit :

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

Si vos paramètres ne correspondent pas à ceux ci-dessus, utilisez la commande set pour reconfigurer vos paramètres.

Étape 3: Utilisez l’interface de ligne de commande pour configurer le provisionnement OCI.

Accédez au répertoire de provisionnement :

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Exécutez la commande suivante pour obtenir les paramètres de provisionnement OCI actuels :

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

Étape 4: Exécutez la commande ci-dessous dans CLI pour vérifier que votre configuration est correcte.

 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.

Vérifier que le serveur client ouvert est déployé et actif

Utilisez les commandes ci-dessous pour déployer et démarrer le serveur Open Client sur le serveur d'applications secondaire s'il n'est pas déployé ou n'a pas déjà démarré.

Étape 1: Déployez le serveur avec la commande CLI suivante :

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Étape 2: Démarrez le serveur avec cette commande :

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Activer l'activation des numéros

Exécutez les commandes suivantes dans CLI pour activer l'activation des numéros :

Étape 1: Exécutez la commande d'activation du numéro :

AS_CLI> cd SubscriberMgmt/NumberActivation

Étape 2: Exécutez la commande d'activation activée :

AS_CLI> set dnMode groupAndUserActivationEnabled

Étape 3: À l’invite de confirmation, entrez Y.

Pour BroadCloud

L'outil d'extraction est intégré au portail BroadCloud Service Provider. Un administrateur de fournisseur de services peut :

1. Soumettez des demandes d'extrait pour un maximum de 50 clients par demande.
   La demande d'extraction ne peut pas être soumise pour le même client plus de 10 fois par jour.
2. Téléchargez le fichier de données extrait, au format ZIP, jusqu'à 28 jours à compter de la date de soumission de la demande.

Les figures suivantes montrent le portail du fournisseur de services.

Figure 6 : Portail des fournisseurs de services

Figure 7 : Portail des fournisseurs de services

Demande d'extraction CSV

Lancer une demande d'extraction CSV

1. Télécharger le fichier CSV client

   Cliquez sur le lien Télécharger le fichier CSV client dans le coin supérieur droit de la section Lancer la demande d'extraction CSV.

2. Modifier la liste des clients

   L'administrateur peut modifier ce fichier CSV pour inclure uniquement les clients pour lesquels l'extraction doit être effectuée.

3. Télécharger et soumettre

   Après l'édition, téléchargez le CSV modifié.

   Cliquez sur Soumettre pour lancer une demande d'extraction pour les clients répertoriés et leurs emplacements associés.

Lancer une demande d'extraction pour un client avec des emplacements CSV

1. Sélectionnez le client et téléchargez les emplacements

   Choisissez un client dans la liste déroulante.

   Téléchargez le fichier locations.csv correspondant depuis Afficher les clients→ onglet Sites → Exporter les emplacements au format CSV.

2. Modifier le fichier d'emplacements

   L'administrateur peut modifier le CSV pour inclure uniquement les emplacements qu'il souhaite extraire.

3. Télécharger et soumettre

   Téléchargez le fichier locations.csv modifié et cliquez sur Soumettre.

   Seuls les emplacements spécifiés pour le client sélectionné seront inclus dans la demande d'extraction.

Lancer une demande d'extraction pour tous les clients

1. Cliquez sur Soumettre pour lancer une demande d'extraction pour tous les clients et tous leurs emplacements sous le fournisseur de services actuel.

Pour Cisco BroadWorks et Webex pour BroadWorks

1. L'outil d'extraction s'exécute sur le serveur d'applications Cisco BroadWorks secondaire au sein du réseau partenaire et se connecte via OCI-P.
2. L'outil extrait les données brutes de l'entreprise, du groupe, des numéros, des utilisateurs, des services, des appareils et des clients logiciels de la plate-forme Cisco BroadWorks ou BroadCloud et génère ces données dans des fichiers XML qui fournissent les entrées pour l'outil de transformation.

Les sections suivantes expliquent comment installer et configurer l’outil d’extraction.

Prérequis

1. SCP extrait les fichiers binaires de l'outil vers le serveur d'applications Cisco BroadWorks secondaire.
2. Connectez-vous au serveur d’applications Cisco BroadWorks secondaire en SSH pour configurer les conditions préalables et exécuter l’outil d’extraction.
3. Configurez le fournisseur de services et l'ID de groupe à extraire de Cisco BroadWorks dans le conf/exportTool.yml. Reportez-vous à l’exemple d’extrait YAML suivant :

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

4. Assurez-vous que l'ID utilisateur, le mot de passe et le nom d'hôte du serveur d'applications Cisco BroadWorks secondaire sont corrects dans le conf/partner.cfg déposer:

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

   La propriété REFRESH_TOKEN est obligatoire pour une migration Webex pour BroadWorks.

5. Modifier le JDK/JRE chemin d'environnement dans le fichier export.sh si le serveur d'applications Cisco BroadWorks secondaire JDK/JRE le chemin d'accès à l'environnement est différent du fichier :

   JAVA_HOME=/usr/local/java/java_base

Instructions pour exécuter

Exécutez la commande suivante dans le serveur d’applications Cisco BroadWorks secondaire à partir du répertoire de l’outil d’extraction :

./export.sh

Journaux des terminaux

Les journaux suivants sont disponibles dans le terminal lors d'une exportation réussie : Exécution de l'outil d'exportation de données 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
**************************************************

Sortie

Un fichier ZIP de sortie (extracted_data_<timestamp>.zip) est disponible dans le même répertoire d'outils d'extraction. Utilisez la commande suivante pour afficher et utiliser le fichier ZIP pour l'entrée de l'outil de transformation :

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

Cet outil de transformation s’exécute pour toutes les migrations. L'outil de transformation fonctionne sur n'importe quel ordinateur, y compris l'ordinateur portable de l'administrateur d'un partenaire, et utilise les API publiques Webex. Il lit le fichier ZIP de sortie de l'outil d'extraction (extracted_data_<timestamp>.zip) comme entrée et transforme le XML brut en un format JSON utilisé par l'outil de provisionnement.

Prérequis

Après avoir téléchargé et extrait les binaires des outils de migration, configurez les prérequis suivants :

1. Définissez le JETON REFRESH_(Jeton copié à partir de l'outil de génération de jetons) et le NOM_DE_EMPLACEMENT PRINCIPAL_dans le conf/partner.cfg déposer:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Définissez éventuellement l'ID PROVISIONING_(copié à partir du modèle dans Partner Hub) dans le conf/partner.cfg déposer:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pour obtenir une vérification plus complète de l'adresse e-mail du client, vous pouvez éventuellement définir l'ID PROVISIONING_.
3. Configurer les informations manquantes dans le input/customers.csv fichier (voir section suivante) s'il est manquant.
4. Ajoutez l'adresse e-mail de l'utilisateur final dans le input/users.csv déposer.
5. Si de nouveaux téléphones doivent être provisionnés, ajoutez l'adresse MAC et l'adresse e-mail du nouveau téléphone de l'utilisateur à input/newphones.csv déposer. Cela n'est requis que si les administrateurs partenaires souhaitent provisionner de nouveaux téléphones dans les appels de gros.
6. Convertissez les centres d'appels BroadWorks en CxEssentials en utilisant le input/cxessentials.csv déposer.
7. En option, activez la propriété UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS pour convertir tous les centres d'appels en CxEssentials.
8. Utilisez le input/locations.csv fichier pour prendre en charge la migration des grandes entreprises qui permet aux administrateurs de migrer les emplacements de leurs clients par emplacement
9. Activez éventuellement l'utilisation des adresses MAC à partir de l'en-tête User-Agent du message SIP REGISTER lorsque l'adresse MAC n'est pas disponible dans le profil de périphérique Cisco BroadWorks. Décommentez la ligne « USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" dans le fichier conf/partner.cfg
10. La fonctionnalité de synchronisation du serveur réseau permet aux administrateurs de provisionner des numéros de téléphone, des adresses MAC et des adresses e-mail d'utilisateurs lors de la mise en place dans la même région de migration. Pour l'activer, définissez USE_NS_SYNC=yes dans conf/partner.cfg.

    Si la synchronisation NS est désactivée, le provisionnement du numéro de téléphone et de l'appareil sera ignoré et les utilisateurs recevront des adresses e-mail temporaires.

11. Activez éventuellement les propriétés ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD et ANALOG_USER_TYPE_DISABLE_T38 pour configurer l'appel en attente, la musique en attente et désactiver les paramètres T38 pour tous les utilisateurs de type analogique.

Remplissage du input/customers.csv

Le fichier input/customers.csv fournit des données qui peuvent manquer dans Cisco BroadWorks ou BroadCloud. Ce fichier peut être laissé vide si toutes les informations obligatoires sont déjà disponibles. Vous n'êtes pas obligé de remplir toutes les colonnes, seules les informations manquantes sont obligatoires.

Le tableau ci-dessous explique les colonnes les plus importantes input/customers.csv.

Remplissage du input/users.csv

Le fichier input/users.csv fournit des données qui peuvent manquer dans Cisco BroadWorks ou BroadCloud. Ce fichier peut être laissé vide si toutes les informations obligatoires sont déjà disponibles. Vous n'êtes pas obligé de remplir toutes les colonnes, seules les informations manquantes sont obligatoires.

Instructions pour exécuter

Exécutez l’outil de transformation dans n’importe quel système d’exploitation. Suivez les étapes ci-dessous pour exécuter l’outil sous Windows et macOS :

Windows

Exécutez la commande ci-dessous pour exécuter l’outil de transformation sous Windows :

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

macOS

Exécutez les étapes suivantes pour exécuter l’outil de transformation sur macOS :

1. Créez un environnement virtuel et installez les dépendances pour exécuter l'outil de transformation à l'aide de 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. Exécutez l’outil de transformation :

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

Customer/user pré-vérification

L'outil de transformation effectue des appels API vers Webex pour détecter les problèmes de provisionnement potentiels. Par défaut, il validera l'adresse et l'e-mail principal du client. Si la valeur d'ID PROVISIONING_est spécifiée dans le conf/partner.cfg fichier, il validera également les informations de localisation. Les résultats du pré-contrôle sont inclus dans le rapport d’exception.

De plus, les paramètres facultatifs suivants peuvent être ajoutés lors de l'exécution de l'outil de transformation :

pré-vérification

En plus d'exécuter l'API de pré-vérification pour les informations client, l'outil de transformation exécutera également l'API de pré-vérification pour les e-mails des abonnés.

informations de pré-vérification

Par défaut, seules les erreurs de pré-vérification (c'est-à-dire les problèmes qui bloqueront le provisionnement) sont incluses dans le rapport d'exception. L'ajout de cet indicateur inclura également les résultats de pré-vérification réussis (par exemple, si une organisation Webex existe déjà et peut être automatiquement attachée).

Journaux des terminaux

Les journaux suivants s'affichent dans le terminal lors d'une transformation réussie :

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

Rapport d'exception

L'outil de transformation génère le rapport d'exception dans la sortie /<timestamp>/exception_report.txt répertoire. Vous pouvez utiliser ce rapport pour identifier les problèmes qui affecteront la migration et les résoudre dans le système Cisco BroadWorks.

Après avoir modifié les données utilisateur pour résoudre l’exception, réexécutez les outils d’extraction et de transformation avec les nouvelles données. L'exemple de fichier de rapport d'exception est le suivant :

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

Sortie

Un fichier de sortie JSON (customer.json) sera disponible dans le répertoire output/<timestamp>/<groupid> répertoire. L'exemple de fichier customer.json est le suivant :

{
    "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"
    }
}

L'outil de provisionnement peut s'exécuter sur n'importe quelle machine, généralement l'ordinateur portable de l'administrateur du partenaire, et utilise les API publiques Webex. Il lit le fichier JSON de sortie de l'outil de transformation (customer.json) comme entrée et provisionne les clients, les emplacements, les numéros, les utilisateurs, les services et les appareils dans la solution Webex Wholesale RTM.

Prérequis

Configurez les prérequis suivants dans le répertoire de l’outil de provisionnement :

1. Installez Java 8, 11, 17 ou 21 sur l’ordinateur. Java est disponible à partir de nombreuses sources, notamment :
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Après avoir téléchargé et extrait les binaires des outils de migration, définissez la variable d'environnement JAVA_HOME dans provisioning_tool.sh pour MAC et provisioning_tool.bat pour Windows.
3. Le fichier partner.cfg :
   • Définissez l'ID WHOLESALE_PROVISIONING_et REFRESH_TOKEN (jeton copié à partir de l'outil de génération de jetons). Les administrateurs partenaires doivent contacter leur équipe de compte pour obtenir l'ID PROVISIONING_ :

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Définissez ALLOW_ADMIN_INVITE_EMAILS sur false, si le partenaire ne souhaite pas envoyer d'e-mail de bienvenue aux utilisateurs. La valeur par défaut est vrai.

4. Utilisez la propriété WEBEX4BWKS_EMAIL_SUBJECT pour les migrations Webex pour BroadWorks afin d'envoyer l'objet de l'e-mail de demande de modification de mot de passe pour les abonnés Webex pour BroadWorks.
5. Utilisez la propriété WEBEX4BWKS_EMAIL_BODY pour les migrations Webex pour BroadWorks afin d'envoyer le corps de l'e-mail de demande de modification de mot de passe pour les abonnés Webex pour BroadWorks.
6. La fonctionnalité de synchronisation du serveur réseau permet aux administrateurs de provisionner des numéros de téléphone, des adresses MAC et des adresses e-mail d'utilisateurs lors de la mise en place dans la même région de migration. Pour l'activer, définissez USE_NS_SYNC=yes dans conf/partner.cfg.

   Si la synchronisation NS est désactivée, le provisionnement du numéro de téléphone et de l'appareil sera ignoré et les utilisateurs recevront des adresses e-mail temporaires.

Pour les migrations BroadCloud même région :

1. L'outil ignore le provisionnement des numéros, des appareils et des apparences d'appels partagés.
2. L'outil crée des utilisateurs et des utilisateurs virtuels avec extension et extension temporaire.

Pour les migrations BroadCloud vers une autre région :

1. L'outil fournira des numéros, des appareils et des apparences d'appels partagés.
2. L'outil crée des utilisateurs et des utilisateurs virtuels avec des numéros de téléphone et des extensions réels.
   Toutes les migrations BroadCloud en Europe se font vers une autre région.

Instructions pour exécuter

Suivez les étapes suivantes pour exécuter l’outil sous Windows et macOS :

Windows

Exécutez les étapes suivantes pour exécuter l’outil sur le système d’exploitation Windows :

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

macOS

Exécutez les étapes suivantes pour exécuter l’outil sur macOS :

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

Conditions préalables à la migration vers Webex pour BroadWorks

Les administrateurs partenaires doivent mettre à jour leur modèle d’intégration BroadWorks pour les fonctionnalités de coexistence Webex for BroadWorks. Reportez-vous à l’image suivante :

Une fois le modèle d'intégration Webex pour BroadWorks mis à jour pour prendre en charge la migration, demandez à l'équipe de compte Cisco d'activer la fonctionnalité « wholesale-partner-blending-enabled » au niveau du partenaire. Cela permettra d'ajouter des packages de gros aux organisations clientes Webex for BroadWorks existantes lors de l'approvisionnement.

Exécutez l’outil de provisionnement avec un argument supplémentaire.

Phase de préparation : est la phase par défaut où les administrateurs peuvent provisionner les utilisateurs BroadWorks en tant qu'abonnés Wholesale et continuer avec les utilisateurs Webex pour BroadWorks.

Phase de maintenance : il s'agit de la deuxième phase au cours de laquelle les administrateurs peuvent attribuer la licence Wholesale aux utilisateurs Webex for BroadWorks existants. Vous devez exécuter l'outil de provisionnement avec un argument maintenance.

Phase post-migration : Il s'agit de la phase finale au cours de laquelle les administrateurs peuvent convertir complètement BroadWorks en Wholesale. Vous devez exécuter l'outil de provisionnement avec un argument postmigration.

Journaux des terminaux

Voici les journaux dans le terminal en cas de provisionnement réussi :

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

Un tableau sera imprimé avec le nombre d'emplacements créés pour chaque exécution :

Sortie

L'outil de provisionnement génère des rapports de réussite et d'erreur dans la sortie /<external_id>/*.success/error fichiers. Consultez les journaux de réussite et d’erreur de sortie pour vérifier la réussite du provisionnement.

Les administrateurs partenaires peuvent vérifier le provisionnement des clients dans le portail Partner Hub et Control Hub. Reportez-vous aux illustrations suivantes du portail Partner Hub et Control Hub :

Figure 8 : Hub partenaire

Figure 9 : Control Hub

Figure 10 : Appareils

Figure 11 : Appel

Pour BroadCloud

Pour les partenaires BroadCloud, utilisez le portail des fournisseurs de services pour soumettre une demande de migration pour les numéros, les appareils et les migrations d'apparences d'appels partagés (SCA).

Au sein du portail des fournisseurs de services, une demande de migration peut inclure jusqu'à 50 clients. Un maximum de 10 demandes peuvent être soumises dans une journée.

La fonctionnalité de synchronisation du serveur réseau permet aux administrateurs de désactiver l'emplacement broadCloud et d'activer l'emplacement Webex Calling en définissant le USE_NS_SYNC=yes dans le conf/partner.cfg. Après la migration, les appareils et les numéros de téléphone sont activés dans l'emplacement Webex Calling.

Les administrateurs peuvent activer la restauration automatique en définissant ROLLBACK_TO_BROADCLOUD=true dans le fichier conf/partner.cfg, ce qui déplace les appareils vers BroadCloud après la migration. Il prend en charge les migrations vers une même région ou vers une région différente avec NS Sync, mais uniquement pour les migrations réussies. En cas d'échec, les administrateurs doivent contacter un TAC Cisco avant de demander une restauration.

Deux options sont disponibles pour sélectionner le type de migration dans le portail :

• Migration – Sélectionnez cette option pour lancer une demande de migration de numéros, d’appareils et d’apparences d’appels partagés (SCA).
• État de l'appareil – Sélectionnez cette option pour afficher l'état actuel d'un appareil sur BroadCloud et Calling.

Les figures suivantes montrent le portail du fournisseur de services.

Figure 12 : Portail des fournisseurs de services

Figure 13 : Portail des fournisseurs de services

Migrer les emplacements sélectionnés (facultatif)

Pour démarrer la migration pour un sous-ensemble spécifique d'emplacements répertoriés dans le fichier customer.json, incluez un fichier locations.csv avec votre demande. Ce fichier CSV doit répertorier uniquement les emplacements que vous souhaitez migrer.

Pour télécharger la liste des sites actifs disponibles, accédez à Afficher les clients → Sélectionner un client → Exporter les emplacements au format CSV.

Figure 14 : Exporter les emplacements au format CSV

Pour Cisco BroadWorks et Webex pour BroadWorks

Pour les migrations Cisco BroadWorks et Webex pour BroadWorks, l'outil s'exécute sur le serveur d'applications Cisco BroadWorks secondaire au sein du réseau partenaire et se connecte à l'AS via OCI-P. Il utilise le fichier JSON de sortie de l'outil de transformation (customer.json) comme entrée et exécute les commandes OCI-P pour migrer les appareils et les clients logiciels.

En cas d'opération réussie, l'outil de déplacement de l'appareil va :

1. Annulez l'enregistrement des appareils de Cisco BroadWorks et enregistrez-les dans Wholesale.
2. Les utilisateurs utilisant le client UC-One seront redirigés vers l'application Webex lors de la première connexion.
3. Désactivez les numéros de téléphone de Cisco BroadWorks ou supprimez les numéros de téléphone de BroadCloud.
4. Activer les numéros en gros.
5. Créez des apparences d’appel partagées dans Wholesale pour les migrations BroadCloud. [This l'étape s'applique uniquement à BroadCloud migrations].

SCP et SSH

1. SCP l'outil de déplacement de périphérique vers le serveur d'applications Cisco BroadWorks secondaire.
2. Connectez-vous au serveur d’applications Cisco BroadWorks secondaire en SSH pour configurer les conditions préalables et exécuter l’outil de déplacement de périphérique.

Prérequis

1. Définissez le JETON REFRESH_(Jeton copié à partir de l'outil Générateur de jetons) dans le conf/partner.cfg déposer:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Assurez-vous que l'ID utilisateur, le mot de passe et le nom d'hôte du serveur d'applications Cisco BroadWorks secondaire sont corrects dans le conf/deviceMoveTool.conf déposer:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Pour renvoyer les e-mails d'activation, vous devez définir RENVOYER_INVITATION_EMAILS=true dans le conf/partner.cfg déposer.

   Si les administrateurs souhaitent envoyer des e-mails d'invitation à leurs utilisateurs pendant la migration, ils doivent supprimer le commentaire « RENVOYER_INVITATION_EMAILS=true" propriété dans le conf/partner.cfg déposer. Dans le cas contraire, la propriété devrait rester inchangée.

4. Vérifiez le JDK/JRE le chemin d'environnement est correct dans devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Les administrateurs peuvent utiliser le fichier locations.csv du répertoire d'entrée pour migrer les groupes spécifiques au lieu de tous les groupes d'une entreprise.

Téléphones Polycom

Pour déplacer les téléphones Polycom de Cisco BroadWorks vers Wholesale Calling, un administrateur partenaire doit créer un nouveau Identity/Device Fichier de type de profil au niveau du système dans Cisco BroadWorks chaque modèle de périphérique Polycom. Reportez-vous à la figure 14 et téléchargez le fichier personnalisé device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Après avoir téléchargé le nouveau fichier de périphérique, assurez-vous que le fichier nouvellement créé existe au niveau du groupe. Assurez-vous également que le fichier migration_%BWMAC ADDRESS%.cfg n'entre pas en conflit avec un fichier existant dans votre système).

Il est utilisé en interne par l'outil de déplacement de périphérique.

Le processus de migration pour les téléphones Polycom :

1. L'outil de déplacement de périphérique remplace le fichier %BWMACADDRESS%.cfg au niveau du périphérique par polycom_vvx2.cfg. Ce fichier fait référence à migration_%BWMACADDRESS%.cfg.
2. Reconstruisez les profils d’appareils au niveau du groupe ou au niveau de l’appareil.
   L'action au niveau du groupe ou au niveau du périphérique dépend de la configuration du paramètre deviceLevelRebuild dans le fichier device-move-tool/conf/partner.cfg.
3. L'outil de déplacement de périphérique demande au serveur d'applications Cisco BroadWorks de redémarrer les téléphones au niveau du groupe ou au niveau du périphérique.
4. Après la demande de redémarrage, les téléphones Polycom téléchargent et traitent% BWMACADDRESS%.cfg, qui demande aux téléphones Polycom de télécharger et de traiter migration_%BWMACADDRESS%.cfg, ce qui définit device.prov.serverName sur https://plcm.sipflash.com.
   https://plcm.sipflash.com pour la région des États-Unis, les autres régions ont des URL différentes.
5. Le téléphone Polycom télécharge %BWMACADDRESS%.cfg depuis https://plcm.sipflash.com et sera géré par le DMS Webex Calling.

Figure 14 : Identity/device fichier de type de profil ajouter

Instructions pour exécuter

Il existe deux méthodes pour invoquer le DMT, la première consiste à invoquer un seul client à la fois et l'autre consiste à exécuter plusieurs clients simultanément.

L'outil de déplacement de périphérique est exécuté à partir du serveur d'applications Cisco BroadWorks secondaire dans le répertoire de l'outil de déplacement de périphérique :

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

Journaux des terminaux

Voici les journaux dans le terminal lors de l'exécution réussie de l'outil de déplacement de périphérique pour la migration de périphérique :

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

Sortie

Après la migration des appareils, les appareils sont en ligne et prêts à être utilisés. make/receive appels. Reportez-vous à la figure 15 pour voir un exemple de l’état de l’appareil :

Figure 15 : Statut du périphérique

Après la migration des appareils, les numéros sont devenus actifs. Reportez-vous à la figure 16 pour voir un exemple des numéros actifs :

Figure 16 : Numéros actifs

L'opération de restauration doit être exécutée pour une entreprise à la fois.

Pour BroadCloud Carrier

Le processus de retour pour les partenaires BroadCloud est le suivant :

1. Ouvrez un ticket auprès du TAC Cisco pour demander une restauration de l'appareil.
2. Exécutez l'outil de déplacement de périphérique en mode de restauration :
   • Les numéros de téléphone ne seront plus attribués à partir de Webex Calling, laissant les utilisateurs et les services avec uniquement des extensions.
   • Les adresses e-mail dans Webex Calling seront rétablies en adresses e-mail temporaires.
   • Les téléphones seront supprimés de Webex Calling.
   • Les numéros de téléphone, les adresses e-mail utilisées comme identifiants alternatifs et les téléphones seront recréés dans BroadCloud.
   • Les téléphones seront redémarrés.
3. Les administrateurs partenaires doivent déplacer les numéros de téléphone PSTN vers BroadCloud Carrier.

Pour Cisco BroadWorks et Webex pour BroadWorks

Le processus de restauration pour Cisco BroadWorks et Webex pour BroadWorks est le suivant :

1. Ouvrez un ticket auprès du TAC Cisco pour demander une restauration de l'appareil.
2. Exécutez l’outil de déplacement de périphérique en mode de restauration sur le serveur d’applications BroadWorks secondaire pour annuler les migrations de périphérique. Cela rétablira l'URL DMS sur l'URL DMS du fournisseur de services pour les profils d'appareils dans Cisco BroadWorks et réactivera les numéros de téléphone.
3. L'équipe Webex Calling redéfinit l'URL DMS sur l'URL DMS du fournisseur de services dans les profils d'appareils dans Webex Calling.
4. Les administrateurs partenaires doivent désactiver ou supprimer les numéros de téléphone dans Webex Calling via le portail Control Hub.
5. Les administrateurs partenaires doivent déplacer les numéros de téléphone PSTN vers Cisco BroadWorks.

Instructions pour exécuter l'outil de déplacement de périphérique en mode de restauration

Suivez les étapes ci-dessous pour exécuter l’outil de déplacement de périphérique en mode de restauration :

Exécutez la commande ci-dessous dans le serveur d'applications Cisco BroadWorks secondaire dans le répertoire de l'outil de déplacement de périphérique :

Rétablir les profils

./devicemove.sh -input=  -revertProfiles

Inverser les numéros

./devicemove.sh -input=  -revertNumbers

Journaux des terminaux

Nous obtiendrons les journaux suivants dans le terminal lors de l'exécution réussie de l'outil de déplacement de périphérique pour l'opération de restauration :

Rétablir les profils

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

Inverser les numéros

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