La herramienta de aprovisionamiento creará y asignará automáticamente los teléfonos compatibles a los usuarios de Webex Calling. Los teléfonos marcados con “sí” en la columna “Compatible con la herramienta de migración de dispositivos” también se migrarán automáticamente de Cisco BroadWorks o BroadCloud a Webex Calling cuando se ejecute la herramienta de migración de dispositivos. Los teléfonos marcados con "No" en esa columna requieren 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 correspondencia entre los modelos de teléfono y 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 asociados ejecutan esta herramienta generadora de tokens al menos una vez antes de comenzar a ejecutar las herramientas de migración. El uso de esta herramienta es una actividad que se realiza una sola vez, después de que la cuenta del socio se haya incorporado a la solución Wholesale RTM. Esta herramienta permite a los administradores asociados iniciar sesión a través de un navegador web para obtener el TOKEN único necesario para actualizar los archivos de configuración del socio para las herramientas de migración.

Requisitos previos

Instala Java 8, 11, 17 o 21 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://www.oracle.com/java/technologies/downloads/#java21

Tras la descarga, extraiga los archivos binarios de la herramienta de migración.

Instrucciones para ejecutar

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

Windows:

token_generator.bat

macOS:

./token_generator.sh

Producción:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

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

A continuación se muestran ilustraciones de la interfaz de usuario a modo de 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 mediante comandos OCI-P. Para habilitar la conectividad OCI-P, siga los pasos que se indican a continuación:

Paso 1: Utilice la interfaz de línea de comandos (CLI) para configurar los ajustes generales.

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 configuración general actual:

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

Si su configuración no coincide con la anterior, utilice el comando set para reconfigurar su configuración.

Paso 2: Utilice la interfaz de línea de comandos (CLI) para configurar el proxy OCI.

Cambie el directorio a OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Ejecute la siguiente interfaz de línea de comandos 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 su configuración no coincide con la anterior, utilice el comando set para reconfigurar su configuración.

Paso 3: Utilice la interfaz de línea de comandos (CLI) para configurar el aprovisionamiento de OCI.

Cambiar al 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> get
Address Description
========================
127.0.0.1 local as

Paso 4: Ejecute el siguiente comando en la interfaz de línea de comandos (CLI) para verificar que su configuración sea correcta.

 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.

Verifique que el servidor cliente abierto esté desplegado y activo.

Utilice los comandos que aparecen a continuación para desplegar e iniciar el servidor Open Client en el servidor de aplicaciones secundario, si aún no está desplegado o no se ha iniciado.

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Paso 2: Inicie el servidor con este comando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Habilitar la activación de números

Ejecute los siguientes comandos en la interfaz de línea de comandos (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: Ejecute el comando de activación habilitada:

AS_CLI> set dnMode groupAndUserActivationEnabled

Paso 3: Cuando se le solicite confirmación, ingrese Y.

Para BroadCloud

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

1. Envíe solicitudes de extracción de datos para hasta 50 clientes por solicitud.
   No se puede enviar una solicitud de extracción para el mismo cliente más de 10 veces al día.
2. Descargue el archivo de datos extraído, en formato ZIP, durante un plazo máximo de 28 días a partir de la fecha de envío 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

Solicitud de extracción de CSV

Iniciar solicitud de extracción de CSV

1. Descargue el archivo CSV del cliente.

   Haga clic en el enlace Descargar CSV del cliente en la esquina superior derecha de la sección Iniciar solicitud de extracción de CSV.

2. Editar la lista de clientes

   El administrador puede editar este archivo CSV para incluir únicamente a los clientes para quienes se necesita realizar la extracción de datos.

3. Cargar y enviar

   Tras editarlo, sube el archivo CSV modificado.

   Haga clic en Enviar para iniciar una solicitud de extracción de datos para los clientes listados y sus ubicaciones asociadas.

Iniciar solicitud de extracción para un cliente con archivo CSV de ubicaciones

1. Seleccione el cliente y las ubicaciones de descarga.

   Seleccione un cliente del menú desplegable.

   Descargue el archivo locations.csv correspondiente desde Ver clientes→ pestaña Sitios → Exportar ubicaciones como CSV.

2. Editar el archivo de ubicaciones

   El administrador puede editar el archivo CSV para incluir solo las ubicaciones que desea extraer.

3. Cargar y enviar

   Cargue el archivo locations.csv editado y haga clic en Enviar.

   Únicamente las ubicaciones especificadas para el cliente seleccionado se incluirán en la solicitud de extracción.

Iniciar solicitud de extracción para todos los clientes.

1. Haga clic en Enviar para iniciar una solicitud de extracción para todos los clientes y todas sus ubicaciones bajo el proveedor de servicios actual.

Para Cisco BroadWorks y Webex para BroadWorks

1. La herramienta de extracción se ejecuta en el servidor de aplicaciones Cisco BroadWorks secundario dentro de la red del socio y se conecta a través de OCI-P.
2. La herramienta extrae datos brutos de empresas, grupos, números, usuarios, servicios, dispositivos y clientes de software de la plataforma Cisco BroadWorks o BroadCloud y genera archivos XML que sirven como entrada para la herramienta de transformación.

Las siguientes secciones explican cómo instalar y configurar la herramienta de extracción.

Requisitos previos

1. Copia los archivos binarios de la herramienta de extracción al servidor de aplicaciones secundario Cisco BroadWorks mediante SCP.
2. Conéctese mediante SSH al servidor de aplicaciones secundario 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 el conf/exportTool.yml. Consulte el siguiente fragmento de código YAML de ejemplo:

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

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

   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 propiedad REFRESH_TOKEN es obligatoria para una migración de Webex a BroadWorks.

5. Modificar el JDK/JRE Ruta de entorno en el archivo export.sh si se trata de un servidor de aplicaciones Cisco BroadWorks secundario. JDK/JRE La ruta del entorno es diferente a la del archivo:

   JAVA_HOME=/usr/local/java/java_base

Instrucciones para ejecutar

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

./export.sh

Registros de terminal

Los siguientes registros estarán disponibles en la terminal tras una exportación exitosa: Ejecutando la herramienta de exportación de datos de 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
**************************************************

Salida

Un archivo ZIP de salida (extracted_data_<timestamp>.zip) está disponible en el mismo directorio de la herramienta de extracción. Utilice el siguiente comando para ver y usar el archivo ZIP para la entrada de la herramienta Transformar:

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 el administrador está utilizando la herramienta detrás de un proxy corporativo, siga los pasos que se indican a continuación para configurar y ejecutar el script de exportación.

Pasos para configurar y ejecutar el script de exportación

1. Abra el archivo export.sh.
2. Localice la variable HTTPS_PROXY_HOST y descomentela (elimine el encabezado). #).

3. Establezca el valor HTTPS_PROXY_HOST como:

   HTTPS_PROXY_HOST=

4. Localice la variable HTTPS_PROXY_PORT y descomentela (elimine el encabezado). #).
5. Establezca el valor HTTPS_PROXY_PORT como:

   HTTPS_PROXY_PORT=

6. Guarda y cierra el archivo export.sh.
7. Abra el archivo partner.cfg y agregue los corchetes refresh_tokennecesarios.
8. Verifique que el host, el nombre de usuario y la contraseña de BroadWorks estén configurados correctamente en partner.cfg.
9. Ejecuta el script:

   ./export.sh

Formulario de participación:

La herramienta de extracción (BroadCloud y BroadWorks) ahora genera automáticamente un archivo XLSX consolidado titulado Engagement Form SUA.xlsx durante la ejecución. El archivo ya contiene todos los datos disponibles en las hojas de cálculo pertinentes, lo que ayuda a simplificar y acelerar la cumplimentación por parte de los socios.

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 de administrador de un socio, y utiliza las API públicas de Webex. Lee el archivo ZIP de salida de la herramienta de extracción (extracted_data_<timestamp>.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 TOKEN REFRESH_(Token copiado de la herramienta Generador de tokens) y el NOMBRE_DE_UBICACIÓN PRINCIPAL_en el conf/partner.cfg archivo:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Para obtener una verificación más completa de la dirección de correo electrónico del cliente, puede configurar opcionalmente el ID de_PROVISIONAMIENTO .
3. Configure la información faltante en el input/customers.csv Archivo (ver la siguiente sección) si falta.
4. Agregue la dirección de correo electrónico del usuario final en el input/users.csv archivo.
5. Si se van a configurar nuevos teléfonos, agregue la dirección MAC y la dirección de correo electrónico del nuevo teléfono del usuario a input/newphones.csv archivo. Esto solo es necesario si los administradores asociados desean habilitar nuevos teléfonos para llamadas mayoristas.
6. Convierta los centros de llamadas de BroadWorks en CxEssentials utilizando el input/cxessentials.csv archivo.
7. Opcionalmente, habilite la propiedad UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS para convertir todos los centros de llamadas a CxEssentials.
8. Utilice el input/locations.csv archivo para respaldar la migración de grandes empresas que permite a los administradores migrar las ubicaciones de sus clientes por ubicación
9. Opcionalmente, puede habilitar 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
10. Opcionalmente, habilite las propiedades ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD y ANALOG_USER_TYPE_DISABLE_T38 para configurar la llamada en espera, la música en espera y la desactivación de la configuración T38 para todos los usuarios de tipo analógico.

11. Si desea configurar dispositivos de puerta de enlace genéricos, agregue la dirección MAC del dispositivo y el ID de usuario a la input/genericgateways.csv archivo. Además, indique si el usuario es el propietario PRINCIPAL o un usuario COMPARTIDO (para apariciones de llamadas compartidas). Esto solo es necesario si los administradores asociados planean usar dispositivos de puerta de enlace genéricos en Llamadas Mayoristas.

    Esta función no está disponible para las migraciones de BroadCloud a Wholesale.

12. Para las migraciones de BroadCloud, para convertir todos los usuarios con el tipo de estación de mensajería a voice_mail_group, actualice el archivo conf/rialto_station_type_to_wholesale_package.csv reemplazando el valor de Wholesale Package con voice_mail_group para la fila donde el Rialto Station Type sea messaging.

    Opcionalmente, habilite la propiedad COMMON_VOICE_MAIL_GROUP_PASSCODE en partner.cfg para configurar el PIN predeterminado para los grupos de correo de voz.

    Si esta propiedad no está especificada en partner.cfg, debe proporcionarse por cliente en el archivo customers.csv en la columna commonVoicemailGroupPassCode.

13. Para la migración de contactos comunes a Webex Calling

    Se trata de una mejora para la gestión de contactos comunes a nivel empresarial y de sitio. Estos contactos ahora se pueden migrar como contactos de la organización (Contactos de la organización) o como extensiones virtuales, según la configuración. A continuación encontrará los detalles que le guiarán a través de este proceso de migración.

    Configuración de claves:

    • LISTA DE TELÉFONOS_COMÚN__A_EXTENSIÓN VIRTUAL__INICIO_RANGO

      Se introduce una nueva propiedad, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, en el archivo partner.cfg. Esta propiedad determina cómo se migran los contactos comunes de Rialto a Webex Calling.

    • Sin COMÚN_LISTA DE TELÉFONOS__A_VIRTUAL_EXTENSIÓN_INICIO_RANGO Configurado

      Los contactos comunes se migrarán como contactos de la organización (Contactos de la organización).

      No se requiere ninguna configuración adicional.

      Los contactos siguen estando accesibles a nivel de organización.

    • Con COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurado

      Los contactos comunes se migrarán como extensiones virtuales.

      A cada contacto se le añadirá un número de extensión, y el rango inicial de la extensión se define en la propiedad COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE en partner.cfg.

      Las extensiones virtuales son compatibles tanto a nivel de organización como a nivel de ubicación, dependiendo del alcance del contacto.

14. Habilitar Webex como proveedor predeterminado de grabación de llamadas.

    Este paso solo es necesario al migrar la configuración de grabación de llamadas para usuarios configurados con Dubber a Grabación de llamadas nativa de Cisco en Webex.

    Para habilitar esta opción:

    • En el archivo partner.cfg, configure la siguiente propiedad, DEFAULT_CALL_RECORDING_VENDOR=Webex.
    • Además, utilice la propiedad WEBEX_CALL_RECORDING_STORAGE_REGION para configurar la región de almacenamiento.

      La opción de grabación bajo demanda de BroadCloud no es compatible con Webex Calling. Estos ajustes de grabación de llamadas no se migrarán y aparecerán en el informe de excepciones.

15. Exclusión de determinados números de teléfono de la migración:

    Para excluir números de teléfono específicos del proceso de migración, se debe seguir el siguiente procedimiento de dos pasos utilizando la herramienta de transformación:

    • Ejecute inicialmente la herramienta de transformación por primera vez. Una vez completada, la herramienta generará un archivo llamado telephone_numbers_inventory.csv, ubicado dentro de la output/timestamp/ directorio. El cliente debe revisar este archivo e indicar "Sí" en la columna "Drop Tn's" para cada número de teléfono que deba excluirse de la próxima migración.
    • Después de actualizar el archivo telephone_numbers_inventory.csv con las banderas de exclusión adecuadas, la herramienta de transformación se ejecuta por segunda vez. El archivo actualizado debe pasarse como argumento en el siguiente formato.

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

16. Opcionalmente, configure la propiedad ALLOW_RESTRICT_BY_PARTNER_MODE en OFF para permitir que los administradores de clientes modifiquen la configuración definida por el socio en Control Hub.
17. Para migrar números de teléfono móvil (BroadWorks Mobility) de BroadCloud a Webex Calling

    Esta sección describe la migración de la función BroadWorks Mobility(números móviles de clientes) desde BroadCloud (integración de red móvil) a Wholesale Webex Calling (operador de red móvil Webex Go).

    Requisitos previos- Antes de comenzar el proceso de migración, los administradores de socios deben comunicarse con el equipo de cuentas de Cisco para realizar la configuración del proveedor de PSTN conectado a la nube (CCP) y la lista de operadores personalizados (CCL).

    Se agrega una nueva propiedad, ASIGNAR_NÚMEROS_MÓVILES_A_USUARIOS, al archivo partner.cfg. Habilite esta propiedad para permitir que se asignen y migren números de teléfono móvil a los usuarios.

    • Esta función solo es compatible con las migraciones de BroadCloud a [] Wholesale.
    • En Wholesale Webex, los usuarios finales pueden tener un número de teléfono móvil o un número PSTN (no ambos), a diferencia de BroadCloud.
    • Cuando se asigna un número de teléfono móvil a un usuario, su número PSTN principal se convierte en su número secundario (alternativo).
    • Los números de teléfono móvil no se pueden migrar para los usuarios que se están convirtiendo a Espacios de trabajo o Líneas virtuales.
    • Una vez que se asigna un número de teléfono móvil en Wholesale Webex, aparecerá como Activo en Control Hub. Este estado no significa que el número esté listo para recibir llamadas de inmediato. La función de llamadas estará disponible únicamente una vez que la migración se haya completado por completo.
    • Los ajustes de integración de telefonía móvil configurados por los usuarios finales en el Portal de Usuarios que Realizan Llamadas (CUP) no se migran. Tras la migración, cuando se llame a un número de teléfono fijo, móvil o extensión, todos los dispositivos del usuario sonarán.

18. Para configurar opcionalmente los límites de cantidad de paquetes durante la migración del cliente, especifique la cantidad para cada paquete en el archivo input/package_quantity.csv. La cantidad de paquetes configurada debe ser mayor o igual que el número de user/workspace paquetes asignados.

    Actualmente, no se admiten límites en la cantidad de paquetes para las migraciones de Webex for BroadWorks a Wholesale.

    Al ejecutar la herramienta de transformación, proporcione el archivo actualizado como parámetro de entrada: ./transform.sh -extraer=<extract_zip_file> -packagelimits=input/package_quantity.csv.

19. Migrar sitios de múltiples clientes desde BroadWorks/BroadCloud en un solo cliente en Llamadas Webex al por mayor
    • Se introduce un nuevo modo de ejecución, -consolidatedMigration, en la herramienta Transform para admitir la migración de múltiples sitios de clientes desde Broadcloud/Broadworks a la plataforma mayorista de Webex bajo una única organización de clientes mayoristas. Cuando se habilita este modo, la herramienta consolida varios sitios de clientes en una única organización de clientes mayoristas.

      -consolidatedMigration

    • Existen otros argumentos opcionales que se pueden proporcionar junto con -consolidatedMigration, como por ejemplo:

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

    • Si se proporciona -targetEnterpriseId y el Id existe en el archivo de salida de la herramienta Extract, se utilizará para crear la organización del cliente mayorista y, si no se encuentra el Id, la herramienta recurrirá a cualquier detalle de cliente disponible en el archivo de salida de la herramienta Extract.
    • Si se proporciona -consolidatedExternalId, se establecerá el externalId para el cliente y, si no se proporciona, la herramienta recurrirá al flujo existente para el ID externo.

Llenar el input/customers.csv

El archivo input/customers.csv Proporciona datos que podrían faltar en Cisco BroadWorks o BroadCloud. Este archivo puede dejarse vacío si ya se dispone de toda la información obligatoria. No es necesario rellenar todas las columnas; solo la información que falta es obligatoria.

La tabla a continuación explica las columnas más importantes en input/customers.csv.

Llenar el input/users.csv

El archivo input/users.csv Proporciona datos que podrían faltar en Cisco BroadWorks o BroadCloud. Este archivo puede dejarse vacío si ya se dispone de toda la información obligatoria. No es necesario rellenar todas las columnas; solo la información que falta es obligatoria.

Instrucciones para ejecutar

Ejecute la herramienta de transformación 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 Transformar en Windows:

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

macOS

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

1. Crea un entorno virtual e instala las dependencias necesarias para ejecutar la herramienta de transformación usando 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. Ejecuta la herramienta de transformación:

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

Customer/user control previo

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

Además, al ejecutar la herramienta de transformación se pueden agregar los siguientes parámetros opcionales:

control previo

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

información de verificación previa

Por defecto, solo los errores de verificación previa (es decir, los problemas que bloquearán el aprovisionamiento) se incluyen en el informe de excepciones. Al agregar esta bandera, también se incluirán los resultados de la verificación previa (por ejemplo, si ya existe una organización de Webex que se puede conectar automáticamente).

Registros de terminal

Los siguientes registros aparecen en la terminal tras una transformación exitosa:

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

Informe de excepciones

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

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

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

Salida

Un archivo JSON de salida (customer.json) estará disponible en output/<timestamp>/<groupid> directorio. El archivo de muestra customer.json es el siguiente:

{
    "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"
    }
}

La herramienta de aprovisionamiento puede ejecutarse en cualquier máquina, normalmente el ordenador 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. Instala Java 8, 11, 17 o 21 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://www.oracle.com/java/technologies/downloads/#java21
2. Después de descargar y extraer los binarios de las herramientas de migración, configure la variable de entorno JAVA_HOME en el archivo provisioning_tool.sh para MAC y en el archivo provisioning_tool.bat para Windows.
3. El archivo partner.cfg:
   • Establezca el ID de APROVISIONAMIENTO_DE VENTA_AL POR MAYOR y el TOKEN DE_ACTUALIZACIÓN (Token copiado de la herramienta Generador de tokens). Los administradores asociados deben ponerse en contacto con su equipo de cuentas para obtener el ID de_aprovisionamiento :

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Establezca SEND_SUBSCRIBERS_WELCOME_EMAIL en falso, si los socios no desean enviar un correo electrónico de bienvenida a los usuarios. El valor predeterminado es verdadero.

     Webex solo envía correos electrónicos de bienvenida a los usuarios finales. Los administradores de clientes no reciben correos electrónicos de bienvenida.

     Los usuarios y administradores de clientes con sede en Estados Unidos y Canadá reciben una notificación por correo electrónico independiente de RedSky. La plataforma RedSky E911 envía este correo electrónico para confirmar la creación de la cuenta de cliente para los servicios de emergencia. Este correo electrónico de RedSky es independiente de los correos electrónicos de bienvenida de Webex y no está controlado por la configuración de correo electrónico de Webex. Para las organizaciones mayoristas en EE. UU. y Canadá, RedSky se habilita automáticamente como proveedor de servicios de emergencia.

4. Utilice la propiedad WEBEX4BWKS_EMAIL_SUBJECT para las migraciones de Webex para BroadWorks para enviar el asunto del correo electrónico de solicitud de cambio de contraseña para 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 para los suscriptores de Webex para BroadWorks.
6. Utilice la propiedad CUSTOM_TAGS para agregar etiquetas después de la creación del cliente.
7. Para aplicar descuentos mayoristas, los administradores de socios deben ponerse en contacto con el equipo de cuentas de Cisco antes de que comience la migración.

   Se ha añadido una nueva propiedad, APLICAR__DESCUENTOS AL POR MAYOR, a partner.cfg. Habilitar esta propiedad para aplicar descuentos a usuarios y espacios de trabajo.

Instrucciones para ejecutar

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

Windows

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

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

Siga los siguientes pasos para ejecutar la herramienta en macOS:

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

Requisitos previos para la migración de Webex a BroadWorks

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

Una vez que la plantilla de Webex para la incorporación de BroadWorks se haya actualizado para admitir la migración, solicite al equipo de cuentas de Cisco que habilite la opción "wholesale-partner-blending-enabled" a nivel de socio. Esto permitirá añadir paquetes mayoristas a las organizaciones clientes de Webex para BroadWorks existentes durante el proceso de aprovisionamiento.

Ejecute la herramienta de aprovisionamiento con un argumento adicional.

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

Fase de mantenimiento: Esta es la segunda fase, donde los administradores pueden asignar la licencia mayorista a los usuarios existentes de Webex para BroadWorks. Debe ejecutar la herramienta de aprovisionamiento con el argumento maintenance.

Fase posterior a la migración: Es la fase final en la que los administradores pueden convertir BroadWorks a Wholesale por completo. Debe ejecutar la herramienta de aprovisionamiento con el argumento postmigration.

Registros de terminal

A continuación se muestran los registros en la terminal tras un aprovisionamiento exitoso:

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 ****************

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 la salida /<external_id>/*.success/error archivos. Revise los registros de éxito y error de la salida para verificar que el aprovisionamiento se haya realizado correctamente.

El sistema generará un archivo Provisioning_Report_*.csv en el directorio output/consolidated_reports/. Este archivo contiene detalles tanto de éxito como de fracaso para cada entidad y su configuración, proporcionando un informe de aprovisionamiento completo.

Los administradores asociados 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: Llamadas

Restricciones posteriores al aprovisionamiento

Una vez que se complete el aprovisionamiento para una migración de BroadCloud, las siguientes acciones estarán bloqueadas:

• Portal CAP – Agregar usuarios o dispositivos portados.
• Portal SP – Creación de órdenes ADD con dispositivos o números.
• API RSB – Creación de órdenes ADD con dispositivos o números y creación de usuarios. Los pedidos de RSB ADD realizados con dispositivos o números serán rechazados.

Para BroadCloud

Los socios de BroadCloud deben usar el portal de proveedores de servicios para enviar una solicitud de migración de números, dispositivos y migraciones de apariencias de llamadas compartidas (SCA).

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

Los administradores pueden habilitar la reversión automática configurando ROLLBACK_TO_BROADCLOUD=true en el archivo conf/partner.cfg, lo que mueve los dispositivos de vuelta a BroadCloud después de la migración. Admite migraciones tanto dentro de la misma región como entre regiones diferentes con NS Sync, pero solo para migraciones exitosas. En caso de que la operación falle, los administradores deben contactar con el soporte técnico de Cisco (Cisco TAC) antes de solicitar la reversión.

En el portal hay dos opciones disponibles para seleccionar el tipo de migración:

• Migración – Seleccione esta opción para iniciar una solicitud de migración de números, dispositivos y apariencias de llamadas compartidas (SCA).
• Estado del dispositivo – Seleccione esta opción para ver el estado actual de un dispositivo en BroadCloud y Calling.

Las siguientes figuras muestran el portal del proveedor de servicios.

Figura 12: Portal del proveedor de servicios

Figura 13: Portal del proveedor de servicios

Migrar ubicaciones seleccionadas (opcional)

Para iniciar la migración para un subconjunto específico de ubicaciones enumeradas en el archivo customer.json, incluya un archivo locations.csv con su solicitud. Este archivo CSV debe incluir únicamente las ubicaciones que desea migrar.

Para descargar la lista de sitios activos disponibles, vaya a Ver clientes → Seleccionar un cliente → Exportar ubicaciones como CSV.

Figura 14: Exportar ubicaciones como CSV

Habilitar la opción de números de desconexión

Cuando utilice el mismo troncal SIP para Webex Calling y BroadCloud Carrier, los administradores deben usar la opción Desconectar números. Esto impide que los números de teléfono reciban llamadas entrantes después de la migración en BroadCloud.

Para habilitar esta opción,

1. En el archivo partner.cfg, configure DISCONNECT_NUMBERS_FROM_RIALTO = Sí.
2. Vuelva a ejecutar la herramienta de migración utilizando el mismo archivo customer.json y el archivo partner.cfgactualizado.

Si los números no se desconectan, envíe una solicitud a Cisco TAC.

Para Cisco BroadWorks y Webex para BroadWorks

Para las migraciones de Cisco BroadWorks y Webex for 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 Transform Tool (customer.json) como entrada y ejecuta los comandos OCI-P para migrar dispositivos y clientes de software.

Tras un funcionamiento correcto, la herramienta de desplazamiento del dispositivo hará lo siguiente:

1. Anule el registro de los dispositivos en Cisco BroadWorks y regístrelos 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 elimínelos de BroadCloud.
4. Activar números en Venta al por mayor.
5. Cree apariciones de llamadas compartidas en Wholesale para migraciones a BroadCloud. [This Este paso solo es aplicable a BroadCloud. migrations].

SCP y SSH

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

Requisitos previos

1. Establezca el TOKEN REFRESH_(Token copiado de la herramienta Generador de tokens) en el conf/partner.cfg archivo:

   REFRESH_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 sean correctos en el conf/deviceMoveTool.conf archivo:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

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

4. Verificar el JDK/JRE La ruta del entorno es correcta en devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

Teléfonos Polycom

Para trasladar los teléfonos Polycom de Cisco BroadWorks a Wholesale Calling, un administrador de socios debe crear un nuevo Identity/Device Archivo de tipo de perfil 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. Tras cargar el nuevo archivo del dispositivo, 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 movimiento de dispositivos.

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

1. La herramienta de movimiento de dispositivos reemplaza el archivo %BWMACADDRESS%.cfg en el nivel del dispositivo con polycom_vvx2.cfg. Este archivo hace referencia a migration_%BWMACADDRESS%.cfg.
2. Reconstruya los perfiles de los dispositivos 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 de traslado de 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 solicita a los teléfonos Polycom que descarguen y procesen migration_%BWMACADDRESS%.cfg, que establece device.prov.serverName en https://plcm.sipflash.com.
   https://plcm.sipflash.com Para la región de EE. UU., las URL de otras regiones son diferentes.
5. El teléfono Polycom descarga %BWMACADDRESS%.cfg desde https://plcm.sipflash.com y será administrado por el DMS de llamadas de Webex.

Figura 14: Identity/device agregar archivo de tipo de perfil

Instrucciones para ejecutar

Existen dos métodos para invocar el DMT: el primero consiste en invocarlo a través de un único cliente a la vez, y el segundo, en ejecutarlo a través de varios clientes simultáneamente.

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

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 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=  -macaddress=4CBC4883A6F8,48256741CBE9

Registros de terminal

A continuación se muestran los registros en la terminal tras ejecutar correctamente la herramienta de migración de dispositivos:

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

Salida

Después de la migración de dispositivos, los dispositivos se han conectado y están listos para funcionar. make/receive llamadas. Consulte la figura 15 para ver un ejemplo del estado del dispositivo:

Figura 15: Estado del dispositivo

Tras la migración de los dispositivos, los números se han activado. Consulte la figura 16 para ver un ejemplo de los números que están activos:

Figura 16: Números activos

Si el administrador está utilizando la herramienta detrás de un proxy corporativo, siga los pasos que se indican a continuación para configurar y ejecutar el script devicemove.

Pasos para configurar y ejecutar el script devicemove

1. Abra el archivo devicemove.sh.
2. Localice la variable HTTPS_PROXY_HOST y descomentela (elimine el encabezado). #).

3. Establezca el valor HTTPS_PROXY_HOST como:

   HTTPS_PROXY_HOST=

4. Localice la variable HTTPS_PROXY_PORT y descomentela (elimine el encabezado). #).
5. Establezca el valor HTTPS_PROXY_PORT como:

   HTTPS_PROXY_PORT=

6. Guarda y cierra el archivo devicemove.sh.
7. Abra el archivo partner.cfg y agregue los corchetes refresh_tokennecesarios.
8. Verifique que el host, el nombre de usuario y la contraseña de BroadWorks estén configurados correctamente en partner.cfg.
9. Ejecuta el script:

   ./devicemove.sh

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

Para el operador BroadCloud

Los administradores pueden configurar ROLLBACK_TO_BROADCLOUD=true en conf/partner.cfg para habilitar la reversión automática. Esto permite que los dispositivos regresen a BroadCloud después de una migración exitosa dentro de la misma región o entre regiones diferentes con NS Sync. En caso de migraciones fallidas, póngase en contacto con el soporte técnico de Cisco (Cisco TAC) antes de solicitar la reversión.

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 el soporte técnico de Cisco (Cisco TAC) para solicitar la reversión del dispositivo.
2. Ejecute la herramienta de migración de dispositivos en modo de reversión en el servidor de aplicaciones BroadWorks secundario para revertir las migraciones de dispositivos. Esto restablecerá la URL de DMS a la URL de DMS del proveedor de servicios para los perfiles de dispositivos en Cisco BroadWorks y reactivará los números de teléfono.
3. El equipo de Webex Calling restablece la URL de DMS a la URL de DMS del proveedor de servicios en los perfiles de dispositivo de Webex Calling.
4. Los administradores asociados deben desactivar o eliminar los números de teléfono en Webex Calling a través del portal Control Hub.
5. Los administradores asociados deben transferir los números de teléfono PSTN de vuelta a Cisco BroadWorks.

Instrucciones para ejecutar la herramienta de movimiento de dispositivos en modo inverso.

Siga los pasos que se indican a continuación para ejecutar la herramienta de traslado de dispositivos en modo inverso:

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

Revertir perfiles

./devicemove.sh -input=  -revertProfiles

Revertir números

./devicemove.sh -input=  -revertNumbers

Registros de terminal

Tras ejecutar correctamente la herramienta de reversión del dispositivo, obtendremos los siguientes registros en la terminal:

Revertir perfiles

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

Revertir números

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