Herramientas de migración para pasar de BroadWorks, Webex para BroadWorks y BroadCloud a las soluciones RTM para mayoristas

Los administradores de socios ejecutan esta herramienta de utilidad generadora de tokens al menos una vez antes de empezar a ejecutar las herramientas de migración. La ejecución de esta herramienta es una actividad que se realiza una sola vez, una vez que la cuenta del socio se incorpora a la solución RTM Mayorista. Esta herramienta permite a los administradores de los socios conectarse a través de un navegador web para obtener el TOKEN único necesario para actualizar los archivos de configuración de los socios para las herramientas de migración.

Requisitos previos

Tras 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, será reutilizada por la herramienta.

• 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 generadora de tokens: 1.13.0 Cargue la URL en su navegador web: http://localhost:8080 

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

A continuación se presentan, a modo de referencia, las ilustraciones de la interfaz de usuario:

Figura 3: Iniciar sesión con Cisco Webex

Figura 4: Ventana de credenciales

Figura 5: Generación de fichas

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

Activar la conectividad OCI-P

La herramienta de movimiento de dispositivos se comunica con el BroadWorks a través de comandos OCI-P, para habilitar la conectividad OCI-P utilice los siguientes pasos:

Paso 1: Utilice la CLI para configurar los Ajustes Generales.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Ejecute el siguiente comando en CLI para obtener los GeneralSettings actuales:

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

Si sus ajustes no coinciden con los anteriores, utilice el comando set para reconfigurar sus ajustes.

Paso 2: Utilice la CLI para configurar el OCI Proxy.

Cambie el directorio a OCI Proxy:

AS_CLI> cd /Aplicaciones/OpenClientServer/OCIProxy

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

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

Si sus ajustes no coinciden con los anteriores, utilice el comando set para reconfigurar sus ajustes.

Paso 3: Utilice la CLI para configurar OCI Provisioning.

Cambie al directorio de aprovisionamiento:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get Dirección Descripción ======================== 127.0.0.1 local as 

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks y comprueba que el resultado es correcto. A continuación se muestra un ejemplo: AS_CLI/Maintenance/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== * Servidor: Identity..............: AS Version...............: Rel_21.sp1_1.551 Estado Administrativo..: Desbloqueado * Aplicaciones: Nombre Versión Desplegado Estado Administrativo Estado Efectivo ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 true Desbloqueado Desbloqueado FlashPolicy 21.sp1_1.551 false Desbloqueado Detenido OpenClientServer 21.sp1_1.551 true Desbloqueado Desbloqueado WebContainer 21.sp1_1.551 true Desbloqueado Desbloqueado 4 entradas encontradas. * Aplicaciones alojadas: Nombre Versión Contexto Ruta Desplegado ================================================================== 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á desplegado y activo

Utilice los siguientes comandos para desplegar e iniciar el Open Client Server en el servidor de aplicaciones secundario si no está desplegado o no se ha iniciado todavía.

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

AS_CLI/Maintenance/ManagedObjects> desplegar aplicación OpenClientServer

Paso 2: Inicie el servidor con este comando:

AS_CLI/Maintenance/ManagedObjects> iniciar aplicación OpenClientServer

Activar números

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

Paso 1: Ejecuta el comando de activación del número:

AS_CLI> cd SubscriberMgmt/NumberActivation

Paso 2: Ejecuta el comando de activación habilitada:

AS_CLI> set dnMode groupAndUserActivationEnabled

Paso 3: Cuando aparezca el mensaje de confirmación, introduzca Y.

Para BroadCloud

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

1. Envíe solicitudes de extractos de hasta 50 clientes por solicitud.
   No se puede presentar una solicitud de extracto para el mismo cliente más de 10 veces en un día.
2. Descargue el archivo de datos extraído, en formato ZIP, durante un máximo de 28 días a partir de la fecha de presentación de la solicitud.

Las siguientes figuras muestran el portal del Proveedor 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 Cisco BroadWorks dentro de la red de socios y se conecta a través de OCI-P.
2. La herramienta extrae datos sin procesar de empresas, grupos, números, usuarios, servicios, dispositivos y 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 la herramienta de extracción al servidor secundario de aplicaciones Cisco BroadWorks.
2. SSH al servidor secundario de aplicaciones 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 extraerlos de Cisco BroadWorks en conf/exportTool.yml. Consulte el siguiente fragmento de YAML de ejemplo:

   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 del servidor de aplicaciones Cisco BroadWorks secundario son correctos en el archivo conf/partner.cfg:

   BROADWORKS_USUARIO_ID = admin BROADWORKS_CONTRASEÑA = admin BROADWORKS_HOST_NOMBRE = localhost REFRESCAR_TOKEN = Token de actualización del administrador asociado copiado de la herramienta generadora de tokens. MIGRACIÓN_MODO = Los valores admitidos son webex_for_broadworks_to_wholesale. El valor por defecto es broadworks_to_wholesale. Utilice webex_for_broadworks_to_wholesale para Webex para las migraciones de BroadWorks. 

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

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

   JAVA_HOME=/usr/local/java/java_base

Instrucciones para ejecutar

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

./export.sh

Registros de terminales

Los siguientes registros están disponibles en el terminal cuando la exportación se realiza correctamente: Ejecutar la herramienta de exportación de datos 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, Grupo=collabmigrationtestGRP_engg Exportando usuarios para SP=collabmigrationtestSP_engg, Grupo=collabmigrationtestGRP_engg Exportación de usuarios completada para SP=collabmigrationtestSP_engg, Grupo=collabmigrationtestGRP_engg Exportación completada para SP=collabmigrationtestSP_engg, Grupo=collabmigrationtestGRP_engg Exportación completada Directorio Zip de volcado de exportación : output/20221017223452_ExportTool Export Dump Zip Nombre de archivo :extracted_data_1666060500618.zip Se ha creado el fichero ZIP con el nombre extracted_data_1666060500618.zip Proceso de creación del fichero ZIP finalizado Ficheros exportados convertidos a fichero ZIP ************************************************** 

Salida

Un archivo ZIP de salida (extracted_data_.zip) estará disponible en el mismo directorio de la herramienta 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 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 

Esta herramienta de transformación se ejecuta para todas las migraciones. La herramienta de transformación se ejecuta en cualquier ordenador, incluido el 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 entrada y transforma el XML sin procesar en un formato JSON que utiliza la herramienta de aprovisionamiento.

Requisitos previos

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

1. Establezca el REFRESH_TOKEN (Token copiado de la herramienta generadora de tokens) y NAME_OF_MAIN_LOCATION en el archivo conf/partner.cfg:

   REFRESCAR_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NOMBRE_DE_PRINCIPAL_LOCATION=Principal 

2. Opcionalmente, establezca el ID de PROVISIONING_(copiado de la plantilla en Partner Hub) en el archivo conf/partner.cfg:

   PROVISIÓN_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Para obtener una verificación más completa de la dirección de correo electrónico del cliente, puede establecer opcionalmente el ID de PROVISIONING_.
3. Configure la información que falta en el archivo input/customers.csv (véase la sección siguiente) si falta.
4. Añada la dirección de correo electrónico del usuario final en el archivo input/users.csv.
5. Si se van a aprovisionar nuevos teléfonos, añada la dirección mac y la dirección de correo electrónico del nuevo teléfono del usuario al archivo input/newphones.csv. Esto sólo es necesario si los administradores asociados desean aprovisionar nuevos teléfonos en llamadas al por mayor.
6. Convierta los centros de llamadas de BroadWorks en CxEssentials utilizando el archivo input/cxessentials.csv.
7. Opcionalmente, active la propiedad UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS para convertir todos los Call Centers a CxEssentials.
8. Utilice el archivo input/locations.csv para apoyar la migración de grandes empresas que permite a los administradores migrar las ubicaciones de sus clientes por ubicación.
9. Opcionalmente habilite el uso de direcciones MAC del encabezado User-Agent del mensaje SIP REGISTER cuando la dirección MAC no esté disponible en el perfil del dispositivo Cisco BroadWorks. Descomente la línea "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" en el archivo conf/partner.cfg

Rellenar el archivo input/customers.csv

El archivo input/customers.csv proporciona datos que pueden faltar en Cisco BroadWorks o BroadCloud. Este archivo puede dejarse vacío si ya se dispone de toda la información obligatoria. No tiene que rellenar todas las columnas, sólo es obligatoria la información que falta.

La siguiente tabla explica las columnas más importantes de input/customers.csv.

Instrucciones para ejecutar

Ejecute la Herramienta Transform en cualquier sistema operativo. Siga los pasos que se indican a continuación 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 las dependencias para ejecutar la herramienta de transformación utilizando Python:

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

2. Ejecute la herramienta de transformación:

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

Control previo de clientes/usuarios

La herramienta de transformación realiza llamadas API a Webex para detectar posibles problemas de aprovisionamiento. Por defecto, validará la dirección y el correo electrónico principal del cliente. Si se especifica el valor de ID de PROVISIONING_en el archivo conf/partner.cfg, también validará la información de ubicación. Los resultados de la comprobación previa se incluyen en el informe de excepciones.

Además, se pueden añadir los siguientes parámetros opcionales al ejecutar 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 de los suscriptores.

precheckinfo

Por defecto, sólo se incluyen en el informe de excepciones los errores de comprobación previa (es decir, los problemas que bloquearán la provisión). Si se añade este indicador, se incluirán también los resultados satisfactorios de la comprobación previa (por ejemplo, si ya existe una organización Webex que pueda adjuntarse automáticamente).

Registros de terminales

Lo siguiente se registra en el terminal en la transformación exitosa:

Informe resumido Empresas BroadWorks que pueden migrarse con éxito: 1 Empresas BroadWorks que no se pueden migrar: 0 usuarios de BroadWorks que se pueden migrar con éxito: 4 usuarios de BroadWorks que no se pueden migrar: 0 Teléfonos que se pueden migrar con éxito: 3 Teléfonos no compatibles con Webex Calling: 0 

Informe de excepción

Transform Tool genera el reporte de excepción 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 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 ejemplo de archivo de informe de excepciones es el siguiente:

Informe de excepción Tue Oct 18 08:12:09 2022 Empresas con función de bloqueo de comunicaciones Recomendación: configurar manualmente el plan de llamadas salientes en el concentrador de control ________________________________________________________________________________ collabmigrationtestGRP_engg 

Salida

Un archivo JSON de salida (customer.json) estará disponible en el directorio output// . El archivo de ejemplo customer.json es el siguiente:

{ "cliente": { "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": "Grupo de Ingeniería - 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", "paquete": "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", "paquete": "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", "paquete": "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", "paquete": "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": "Portal de voz automatizado", "firstName": "Automatizado", "lastName": "Portal de voz", "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" } } 

La herramienta de aprovisionamiento puede ejecutarse en cualquier máquina, normalmente el (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 aprovisiona los clientes, ubicaciones, números, usuarios, servicios y dispositivos en la solución Webex Wholesale RTM.

Requisitos previos

Configure los siguientes requisitos previos dentro del directorio de la herramienta de aprovisionamiento:

1. Instale Java 8, 11 o 17 en el ordenador. Java está disponible en 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. Tras descargar y extraer los binarios de las herramientas de migración, establezca la variable de entorno JAVA_HOME en los archivos provisioning_tool.sh para MAC y provisioning_tool.bat para Windows.
3. El archivo partner.cfg:
   • Establezca el ID y el TOKEN REFRESH_(Token copiado de la herramienta generadora de tokens) de WHOLESALE_PROVISIONING_. Los administradores de los socios deben ponerse en contacto con su equipo de cuentas para obtener el ID de PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Establezca ALLOW_ADMIN_INVITE_EMAILS en false, si no desea enviar correos electrónicos de bienvenida a los usuarios. El valor por defecto es true.

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

Para las migraciones BroadCloud misma región:

1. La herramienta omitirá el aprovisionamiento de números, dispositivos y apariencias de llamada compartidas.
2. La herramienta creará usuarios y usuarios virtuales con extensión y extensión temporal.

Para las migraciones BroadCloud otra región:

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

Instrucciones para ejecutar

Siga los pasos que se indican a continuación para ejecutar la herramienta en Windows y macOS:

Windows

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

Para abastecer a 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 a Webex para BroadWorks

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

Ejecute la herramienta de aprovisionamiento con un argumento adicional para la migración de Webex para BroadWorks a Wholesale.

Fase de preparación: es la fase predeterminada en la que los administradores pueden aprovisionar a los usuarios de BroadWorks como suscriptores mayoristas y continuar con los usuarios de Webex para 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 argumento maintenance.

Fase posterior a la migración: Es la fase final donde los Administradores pueden convertir el BroadWorks a Mayorista completamente. Debe ejecutar la herramienta de aprovisionamiento con un argumento postmigration.

Registros de terminales

A continuación se muestran los registros en el terminal en el aprovisionamiento con éxito:

Nombre de la herramienta: Versión de la herramienta de aprovisionamiento: 1.15.0 ********** Archivo de procesamiento iniciado : input/customer.json **************** Aprovisionando cliente Esperando a que el cliente external_id_engg_grp1 complete el aprovisionamiento... Esperando a que el cliente external_id_engg_grp1 complete el aprovisionamiento...   Cliente external_id_engg_grp1 estado : aprovisionado Aprovisionamiento de números Aprovisionamiento de usuarios Aprovisionamiento de funciones de usuario Aprovisionamiento de saludos Aprovisionamiento de horarios Aprovisionamiento de dispositivos Aprovisionamiento de apariencias de llamadas compartidas Aprovisionamiento de operadoras automáticas Aprovisionamiento de colas de llamadas Aprovisionamiento de grupos de búsqueda Aprovisionamiento de paginaciones de grupo Aprovisionamiento de aparcamientos de llamadas Aprovisionamiento de descolgados de llamadas Aprovisionamiento de 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 éxito y error de salida para verificar que el aprovisionamiento se ha realizado correctamente.

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

Figura 8: Partner Hub

Figura 9: Control Hub

Figura 10: Dispositivos

Figura 11: Llamando

Para BroadCloud

Para 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.

En el portal de proveedores de servicios, una solicitud de migración puede incluir hasta 50 clientes. Se puede presentar un máximo de 10 solicitudes en un día.

Las siguientes figuras muestran el portal del Proveedor 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 mediante 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 soft.

Si la operación se realiza correctamente, la herramienta de desplazamiento de dispositivos:

1. Dar de baja dispositivos del Cisco BroadWorks y darlos de alta en Wholesale.
2. Los usuarios que utilicen el cliente UC-One serán redirigidos a la aplicación Webex la primera vez que inicien sesión.
3. Desactive los números de teléfono de Cisco BroadWorks o elimine los números de teléfono de BroadCloud.
4. Activar números en Mayorista.
5. Crear apariencias de llamada compartidas en la venta al por mayor para las migraciones BroadCloud. [Este paso sólo es aplicable a las migraciones BroadCloud].

SCP y SSH

1. SCP la herramienta de movimiento de dispositivos al servidor de aplicaciones Cisco BroadWorks secundario.
2. Conéctese mediante SSH al servidor de aplicaciones secundario de Cisco BroadWorks para configurar los requisitos previos y ejecutar la herramienta de traslado de dispositivos.

Requisitos previos

1. Establezca el REFRESH_TOKEN (Token copiado de la herramienta generadora de tokens) en el archivo conf/partner.cfg:

   REFRESCAR_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USUARIO_ID = admin BROADWORKS_CONTRASEÑA = admin BROADWORKS_HOST_NOMBRE = localhost 

3. Compruebe que la ruta de entorno JDK/JRE es correcta en devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

4. 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 trasladar teléfonos Polycom de Cisco BroadWorks a Llamadas al por mayor, un administrador asociado debe crear un nuevo Archivo de tipo de perfil de identidad/dispositivo 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 nuevo archivo de dispositivo, asegúrese de que el archivo recién creado existe a nivel de Grupo. Asegúrese también de que el archivo migration_%BWMAC ADDRESS%.cfg no entra en conflicto con ningún archivo existente en su sistema).

Es utilizado internamente por la herramienta de movimiento de dispositivos.

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

1. La herramienta para mover dispositivos sustituye el archivo %BWMACADDRESS%.cfg a nivel de dispositivo por polycom_vvx2.cfg. Tenga en cuenta que este archivo hace referencia a migration_%BWMACADDRESS%.cfg.
2. Reconstruir los perfiles de dispositivo a nivel de grupo o a nivel de dispositivo.
   Actuar a nivel de grupo o a nivel de dispositivo depende de la configuración del parámetro deviceLevelRebuild en el archivo device-move-tool/conf/partner.cfg.
3. La herramienta para mover dispositivos solicita al servidor de aplicaciones Cisco BroadWorks que reinicie los teléfonos a nivel de grupo o a nivel de dispositivo.
4. Después de la solicitud de reinicio, los teléfonos Polycom descargan y procesan% BWMACADDRESS%.cfg, que 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á gestionado por el DMS de llamadas Webex.

Figura 14: Añadir archivo de tipo de perfil de identidad/dispositivo

Instrucciones para ejecutar

Hay 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 múltiples clientes simultáneamente.

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

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

Registros de terminales

A continuación se muestran los registros en el terminal al ejecutar correctamente la herramienta de movimiento de dispositivos para la migración de dispositivos:

Nombre de la herramienta: Versión de Device Move Tool: 1.15.0 Herramienta de dispositivos 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 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 Activación de números de teléfono webex proceso iniciado para el cliente org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Activar números de teléfono webex proceso completado para el cliente org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c Desactivar números de teléfono de broadworks proceso iniciado para groupId : collabmigrationtestGRP_engg Desactivar números de teléfono de broadworks proceso completado para groupId : collabmigrationtestGRP_engg Migración de dispositivos completada 

Salida

Tras la migración de los dispositivos, éstos se han puesto en línea y están listos para hacer/recibir llamadas. Consulte la figura 15 para ver un ejemplo del estado del dispositivo:

Figura 15: Estado del dispositivo

Tras la migración del dispositivo, los números se han activado. Consulte la figura 16 para ver un ejemplo de números activos:

Figura 16: Números activos

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

Para BroadCloud Carrier

El proceso de reversión para los socios de BroadCloud es el siguiente:

1. Abra un ticket con Cisco TAC para solicitar una reversión del dispositivo.
2. Ejecute la herramienta para mover dispositivos en modo revertir:
   • Los números de teléfono se desasignarán de Webex Calling, dejando a los usuarios y servicios sólo 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 alternatedIds y los teléfonos se volverán a crear en BroadCloud.
   • Los teléfonos se reiniciarán.
3. Los administradores de socios deben mover los números de teléfono PSTN de nuevo a BroadCloud Carrier.

Para Cisco BroadWorks y Webex para BroadWorks

El proceso de reversión para Cisco BroadWorks y Webex para BroadWorks es el siguiente:

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

Instrucciones para ejecutar la herramienta de movimiento de dispositivos en modo revertir

Siga los pasos que se indican a continuación para ejecutar la herramienta para mover dispositivos en modo revertir:

Ejecute el siguiente comando en el servidor secundario de aplicaciones 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 terminales

Obtendremos los siguientes registros en el terminal al ejecutar con éxito la herramienta de movimiento de dispositivos para revertir la operación:

Revertir perfiles

Nombre de la herramienta: Versión de Device Move Tool: 1.15.0 Herramienta de dispositivos iniciada para revertir el proceso... Dispositivos que pueden volver 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 trasladar de nuevo estos dispositivos de Webex Calling a BroadWorks? (Sí, Y, No, N):  Sí Cargando Perfiles de Dispositivo para DMS Cisco MPP LC Proceso de Reconstrucción de Dispositivo Iniciado Proceso de Reconstrucción de Dispositivo Completado con Éxito Proceso de Reinicio Iniciado Proceso de Reinicio Completado con Éxito Migración de Dispositivo Completada para Proceso de Desprovisión 

Revertir números

Nombre de la herramienta: Versión de Device Move Tool: 1.15.0 ¿Quieres seguir revirtiendo números a Broadworks?  ([S]i o [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Iniciando proceso de revertir Activar números de teléfono de broadworks iniciado para groupId : collabmigrationtestGRP_engg Activar números de teléfono de broadworks proceso completado para groupId : collabmigrationtestGRP_engg Migración de Dispositivos Proceso de Reversión Completado con Éxito