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

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

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

Requisitos previos

Instale Java 8, 11, 17 o 21 en la computadora. Java está disponible de muchas fuentes, entre ellas:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

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

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:

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 en la terminal, inicie sesión con las credenciales de administrador de socios para obtener el TOKEN y cópielo para su uso posterior.

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

Figura 3: Iniciar sesión con Cisco Webex

Figura 4: Ventana de credenciales

Figura 5: Generación de tokens

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

Habilitar la conectividad OCI-P

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

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

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

Cambiar el directorio a proxy de OCI:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

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

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

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

Cambio en el directorio de aprovisionamiento:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

Paso 4: Ejecute el siguiente comando en la 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.

Verificar que el servidor cliente abierto esté implementado y activo

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

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

AS_CLI/Maintenance/ManagedObjects> 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 CLI para habilitar la activación de los números:

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

AS_CLI> cd SubscriberMgmt/NumberActivation

Paso 2: Ejecute el comando activación activada:

AS_CLI> set dnMode groupAndUserActivationEnabled

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

Para BroadCloud

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

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

Las siguientes figuras muestran el portal de proveedores de servicios.

Figura 6: Portal del proveedor de servicios

Figura 7: Portal del proveedor de servicios

Para Cisco BroadWorks y Webex para BroadWorks

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

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

Requisitos previos

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

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

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

   La REFRESH_TOKEN propiedad 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 secundaria del servidor de aplicaciones de Cisco BroadWorks es diferente que la del archivo:

   JAVA_HOME=/usr/local/java/java_base

Instrucciones para ejecutar

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

./export.sh

Registros de terminal

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

 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) estará disponible en el mismo directorio de herramientas de extracción. Utilice el siguiente comando para ver y utilizar el archivo ZIP para la entrada de la herramienta de transformación:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 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 computadora, incluido el equipo portátil del administrador del socio, y utiliza las API públicas de Webex. Lee el archivo ZIP de salida de la herramienta de extracción (extracted_data_<timestamp>.zip) como una entrada y transforma el XML sin formato al formato JSON que utiliza la herramienta de aprovisionamiento.

Requisitos previos

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

    Si la sincronización de NS está deshabilitada, se omitirá el aprovisionamiento de números de teléfono y dispositivos, y los usuarios obtendrán direcciones de correo electrónico temporales.

Completar el archivo input/customers.csv

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

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

Instrucciones para ejecutar

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

Windows

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

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

macOS

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

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

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

2. Ejecute la herramienta de transformación:

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

Comprobación previa del cliente/usuario

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

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

comprobación previa

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

información de verificación previa

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

Registros de terminal

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

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 excepción

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

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

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

Habrá un archivo JSON de salida (customer.json) disponible en el directorio output/<timestamp>/<groupid> . El archivo customer.json de muestra 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, por lo general (la computadora portátil del administrador del socio), y utiliza las API públicas de Webex. Lee el archivo JSON de salida de la herramienta de transformación (customer.json) como entrada y aprovisionamiento de clientes, ubicaciones, números, usuarios, servicios y dispositivos en la solución RTM para mayoristas de Webex.

Requisitos previos

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

1. Instale Java 8, 11, 17 o 21 en la computadora. Java está disponible de muchas fuentes, entre ellas:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Después de descargar y extraer los binarios de las herramientas de migración, defina la variable de entorno JAVA_HOME en provisioning_tool.sh para MAC y provisioning_tool.bat para Windows.
3. El archivo partner.cfg:
   • Defina el ID_DE APROVISIONAMIENTO_MAYORISTA y el TOKEN DE ACTUALIZACIÓN_ (Token copiado desde la herramienta generador de tokens). Los administradores de socios deben comunicarse con su equipo de cuentas para obtener el ID de APROVISIONAMIENTO_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

4. Utilice la propiedad WEBEX4BWKS_CORREO ELECTRÓNICO_ASUNTO para las migraciones de Webex for BroadWorks para enviar el asunto del correo electrónico de solicitud de cambio de contraseña para los suscriptores de Webex for BroadWorks.
5. Utilice la propiedad WEBEX4BWKS_EMAIL_BODY para las migraciones de Webex for BroadWorks para enviar el cuerpo del correo electrónico de solicitud de cambio de contraseña para los suscriptores de Webex for BroadWorks.
6. La característica de sincronización del servidor de red permite a los administradores aprovisionar números de teléfono, direcciones MAC y direcciones de correo electrónico de los usuarios durante el aprovisionamiento en la misma migración de región. Para habilitarlo, configure USE_NS_SYNC=yes en conf/partner.cfg.

   Si la sincronización de NS está deshabilitada, se omitirá el aprovisionamiento de números de teléfono y dispositivos, y los usuarios obtendrán direcciones de correo electrónico temporales.

Para migraciones de BroadCloud en la misma región:

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

Para las migraciones de BroadCloud, otra región:

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

Instrucciones para ejecutar

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

Windows

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

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

macOS

Ejecute 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 for BroadWorks

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

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

Ejecute la herramienta de aprovisionamiento con un argumento adicional.

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

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

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

Registros de terminal

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

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** 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 los archivos output/<external_id>/*.success/error . Revise los registros de errores y aciertos de la salida para verificar el aprovisionamiento correcto.

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

Figura 8: Hub del socio

Figura 9: Control Hub

Figura 10: Dispositivos

Figura 11: Llamadas

Para BroadCloud

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

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

La característica de sincronización de servidores de red permite a los administradores desactivar la ubicación de BroadCloud y activar la ubicación de Webex Calling al configurar USE_NS_SYNC=yes en el conf/partner.cfg. Después de la migración, los dispositivos y números de teléfono se activan en la ubicación de Webex Calling.

Los administradores pueden habilitar la reversión automatizada configurando ROLLBACK_TO_BROADCLOUD=true en el conf/partner.cfg archivo, lo que mueve los dispositivos de nuevo a BroadCloud después de la migración. Admite migraciones de regiones iguales y diferentes con NS Sync, pero solo para migraciones exitosas. En el caso de los fallidos, los administradores deben crear un TAC de Cisco antes de solicitar la reversión.

Las siguientes figuras muestran el portal de proveedores de servicios.

Figura 12: Portal del proveedor de servicios

Figura 13: Portal del proveedor de servicios

Para Cisco BroadWorks y Webex para BroadWorks

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

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

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

SCP y SSH

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

Requisitos previos

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

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

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

   JAVA_HOME=/usr/local/java/java_base

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

Teléfonos Polycom

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

Se utiliza internamente por la herramienta de traslado del dispositivo.

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

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

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

Instrucciones para ejecutar

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

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

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 indican los registros en la terminal cuando se ejecuta con éxito la herramienta de traslado de dispositivos para la 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 del dispositivo, los dispositivos están en línea y listos para realizar/recibir llamadas. Consulte la figura 15 para ver un ejemplo del estado del dispositivo:

Figura 15: Estado del dispositivo

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

Figura 16: Números activos

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

Para BroadCloud Carrier

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

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

Para Cisco BroadWorks y Webex para BroadWorks

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

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

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

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

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

Revertir perfiles

./devicemove.sh -input=  -revertProfiles

Revertir números

./devicemove.sh -input=  -revertNumbers

Registros de terminal

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

Revertir perfiles

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