Outils de migration pour passer de BroadWorks, Webex for BroadWorks et BroadCloud aux solutions RTM Wholesale

Les téléphones pris en charge seront automatiquement créés et attribués aux utilisateurs dans Webex Calling par l’outil de mise à disposition. Les téléphones marqués « oui » dans la colonne « Pris en charge dans l’outil de déplacement du périphérique » seront également automatiquement déplacés de Cisco BroadWorks ou BroadCloud vers Webex Calling lorsque l’outil de déplacement du périphérique sera 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 « Device type » du fichier transform-tool/input/newphones.csv. (Voir la section Transformer l'outil de cet article pour plus d'informations sur newphones.csv).

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

Prérequis

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

Définissez le chemin d'environnement JRE/JDK dans les token_generator.sh pour MAC et token_generator.bat pour Windows. Si le chemin JAVA_HOME existe déjà, il sera réutilisé par l’outil.

• MAC : JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows : JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Instructions à 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

Sortie :

Nom de l'outil : Version de l’outil du générateur de jetons : 1.13.0 Charger l'URL dans votre navigateur Web : 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 JETON et copiez-le pour une utilisation ultérieure.

Les illustrations de l’interface utilisateur sont données ci-dessous à titre indicatif :

Figure 3 : Se connecter avec Cisco Webex

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

Figure 5 : Génération des 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 (CLI) pour configurer les paramètres généraux.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Exécutez la commande suivante dans 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 à ce qui précède, utilisez la commande définir pour reconfigurer vos paramètres.

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

Changer le répertoire en proxy OCI :

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 à ce qui précède, utilisez la commande définir pour reconfigurer vos paramètres.

Étape 3 : Utilisez l'interface de ligne de commande (CLI) pour configurer la mise à disposition OCI.

Modifier le répertoire de mise à disposition :

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> obtenir la description de l'adresse ======================== 127.0.0.1 locale comme 

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

 AS_CLI/Maintenance/ManagedObjects> obtenez broadworks et vérifiez que votre sortie semble correcte. Voir ci-dessous pour la sortie de l’échantillon : AS_CLI/Maintenance/ManagedObjects> obtenir broadworks BroadWorks Managed Objects ========================== * Serveur : Identité..............: Version AS...............: Rel_21.sp1_1.551 État administratif.. : Déverrouillé * Applications : Nom Version Deployed État administratif État effectif ========================================================================================= 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: Nom 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 entrées trouvées. 

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 client ouvert 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> déployer l'application OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> démarrer l'application OpenClientServer

Activer l’activation des numéros

Exécutez les commandes suivantes dans CLI pour activer les 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> définir le groupe dnMode etUserActivationEnabled

Étape 3 : À l'invite de confirmation, saisissez O.

Pour BroadCloud

L'outil d'extraction est intégré dans le portail du fournisseur de services BroadCloud. Un administrateur fournisseur de services peut :

1. Soumettez des demandes d'extraction pour un maximum de 50 clients par demande.
   La demande d’extrait 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 extraites, au format ZIP, pendant 28 jours à compter de la date de soumission de la demande.

Les figures ci-dessous montrent le portail Prestataire.

Figure 6 : Portail Prestataire de services

Figure 7 : Portail Prestataire de services

Pour Cisco BroadWorks et Webex pour BroadWorks

1. L'outil d'extraction s'exécute sur le serveur d'application Cisco BroadWorks secondaire dans le 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 périphériques et du client logiciel de la plateforme Cisco BroadWorks ou BroadCloud et produit 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 les binaires de l'outil d'extraction vers le serveur d'application Cisco BroadWorks secondaire.
2. SSH sur le serveur d'applications Cisco BroadWorks secondaire pour configurer les prérequis et exécuter l'outil d'extraction.
3. Configurez le fournisseur de services et l'ID du groupe pour extraire de Cisco BroadWorks dans conf/exportTool.yml. Reportez-vous à l'exemple d'extrait YAML ci-dessous :

   ID du fournisseur de service-A :      - GroupID-A1 - GroupID-A2 - GroupID-A3 PrestataireID-B :                        - TOUS 

4. Vérifiez que l'ID utilisateur du serveur d'application Cisco BroadWorks secondaire, le mot de passe et le nom d'hôte sont corrects dans le fichier conf/partner.cfg :

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = jeton d’actualisation de l’administrateur partenaire copié à partir de l’outil Générateur de jetons. MODE_MIGRATION = Les valeurs prises en charge sont webex_for_broadworks_to_wholesale. La valeur par défaut est broadworks_to_wholesale. Utiliser webex_for_broadworks_to_wholesale pour Webex pour les migrations BroadWorks. 

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

5. Modifiez le chemin d'environnement JDK/JRE dans le fichier export.sh si le chemin d'environnement secondaire JDK/JRE du serveur d'application Cisco BroadWorks secondaire est différent du fichier :

   JAVA_HOME=/usr/local/java/java_base

Instructions à exécuter

Exécutez la commande ci-dessous 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 de l'exportation réussie : Exécution de l'outil d'exportation de données BroadSoft :

 Exécution de l'outil d'exportation de données BroadSoft ************************************************ Démarrage de l'outil d'exportation v : 1.15.0 Exportation démarrée pour SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportation des utilisateurs pour SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportation terminée pour SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportation terminée pour SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportation terminée Exportation du répertoire zip du vidage : output/20221017223452_ExportTool Export Dump Zip nom du fichier :extracted_data_1666060500618.zip Fichier zip portant le nom extracted_data_1666060500618.zip a été créé Processus de création de fichier zip terminé Fichiers exportés convertis en fichier ZIP ************************************************** 

Sortie

Un fichier ZIP de sortie (extracted_data_.zip) sera disponible dans le même répertoire de l’outil d’extraction. Utilisez la commande ci-dessous pour afficher et utiliser le fichier ZIP pour l'entrée Transform Tool :

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 est exécuté pour toutes les migrations. L’outil de transformation s’exécute 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_.zip) en entrée et transforme le XML brut en un format JSON qui est utilisé par l'outil de mise à disposition.

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 REFRESH_TOKEN (Token copié à partir de l'outil Token Generator) et le NAME_OF_MAIN_LOCATION dans le fichier conf/partner.cfg :

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main 

2. Configurez éventuellement l’ID_DE MISE À DISPOSITION (copié à partir du modèle dans Partner Hub) dans le fichier conf/partner.cfg :

   MISE À DISPOSITION_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pour obtenir une vérification plus complète de l’adresse électronique du client, vous pouvez éventuellement définir l’ID de_PROVISIONING.
3. Configurez les informations manquantes dans le fichier input/customers.csv (voir section suivante) si elles sont manquantes.
4. Ajoutez l’adresse électronique de l’utilisateur final dans le fichier input/users.csv.
5. Si de nouveaux téléphones doivent être mis à disposition, ajoutez l'adresse mac et l'adresse électronique du nouveau téléphone de l'utilisateur au fichier input/newphones.csv. Ceci est requis uniquement si les administrateurs partenaires souhaitent mettre à disposition de nouveaux téléphones dans l’appel Wholesale.
6. Convertissez les centres d’appels BroadWorks dans CxEssentials en utilisant le fichier input/cxessentials.csv.
7. En option, activez la propriété UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS pour convertir tous les centres d’appels vers CxEssentials.
8. Utiliser le fichier input/locations.csv pour prendre en charge la migration des grandes entreprises qui permet aux administrateurs de migrer les emplacements de leurs clients par emplacement
9. Vous pouvez éventuellement activer l'utilisation des adresses MAC à partir de l'en-tête Agent-utilisateur du message SIP REGISTER lorsque l'adresse MAC n'est pas disponible dans le profil du périphérique Cisco BroadWorks. Décocher la ligne « USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes » dans le fichier conf/partner.cfg

Remplir le fichier input/customers.csv

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

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

Instructions à exécuter

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

Windows

Exécutez la commande ci-dessous pour exécuter l'outil Transform dans 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 des dépendances pour exécuter l’outil de transformation en utilisant Python :

   python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. Lancez l’outil de transformation :

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

Pré-vérification client/utilisateur

L’outil Transform passe des appels API vers Webex pour détecter les problèmes potentiels de mise à disposition. Par défaut, il validera l’adresse et l’e-mail principal du client. Si la valeur PROVISIONING_ID est spécifiée dans le fichier conf/partner.cfg, elle validera également les informations de localisation. Les résultats de la pré-vérification sont inclus dans le rapport d'exception.

En outre, 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 du client, l'outil de transformation exécutera également l'API de prévérification pour les courriers électroniques des abonnés.

pré-checkinfo

Par défaut, seules les erreurs de pré-vérification (c’est-à-dire les problèmes qui bloqueront la mise à disposition) sont incluses dans le rapport d’exception. L’ajout de ce drapeau inclura également les résultats de pré-vérification réussis (par exemple, si une organisation Webex existe déjà et peut être automatiquement jointe).

Journaux des terminaux

Les journaux suivants dans le terminal lors de la transformation réussie :

Rapport de synthèse Les entreprises BroadWorks qui peuvent être migrées avec succès : 1 entreprises BroadWorks qui ne peuvent pas être migrées : 0 utilisateurs BroadWorks qui peuvent être transférés avec succès : 4 utilisateurs BroadWorks qui ne peuvent pas être transférés : 0 Téléphones qui peuvent être transférés avec succès : 3 téléphones qui ne sont pas compatibles avec Webex Calling : 0 

Rapport d'exception

Transform Tool génère le rapport d'exception dans le répertoire output//exception_report.txt . 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, relancez les outils d'extraction et de transformation avec les nouvelles données. L'exemple de fichier de rapport d'exception comme suit :

Rapport d'exception mar. oct. 18 08:12:09 2022 Entreprises avec interdiction de communication Feature Recommendation: configurer manuellement le plan d’appels sortants dans le Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Sortie

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

{ "customer": { "provisioningId": "!!!!!!!!!!REMPLACER_AVEC_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+engineering group1@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", "langue": "en_us", "numéros": [ "+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": "!!!!!!!!!!REMPLACER_AVEC_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "paquet": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" }}, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": vrai, "sendBusyCalls": { "enabled": true, "message d'accueil": "DEFAULT" }, "sendUnansweredCalls": { "enabled": vrai, "message d'accueil" : "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": vrai, "sendBusyCalls": { "enabled": true, "message d'accueil": "DEFAULT" }, "sendUnansweredCalls": { "enabled": vrai, "message d'accueil" : "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": vrai, "sendBusyCalls": { "enabled": true, "message d'accueil": "DEFAULT" }, "sendUnansweredCalls": { "enabled": vrai, "message d'accueil" : "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": vrai, "sendBusyCalls": { "enabled": true, "message d'accueil": "DEFAULT" }, "sendUnansweredCalls": { "enabled": vrai, "message d'accueil" : "DEFAULT", "numberOfRings" : 3 }, « messageStorage » : { « mwiEnabled » : true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [{ "cisUuid": "!!!!!!!!!!REPLACE_AVEC_PERSONID!!!!!!!!!!", « produit » : « DMS Cisco 8811 », « mac » : « F87B204E4066 » } ] } } ], «auto_attendants": [], "call_queues": [], "hunt_groups": [], "annexes": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [{ "name": "Portail vocal automatisé", "firstName": "Automatisé", "lastName": "Portail vocal", "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 mise à disposition peut fonctionner 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 mise à disposition des clients, emplacements, numéros, utilisateurs, services et périphériques dans la solution Webex Wholesale RTM.

Prérequis

Configurez les prérequis suivants dans le répertoire de l'outil de mise à disposition :

1. Installez Java 8, 11 ou 17 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://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Après avoir téléchargé et extrait les binaires des outils de migration, définissez la variable d'environnement JAVA_HOME dans les fichiers provisioning_tool.sh pour MAC et provisioning_tool.bat pour Windows.
3. Le fichier partner.cfg :
   • Configurez l’ID_DE MISE À DISPOSITION_EN GROS et le JETON D’ACTUALISATION_(jeton copié à partir de l’outil Générateur de jetons). Les administrateurs partenaires doivent contacter l'équipe de leur compte pour obtenir l'ID de_PROVISIONING :

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Configurez les COURRIERS ÉLECTRONIQUES AUTORISER_ADMIN_INVITER_à faux, si le partenaire ne souhaite pas envoyer de courrier électronique de bienvenue aux utilisateurs. La valeur par défaut est Vrai.

4. Utilisez la propriété WEBEX4BWKS_EMAIL_SUBJECT pour les migrations Webex for BroadWorks pour envoyer l’objet du courrier électronique de demande de changement de mot de passe pour Webex pour les abonnés BroadWorks.
5. Utilisez la propriété WEBEX4BWKS_EMAIL_BODY pour les migrations Webex for BroadWorks pour envoyer le corps du courrier électronique de demande de changement de mot de passe pour Webex pour les abonnés BroadWorks.

Pour les migrations BroadCloud, même région :

1. L’outil ignorera le provisionnement des numéros, des périphériques et des apparences d’appels partagés.
2. L’outil créera des utilisateurs et des utilisateurs virtuels avec un numéro de poste et un numéro de poste temporaire.

Pour les migrations BroadCloud, une autre région :

1. L’outil fournira les numéros, les périphériques et les apparences d’appels partagés.
2. L’outil créera des utilisateurs et des utilisateurs virtuels avec des numéros de téléphone et des numéros de poste réels.
   Toutes les migrations BroadCloud en Europe sont vers une autre région.

Instructions à exécuter

Suivez les étapes ci-dessous pour exécuter l'outil dans Windows et macOS :

Windows

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

Pour approvisionner un seul client : provision.bat -input= Pour provisionner plusieurs clients : provision.bat -input= 

macOS

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

Pour approvisionner un seul client : ./transform.sh -input= Pour approvisionner plusieurs clients : ./transform.sh -input= 

Prérequis pour la migration de Webex pour BroadWorks

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

Exécutez l’outil de provisionnement avec un argument supplémentaire pour la migration de Webex pour BroadWorks vers Wholesale.

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

Phase de maintenance : est la deuxième phase au cours de laquelle les administrateurs peuvent attribuer la licence Wholesale à Webex existant pour les utilisateurs BroadWorks. Vous devez lancer l'outil de mise à disposition avec un argument maintenance.

Phase de post-migration : Est la phase finale pendant laquelle les administrateurs peuvent convertir complètement BroadWorks en Wholesale. Vous devez lancer l'outil de mise à disposition avec un argument post-migration.

Journaux des terminaux

Voici les journaux du terminal lors de la mise à disposition réussie :

Nom de l'outil : Version de l’outil de mise à disposition : 1.15.0 ********** Fichier de traitement démarré : input/customer.json **************** Provisioning Client En attente que le client external_id_engg_grp1 ait terminé le provisionnement... En attente que le client external_id_engg_grp1 termine la mise à disposition...   Statut du client external_id_engg_grp1 : Numéros de provisioning Utilisateurs Provisioning Fonctionnalités des utilisateurs Provisioning Messages d’accueil Provisioning Calendriers de provisioning Périphériques de provisioning Apparences d’appels partagés Provisioning Répondeurs automatiques Provisioning Files d’attente d’appels Provisioning Groupes de recherche Provisioning Pagings de groupe Provisioning Parkings d’appels Provisioning Prises d’appels Provisioning Portail vocal ********** Fichier terminé : input/customer.json **************** 

Un tableau sera imprimé avec le nombre d’emplacements créés pour chaque passage :

Sortie

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

Les administrateurs partenaires peuvent vérifier la mise à disposition du client 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 du fournisseur de services pour soumettre une demande de migration pour les numéros, les périphériques et les migrations SCA.

Dans le portail du fournisseur de services, une demande de migration peut inclure jusqu’à 50 clients. Un maximum de 10 demandes peuvent être soumises en une journée.

Les figures ci-dessous montrent le portail Prestataire.

Figure 12 : Portail Prestataire de services

Figure 13 : Portail Prestataire de services

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'application Cisco BroadWorks secondaire dans le réseau partenaire et se connecte au AS via OCI-P. Il utilise le fichier JSON de sortie Transform Tool (customer.json) comme entrée et exécute les commandes OCI-P pour migrer les périphériques et les clients logiciels.

En cas de fonctionnement réussi, l’outil de déplacement du périphérique :

1. Désenregistrez les périphériques de Cisco BroadWorks et enregistrez-les dans Wholesale.
2. Les utilisateurs utilisant le client UC-One redirigeront vers l’application Webex lors de leur 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 dans Wholesale.
5. Créer des apparences d'appels partagés dans Wholesale pour les migrations BroadCloud. [Cette étape n’est applicable que pour les migrations BroadCloud].

SCP et SSH

1. SCP l'outil de déplacement du périphérique vers le serveur d'applications Cisco BroadWorks secondaire.
2. SSH vers le serveur d'application Cisco BroadWorks secondaire pour configurer les prérequis et exécuter l'outil de déplacement de périphérique.

Prérequis

1. Définissez le REFRESH_TOKEN (Token copié à partir de l'outil Générateur de Token) dans le fichier conf/partner.cfg :

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Vérifiez que l'ID utilisateur du serveur d'application Cisco BroadWorks secondaire, le mot de passe et le nom d'hôte sont corrects dans le fichier conf/deviceMoveTool.conf :

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost 

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

   JAVA_HOME=/usr/local/java/java_base

4. 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 sous 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 fichier de type d'identité/profil de périphérique au niveau 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 du périphérique, assurez-vous que le nouveau fichier créé existe au niveau du Groupe. Assurez-vous également que le fichier migration_%BWMAC ADDRESS%.cfg n'est pas en conflit avec un fichier existant dans votre système).

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

Le processus de migration des 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. Notez que ce fichier fait référence à migration_%BWMACADDRESS%.cfg.
2. Reconstruire les profils de périphérique au niveau du groupe ou du périphérique.
   Agir au niveau du groupe ou 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'application Cisco BroadWorks de redémarrer les téléphones au niveau du groupe ou 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, qui définit device.prov.serverName sur https://plcm.sipflash.com.
   https://plcm.sipflash.com pour la région des États-Unis, d'autres régions ont des URL différentes.
5. Le téléphone Polycom télécharge %BWMACADDRESS%.cfg à partir de https://plcm.sipflash.com et sera géré par le DMS Webex Calling.

Figure 14 : Ajout d’un fichier de type d’identité/de profil de périphérique

Instructions à exécuter

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

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

Pour device move single customer: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Pour device move multiple customers: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json De plus, l'outil de device move prend en charge la migration de téléphones individuels/spécifiques à partir de la version 1.35.0. Utilisez la commande ci-dessous : ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Journaux des terminaux

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

Nom de l'outil : Version de l’outil de déplacement du périphérique : 1.15.0 L’outil du périphérique a démarré... Périphériques valides pour le transfert : ------------------------------------------------------------------------------------------------------------------- | Type de périphérique | Mac | Version | Courrier électronique | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Voulez-vous migrer tous ces périphériques ? ([Y]es ou [N]o) oui Chargement des profils de périphériques pour DMS Cisco MPP LC Processus de reconstruction du périphérique démarré Processus de reconstruction du périphérique terminé avec succès Processus de redémarrage démarré Processus de redémarrage terminé avec succès Modification des profils pour Business Communicator sous groupe collabmigrationtestGRP_engg Activer le processus de numéros de téléphone Webex démarré pour l’ID de l’organisation du client : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Activation du processus de numéros de téléphone Webex terminé pour l’ID d’organisation du client : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Désactivation des numéros de téléphone broadworks a démarré pour groupId : collabmigrationtestGRP_engg Processus de désactivation des numéros de téléphone broadworks terminé pour groupId : Migration du périphérique collabmigrationtestGRP_engg terminée 

Sortie

Après la migration du périphérique, les périphériques sont connectés et prêts à passer/recevoir des appels. Reportez-vous à la figure 15 pour voir un exemple de l'état du périphérique :

Figure 15 : Statut du périphérique

Après la migration du périphérique, les numéros sont devenus actifs. Reportez-vous à la figure 16 pour voir un exemple de numéros actifs :

Figure 16 : Numéros actifs

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

Pour BroadCloud Carrier

Le processus de rétablissement pour les partenaires BroadCloud est le suivant :

1. Ouvrez un ticket auprès du CAT Cisco pour demander la remise en service d’un périphérique.
2. Exécutez l'outil de déplacement du périphérique en mode retour arrière :
   • Les numéros de téléphone ne seront pas attribués à partir de Webex Calling, laissant les utilisateurs et les services uniquement avec des numéros de poste.
   • Les adresses électroniques dans Webex Calling seront renvoyées aux adresses électroniques temporaires.
   • Les téléphones seront supprimés de Webex Calling.
   • Les numéros de téléphone, les adresses électroniques 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 RTCP vers l’opérateur BroadCloud.

Pour Cisco BroadWorks et Webex pour BroadWorks

Le processus de rétablissement pour Cisco BroadWorks et Webex pour BroadWorks est le suivant :

1. Ouvrez un ticket auprès du CAT Cisco pour demander la remise en service d’un périphérique.
2. Exécutez l'outil de déplacement de périphérique en mode retour sur le serveur d'application BroadWorks secondaire pour annuler les migrations de périphériques. Ceci rétablira l’URL DMS sur l’URL DMS du fournisseur de service pour les profils de périphériques dans Cisco BroadWorks et réactivera les numéros de téléphone.
3. L’équipe Webex Calling rétablit l’URL DMS à l’URL DMS du fournisseur de service dans les profils de périphériques 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 RTCP vers Cisco BroadWorks.

Instructions pour exécuter l’outil de déplacement du périphérique en mode retour arrière

Suivez les étapes ci-dessous pour faire fonctionner l'outil de déplacement du périphérique en mode Retour arrière :

Exécutez la commande ci-dessous dans le serveur d'application Cisco BroadWorks secondaire dans le répertoire des outils de déplacement du périphérique :

Rétablir les profils

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

Rétablir les numéros

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -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 du périphérique pour le fonctionnement de retour :

Rétablir les profils

Nom de l'outil : Version de l’outil de déplacement du périphérique : 1.15.0 Outil du périphérique démarré pour le processus de retour en arrière... Périphériques qui peuvent être déplacés de Webex Calling vers BroadWorks : - ------------------------------------------------------------------------------------------------------------------- | Type de périphérique | 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 | ------------------------------------------------------------------------------------------------------------------- Voulez-vous déplacer ces périphériques de Webex Calling vers BroadWorks ? (Oui, Y, Non, N) :  oui Chargement des profils de périphériques pour DMS Cisco MPP LC Processus de reconstruction du périphérique démarré Processus de reconstruction du périphérique terminé avec succès Processus de redémarrage démarré Processus de redémarrage terminé Migration du périphérique terminée avec succès Processus de déprovisionnement 

Rétablir les numéros

Nom de l'outil : Version de l’outil de déplacement du périphérique : 1.15.0 Voulez-vous continuer à renvoyer les numéros à Broadworks ?  ([Y]es ou [N]o) :  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Démarrage retour Activer le processus de numéros de téléphone broadworks a démarré pour groupId : collabmigrationtestGRP_engg Activer le processus de numéros de téléphone broadworks terminé pour groupId : collabmigrationtestGRP_engg Processus d'annulation de la migration du périphérique terminé avec succès