Merci pour votre commentaire.

Les téléphones pris en charge seront automatiquement créés et attribués aux utilisateurs Webex Calling via l'outil d'approvisionnement. Les téléphones marqués « Oui » dans la colonne « Supporté par l' outil de déplacement d'appareil » seront également automatiquement transférés de Cisco BroadWorks ou BroadCloud Webex Calling lorsque l'outil de déplacement d'appareil sera exécuté. Les téléphones marqués « Non » dans cette colonne nécessitent une intervention manuelle pour modifier l'URL du DMS dans le modèle d'appareil Cisco BroadWorks ou sur le téléphone lui-même.

La dernière colonne indique le mappage des modèles de téléphones avec 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 générateur de jetons au moins une fois avant de commencer à utiliser les outils de migration. L'utilisation de cet outil se fait une seule fois que le compte partenaire est intégré à la solution Wholesale RTM. Cet outil permet aux administrateurs des partenaires de se connecter via un navigateur Web pour obtenir le TOKEN unique nécessaire à la mise à jour des fichiers de configuration des partenaires pour les outils de migration.

Prérequis

Installez Java 8, 11, 17 ou 21 sur l'ordinateur. Java est disponible auprès 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 fichiers binaires de l'outil de migration.

Instructions pour courir

Exécutez la commande suivante dans le terminal situé dans le répertoire du générateur de jetons :

Windows :

token_generator.bat

MacOS :

./token_generator.sh

Sortie :

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 du terminal, connectez-vous avec les informations d'identification de l'administrateur du 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'identification

Figure 5 : Génération de jetons

Configurez les étapes suivantes, avant d'exécuter les outils d'extraction et de déplacement d'appareils sur le serveur BroadWorks secondaire.

Activez la connectivité OCI-P

L'outil de déplacement de l'appareil communique avec BroadWorks par le biais de commandes OCI-P. Pour activer la connectivité OCI-P, procédez comme suit :

É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 les reconfigurer .

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

Remplacez le répertoire par 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 les reconfigurer .

Étape 3 : Utilisez la CLI pour configurer OCI Provisioning.

Passez au répertoire Provisioning :

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Exécutez la commande suivante pour obtenir les paramètres d'approvisionnement 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 la 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 l'Open Client Server sur le serveur d'applications secondaire s'il n'est pas déployé ou s'il n'a pas encore démarré.

Étape 1 : Déployez le serveur à l'aide de 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 la CLI pour activer les numéros :

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

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, saisissez Y.

Pour BroadCloud

L'outil d'extraction est intégré au portail des fournisseurs de services BroadCloud. L'administrateur d'un fournisseur de services peut :

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

Les chiffres suivants montrent le portail des fournisseurs de services.

Figure 6 : Portail des fournisseurs de services

Figure 7 : Portail des fournisseurs de services

Demande d'extrait CSV

Lancer une demande d'extrait CSV

1. Téléchargez le fichier CSV du client

   Cliquez sur le lien Télécharger le fichier CSV du client en haut à droite de la section Initier une demande d'extrait CSV.

2. Modifier la liste des clients

   L'administrateur peut modifier ce fichier CSV pour n'inclure que les clients pour lesquels l'extrait doit être effectué.

3. Charger et envoyer

   Après le montage, chargez le CSV modifié.

   Cliquez sur Soumettre pour lancer une demande d'extrait pour les clients répertoriés et les succursales qui leur sont associées.

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

1. Sélectionnez les points de vente et de téléchargement

   Choisissez un client dans la liste déroulante.

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

2. Modifier le fichier de localisation

   L'administrateur peut modifier le CSV pour n'inclure que les lieux qu'il souhaite extraire.

3. Charger et envoyer

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

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

Lancer une demande d'extrait pour tous les clients

1. Cliquez sur Soumettre pour lancer une demande d'extrait pour tous les clients et toutes leurs succursales auprès du 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 du réseau partenaire et se connecte via OCI-P.
2. L'outil extrait les données brutes sur l'entreprise, les groupes, les numéros, les utilisateurs, les services, les appareils et les clients logiciels depuis la plateforme Cisco BroadWorks ou BroadCloud et les transmet 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.

Prérequis

1. SCP les fichiers binaires de l'outil d'extraction vers le serveur d'applications Cisco BroadWorks secondaire.
2. Connexion au serveur d'applications secondaire Cisco BroadWorks par connexion SSH pour configurer les prérequis 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 de code YAML suivant :

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

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

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

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

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

   JAVA_HOME=/usr/local/java/java_base

Instructions pour courir

Exécutez la commande suivante sur le serveur d'applications Cisco BroadWorks secondaire depuis le répertoire des outils d'extraction :

./export.sh

Journaux des terminaux

Les journaux suivants sont disponibles sur le terminal en cas d'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_ .zip<timestamp>) est disponible dans le même répertoire d'outils d'extraction. Utilisez la commande suivante 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

Si l'administrateur utilise l'outil d'un proxy d'entreprise, suivez les étapes ci-dessous pour configurer et exécuter le script d'exportation.

Étapes pour configurer et exécuter le script d'exportation

1. Ouvrez le fichier export.sh.
2. Localisez la variable HTTPS_PROXY_HOST et décommentez-la (supprimez le premier #).

3. Définissez la valeur HTTPS_PROXY_HOST comme suit :

   HTTPS_PROXY_HOST=<proxy-host>

4. Localisez la variable HTTPS_PROXY_PORT et décommentez-la (supprimez le premier #).
5. Définissez la valeur HTTPS_PROXY_PORT comme suit :

   HTTPS_PROXY_PORT=<proxy-port>

6. Enregistrez et fermez le fichier export.sh.
7. Ouvrez le fichier partner.cfg et ajoutez le refresh_token requis.
8. Vérifiez que l'hôte, le nom d'utilisateur et le mot de passe BroadWorks sont correctement configurés dans partner.cfg.
9. Exécutez le script :

   ./export.sh

Formulaire de fiançailles :

L'outil d'extraction (BroadCloud et BroadWorks) génère désormais automatiquement un fichier XLSX consolidé intitulé Engagement Form SUA.xlsx lors de l'exécution. Le fichier est prérempli avec toutes les données disponibles sur les feuilles de travail pertinentes, ce qui permet de rationaliser et d'accélérer le recrutement des partenaires.

Cet outil de transformation fonctionne 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_ .zip<timestamp>) en entrée et transforme le XML brut en format JSON utilisé par l'outil de provisioning.

Prérequis

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

1. Définissez le REFRESH_TOKEN (jeton copié depuis l'outil de génération de jetons) et NAME_OF_MAIN_LOCATION dans le fichier conf/partner.cfg :

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Définissez éventuellement le PROVISIONING_ID (copié depuis le modèle de Partner Hub) dans le fichier conf/partner.cfg :

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Pour une vérification plus complète de l'adresse e-mail du client, vous pouvez éventuellement définir le PROVISIONING_ID.
3. Configurez les informations manquantes dans le fichier input/customers.csv (voir section suivante) si elles sont manquantes.
4. Ajoutez l'adresse e-mail de l'utilisateur final dans le fichier input/users.csv.
5. Si de nouveaux téléphones doivent être approvisionnés, ajoutez l'adresse MAC et l'adresse e-mail du nouveau téléphone de l'utilisateur au fichier input/newphones.csv. Cela n'est obligatoire que si les administrateurs partenaires souhaitent fournir de nouveaux téléphones dans Wholesale Calling.
6. Convertissez les centres d'appels BroadWorks en CXEssentials à l'aide du fichier input/cxessentials.csv.
7. Activez éventuellement la propriété UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS pour convertir tous les centres d'appels en CXEssentials.
8. Utilisez le fichier input/locations.csv pour faciliter la migration des grandes entreprises, qui permet aux administrateurs de migrer les sites de leurs clients par localisation
9. Activez éventuellement l'utilisation des adresses MAC depuis l'en-tête User-Agent du message SIP REGISTER lorsque l'adresse MAC n'est pas disponible dans le profil de l' appareil Cisco BroadWorks. Décommentez la ligne USE_MAC_Address_From_SIP_REGISTER=YES dans le fichier conf/partner.cfg
10. 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 les appels en attente, la musique en attente et désactiver les paramètres T38 pour tous les utilisateurs de type analogique.

11. Si vous souhaitez configurer des passerelles génériques, ajoutez l'adresse MAC et l'identifiant utilisateur de l'appareil au fichier input/genericgateways.csv. Indiquez également si l' utilisateur est le propriétaire PRINCIPAL ou un utilisateur PARTAGÉ (pour les appels partagés). Cela n'est nécessaire que si les administrateurs partenaires prévoient d'utiliser des passerelles génériques dans Wholesale Calling.

    Cette fonctionnalité n'est pas disponible pour les migrations entre BroadCloud et Wholesale.

12. Pour les migrations vers BroadCloud, afin de convertir tous les utilisateurs dont le type de station de messagerie est voice_mail_group, mettez à jour le fichier conf/rialto_station_type_to_wholesale_package.csv en remplaçant la valeur du package de vente en gros par voice_mail_group pour la ligne où le type de station Rialto est la messagerie.

    Activez éventuellement la propriété COMMON_VOICE_MAIL_GROUP_PASSCODE dans partner.cfg pour configurer le code PIN par défaut pour les groupes de messagerie vocale.

    Si cette propriété n'est pas spécifiée dans le fichier partner.cfg, elle doit être fournie par client dans le fichier customers.csv, dans la colonne CommonVoiceMailGroupPassCode.

13. Pour la migration des contacts communs vers Webex Calling

    C'est l'amélioration de la gestion des contacts communs au niveau de l'entreprise et du site. Ces contacts peuvent désormais être migrés soit en tant que contacts de l'organisation (contacts de l'organisation ), soit en tant qu'extensions virtuelles, en fonction des paramètres de configuration. Vous trouverez ci-dessous les informations qui vous guideront tout au long de ce processus de migration.

    Configuration des touches :

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Une nouvelle propriété, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, est introduite dans le fichier partner.cfg. Cette propriété détermine la manière dont les contacts courants sont transférés du Rialto vers. Webex Calling

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE n'est pas configuré

      Les contacts courants seront transférés en tant que contacts de l'organisation ( contacts de l'organisation).

      Aucune configuration supplémentaire n'est requise.

      Les contacts restent accessibles au niveau de l'organisation.

    • Avec COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configuré

      Les contacts courants seront migrés sous forme d' extensions virtuelles.

      Un numéro de poste sera ajouté à chaque contact, et la plage de début de l'extension est définie dans la propriété COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE du fichier partner.cfg.

      Les extensions virtuelles sont prises en charge à la fois au niveau de l'organisation et au niveau du site, selon l'étendue du contact.

14. Activez le fournisseur d'enregistrement des appels par défaut sur Webex.

    Cette étape n'est requise que lors de la migration des paramètres d'enregistrement des appels pour les utilisateurs configurés avec Dubber vers l' enregistrement natif des appels Cisco sur Webex.

    Pour activer cette option :

    • Dans le fichier partner.cfg, définissez la propriété suivante, Default_Call_Recording_Vendor=WebEx.
    • De plus, utilisez la propriété WEBEX_CALL_RECORDING_STORAGE_REGION pour configurer la région de stockage.

      L'option d'enregistrement à la demande de BroadCloud n'est pas prise en charge dansWebex Calling. Ces paramètres d'enregistrement des appels ne seront pas migrés et apparaîtront dans le rapport des exceptions.

15. Exclusion de certains numéros de téléphone de la migration :

    Pour exclure des numéros de téléphone spécifiques du processus de migration, il faut suivre la procédure en deux étapes suivante à l'aide de l'outil de transformation :

    • Exécutez d'abord l'outil de transformation pour la première fois. Une fois terminé, l'outil générera un fichier nommé telephone_numbers_inventory.csv, situé dans le répertoire output/timestamp/. Le client doit consulter ce fichier et indiquer « Oui » dans la colonne « Drop Tn » pour chaque numéro de téléphone à exclure lors de la prochaine migration.
    • Après avoir mis à jour le fichier telephone_numbers_inventory.csv avec les indicateurs d'exclusion appropriés, l'outil de transformation est exécuté une deuxième fois. Le fichier mis à jour doit être transmis en argument au format suivant.

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

16. Si vous le souhaitez, définissez la propriété ALLOW_RESTRICT_BY_PARTNER_MODE sur OFF pour permettre aux administrateurs clients de modifier les paramètres définis par les partenaires dans Control Hub.
17. Pour la migration de numéros de téléphone portable (BroadWorks Mobility) de BroadCloud vers Webex Calling

    Cette section décrit la migration de la fonctionnalité BroadWorks Mobility (numéros de téléphone portable des clients) de BroadCloud (intégration du réseau mobile) vers Wholesale Webex Calling (opérateur de réseau mobile Webex Go).

    Prérequis - Avant de commencer le processus de migration, les administrateurs des partenaires doivent contacter l' équipe Cisco Account pour configurer le fournisseur Cloud Connected PSTN (CCP) et la Custom Carrier List (CCL).

    Une nouvelle propriété, ASSIGN_MOBILE_NUMBERS_TO_USERS, a été ajoutée au fichier partner.cfg. Activez cette propriété pour permettre l'attribution et la migration des numéros de téléphone portable aux utilisateurs.

    • Cette fonctionnalité n'est prise en charge que pour les migrations entre Broadcloud et Wholesale.
    • Dans Wholesale Webex, les utilisateurs finaux peuvent avoir un numéro de portable ou un numéro PSTN (pas les deux), contrairement à BroadCloud.
    • Lorsqu'un numéro de portable est attribué à un utilisateur, son numéro PSTN principal devient son numéro secondaire (alternatif).
    • Les numéros de portable ne peuvent pas être transférés pour les utilisateurs qui sont convertis en espaces de travail ou en lignes virtuelles.
    • Une fois qu'un numéro de portable a été attribué dans Wholesale Webex, il apparaît comme actif dans Control Hub. Ce statut ne signifie pas que le numéro est immédiatement prêt à recevoir des appels. La capacité d'appel ne sera disponible qu'une fois la migration terminée.
    • Les paramètres d'intégration des téléphones portables configurés par les utilisateurs finaux sur le Calling User Portal (CUP) ne sont pas migrés. Après la migration, lorsqu'un numéro de téléphone, un numéro de portable ou une extension est appelé, tous les appareils de l'utilisateur sonnent.

18. Pour configurer éventuellement les limites de quantité de colis lors de la migration des clients, spécifiez la quantité pour chaque colis dans le fichier input/package_quantity.csv. La quantité de colis configurée doit être supérieure ou égale au nombre de packages attribués à l' utilisateur/à l'espace de travail.

    Les limites de quantité de colis ne sont actuellement pas prises en charge pour les migrations de Webex for BroadWorks vers Wholesale.

    Lorsque vous exécutez l'outil de transformation, fournissez le fichier mis à jour en tant que paramètre d'entrée :. <extract_zip_file>/transform.sh -extract= -packagelimits=input/package_quantity.csv .

19. Migrer les sites de plusieurs clients de Broadworks/BroadCloud vers un seul client dans Wholesale Webex Calling
    • Un nouveau mode d'exécution, -ConsolidatedMigration, a été introduit dans l'outil Transform pour faciliter la migration de plusieurs sites clients de Broadcloud/Broadworks vers la plateforme Webex Wholesale au sein d'une seule organisation de vente en gros. Lorsque ce mode est activé, l'outil regroupe plusieurs sites clients au sein d'une seule organisation de vente en gros

      -consolidatedMigration

    • D'autres arguments facultatifs peuvent être fournis en plus de -ConsolidatedMigration, tels que

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

    • si -TargetEnterpriseID est donné et que l'identifiant existe dans le fichier de sortie de l' outil d'extraction, il sera utilisé pour créer l'organisation des clients de la vente en gros et si l'identifiant n'est pas trouvé, l'outil utilisera toutes les informations clients disponibles dans le fichier de sortie de l'outil d'extraction.
    • si -ConsolidatedExternalId est donné, il définira l'ExternalID pour le client et s'il n'est pas fourni, l'outil utilisera le flux existant pour l'identifiant externe.
    • <timestamp>Un fichier JSON consolidé (customer.json) sera disponible dans le répertoire output/ /consolidated.

Remplir le fichier input/customers.csv

Le fichier input/customers.csv fournit des données qui manquent peut-être 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ée de remplir toutes les colonnes, seules les informations manquantes sont obligatoires.

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

Remplir le fichier input/users.csv

Le fichier input/users.csv fournit des données qui manquent peut-être 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ée de remplir toutes les colonnes, seules les informations manquantes sont obligatoires.

Instructions pour courir

Exécutez l'outil de transformation sur 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 lancer l'outil de transformation sous Windows :

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

macOS

Suivez 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 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. Lancez l' outil de transformation :

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

Prévérification client/utilisateur

L'outil Transform passe des appels d'API à Webex pour détecter d'éventuels problèmes d'approvisionnement. Par défaut, l'adresse et l'adresse e-mail principale du client seront validées. Si la valeur PROVISIONING_ID est spécifiée dans le fichier conf/partner.cfg, cela validera également les informations de localisation. Les résultats de la prévérification sont inclus dans le rapport d'exception.

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

prévérification

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

precheckinfo

Par défaut, seules les erreurs de prévérification (c'est-à-dire les problèmes qui bloquent l'approvisionnement) sont incluses dans le rapport d'exceptions. L'ajout de ce drapeau inclura également les résultats de la prévérification (par exemple, si une organisation Webex existe déjà, elle peut être automatiquement jointe).

Journaux des terminaux

Les informations suivantes sont enregistrées dans le terminal en cas de réussite de la transformation :

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

Transform Tool génère le rapport des exceptions dans le répertoire output/ /exception_report.txt<timestamp>. 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 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

<timestamp><groupid>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": "!!!!!!!!!!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 d'approvisionnement 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 (customer.json) de sortie de l'outil de transformation en entrée et fournit 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 des outils d'approvisionnement :

1. Installez Java 8, 11, 17 ou 21 sur l'ordinateur. Java est disponible auprès 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 fichiers 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 :
   • Définissez WHOLESALE_PROVISIONING_ID et REFRESH_TOKEN (jeton copié depuis le générateur de jetons). Les administrateurs partenaires doivent contacter l'équipe chargée de leur compte pour obtenir le PROVISIONING_ID :

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Définissez SEND_SUBSCRIBERS_WELCOME_EMAIL sur false, si les partenaires ne veulent pas envoyer d'e-mail de bienvenue aux utilisateurs. La valeur par défaut est True.

     Webex envoie des e-mails de bienvenue uniquement aux utilisateurs finaux. Les administrateurs clients ne reçoivent pas d'e-mails de bienvenue.

     Les utilisateurs et les administrateurs clients basés aux États-Unis et au Canada reçoivent une notification par e-mail distincte de la part de RedSky. La plateforme RedSky E911 envoie cet e-mail pour confirmer la création du compte client pour les services d'urgence. Cet e-mail RedSky est distinct des e-mails de bienvenue de Webex et n'est pas contrôlé par les paramètres de messagerie de Webex. Pour les grossistes aux États-Unis et au Canada, RedSky est automatiquement activé en tant que fournisseur de services d'urgence.

4. Utilisez la propriété WEBEX4BWKS_EMAIL_SUBJECT pour les migrations de Webex pour BroadWorks afin d'envoyer l'objet de l'e-mail de demande de changement de mot de passe aux abonnés de Webex pour BroadWorks.
5. Utilisez la propriété WEBEX4BWKS_EMAIL_BODY pour les migrations de Webex pour BroadWorks afin d'envoyer le corps de l'e-mail de demande de changement de mot de passe aux abonnés de Webex pour BroadWorks.
6. Utilisez la propriété CUSTOM_TAGS pour ajouter des tags après la création du client.
7. Pour appliquer des remises de gros, les administrateurs des partenaires doivent contacter l'équipe chargée des comptes Cisco avant de commencer la migration.

   Une nouvelle propriété, APPLY_WHOLESALE_DISCOUNTS, a été ajoutée à partner.cfg. Activez cette propriété pour appliquer des réductions aux utilisateurs et aux espaces de travail.

8. (Facultatif) Configurez explicitement la connexion PSTN

   Pour spécifier la connexion PSTN pour tous les sites provisionnés lors de la migration, y compris l'emplacement principal, ajoutez la propriété suivante au fichier partner.cfg :

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

   Si la propriété n'est pas configurée ou si elle est commentée, l'outil d'approvisionnement utilise le processus de sélection de la connexion PSTN par défaut.

Instructions pour courir

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

Windows

Suivez les étapes suivantes pour exécuter l'outil sur le système d' exploitation Windows :

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

macOS

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

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

Prérequis pour la migration entre Webex et BroadWorks

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

Une fois le modèle d'intégration de Webex pour BroadWorks mis à jour pour faciliter la migration, demandez à l'équipe chargée des comptes Cisco d'activer la fonction « combinaison de partenaires grossistes » au niveau du partenaire. Ce paramètre permet à l'outil d'approvisionnement d'ajouter automatiquement des packages de vente en gros aux clients Webex for BroadWorks existants pendant le provisionnement.

Lancez l'outil d'approvisionnement avec un argument supplémentaire.

Phase de préparation : c'est la phase par défaut au cours de laquelle les administrateurs peuvent approvisionner les utilisateurs de BroadWorks en tant qu'abonnés Wholesale et continuer à utiliser le Webex pour les utilisateurs de BroadWorks.

Phase de maintenance : c'est la deuxième phase au cours de laquelle les administrateurs peuvent attribuer la licence Wholesale aux utilisateurs existants de Webex for BroadWorks. Vous devez exécuter l'outil de provisionnement avec une maintenance des arguments.

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

Journaux des terminaux

Voici les journaux du terminal indiquant la réussite de l' approvisionnement :

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

Un tableau sera imprimé avec le nombre de places créées pour chaque course :

Sortie

<external_id>L'outil d'approvisionnement génère des rapports de réussite et d'erreur dans les fichiers output/ /*.success/error. Consultez les journaux d'erreurs et de réussite des sorties pour vérifier le bon provisionnement.

Le système générera un fichier Provisioning_Report_*.csv dans le répertoire output/consolidated_reports/. Ce fichier contient des informations sur les réussites et les échecs de chaque entité et de ses paramètres, fournissant ainsi un rapport d'approvisionnement complet.

L'outil d'approvisionnement génère également un fichier Provisioning_Statistics_*.csv dans le répertoire output/consolidated_reports/. Ce rapport contient le nombre de clients, de sites, d'utilisateurs, d'appareils et de fonctionnalités de groupe configurés avec succès ou non.

Les administrateurs partenaires peuvent vérifier l'approvisionnement des clients sur les portails Partner Hub et Control Hub. Reportez-vous aux illustrations suivantes, extraites des portails Partner Hub et Control Hub :

Figure 8 : Partner Hub

Figure 9 : Control Hub

Figure 10 : Appareils

Figure 11 : Appels

Restrictions après l'approvisionnement

Une fois le provisionnement terminé pour une migration vers BroadCloud, les actions suivantes seront bloquées :

• CAP Portal — Ajout d'utilisateurs ou d'appareils transférés.
• SP Portal — Création de commandes ADD à l'aide d'appareils ou de numéros.
• API RSB — Création de commandes ADD à l'aide d'appareils ou de numéros et création d'utilisateurs. Les commandes RSB ADD passées à l'aide d'appareils ou de numéros seront rejetées.

Migration de BroadCloud vers Wholesale — Limitation de l'enregistrement des appareils

Pour les administrateurs partenaires qui migrent des clients de BroadCloud vers Wholesale dans la même région, les appareils peuvent être ajoutés à Wholesale après avoir exécuté l'outil de provisionnement. Cependant, ces appareils ne pourront s'enregistrer sur la plateforme Webex qu'une fois la migration (déplacement de l'appareil) vers la destination correspondante terminée.

Cette limitation ne s'applique pas à :

• Les clients passent de Broadworks/W4b à Wholesale.
• Migrations entre BroadCloud et Wholesale dans différentes régions.

Conseils recommandés

Pour éviter les problèmes d'enregistrement des appareils, effectuez la migration des appareils au niveau de la localisation avant d'essayer d'enregistrer les appareils sur la plateforme Webex pour les migrations entre BroadCloud et Wholesale dans la même région.

Pour BroadCloud

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

Sur le portail des fournisseurs de services, une demande de migration peut inclure jusqu'à 50 clients. Un maximum de 10 demandes peuvent être soumises par jour.

Les administrateurs peuvent activer la restauration automatique en définissant Rollback_to_broadcloud=True dans le fichier conf/partner.cfg, qui redirige les appareils vers BroadCloud après la migration. Il prend en charge les migrations entre des régions identiques et différentes avec NS Sync, mais uniquement pour les migrations réussies. En cas d' échec, les administrateurs doivent émettre un message Cisco TAC avant de demander une annulation.

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

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

Les chiffres suivants montrent le portail des fournisseurs de services.

Figure 12 : Portail des fournisseurs de services

Figure 13 : Portail des fournisseurs de services

Migrer certaines destinations (facultatif)

Pour démarrer la migration pour un sous-ensemble spécifique de sites répertoriés dans le fichier customer.json, incluez un fichier locations.csv dans votre demande. Ce fichier CSV ne devrait répertorier que les destinations que vous avez l'intention de migrer.

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

Figure 14 : Exporter les lieux au format CSV

Activez l'option Numéros de déconnexion

Lorsque vous utilisez le même trunk SIP pour Webex Calling BroadCloud Carrier, les administrateurs doivent utiliser l'option Disconnect Numbers. Cela empêche les numéros de téléphone de recevoir des appels entrants après la migration vers BroadCloud.

Pour activer cette option,

1. Dans le fichier partner.cfg, définissez DISCONNECT_NUMBERS_FROM_RIALTO = yes.
2. Relancez l'outil de migration en utilisant le même fichier customer.json et le fichier partner.cfg mis à jour.

Si les numéros ne parviennent pas à se déconnecter, soumettez une demande de TAC Cisco.

Pour Cisco BroadWorks et Webex pour BroadWorks

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

En cas de fonctionnement réussi, l'outil de déplacement de l'appareil va :

1. Désenregistrez les appareils de Cisco BroadWorks et enregistrez-les dans Wholesale.
2. Les utilisateurs du client UC-One seront redirigés 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 de BroadCloud.
4. Activez les numéros dans Wholesale.
5. Créez des apparences d'appel partagées dans Wholesale pour les migrations vers BroadCloud. [Cette étape ne s' applique qu'aux migrations vers BroadCloud].

6. Si l'administrateur utilise l'outil d'un proxy d'entreprise, suivez les étapes ci-dessous pour configurer et exécuter le script de provisioning.

   Procédure de configuration

   1. Ouvrez le fichier devicemove.sh.
   2. Localisez la variable PROXY_HOST et décommentez-la (supprimez le premier # du fichier devicemove.sh).

   3. Définissez la valeur PROXY_HOST comme suit :

      PROXY_HOST=<proxy-host>

   4. Localisez la variable PROXY_PORT et décommentez-la (supprimez le premier # du fichier devicemove.sh).

   5. Définissez la valeur PROXY_PORT comme suit :

      PROXY_PORT=<proxy-port>

   6. Localisez la variable PROXY_SCHEME et décommentez-la (supprimez le premier # du fichier devicemove.sh). Cette étape est facultative ; si elle reste commentée, la valeur par défaut de PROXY_SCHEME sera HTTP.

   7. Définissez la valeur PROXY_SCHEME comme suit :

      PROXY_SCHEME=<proxy-scheme>

   8. Enregistrez et fermez le fichier devicemove.sh.
   9. Ouvrez le fichier partner.cfg et ajoutez le refresh_token requis.
   10. Vérifiez que l'hôte, le nom d'utilisateur et le mot de passe BroadWorks sont correctement configurés dans partner.cfg

   11. Exécutez le script :

       ./devicemove.sh

SCP et SSH

1. SCP l'outil de déplacement de l'appareil vers le serveur d'applications Cisco BroadWorks secondaire.
2. Connexion par SSH au serveur d'applications secondaire Cisco BroadWorks pour configurer les prérequis et exécuter l'outil de déplacement de périphériques.

Prérequis

1. Définissez le REFRESH_TOKEN (jeton copié depuis l'outil de génération de jetons) dans le fichier conf/partner.cfg :

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Assurez-vous que le nom d'utilisateur, le mot de passe et le nom d'hôte du serveur d'applications Cisco BroadWorks secondaire 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 Send_Subscribers_Welcome_Email=true dans le fichier conf/partner.cfg.

   Si les administrateurs souhaitent envoyer des e-mails d'invitation à leurs utilisateurs pendant la migration, ils doivent supprimer les commentaires de la propriété « Send_Subscribers_Welcome_Email=true » dans le fichier conf/partner.cfg. Sinon, la propriété devrait rester inchangée.

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

   JAVA_HOME=/usr/local/java/java_base

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

Téléphones Polycom

Pour transférer les téléphones Polycom de Cisco BroadWorks vers Wholesale Calling, un administrateur partenaire doit créer un nouveau fichier d'identité/type de profil d'appareil au niveau du système dans Cisco BroadWorks pour chaque modèle d'appareil Polycom. Reportez-vous à la figure 14 et chargez le fichier personnalisé Device-Move-Tool/conf/DeviceProfile/ {region} /polycom_vvx.cfg. Après avoir chargé le nouveau fichier de l'appareil, assurez-vous qu'il existe au niveau du groupe. Assurez-vous également que le fichier Migration_%BWMAC Address%.cfg n'entre en conflit avec aucun fichier existant sur votre système).

Il est utilisé en interne par l'outil Device Move.

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

1. L'outil de déplacement d'appareil remplace le fichier %BWMacAddress%.cfg au niveau de l'appareil par polycom_vvx2.cfg. Ce fichier fait référence à Migration_%BWMacAddress%.cfg.
2. Reconstruisez les profils des appareils au niveau du groupe ou de l'appareil.
   Agir au niveau du groupe ou de l'appareil dépend de la configuration du paramètre DeviceLevelRebuild dans le fichier device-move-tool/conf/partner.cfg.
3. L'outil de déplacement d'appareil demande au serveur d'applications 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 de traiter Migration_%BWMacAddress%.cfg, qui définit Device.Prov.ServerName sur https://plcm.sipflash.com.
   https://plcm.sipflash.com pour les É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 : Ajout d'un fichier d'identité/type de profil d'appareil

Instructions pour courir

Il existe deux méthodes pour invoquer le DMT : la première consiste à l'invoquer par l'intermédiaire d'un seul client à la fois et l'autre à passer par plusieurs clients simultanément.

L'outil de déplacement d'appareils est exécuté depuis le serveur d'applications Cisco BroadWorks secondaire, dans le répertoire des outils de déplacement de périphériques :

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Journaux des terminaux

Voici les informations enregistrées dans le terminal concernant l'utilisation réussie de l'outil Device Move pour la migration des appareils :

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, les appareils sont en ligne et prêts à passer et à recevoir des appels. Reportez-vous à la figure 15 pour voir un exemple de l' état de l'appareil :

Figure 15 : État de l'appareil

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

Figure 16 : Chiffres actifs

Si l'administrateur utilise l'outil d'un proxy d'entreprise, suivez les étapes ci-dessous pour configurer et exécuter le script devicemove.

Étapes pour configurer et exécuter le script DeviceMove

1. Ouvrez le fichier devicemove.sh.
2. Localisez la variable HTTPS_PROXY_HOST et décommentez-la (supprimez le premier #).

3. Définissez la valeur HTTPS_PROXY_HOST comme suit :

   HTTPS_PROXY_HOST=<proxy-host>

4. Localisez la variable HTTPS_PROXY_PORT et décommentez-la (supprimez le premier #).
5. Définissez la valeur HTTPS_PROXY_PORT comme suit :

   HTTPS_PROXY_PORT=<proxy-port>

6. Enregistrez et fermez le fichier devicemove.sh.
7. Ouvrez le fichier partner.cfg et ajoutez le refresh_token requis.
8. Vérifiez que l'hôte, le nom d'utilisateur et le mot de passe BroadWorks sont correctement configurés dans partner.cfg.
9. Exécutez le script :

   ./devicemove.sh

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

Pour BroadCloud Carrier

Les administrateurs peuvent définir Rollback_to_broadcloud=true dans conf/partner.cfg pour activer la restauration automatique. Cela permet de renvoyer les appareils vers BroadCloud après une migration réussie dans la même région ou entre les régions avec NS Sync. En cas d'échec de la migration, Cisco TAC contactez-moi avant de demander une annulation.

Pour Cisco BroadWorks et Webex pour BroadWorks

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

1. Ouvrez un ticket Cisco TAC pour demander le retour à l'appareil.
2. Exécutez l'outil de déplacement d'appareils en mode retour sur le serveur d'applications BroadWorks secondaire pour annuler la migration des appareils. Cela ramènera 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'Webex Callingéquipe redéfinit l'URL du DMS sur celle du fournisseur de services dans les profils des appareils. Webex Calling
4. Les administrateurs partenaires doivent désactiver ou supprimer les numéros de téléphone sur le Webex Calling portail Control Hub.
5. Les administrateurs partenaires doivent retransférer les numéros de téléphone PSTN vers Cisco BroadWorks.

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

Suivez les étapes ci-dessous pour lancer l'outil de déplacement de l'appareil en mode retour :

Exécutez la commande ci-dessous sur le serveur d'applications Cisco BroadWorks secondaire, dans le répertoire des outils de déplacement de périphériques :

Rétablir les profils

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

Inverser les numéros

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

Journaux des terminaux

Nous recevrons les journaux suivants sur le terminal en cas de réussite de l'outil de déplacement de l'appareil pour revenir à l'opération :

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