Ferramentas de migração para a transição de soluções BroadWorks, Webex para BroadWorks e BroadCloud para RTM por atacado

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

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

Os administradores de parceiros executam essa ferramenta de utilitário do gerador de token pelo menos uma vez antes de iniciar a execução de 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 de parceiros façam logon via navegador da web para obter o TOKEN exclusivo necessário para atualizar os arquivos de configuração de parceiros para as ferramentas de migração.

Pré-requisitos

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

Defina o caminho do ambiente JRE/JDK no token_generator.sh para MAC e token_generator.bat para Windows. Se o caminho JAVA _ HOME já existir, ele será reutilizado pela ferramenta.

• MAC: JAVA _ HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA _ HOME=C:\Progra~1\Java\jre1.8.0 _ 321

Instruções a serem executadas

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

Windows:

token_generator. bat

MacOS:

./token_generator.sh 

Saída:

Nome da ferramenta: Versão da ferramenta de gerador de token: 1.13.0 Carregue a URL no seu navegador da Web: http://localhost:8080 

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

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

Figura 3: Fazer logon com o Cisco Webex

Figura 4: Janela de credenciais

Figura 5: Geração de token

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

Ativar conectividade OCI-P

A ferramenta de movimentação do dispositivo se comunica com o BroadWorks através de comandos OCI-P, para habilitar a conectividade OCI-P, use as etapas abaixo:

Etapa 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 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 acima, use o comando set para redefinir suas configurações.

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

Altere o diretório para o proxy OCI:

 AS _ CLI> cd /Applications/OpenClientServer/OCIProxy 

Execute a CLI a seguir 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 acima, use o comando set para redefinir suas configurações.

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

Altere 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 OCI:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> obter a descrição do endereço ======================== 127.0.0.1 local como 

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

 AS _ CLI/Maintenance/ManagedObjects> obtenha Broadworks e verifique se sua saída parece OK. Veja abaixo a saída de amostra: AS _ CLI/Manutenção/ManagedObjects> obtenha BroadWorks BroadWorks Managed Objects ========================== * Servidor: Identidade ..............: COMO Versão ...............: R el_ 21.sp1 _ 1.551 Estado administrativo... Desbloqueado * Aplicativos: Nome Versão Implantada Estado Administrativo Efetivo Estado ========================================================================================= ExecuçãoAndProvisioning 21.sp1 _ 1.551 true Desbloqueado Desbloqueado FlashPolicy 21.sp1 _ 1.551 false Desbloqueado Desbloqueado OpenClientServer 21.sp1 _ 1.551 true Desbloqueado Desbloqueado WebContainer 21.sp1 _ 1.551 true Desbloqueado Desbloqueado 4 entradas encontradas. * Aplicativos hospedados: Nome Versão Contexto Caminho Implantado ================================================================== CommPilot 21.sp1_1.551 / verdadeiro DeviceManagementFiles 21.sp1_1.551 /DeviceManagement verdadeiro JWSFiles 21.sp1_1.551 /FileRepos true MediaFiles 21.sp1_1.551 /media true OCIFiles 21.sp1_1.551 /ocifiles verdadeiras 5 entradas encontradas. 

Verifique se o servidor de cliente aberto está implantado e ativo

Use os comandos abaixo para implantar e iniciar o servidor de cliente aberto no servidor de aplicativos secundário se ele não estiver implantado ou ainda não tiver iniciado.

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

AS_CLI/Maintenance/ManagedObjects> implantar aplicativo OpenClientServer

Etapa 2 : Inicie o servidor com este comando:

AS_CLI/Maintenance/ManagedObjects> iniciar aplicativo OpenClientServer

Ativar ativação de números

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

Etapa 1 : Execute o comando de ativação do número:

 AS _ CLI> cd SubscriberMgmt/NumberActivation 

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

 AS _ CLI> definir dnMode groupAndUserActivationEnabled 

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

Para BroadCloud

A ferramenta de extração é integrada no portal do Provedor de Serviços BroadCloud. Um administrador do 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 ao 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.

Os números abaixo mostram o portal do provedor de serviços.

Figura 6: Portal do Provedor de serviços

Figura 7: Portal do Provedor de serviços

Para Cisco BroadWorks e Webex para BroadWorks

1. A ferramenta de extração é executada no servidor de aplicativos Cisco BroadWorks secundário na rede parceira e se conecta via OCI-P.
2. A ferramenta extrai dados brutos da empresa, do grupo, números, usuários, serviços, dispositivos e de clientes soft 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 a ferramenta de extração binários para o servidor de aplicativos do Cisco BroadWorks secundário.
2. O SSH para o servidor de aplicativos do Cisco BroadWorks secundário para configurar os pré-requisitos e executar a ferramenta de extração.
3. Configure o provedor de serviços e a ID do grupo a serem extraídos do Cisco BroadWorks no conf/exportTool.yml. Consulte o trecho de exemplo YAML abaixo:

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

4. Verifique se a ID de usuário, senha e nome de host secundários do servidor de aplicativos do Cisco BroadWorks estão corretas no arquivo conf/partner.cfg:

    BROADWORKS _ USER _ ID = admin BROADWORKS _ SENHA = admin BROADWORKS _ HOST _ NOME = ATUALIZAÇÃO do _ localhost TOKEN = Token de atualização do administrador do parceiro copiado da ferramenta Gerador de tokens. MIGRAÇÃO _ MODE = Os valores suportados são webex_for_broadworks_to_wholesale. O valor padrão é broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale para o Webex para migrações de BroadWorks. 

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

5. Modifique o caminho de ambiente JDK/JRE no arquivo export.sh se o caminho de ambiente JDK/JRE do servidor de aplicativos secundário do Cisco BroadWorks for diferente do arquivo:

    JAVA _ HOME=/usr/local/java/java_base

Instruções a serem executadas

Execute o comando abaixo no servidor de aplicativos Cisco BroadWorks secundário a partir do diretório de ferramentas de extração:

./export.sh

Registros de terminal

Os seguintes registros estão disponíveis no terminal na exportação bem-sucedida: Executando a ferramenta de exportação de dados BroadSoft:

 Executando BroadSoft Data Export Tool ************************************************ Iniciando Exportação Ferramenta v: 1.15.0 Exportação iniciada para SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Exportando usuários para SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Exportação usuários concluídos para SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Exportação concluída para SP=collabmigrationtestSP _engg, Group=collabmigrationtestGRP _engg Exportação concluída Exportação Dump Zip Diretório: output/20221017223452 _ ExportTool Export Dump Zip Nome do arquivo:extracted_data_1666060 500618.zip Zip arquivo com o nome extracted_data_1666060 500618.zip foi criado processo de criação do arquivo ZIP concluído Exportados arquivos convertidos como arquivo ZIP ************************************************** 

Saída

Um arquivo ZIP de saída (extracted_data_.zip ) estará disponível no mesmo diretório de ferramenta de extração. Use o comando abaixo para visualizar e usar o arquivo ZIP para a entrada Ferramenta de transformação:

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

Essa ferramenta de transformação é executada para todas as migrações. A ferramenta de transformação é executada em qualquer computador, incluindo o laptop de administrador de um parceiro e usa as APIs Públicas Webex. Ele lê o arquivo ZIP de saída de ferramenta de extração (extracted_data_.zip ) como uma entrada e transforma o XML bruto em um formato JSON que é 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 TOKEN _ de ATUALIZAÇÃO (Token copiado da ferramenta Gerador de token) e o NOME _ OF _ MAIN _ LOCALIZAÇÃO no arquivo conf/partner.cfg:

    ATUALIZAÇÃO _ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NOME _ DE _ PRINCIPAL _ LOCALIZAÇÃO=Principal 

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

    PROVISIONING _ ID=YmE4MjFkZYTYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1 

   Para obter uma verificação mais completa do endereço de e-mail do cliente, você pode, opcionalmente, definir o PROVISIONING _ ID.
3. Configure informações ausentes no arquivo input/customers.csv (consulte a próxima seção) se estiver faltando.
4. Adicione o endereço de e-mail do usuário final no arquivo input/users.csv.
5. Se novos telefones forem 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 apenas se os administradores de parceiros quiserem provisionar novos telefones em chamadas por atacado.
6. Converta os Call Centers do BroadWorks nos CxEssentials usando o arquivo input/cxessentials.csv.
7. Opcionalmente, ative a propriedade ATUALIZAR _ ALL _ CALL _ CENTERS _ TO _ CX _ ESSENCIALS para converter todos os centros de chamadas em CxEssentials.
8. Use o arquivo input/locations.csv para suportar a migração de grandes empresas que permite aos administradores migrar as localizações de seus clientes por local
9. Opcionalmente, ative 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" no arquivo conf/partner.cfg

Preenchimento da entrada/customers.csv

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

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

Instruções a serem executadas

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

2. Execute a ferramenta de transformação:

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

Pré-verificação de 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 do cliente e o e-mail principal. Se o valor do 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 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 obter as informações do cliente, a Ferramenta de transformação também executará a API de pré-verificação para os e-mails do assinante.

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

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

Registros de terminal

Os seguintes registros no terminal em transformação bem-sucedida:

Relatório resumido Empresas BroadWorks que podem ser migradas com sucesso: 1 empresas BroadWorks que não podem ser migradas: 0 usuários do BroadWorks que podem ser migrados com êxito: 4 usuários do BroadWorks que não podem ser migrados: 0 Telefones que podem ser migrados com êxito: 3 Telefones não compatíveis com o 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 . 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 Extrair e Transformar com os novos dados. O arquivo de relatório de exceção de exemplo como segue:

Relatório de exceção Ter Oct 18 08:12:09 2022 Empresas com comunicação Barring Recomendação de recursos: configurar manualmente o Plano de chamadas de saída no Control Hub ________________________________________________________________________________ collabmigrationtestGRP _engg 

Saída

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

{ "cliente": { "provisioningId": "!!!!!!!!!! SUBSTITUIR_COM_PROVISIONINGID !!!!!!!!!!", "pacotes": [ "webex_calling", "common_area_calling"], "externalId":external_id_engg_grp1", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrPostalCode": "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": "América/New_"York", "idioma":en_us", "números": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+152055551101" } } } }, "broadworks_info": {"service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg"}, "assinantes": [ { "amareswaranvel+benjaminjack@gmail.com": { "assinante": { "customerId": "!!!!!!!!!! SUBPLACE_COM_CUSTOMERID !!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "pacote": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extension": "1102" }}, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": verdadeiro, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnAnsedCalls": { "ativado": true, "greeting": "PADRÃO", "numberOfRings": 3 }, "MessageStorage": { "mwiEnabled": verdadeiro, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } }], "dispositivos": [ { "cisUuid": "!!!!!!!!!! SUBPLACE _ WITH _ PERSONID !!!!!!!!!!", "produto": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!! SUBPLACE _ WITH _ CUSTOMERID !!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Oliver", "primaryPhoneNumber": "+152055551103", "extension": "1103" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": verdadeiro, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnAnsedCalls": { "ativado": true, "greeting": "PADRÃO", "numberOfRings": 3 }, "MessageStorage": { "mwiEnabled": verdadeiro, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } }], "dispositivos": [ { "cisUuid": "!!!!!!!!!! SUBPLACE _ WITH _ PERSONID !!!!!!!!!!", "produto": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!! SUBPLACE _ WITH _ CUSTOMERID !!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "pacote": "webex_calling", "provisioningParameters": { "firstName": "Leo", "lastName": "Jackson", "primaryPhoneNumber": "+152055551104", "extension": "1104" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": verdadeiro, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnAnsedCalls": { "ativado": true, "greeting": "PADRÃO", "numberOfRings": 3 }, "MessageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } }], "devices": [] }}, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!! SUBPLACE _ WITH _ CUSTOMERID !!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+152055551101", "extension": "1101" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": verdadeiro, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnAnsedCalls": { "ativado": true, "greeting": "PADRÃO", "numberOfRings": 3 }, "MessageStorage": { "mwiEnabled": verdadeiro, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } }}], "devices": [ { "cisUuid": "!!!!!!!!!! SUBSTITUIR_COM_ !!!!!!!!!!", "produto": "DMS Cisco 8811", "mac": "F87B204E4066" }] }}", "auto_attendants": [], "call_queues": [], "hunt_groups": [], "horários": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Automated Voice Portal", "firstName": "Automated", "lastName": "Voice Portal", "languageCode": "en_us", "phoneNumber": "+15205551105", "ramal": "1105" }], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile" ], "connect_client_to_upgrade_to_webex_app": [], "Locais": [], "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 de administrador do parceiro) e usa as APIs Públicas Webex. Ele lê o arquivo JSON ( customer.json ) de saída da ferramenta de transformação como uma entrada e provisionamento dos 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 de ferramentas de provisionamento:

1. Instale o Java 8, 11 ou 17 no computador. O Java está disponível de várias fontes, incluindo:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. Depois de baixar e extrair os binários das ferramentas de migração, defina a variável de ambiente JAVA _ HOME no provisioning_tool.sh para MAC e provisioning_tool.bat para Windows.
3. O arquivo partner.cfg:
   • Defina o TOKEN _ PROVISIONING _ ID e ATUALIZAÇÃO _ (Token copiado da ferramenta Gerador de token). Os administradores de parceiros devem entrar em contato com a equipe de contas para obter o PROVISIONING _ ID:

      ATACESALE _ PROVISIONING _ ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 ATUALIZAÇÃO _ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • Defina PERMITIR E-MAILS _ ADMIN _ INVITE _ para falso, se o parceiro não quiser enviar e-mail de boas-vindas aos usuários. O valor padrão é verdadeiro.

4. Use a propriedade WEBEX4BWKS _ E-MAIL _ ASSUNTO para migrações Webex para BroadWorks para enviar o assunto de solicitação de alteração de senha por e-mail para assinantes Webex para BroadWorks.
5. Use a propriedade WEBEX4BWKS _ E-MAIL _ 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.

Para migrações BroadCloud mesma região:

1. A ferramenta ignorará os números, dispositivos e o provisionamento de Aparências de chamadas compartilhadas.
2. A ferramenta criará usuários e usuários virtuais com ramal e ramal temporário.

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

1. A ferramenta fornecerá números, dispositivos e Aparências De Chamadas Compartilhadas.
2. A ferramenta criará usuários e usuários virtuais com números de telefone e ramal reais.
   Todas as migrações do BroadCloud da Europa são para outra região.

Instruções a serem executadas

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

Windows

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

Para provisionar um único cliente: provision.bat-input= Para provisionar vários clientes: provision.bat -input= 

macOS

Execute as seguintes etapas para executar a ferramenta no macOS:

Para provisionar um único cliente: ./transform.sh -input= Para provisionar vários clientes: ./transform.sh -input= 

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

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

Execute a ferramenta de provisionamento com um argumento adicional para a migração do Webex para BroadWorks para atacado.

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 para BroadWorks. Você deve executar a ferramenta de provisionamento com um argumento maintenance .

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

Registros de terminal

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

Nome da ferramenta: Versão da ferramenta de provisionamento: Arquivo de ********** processamento 1.15.0 iniciado: input/customer.json **************** Provisioning Cliente Aguardando o cliente external_id_engg_grp 1 concluir o provisionamento... Aguardando o cliente external_id_engg_grp 1 concluir o provisionamento...   Status external_id_engg_grp do cliente 1: Números de provisionamento provisionados Provisionamento de usuários Recursos do usuário Provisionamento Saudações Agendas de provisionamento Provisionamento de dispositivos Provisionamento de exibições de chamadas compartilhadas Provisionamento de assistentes automáticos Provisionamento de filas de chamadas Provisionamento de grupos de busca Provisionamento de pagings Parques de chamada Provisionamento Provisionamento de capturas de chamadas Portal ********** de voz Concluído: entrada/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 erros dentro dos arquivos output/<external_id>/*.success/error . Revise os registros de erro e sucesso da saída para verificar o provisionamento bem-sucedido.

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

Figura 8: Hub do parceiro

Figura 9: Hub de controle

Figura 10: Dispositivos

Figura 11: Ligando

Para BroadCloud

Para parceiros BroadCloud, use o portal do provedor de serviços para enviar uma solicitação de migração de números, dispositivos e migrações SCA.

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

Os números abaixo mostram o portal do provedor de serviços.

Figura 12: Portal do Provedor de serviços

Figura 13: Portal do Provedor de serviços

Para Cisco BroadWorks e Webex para BroadWorks

Para o Cisco BroadWorks e o Webex para migrações de BroadWorks, a ferramenta é executada no servidor de aplicativos Cisco BroadWorks secundário na rede parceira e se conecta ao AS via 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 soft clients.

Na operação bem-sucedida, a ferramenta de transferência do dispositivo será:

1. Desregistrar dispositivos do Cisco BroadWorks e registrá-los no Atacado.
2. Os usuários que usam o cliente UC-One serão redirecionados para o aplicativo Webex no primeiro logon.
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 apresentações de chamadas compartilhadas no atacado para migrações do BroadCloud. [Esta etapa é aplicável apenas para migrações do BroadCloud].

SCP e SSH

1. SCP, a ferramenta de transferência do dispositivo para o servidor de aplicativos Cisco BroadWorks secundário.
2. O SSH para o servidor de aplicativos do Cisco BroadWorks secundário para configurar os pré-requisitos e executar a ferramenta de movimentação do dispositivo.

Pré-requisitos

1. Defina o TOKEN _ de ATUALIZAÇÃO (Token copiado da ferramenta Gerador de token) no arquivo conf/partner.cfg:

    REFRESH _ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

2. Verifique se a ID de usuário, senha e nome de host secundários do servidor de aplicativos do Cisco BroadWorks estão corretas no arquivo conf/deviceMoveTool.conf:

    BROADWORKS _ USUÁRIO _ ID = admin BROADWORKS _ SENHA = admin BROADWORKS _ HOST _ NOME = localhost 

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

    JAVA _ HOME=/usr/local/java/java_base

4. 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 transferir telefones Polycom do Cisco BroadWorks para chamadas por atacado, um administrador de parceiros deve criar um novo Arquivo de tipo de perfil de identidade/dispositivo no nível do sistema no Cisco BroadWorks each modelo de dispositivo Polycom. Consulte a figura 14 e carregue o arquivo de arquivo personalizado device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg . Depois de carregar o novo arquivo de dispositivo, verifique se o arquivo recém-criado existe no nível de Grupo. Certifique-se também que o file migration_%BWMAC ADDRESS%.cfg não entre em conflito com qualquer arquivo existente em seu sistema).

Ele é usado internamente pela ferramenta de movimento do dispositivo.

O processo de migração para telefones Polycom:

1. A ferramenta de transferência do dispositivo substitui file %BWMACADDRESS%.cfg no nível do dispositivo por polycom_vvx 2.cfg. Observe que este arquivo se refere a migration_%BWMACADDRESS%.cfg.
2. Recrie os perfis de dispositivo no nível do grupo ou no nível do dispositivo.
   Atuar no nível do grupo ou do dispositivo depende da configuração do deviceLevelRebuild do parâmetro no arquivo device-move-tool/conf/partner.cfg.
3. A ferramenta de transferência do dispositivo pede ao servidor de aplicativos do Cisco BroadWorks para reinicializar 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 aos telefones Polycom que baixem e processem migration_%BWMACADDRESS%.cfg, o que define o device.prov.serverName para 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: Adicionar arquivo de tipo de perfil de identidade/dispositivo

Instruções a serem executadas

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

A ferramenta de transferência do dispositivo é executada do servidor de aplicativos Cisco BroadWorks secundário dentro do diretório de ferramentas de transferência do dispositivo:

Para mover dispositivo de um único cliente: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Para mover dispositivo de vários clientes: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Além disso, a ferramenta de mover dispositivo suporta migrar um único/específico telefone(s) a partir da versão 1.35.0. Use o comando abaixo: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Registros de terminal

A seguir estão os registros no terminal sobre a execução bem-sucedida da ferramenta de migração do dispositivo para a migração do dispositivo:

Nome da ferramenta: Versão da ferramenta de transferência do dispositivo: Ferramenta de dispositivos 1.15.0 iniciada... Dispositivos válidos para migração: ------------------------------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------- | Tipo De Dispositivo | Mac | Versão | E-mail | ------------------------------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Deseja migrar todos esses dispositivos? ([Y]es ou [N]o) sim Carregando perfis de dispositivos para DMS Cisco MPP LC Recriar processo de dispositivo iniciado Recriar processo de dispositivo concluído com êxito Processo de reinicialização iniciado Processo de reinicialização concluído com êxito Modificando perfis para o Business Communicator em grupo collabmigrationtestGRP _engg Ativar o processo de números de telefone webex iniciado para a ID da organização do cliente: 85ea1d6d-ff9e-41a1-843f-7362aaf12b4c Ative o processo de números de telefone webex concluído para a ID da organização do cliente: 85ea1d6d-ff9e-41a1-843f-7362aaf12b4c Desativar o processo de números de telefone do broadworks iniciado para groupId: collabmigrationtestGRP _engg Desativar o processo de números de telefone do Broadworks concluído para groupId: collabmigrationtestGRP _engg Migração de dispositivos concluída 

Saída

Após a migração do dispositivo, os dispositivos ficaram 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 ficaram ativos. Consulte a figura 16 para ver um exemplo de números ativos:

Figura 16: Números ativos

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

Para a operadora BroadCloud

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

1. Abra um ticket com o Cisco TAC para solicitar uma reversão do dispositivo.
2. Execute a ferramenta de movimento do dispositivo no modo de reversão:
   • Os números de telefone não serão atribuídos do Webex Calling, deixando os usuários e serviços apenas 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 alternativos e telefones serão recriados no BroadCloud.
   • Os telefones serão reinicializados.
3. Os administradores de parceiros devem transferir os números de telefone PSTN de volta para a operadora do BroadCloud.

Para Cisco BroadWorks e Webex para BroadWorks

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

1. Abra um ticket com o Cisco TAC para solicitar uma reversão do dispositivo.
2. Execute a ferramenta de transferência do dispositivo no modo de reversão no servidor de aplicativos BroadWorks secundário para reverter as migrações do dispositivo. Isso definirá a URL DMS de volta para a URL 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 a URL DMS de volta para a URL 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 do Control Hub.
5. Os administradores de parceiros devem transferir os números de telefone PSTN de volta para o Cisco BroadWorks.

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

Siga as etapas abaixo para executar a ferramenta de movimento do dispositivo no modo de reversão:

Execute o comando abaixo no servidor de aplicativos Cisco BroadWorks secundário dentro do diretório de ferramentas de movimento do dispositivo:

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 de terminal

Obteremos os seguintes registros no terminal ao executar com êxito a ferramenta de movimento do dispositivo para reverter a operação:

Reverter perfis

Nome da ferramenta: Versão da ferramenta de transferência do dispositivo: Ferramenta do dispositivo 1.15.0 iniciada para reverter processo... Dispositivos que podem ser transferidos de volta do Webex Calling para BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | Tipo De Dispositivo | Mac | Versão | E-mail | ------------------------------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- Deseja transferir esses dispositivos do Webex Calling para o BroadWorks? (Sim, Y, Não, N):  sim Carregamento de perfis de dispositivos para DMS Cisco MPP LC Recriar processo de dispositivo iniciado Recriar processo de dispositivo concluído com êxito Processo de reinicialização iniciado Processo de reinicialização concluído com êxito Migração de dispositivos concluída 

Reverter números

Nome da ferramenta: Versão da ferramenta de transferência do dispositivo: 1.15.0 Deseja continuar revertendo números para o Broadworks?  ([Y]es ou [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] Iniciando reverter Ativar o processo de números de telefone do Broadworks iniciado para groupId: collabmigrationtestGRP _engg Ative o processo de números de telefone do Broadworks concluído para groupId: collabmigrationtestGRP _engg Processo reverso de migração do dispositivo concluído com êxito