Os telefones compatíveis serão criados automaticamente e atribuídos aos usuários no Webex Calling pela ferramenta de provisionamento. Os telefones marcados "Sim" na coluna "Suportado na ferramenta de transferência do dispositivo" também serão movidos automaticamente do Cisco BroadWorks ou BroadCloud para o Webex Calling quando a ferramenta de transferência do dispositivo for executada. Os telefones marcados "Não" nessa coluna precisam de uma intervenção manual para alterar o URL 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 a seção Ferramenta de transformação deste artigo para obter mais informações sobre newphones.csv).

Os administradores de parceiros executam essa ferramenta utilitária do gerador de tokens pelo menos uma vez antes de começar a executar as ferramentas de migração. A execução desta ferramenta será uma atividade única depois que a conta do parceiro for integrada à solução Wholesale RTM. Essa ferramenta permite que os administradores de parceiros façam logon através do 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

Após o download, extraia os binários da ferramenta 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 HOME JAVA_já existir, ele será reutilizado pela ferramenta.

• Mac: JAVA_HOME="/USUÁRIOS/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\Progra~1\Java\jre1.8.0_321

Instruções para executar

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

Windows:

token_generator. bat

MACOS:

./token_generator.sh

Resultado:

Nome da ferramenta: Versão da ferramenta do gerador de tokens: 1.13.0 Carregue o 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 para uso posterior.

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

Figura 3: Efetuar 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 movimentação do dispositivo no servidor BroadWorks secundário.

Ativar conectividade OCI-P

A ferramenta de movimento do dispositivo se comunica com o BroadWorks por meio de comandos OCI-P. Para ativar 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 alterar para o diretório GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

Etapa 3: Use a CLI para configurar o provisionamento de 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.

 À MEDIDA_que CLI/Maintenance/ManagedObjects> obtém o BroadWorks e verifique se sua saída está OK. Veja abaixo o resultado da amostra: COMO_CLI/Manutenção/ManagedObjects> obtém BroadWorks Managed Objects ========================== * Servidor: Identidade..............: COMO Versão...............: Rel_21.sp1_1.551 Estado Administrativo..: * Aplicações desbloqueadas: Nome Versão Implantada Estado administrativo Execução efetiva do estado ========================================================================================= e provisionamento 21.sp1_1.551 verdadeiro Desbloqueado Flash desbloqueado 21.sp1_1.551 falso Desbloqueado Parado OpenClientServer 21.sp1_1.551 verdadeiro Desbloqueado Desbloqueado WebContainer 21.sp1_1.551 verdadeiro Desbloqueado Desbloqueado 4 entradas encontradas. * Aplicativos hospedados: Nome Versão Caminho de contexto Implantado ================================================================== 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 entradas encontradas. 

Verificar o servidor do cliente aberto 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 sido iniciado.

Etapa 1: Implante o servidor com o seguinte comando da interface de linha de comando:

AS_CLI/Maintenance/ManagedObjects> implementar a aplicação OpenClientServer

Etapa 2: Inicie o servidor com este comando:

AS_CLI/Maintenance/ManagedObjects> iniciar a aplicação OpenClientServer

Ativar ativação de números

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

Etapa 1: Executar o comando de ativação de números:

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 está integrada ao 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 para o mesmo cliente mais de 10 vezes por dia.
2. Baixe o arquivo de dados extraídos, em formato ZIP, por até 28 dias a partir da data de envio da solicitação.

As figuras 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 do parceiro e se conecta via OCI-P.
2. A ferramenta extrai os dados brutos da empresa, grupo, números, usuários, serviços, dispositivos e soft client 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 servidor de aplicativos Cisco BroadWorks secundário.
2. SSH para o servidor de aplicativos secundário do Cisco BroadWorks para configurar os pré-requisitos e executar a ferramenta de extração.
3. Configure o provedor de serviços e a ID de grupo a ser extraída do Cisco BroadWorks em conf/exportTool.yml. Consulte o exemplo abaixo do snippet YAML:

   ID-A do provedor de serviços:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - tudo 

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

   BROADWORKS_USUÁRIO_ID = admin BROADWORKS_SENHA = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = token de atualização do administrador do parceiro copiado da ferramenta Gerador de token. MODO DE MIGRAÇÃO_ = Os valores suportados são webex_for_broadworks_to_wholesale. O valor padrão é broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale para migrações do Webex para BroadWorks. 

   A propriedade ATUALIZAR_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 secundário JDK/JRE do servidor de aplicativos do Cisco BroadWorks for diferente do arquivo:

   JAVA_HOME=/usr/local/java/java_base

Instruções para executar

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

./export.sh

Registos do 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 a ferramenta de exportação de dados BroadSoft ************************************************ Iniciando a ferramenta de exportação v: 1.15.0 Exportação iniciada para SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportar usuários para SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg Exportar 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 Diretório Zip do despejo: output/20221017223452_ExportTool Export Dump Zip Nome do arquivo:extracted_data_1666060500618.zip Arquivo Zip com o nome extracted_data_1666060500618.zip foi criado o processo de criação do arquivo ZIP concluído Arquivos exportados 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 da ferramenta de transformação:

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 outubro  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 outubro  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 outubro  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 de outubro 17 22:34 saída/ drwxrwxr-x 2 bwadmin bwadmin 4096 de outubro 17 22:34 registros/ -rw-rw-r-- 1 bwadmin bwadmin 46341 de outubro 17 22:35 extracted_data_1666060500618.zip 

Esta ferramenta de transformação é executada para todas as migrações. A ferramenta de transformação é executada em qualquer computador, incluindo o laptop do administrador de um parceiro, e usa as APIs Webex Public. Ele lê o arquivo ZIP de saída da ferramenta de extração (extracted_data_.zip) 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 TOKEN_ATUALIZAR (token copiado da ferramenta geradora de token) e o NOME_DO LOCAL_PRINCIPAL_no arquivo conf/partner.cfg:

   ATUALIZAR_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NOME_OU_PRINCIPAL_LOCAL=Principal 

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

   PROVISIONAMENTO_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   Para obter uma verificação mais completa do endereço de e-mail do cliente, você pode, opcionalmente, definir a ID de PROVISIONAMENTO_.
3. Configure as informações ausentes no arquivo csv de entrada/customers.csv (consulte a próxima seção) se ausentes.
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 será necessário apenas se os administradores de parceiros quiserem provisionar novos telefones nas chamadas de varejo.
6. Converta os call centers do BroadWorks em CxEssentials usando o arquivo input/cxessentials.csv.
7. Opcionalmente, ative a propriedade ATUALIZAR_TODOS OS_CALL_CENTERS_PARA_CX_ESSENTIALS para converter todos os Call Centers para CxEssentials.
8. Use o arquivo input/locations.csv para oferecer suporte à migração de grandes empresas que permite aos administradores migrar os locais dos 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. Descomentar a linha "USAR_ENDEREÇO MAC__DE_SIP_REGISTER=sim" no arquivo conf/partner.cfg

Preenchendo a entrada/customers.csv

O arquivo input/customers.csv fornece dados que talvez estejam ausentes no Cisco BroadWorks ou no 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 para executar

Execute a ferramenta de transformação em qualquer sistema operacional. Use as etapas abaixo para executar a ferramenta no Windows e 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 solicitações de instalação pip python3 -m solicitações de instalação pip-oauthlib 

2. Execute a ferramenta de transformação:

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

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

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

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

pré-verificação

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

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

Registos do terminal

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

Relatório de resumo das empresas do BroadWorks que podem ser migradas com êxito: 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 que não sã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 saída//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 de extração e transformação com os novos dados. O arquivo de relatório de exceção de amostra da seguinte forma:

Relatório de exceção Ter 18 de outubro 08:12:09 2022 Empresas com recomendação de recurso de bloqueio de comunicação: 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// . O arquivo de exemplo customer.json é o seguinte:

{ "cliente": { "provisioningId": "!!!!!!!!!!SUBSTITUIR_com_Provisioningid!!!!!!!!!!", "pacotes": [ "webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "endereço": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "EUA" }, "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", "país": "EUA" }, "fuso horário": "America/New_York", "language": "en_us", "números": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } }, "broadworks_info": { "service_provider_id": "collabmigrationtestSP_engg", "group_id": "collabmigrationtestGRP_engg" }, "assinantes": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!SUBSTITUIR_com_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Benjamin", "lastName": "Jack", "primaryPhoneNumber": "+15205551102", "extensão": "1102" } }, "recursos": [ { "/v1/people/{personId}/features/correio de voz": { "ativado": true, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnansweredCalls": { "ativado": verdadeiro, "saudação": "PADRÃO", "numberOfToques": 3 }, "Armazenamento de mensagem": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "dispositivos": [ { "cisUuid": "!!!!!!!!!!SUBSTITUIR_COM_PERSONID!!!!!!!!!!", "produto": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!SUBSTITUIR_COM_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Lucas", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "recursos": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnansweredCalls": { "ativado": verdadeiro, "saudação": "PADRÃO", "numberOfToques": 3 }, "Armazenamento de mensagem": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "dispositivos": [ { "cisUuid": "!!!!!!!!!!SUBSTITUIR_COM_PERSONID!!!!!!!!!!", "produto": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } , { "amareswaranvel+leojackson@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!SUBSTITUIR_COM_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Leo", "lastName": "Jackson", "primaryPhoneNumber": "+15205551104", "extension": "1104" } }, "recursos": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnansweredCalls": { "ativado": verdadeiro, "saudação": "PADRÃO", "numberOfToques": 3 }, "Armazenamento de mensagem": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "dispositivos": [] } }, { "amareswaranvel+owenalex@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!SUBSTITUIR_POR_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+owenalex@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "Owen", "lastName": "Alexander", "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "recursos": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "ativado": verdadeiro, "saudação": "PADRÃO" }, "sendUnansweredCalls": { "ativado": verdadeiro, "saudação": "PADRÃO", "numberOfToques": 3 }, "Armazenamento de mensagem": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "dispositivos": [ { "cisUuid": "!!!!!!!!!!SUBSTITUIR_com_PERSONID!!!!!!!!!!", "produto": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "agendas": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "Portal de voz automatizado", "firstName": "Automatizado", "lastName": "Portal de voz", "languageCode": "en_us", "phoneNumber": "+15205551105", "ramal": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Perfil do dispositivo Engg" ], "connect_client_to_upgrade_to_webex_app": [], "localizações": [], "webex_for_broadworks_info": { "usuários": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

A ferramenta de provisionamento pode ser executada em qualquer máquina, geralmente no (laptop do administrador do parceiro) e usa as APIs públicas Webex. Ele lê o arquivo JSON de saída da ferramenta de transformação (customer.json) 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 da ferramenta de provisionamento:

1. Instale o Java 8, 11 ou 17 no computador. O Java está disponível a partir de muitas 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 em provisioning_tool.sh para MAC e provisioning_tool.bat para Windows.
3. O arquivo partner.cfg:
   • Defina a ID de _PROVISIONAMENTO_ e o TOKEN DE ATUALIZAÇÃO_ (token copiado da ferramenta geradora de token). Os administradores de parceiros devem entrar em contato com a equipe da conta para obter a ID de PROVISIONAMENTO_:

     ATACADO_PROVISIONAMENTO_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. Use a propriedade WEBEX4BWKS _ 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 as migrações do BroadCloud, mesma região:

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

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

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

Instruções para executar

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

Windows

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

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 da 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 a seguir:

Depois que o modelo de integração do Webex para BroadWorks for atualizado para oferecer suporte à migração, solicite à equipe de contas da Cisco a ativação da alternância de recursos "habilitado para mistura de parceiros por atacado" no nível do parceiro. Isso permitirá que os pacotes por atacado sejam adicionados às organizações de clientes Webex para BroadWorks existentes 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 os usuários do Webex para 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 uma manutenção do argumento.

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

Registos do terminal

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

Nome da ferramenta: Versão da ferramenta de provisionamento: 1.15.0 ********** Arquivo de processamento iniciado: input/customer.json Provisionamento **************** Cliente Aguardando o cliente external_id_engg_grp1 para concluir o provisionamento... Aguardando o cliente external_id_engg_grp1 concluir o provisionamento...   Status external_id_engg_grp1 do cliente: Números de provisionamento provisionados Usuários de provisionamento Recursos do usuário Saudações de provisionamento Agendas de provisionamento Dispositivos de provisionamento Aparências de chamadas compartilhadas Provisionamento Assistentes automáticos Provisionamento Filas de chamadas Provisionamento Grupos de busca Paginações de grupos de provisionamento Estacionamento de chamadas Provisionamento Atendimentos de chamadas Provisionamento Portal de voz ********** Arquivo concluído: entrada/cliente.json **************** 

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

Saída

A ferramenta de provisionamento gera relatórios de sucesso e erro nos arquivos de saída/<external_id>/*.success/error . Revise os registros de erros e êxito 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 do Hub de parceiros e do 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.

As figuras 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 BroadWorks, a ferramenta é executada no servidor de aplicativos Cisco BroadWorks secundário na rede parceira e se conecta ao AS por meio do OCI-P. Ele usa o arquivo JSON ( customer.json ) de saída da ferramenta de transformação como entrada e executa os comandos OCI-P para migrar dispositivos e soft clients.

Na operação bem-sucedida, a ferramenta de transferência 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 serão redirecionados para o aplicativo Webex no primeiro início de sessão.
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. [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. SSH para o servidor de aplicativos Cisco BroadWorks secundário para configurar os pré-requisitos e executar a ferramenta de transferência do dispositivo.

Pré-requisitos

1. Defina o TOKEN_de atualização (token copiado da ferramenta geradora de token) no arquivo conf/partner.cfg:

   ATUALIZAR_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USUÁRIO_ID = admin BROADWORKS_SENHA = admin BROADWORKS_HOST_NAME = localhost 

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

   Se os administradores desejam enviar e-mails de convite para seus usuários durante a migração, eles devem descomentar a propriedade "RESEND _ INVITATION _ EMAILS=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 as chamadas de 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 cada modelo de dispositivo Polycom. Consulte a figura 14 e carregue o arquivo personalizado device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg . Depois de carregar o novo arquivo de dispositivo, verifique se o arquivo recém-criado existe no nível do Grupo. Certifique-se também que o arquivo 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 de telefones Polycom:

1. A ferramenta de transferência do dispositivo substitui file %BWMACADDRESS%.cfg no nível do dispositivo por polycom_vvx 2.cfg. Este arquivo se refere a migration_%BWMACADDRESS%.cfg.
2. Recrie os perfis do 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 solicita ao servidor de aplicativos Cisco BroadWorks para reinicializar os telefones no nível de 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 pede aos telefones Polycom para baixarem e processarem migration_%BWMACADDRESS%.cfg, que define device.prov.serverName como https://plcm.sipflash.com.
   https://plcm.sipflash.com para a região dos EUA, outras regiões têm URLs diferentes.
5. O telefone Polycom baixa %BWMACADDRESS%.cfg de https://plcm.sipflash.com e será gerenciado pelo Webex Calling DMS.

Figura 14: Adicionar arquivo do tipo de perfil de identidade/dispositivo

Instruções para executar

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

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

Para a transferência do dispositivo um único cliente: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json Para a transferência do dispositivo de vários clientes: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json Além disso, a ferramenta de transferência do dispositivo suporta a migração de telefones individuais/específicos da versão 1.35.0. Use o comando abaixo: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

Registos do terminal

A seguir estão os registros no terminal em que a ferramenta de transferência do dispositivo foi executada com êxito para migração do dispositivo:

Nome da ferramenta: Versão da ferramenta de movimento do dispositivo: 1.15.0 Ferramenta do dispositivo 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 Processo de reconstrução do dispositivo Cisco MPP LC Iniciado Processo de reconstrução do dispositivo concluído com êxito Processo de reinicialização iniciado Processo de reinicialização concluído com êxito Modificar perfis do Business Communicator no grupo collabmigrationtestGRP_engg Ative o processo de números de telefone Webex iniciado na ID da organização do cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c O processo de ativação de números de telefone Webex foi concluído para a ID da organização do cliente: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c O processo de desativação dos números de telefone do BroadWorks foi 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 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 ficaram ativos. Consulte a figura 16 para ver um exemplo de quais números estão ativos:

Figura 16: Números ativos

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

Para 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 serão cancelados do Webex Calling, deixando 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.
   • Os números de telefone, os endereços de e-mail usados como alternateIds e os 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 BroadCloud Carrier.

Para Cisco BroadWorks e Webex para BroadWorks

O processo de reversão do Cisco BroadWorks e do 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 movimento do dispositivo no modo de reversão no servidor de aplicativos secundário do BroadWorks 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 reverter

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 mover dispositivo:

Reverter perfis

./devicemove.sh -input=  -revertProfiles

Reverter números

./devicemove.sh -input=  -revertNumbers

Registos do terminal

Obteremos os seguintes registros no terminal em execução bem-sucedida da ferramenta de transferência do dispositivo para operação de reversão:

Reverter perfis

Nome da ferramenta: Versão da ferramenta de movimento do dispositivo: 1.15.0 Ferramenta de dispositivo iniciada para o processo de reversão... Dispositivos que podem ser movidos de volta do Webex Calling para o 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 | ------------------------------------------------------------------------------------------------------------------- Você deseja transferir esses dispositivos de volta do Webex Calling para o BroadWorks? (Sim, Y, Não, N):  Sim Carregando perfis de dispositivos para DMS O processo de reconstrução do dispositivo foi iniciado O processo de reconstrução do dispositivo foi concluído com êxito O processo de reinicialização iniciado O processo de reinicialização foi concluído com êxito A migração do dispositivo foi concluída com êxito para o processo de desprovisionamento 

Reverter números

Nome da ferramenta: Versão da ferramenta de movimento 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 a reversão O processo de ativação dos números de telefone do Broadworks foi iniciado para groupId: collabmigrationtestGRP_engg O processo de ativação dos números de telefone do BroadWorks foi concluído para o groupId: collabmigrationtestGRP_engg Processo de reversão de migração de dispositivos concluído com êxito