La herramienta de aprovisionamiento creará y asignará automáticamente los teléfonos compatibles a los usuarios en Webex Calling. Los teléfonos marcados “sí” en la columna “Compatible con la herramienta de traslado del dispositivo” también se moverán automáticamente de Cisco BroadWorks o BroadCloud a Webex Calling cuando se ejecute la herramienta de traslado del dispositivo. Los teléfonos marcados como “No” en esa columna necesitan una intervención manual para cambiar la URL de DMS en la plantilla de dispositivo de Cisco BroadWorks o en el propio teléfono.

La última columna proporciona la asignación de modelos de teléfono a la columna “Tipo de dispositivo” del archivo transform-tool/input/newphones.csv. (Consulte la sección Herramienta de transformación de este artículo para obtener más información sobre newphones.csv).

Los administradores de socios ejecutan esta herramienta de utilidad de generador de tokens al menos una vez antes de comenzar a ejecutar las herramientas de migración. La ejecución de esta herramienta es una actividad única después de que la cuenta del socio se incorpora a la solución Wholesale RTM. Esta herramienta permite a los administradores de socios conectarse a través del navegador web para obtener el TOKEN único que se necesita para actualizar a los archivos de configuración del socio para las herramientas de migración.

Requisitos previos

Después de la descarga, extraiga los binarios de la herramienta de migración.

Establezca la ruta del entorno JRE/JDK en token_generator.sh para MAC y token_generator.bat para Windows. Si la ruta JAVA_HOME ya existe, la herramienta la reutilizará.

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

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

Instrucciones para ejecutar

Ejecute el siguiente comando en el terminal dentro del directorio del generador de tokens:

Windows:

token_generator. bat

MacOS:

./token_generator.sh

Salida:

Nombre de la herramienta: Versión de la herramienta generador de tokens: 1.13.0 Cargar la URL en su navegador web: http://localhost:8080 

Abra la URL en el navegador web en la terminal, inicie sesión con las credenciales de administrador de socios para obtener el TOKEN y cópielo para su uso posterior.

Las ilustraciones de la interfaz de usuario se proporcionan a continuación como referencia:

Figura 3: Iniciar sesión con Cisco Webex

Figura 4: Ventana de credenciales

Figura 5: Generación de tokens

Configure los siguientes pasos antes de ejecutar las herramientas de extracción y traslado de dispositivos en el servidor secundario de BroadWorks.

Habilitar la conectividad OCI-P

La herramienta de traslado de dispositivos se comunica con BroadWorks a través de comandos OCI-P. Para habilitar la conectividad OCI-P, siga los pasos a continuación:

Paso 1: Utilice la CLI para configurar la configuración general.

Ejecute el siguiente comando en la CLI para cambiar al directorio GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Ejecute el siguiente comando en la CLI para obtener la GeneralSettings actual:

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

Si su configuración no coincide con lo anterior, utilice el comando establecer para volver a configurar su configuración.

Paso 2: Utilice la CLI para configurar el proxy de OCI.

Cambiar el directorio a proxy de OCI:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Ejecute la siguiente CLI para obtener la configuración actual. Debería ver lo siguiente:

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

Si su configuración no coincide con lo anterior, utilice el comando establecer para volver a configurar su configuración.

Paso 3: Utilice la CLI para configurar el aprovisionamiento de OCI.

Cambio en el directorio de aprovisionamiento:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Ejecute el siguiente comando para obtener la configuración actual de aprovisionamiento de OCI:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> obtener Descripción de la dirección ======================== 127.0.0.1 local como 

Paso 4: Ejecute el siguiente comando en la CLI para verificar que su configuración sea correcta.

 AS_CLI/Maintenance/ManagedObjects> obtenga broadworks y compruebe que su salida se vea bien. Consulte a continuación el resultado de la muestra: AS_CLI/Maintenance/ManagedObjects> obtener broadworks BroadWorks Managed Objects ========================== * Servidor: Identidad..............: COMO versión...............: Rel_21.sp1_1.551 Estado administrativo..: Aplicaciones desbloqueadas *: Nombre Versión Estado administrativo implementado Estado efectivo ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true Desbloqueada Desbloqueada FlashPolicy 21.sp1_1.551 false Desbloqueada Detenida OpenClientServer 21.sp1_1.551 true Desbloqueada Desbloqueada WebContainer 21.sp1_1.551 true Desbloqueada Desbloqueada 4 entradas encontradas. * Aplicaciones alojadas: Nombre Versión 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 entradas encontradas. 

Verificar que el servidor cliente abierto esté implementado y activo

Utilice los siguientes comandos para implementar e iniciar el servidor cliente abierto en el servidor de aplicaciones secundario si no está implementado o no se ha iniciado ya.

Paso 1: Implemente el servidor con el siguiente comando CLI:

AS_CLI/Maintenance/ManagedObjects> implementar la aplicación OpenClientServer

Paso 2: Inicie el servidor con este comando:

AS_CLI/Maintenance/ManagedObjects> iniciar aplicación OpenClientServer

Habilitar la activación de números

Ejecute los siguientes comandos en CLI para habilitar la activación de los números:

Paso 1: Ejecute el comando de actividad de números:

AS_CLI> cd SubscriberMgmt/NumberActivation

Paso 2: Ejecute el comando activación activada:

COMO_CLI> establecer dnMode groupAndUserActivationEnabled

Paso 3: En el mensaje de confirmación, ingrese Y.

Para BroadCloud

La herramienta de extracción está integrada en el portal de proveedores de servicios de BroadCloud. Un administrador del proveedor de servicios puede:

1. Envíe solicitudes de extractos para un máximo de 50 clientes por solicitud.
   La solicitud de extracto no se puede enviar para el mismo cliente más de 10 veces en un día.
2. Descargue el archivo de datos extraídos, en formato ZIP, durante un máximo de 28 días a partir de la fecha de envío de la solicitud.

Las siguientes figuras muestran el portal de proveedores de servicios.

Figura 6: Portal del proveedor de servicios

Figura 7: Portal del proveedor de servicios

Para Cisco BroadWorks y Webex para BroadWorks

1. La herramienta de extracción se ejecuta en el servidor de aplicaciones secundario de Cisco BroadWorks dentro de la red del socio y se conecta a través de OCI-P.
2. La herramienta extrae datos brutos de la empresa, el grupo, los números, los usuarios, los servicios, los dispositivos y los datos de clientes de software de la plataforma Cisco BroadWorks o BroadCloud y envía estos datos a archivos XML que proporcionan las entradas para la herramienta de transformación.

En las siguientes secciones se explica cómo instalar y configurar la herramienta de extracción.

Requisitos previos

1. SCP los binarios de herramientas de extracción en el servidor de aplicaciones de Cisco BroadWorks secundario.
2. SSH al servidor de aplicaciones secundario de Cisco BroadWorks para configurar los requisitos previos y ejecutar la herramienta de extracción.
3. Configure el proveedor de servicios y el ID de grupo para extraer de Cisco BroadWorks en conf/exportTool.yml. Consulte el siguiente fragmento YAML de muestra:

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

4. Asegúrese de que el ID de usuario, la contraseña y el nombre de host secundarios del servidor de aplicaciones de Cisco BroadWorks sean correctos en el archivo conf/partner.cfg:

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Token de actualización del administrador del socio copiado desde la herramienta Generador de tokens. MODO DE_MIGRACIÓN = Los valores compatibles son webex_for_broadworks_to_wholesale. El valor predeterminado es broadworks_to_wholesale. Utilizar webex_for_broadworks_to_wholesale para migraciones de Webex para BroadWorks. 

   La propiedad REFRESH_TOKEN es obligatoria para una migración de Webex for BroadWorks.

5. Modifique la ruta del entorno JDK/JRE en el archivo export.sh si la ruta del entorno JDK/JRE secundaria del servidor de aplicaciones de Cisco BroadWorks es diferente que la del archivo:

   JAVA_HOME=/usr/local/java/java_base

Instrucciones para ejecutar

Ejecute el siguiente comando en el servidor de aplicaciones secundario de Cisco BroadWorks desde el directorio de herramientas de extracción:

./export.sh

Registros de terminal

Los siguientes registros están disponibles en la terminal cuando se exportó correctamente: Ejecución de la herramienta de exportación de datos de BroadSoft:

 Ejecución de la herramienta de exportación de datos de BroadSoft ************************************************ Inicio de la herramienta de exportación v: 1.15.0 Exportación iniciada para SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportación de usuarios para SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportación de usuarios completados para SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportación completada para SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Directorio zip de volcado de exportación: output/20221017223452_Nombre del archivo zip de volcado de exportación de ExportTool:extracted_data_1666060500618.zip Archivo Zip con el nombre extracted_data_1666060500618.zip se ha creado el proceso de creación de archivo ZIP completado Archivos exportados convertidos como archivo ZIP ************************************************** 

Salida

Un archivo ZIP de salida (extracted_data_.zip) estará disponible en el mismo directorio de herramientas de extracción. Utilice el siguiente comando para ver y utilizar el archivo ZIP para la entrada de la herramienta de transformación:

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 17 de octubre 22:34 salida/ drwxrwxr-x 2 bwadmin bwadmin 4096 17 de octubre 22:34 registros/ -rw-rw-r-- 1 bwadmin bwadmin 46341 17 de octubre 22:35 extracted_data_1666060500618.zip 

Esta herramienta de transformación se ejecuta para todas las migraciones. La herramienta de transformación se ejecuta en cualquier computadora, incluido el equipo portátil del administrador del socio, y utiliza las API públicas de Webex. Lee el archivo ZIP de salida de la herramienta de extracción (extracted_data_.zip) como una entrada y transforma el XML sin formato al formato JSON que utiliza la herramienta de aprovisionamiento.

Requisitos previos

Después de descargar y extraer los binarios de las herramientas de migración, configure los siguientes requisitos previos:

1. Configure el TOKEN_REFRESH (token copiado desde la herramienta generador de tokens) y el NOMBRE_DE LA UBICACIÓN_PRINCIPAL_en el archivo conf/partner.cfg:

   ACTUALIZAR_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NOMBRE_DE_PRINCIPAL_UBICACIÓN=Principal 

2. Opcionalmente, defina el ID_de APROVISIONAMIENTO (copiado de la plantilla en Partner Hub) en el archivo conf/partner.cfg:

   APROVISIONAMIENTO_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Para obtener una verificación más completa de la dirección de correo electrónico del cliente, de manera opcional, puede definir el ID_de APROVISIONAMIENTO.
3. Si falta, configure la información que falta en el archivo input/customers.csv (consulte la sección siguiente).
4. Agregue la dirección de correo electrónico del usuario final en el archivo input/users.csv.
5. Si se aprovisionarán nuevos teléfonos, agregue la dirección MAC y la dirección de correo electrónico del nuevo teléfono del usuario al archivo input/newphones.csv. Esto solo es necesario si los administradores de socios desean aprovisionar nuevos teléfonos en llamadas mayoristas.
6. Convierta los centros de llamadas de BroadWorks en CxEssentials mediante el archivo input/cxessentials.csv.
7. De manera opcional, habilite la propiedad MEJORAR_ALL_CALL_CENTERS_A_CX_ESSENTIALS para convertir todos los centros de llamadas a CxEssentials.
8. Utilice el archivo input/locations.csv para proporcionar soporte para la migración de grandes empresas que permite a los administradores migrar las ubicaciones de sus clientes por ubicación
9. De manera opcional, habilite el uso de direcciones MAC desde el encabezado User-Agent (Agente del usuario) del mensaje SIP REGISTER cuando la dirección MAC no esté disponible en el perfil del dispositivo de Cisco BroadWorks. Desmarque la línea "USE"_mac_dirección_de_sip_REGISTER=yes" en el archivo conf/partner.cfg

Completar el archivo input/customers.csv

El archivo input/customers.csv proporciona datos que pueden faltar en Cisco BroadWorks o BroadCloud. Este archivo se puede dejar vacío si toda la información obligatoria ya está disponible. No es necesario rellenar todas las columnas, solo la información que falta es obligatoria.

En la siguiente tabla se explican las columnas más importantes en input/customers.csv.

Instrucciones para ejecutar

Ejecute la herramienta de transformación en cualquier sistema operativo. Utilice los siguientes pasos para ejecutar la herramienta en Windows y macOS:

Windows

Ejecute el siguiente comando para ejecutar la herramienta de transformación en Windows:

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

macOS

Ejecute los siguientes pasos para ejecutar la herramienta de transformación en macOS:

1. Cree un entorno virtual e instale dependencias para ejecutar la herramienta de transformación con Python:

   python3 -m venv venv source venv/bin/activate python3 -m pip solicitudes de instalación python3 -m pip solicitudes de instalación-oauthlib 

2. Ejecute la herramienta transform:

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

Comprobación previa del cliente/usuario

La herramienta Transform realiza llamadas de API a Webex para detectar posibles problemas de aprovisionamiento. De manera predeterminada, validará la dirección y el correo electrónico principal del cliente. Si se especifica el valor de ID de APROVISIONAMIENTO_en el archivo conf/partner.cfg, también validará la información de la ubicación. Los resultados de las comprobaciones previas se incluyen en el informe de excepción.

Además, se pueden añadir los siguientes parámetros opcionales cuando se ejecuta la herramienta de transformación:

comprobación previa

Además de ejecutar la API de comprobación previa para la información del cliente, la herramienta de transformación también ejecutará la API de comprobación previa para los correos electrónicos del suscriptor.

información de verificación previa

De forma predeterminada, solo los errores de comprobación previa (es decir, los problemas que bloquearán el aprovisionamiento) se incluyen en el informe de excepción. La adición de este marcador también incluirá los resultados exitosos de la comprobación previa (p. ej.: si ya existe una organización de Webex, que se puede adjuntar automáticamente).

Registros de terminal

Los siguientes registros en el terminal cuando se transformó con éxito:

Informe de resumen de empresas de BroadWorks que pueden migrarse correctamente: 1 empresas de BroadWorks que no se pueden migrar: 0 usuarios de BroadWorks que pueden migrarse correctamente: 4 usuarios de BroadWorks que no se pueden migrar: 0 teléfonos que se pueden migrar correctamente: 3 teléfonos que no son compatibles con Webex Calling: 0 

Informe de excepción

La herramienta de transformación genera el informe de excepciones dentro del directorio output//exception_report.txt . Puede utilizar este informe para identificar los problemas que afectarán a la migración y solucionarlos en el sistema de Cisco BroadWorks.

Después de modificar los datos del usuario para resolver la excepción, vuelva a ejecutar las herramientas de extracción y transformación con los nuevos datos. El archivo de informe de excepción de ejemplo es el siguiente:

Informe de excepción Martes 18 de octubre 08:12:09 2022 Empresas con la característica de restricción de comunicaciones Recomendación: configurar manualmente el plan de llamadas salientes en Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

Salida

Habrá un archivo JSON de salida (customer.json) disponible en el directorio output// . El archivo customer.json de muestra es el siguiente:

{ "cliente": { "provisioningId": "!!!!!!!!!!REEMPLAZAR_con_PROVISIONINGID!!!!!!!!!!", "paquetes": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "dirección": { "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": { "location": { "name": "Main", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/New_York", "idioma": "en_us", "números": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "suscriptores": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REEMPLAZAR_con_ID DEL CLIENTE!!!!!!!!!!", "correo electrónico": "amareswaranvel+benjaminjack@gmail.com", "paquete": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "enabled": true, "saludo": "PREDETERMINADO" }, "sendUnansweredCalls": { "enabled": true, "saludo": "PREDETERMINADO", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNO", "externalEmail": "engineering17861@mailnator.com" } } } ], "dispositivos": [ { "cisUuid": "!!!!!!!!!!REEMPLAZAR_CON_PERSONID!!!!!!!!!!", "producto": "DMS Cisco 7861", "mac": "CC98914EAAD7" } } }, { "amareswaranvel+lucasoliver@gmail.com": { "suscriptor": { "customerId": "!!!!!!!!!!REEMPLAZAR_CON_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "paquete": "webex_calling", "provisioningParameters": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "enabled": true, "saludo": "PREDETERMINADO" }, "sendUnansweredCalls": { "enabled": true, "saludo": "PREDETERMINADO", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNO", "externalEmail": "engineering16821@mailnator.com" } } } ], "dispositivos": [ { "cisUuid": "!!!!!!!!!!REEMPLAZAR_CON_PERSONID!!!!!!!!!!", "producto": "DMS Cisco 6821", "mac": "5486BCAE7E45" } } }, { "amareswaranvel+leojackson@gmail.com": { "suscriptor": { "customerId": "!!!!!!!!!!REEMPLAZAR_CON_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "paquete": "webex_calling", "provisioningParameters": { "firstName": "Leo", "lastName": "Jackson", "primaryPhoneNumber": "+15205551104", "extension": "1104" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "enabled": true, "saludo": "PREDETERMINADO" }, "sendUnansweredCalls": { "enabled": true, "saludo": "PREDETERMINADO", "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, "saludo": "PREDETERMINADO" }, "sendUnansweredCalls": { "enabled": true, "saludo": "PREDETERMINADO", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNO", "externalEmail": "engineering8811@mailnator.com" } } } ], "dispositivos": [ { "cisUuid": "!!!!!!!!!!REEMPLAZAR_con_PERSONID!!!!!!!!!!", "producto": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "planificaciones": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Portal de voz automatizado", "firstName": "Automatizado", "lastName": "Portal de voz", "languageCode": "en_us", "phoneNumber": "+15205551105", "extensión": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": ["PC Comm - Perfil del dispositivo de Engg"], "connect_client_to_upgrade_to_webex_app": [], "ubicaciones": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

La herramienta de aprovisionamiento puede ejecutarse en cualquier máquina, por lo general (la computadora portátil del administrador del socio), y utiliza las API públicas de Webex. Lee el archivo JSON de salida de la herramienta de transformación (customer.json) como entrada y aprovisionamiento de clientes, ubicaciones, números, usuarios, servicios y dispositivos en la solución RTM para mayoristas de Webex.

Requisitos previos

Configure los siguientes requisitos previos dentro del directorio de herramientas de aprovisionamiento:

1. Instale Java 8, 11 o 17 en la computadora. Java está disponible de muchas fuentes, entre ellas:
   • 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. Después de descargar y extraer los binarios de las herramientas de migración, defina la variable de entorno JAVA_HOME en provisioning_tool.sh para MAC y provisioning_tool.bat para Windows.
3. El archivo partner.cfg:
   • Defina el ID_DE APROVISIONAMIENTO_MAYORISTA y el TOKEN DE ACTUALIZACIÓN_ (Token copiado desde la herramienta generador de tokens). Los administradores de socios deben comunicarse con su equipo de cuentas para obtener el ID de APROVISIONAMIENTO_:

     venta al por mayor_aprovisionamiento_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Defina los CORREOS ELECTRÓNICOS PERMITIR_INVITACIÓN DEL ADMINISTRADOR__en falso si el socio no desea enviar un correo electrónico de bienvenida a los usuarios. El valor predeterminado es verdadero.

4. Utilice la propiedad WEBEX4BWKS_CORREO ELECTRÓNICO_ASUNTO para las migraciones de Webex for BroadWorks para enviar el asunto del correo electrónico de solicitud de cambio de contraseña para los suscriptores de Webex for BroadWorks.
5. Utilice la propiedad WEBEX4BWKS_EMAIL_BODY para las migraciones de Webex for BroadWorks para enviar el cuerpo del correo electrónico de solicitud de cambio de contraseña para los suscriptores de Webex for BroadWorks.

Para migraciones de BroadCloud en la misma región:

1. La herramienta omite los números, los dispositivos y el aprovisionamiento de apariencias de llamadas compartidas.
2. La herramienta crea usuarios y usuarios virtuales con extensión y extensión temporal.

Para las migraciones de BroadCloud, otra región:

1. La herramienta aprovisionará números, dispositivos y apariencias de llamadas compartidas.
2. La herramienta crea usuarios y usuarios virtuales con números de teléfono y extensión reales.
   Todas las migraciones de Europe BroadCloud son a otra región.

Instrucciones para ejecutar

Siga los siguientes pasos para ejecutar la herramienta en Windows y macOS:

Windows

Ejecute los siguientes pasos para ejecutar la herramienta en el sistema operativo Windows:

Para aprovisionar un solo cliente: provision.bat -input= Para aprovisionar varios clientes: provision.bat -input= 

macOS

Ejecute los siguientes pasos para ejecutar la herramienta en macOS:

Para aprovisionar un solo cliente: ./transform.sh -input= Para aprovisionar varios clientes: ./transform.sh -input= 

Requisitos previos para la migración de Webex for BroadWorks

Los administradores de socios deben actualizar su plantilla de incorporación de BroadWorks para las características de coexistencia de Webex para BroadWorks. Consulte la siguiente imagen:

Una vez que se actualice la plantilla de incorporación de Webex para BroadWorks a fin de admitir la migración, solicite al equipo de cuentas de Cisco que habilite la alternancia de características "mayorista-partner-blending-enabled" a nivel de socio. Esto permitirá agregar paquetes mayoristas a las organizaciones existentes de clientes de Webex para BroadWorks durante el aprovisionamiento.

Ejecute la herramienta de aprovisionamiento con un argumento adicional.

Fase de preparación: es la fase predeterminada en la que los administradores pueden aprovisionar a los usuarios de BroadWorks como suscriptor mayorista y continuar con Webex para los usuarios de BroadWorks.

Fase de mantenimiento: es la segunda fase en la que los administradores pueden asignar la licencia mayorista a los usuarios existentes de Webex para BroadWorks. Debe ejecutar la herramienta de aprovisionamiento con un mantenimiento de argumento.

Fase posterior a la migración: Es la fase final en la que los administradores pueden convertir completamente BroadWorks a mayorista. Debe ejecutar la herramienta de aprovisionamiento con un argumento postmigración.

Registros de terminal

A continuación se indican los registros en la terminal cuando el aprovisionamiento es correcto:

Nombre de la herramienta: Versión de la herramienta de aprovisionamiento: 1.15.0 ********** Se inició el procesamiento del archivo: input/customer.json **************** Aprovisionamiento Cliente Esperando a que el cliente external_id_engg_grp1 complete el aprovisionamiento... A la espera de que el cliente external_id_engg_grp1 complete el aprovisionamiento...   Estado del cliente external_id_engg_grp1: aprovisionados Números de aprovisionamiento Usuarios de aprovisionamiento Características del usuario Saludos de aprovisionamiento Planificaciones de aprovisionamiento Dispositivos de aprovisionamiento Apariencias de llamadas compartidas Aprovisionamiento Asistentes automáticos Aprovisionamiento Colas de llamadas Aprovisionamiento Grupos de búsqueda Paginaciones grupales de aprovisionamiento Aprovisionamiento Parques de llamadas Aprovisionamiento Contestaciones de llamadas Aprovisionamiento Portal de voz ********** Archivo completado: input/customer.json **************** 

Se imprimirá una tabla con el número de ubicaciones creadas para cada ejecución:

Salida

La herramienta de aprovisionamiento genera informes de éxito y error dentro de los archivos output/<external_id>/*.success/error . Revise los registros de errores y aciertos de la salida para verificar el aprovisionamiento correcto.

Los administradores de socios pueden verificar el aprovisionamiento del cliente en el portal de Partner Hub y Control Hub. Consulte las siguientes ilustraciones del portal de Partner Hub y Control Hub:

Figura 8: Hub del socio

Figura 9: Control Hub

Figura 10: Dispositivos

Figura 11: Llamadas

Para BroadCloud

En el caso de los socios de BroadCloud, utilice el portal de proveedores de servicios para enviar una solicitud de migración de números, dispositivos y migraciones SCA.

Dentro del portal de proveedores de servicios, una solicitud de migración puede incluir hasta 50 clientes. Se pueden enviar un máximo de 10 solicitudes en un día.

Las siguientes figuras muestran el portal de proveedores de servicios.

Figura 12: Portal del proveedor de servicios

Figura 13: Portal del proveedor de servicios

Para Cisco BroadWorks y Webex para BroadWorks

Para las migraciones de Cisco BroadWorks y Webex para BroadWorks, la herramienta se ejecuta en el servidor de aplicaciones secundario de Cisco BroadWorks dentro de la red del socio y se conecta al AS a través de OCI-P. Utiliza el archivo JSON de salida de la herramienta de transformación (customer.json) como entrada y ejecuta los comandos OCI-P para migrar dispositivos y clientes de software.

Al funcionar con éxito, la herramienta de traslado del dispositivo:

1. Cancele la inscripción de dispositivos de Cisco BroadWorks y regístrelos en venta al por mayor.
2. Los usuarios que utilicen el cliente UC-One redirigirán a la aplicación Webex al iniciar sesión por primera vez.
3. Desactive los números de teléfono de Cisco BroadWorks o elimine los números de teléfono de BroadCloud.
4. Active los números en Mayorista.
5. Cree apariencias de llamadas compartidas en Mayorista para las migraciones de BroadCloud. [Este paso solo se aplica a las migraciones de BroadCloud].

SCP y SSH

1. SCP es la herramienta de traslado del dispositivo al servidor de aplicaciones secundario de Cisco BroadWorks.
2. SSH al servidor de aplicaciones secundario de Cisco BroadWorks para configurar los requisitos previos y ejecutar la herramienta de traslado del dispositivo.

Requisitos previos

1. Configure el TOKEN DE ACTUALIZACIÓN_ (token copiado desde la herramienta generador de tokens) en el archivo conf/partner.cfg:

   ACTUALIZAR_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Asegúrese de que el ID de usuario, la contraseña y el nombre de host secundarios del servidor de aplicaciones de Cisco BroadWorks sean correctos en el archivo conf/deviceMoveTool.conf:

   BROADWORKS_ID_DE USUARIO = administrador BROADWORKS_CONTRASEÑA = administrador BROADWORKS_ORGANIZADOR_NOMBRE = organizador local 

3. Para reenviar correos electrónicos de activación, debe establecer RESEND_INVITATION_EMAILS=true en el archivo conf/partner.cfg.

   Si los administradores desean enviar correos electrónicos de invitación a sus usuarios durante la migración, deben anular el comentario de la propiedad "REENVIAR_INVITATION_EMAILS=true" en el archivo conf/partner.cfg. De lo contrario, la propiedad deberá permanecer sin cambios.

4. Verifique que la ruta del entorno JDK/JRE sea correcta en devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Los administradores pueden utilizar el archivo locations.csv del directorio de entrada para migrar los grupos específicos en lugar de todos los grupos de una empresa.

Teléfonos Polycom

Para mover teléfonos Polycom de Cisco BroadWorks a llamadas mayoristas, un administrador de socios debe crear un archivo de tipo de perfil de dispositivo/identidad nuevo a nivel de sistema en Cisco BroadWorks cada plantilla de dispositivo Polycom. Consulte la figura 14 y cargue el archivo personalizado device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Después de cargar el archivo de dispositivo nuevo, asegúrese de que el archivo recién creado exista a nivel de grupo. Asegúrese también de que el archivo migration_%BWMAC ADDRESS%.cfg no entre en conflicto con ningún archivo existente en su sistema).

Se utiliza internamente por la herramienta de traslado del dispositivo.

El proceso de migración para los teléfonos Polycom:

1. La herramienta de traslado de dispositivos reemplaza el archivo %BWMACADDRESS%.cfg a nivel de dispositivo con polycom_vvx2.cfg. Este archivo se refiere a migration_%BWMACADDRESS%.cfg.
2. Regenere los perfiles de dispositivo a nivel de grupo o de dispositivo.
   Actuar a nivel de grupo o de dispositivo depende de la configuración del parámetro deviceLevelRebuild en el archivo device-move-tool/conf/partner.cfg.
3. La herramienta de traslado del dispositivo solicita al servidor de aplicaciones de Cisco BroadWorks que reinicie los teléfonos a nivel de grupo o de dispositivo.
4. Después de la solicitud de reinicio, los teléfonos Polycom descargan y procesan% BWMACADDRESS%.cfg, que les pide a los teléfonos Polycom que descarguen y procesen migration_%BWMACADDRESS%.cfg, que establece el device.prov.serverName en https://plcm.sipflash.com.
   https://plcm.sipflash.com para la región de EE. UU., otras regiones tienen URL diferentes.
5. El teléfono Polycom descarga %BWMACADDRESS%.cfg desde https://plcm.sipflash.com y será administrado por el DMS de Webex Calling.

Figura 14: Adición de archivo de tipo de perfil de identidad/dispositivo

Instrucciones para ejecutar

Existen dos métodos para invocar el DMT, el primero es invocar a través de un solo cliente a la vez y el otro es ejecutar a través de varios clientes simultáneamente.

La herramienta de traslado de dispositivos se ejecuta desde el servidor de aplicaciones secundario de Cisco BroadWorks dentro del directorio de herramientas de traslado de dispositivos:

Para el traslado de dispositivos de un solo cliente: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Para el traslado de dispositivos de varios clientes: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Además, la herramienta de traslado de dispositivos admite la migración de teléfonos individuales o específicos desde la versión 1.35.0. Use el siguiente comando: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Registros de terminal

A continuación se indican los registros en la terminal cuando se ejecuta con éxito la herramienta de traslado de dispositivos para la migración de dispositivos:

Nombre de la herramienta: Versión de la herramienta Device Move: 1.15.0 Herramienta del dispositivo iniciada... Dispositivos válidos para la migración: ------------------------------------------------------------------------------------------------------------------- | Tipo de dispositivo | Mac | Versión | Correo electrónico | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- ¿Desea migrar todos estos dispositivos? ([Y]es o [N]o) sí Carga de perfiles de dispositivo para DMS Proceso de reconstrucción del dispositivo MPP LC de Cisco Iniciado Proceso de reconstrucción del dispositivo Completado Proceso de reinicio correcto Iniciado Proceso de reinicio Completado Modificando correctamente los perfiles para Business Communicator en collabmigrationtestGRP_engg Se inició el proceso de activación de números de teléfono de Webex para el ID de la organización del cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Se ha completado el proceso de activación de números de teléfono de Webex para el ID de organización del cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Se inició el proceso de desactivar números de teléfono de Broadworks para groupId: collabmigrationtestGRP_engg Se completó el proceso de desactivar números de teléfono de Broadworks para groupId: collabmigrationtestGRP_engg Migración de dispositivos finalizada 

Salida

Después de la migración del dispositivo, los dispositivos están en línea y listos para realizar/recibir llamadas. Consulte la figura 15 para ver un ejemplo del estado del dispositivo:

Figura 15: Estado del dispositivo

Después de la migración del dispositivo, los números están activos. Consulte la figura 16 para ver un ejemplo de qué números están activos:

Figura 16: Números activos

La operación de reversión debe ejecutarse para una empresa a la vez.

Para BroadCloud Carrier

El proceso de revertir para los partners de BroadCloud es el siguiente:

1. Abra un ticket con el TAC de Cisco para solicitar la reversión de un dispositivo.
2. Ejecute la herramienta de traslado del dispositivo en modo de revertir:
   • Se anulará la asignación de los números de teléfono de Webex Calling, lo que dejará a los usuarios y servicios solo con extensiones.
   • Las direcciones de correo electrónico en Webex Calling se revertirán a direcciones de correo electrónico temporales.
   • Los teléfonos se eliminarán de Webex Calling.
   • Los números de teléfono, las direcciones de correo electrónico utilizadas como identificadores alternados y los teléfonos se recrearán en BroadCloud.
   • Se reiniciarán los teléfonos.
3. Los administradores de socios deben mover los números de teléfono de PSTN de nuevo a BroadCloud Carrier.

Para Cisco BroadWorks y Webex para BroadWorks

El proceso de revertir para Cisco BroadWorks y Webex para BroadWorks es el siguiente:

1. Abra un ticket con el TAC de Cisco para solicitar la reversión de un dispositivo.
2. Ejecute la herramienta de traslado de dispositivos en modo de revertir en el servidor de aplicaciones de BroadWorks secundario para revertir las migraciones de dispositivos. Esto restablecerá la URL de DMS en la URL de DMS del proveedor de servicios para los perfiles de dispositivos en Cisco BroadWorks y volverá a activar los números de teléfono.
3. El equipo de Webex Calling establece la URL de DMS en la URL de DMS del proveedor de servicios en los perfiles de dispositivos en Webex Calling.
4. Los administradores de socios deben desactivar o eliminar los números de teléfono en Webex Calling a través del portal de Control Hub.
5. Los administradores de socios deben mover los números de teléfono de PSTN de nuevo a Cisco BroadWorks.

Instrucciones para ejecutar la herramienta de traslado de dispositivos en modo reverso

Siga los pasos a continuación para ejecutar la herramienta de traslado del dispositivo en modo reverso:

Ejecute el siguiente comando en el servidor de aplicaciones secundario de Cisco BroadWorks dentro del directorio de herramientas de traslado de dispositivos:

Revertir perfiles

./devicemove.sh -input=  -revertProfiles

Revertir números

./devicemove.sh -input=  -revertNumbers

Registros de terminal

Obtendremos los siguientes registros en la terminal cuando se ejecute con éxito la herramienta de traslado de dispositivos para la operación de revertir:

Revertir perfiles

Nombre de la herramienta: Versión de la herramienta Device Move: 1.15.0 Herramienta del dispositivo iniciada para el proceso de revertir... Dispositivos que se pueden trasladar de Webex Calling a BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Tipo de dispositivo | Mac | Versión | Correo electrónico | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- ¿Desea mover estos dispositivos de Webex Calling a BroadWorks? (Sí, Y, No, N):  Sí Cargando perfiles de dispositivo para DMS Proceso de reconstrucción del dispositivo MPP LC de Cisco Iniciado Proceso de reconstrucción del dispositivo Completado Proceso de reinicio Iniciado Proceso de reinicio Completado Correctamente Migración del dispositivo Completado para el proceso de desaprovisionamiento 

Revertir números

Nombre de la herramienta: Versión de la herramienta Device Move: 1.15.0 ¿Desea seguir revertiendo los números a Broadworks?  ([Y]es o [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Iniciando reverso Activar el proceso de números de teléfono de broadworks iniciado para groupId: collabmigrationtestGRP_engg Se completó el proceso de activación de números de teléfono de broadworks para groupId: collabmigrationtestGRP_engg El proceso de revertir la migración del dispositivo se completó correctamente