- Página inicial
- /
- Artigo
Ferramentas de migração para fazer a transição para soluções Wholesale RTM
Execute a migração com o mínimo de pré-configuração. Facilite a execução dos comandos. Os administradores podem revisar seus dados após o provisionamento e fazer e receber chamadas imediatamente após a migração. Ele oferece suporte à atualização automática do aplicativo Webex para clientes UC-One.
Visão geral
O objetivo deste documento é fornecer instruções detalhadas sobre o uso de ferramentas para migrar do Cisco BroadWorks, Webex for BroadWorks e BroadCloud para o Wholesale e o Webex Calling. Este documento aborda um conjunto de ferramentas de migração projetadas para ajudar os clientes existentes do Cisco BroadWorks, Webex for BroadWorks e BroadCloud a migrar para a solução Wholesale Route-to-Market.
As ferramentas de migração têm como objetivo facilitar uma transição completa dos serviços BroadWorks para os serviços Wholesale. Eles não foram projetados para a coexistência a longo prazo de ambos os serviços dentro da mesma organização do cliente.
Impacto da migração
Os impactos pós-migração são os seguintes:
Administradores
Após a migração, os administradores devem:
- Comece a usar o Partner Hub e o Control Hub para configurar recursos em vez do CommPilot.
- Reconfigure quaisquer funcionalidades que não façam parte da migração.
Você precisa migrar manualmente os recursos que não forem migrados automaticamente após a conclusão da migração pelas ferramentas.
Usuários
As funcionalidades suportadas devem funcionar após a migração da mesma forma que funcionavam antes da migração. As funcionalidades de chamadas do Webex que não forem suportadas pela migração deverão ser reconfiguradas no Webex após a migração:
- Os usuários perderão seu histórico de chamadas e mensagens.
- Os usuários perderão todas as configurações e personalizações de suas respectivas linhas de chave e precisarão reconfigurar essas configurações após a migração. Exemplos incluem discagem rápida.
- Os usuários devem redefinir seus códigos de acesso e senhas no primeiro login.
- Os usuários que utilizam o cliente UC-One são obrigados a atualizar para o aplicativo Webex no primeiro acesso.
Arquitetura de ferramentas de migração
A arquitetura das ferramentas de migração consiste em quatro ferramentas diferentes:
- Ferramenta de extração—Extrai empresas, grupos, números, usuários, serviços, telefones e clientes de software do Cisco BroadWorks. Os parceiros da BroadCloud devem enviar uma solicitação de extração no Portal do Provedor de Serviços.
- Ferramenta de transformação—Transforma as informações extraídas pela ferramenta de extração em um arquivo JSON que pode ser editado.
- Ferramenta de provisionamento— Usa o arquivo de saída JSON da Ferramenta de Transformação para provisionar clientes, locais, números, usuários, serviços e telefones usando APIs públicas do Webex.
- Ferramenta de movimentação de dispositivos— Usa o arquivo de saída JSON da Ferramenta de Transformação para reconstruir os perfis e reiniciar os telefones, ativar números na solução Wholesale RTM e desativar números de telefone no Cisco BroadWorks.
- Esta ferramenta permite reverter perfis de telefone e de cliente de software, bem como a ativação de números, no Cisco BroadWorks.
- Os parceiros da BroadCloud devem enviar uma solicitação de migração no Portal do Provedor de Serviços.
A ilustração a seguir representa como as quatro ferramentas funcionam sequencialmente, comunicando-se com o Cisco BroadWorks, APIs públicas e enviando métricas para os serviços Webex para análises futuras, após o administrador iniciar as tarefas de migração.
Figura 1. Ferramentas de migração
Requisitos
Antes de executar as ferramentas de migração, o parceiro deve atender aos seguintes requisitos:
- A conta do parceiro e a conta do administrador do parceiro devem estar cadastradas na solução Wholesale RTM. Durante a fase de pré-venda, não é necessário que os parceiros sejam integrados à solução Wholesale RTM para executar a ferramenta de extração.
- O parceiro deve consultar a lista de verificação pré-migração para garantir que todos os requisitos sejam atendidos.
- São necessárias credenciais de administrador de sistema do Cisco BroadWorks para executar as ferramentas de extração e movimentação de dispositivos. Isso não se aplica a parceiros da BroadCloud.
- As ferramentas de extração e movimentação de dispositivos devem ser executadas a partir do servidor de aplicativos Cisco BroadWorks secundário durante uma janela de manutenção para minimizar os riscos. Os parceiros da BroadCloud executarão a Ferramenta de Migração de Dispositivos a partir do Portal do Provedor de Serviços.
- Consulte a lista de dispositivos Webex Calling compatíveis .
- Consulte a lista de dispositivos Webex Calling não suportados.
- Os parceiros devem solicitar à sua equipe de contas na Cisco a versão de firmware compatível para telefones e dispositivos.
- Os clientes do UC-One devem atualizar para as seguintes versões:
- Os clientes do Desktop Communicator devem ser da versão 22.9.12 ou superior.
- Os clientes do Mobile Connect devem ser da versão 3.9.14 ou superior.
- O computador do administrador deve ter:
- JDK/JRE A versão 1.8 é necessária para a Ferramenta de Provisionamento.
- Em máquinas MAC e Linux, é necessário o Python 3.10.5 ou superior para a ferramenta de transformação.
- Os clientes devem ter um endereço de cobrança válido e os usuários finais devem ter um endereço de e-mail comercial configurado no Cisco BroadWorks. Caso os valores não estejam definidos, os administradores parceiros devem entrar em contato com seus clientes para obtê-los. Esses detalhes devem ser adicionados aos arquivos CSV (valores separados por vírgula) antes de executar a ferramenta de transformação. Arquivos CSV de exemplo são fornecidos com a ferramenta de transformação.
Plano de migração
O plano de migração tem 3 etapas:
- Preparação
- Obtenha uma cópia dos dados do usuário com a Ferramenta de Extração.
- Gere um token usando a Ferramenta de Geração de Tokens.
- Utilize a ferramenta Transformar para formatar os dados do usuário.
- Provisionamento
- Obtenha os dados mais recentes dos usuários com a Ferramenta de Extração.
- Utilize a ferramenta Transformar para formatar os dados do usuário.
- Provisione usuários com a Ferramenta de Provisionamento.
- Migração
- Migre dispositivos com a Ferramenta de Movimentação de Dispositivos
- Migrações sem dispositivos [ Ativação de números de telefone através do Control Hub ]
Se os administradores parceiros não tiverem dispositivos para migrar do Cisco BroadWorks para o Wholesale, executar a ferramenta de migração de dispositivos não será necessário. Os administradores parceiros podem usar o link público abaixo para ativar os números de telefone diretamente pelo portal Control Hub. Para obter mais informações, consulte Gerenciar números de telefone no Control Hub.
A desativação dos números de telefone no Cisco BroadWorks é opcional se os administradores parceiros ativarem seus números de telefone por meio do Control Hub.
Funcionalidades migradas automaticamente para Chamadas por Atacado
Essas funcionalidades do usuário são migradas automaticamente pelas ferramentas de migração:
- As configurações de mensagens de voz e saudações personalizadas (mensagens de voz, áudio com nome personalizado e PIN do usuário não são migrados).
- Números alternativos
- BroadWorks em qualquer lugar
- Campo de lâmpadas movimentado
- Identificação de chamadas (nome e número de telefone personalizados)
- Chamada em espera
- Configurações de encaminhamento de chamadas (encaminhamento de chamadas) always/busy/no answer/not (acessível)
- Interceptação de chamadas
- Não perturbe
- Configurações de fax
- Escritório remoto
- Aparência da chamada compartilhada
- Pessoal de anel simultâneo (incluindo cronograma e critérios de seleção)
- Notificar por telefone (incluindo cronograma e critérios de seleção)
- Rejeição de chamada anônima
- Rejeição seletiva de chamadas
- Encaminhamento seletivo de chamadas
- Aceitação seletiva de chamadas
- Atendimento de chamadas direcionado e intervenção direta
- Isenção de entrada por barcaça
- Pressione para falar
- Privacidade
- Música em espera
- Serviço de feriados
- Serviço noturno
- Plano de chamadas de saída
- Plano de chamadas de saída - Códigos de autorização
- Plano de chamadas de saída - Transferência de números
- Plano de chamadas recebidas
- Cliente recepcionista
- Gravação de chamadas
Essas funcionalidades de grupo são migradas automaticamente pelas ferramentas de migração:
- Atendimento automático
- Saudações personalizadas
- Configurações de encaminhamento de chamadas (sempre, ocupado, seletivo)
- Números alternativos
- O menu de feriados não está disponível no Webex.
- Rejeição seletiva de chamadas
- Cisco BroadWorks Call Center Standard e Fila de Chamadas BroadCloud:
- Configuração básica
- Saudações personalizadas
- Agentes e supervisores
- Configurações de encaminhamento de chamadas (sempre, ocupado, seletivo)
- Números alternativos
- Música em espera
- Encaminhamento forçado
- Ignorar mensagem de conforto
- Espaço de trabalho compartilhado:
- Encaminhamento de chamadas
- Não perturbe
- Chamada em espera
- Interceptação de chamadas
- Música em espera
- Campo de lâmpadas movimentado (Monitoramento)
- ID do autor da chamada
- Números alternativos
- Plano de chamadas recebidas
- Plano de chamadas de saída
- Plano de chamadas de saída - Códigos de autorização
- Plano de chamadas de saída - Transferência de números
- Espaço de trabalho profissional:
- Encaminhamento de chamadas
- Correio de voz
- Correio de voz - Mensagem de ocupado
- Correio de voz - Sem resposta
- Não perturbe
- Chamada em espera
- Interceptação de chamadas
- Música em espera
- Campo de lâmpadas movimentado (Monitoramento)
- Pressione para falar
- Toque simultâneo
- Rejeição de chamada anônima
- Encaminhamento seletivo de chamadas
- Rejeição seletiva de chamadas
- Aceitação seletiva de chamadas
- Entrada direta
- Configurações de privacidade
- ID do autor da chamada
- Números alternativos
- Plano de chamadas recebidas
- Plano de chamadas de saída
- Plano de chamadas de saída - Códigos de autorização
- Plano de chamadas de saída - Transferência de números
- Gravação de chamadas
- Linha virtual:
- Encaminhamento de chamadas
- Correio de voz
- Correio de voz - Mensagem de ocupado
- Correio de voz - Sem resposta
- Chamada em espera
- Interceptação de chamadas
- Música em espera
- Pressione para falar
- Entrada direta
- Configurações de privacidade
- ID do autor da chamada
- Plano de chamadas recebidas
- Plano de chamadas de saída
- Plano de chamadas de saída - Códigos de autorização
- Plano de chamadas de saída - Transferência de números
- Gravação de chamadas
- Estacionamento de chamadas
- Atendimento de chamadas
- Grupo de busca
- Configurações de encaminhamento de chamadas (sempre, ocupado, seletivo, inacessível)
- Números alternativos
- Código de localização (um por local ou grupo)
- Grupo de paging
- Agendamentos (os agendamentos corporativos não são migrados)
- Portal de voz
- Música em espera
- Lista telefônica comum
- Grupo de correio de voz
Dispositivos compatíveis
Os telefones compatíveis serão criados e atribuídos automaticamente aos usuários no Webex Calling pela ferramenta de provisionamento. Os telefones marcados com "sim" na coluna "Compatível com a ferramenta de migração de dispositivos" também serão migrados automaticamente do Cisco BroadWorks ou BroadCloud para o Webex Calling quando a ferramenta de migração de dispositivos for executada. Os telefones marcados com "Não" nessa coluna precisam de intervenção manual para alterar o URL do DMS no modelo de dispositivo Cisco BroadWorks ou no próprio telefone.
A última coluna fornece o mapeamento dos modelos de telefone para a coluna “Tipo de dispositivo” do arquivo. transform-tool/input/newphones.csv. (Consulte a seção Ferramenta de transformação deste artigo para obter mais informações sobre newphones.csv).
|
Modelo do telefone |
Compatível com a ferramenta de movimentação de dispositivos |
Tipo de dispositivo em newphones.csv |
|---|---|---|
|
Cisco MPP 6821 |
Sim |
DMS Cisco 6821 |
|
Cisco MPP 6841 |
Sim |
DMS Cisco 6841 |
|
Cisco MPP 6851 |
Sim |
DMS Cisco 6851 |
|
Cisco MPP 6861 |
Sim |
DMS Cisco 6861 |
|
Cisco MPP 6871 |
Sim |
DMS Cisco 6871 |
|
Cisco MPP 7811 |
Sim |
DMS Cisco 7811 |
|
Cisco MPP 7821 |
Sim |
DMS Cisco 7821 |
|
Cisco MPP 7832 |
Sim |
DMS Cisco 7832 |
|
Cisco MPP 7841 |
Sim |
DMS Cisco 7841 |
|
Cisco MPP 7861 |
Sim |
DMS Cisco 7861 |
|
Cisco MPP 8811 |
Sim |
DMS Cisco 8811 |
|
Cisco MPP 8832 |
Sim |
DMS Cisco 8832 |
|
Cisco MPP 8841 |
Sim |
DMS Cisco 8841 |
|
Cisco MPP 8845 |
Sim |
DMS Cisco 8845 |
|
Cisco MPP 8851 |
Sim |
DMS Cisco 8851 |
|
Cisco MPP 8861 |
Sim |
DMS Cisco 8861 |
|
Cisco MPP 8865 |
Sim |
DMS Cisco 8865 |
|
Cisco MPP 8875 |
Sim |
DMS Cisco 8875 |
|
Cisco ATA191 |
Sim |
DMS Cisco 191 |
|
Cisco ATA192 |
Sim |
DMS Cisco 192 |
|
Cisco DBS 110 |
Sim |
DMS Cisco DBS110 |
|
Polycom VVX101 |
Sim |
DMS Polycom VVX101 |
|
Polycom VVX150 |
Sim |
DMS Polycom VVX150 |
|
Polycom VVX201 |
Sim |
DMS Polycom VVX201 |
|
Polycom VVX250 |
Sim |
DMS Polycom VVX250 |
|
Polycom VVX301 |
Sim |
DMS Polycom VVX301 |
|
Polycom VVX311 |
Sim |
DMS Polycom VVX311 |
|
Polycom VVX350 |
Sim |
DMS Polycom VVX350 |
|
Polycom VVX401 |
Sim |
DMS Polycom VVX401 |
|
Polycom VVX411 |
Sim |
DMS Polycom VVX411 |
|
Polycom VVX450 |
Sim |
DMS Polycom VVX450 |
|
Polycom VVX501 |
Sim |
DMS Polycom VVX501 |
|
Polycom VVX601 |
Sim |
DMS Polycom VVX601 |
|
Polycom Trio 8300 |
Sim |
DMS Polycom Trio8300 |
|
Polycom Trio 8500 |
Sim |
DMS Polycom Trio8500 |
|
Polycom Trio 8800 |
Sim |
DMS Polycom Trio8800 |
|
Polycom SoundStation 5000 |
Sim |
DMS Polycom SSIP5000 |
|
Polycom SoundStation 6000 |
Sim |
DMS Polycom SSIP6000 |
|
Yealink T33G |
Sim |
DMS Yealink T33G |
|
Yealink T41S |
Sim |
DMS Yealink T41S |
|
Yealink T42S |
Sim |
DMS Yealink T42S |
|
Yealink T43U |
Sim |
DMS Yealink T43U |
|
Yealink T46U |
Sim |
DMS Yealink T46U |
|
Yealink T46S |
Sim |
DMS Yealink T46S |
|
Yealink T48S |
Sim |
DMS Yealink T48S |
|
Yealink T48U |
Sim |
DMS Yealink T48U |
|
Yealink T53W |
Sim |
DMS Yealink T53W |
|
Yealink T54W |
Sim |
DMS Yealink T54W |
|
Yealink T57W |
Sim |
DMS Yealink T57W |
|
Yealink T58V |
Sim |
DMS Yealink T58V |
|
Yealink CP920 |
Sim |
DMS Yealink CP920 |
|
Yealink CP960 |
Sim |
DMS Yealink CP960 |
|
Yealink W52B |
Sim |
DMS Yealink W52P |
|
Yealink W56B |
Sim |
DMS Yealink W56P |
|
Yealink W60B |
Sim |
DMS Yealink W60P |
|
Yealink W70B |
Sim |
DMS Yealink W70P |
|
Yealink CP925 |
Sim |
DMS Yealink CP925 |
|
Yealink CP965 |
Sim |
DMS Yealink CP965 |
|
AudioCodes MP204R |
Sim |
DMS AudioCodes MP204R |
|
AudioCodes MP202R |
Sim |
DMS AudioCodes MP202R |
|
AudioCodes MP204 |
Sim |
Códigos de áudio DMS MP204 |
|
AudioCodes MP202 |
Sim |
Códigos de áudio DMS MP202 |
Dispositivos não suportados
Se o cliente usar dispositivos não compatíveis com a solução Wholesale RTM, esses dispositivos não serão elegíveis para migração. Nesse caso, você tem as seguintes opções:
- Provisione os novos telefones no Cisco BroadWorks antes de migrar.
- Deixe os telefones antigos no Cisco BroadWorks, e os usuários precisarão instalar o aplicativo Webex para fazer e receber chamadas.
Pacotes de chamadas por atacado
As ferramentas de migração possuem um conjunto de configurações padrão para selecionar pacotes de chamadas por atacado para assinantes. Caso seja desejado um pacote diferente posteriormente, essas configurações podem ser alteradas no Control Hub por um administrador parceiro.
Configuração do pacote de migração Cisco BroadWorks
Todos os assinantes que migrarem do Cisco BroadWorks serão automaticamente direcionados para o pacote de chamadas Webex. Se o pacote Webex Voice for desejado para assinantes que não têm Chamada em Espera ou Correio de Voz atribuídos, isso pode ser habilitado no arquivo partner.cfg da ferramenta Transform, descomentando a linha USE_WEBEX_VOICE_PACKAGE.
Mapeamento do pacote de migração do Webex para BroadWorks
A migração de pacotes Webex para Broadworks é baseada no tipo de pacote Broadworks. Configure o mapeamento padrão no arquivo de configuração da Ferramenta de Transformação em conf/w4b_package_to_wholesale_package.csv.
|
Pacote Webex para BroadWorks |
Pacote de Chamadas por Atacado |
|---|---|
|
Softphone |
Webex Voice |
|
Básico |
Webex Calling |
|
Padrão |
Webex Suite |
|
Premium |
Webex Suite |
mapeamento do pacote de migração BroadCloud
Migrações de pacotes de mapas de operadoras BroadCloud com base no tipo de estação. O mapeamento padrão pode ser configurado no arquivo de configuração da ferramenta de transformação conf/rialto_station_type_to_wholesale_package.csv.
|
Tipo de estação de portadora BroadCloud |
Pacote de Chamadas por Atacado |
|---|---|
|
Básico |
Webex Voice |
|
Sala de conferências |
Webex Voice |
|
Mensagens |
Webex Voice |
|
Padrão |
Webex Voice |
|
Administrador |
Webex Suite |
|
Todos os outros tipos de estação |
Webex Voice |
Transforme uma conta de usuário do BroadWorks ou BroadCloud em um espaço de trabalho do Webex Calling.
Um espaço de trabalho Webex é um telefone compartilhado entre várias pessoas, por exemplo: por exemplo: telefones em uma sala de conferências, armazém ou saguão. Esses telefones podem ser configurados no Webex Calling como espaços de trabalho do Webex em vez de usuários do Webex. Existe uma opção para transformar automaticamente as contas de usuário do Cisco BroadWorks ou BroadCloud Carrier em espaços de trabalho durante o processo de migração.
Etapas
- No arquivo transform_tool/input/users.csv, Atribua o pacote “common_area” aos usuários para que ele seja transformado em um Espaço de Trabalho.
- Exemplo: bwuser@domain,,,common_area
- (Apenas para BroadCloud) Para converter todas as contas de usuário de um tipo de estação específico em espaços de trabalho, adicione uma entrada em transform-tool/conf/rialto_station_type_to_wholesale_package.csv e defina o pacote Wholesale como “common_area_calling”.
- Exemplo: conference_room_v2,common_area_calling
- Execute a ferramenta de transformação.
- Execute a ferramenta de provisionamento.
- Abra o Control Hub da organização do cliente recém-criada e defina um domínio SIP (consulte a figura 2, Configurando um domínio SIP no Control Hub).
- Execute a ferramenta de provisionamento novamente. Isso cria os espaços de trabalho e atribui os telefones a eles.
Limitações:
A configuração de funcionalidades do usuário (por exemplo, encaminhamento de chamadas, modo "não perturbe") não é migrada automaticamente para o espaço de trabalho.
Figura 2: Configurando um domínio SIP no Control Hub
Ferramenta geradora de tokens
Os administradores parceiros executam esta ferramenta de geração de tokens pelo menos uma vez antes de começar a executar as ferramentas de migração. A execução desta ferramenta é uma atividade realizada uma única vez, após a integração da conta do parceiro na solução Wholesale RTM. Esta ferramenta permite que os administradores parceiros façam login através de um 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 diversas 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 arquivos binários da ferramenta de migração.
Esta etapa é opcional.
Instruções para executar
Execute o seguinte comando no terminal dentro do diretório do gerador de tokens:
-
As seguintes portas devem estar disponíveis para executar a ferramenta geradora de tokens. Portos: 8080, 50009, 50010, 50011, 50012 e 50013
-
Pelo menos uma das portas mencionadas deve estar aberta para conexão no computador do usuário.
Windows:
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 o URL no navegador da web no terminal, faça login com as credenciais de administrador do parceiro para obter o TOKEN e copie-o para uso posterior.
As ilustrações da interface do usuário são apresentadas abaixo para referência:

Figura 3: Faça login com o Cisco Webex

Figura 4: Janela de credenciais

Figura 5: Geração de tokens
Tarefas de configuração do BroadWorks
Configure os seguintes passos antes de executar as ferramentas de extração e movimentação de dispositivos no servidor BroadWorks secundário.
Habilitar conectividade OCI-P
A ferramenta de movimentação de dispositivos se comunica com o BroadWorks por meio de comandos OCI-P. Para habilitar a conectividade OCI-P, siga os passos abaixo:
Passo 1: Utilize a CLI para configurar as Definições Gerais.
Execute o seguinte comando na CLI para acessar 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 as suas configurações não corresponderem às acima, use o comando set para reconfigurar as suas configurações.
Etapa 2: Utilize a CLI para configurar o proxy OCI.
Alterar o diretório para OCI Proxy:
AS_CLI> cd /Applications/OpenClientServer/OCIProxy Execute o seguinte comando na linha de comando para obter as configurações atuais. Você deverá ver o seguinte:
AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800
Se as suas configurações não corresponderem às acima, use o comando set para reconfigurar as suas configurações.
Etapa 3: Utilize a CLI para configurar o provisionamento do OCI.
Alterar para o diretório de provisionamento:
AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning Execute o seguinte comando para obter as configurações atuais de provisionamento do OCI:
AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as
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.
Utilize os comandos abaixo para implantar e iniciar o Open Client Server no servidor de aplicativos secundário, caso ele ainda não esteja implantado ou em execução.
Passo 1: Implante o servidor com o seguinte comando da CLI:
AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer Etapa 2: Inicie o servidor com este comando:
AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer Ativar números
Execute os seguintes comandos na CLI para habilitar a ativação dos números:
Passo 1: Execute o comando de ativação numérica:
AS_CLI> cd SubscriberMgmt/NumberActivation Etapa 2: Execute o comando de ativação:
AS_CLI> set dnMode groupAndUserActivationEnabled Etapa 3: Na tela de confirmação, digite Y.
Plano de chamadas da Cisco
Os planos de chamadas da Cisco oferecem uma solução integrada projetada para simplificar sua experiência de chamadas em nuvem com o Webex Calling.
Pré-requisitos
A equipe de contas da Cisco deve auxiliar o administrador do parceiro na configuração do fornecedor Cloud Connected PSTN como Sinch no modelo de provisionamento de atacado.
Ferramenta de Transformação
Para ativar o plano de chamadas da Cisco, adicione a seguinte configuração ao arquivo partner.cfg:
- ATIVAR_CISCO_CHAMADA_PLAN=Yes
- Por padrão, essa propriedade está comentada. Os administradores devem descomentar e habilitar antes de executar a ferramenta de transformação.
- Após habilitar esta propriedade e executar a Ferramenta de Transformação, a seção Wholesale Package do arquivo JSON do cliente incluirá automaticamente o plano de chamadas da Cisco.
Ferramenta de provisionamento
Para as localidades dos clientes que optam pelo plano de chamadas da Cisco, ativamos os números associados durante a fase de provisionamento de números. No entanto, os clientes só começarão a usar os números após a conclusão do processo de migração.
Ferramenta de extração
Para BroadCloud
A ferramenta de extração está integrada no portal do provedor de serviços BroadCloud. Um administrador de provedor de serviços pode:
- Envie solicitações de extração para até 50 clientes por solicitação.Não é possível submeter um pedido de extração para o mesmo cliente mais de 10 vezes por dia.
- Faça o download do arquivo de dados extraídos, 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
-
Baixe o arquivo 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.
-
Editar a lista de clientes
O administrador pode editar este arquivo CSV para incluir apenas os clientes para os quais a extração precisa ser realizada.
-
Carregar e enviar
Após a edição, faça o upload do arquivo 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 localizações
-
Selecione o cliente e os locais de download.
Selecione um cliente no menu suspenso.
Baixe o arquivo locations.csv correspondente em Visualizar Clientes→ guia Locais → Exportar Locais como CSV.
-
Edite o arquivo de locais
O administrador pode editar o arquivo CSV para incluir apenas os locais que deseja extrair.
-
Carregar e enviar
Faça o upload do arquivo locations.csv editado e clique em Enviar.
Apenas 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
- Clique em Enviar para iniciar uma solicitação de extração para todos os clientes e todos os seus locais sob o provedor de serviços atual.
Para Cisco BroadWorks e Webex para BroadWorks
- A ferramenta de extração é executada no servidor de aplicativos Cisco BroadWorks secundário dentro da rede do parceiro e se conecta por meio de OCI-P.
- 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 converte esses dados em arquivos XML que fornecem as entradas para a ferramenta de transformação.
As próximas seções explicam como instalar e configurar a ferramenta de extração.
Pré-requisitos
- SCP: utilize a ferramenta de extração de binários para um servidor de aplicativos Cisco BroadWorks secundário.
- Acesse o servidor de aplicativos Cisco BroadWorks secundário via SSH para configurar os pré-requisitos e executar a ferramenta de extração.
- Configure o provedor de serviços e o ID do grupo para extrair do Cisco BroadWorks. conf/exportTool.yml. Consulte o seguinte trecho de YAML de exemplo:
ServiceProviderID-A: - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B: - ALL - Certifique-se de que o ID de usuário, a senha e o nome do host do servidor de aplicativos Cisco BroadWorks secundário estejam corretos. conf/partner.cfg arquivo:
BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.A propriedade
REFRESH_TOKENé obrigatória para uma migração do Webex para BroadWorks. - Modifique o JDK/JRE O caminho do ambiente no arquivo export.sh deve ser especificado se o servidor de aplicativos Cisco BroadWorks secundário estiver configurado dessa forma. JDK/JRE O caminho do ambiente é diferente do arquivo:
JAVA_HOME=/usr/local/java/java_base
Instruções para executar
Execute o seguinte comando no servidor de aplicativos Cisco BroadWorks secundário, localizado no diretório da ferramenta de extração:
./export.sh Registros do terminal
Os seguintes registros ficam disponíveis no terminal após uma exportação bem-sucedida: Executando a ferramenta de exportação de dados BroadSoft:
Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed
Exported files converted as ZIP file
**************************************************
Saída
Um arquivo ZIP de saída (extracted_data_<timestamp>.zip) está disponível no mesmo diretório da ferramenta de extração. Utilize o seguinte comando para visualizar e usar o arquivo ZIP como entrada para a 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
Ferramenta de transformação
Essa ferramenta de transformação funciona para todas as migrações. A ferramenta de transformação funciona em qualquer computador, incluindo o laptop do administrador de um parceiro, e utiliza as APIs públicas do Webex. Ele lê o arquivo ZIP de saída da ferramenta de extração (extracted_data_<timestamp>.zip) como entrada e transforma o XML bruto em um formato JSON que é usado pela ferramenta de provisionamento.
Pré-requisitos
Após baixar e extrair os arquivos binários das ferramentas de migração, configure os seguintes pré-requisitos:
- Defina o REFRESH_TOKEN (Token copiado da Ferramenta Geradora de Tokens) e o NAME_OF_MAIN_LOCATION no conf/partner.cfg arquivo:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=Main - Opcionalmente, defina o ID de PROVISIONAMENTO_(copiado do modelo no Partner Hub) no conf/partner.cfg arquivo:
PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1Para obter uma verificação mais completa do endereço de e-mail do cliente, você pode definir opcionalmente o ID de_PROVISIONAMENTO . - Configure as informações que faltam em input/customers.csv arquivo (ver próxima seção) se estiver faltando.
- Adicione o endereço de e-mail do usuário final em input/users.csv arquivo.
- Se novos telefones forem provisionados, adicione o endereço MAC e o endereço de e-mail do novo telefone do usuário ao input/newphones.csv arquivo. Isso só é necessário se os administradores parceiros desejarem provisionar novos telefones no serviço de chamadas por atacado.
- Converta os Call Centers BroadWorks em CxEssentials usando o input/cxessentials.csv arquivo.
- Opcionalmente, habilite a propriedade ATUALIZAR_TODOS_CENTRAIS_DE ATENDIMENTO_PARA_CX_ESSENTIALS para converter todos os Centros de Atendimento para CxEssentials.
- Use o input/locations.csv Arquivo para dar suporte à migração de grandes empresas que permite aos administradores migrar as localizações de seus clientes uma a uma.
- Opcionalmente, habilite o uso de endereços MAC do cabeçalho User-Agent da mensagem SIP REGISTER quando o endereço MAC não estiver disponível no perfil do dispositivo Cisco BroadWorks. Descomente a linha USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes no arquivo conf/partner.cfg
- Opcionalmente, habilite as propriedades ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD e ANALOG_USER_TYPE_DISABLE_T38 para configurar a chamada em espera, a música em espera e desabilitar as configurações T38 para todos os usuários do tipo analógico.
-
Se você deseja configurar dispositivos de gateway genéricos, adicione o endereço MAC e o ID do usuário do dispositivo ao input/genericgateways.csv arquivo. Além disso, mencione se o usuário é o proprietário PRINCIPAL ou um usuário COMPARTILHADO (para participações compartilhadas em chamadas). Isso só é necessário se os administradores parceiros planejarem usar dispositivos de gateway genéricos em Chamadas por Atacado.
Este recurso não está disponível para migrações do BroadCloud para o Wholesale.
-
Para migrações BroadCloud, para converter todos os usuários com o tipo de estação de mensagens para voice_mail_group, atualize o arquivo conf/rialto_station_type_to_wholesale_package.csv substituindo o valor de Wholesale Package por voice_mail_group para a linha onde o Rialto Station Type é de mensagens.
Opcionalmente, habilite a propriedade COMMON_VOICE_MAIL_GROUP_PASSCODE em partner.cfg para configurar o PIN padrão para grupos de correio de voz.
Se esta propriedade não for especificada em partner.cfg, ela deverá ser fornecida por cliente no arquivo customers.csv na coluna commonVoicemailGroupPassCode.
-
Para migração de contatos comuns para o Webex Calling
Trata-se de um aprimoramento para o gerenciamento de contatos comuns em nível corporativo e local. Esses contatos agora podem ser migrados como contatos da organização (Org Contacts) ou como extensões virtuais, dependendo das configurações. A seguir, apresentamos os detalhes para orientá-lo durante esse processo de migração.
Configuração principal:
- LISTA DE TELEFONE COMUM___PARA__EXTENSÃO VIRTUAL_INÍCIO_INTERVALO
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 do Rialto para o Webex Calling.
- Sem COMUM_TELEFONE_LISTA_PARA_EXTENSÃO VIRTUAL__INÍCIO_INTERVALO Configurado
Os contatos em comum serão migrados para contatos da organização (Contatos da Organização).
Nenhuma configuração adicional é necessária.
Os contatos permanecem acessíveis no nível organizacional.
- Com COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE configurado
Os contatos em comum serão migrados como extensões virtuais.
A cada contato será acrescentado um número de ramal, e o intervalo inicial do ramal é definido na propriedade COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE em partner.cfg.
As extensões virtuais são suportadas tanto a nível organizacional como a nível local, dependendo do âmbito do contacto.
- LISTA DE TELEFONE COMUM___PARA__EXTENSÃO VIRTUAL_INÍCIO_INTERVALO
- Ative o fornecedor padrão de gravação de chamadas para o Webex.
Esta etapa é necessária apenas ao migrar as configurações de gravação de chamadas para usuários configurados com Dubber para Gravação de Chamadas Nativa da Cisco no Webex.
Para ativar esta opção:
- No arquivo partner.cfg, defina a seguinte propriedade,
DEFAULT_CALL_RECORDING_VENDOR=Webex. - Além disso, use a propriedade
WEBEX_CALL_RECORDING_STORAGE_REGIONpara configurar a região de armazenamento.A opção de gravação sob demanda do BroadCloud não é compatível com o Webex Calling. Essas configurações de gravação de chamadas não serão migradas e aparecerão no relatório de exceções.
- No arquivo partner.cfg, defina a seguinte propriedade,
-
Exclusão de determinados números de telefone da migração:
Para excluir números de telefone específicos do processo de migração, o seguinte procedimento em duas etapas, utilizando a ferramenta de transformação, deve ser seguido:
- Execute a ferramenta de transformação pela primeira vez. Ao concluir, a ferramenta irá gerar um arquivo chamado telephone_numbers_inventory.csv, localizado dentro do output/timestamp/ diretório. O cliente deve revisar este arquivo e indicar "Sim" na coluna "Excluir Tn's" para cada número de telefone que deve ser excluído da próxima migração.
- Após 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 seguinte formato.
./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}
Enchendo o input/customers.csv
O arquivo input/customers.csv Fornece dados que podem estar faltando no Cisco BroadWorks ou BroadCloud. Este arquivo pode ser deixado vazio se todas as informações obrigatórias já estiverem disponíveis. Não é necessário preencher todas as colunas, apenas as informações que estiverem faltando são obrigatórias.
A tabela abaixo explica as colunas mais importantes em input/customers.csv.
|
Nome da Coluna |
Regras |
|---|---|
|
Id |
No modo empresarial Cisco BroadWorks:
No modo de provedor de serviços BroadWorks, este é o ID do grupo Cisco BroadWorks. No BroadCloud, este é o customerId do Rialto. |
|
ID externa |
Este é um identificador que corresponde ao identificador interno do parceiro para este cliente. Esta coluna deve ser exclusiva dentro de uma organização parceira do Webex. Esta coluna é opcional; um identificador único será gerado automaticamente pela ferramenta de transformação. Esta coluna não é utilizada para grupos dentro de uma empresa. |
|
nomeDoCliente |
Para empresas, esta coluna é usada como o campo de nome do cliente Webex. Para um grupo dentro de uma empresa, esta coluna é usada como nome do local. Os nomes de localização devem ser únicos dentro de uma empresa. |
|
e-mail principal |
Este endereço é usado como o endereço de e-mail do administrador de clientes do Webex. Esta coluna é opcional para grupos dentro de uma empresa. |
|
Colunas de endereço |
Para uma empresa, o endereço é usado como endereço de faturamento e endereço da primeira localização. Para um grupo dentro de uma empresa, o endereço é usado como endereço de localização. |
|
Timezone |
Consulte a seção sobre fusos horários deste artigo. |
|
idioma | Consulte Idiomas suportados pelo Webex. |
|
PIN padrão do correio de voz |
Consulte Definir um PIN de correio de voz. |
|
Código de acesso comum do grupo de correio de voz | Utilize esta coluna para especificar o PIN padrão que será aplicado a todos os grupos de correio de voz do respectivo cliente. Após a migração, os administradores devem atualizar o PIN para cada grupo de correio de voz. Durante o processo de transformação, o PIN comum especificado pelo administrador é atribuído a todos os grupos de correio de voz. |
Enchendo o input/users.csv
O arquivo input/users.csv Fornece dados que podem estar faltando no Cisco BroadWorks ou BroadCloud. Este arquivo pode ser deixado vazio se todas as informações obrigatórias já estiverem disponíveis. Não é necessário preencher todas as colunas, apenas as informações que estiverem faltando são obrigatórias.
Todos esses campos são opcionais.
|
Nome da Coluna |
Regras |
|---|---|
|
ID do usuário |
Um identificador único para o usuário. Pode ser um ID de usuário do BroadWorks ou do BroadCloud. |
|
| (Opcional) O endereço de e-mail do usuário. Caso seja fornecido, será utilizado para fins de provisionamento. |
|
número de telefone |
(Opcional) O número de telefone do usuário a ser provisionado. |
|
Pacote |
(Opcional) Tipo de pacote do usuário. Valores permitidos: voz, chamada, suíte, common_area, virtual_line, dont_migrate, call_park_ext ou voice_mail_group. O valor dont_migrate é usado quando os parceiros desejam excluir determinados usuários — juntamente com seus dispositivos e números de telefone — tanto do provisionamento quanto da migração. Isso é compatível tanto com BroadWorks quanto com BroadCloud. Ao aplicar esta opção, os usuários selecionados e seus respectivos recursos não serão migrados nem provisionados. Para usar isso, os administradores devem inserir dont_migrate na coluna pacote do arquivo users.csv. |
|
ramal |
(Opcional) Ramal telefônico a ser atribuído ao usuário. |
|
nome |
(Opcional) O nome completo do usuário. |
|
ata_settings |
(Opcional) Valores permitidos: t38, analógico Para enable/disable Chamada em espera, música de espera e configurações T38 T38: Esta opção desativa a chamada em espera e a música de espera, e ativa as configurações T38 para dispositivos ATA. Analógico:
|
|
do_not_move_phone |
Somente BroadWorks. Sinalizador opcional para impedir a migração do dispositivo para o Webex Calling. Esta opção permite que os parceiros provisionem usuários juntamente com suas configurações de chamada, dispositivos e números de telefone sem migrar os dispositivos para o Webex ou ativar os números de telefone no Webex Calling. Esta configuração está disponível apenas para BroadWorks , não paraBroadCloud . Para usá-lo, os administradores devem especificar do_not_move_phone na coluna do_not_move_phone (somente BroadWorks) do arquivo users.csv. Isso garante que os usuários sejam atendidos sem a necessidade de ativar números ou mover seus telefones, para que continuem operando via BroadCloud. |
Instruções para executar
Execute a Ferramenta de Transformação em qualquer sistema operacional. Siga os passos 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 os seguintes passos para executar a ferramenta de transformação no macOS:
- Crie um ambiente virtual e instale as 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 - Execute a ferramenta de transformação:
./transform.sh -extract= -customers= -users= -newphones=
Customer/user verificação prévia
A ferramenta Transform faz chamadas de API para o Webex a fim de detectar possíveis problemas de provisionamento. Por padrão, o sistema validará o endereço e o e-mail principal do cliente. Se o valor do ID PROVISIONING_for especificado no conf/partner.cfg O arquivo também validará as informações de localização. Os resultados da verificação prévia 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:
verificação prévia
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, apenas os erros de pré-verificação (ou seja, problemas que bloquearão o provisionamento) são incluídos no relatório de exceções. Adicionar essa opção também incluirá os resultados bem-sucedidos da verificação prévia (por exemplo, se já existir uma organização Webex que possa ser anexada automaticamente).
precheckinfo leva mais tempo para ser executado.
Registros do terminal
Os seguintes registros são exibidos no terminal após 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 da saída /<timestamp>/exception_report.txt diretório. Você pode usar este relatório para identificar os problemas que afetarão a migração e corrigi-los no sistema Cisco BroadWorks.
Após 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. Segue abaixo um exemplo de arquivo de relatório de exceções:
Exception Report
Tue Oct 18 08:12:09 2022
Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg
Saída
Um arquivo JSON de saída (customer.json) estará disponível em output/<timestamp>/<groupid> diretório. O arquivo de exemplo customer.jsoné o seguinte:
{
"customer": {
"provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
"packages": [
"webex_calling",
"common_area_calling"
],
"externalId": "external_id_engg_grp1",
"address": {
"addressLine1": "100 Main Street",
"addressLine2": "",
"city": "Gaithersburg",
"stateOrProvince": "MD",
"zipOrPostalCode": "20877",
"country": "US"
},
"customerInfo": {
"name": "Engineering Group - 1",
"primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
},
"provisioningParameters": {
"calling": {
"location": {
"name": "Main",
"address": {
"addressLine1": "100 Main Street",
"addressLine2": "",
"city": "Gaithersburg",
"stateOrProvince": "MD",
"zipOrPostalCode": "20877",
"country": "US"
},
"timezone": "America/New_York",
"language": "en_us",
"numbers": [
"+15205551101",
"+15205551102",
"+15205551103",
"+15205551104",
"+15205551105",
"+15205551106",
"+15205551107",
"+15205551108",
"+15205551109",
"+15205551110"
],
"mainNumber": "+15205551101"
}
}
}
},
"broadworks_info": {
"service_provider_id": "collabmigrationtestSP_engg",
"group_id": "collabmigrationtestGRP_engg"
},
"subscribers": [
{
"amareswaranvel+benjaminjack@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+benjaminjack@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Benjamin",
"lastName": "Jack",
"primaryPhoneNumber": "+15205551102",
"extension": "1102"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineering17861@mailnator.com"
}
}
}
],
"devices": [
{
"cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
"product": "DMS Cisco 7861",
"mac": "CC98914EAAD7"
}
]
}
},
{
"amareswaranvel+lucasoliver@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+lucasoliver@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Lucas",
"lastName": "Oliver",
"primaryPhoneNumber": "+15205551103",
"extension": "1103"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineering16821@mailnator.com"
}
}
}
],
"devices": [
{
"cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
"product": "DMS Cisco 6821",
"mac": "5486BCAE7E45"
}
]
}
},
{
"amareswaranvel+leojackson@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+leojackson@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Leo",
"lastName": "Jackson",
"primaryPhoneNumber": "+15205551104",
"extension": "1104"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineeringmacpc@mailnator.com"
}
}
}
],
"devices": []
}
},
{
"amareswaranvel+owenalex@gmail.com": {
"subscriber": {
"customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
"email": "amareswaranvel+owenalex@gmail.com",
"package": "webex_calling",
"provisioningParameters": {
"firstName": "Owen",
"lastName": "Alexander",
"primaryPhoneNumber": "+15205551101",
"extension": "1101"
}
},
"features": [
{
"/v1/people/{personId}/features/voicemail": {
"enabled": true,
"sendBusyCalls": {
"enabled": true,
"greeting": "DEFAULT"
},
"sendUnansweredCalls": {
"enabled": true,
"greeting": "DEFAULT",
"numberOfRings": 3
},
"messageStorage": {
"mwiEnabled": true,
"storageType": "EXTERNAL",
"externalEmail": "engineering8811@mailnator.com"
}
}
}
],
"devices": [
{
"cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
"product": "DMS Cisco 8811",
"mac": "F87B204E4066"
}
]
}
}
],
"auto_attendants": [],
"call_queues": [],
"hunt_groups": [],
"schedules": [],
"call_parks": [],
"call_pickups": [],
"paging_groups": [],
"voice_portals": [
{
"name": "Automated Voice Portal",
"firstName": "Automated",
"lastName": "Voice Portal",
"languageCode": "en_us",
"phoneNumber": "+15205551105",
"extension": "1105"
}
],
"shared_call_appearances": [],
"business_communicator_desktop_to_upgrade_to_webex_app": [
"PC Comm - Engg Device Profile"
],
"connect_client_to_upgrade_to_webex_app": [],
"locations": [],
"webex_for_broadworks_info": {
"users": [
{
"id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
}
],
"hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
"hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
}
}
O `webex_for_broadworks_info` A propriedade JSON está presente apenas para migrações do Webex para BroadWorks. O `broadcloud_info` A propriedade JSON está presente apenas para migrações do BroadCloud.
Ferramenta de provisionamento
A ferramenta de provisionamento pode ser executada em qualquer máquina, geralmente no laptop do administrador do parceiro, e utiliza as APIs públicas do Webex. Ele lê o arquivo JSON de saída da ferramenta de transformação (customer.json) como 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 no diretório da ferramenta de provisionamento:
- Instale o Java 8, 11, 17 ou 21 no computador. O Java está disponível em diversas fontes, incluindo:
- Após 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.
- O arquivo partner.cfg:
- Defina WHOLESALE_PROVISIONING_ID e REFRESH_TOKEN (Token copiado da Ferramenta Geradora de Token). Os administradores parceiros devem entrar em contato com a equipe de contas para obter o ID de PROVISIONAMENTO_:
WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj -
Defina ALLOW_ADMIN_INVITE_EMAILS como falso, se os parceiros não quiserem enviar um e-mail de boas-vindas aos usuários. O valor padrão é verdadeiro.
O Webex envia e-mails de boas-vindas apenas para usuários finais. Os administradores de clientes não recebem e-mails de boas-vindas.
Usuários e administradores de clientes localizados nos EUA e Canadá recebem uma notificação por e-mail separada da RedSky. A plataforma RedSky E911 envia este e-mail para confirmar a criação da conta do cliente para serviços de emergência. Este e-mail da RedSky é diferente 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 Canadá, a RedSky é ativada automaticamente como provedora de serviços de emergência.
- Defina WHOLESALE_PROVISIONING_ID e REFRESH_TOKEN (Token copiado da Ferramenta Geradora de Token). Os administradores parceiros devem entrar em contato com a equipe de contas para obter o ID de PROVISIONAMENTO_:
- 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.
- 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.
- Use a propriedade
CUSTOM_TAGSpara adicionar tags após a criação do cliente.
Instruções para executar
Siga os passos abaixo para executar a ferramenta no Windows e no macOS:
Windows
Execute os seguintes passos para executar a ferramenta no sistema operacional Windows:
To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input=
macOS
Execute os seguintes passos para executar a ferramenta no macOS:
To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=
Pré-requisitos para a migração do Webex para o BroadWorks
Os administradores de parceiros devem atualizar seu modelo de integração do BroadWorks para os recursos de coexistência do Webex com o BroadWorks. Consulte a imagem a seguir:
Após a atualização do modelo de integração do Webex para BroadWorks para suportar a migração, solicite à equipe de contas da Cisco que habilite a opção "wholesale-partner-blending-enabled" no nível do parceiro. Isso permitirá que pacotes de atacado sejam adicionados às organizações de clientes Webex for 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 o Webex para usuários do BroadWorks.
Fase de manutenção: É a segunda fase, onde os administradores podem atribuir a licença Wholesale aos usuários existentes do Webex for BroadWorks. Você deve executar a ferramenta de provisionamento com um argumento manutenção.
Fase pós-migração: É a fase final, quando os administradores podem converter completamente o BroadWorks para o modelo de atacado. Você deve executar a ferramenta de provisionamento com um argumento postmigration.
Registros do terminal
A seguir, estão os registros no terminal após 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 ****************
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 dentro de output/<external_id>/*.success/error arquivos. Analise os registros de sucesso e de erros para verificar se o provisionamento foi bem-sucedido.
O sistema irá gerar um arquivo Provisioning_Report_*.csv no diretório output/consolidated_reports/. Este arquivo contém detalhes de sucesso e falha para cada entidade e suas configurações, fornecendo um relatório de provisionamento abrangente.
Após o provisionamento bem-sucedido, os usuários finais recebem um e-mail da solução Wholesale RTM.
Os administradores de parceiros podem verificar o provisionamento do cliente no portal Partner Hub e Control Hub. Consulte as ilustrações a seguir, extraídas do portal Partner Hub e Control Hub:
Figura 8: Hub de parceiros
Figura 9: Control Hub
Figura 10: Dispositivos
Figura 11: Chamadas
Restrições pós-provisionamento
Após a conclusão do provisionamento para uma migração para o 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 RSB ADD feitos com dispositivos ou números serão rejeitados.
Ferramenta de movimentação de dispositivos
Para BroadCloud
Para parceiros da BroadCloud, use o portal do provedor de serviços para enviar uma solicitação de migração de números, dispositivos e Aparências de Chamada Compartilhadas (SCA).
No portal do provedor de serviços, uma solicitação de migração pode incluir até 50 clientes. É possível submeter no máximo 10 solicitações por dia.
Os administradores podem ativar o rollback automático definindo ROLLBACK_TO_BROADCLOUD=true no arquivo conf/partner.cfg, o que move os dispositivos de volta para o BroadCloud após a migração. Ele oferece suporte a migrações tanto na mesma região quanto em regiões diferentes com o NS Sync, mas apenas para migrações bem-sucedidas. Para as instalações com falha, os administradores devem abrir um chamado no Cisco TAC antes de solicitar o rollback.
Existem duas opções disponíveis para selecionar o tipo de migração no portal:
- Migração – Selecione esta opção para iniciar uma solicitação de migração de números, dispositivos e Aparências de Chamada Compartilhadas (SCA).
- Status do dispositivo – Selecione esta opção para visualizar o status atual de um dispositivo no BroadCloud e em Chamadas.
As figuras a seguir mostram o portal do provedor de serviços.
Figura 12: Portal do provedor de serviços
Figura 13: Portal do provedor de serviços
Migrar locais selecionados (opcional)
Para iniciar a migração para um subconjunto específico de locais listados no arquivo customer.json, inclua um arquivo locations.csv com sua solicitação. Este arquivo CSV deve listar apenas os locais para os quais você pretende migrar.
Caso o arquivo locations.csv não seja fornecido, todas as localizações presentes no arquivo customer.json serão migradas.
| Termo | Definição |
|---|---|
|
ID do site |
O ID do site do local a ser migrado. |
|
Nome do site |
O nome da localização a ser migrada. |
Para baixar a lista de locais ativos disponíveis, navegue até Visualizar Clientes → Selecionar um Cliente → Exportar Locais como CSV.
Figura 14: Exportar locais como CSV
Ative a opção de desconexão de números
Quando você usa o mesmo tronco SIP para Webex Calling e BroadCloud Carrier, 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 para o BroadCloud.
Essa opção é necessária apenas ao migrar para uma região diferente do Webex Calling. Isso não se aplica se você permanecer na mesma região.
- Esta ação é irreversível
-
Ative esta opção somente após confirmar:
- Migração concluída.
- Todos os dispositivos foram registrados com sucesso no Webex Calling.
- Os números estão ativos
Para ativar esta opção,
- No arquivo partner.cfg, defina DISCONNECT_NUMBERS_FROM_RIALTO = sim.
- Execute novamente a ferramenta de migração usando o mesmo arquivo customer.json e o arquivo partner.cfgatualizado.
Se os números não se desconectarem, abra uma solicitação Cisco TAC.
Para Cisco BroadWorks e Webex para BroadWorks
Para migrações do Cisco BroadWorks e do Webex para BroadWorks, a ferramenta é executada no servidor de aplicativos Cisco BroadWorks secundário dentro da rede do parceiro e se conecta ao AS por meio do OCI-P. Ele usa o arquivo JSON de saída da ferramenta de transformação (customer.json) como entrada e executa os comandos OCI-P para migrar dispositivos e clientes de software.
Após a operação bem-sucedida, a ferramenta de movimentação do dispositivo irá:
- Cancele o registro dos dispositivos no Cisco BroadWorks e registre-os no Wholesale.
- Os usuários que utilizam o cliente UC-One serão redirecionados para o aplicativo Webex no primeiro acesso.
- Desative os números de telefone do Cisco BroadWorks ou remova-os do BroadCloud.
- Ative os números no atacado.
- Criar aparências de chamadas compartilhadas no Wholesale para migrações do BroadCloud. [This Esta etapa aplica-se somente ao BroadCloud. migrations].
SCP e SSH
- Copie e execute a ferramenta de movimentação de dispositivos SCP para o servidor de aplicativos Cisco BroadWorks secundário.
- Conecte-se via SSH ao servidor de aplicativos Cisco BroadWorks secundário para configurar os pré-requisitos e executar a ferramenta de movimentação de dispositivos.
Pré-requisitos
- Defina o REFRESH_TOKEN (token copiado da Ferramenta Geradora de Tokens) no conf/partner.cfg arquivo:
REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj - Certifique-se de que o ID de usuário, a senha e o nome do host do servidor de aplicativos Cisco BroadWorks secundário estejam corretos. conf/deviceMoveTool.conf arquivo:
BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost - Para reenviar e-mails de ativação, você precisa definir RESEND_INVITATION_EMAILS=true no conf/partner.cfg arquivo.
Se os administradores desejarem enviar e-mails de convite aos seus usuários durante a migração, eles devem remover o comentário da linha "RESEND_INVITATION_EMAILS=true" propriedade no conf/partner.cfg arquivo. Caso contrário, a propriedade deve permanecer inalterada.
- Verifique o JDK/JRE O caminho do ambiente está correto em devicemove.sh
JAVA_HOME=/usr/local/java/java_base - Os administradores podem usar o arquivo locations.csv do diretório de entrada para migrar grupos específicos em vez de todos os grupos de uma empresa.
Telefones Polycom
Para migrar telefones Polycom do Cisco BroadWorks para o Wholesale Calling, um administrador parceiro deve criar uma nova conexão. Identity/Device Arquivo de tipo de perfil no nível do sistema no Cisco BroadWorks cada modelo de dispositivo Polycom. Consulte a figura 14 e carregue o arquivo personalizado device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. Após carregar o novo arquivo do dispositivo, verifique se o arquivo recém-criado existe 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.
É utilizado internamente pela ferramenta de movimentação de dispositivos.
O processo de migração para telefones Polycom:
- A ferramenta de movimentação de dispositivo substitui o arquivo %BWMACADDRESS%.cfg no nível do dispositivo por polycom_vvx2.cfg. Este arquivo se refere a migration_%BWMACADDRESS%.cfg.
- Recrie os perfis de dispositivo no nível do grupo ou no nível do dispositivo.A atuação em nível de grupo ou em nível de dispositivo depende da configuração do parâmetro deviceLevelRebuild no arquivo. device-move-tool/conf/partner.cfg.
- A ferramenta de movimentação de dispositivos solicita ao servidor de aplicativos Cisco BroadWorks que reinicie os telefones no nível do grupo ou no nível do dispositivo.
- Após a solicitação de reinicialização, os telefones Polycom baixam e processam% BWMACADDRESS%.cfg, o que instrui os telefones Polycom a baixar e processar 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.
- O telefone Polycom baixa %BWMACADDRESS%.cfg de https://plcm.sipflash.com e será gerenciado pelo Webex Calling DMS.
Figura 14: Identity/device adicionar arquivo de tipo de perfil
Instruções para executar
Existem dois métodos para invocar o DMT: o primeiro consiste em invocar um único cliente de cada vez, e o segundo consiste em executar o processo em vários clientes simultaneamente.
A ferramenta de movimentação de dispositivos é executada a partir do servidor de aplicativos Cisco BroadWorks secundário, localizado no diretório da ferramenta de movimentação de dispositivos:
For device move single customer:
./devicemove.sh -input=
./devicemove.sh -input=/tmp/customername.json
For device move multiple customers:
./devicemove.sh -input=
ls -l /tmp/directoryofcustomers/
customer1.json
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input= -macaddress=4CBC4883A6F8,48256741CBE9
Registros do terminal
A seguir, estão os registros no terminal após 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 dos dispositivos, eles entraram em funcionamento e estão prontos para uso. make/receive ligações. Consulte a figura 15 para ver um exemplo do estado do dispositivo:
Figura 15: Status do dispositivo
Após a migração do dispositivo, os números foram ativados. Consulte a figura 16 para ver um exemplo de quais números estão ativos:
Figura 16: Números ativos
Migração Dubber
Agora você pode transferir gravações de chamadas do BroadCloud para o Webex Calling. Isso mantém suas contas Dubber existentes e todas as suas gravações antigas acessíveis, sem que você perca o acesso atual à plataforma Dubber durante a migração. Para obter mais informações sobre a migração do Dubber, consulte Migrar o Dubber do BroadCloud para o Webex Calling.
Reverter migração
A operação de reversão deve ser executada para uma empresa de cada vez.
Para a operadora BroadCloud
Os administradores podem definir ROLLBACK_TO_BROADCLOUD=true em conf/partner.cfg para ativar o rollback automático. Isso devolve os dispositivos ao BroadCloud após uma migração bem-sucedida na mesma região ou em região diferente com o NS Sync. Em caso de migração com falha, entre em contato com o Cisco TAC antes de solicitar o rollback.
Para Cisco BroadWorks e Webex para BroadWorks
O processo de reversão para o Cisco BroadWorks e o Webex para BroadWorks é o seguinte:
- Abra um chamado com o suporte técnico da Cisco (TAC) para solicitar a reversão do dispositivo.
- 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 redefinirá 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.
- A equipe do Webex Calling redefine o URL do DMS para o URL do DMS do provedor de serviços nos perfis de dispositivo do Webex Calling.
- Os administradores parceiros devem desativar ou excluir os números de telefone no Webex Calling por meio do portal Control Hub.
- Os administradores parceiros devem migrar os números de telefone PSTN de volta para o Cisco BroadWorks.
Instruções para executar a ferramenta de movimentação de dispositivos no modo de reversão
Siga os passos abaixo para executar a ferramenta de movimentação de dispositivos no modo de reversão:
Execute o comando abaixo no servidor de aplicativos Cisco BroadWorks secundário, localizado no diretório da ferramenta de movimentação de dispositivos:
Reverter perfis
./devicemove.sh -input= -revertProfiles Números invertidos
./devicemove.sh -input= -revertNumbers Registros do terminal
Ao executar com sucesso a ferramenta de movimentação de dispositivos para a operação de reversão, os seguintes registros serão exibidos no terminal:
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
Números invertidos
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
Apêndice
Migração de grandes empresas
Grandes empresas com muitas filiais não conseguem migrar todas as filiais dentro de uma única janela de manutenção. A funcionalidade descrita nesta seção permite que os parceiros migrem alguns locais de cada vez.
Passos
Siga os passos abaixo para planejar as migrações faseadas em uma grande empresa:
- Extraia os dados corporativos do BroadWorks ou do BroadCloud.
- Execute a ferramenta Transformar sem a opção de localização nos dados extraídos.
- Procure a seção "Recomendado para movimentação simultânea" em exception_report.txt para planejar as fases de migração e obter mais informações sobre dependências de localização. Examine os arquivos de lista de agentes de recursos (consulte a ferramenta Transformar abaixo).
- Gere o arquivo input/locations.csv modificando locations_to_be_edited.csv.
- Execute a ferramenta Transformar novamente com a opção de locais.
- Examine exception_report.txt para identificar quaisquer problemas de dependência de localização para a fase atual.
- Corrija os problemas de dependência de localização conforme necessário (modificando o arquivo locations.csv).
- Execute novamente a ferramenta Transform para gerar o arquivo customers.json para a fase atual.
- Execute a ferramenta de provisionamento para cada arquivo customer.json.
- Durante a janela de manutenção, execute a Ferramenta de Movimentação de Dispositivos.
- Repita os passos 4 a 10 para a próxima fase.
Ferramenta de transformação
Para atingir o objetivo de migrar as localizações de uma grande empresa fase por fase, como mencionado acima, um novo arquivo locations.csv é adicionado como entrada opcional (-locations=input/locations.csv) ao executar a ferramenta de transformação.
O arquivo locations.csv contém dados específicos de cada local. Ele substitui os dados encontrados em input/customers.csv, que atualmente contém dados tanto da empresa quanto da localização.
A tabela a seguir lista os detalhes dos locations.csv:
|
Descrição |
Valores |
Valor padrão |
Obrigatório |
Mapas no BroadWorks |
Mapas no BroadCloud | |
|---|---|---|---|---|---|---|
|
ID da empresa |
ID exclusivo da empresa |
Y |
ID do provedor de serviços |
ID do cliente Rialto | ||
|
ID da localização |
Identificador de localização, único dentro da empresa. |
Y |
ID do grupo |
ID do local de Rialto | ||
|
status migratório |
Este local foi migrado? |
migrado, dont_migrate, migrando |
migrando |
N | ||
|
nome |
Nome deste local. Deixe em branco para usar o locationId. |
N | ||||
|
Timezone |
N | |||||
|
idioma |
N | |||||
|
address1 |
N | |||||
|
address2 |
N | |||||
|
cidade |
N | |||||
|
estado |
N | |||||
|
código postal |
CEP ou código postal |
N | ||||
|
país |
Código de 2 letras |
N |
O locations.csv pode ser composto a partir do arquivo .csv pré-preenchido locations_to_be_editedao executar a ferramenta Transform em grandes empresas. Leia mais para ver exemplos.
O arquivo locations.csv é uma entrada opcional ao executar a ferramenta de transformação; portanto, a ferramenta de transformação se comportará da mesma forma que antes se a opção estiver selecionada. -locations=input/locations.csv Não está presente.
Novos arquivos de saída
Existem 5 novos arquivos de saída da ferramenta de transformação:
- locations_to_be_edited.csv – este arquivo já vem preenchido com as informações de todas as localizações da grande empresa a ser migrada.
Exemplo:
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US O partners/customers Pode ser usado para gerar um arquivo locations.csv para controlar os locais a serem migrados em uma fase específica (e atualizar as informações dos locais conforme necessário).
Exemplo: locations.csv gerado a partir do arquivo locations_to_be_edited.csv acima
locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country
auto_mig_ent_grp1,auto_mig_ent,migrated,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp2,auto_mig_ent,migrating,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US
auto_mig_ent_grp3,auto_mig_ent,dont_migrate,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US Este locations.csvsignifica: para esta fase, a localização auto_mig_ent_grp1 foi migrada, a localização auto_mig_ent_grp2 está migrando e não migrar a localização auto_mig_ent_grp3.
- hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4 arquivos têm a mesma finalidade: gerar as listas completas das funcionalidades correspondentes agents/supervisors/originators/targets/monitored_elements nos locais de migração se os locais de migração tiverem dependências de outros locais.
Eles têm um formato quase idêntico (o nome da terceira coluna varia de acordo com a funcionalidade), como abaixo (auto_mig_ent_grp2's hunt group's agents list for the above phase):
Exemplo: O texto a seguir é de hunt_group_agents.csv
feature name,feature location,agent,location
Sarah Rodriguez,auto_mig_ent_grp2,agent_michael@domain.com,auto_mig_ent_grp1
Sarah Rodriguez,auto_mig_ent_grp2,agent_sally@domain.com,auto_mig_ent_grp1 Se a opção de locais não estiver presente ao executar a ferramenta Transformar, os 4 arquivos acima gerarão as listas completas dos locais. hunt-group/call-center/paging-group/busy-lamp-field’s agents/supervisors/originators/targets/monitored_elements para toda a empresa, que pode ser usado para planejar as migrações faseadas.
Novas seções em exception_report
Ao realizar a migração faseada para grandes empresas, haverá algumas novas seções em exception_report.txt se houver dependências de localização que não forem atendidas.
Exemplo: A seguinte nova seção é para o grupo de caça de localização auto_mig_ent_grp2, agentes de Sarah Rodriguez na localização auto_mig_ent_grp3, que não foi migrada e não migrará nesta fase.
Dependencies between locations - Hunt groups
Name Location Agent Agent's Location Comment
________________________________________________________________________________________________________________
Sarah Rodriguez auto_mig_ent_grp2 agent_william@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet
Sarah Rodriguez auto_mig_ent_grp2 agent_melody@domain.com auto_mig_ent_grp3 Agent in different location not migrated yet A próxima seção apresenta recomendações sobre como agrupar os locais nas fases de migração.
Locais recomendados para deslocamento simultâneo:
Location auto_mig_ent_grp1 has dependency on location(s) auto_mig_ent_grp2, auto_mig_ent_grp3
Location auto_mig_ent_grp2 has dependency on location(s) auto_mig_ent_grp3 Caso a opção de locais não esteja presente ao executar a ferramenta Transformar, a seção Locais recomendados para movimentação simultânea lista todas as dependências de locais para facilitar o planejamento.
Ao executar a ferramenta Transformar com a opção de locais (ou seja, para uma fase de migração), a seção Locais recomendados para movimentação simultânea lista apenas as dependências de locais para a fase atual.
Ferramenta de provisionamento
Para grandes empresas, a ferramenta de provisionamento pode ser executada normalmente.
Ferramenta de movimentação de dispositivos
A ferramenta de movimentação de dispositivos pode ser executada para um subconjunto de locais do arquivo customer.json. Para isso, adicione um novo arquivo opcional locations.csv com duas colunas.
|
External_id |
Nomes de locais |
|---|---|
|
Valor de ID externo |
Nomes dos locations/group nomes |
- Este é um arquivo opcional; se não for fornecido ou se contiver valores vazios, todas as localizações serão migradas.
- Se forem fornecidos os nomes dos locais e seus respectivos IDs external_, somente esses locais serão migrados.
O comando é o seguinte:
./devicemove.sh -input=/customer.json -locations=/Location_names.csv Fusos horário
EUA:
"timeZones":["America/Adak","America/Anchorage","America/Chicago","America/Denver","America/Los_Angeles","America/New_York","America/Phoenix","Pacific/Honolulu"]
Canadá:
"timeZones":["America/Dawson_Creek","America/Edmonton","America/Halifax","America/Montreal","America/Regina","America/St_Johns","America/Vancouver","America/Winnipeg"]
Austrália:
"timeZones":["Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Hobart","Australia/Lord_Howe","Australia/Perth","Australia/Sydney"]
França:
"timeZones":["Europe/Paris"]
Portugal:
"timeZones":["Atlantic/Azores","Europe/Lisbon"]}
Reino Unido:
"timeZones":["Europe/London"]
Itália:
"timeZones":["Europe/Rome"]
Alemanha:
"timeZones":["Europe/Berlin"]
Perguntas frequentes
Erros conhecidos
| Erro | Ação |
|---|---|
| Ferramenta geradora de tokens | |
| ./tokengenerator.sh: linha 77: /bin/java: Não existe tal arquivo ou diretório | Configure corretamente a variável de ambiente JAVA_PATH em seu ambiente. |
| Erros da ferramenta de transformação | |
|
|
| Erros na ferramenta de provisionamento | |
|
|
| DeviceMove (BroadWorks) / Erros na ferramenta de migração (BroadCloud) | |
| A migração falhou devido a um erro no estado da rede do AS de origem e do AS de destino. |
Evite alterações no dispositivo ou no número após o provisionamento e antes de executar a ferramenta de movimentação de dispositivo. |
Pré-requisitos
1. Como encontro o OrgID do parceiro?
Faça login no Partner Hub e acesse a seção Contas. O OrgID aparece ali.
Extrair
1. Por que um cliente ou site não está listado na página "Iniciar Extração"?
Apenas os clientes com pelo menos um site com serviços de chamada ativos no BroadCloud são exibidos. Caso não existam sites de chamadas ativos, o cliente não será listado.
Transforme
1. Por que o recurso de usuário ou grupo está faltando no arquivo customer.json?
Para ver o recurso de usuário ou grupo, verifique exception_report.txt para erros relacionados.
2. Por que o arquivo customer.json não está sendo gerado?
Atualize o arquivo customers.csv com um endereço válido. Utilize o parâmetro -customers durante a transformação.
3. Qual é a finalidade do arquivo input/customers.csv ?
A finalidade é fornecer quaisquer dados obrigatórios do cliente que possam estar faltando no Cisco BroadWorks ou BroadCloud durante o processo de extração.
4. Qual é a finalidade do arquivo input/users.csv ?
O arquivo input/users.csv é usado para fornecer dados de nível de usuário que podem estar ausentes no Cisco BroadWorks ou BroadCloud.
5. Como converter call centers BroadWorks para Cx Essentials?
Use input/cxessentials.csv para converter BroadWorks Call Centers em Cx Essentials.
6. Existe alguma maneira de converter automaticamente todos os Call Centers para o Cx Essentials?
Sim, você pode habilitar a propriedade UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS para converter automaticamente todos os Call Centers para Cx Essentials sem usar o arquivo CSV.
7. Como faço para disponibilizar novos telefones para os usuários?
Para provisionar novos telefones, adicione o endereço MAC e o endereço de e-mail do usuário ao arquivo input/newphones.csv. Esta etapa só é necessária se os administradores parceiros pretenderem configurar novos telefones no ambiente de Chamadas por Atacado.
8. Como faço para configurar dispositivos de gateway genéricos?
Para configurar dispositivos de gateway genéricos, adicione o endereço MAC do dispositivo e o ID de usuário associado ao arquivo input/genericgateways.csv. Você também deve especificar se o usuário é o proprietário PRIMÁRIO ou um usuário COMPARTILHADO (para aparições de chamadas compartilhadas).
9. É possível configurar um gateway genérico para migrações do BroadCloud para o Wholesale?
Não, este recurso não é compatível com migrações do BroadCloud para o Wholesale.
Provisionamento
1. Como os parceiros podem configurar arquivos JSON para mais de 100 clientes simultaneamente, conforme configurado na propriedade maxCustomersProvisioning em conf/app.cfg?
Defina o maxCustomersProvisioning=<no.of.customers> em app.cfg e execute o provisionamento.
2. O provisionamento foi bloqueado porque a organização está em "pending_rpl_review"?
O departamento financeiro da Cisco está analisando o cliente. Isso pode levar até 72 horas. Tente novamente após a aprovação.
3. Como posso resolver um problema em que o pacote de atacado, seus recursos e usuários foram atribuídos à organização incorreta devido a um ID externo incorreto durante o processo de migração?
Etapa 1: Excluir todos os usuários / Funcionalidades fornecidas pela ferramenta de provisionamento.
Etapa 2: No Partner Hub, selecione o cliente, acesse a seção "Pacotes", desative todos os pacotes de atacado e salve as alterações.
DeviceMove (BroadWorks) / Migração (Broadcloud)
1. No arquivo customer.json, de todos os dispositivos, um ou dois não ficaram online? Como corrigir isso?
Se apenas alguns dispositivos não estiverem online, tente reiniciá-los manualmente.
2. O rialtoIdentifier é obrigatório no arquivo customer.json para a migração para o Broadcloud?
Sim.
3. Como executar a ferramenta de movimentação de dispositivos no modo reverso para Broadcloud?
Adicionar ROLLBACK_PARA_BROADCLOUD=true em partner.cfg e, em seguida, carregue os arquivos customer.json e partner.cfg e execute a migração novamente.
4. O que devo fazer se a ferramenta de provisionamento não conseguir adicionar dispositivos devido a um erro (geralmente porque o dispositivo já está em estado EDOS) e a migração do site prosseguir mesmo assim?
Normalmente recomendamos que o administrador resolva os erros de provisionamento antes da migração, mas neste caso o site foi migrado para a Plataforma de Chamadas Webex Wholesale antes que o dispositivo fosse provisionado com sucesso no Webex Calling.
Solução alternativa para adicionar o endereço MAC às chamadas do Webex:
Passo 1: Corrija o problema que impedia a adição do dispositivo (geralmente, é a remoção do endereço MAC do EDOS).
Passo 1: Existem duas opções.
Opção 1: Reverter e tentar novamente
- Reverter o site para o BroadCloud.
- Adicione o dispositivo no Webex Calling manualmente através do Control Hub ou execute novamente a ferramenta de provisionamento.
- Após adicionar o dispositivo, repita o processo de migração.
Opção 2: Continuar no Webex
Caso a reversão não seja a opção preferida:
- Informe-nos (equipe de migração de atacado) para que possamos definir o status de sincronização do BroadCloud NS para LOCAL.
- O administrador poderá então:
- Remova a atribuição do endereço MAC do usuário no Rialto.
- Remova o MAC do site em Rialto.
- Após a limpeza, o dispositivo é adicionado manualmente ao Webex Calling usando o portal do Control Hub.
- Após adicionar o dispositivo no Webex Calling, reinicie-o manualmente.