Obrigado pelos seus comentários.

Os telefones compatíveis serão automaticamente criados e atribuídos aos usuários Webex Calling pela ferramenta de provisionamento. Os telefones marcados com “sim” na coluna “Suportados na ferramenta de movimentação de dispositivos” também serão movidos automaticamente do Cisco BroadWorks ou BroadCloud para Webex Calling quando a ferramenta de movimentação de dispositivos for executada. Os telefones marcados com “Não” nessa coluna precisam de uma intervenção manual para alterar a URL do DMS no modelo do 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 parceiros executam essa ferramenta utilitária geradora de tokens pelo menos uma vez antes de começar a executar as ferramentas de migração. A execução dessa ferramenta é uma atividade única depois que a conta do parceiro é integrada à solução Wholesale RTM. Essa ferramenta permite que os administradores 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. O Java está disponível em várias 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:

Janelas:

token_generator.bat

macOS:

./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 mesmo para uso posterior.

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

Figura 3: Faça login com Cisco Webex

Figura 4: Janela de credenciais

Figura 5: Geração de token

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

Habilitar a 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, use as etapas abaixo:

Etapa 1: Use a CLI para definir as configurações gerais.

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

Execute o seguinte comando na CLI para obter as configurações gerais atuais:

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

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

Etapa 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ê deve 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 descritas acima, use o comando set para reconfigurá-las.

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

Mude para o diretório de aprovisionamento:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

Execute o comando a seguir para obter as configurações atuais de provisionamento OCI:

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

Etapa 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 servidor de aplicativos secundário se ele não estiver implantado ou ainda não tiver sido iniciado .

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

Etapa 2: Inicie o servidor com este comando:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

Ativar ativação de números

Execute os seguintes comandos na CLI para ativar os números:

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

AS_CLI> cd SubscriberMgmt/NumberActivation

Etapa 2: Execute o comando de ativação ativada:

AS_CLI> set dnMode groupAndUserActivationEnabled

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

Para BroadCloud

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

1. Envie solicitações de extração para até 50 clientes por solicitação.
   A solicitação de extração não pode ser enviada para o mesmo cliente mais de 10 vezes por dia.
2. Faça o download do 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 extração de 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 esse arquivo CSV para incluir somente os clientes para os quais a extração precisa ser executada.

3. Carregar e enviar

   Depois de editar, faça o upload do CSV modificado.

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

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

1. Selecione o cliente e os locais de download

   Escolha um cliente no menu suspenso.

   Faça o download do locations.csv correspondente na guia Exibir clientes → Sites → Exportar locais como CSV.

2. Edite o arquivo de localizações

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

3. Carregar e enviar

   Faça o upload do arquivo locations.csv editado e clique em Enviar.

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

Iniciar solicitação de extração para todos os clientes

1. Clique em Enviar para iniciar uma solicitação de extração para todos os clientes e todas as suas localizações sob o provedor de serviços atual.

Para Cisco BroadWorks e Webex para BroadWorks

1. A ferramenta de extração é executada no Cisco BroadWorks Application Server secundário na rede do parceiro e se conecta via OCI-P.
2. A ferramenta extrai dados brutos de empresas, grupos, números, usuários, serviços, dispositivos e clientes de software da plataforma Cisco BroadWorks ou BroadCloud e envia esses dados para 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, os binários da ferramenta de extração, para o Cisco BroadWorks Application Server secundário.
2. SSH para o 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 a serem extraídos do Cisco BroadWorks no conf/exporttool.yml. Consulte o exemplo de trecho YAML a seguir:

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

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

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

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

5. Modifique o caminho do ambiente JDK/JRE no arquivo export.sh se o caminho do ambiente JDK/JRE secundário do Cisco BroadWorks Application Server for 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 do terminal

Os seguintes registros estão disponíveis no terminal em caso de exportação bem-sucedida: Executando a ferramenta de exportação de dados da 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_ .zip<timestamp>) está disponível no mesmo diretório da ferramenta de extração. Use o comando a seguir 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

Se o administrador estiver operando a ferramenta por trás de um proxy corporativo, siga as etapas abaixo para configurar e executar o script de exportação.

Etapas para configurar e executar o script de exportação

1. Abra o arquivo export.sh.
2. Localize a variável HTTPS_PROXY_HOST e descomente-a (remova o # inicial).

3. Defina o valor HTTPS_PROXY_HOST como:

   HTTPS_PROXY_HOST=<proxy-host>

4. Localize a variável HTTPS_PROXY_PORT e descomente-a (remova o # inicial).
5. Defina o valor HTTPS_PROXY_PORT como:

   HTTPS_PROXY_PORT=<proxy-port>

6. Salve e feche o arquivo export.sh.
7. Abra o arquivo partner.cfg e adicione o refresh_token necessário.
8. Verifique se o host, o nome de usuário e a senha do BroadWorks estão configurados corretamente em partner.cfg.
9. Execute o script:

   ./export.sh

Formulário de engajamento:

A ferramenta de extração (BroadCloud e BroadWorks) agora gera automaticamente um arquivo XLSX consolidado intitulado Engagement Form SUA.xlsx durante a execução. O arquivo é preenchido previamente com todos os dados disponíveis nas planilhas relevantes, ajudando a agilizar e acelerar a conclusão por parceiros.

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

Pré-requisitos

Depois de 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 Geradora de Token) e o NAME_OF_MAIN_LOCATION no arquivo conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Para obter uma verificação mais completa do endereço de e-mail do cliente, você pode definir opcionalmente o PROVISIONING_ID.
3. Configure as informações ausentes no arquivo input/customers.csv (consulte a próxima seção) se estiverem ausentes.
4. Adicione o endereço de e-mail do usuário final no arquivo input/users.csv.
5. Se novos telefones precisarem ser provisionados, adicione o endereço MAC e o endereço de e-mail do novo telefone do usuário ao arquivo input/newphones.csv. Isso é necessário somente se os administradores do parceiro quiserem provisionar novos telefones nas chamadas de atacado.
6. Converta os call centers da BroadWorks em CXEssentials usando o arquivo input/cxessentials.csv.
7. Opcionalmente, ative a propriedade UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS para converter todos os call centers em CXEssentials.
8. Use o arquivo input/locations.csv para dar suporte à migração de grandes empresas que permite que os administradores migrem os locais de seus clientes por local
9. Opcionalmente, ative o uso de endereços MAC a partir 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. Remova o comentário da linha USE_MAC_ADDRESS_from_sip_register=YES no arquivo conf/partner.cfg
10. Opcionalmente, ative 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 desativar as configurações de T38 para todos os usuários do tipo analógico.

11. Se você quiser configurar dispositivos de gateway genéricos, adicione o endereço MAC e o ID do usuário do dispositivo ao arquivo input/genericgateways.csv. Além disso, mencione se o usuário é o proprietário PRINCIPAL ou um usuário COMPARTILHADO (para aparições de chamadas compartilhadas). Isso só é necessário se os administradores parceiros planejarem usar dispositivos de gateway genéricos no Wholesale Calling.

    Esse recurso não está disponível para migrações de BroadCloud para Wholesale .

12. Para migrações do BroadCloud, para converter todos os usuários com o tipo de estação de mensagens em voice_mail_group, atualize o arquivo conf/rialto_station_type_to_wholesale_package.csv substituindo o valor do pacote de atacado por voice_mail_group na linha em que o tipo de estação Rialto está enviando mensagens.

    Opcionalmente, ative a propriedade COMMON_VOICE_MAIL_GROUP_PASSCODE em partner.cfg para configurar o PIN padrão para grupos de correio de voz.

    Se essa propriedade não for especificada em partner.cfg, ela deverá ser fornecida por cliente no arquivo customers.csv na coluna commonVoicemailGroupPasscode.

13. Para a migração de contatos comuns para Webex Calling

    É o aprimoramento para gerenciar contatos comuns em nível corporativo e local. Agora, esses contatos podem ser migrados como contatos da organização ( Contatos da organização) ou como extensões virtuais, com base nas configurações. Abaixo estão os detalhes para guiá-lo nesse processo de migração.

    Configuração da chave:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      Uma nova propriedade, COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, é introduzida no arquivo partner.cfg. Essa propriedade determina como os contatos comuns são migrados de Rialto para o. Webex Calling

    • Sem o COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurado

      Os contatos comuns serão migrados como contatos da organização (Contatos da organização).

      Nenhuma configuração adicional é necessária.

      Os contatos permanecem acessíveis no nível da organização.

    • Com COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurado

      Os contatos comuns serão migrados como extensões virtuais.

      Cada contato será anexado a um número de ramal e o intervalo inicial da extensão será definido na propriedade COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE em partner.cfg.

      As extensões virtuais são suportadas tanto no nível da organização quanto no nível da localização, dependendo do escopo do contato.

14. Habilite o fornecedor padrão de gravação de chamadas para o Webex.

    Essa etapa é necessária somente ao migrar as configurações de gravação de chamadas para usuários configurados com o Dubber para a gravação nativa de chamadas da Cisco no Webex.

    Para ativar essa opção:

    • No arquivo partner.cfg, defina a propriedade a seguir, DEFAULT_CALL_RECORDING_VENDOR=webex.
    • Além disso, use a propriedade WEBEX_CALL_RECORDING_STORAGE_REGION para configurar a região de armazenamento.

      A opção de gravação sob demanda do BroadCloud não é suportada noWebex Calling. Essas configurações de gravação de chamadas não migrarão e aparecerão no relatório de exceções.

15. Exclusão de números de telefone selecionados da migração:

    Para excluir números de telefone específicos do processo de migração, é necessário seguir o procedimento de duas etapas a seguir usando a ferramenta de transformação:

    • Inicialmente, execute a ferramenta de transformação pela primeira vez. Após a conclusão, a ferramenta gerará um arquivo chamado telephone_numbers_inventory.csv, localizado no diretório output/timestamp/. O cliente deve revisar esse arquivo e indicar “Sim” na coluna “Drop Tn's” para cada número de telefone que deve ser excluído da próxima migração.
    • Depois de atualizar o arquivo telephone_numbers_inventory.csv com os sinalizadores de exclusão apropriados, a ferramenta de transformação é executada uma segunda vez . O arquivo atualizado deve ser passado como argumento no formato a seguir.

      . /transform.sh -extract=input/extracted_data_1747640608219.zip -números de descomissionamento = {filepath/telephone_numbers_inventory.csv}

16. Opcionalmente, defina a propriedade ALLOW_RESTRICT_BY_PARTNER_MODE como OFF para permitir que os administradores do cliente modifiquem as configurações definidas pelo parceiro no Control Hub.
17. Para migrar números de celular (BroadWorks Mobility) do BroadCloud para Webex Calling

    Esta seção descreve a migração do recurso BroadWorks Mobility (números de celular do cliente) do BroadCloud (integração de rede móvel) para o atacado Webex Calling (operadora de rede móvel Webex Go).

    Pré-requisitos - Antes de iniciar o processo de migração, os administradores parceiros devem entrar em contato com a equipe de contas da Cisco para fazer a configuração do fornecedor Cloud Connected PSTN (CCP) e da Custom Carrier List (CCL).

    Uma nova propriedade, ASSIGN_MOBILE_NUMBERS_TO_USERS, é adicionada ao arquivo partner.cfg. Ative essa propriedade para permitir que números de celular sejam atribuídos e migrados para os usuários.

    • Esse recurso é suportado somente para migrações de Broadcloud para atacado.
    • No Wholesale Webex, os usuários finais podem ter um número de celular ou um número PSTN (não ambos), ao contrário do BroadCloud.
    • Quando um número de celular é atribuído a um usuário, seu número PSTN principal se torna seu número secundário (alternativo).
    • Os números de celular não podem ser migrados para usuários que estão sendo convertidos em espaços de trabalho ou linhas virtuais.
    • Depois que um número de celular for atribuído no Wholesale Webex, ele será exibido como Ativo no Control Hub. Esse status não significa que o número esteja imediatamente pronto para receber chamadas. O recurso de chamada estará disponível somente após a conclusão total da migração.
    • As configurações de integração de celular definidas pelos usuários finais no Portal do Usuário Chamador (CUP) não são migradas. Após a migração, quando um número de telefone, número de celular ou ramal for chamado, todos os dispositivos do usuário tocarão.

18. Para configurar opcionalmente os limites de quantidade de pacotes durante a migração do cliente, especifique a quantidade de cada pacote no arquivo input/package_quantity.csv. A quantidade de pacotes configurada deve ser maior ou igual ao número de pacotes atribuídos ao usuário/espaço de trabalho.

    Atualmente, os limites de quantidade de pacotes não são compatíveis com migrações do Webex for BroadWorks para Wholesale.

    Ao executar a ferramenta de transformação, forneça o arquivo atualizado como um parâmetro de entrada:. <extract_zip_file>/transform.sh -extract= -packagelimits=input/package_quantity.csv.

19. Migre sites de vários clientes da Broadworks/Broadcloud para um único cliente no atacado Webex Calling
    • Um novo modo de execução, -ConsolidatedMigration, é introduzido na ferramenta Transform para oferecer suporte à migração de vários sites de clientes da Broadcloud/Broadworks para a Webex Wholesale Platform em uma única organização de clientes de atacado. Quando esse modo é ativado, a ferramenta consolida vários sites de clientes em uma organização de clientes de atacado

      -consolidatedMigration

    • Existem outros argumentos opcionais que podem ser fornecidos junto com -ConsolidatedMigration, como

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

    • se -TargetEnterpriseID for fornecido e o ID existir no arquivo de saída da ferramenta Extract, ele será usado para criar a organização do cliente de atacado. Se o ID não for encontrado, a ferramenta voltará a usar todos os detalhes do cliente disponíveis no arquivo de saída da ferramenta Extract.
    • se -ConsoliatedExternalId for fornecido, ele definirá o ExternalId para o cliente e, se não for fornecido, a ferramenta voltará a usar o fluxo existente para ID externo.
    • <timestamp>Um arquivo JSON consolidado (customer.json) estará disponível no diretório output/ /consolidated.

Preenchendo o input/customers.csv

O arquivo input/customers.csv fornece dados que podem estar ausentes no Cisco BroadWorks ou no BroadCloud. Esse arquivo pode ser deixado vazio se todas as informações obrigatórias já estiverem disponíveis. Você não precisa preencher todas as colunas, somente 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 ausentes no Cisco BroadWorks ou BroadCloud. Esse arquivo pode ser deixado vazio se todas as informações obrigatórias já estiverem disponíveis. Você não precisa preencher todas as colunas, somente 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 de Transformação no Windows:

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

macOS

Execute as etapas a seguir 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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

Pré-verificação do cliente/usuário

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 PROVISIONING_ID for especificado no arquivo conf/partner.cfg, ele também validará as informações de localização. Os resultados da pré-verificação estão incluídos no relatório de exceções.

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.

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

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 esse sinalizador também incluirá resultados de pré-verificação bem-sucedidos (por exemplo, se já existir uma organização Webex que possa ser anexada automaticamente).

Registros do terminal

Os seguintes registros no terminal sobre uma 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 do diretório output/ /exception_report.txt<timestamp>. Você pode usar esse 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 exemplo de arquivo de relatório de exceções é 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 (customer.json) de saída estará disponível no diretório output//. <timestamp><groupid> O exemplo de arquivo 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. O Java está disponível em várias 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. Depois de 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 o REFRESH_TOKEN (Token copiado da Ferramenta Geradora de Token). Os administradores do parceiro devem entrar em contato com a equipe de contas para obter o PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • Defina SEND_SUBSCRIBERS_WELCOME_EMAIL como false, se os parceiros não quiserem enviar um e-mail de boas-vindas aos usuários. O valor padrão é true.

     O Webex envia e-mails de boas-vindas somente para usuários finais. Os administradores do cliente não recebem e-mails de boas-vindas.

     Usuários e administradores de clientes baseados nos EUA e Canadá recebem uma notificação por e-mail separada da RedSky. A plataforma RedSky E911 envia esse e-mail para confirmar a criação da conta do cliente para serviços de emergência. Esse e-mail do RedSky é separado dos e-mails de boas-vindas do Webex e não é controlado pelas configurações de e-mail do Webex. Para organizações de atacado nos EUA e no Canadá, o RedSky é ativado automaticamente como provedor de serviços de emergência.

4. Use a propriedade WEBEX4BWKS_EMAIL_SUBJECT para migrações do Webex for BroadWorks para enviar o assunto do e-mail de solicitação de alteração de senha para assinantes do Webex for BroadWorks.
5. Use a propriedade WEBEX4BWKS_EMAIL_BODY para migrações do Webex for BroadWorks para enviar o corpo do e-mail de solicitação de alteração de senha para assinantes do Webex for BroadWorks.
6. Use a propriedade CUSTOM_TAGS para adicionar tags após a criação do cliente.
7. Para aplicar descontos por atacado, os administradores parceiros devem entrar em contato com a equipe de contas da Cisco antes de você iniciar a migração.

   Uma nova propriedade, APPLY_WHOLESALE_DISCOUNTS, é adicionada ao partner.cfg. Ative essa propriedade para aplicar descontos a usuários e espaços de trabalho.

8. (Opcional) Configure explicitamente a conexão PSTN

   Para especificar a conexão PSTN para todos os locais provisionados durante a migração, incluindo o local principal, adicione a seguinte propriedade ao arquivo partner.cfg:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   Se a propriedade não estiver configurada ou for comentada, a ferramenta de provisionamento usará o processo padrão de seleção de conexões PSTN.

Instruções para executar

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

Windows

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

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

Execute as etapas a seguir para executar a ferramenta no macOS:

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

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

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

Depois que o modelo de integração do Webex for BroadWorks for atualizado para oferecer suporte à migração, solicite à equipe de contas da Cisco que ative a opção “habilitado para combinação de parceiros de atacado” no nível do parceiro. Essa configuração permite que a ferramenta de provisionamento adicione automaticamente pacotes de atacado aos clientes existentes do Webex for 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 de atacado 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 for BroadWorks. Você deve executar a ferramenta de provisionamento com uma manutenção de argumentos.

Fase pós-migração: é a fase final em que os administradores podem converter completamente o BroadWorks em atacado. Você deve executar a ferramenta de provisionamento com um argumento após a migração.

Registros do terminal

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

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

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

Saída

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

O sistema gerará um arquivo Provisioning_Report_*.csv no diretório output/consolidated_reports/. Esse arquivo contém detalhes de sucesso e falha de cada entidade e suas configurações, fornecendo um relatório abrangente de provisionamento.

A ferramenta de provisionamento também gera um arquivo Provisioning_Statistics_*.csv no diretório output/consolidated_reports/. Esse relatório contém as contagens de clientes, locais, usuários, dispositivos e recursos de grupo provisionados com sucesso e sem sucesso.

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

Figura 8: Partner Hub

Figura 9: Control Hub

Figura 10: Dispositivos

Figura 11: Chamando

Restrições pós-provisionamento

Quando o provisionamento for concluído para uma migração do BroadCloud, as seguintes ações serão bloqueadas:

• Portal CAP — Adicionando usuários ou dispositivos portados.
• Portal SP — Criação de pedidos ADD com dispositivos ou números.
• API RSB — Criação de pedidos ADD com dispositivos ou números e criação de usuários. Pedidos do RSB ADD feitos com dispositivos ou números serão rejeitados.

Migração de BroadCloud para atacado — Limitação de registro de dispositivos

Para administradores parceiros que migram clientes do BroadCloud para o Wholesale na mesma região, os dispositivos podem ser adicionados no Wholesale após a execução da ferramenta de provisionamento. No entanto, esses dispositivos se tornarão elegíveis para registro na plataforma Webex somente após a conclusão da migração (movimentação do dispositivo) para o local correspondente.

Essa limitação não se aplica a:

• Clientes migrando da Broadworks/W4B para a Wholesale.
• Migrações de BroadCloud para atacado em diferentes regiões.

Orientação recomendada

Para evitar problemas de registro de dispositivos, conclua a migração de movimentação de dispositivos em nível de localização antes de tentar registrar dispositivos na plataforma Webex para migrações de BroadCloud para Wholesale na mesma região.

Para BroadCloud

Para parceiros do 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 aparências de chamadas compartilhadas (SCA).

No portal do provedor de serviços, uma solicitação de migração pode incluir até 50 clientes. No máximo 10 solicitações podem ser enviadas em um dia.

Os administradores podem ativar a reversão automática 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 suporta migrações para a mesma região e para diferentes regiões com o NS Sync, mas somente para migrações bem-sucedidas. Para aqueles que falharam, os administradores devem aumentar um Cisco TAC antes de solicitar a reversão.

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

• Migração — selecione essa 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 essa 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. Esse CSV deve listar somente 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: Locais de exportação como CSV

Ative a opção de desconectar números

Quando você usa o mesmo tronco SIP para Webex Calling uma operadora BroadCloud, os administradores devem usar a opção Desconectar números. Isso impede que os números de telefone recebam chamadas após a migração no BroadCloud.

Para ativar essa opção,

1. No arquivo partner.cfg, defina DISCONNECT_NUMBERS_FROM_RIALTO = yes.
2. Execute novamente a ferramenta de migração usando o mesmo arquivo customer.json e o partner.cfg atualizado.

Se os números não conseguirem se desconectar, faça uma solicitação de TAC da Cisco.

Para Cisco BroadWorks e Webex para BroadWorks

Para migrações do Cisco BroadWorks e do Webex for BroadWorks, a ferramenta é executada no servidor de aplicativos Cisco BroadWorks secundário na rede do parceiro e se conecta ao AS por meio do OCI-P. Ele usa o arquivo JSON de saída do Transform Tool (customer.json) como entrada e executa os comandos OCI-P para migrar dispositivos e soft clients.

Em caso de 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 atacado.
2. Os usuários que usam o cliente UC-One redirecionarão 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 aparências de chamadas compartilhadas no atacado para migrações do BroadCloud. [Essa etapa é aplicável somente às migrações do BroadCloud].

6. Se o administrador estiver operando a ferramenta por trás de um proxy corporativo, siga as etapas abaixo para configurar e executar o script de provisionamento.

   Procedimento de configuração

   1. Abra o arquivo devicemove.sh.
   2. Localize a variável PROXY_HOST e descomente-a (remova o # inicial de devicemove.sh).

   3. Defina o valor PROXY_HOST como:

      PROXY_HOST=<proxy-host>

   4. Localize a variável PROXY_PORT e descomente-a (remova o # inicial de devicemove.sh).

   5. Defina o valor PROXY_PORT como:

      PROXY_PORT=<proxy-port>

   6. Localize a variável PROXY_SCHEME e descomente-a (remova o # inicial de devicemove.sh). Essa etapa é opcional; se permanecer comentada, o valor padrão para PROXY_SCHEME será HTTP.

   7. Defina o valor PROXY_SCHEME como:

      PROXY_SCHEME=<proxy-scheme>

   8. Salve e feche o arquivo devicemove.sh.
   9. Abra o arquivo partner.cfg e adicione o refresh_token necessário.
   10. Verifique se o host, o nome de usuário e a senha do BroadWorks estão configurados corretamente em partner.cfg

   11. Execute o script:

       ./devicemove.sh

SCP e SSH

1. SCP, a ferramenta de movimentação de dispositivos, para o Cisco BroadWorks Application Server secundário.
2. SSH para o 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 Geradora de Token) no arquivo conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

   Se os administradores quiserem enviar e-mails de convite para seus usuários durante a migração, eles devem remover o comentário da propriedade “send_subscribers_welcome_email=true” no arquivo conf/partner.cfg. Caso contrário, a propriedade deve permanecer inalterada.

4. Verifique se o caminho do ambiente JDK/JRE 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 os grupos específicos em vez de todos os grupos em uma empresa.

Telefones Polycom

Para mover telefones Polycom do Cisco BroadWorks para o Wholesale Calling, um administrador parceiro deve criar um novo arquivo de tipo de perfil de identidade/dispositivo no nível do sistema no Cisco BroadWorks para cada modelo de dispositivo Polycom. Consulte a figura 14 e faça o upload do arquivo personalizado device-move-tool/conf/deviceprofile/ {region} /polycom_vvx.cfg. Depois de fazer o upload do 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 em seu sistema).

É 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 do dispositivo no nível do grupo ou no nível do dispositivo.
   Atuar no nível do grupo ou no nível 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 que o Cisco BroadWorks Application Server reinicialize os telefones no nível do grupo ou no nível 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 DMS. Webex Calling

Figura 14: Arquivo de tipo de perfil de identidade/dispositivo adicionado

Instruções para executar

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

A ferramenta de movimentação de dispositivos é executada a partir do 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=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9

Registros do terminal

A seguir estão os registros 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 on-line e prontos para fazer/receber 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 se tornaram ativos. Consulte a figura 16 para ver um exemplo de quais números estão ativos:

Figura 16: Números ativos

Se o administrador estiver operando a ferramenta por trás de um proxy corporativo, siga as etapas abaixo para configurar e executar o script devicemove.

Etapas para configurar e executar o script devicemove

1. Abra o arquivo devicemove.sh.
2. Localize a variável HTTPS_PROXY_HOST e descomente-a (remova o # inicial).

3. Defina o valor HTTPS_PROXY_HOST como:

   HTTPS_PROXY_HOST=<proxy-host>

4. Localize a variável HTTPS_PROXY_PORT e descomente-a (remova o # inicial).
5. Defina o valor HTTPS_PROXY_PORT como:

   HTTPS_PROXY_PORT=<proxy-port>

6. Salve e feche o arquivo devicemove.sh.
7. Abra o arquivo partner.cfg e adicione o refresh_token necessário.
8. Verifique se o host, o nome de usuário e a senha do BroadWorks estão configurados corretamente em partner.cfg.
9. Execute o script:

   ./devicemove.sh

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

Para BroadCloud Carrier

Os administradores podem definir rollback_to_broadcloud=True em conf/partner.cfg para ativar a reversão automática. Isso retorna os dispositivos para o BroadCloud após a migração bem-sucedida na mesma região ou entre regiões com o NS Sync. Para migrações que falharam, entre em contato Cisco TAC antes de solicitar a reversão.

Para Cisco BroadWorks e Webex para BroadWorks

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

1. Abra um ticket com Cisco TAC para solicitar a reversão do dispositivo.
2. Execute a ferramenta de movimentação de dispositivos no modo de reversão no servidor de aplicativos BroadWorks secundário para reverter as migrações de dispositivos. Isso retornará o URL do DMS 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 Webex Calling equipe define o URL do DMS de volta para o URL do DMS do provedor de serviços nos perfis do dispositivo em. Webex Calling
4. Os administradores do parceiro devem desativar ou excluir os números de telefone no Webex Calling portal do Control Hub.
5. Os administradores parceiros devem transferir os números de telefone PSTN de volta para o Cisco BroadWorks.

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

Siga as etapas abaixo para executar a ferramenta de movimentação do dispositivo 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= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

Reverter números

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

Registros do terminal

Obteremos os seguintes registros no terminal quando a ferramenta de movimentação de dispositivos for executada com sucesso para reverter a operaçã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