Os telefones suportados serão criados automaticamente e atribuídos aos usuários no Webex Calling pela ferramenta de provisionamento. Os telefones marcados como “sim” na coluna “Suportado na ferramenta de movimentação de dispositivos” também serão movidos automaticamente do Cisco BroadWorks ou BroadCloud para o Webex Calling quando a ferramenta de movimentação de dispositivos for executada. Os telefones marcados como “Não” nessa coluna precisam de uma intervenção manual para alterar o URL do DMS no modelo de dispositivo Cisco BroadWorks ou no próprio telefone.

A última coluna fornece o mapeamento dos modelos de telefone para a coluna “Tipo de dispositivo” do arquivo transform-tool/input/newphones.csv. (Consulte a seção Ferramenta de transformação deste artigo para obter mais informações sobre newphones.csv).

Os administradores de parceiros executam esta ferramenta utilitária geradora de tokens pelo menos uma vez antes de começar a executar as ferramentas de migração. A execução desta ferramenta é uma atividade única depois que a conta do parceiro é integrada à solução Wholesale RTM. Esta ferramenta permite que os administradores de parceiros façam login via navegador da web para obter o TOKEN exclusivo necessário para atualizar os arquivos de configuração do parceiro para as ferramentas de migração.

Pré-requisitos

Instale o Java 8, 11, 17 ou 21 no computador. Java está disponível em muitas fontes, incluindo:

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

Após o download, extraia os binários da ferramenta de migração.

Instruções para executar

Execute o seguinte comando no terminal dentro do diretório do gerador de tokens:

Windows:

token_generator.bat

Mac OS:

./token_generator.sh

Saída:

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

Abra a URL no navegador da web no terminal, faça login com as credenciais de administrador do parceiro para obter o TOKEN e copie-o para uso posterior.

As ilustrações da interface do usuário são fornecidas abaixo para referência:

Figura 3: Entrar com Cisco Webex

Figura 4: Janela de credenciais

Figura 5: Geração de tokens

Configure as seguintes etapas antes de executar as ferramentas de extração e movimentação de dispositivos no servidor BroadWorks secundário.

Habilitar conectividade OCI-P

A ferramenta de movimentação de dispositivos se comunica com o BroadWorks por meio de comandos OCI-P. Para habilitar a conectividade OCI-P, siga as etapas abaixo:

Passo 1: Use a CLI para configurar as Configurações gerais.

Execute o seguinte comando na CLI para alterar para o diretório GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Execute o seguinte comando na CLI para obter as GeneralSettings atuais:

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

Se suas configurações não corresponderem às acima, use o comando set para reconfigurá-las.

Passo 2: Use a CLI para configurar o proxy OCI.

Altere o diretório para OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

Execute a seguinte CLI para obter as configurações atuais. Você deverá ver o seguinte:

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

Se suas configurações não corresponderem às acima, use o comando set para reconfigurá-las.

Etapa 3: Use a CLI para configurar o provisionamento OCI.

Alterar para o diretório de provisionamento:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Execute o seguinte comando para obter as configurações atuais de provisionamento do OCI:

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

Passo 4: Execute o comando abaixo na CLI para verificar se sua configuração está correta.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

Verifique se o servidor cliente aberto está implantado e ativo

Use os comandos abaixo para implantar e iniciar o Open Client Server no Application Server secundário, caso ele não esteja implantado ou ainda não tenha sido iniciado.

Passo 1: Implante o servidor com o seguinte comando CLI:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Passo 2: Inicie o servidor com este comando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Habilitar ativação de números

Execute os seguintes comandos na CLI para habilitar a ativação dos números:

Passo 1: Execute o comando de ativação numérica:

AS_CLI> cd SubscriberMgmt/NumberActivation

Passo 2: Execute o comando de ativação habilitada:

AS_CLI> set dnMode groupAndUserActivationEnabled

Etapa 3: No prompt de confirmação, digite Y.

Para BroadCloud

A ferramenta de extração está integrada no portal do BroadCloud Service Provider. Um administrador de provedor de serviços pode:

1. Envie solicitações de extrato para até 50 clientes por solicitação.
   A solicitação de extrato não pode ser enviada para o mesmo cliente mais de 10 vezes por dia.
2. Baixe o arquivo de dados extraído, em formato ZIP, por até 28 dias a partir da data de envio da solicitação.

As figuras a seguir mostram o portal do Provedor de Serviços.

Figura 6: Portal do provedor de serviços

Figura 7: Portal do provedor de serviços

Solicitação de extrato CSV

Iniciar solicitação de extração de CSV

1. Baixe o CSV do cliente

   Clique no link Baixar CSV do cliente no canto superior direito da seção Iniciar solicitação de extração de CSV.

2. Editar a lista de clientes

   O administrador pode editar este arquivo CSV para incluir apenas os clientes para os quais o extrato precisa ser realizado.

3. Carregar e enviar

   Após a edição, carregue o CSV modificado.

   Clique em Enviar para iniciar uma solicitação de extrato para os clientes listados e seus locais associados.

Iniciar solicitação de extrato para um cliente com locais CSV

1. Selecione o cliente e os locais de download

   Selecione um cliente no menu suspenso.

   Baixe o arquivo locations.csv correspondente em Exibir clientes→ guia Sites → Exportar locais como CSV.

2. Editar o arquivo de locais

   O administrador pode editar o CSV para incluir apenas os locais que deseja extrair.

3. Carregar e enviar

   Carregue o locations.csv editado e clique em Enviar.

   Somente os locais especificados para o cliente selecionado serão incluídos na solicitação de extrato.

Iniciar solicitação de extrato para todos os clientes

1. Clique em Enviar para iniciar uma solicitação de extrato para todos os clientes e todos os seus locais sob o provedor de serviço atual.

Para Cisco BroadWorks e Webex para BroadWorks

1. A ferramenta de extração é executada no Cisco BroadWorks Application Server secundário dentro da rede parceira e se conecta via OCI-P.
2. A ferramenta extrai dados brutos de empresas, grupos, números, usuários, serviços, dispositivos e clientes soft da plataforma Cisco BroadWorks ou BroadCloud e gera esses dados em arquivos XML que fornecem as entradas para a ferramenta de transformação.

As próximas seções explicam como instalar e configurar a ferramenta de extração.

Pré-requisitos

1. SCP extrai os binários da ferramenta para o Cisco BroadWorks Application Server secundário.
2. Conecte-se por SSH ao Cisco BroadWorks Application Server secundário para configurar os pré-requisitos e executar a ferramenta de extração.
3. Configure o provedor de serviços e o ID do grupo para extrair do Cisco BroadWorks no conf/exportTool.yml. Consulte o seguinte trecho de exemplo YAML:

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

4. Certifique-se de que o ID do usuário, a senha e o nome do host do servidor de aplicativos Cisco BroadWorks secundário estejam corretos no conf/partner.cfg arquivo:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   A propriedade REFRESH_TOKEN é obrigatória para uma migração do Webex para BroadWorks.

5. Modifique o JDK/JRE caminho do ambiente no arquivo export.sh se o Cisco BroadWorks Application Server secundário JDK/JRE o caminho do ambiente é diferente do arquivo:

   JAVA_HOME=/usr/local/java/java_base

Instruções para executar

Execute o seguinte comando no Cisco BroadWorks Application Server secundário a partir do diretório da ferramenta de extração:

./export.sh

Registros de terminais

Os seguintes logs estão disponíveis no terminal após exportação bem-sucedida: Executando a ferramenta de exportação de dados 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
**************************************************

Saída

Um arquivo ZIP de saída (extracted_data_<timestamp>.zip) está disponível no mesmo diretório da ferramenta de extração. Use o seguinte comando para visualizar e usar o arquivo ZIP para a entrada da Ferramenta de Transformação:

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 ferramenta de transformação é executada para todas as migrações. A ferramenta de transformação é executada em qualquer computador, incluindo o laptop do administrador do parceiro, e usa as APIs públicas do Webex. Ele lê o arquivo ZIP (extracted_data_<timestamp>.zip) de saída da ferramenta de extração como uma entrada e transforma o XML bruto em um formato JSON que é usado pela ferramenta de provisionamento.

Pré-requisitos

Após baixar e extrair os binários das ferramentas de migração, configure os seguintes pré-requisitos:

1. Defina o REFRESH_TOKEN (Token copiado da ferramenta Gerador de Token) e o NOME_DO_LOCAL PRINCIPAL_no conf/partner.cfg arquivo:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. Opcionalmente, defina o ID de PROVISIONAMENTO_(copiado do modelo no Partner Hub) no conf/partner.cfg arquivo:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Para obter uma verificação mais completa do endereço de e-mail do cliente, você pode opcionalmente definir o ID DE PROVISIONAMENTO_.
3. Configurar informações faltantes no input/customers.csv arquivo (veja a próxima seção) se estiver faltando.
4. Adicione o endereço de e-mail do usuário final no input/users.csv arquivo.
5. Se novos telefones forem provisionados, adicione o endereço MAC e o endereço de e-mail do novo telefone do usuário para input/newphones.csv arquivo. Isso é necessário somente se os administradores parceiros desejarem provisionar novos telefones em Chamadas de atacado.
6. Converta os Call Centers BroadWorks em CxEssentials usando o input/cxessentials.csv arquivo.
7. Opcionalmente, habilite a propriedade ATUALIZAR_TODOS_CALL_CENTROS_PARA_CX_ESSENCIAIS para converter todos os Call Centers em CxEssentials.
8. Use o input/locations.csv arquivo para dar suporte à migração de grandes empresas que permite aos administradores migrarem os locais de seus clientes por local
9. Opcionalmente, habilite o uso de endereços MAC do cabeçalho User-Agent da mensagem SIP REGISTER quando o endereço MAC não estiver disponível no perfil do dispositivo Cisco BroadWorks. Descomente a linha "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" em arquivo conf/partner.cfg
10. O recurso de sincronização do servidor de rede permite que os administradores forneçam números de telefone, endereços MAC e endereços de e-mail dos usuários durante o fornecimento na mesma migração regional. Para habilitá-lo, defina USE_NS_SYNC=yes em conf/partner.cfg.

    Se a sincronização do NS estiver desativada, o provisionamento do número de telefone e do dispositivo será ignorado, e os usuários receberão endereços de e-mail temporários.

11. Opcionalmente, habilite as propriedades ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD e ANALOG_USER_TYPE_DISABLE_T38 para configurar a chamada em espera, a música em espera e desabilitar as configurações do T38 para todos os usuários do tipo analógico.

Preenchendo o input/customers.csv

O arquivo input/customers.csv fornece dados que podem estar faltando no Cisco BroadWorks ou BroadCloud. Este arquivo pode ser deixado vazio se todas as informações obrigatórias já estiverem disponíveis. Você não precisa preencher todas as colunas, apenas as informações que faltam são obrigatórias.

A tabela abaixo explica as colunas mais importantes em input/customers.csv.

Preenchendo o input/users.csv

O arquivo input/users.csv fornece dados que podem estar faltando no Cisco BroadWorks ou BroadCloud. Este arquivo pode ser deixado vazio se todas as informações obrigatórias já estiverem disponíveis. Você não precisa preencher todas as colunas, apenas as informações que faltam são obrigatórias.

Instruções para executar

Execute a ferramenta de transformação em qualquer sistema operacional. Use as etapas abaixo para executar a ferramenta no Windows e no macOS:

Windows

Execute o comando abaixo para executar a ferramenta Transformação no Windows:

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

macOS

Execute as seguintes etapas para executar a ferramenta de transformação no macOS:

1. Crie um ambiente virtual e instale dependências para executar a ferramenta de transformação 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. Execute a ferramenta de transformação:

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

Customer/user pré-verificação

A ferramenta de transformação faz chamadas de API para o Webex para detectar possíveis problemas de provisionamento. Por padrão, ele validará o endereço e o e-mail principal do cliente. Se o valor do ID PROVISIONING_for especificado no conf/partner.cfg arquivo, ele também validará as informações de localização. Os resultados da pré-verificação são incluídos no relatório de exceção.

Além disso, os seguintes parâmetros opcionais podem ser adicionados ao executar a ferramenta de transformação:

pré-verificação

Além de executar a API de pré-verificação para as informações do cliente, a Ferramenta de Transformação também executará a API de pré-verificação para os e-mails dos assinantes.

pré-verificação de informações

Por padrão, somente erros de pré-verificação (ou seja, problemas que bloquearão o provisionamento) são incluídos no relatório de exceções. Adicionar este sinalizador também incluirá resultados de pré-verificação bem-sucedidos (por exemplo, se uma organização Webex já existir e puder ser anexada automaticamente).

Registros de terminais

Os seguintes logs no terminal em caso de transformação bem-sucedida:

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

Relatório de exceção

A ferramenta de transformação gera o relatório de exceção dentro da saída /<timestamp>/exception_report.txt diretório. Você pode usar este relatório para identificar os problemas que afetarão a migração e corrigi-los no sistema Cisco BroadWorks.

Depois de modificar os dados do usuário para resolver a exceção, execute novamente as Ferramentas de Extração e Transformação com os novos dados. O arquivo de relatório de exceção de exemplo é o seguinte:

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

Saída

Um arquivo JSON de saída (customer.json) estará disponível em output/<timestamp>/<groupid> diretório. O arquivo de exemplo customer.json é o seguinte:

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

A ferramenta de provisionamento pode ser executada em qualquer máquina, geralmente o laptop do administrador do parceiro, e usa as APIs públicas do Webex. Ele lê o arquivo JSON (customer.json) de saída da ferramenta de transformação como uma entrada e provisiona os clientes, locais, números, usuários, serviços e dispositivos na solução Webex Wholesale RTM.

Pré-requisitos

Configure os seguintes pré-requisitos dentro do diretório da ferramenta de provisionamento:

1. Instale o Java 8, 11, 17 ou 21 no computador. Java está disponível em muitas fontes, incluindo:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. Após baixar e extrair os binários das ferramentas de migração, defina a variável de ambiente JAVA_HOME em provisioning_tool.sh para MAC e provisioning_tool.bat para Windows.
3. O arquivo partner.cfg:
   • Defina o WHOLESALE_PROVISIONING_ID e REFRESH_TOKEN (Token copiado da ferramenta Token Generator). Os administradores de parceiros devem entrar em contato com sua equipe de contas para obter o ID DE PROVISIONAMENTO_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Defina PERMITIR_ADMINISTRADOR_CONVIDAR_E-MAILS como falso, se o parceiro não quiser enviar um e-mail de boas-vindas aos usuários. O valor padrão é verdadeiro.

4. Use a propriedade WEBEX4BWKS_EMAIL_SUBJECT para migrações do Webex para BroadWorks para enviar o assunto do e-mail de solicitação de alteração de senha para assinantes do Webex para BroadWorks.
5. Use a propriedade WEBEX4BWKS_EMAIL_BODY para migrações do Webex para BroadWorks para enviar o corpo do e-mail de solicitação de alteração de senha para assinantes do Webex para BroadWorks.
6. O recurso de sincronização do servidor de rede permite que os administradores forneçam números de telefone, endereços MAC e endereços de e-mail dos usuários durante o fornecimento na mesma migração regional. Para habilitá-lo, defina USE_NS_SYNC=yes em conf/partner.cfg.

   Se a sincronização do NS estiver desativada, o provisionamento do número de telefone e do dispositivo será ignorado, e os usuários receberão endereços de e-mail temporários.

Para migrações do BroadCloud na mesma região:

1. A ferramenta ignora o provisionamento de números, dispositivos e aparências de chamadas compartilhadas.
2. A ferramenta cria usuários e usuários virtuais com extensão e extensão temporária.

Para migrações do BroadCloud, outra região:

1. A ferramenta provisionará números, dispositivos e aparências de chamadas compartilhadas.
2. A ferramenta cria usuários e usuários virtuais com números de telefone e ramais reais.
   Todas as migrações do BroadCloud da Europa são para outra região.

Instruções para executar

Use as seguintes etapas para executar a ferramenta no Windows e no macOS:

Windows

Execute as seguintes etapas para executar a ferramenta no sistema operacional Windows:

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

macOS

Execute as seguintes etapas para executar a ferramenta no macOS:

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

Pré-requisitos para migração do Webex para BroadWorks

Os administradores de parceiros devem atualizar seu modelo de integração do BroadWorks para os recursos de coexistência do Webex para BroadWorks. Consulte a imagem a seguir:

Depois que o modelo de integração do Webex para BroadWorks for atualizado para oferecer suporte à migração, solicite à equipe de contas da Cisco que habilite o recurso "wholesale-partner-blending-enabled" no nível do parceiro. Isso permitirá que pacotes de atacado sejam adicionados ao Webex existente para organizações de clientes do BroadWorks durante o provisionamento.

Execute a ferramenta de provisionamento com um argumento adicional.

Fase de preparação: é a fase padrão em que os administradores podem provisionar os usuários do BroadWorks como assinantes do Wholesale e continuar com o Webex para usuários do BroadWorks.

Fase de manutenção: é a segunda fase em que os administradores podem atribuir a licença de atacado aos usuários existentes do Webex para BroadWorks. Você deve executar a ferramenta de provisionamento com um argumento manutenção.

Fase pós-migração: É a fase final quando os administradores podem converter completamente o BroadWorks para Wholesale. Você deve executar a ferramenta de provisionamento com um argumento postmigration.

Registros de terminais

A seguir estão os logs no terminal sobre o provisionamento bem-sucedido:

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

Uma tabela será impressa com o número de locais criados para cada execução:

Saída

A ferramenta de provisionamento gera relatórios de sucesso e erro dentro da saída /<external_id>/*.success/error arquivos. Revise os logs de sucesso e erro de saída para verificar o provisionamento bem-sucedido.

Os administradores de parceiros podem verificar o provisionamento do cliente no portal Partner Hub e Control Hub. Consulte as seguintes ilustrações do portal Partner Hub e Control Hub:

Figura 8: Hub de parceiros

Figura 9: Control Hub

Figura 10: Dispositivos

Figura 11: Chamadas

Para BroadCloud

Para parceiros BroadCloud, use o portal do Provedor de Serviços para enviar uma solicitação de migração para números, dispositivos e migrações de Shared Call Appearances (SCA).

No portal do Provedor de Serviços, uma solicitação de migração pode incluir até 50 clientes. É possível enviar no máximo 10 solicitações por dia.

O recurso de sincronização do servidor de rede permite que os administradores desativem o local do broadCloud e ativem o local do Webex Calling ao definir USE_NS_SYNC=yes em conf/partner.cfg. Após a migração, os dispositivos e números de telefone são ativados no local do Webex Calling.

Os administradores podem habilitar a reversão automatizada definindo ROLLBACK_TO_BROADCLOUD=true no arquivo conf/partner.cfg, que move os dispositivos de volta para o BroadCloud após a migração. Ele oferece suporte a migrações da mesma região e de regiões diferentes com o NS Sync, mas apenas para migrações bem-sucedidas. Para aqueles com falha, os administradores devem gerar um TAC da Cisco antes de solicitar a reversão.

Há duas opções disponíveis para selecionar o tipo de migração no portal:

• Migração – Selecione esta opção para iniciar uma solicitação de migração de números, dispositivos e Aparências de Chamadas Compartilhadas (SCA).
• Status do dispositivo – Selecione esta opção para visualizar o status atual de um dispositivo no BroadCloud e no Calling.

As figuras a seguir mostram o portal do Provedor de Serviços.

Figura 12: Portal do provedor de serviços

Figura 13: Portal do provedor de serviços

Migrar locais selecionados (opcional)

Para iniciar a migração para um subconjunto específico de locais listados no arquivo customer.json, inclua um arquivo locations.csv com sua solicitação. Este CSV deve listar apenas os locais que você pretende migrar.

Para baixar a lista de sites ativos disponíveis, navegue até Exibir clientes → Selecionar um cliente → Exportar locais como CSV.

Figura 14: Exportar locais como CSV

Para Cisco BroadWorks e Webex para BroadWorks

Para migrações do Cisco BroadWorks e do Webex para BroadWorks, a ferramenta é executada no Cisco BroadWorks Application Server secundário dentro da rede do parceiro e se conecta ao AS por meio do OCI-P. Ele usa o arquivo JSON (customer.json) de saída da ferramenta de transformação como entrada e executa os comandos OCI-P para migrar dispositivos e clientes de software.

Após a operação bem-sucedida, a ferramenta de movimentação do dispositivo irá:

1. Cancele o registro de dispositivos do Cisco BroadWorks e registre-os no Wholesale.
2. Os usuários que utilizam o cliente UC-One serão redirecionados para o aplicativo Webex no primeiro login.
3. Desative os números de telefone do Cisco BroadWorks ou remova os números de telefone do BroadCloud.
4. Ative números no Atacado.
5. Crie aparições de chamadas compartilhadas no Wholesale para migrações do BroadCloud. [This a etapa é aplicável apenas para BroadCloud migrations].

SCP e SSH

1. SCP a ferramenta de movimentação do dispositivo para o Cisco BroadWorks Application Server secundário.
2. Conecte-se por SSH ao Cisco BroadWorks Application Server secundário para configurar os pré-requisitos e executar a ferramenta de movimentação de dispositivos.

Pré-requisitos

1. Defina o REFRESH_TOKEN (Token copiado da ferramenta Gerador de Token) no conf/partner.cfg arquivo:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. Certifique-se de que o ID do usuário, a senha e o nome do host do servidor de aplicativos Cisco BroadWorks secundário estejam corretos no conf/deviceMoveTool.conf arquivo:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. Para reenviar e-mails de ativação, você precisa definir REENVIE_CONVITE_EMAILS=true no conf/partner.cfg arquivo.

   Se os administradores desejarem enviar e-mails de convite aos seus usuários durante a migração, eles devem descomentar a opção "REENVIAR_CONVITE_EMAILS=true" propriedade no conf/partner.cfg arquivo. Caso contrário, a propriedade deve permanecer inalterada.

4. Verifique o JDK/JRE o caminho do ambiente está correto em devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. Os administradores podem usar o arquivo locations.csv do diretório de entrada para migrar grupos específicos em vez de todos os grupos de uma empresa.

Telefones Polycom

Para mover telefones Polycom do Cisco BroadWorks para o Wholesale Calling, um administrador de parceiro deve criar um novo Identity/Device Arquivo de tipo de perfil no nível do sistema no Cisco BroadWorks cada modelo de dispositivo Polycom. Consulte a figura 14 e carregue o arquivo personalizado device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Depois de carregar o novo arquivo do dispositivo, certifique-se de que o arquivo recém-criado exista no nível do Grupo. Certifique-se também de que o arquivo migration_%BWMAC ADDRESS%.cfg não entre em conflito com nenhum arquivo existente no seu sistema).

Ele é usado internamente pela ferramenta de movimentação do dispositivo.

O processo de migração para telefones Polycom:

1. A ferramenta de movimentação de dispositivos substitui o arquivo %BWMACADDRESS%.cfg no nível do dispositivo por polycom_vvx2.cfg. Este arquivo se refere a migration_%BWMACADDRESS%.cfg.
2. Reconstrua os perfis de dispositivo no nível do grupo ou do dispositivo.
   A atuação no nível do grupo ou do dispositivo depende da configuração do parâmetro deviceLevelRebuild no arquivo device-move-tool/conf/partner.cfg.
3. A ferramenta de movimentação de dispositivos solicita ao Cisco BroadWorks Application Server para reiniciar os telefones no nível do grupo ou do dispositivo.
4. Após a solicitação de reinicialização, os telefones Polycom baixam e processam% BWMACADDRESS%.cfg, que solicita que os telefones Polycom baixem e processem migration_%BWMACADDRESS%.cfg, que define o device.prov.serverName como https://plcm.sipflash.com.
   https://plcm.sipflash.com para a região dos EUA, outras regiões têm URLs diferentes.
5. O telefone Polycom baixa %BWMACADDRESS%.cfg de https://plcm.sipflash.com e será gerenciado pelo Webex Calling DMS.

Figura 14: Identity/device adicionar arquivo de tipo de perfil

Instruções para executar

Existem dois métodos para invocar o DMT: o primeiro é invocar um único cliente por vez e o outro é executar vários clientes simultaneamente.

A ferramenta de movimentação de dispositivos é executada no Cisco BroadWorks Application Server secundário dentro do diretório da ferramenta de movimentação 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 terminais

A seguir estão os logs no terminal sobre a execução bem-sucedida da ferramenta de movimentação de dispositivos para migração 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

Saída

Após a migração do dispositivo, os dispositivos ficam online e prontos para make/receive chamadas. Consulte a figura 15 para ver um exemplo do status do dispositivo:

Figura 15: Status do dispositivo

Após a migração do dispositivo, os números ficaram ativos. Consulte a figura 16 para ver um exemplo de quais números estão ativos:

Figura 16: Números ativos

A operação de reversão deve ser executada para uma empresa por vez.

Para operadora BroadCloud

O processo de reversão para parceiros BroadCloud é o seguinte:

1. Abra um tíquete com o Cisco TAC para solicitar a reversão de um dispositivo.
2. Execute a ferramenta de movimentação do dispositivo no modo de reversão:
   • Os números de telefone não serão mais atribuídos pelo Webex Calling, deixando apenas os usuários e serviços com ramais.
   • Os endereços de e-mail no Webex Calling serão revertidos para endereços de e-mail temporários.
   • Os telefones serão excluídos do Webex Calling.
   • Números de telefone, endereços de e-mail usados como alternatedIds e telefones serão recriados no BroadCloud.
   • Os telefones serão reiniciados.
3. Os administradores de parceiros devem mover os números de telefone PSTN de volta para a BroadCloud Carrier.

Para Cisco BroadWorks e Webex para BroadWorks

O processo de reversão para Cisco BroadWorks e Webex para BroadWorks é o seguinte:

1. Abra um tíquete com o Cisco TAC para solicitar a reversão de um dispositivo.
2. Execute a ferramenta de movimentação de dispositivos no modo de reversão no BroadWorks Application Server secundário para reverter as migrações de dispositivos. Isso definirá o URL do DMS de volta para o URL do DMS do provedor de serviços para perfis de dispositivos no Cisco BroadWorks e reativará os números de telefone.
3. A equipe do Webex Calling define o URL do DMS de volta para o URL do DMS do provedor de serviços nos perfis de dispositivos no Webex Calling.
4. Os administradores de parceiros devem desativar ou excluir os números de telefone no Webex Calling por meio do portal Control Hub.
5. Os administradores de parceiros devem mover os números de telefone PSTN de volta para o Cisco BroadWorks.

Instruções para executar a ferramenta de movimentação de dispositivo no modo de reversão

Siga as etapas abaixo para executar a ferramenta de movimentação de dispositivos no modo de reversão:

Execute o comando abaixo no Cisco BroadWorks Application Server secundário dentro do diretório da ferramenta de movimentação de dispositivos:

Reverter perfis

./devicemove.sh -input=  -revertProfiles

Reverter números

./devicemove.sh -input=  -revertNumbers

Registros de terminais

Obteremos os seguintes logs no terminal ao executar com sucesso a ferramenta de movimentação de dispositivos para operação de reversão:

Reverter perfis

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

Reverter 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