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 de l’appareil » seront également automatiquement déplacés de Cisco BroadWorks ou BroadCloud vers Webex Calling lorsque l’outil de déplacement de l’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 « Device type » 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érateur 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 JETON unique nécessaire à la mise à jour des fichiers de configuration partenaires pour les outils de migration.

Predpogoji

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

Définissez le chemin d'environnement JRE/JDK dans 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/"

• Fenêtres : JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Instructions à exécuter

Exécuter la commande suivante dans le terminal à l'intérieur du répertoire générateur de jeton :

Fenêtres :

token_generator.bat

MacOS :

./token_generator.sh

Sortie :

Nom de l’outil : Version de l’outil générateur de jeton : 1.13.0 Charger l'URL dans votre navigateur web : http://localhôte:8080 

Ouvrez l'URL dans le navigateur Web du terminal, connectez-vous avec les identifiants 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 pour référence :

Figure 3 : Se connecter avec Cisco Webex

Figure 4 : Fenêtre Credentials

Figure 5 : Génération de jeton

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

Activer la connectivité OCI-P

L'outil de déplacement de l'appareil communique avec les BroadWorks via les commandes OCI-P, pour activer la connectivité OCI-P, utilisez les étapes suivantes :

Etape 1 : Utiliser le 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 aux paramètres ci-dessus, utilisez la commande set pour reconfigurer vos paramètres.

Etape 2 : Utilisez le CLI pour configurer le proxy OCI.

Changer le répertoire en OCI Proxy :

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Exécutez la CLI suivante pour obtenir les paramètres actuels. Vous devriez voir ce qui suit :

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enableResponseCache = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 messageQueueCapacité = 50 messageQueueTimeoutSeconds = 1800 

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

Etape 3 : Utiliser le CLI pour configurer le provisionnement OCI.

Modification du répertoire Provisioning :

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

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

 AS_CLI/Maintenance/ManagedObjects> obtenez des broadworks et vérifiez que votre sortie est OK. Voir ci-dessous pour la sortie de l'échantillon : AS_CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== * Serveur : Identité..............: AS Version...............: Rel_21.sp1_1.551 Etat administratif.. : Déverrouillé * Applications : Nom 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 entrées trouvées. * Applications hébergées : Nom Version Contexte Chemin Déployé ================================================================== 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'application secondaire s'il n'est pas déployé ou n'a pas déjà démarré.

Etape 1 : Déployer le serveur avec la commande CLI suivante :

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

Etape 2 : Démarrer 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 nombres :

Etape 1 : Exécuter la commande d'activation du nombre :

AS_CLI> cd SubscriberMgmt/NumberActivation

Etape 2 : Exécuter la commande activation activée :

AS_CLI> définir dnMode groupAndUserActivationEnabled

Etape 3 : A l'invite de confirmation, saisir Y.

Pour BroadCloud

L’outil d’extraction est intégré dans le portail BroadCloud Service Provider. Un administrateur de prestataire de services peut :

1. Soumettez des demandes d'extraits pour jusqu'à 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 extrait, au format ZIP, pendant 28 jours maximum à compter de la date de soumission de la demande.

Les figures ci-dessous montrent le portail du Prestataire.

Figure 6 : Portail des prestataires

Figure 7 : Portail des prestataires

Pour Cisco BroadWorks et Webex pour BroadWorks

1. L'outil d'extraction fonctionne sur le serveur d'application secondaire Cisco BroadWorks au sein du réseau partenaire et se connecte via OCI-P.
2. L'outil extrait les données brutes d'entreprise, de groupe, de nombres, d'utilisateurs, de services, d'appareils et de client souple de la plate-forme Cisco BroadWorks ou BroadCloud et produit ces données dans des fichiers XML qui fournissent les entrées de l'outil de transformation.

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

Predpogoji

1. SCP les binaires de l'outil d'extraction vers le serveur d'application secondaire Cisco BroadWorks.
2. SSH vers le serveur d'application secondaire Cisco BroadWorks pour configurer les prérequis et exécuter l'outil d'extraction.
3. Configurez l'identifiant du fournisseur de services et du groupe pour l'extraire de Cisco BroadWorks dans conf/exportTool.yml. Reportez-vous à l’échantillon de snippet YAML ci-dessous :

   PrestataireID-A :      - GroupeID-A1 - GroupeID-A2 - GroupeID-A3 PrestataireID-B :                        - tous 

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = jeton de rafraîchissement de l’administrateur partenaire copié depuis l’outil Token Generator. MIGRATION_MODE = 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 for BroadWorks.

5. Modifier le chemin d'environnement JDK/JRE dans le fichier export.sh si le chemin d'environnement secondaire JDK/JRE de Cisco BroadWorks Application Server 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'application secondaire Cisco BroadWorks à partir du répertoire des outils 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 ************************************************ Outil d'exportation de démarrage v : 1.15.0 Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Export 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 Nom du fichier :extracted_data_1666060500618.zip Fichier zip avec 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 de sortie ZIP (extracted_data_.zip) sera disponible dans le même répertoire d'outils d'extraction. Utilisez la commande ci-dessous pour afficher et utiliser le fichier ZIP pour la saisie 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 est exécuté pour toutes les migrations. L'outil de transformation fonctionne sur n'importe quel ordinateur, y compris l'ordinateur portable administrateur d'un partenaire, et utilise les API Webex Public. Il lit le fichier ZIP (extracted_data_.zip) de sortie de l'outil d'extraction comme une entrée et transforme le XML brut en un format JSON utilisé par l'outil de provisionnement.

Predpogoji

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

1. Définir le REFRESH_TOKEN (token copié depuis l’outil générateur de token) et le NOM_DE L’EMPLACEMENT_PRINCIPAL_dans le fichier conf/partner.cfg :

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NOM_DU_LIEU PRINCIPAL_=Principal 

2. Définir en option l’ID_PROVISIONING (copié depuis le modèle dans Partner Hub) dans le fichier conf/partner.cfg :

   PROVISIONING_ID=YME4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pour obtenir une vérification plus complète de l'adresse e-mail du client, vous pouvez en option définir l'ID_PROVISIONING.
3. Configurer les informations manquantes dans le fichier input/customers.csv (voir la section suivante) si elles sont manquantes.
4. Ajouter l'adresse e-mail de l'utilisateur final dans le fichier input/users.csv.
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 au fichier input/newphones.csv. Ceci n'est requis que si les administrateurs partenaires veulent fournir de nouveaux téléphones dans les appels en gros.
6. Convertissez les centres d'appels BroadWorks en CxEssentials en utilisant le fichier input/cxessentials.csv.
7. En option, activer la propriété UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS pour convertir tous les Call Centers en CxEssentials.
8. Utilisez 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. Activer en option 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écommenter la ligne "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" dans le fichier conf/partner.cfg

Remplissage de l’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 de input/customers.csv.

Instructions à exécuter

Exécutez l'outil de transformation dans n'importe quel système d'exploitation. Utilisez 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 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éer un environnement virtuel et installer 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. Exécuter l'outil transform :

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

Pré-contrôle client/utilisateur

L'outil Transform fait 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 PROVISIONING_ID est spécifiée dans le fichier conf/partner.cfg, elle validera également les informations de localisation. Les résultats du pré-contrôle sont inclus dans le rapport d’exception.

En outre, les paramètres optionnels suivants peuvent être ajoutés lors de l'exécution de l'outil de transformation :

pré-contrôle

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

info précontrôle

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 ce drapeau inclura également les résultats de pré-contrôle réussis (par exemple, si une organisation Webex existe déjà et peut être automatiquement attachée).

Journaux des terminaux

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

Rapport sommaire 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 migrés avec succès : 4 utilisateurs BroadWorks qui ne peuvent pas être migrés : 0 Téléphones pouvant être migrés avec succès : 3 Téléphones non 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, ré-exécuter 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 Communication Barring Feature Recommendation: configurer manuellement le plan d'appel sortant dans 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 :

{ « client » : { « provisioningId » : "!!!!!!!!!!REMPLACER_avec_PROVISIONINGID!!!!!!!!!!", "packages" : [ "webex_calling", "common_area_calling" ], "externalId" : "external_id_engg_grp1", "adresse": { "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 », « 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", "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": "5468 BCAE7E45" } ] } }, { "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_avec_PERSONID!!!!!!!!!!", "produit": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "horaires": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "nom": "Automated Voice Portal", "FirstName": "Automated", "LastName": "Voice Portal", "languageCode": "en_us", "numéro de téléphone": "+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": [], "lieux": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

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

Predpogoji

Configurer les prérequis suivants dans le répertoire des outils de provisionnement :

1. Installez Java 8, 11 ou 17 sur l'ordinateur. Java est disponible à partir de nombreuses sources, y compris:
   • 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, paramétrer la variable d’environnement JAVA_HOME dans provisioning_tool.sh pour MAC et provisioning_tool.bat pour Windows.
3. Le fichier partner.cfg :
   • Définir l’ID_PROVISIONING_WHOLESALE et REFRESH_TOKEN (token copié depuis l’outil générateur de token). Les administrateurs partenaires doivent contacter leur équipe de compte pour obtenir l’ID PROVISIONING_:

     ID_APPROVISIONNEMENT EN GROS_ = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Définissez ALLOW_ADMIN_INVITE_EMAILS à faux, si le partenaire ne souhaite pas envoyer un email de bienvenue aux utilisateurs. La valeur par défaut est vraie.

4. Utilisez la propriété WEBEX4BWKS_EMAIL_SUBJECT for Webex for BroadWorks migrations pour envoyer le sujet email de demande de changement de mot de passe pour Webex for BroadWorks abonnés.
5. Utilisez la propriété WEBEX4BWKS_EMAIL_BODY for Webex for BroadWorks migrations pour envoyer le corps de mail de demande de changement de mot de passe pour les abonnés Webex for BroadWorks.

Pour les migrations BroadCloud dans la même région :

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

Pour les migrations BroadCloud, une autre région :

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

Instructions à exécuter

Utilisez les étapes suivantes pour exécuter l'outil dans Windows et macOS :

Windows

Exécutez les étapes suivantes pour exécuter l'outil sur Windows OS :

Pour mettre à disposition un client unique : provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path> Pour fournir plusieurs clients : provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

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

Pour fournir un client unique: ./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path> Pour fournir plusieurs clients: ./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

Prérequis pour Webex pour la migration de BroadWorks

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

Une fois que le modèle Webex for BroadWorks Onboarding est mis à jour pour prendre en charge la migration, demandez à l'équipe de compte Cisco d'activer la bascule de fonctionnalité « wholesale-partner-blending-enabled » au niveau du partenaire. Cela permettra d'ajouter des paquets Wholesale à Webex existants pour les organisations clientes BroadWorks pendant le provisionnement.

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 fournir les utilisateurs de BroadWorks en tant qu'abonné Wholesale et continuer avec le Webex pour les utilisateurs de BroadWorks.

Phase de maintenance : est la deuxième phase au cours de laquelle les administrateurs peuvent attribuer la licence Wholesale au Webex existant pour les utilisateurs de BroadWorks. Il faut lancer l’outil de provisionnement avec un argument maintenance.

Phase post-migration : Est la phase finale où les administrateurs peuvent convertir complètement les BroadWorks en Wholesale. Vous devez lancer l’outil de provisionnement avec un argument postmigration.

Journaux des terminaux

Voici les journaux dans le terminal lors d'un provisionnement réussi :

Nom de l’outil : Version de l’outil de provisionnement : 1.15.0 ********** Fichier de traitement démarré : input/customer.json Provisionnement **************** Client Attente du client external_id_engg_grp1 pour terminer le provisionnement... En attente du client external_id_engg_grp1 pour terminer le provisionnement...   Statut Client external_id_engg_grp1 : provisionné Numéros de provisionnement Utilisateurs de provisionnement Fonctionnalités utilisateur Provisionnement 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 ********** Fichier complété : 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 à l’intérieur des fichiers output/<external_id>/*.success/error . Examiner les journaux de réussite et d'erreur des sorties pour vérifier la réussite du provisionnement.

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

Figure 8 : Partner Hub

Figure 9 : Nadzorno središče

Figure 10 : Naprave

Figure 11 : Klicanje

Pour BroadCloud

Pour les partenaires BroadCloud, utilisez le portail du fournisseur de services pour soumettre une demande de migration de numéros, d'appareils et de migrations SCA.

Au sein du portail du Prestataire, 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 du Prestataire.

Figure 12 : Portail des prestataires

Figure 13 : Portail des prestataires

Pour Cisco BroadWorks et Webex pour BroadWorks

Pour Cisco BroadWorks et Webex pour les migrations BroadWorks, l'outil fonctionne sur le serveur d'application Cisco BroadWorks secondaire au sein du réseau partenaire et se connecte au 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 périphériques et les clients logiciels.

Une fois l'opération réussie, l'outil de déplacement du dispositif :

1. Déenregistrez les appareils de Cisco BroadWorks et enregistrez-les dans Wholesale.
2. Les utilisateurs utilisant le client UC-One redirigent vers l'application Webex lors de la première connexion.
3. Désactiver les numéros de téléphone de Cisco BroadWorks ou supprimer les numéros de téléphone de BroadCloud.
4. Activer les numéros dans Wholesale.
5. Créer des apparitions d'appels partagés en 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 de l'appareil vers le serveur d'application secondaire Cisco BroadWorks.
2. SSH vers le serveur d'application secondaire Cisco BroadWorks pour configurer les prérequis et exécuter l'outil de déplacement des périphériques.

Predpogoji

1. Paramétrer le REFRESH_TOKEN (Token copié depuis l’outil générateur de token) dans le fichier conf/partner.cfg :

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost 

3. Pour renvoyer les e-mails d’activation, vous devez définir RESEND_INVITATION_EMAILS=true dans le fichier conf/partner.cfg.

   Si les administrateurs souhaitent envoyer des emails d’invitation à leurs utilisateurs pendant la migration, ils doivent décommenter la propriété "RESEND_INVITATION_EMAILS=true" dans le fichier conf/partner.cfg. Dans le cas contraire, le bien doit rester inchangé.

4. Vérifier que le chemin d'environnement JDK/JRE 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 à Wholesale Calling, un administrateur partenaire doit créer un nouveau fichier de type d'identité/profil d'appareil au niveau système dans Cisco BroadWorks chaque modèle d'appareil Polycom. Voir la figure 14 et télécharger 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 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 de l'appareil.

Le processus de migration des téléphones Polycom :

1. L’outil de déplacement du 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 des périphériques au niveau groupe ou au niveau 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ériques demande au serveur d'application Cisco BroadWorks de redémarrer les téléphones au niveau du groupe ou de l'appareil.
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 traiter migration_%BWMACADDRESS%.cfg, qui règle le nomDevice.prov.server sur https://plcm.sipflash.com.
   https://plcm.sipflash.com pour la région US, d'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 : Ajout d'un fichier de type d'identité/profil de périphérique

Instructions à exécuter

Il existe deux méthodes pour invoquer le MNT, la première consiste à invoquer un seul client à la fois et la seconde consiste à passer par plusieurs clients simultanément.

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

Pour le déplacement de périphérique client unique : ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Pour le déplacement de périphérique client multiple : ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json De plus, l'outil de déplacement de périphérique prend en charge la migration de téléphone(s) unique/spécifique(s) à 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 dans le terminal lors de l'exécution réussie de l'outil de déplacement de l'appareil pour la migration de l'appareil :

Nom de l’outil : Version de l'outil de déplacement de l'appareil : 1.15.0 Périphérique Outil démarré... Appareils valides pour la migration : ------------------------------------------------------------------------------------------------------------------- | Type de périphérique | Mac | Version | E-mail | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5468 BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5468 bcae7e45_ | 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 Télé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 Activer le processus de numéros de téléphone webex terminé pour l'ID du client : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Désactiver le processus de numéros de téléphone broadworks démarré pour groupId : collabmigrationtestGRP_engg Désactiver le processus de numéros de téléphone broadworks terminé pour groupId : collabmigrationtestGRP_engg Migration du dispositif terminée 

Sortie

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

Figure 15 : Stanje naprave

Après la migration de l'appareil, les nombres sont devenus actifs. Reportez-vous à la figure 16 pour voir un exemple des nombres actifs :

Figure 16 : Nombres actifs

L'opération de retour 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 avec Cisco TAC pour demander le retour d'un appareil.
2. Exécuter l'outil de déplacement du dispositif en mode retour :
   • Les numéros de téléphone ne seront pas attribués à partir de Webex Calling, laissant aux utilisateurs et aux services des extensions uniquement.
   • Les adresses e-mail dans Webex Calling seront remplacées par des 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 alternatedIds et les téléphones seront recréés dans BroadCloud.
   • Les téléphones seront redémarrés.
3. Les administrateurs partenaires doivent transférer les numéros de téléphone du RTPC à BroadCloud Carrier.

Pour Cisco BroadWorks et Webex pour BroadWorks

Le processus d'inversion pour Cisco BroadWorks et Webex pour BroadWorks est le suivant :

1. Ouvrez un ticket avec Cisco TAC pour demander le retour d'un appareil.
2. Exécutez l'outil de déplacement du périphérique en mode retour sur le serveur d'application BroadWorks secondaire pour revenir sur les migrations du périphérique. Cela réinitialisera l'URL DMS à 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 règle l'URL DMS vers 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 de Webex Calling via le portail Control Hub.
5. Les administrateurs partenaires doivent déplacer les numéros de téléphone du RTPC vers Cisco BroadWorks.

Instructions pour exécuter l'outil de déplacement de l'appareil en mode retour

Suivez les étapes ci-dessous pour exécuter l'outil de déplacement du dispositif en mode retour :

Exécutez la commande ci-dessous dans le serveur d'application Cisco BroadWorks secondaire à l'intérieur du répertoire des outils de déplacement de l'appareil :

Inverser les profils

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -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 l'appareil pour l'opération de retour:

Inverser les profils

Nom de l’outil : Version de l'outil de déplacement de l'appareil : 1.15.0 Outil de périphérique démarré pour le processus de retour... Appareils qui peuvent être déplacés de Webex Calling à BroadWorks : - ------------------------------------------------------------------------------------------------------------------- | Type d'appareil | Mac | Version | E-mail | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5468 BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5468 bcae7e45_ | 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 appareils depuis Webex Calling vers BroadWorks ? (Oui, Y, Non, 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 Completed Successfully Device Migration Completed for Deprovision Process 

Inverser les numéros

Nom de l’outil : Version de l'outil de déplacement de l'appareil : 1.15.0 Voulez-vous continuer à revenir les numéros à Broadworks ?  ([Y]es ou [N]o) :  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Démarrage revert Activer le processus des numéros de téléphone broadworks démarré pour groupId : collabmigrationtestGRP_engg Activer le processus de numéros de téléphone broadworks terminé pour groupId : collabmigrationtestGRP_engg Device Migration Revert processus Terminé avec succès