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

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 generadora 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 RTM mayorista. Esta herramienta permite a los administradores de socios iniciar sesión a través del navegador web para obtener el TOKEN único que se necesita para actualizar los archivos de configuración de socios para las herramientas de migración.

Requisitos previos

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

• 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 la terminal dentro del directorio del generador de tokens:

Windows:

token_generator.bat

Sistema operativo Mac:

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

A continuación se muestran las ilustraciones de la interfaz de usuario 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 movimiento de dispositivos en el servidor secundario BroadWorks.

Habilitar la conectividad OCI-P

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

Paso 1: Utilice la CLI para configurar los ajustes generales.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Ejecute el siguiente comando en CLI para obtener 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 CLI para configurar el proxy OCI.

Cambie el directorio a OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

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

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

Paso 3: Utilice la 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 de aprovisionamiento de OCI actual:

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

Paso 4: Ejecute el siguiente comando en 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 Open Client Server en el servidor de aplicaciones secundario si no está implementado o aún no se ha iniciado.

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 activación de número:

AS_CLI> cd SubscriberMgmt/NumberActivation

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

AS_CLI> set dnMode groupAndUserActivationEnabled

Paso 3: En la solicitud de confirmación, ingrese Y.

Para BroadCloud

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

1. Envíe solicitudes de extracto para hasta 50 clientes por solicitud.
   La solicitud de extracto no se puede enviar para el mismo cliente más de 10 veces al día.
2. Descargue el archivo de datos extraídos, en formato ZIP, hasta 28 días después 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. Descargar el 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 solo los clientes para quienes se debe realizar la extracción.

3. Subir y enviar

   Después de editar, cargue el CSV modificado.

   Haga clic en Enviar para iniciar una solicitud de extracto para los clientes enumerados y sus ubicaciones asociadas.

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

1. Seleccionar ubicaciones de clientes y descargas

   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 CSV para incluir solo las ubicaciones que desea extraer.

3. Subir y enviar

   Sube el archivo places.csv editado y haz clic en Enviar.

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

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 sin procesar de empresas, grupos, números, usuarios, servicios, dispositivos y clientes blandos 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.

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

Requisitos previos

1. SCP: la herramienta de extracción de binarios al servidor de aplicaciones secundario Cisco BroadWorks.
2. Acceda por 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 muestra de YAML:

   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 secundario de Cisco BroadWorks sean correctos. 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 para BroadWorks.

5. Modificar el JDK/JRE Ruta del entorno en el archivo export.sh si el 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 secundario Cisco BroadWorks desde el directorio de la herramienta de extracción:

./export.sh

Registros de terminales

Los siguientes registros están disponibles en la terminal tras una exportación exitosa: 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) está disponible en el mismo directorio de la herramienta de extracción. Utilice el siguiente comando para ver y utilizar el archivo ZIP para la entrada de la herramienta de transformación:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

Esta herramienta de transformación se ejecuta para todas las migraciones. La herramienta de transformación se ejecuta en cualquier computadora, incluida la computadora portátil del 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 es utilizado por 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. Establezca el REFRESH_TOKEN (Token copiado de la herramienta Generador de tokens) y el NOMBRE_DE LA_UBICACIÓN PRINCIPAL_en el conf/partner.cfg archivo:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opcionalmente, configure el ID de PROVISIONING_(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 APROVISIONAMIENTO_.
3. Configurar la información faltante en el input/customers.csv archivo (ver 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 aprovisionar 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 es necesario solo 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 uso de input/cxessentials.csv archivo.
7. Opcionalmente, habilite la propiedad ACTUALIZAR_TODOS__CENTROS DE LLAMADAS_A_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. Habilite opcionalmente el uso de direcciones MAC desde el 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 archivo conf/partner.cfg
10. La función de sincronización del servidor de red permite a los administradores proporcionar números de teléfono, direcciones MAC y direcciones de correo electrónico de los usuarios durante la provisión 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 recibirán direcciones de correo electrónico temporales.

11. Habilite opcionalmente las propiedades ANALÓGICO_USUARIO_TIPO_HABILITAR [_LLAMADA_EN ESPERA, ANALÓGICO_USUARIO_TIPO_HABILITAR_MÚSICA_EN ESPERA_y ANALÓGICO_USUARIO_TIPO_DESHABILITAR_T38 para configurar la llamada en espera, la música en espera y deshabilitar las configuraciones T38 para todos los usuarios de tipo analógico.

Llenando el input/customers.csv

El archivo input/customers.csv Proporciona datos que pueden faltar en Cisco BroadWorks o BroadCloud. Este archivo puede dejarse vacío si toda la información obligatoria ya está disponible. No es necesario que complete todas las columnas, sólo es obligatoria la información que falta.

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

Llenando el input/users.csv

El archivo input/users.csv Proporciona datos que pueden faltar en Cisco BroadWorks o BroadCloud. Este archivo puede dejarse vacío si toda la información obligatoria ya está disponible. No es necesario que complete todas las columnas, sólo es obligatoria la información que falta.

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:

Ventanas

Ejecute el siguiente comando para ejecutar la herramienta 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 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. Ejecute la herramienta de transformación:

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

Customer/user comprobación previa

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

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

comprobación previa

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.

precheckinfo

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

Registros de terminales

Los siguientes registros 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 excepción

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

Después de modificar los datos del usuario para resolver la excepción, vuelva a ejecutar las herramientas de extracción y transformación con los nuevos datos. El archivo de informe de excepción de muestra 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 (generalmente 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 aprovisiona los clientes, las ubicaciones, los números, los usuarios, los servicios y los dispositivos en la solución Webex Wholesale RTM.

Requisitos previos

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

1. Instale Java 8, 11, 17 o 21 en la computadora. Java está disponible en muchas fuentes, incluidas:
   • 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 provisioning_tool.sh para MAC y provisioning_tool.bat para Windows.
3. El archivo partner.cfg:
   • Establezca el ID DE APROVISIONAMIENTO_MAYORISTA_y el TOKEN DE ACTUALIZACIÓN_(token copiado de la herramienta Generador de tokens). Los administradores de socios deben comunicarse con su equipo de cuenta para obtener el ID de PROVISIONING_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Establezca PERMITIR_ADMINISTRADORES_INVITADOS_CORREOS ELECTRÓNICOS 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_EMAIL_SUBJECT para las migraciones de Webex for BroadWorks para enviar el asunto del correo electrónico de solicitud de cambio de contraseña a 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 a los suscriptores de Webex for BroadWorks.
6. La función de sincronización del servidor de red permite a los administradores proporcionar números de teléfono, direcciones MAC y direcciones de correo electrónico de los usuarios durante la provisión 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 recibirán direcciones de correo electrónico temporales.

Para migraciones de BroadCloud misma región:

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

Para migraciones de BroadCloud otra región:

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

Instrucciones para ejecutar

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

Ventanas

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 a BroadWorks

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

Una vez que la plantilla de incorporación de Webex para BroadWorks se actualice para admitir la migración, solicite al equipo de cuentas de Cisco que habilite la función "combinación de socios mayoristas habilitada" en el nivel de socio. Esto permitirá que se agreguen paquetes mayoristas a las organizaciones de clientes existentes 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 suscriptores mayoristas 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 argumento mantenimiento.

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 un argumento postmigration.

Registros de terminales

A continuación se muestran los registros en la terminal sobre el aprovisionamiento exitoso:

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

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

Figura 8: Partner Hub

Figura 9: Control Hub

Figura 10: Dispositivos

Figura 11: Llamando

Para BroadCloud

Para los socios de BroadCloud, utilice el portal del proveedor de servicios para enviar una solicitud de migración de números, dispositivos y 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.

La función de sincronización del servidor 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 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 automática configurando ROLLBACK_TO_BROADCLOUD=true en el archivo conf/partner.cfg, que mueve los dispositivos nuevamente a BroadCloud después de la migración. Admite migraciones de la misma región o de regiones diferentes con NS Sync, pero solo para migraciones exitosas. En el caso de que falle, los administradores deben generar un TAC de Cisco antes de solicitar la reversión.

Hay dos opciones disponibles para seleccionar el tipo de migración en el portal:

• 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 de un subconjunto específico de ubicaciones enumeradas en el archivo customer.json, incluya un archivo locations.csv con su solicitud. Este CSV debe incluir únicamente las ubicaciones que desea migrar.

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

Figura 14: Exportar ubicaciones como CSV

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 Cisco BroadWorks secundario 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.

Tras una operación exitosa, la herramienta de movimiento del dispositivo hará lo siguiente:

1. Anular el registro de dispositivos de Cisco BroadWorks y registrarlos en Wholesale.
2. Los usuarios que utilicen el cliente UC-One serán redirigidos a la aplicación Webex la primera vez que inicien sesión.
3. Desactive los números de teléfono de Cisco BroadWorks o elimine los números de teléfono de BroadCloud.
4. Activar números en Mayoreo.
5. Cree apariencias de llamadas compartidas en Wholesale para migraciones de BroadCloud. [This Este paso solo se aplica a BroadCloud migrations].

SCP y SSH

1. SCP: la herramienta de movimiento de dispositivos al servidor de aplicaciones Cisco BroadWorks secundario.
2. Acceda por SSH al servidor de aplicaciones secundario Cisco BroadWorks para configurar los requisitos previos y ejecutar la herramienta de movimiento del dispositivo.

Requisitos previos

1. Establezca el REFRESH_TOKEN (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 secundario de Cisco BroadWorks sean correctos. 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 RESEND_INVITACIÓN_EMAILS=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 la casilla "REENVIAR_INVITACIÓN_EMAILS=true" propiedad en el conf/partner.cfg archivo. De lo contrario, la propiedad deberá permanecer inalterada.

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 location.csv del directorio de entrada para migrar grupos específicos en lugar de todos los grupos de una empresa.

Teléfonos Polycom

Para mover los teléfonos Polycom de Cisco BroadWorks a Wholesale Calling, un administrador de socios debe crear una nueva Identity/Device Archivo de tipo de perfil en el nivel del sistema en Cisco BroadWorks cada plantilla de dispositivo Polycom. Consulte la figura 14 y cargue el archivo personalizado device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Después de cargar el nuevo archivo del dispositivo, asegúrese de que el archivo recién creado exista en el 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).

Lo utiliza internamente la herramienta de movimiento del dispositivo.

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

1. La herramienta de movimiento de dispositivo reemplaza el archivo %BWMACADDRESS%.cfg en el nivel del dispositivo con polycom_vvx2.cfg. Este archivo hace referencia a migration_%BWMACADDRESS%.cfg.
2. Reconstruir los perfiles del 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 movimiento de dispositivos solicita al servidor de aplicaciones 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 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., 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: Identity/device agregar archivo de tipo de perfil

Instrucciones para ejecutar

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

La herramienta de movimiento de dispositivos se ejecuta desde el servidor de aplicaciones Cisco BroadWorks secundario dentro del directorio de la herramienta de movimiento 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 terminales

A continuación se muestran los registros en la terminal sobre la ejecución exitosa de la herramienta de movimiento 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 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

Después de la migración del dispositivo, los números se volvieron 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 el operador BroadCloud

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

1. Abra un ticket con Cisco TAC para solicitar la reversión de un dispositivo.
2. Ejecute la herramienta de movimiento del dispositivo en modo de reversión:
   • Los números de teléfono no se asignarán desde Webex Calling, y los usuarios y servicios solo tendrán 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 alternativedIds y los teléfonos se volverán a crear en BroadCloud.
   • Los teléfonos se reiniciarán.
3. Los administradores de socios deben trasladar los números de teléfono PSTN a BroadCloud Carrier.

Para Cisco BroadWorks y Webex para BroadWorks

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

1. Abra un ticket con Cisco TAC para solicitar la reversión de un dispositivo.
2. Ejecute la herramienta de movimiento 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 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 Control Hub.
5. Los administradores de socios deben trasladar los números de teléfono PSTN a Cisco BroadWorks.

Instrucciones para ejecutar la herramienta de movimiento de dispositivo en modo de reversión

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

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

Revertir perfiles

./devicemove.sh -input=  -revertProfiles

Revertir números

./devicemove.sh -input=  -revertNumbers

Registros de terminales

Obtendremos los siguientes registros en la terminal al ejecutar exitosamente la herramienta de movimiento del dispositivo para la operación de reversión:

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