IoT Platform:Pré-requisitos

Limites

Antes de começar

Antes de iniciar a migração, revise as informações abaixo para avaliar o impacto no negócio.

• Dados a migrar:

  Ao migrar uma instância pública, o IoT Platform sincroniza e migra automaticamente os produtos, dispositivos e dados de encaminhamento de mensagens. A tabela a seguir descreve os dados migrados.

  Item de dados	Dados migrados	Observações
  Produto	Informações do produto: ProductKey, nome, tipo de nó, categoria, entre outros. Definições de recursos: Propriedades, serviços, eventos e modelos estendidos da Thing Specification Language (TSL), incluindo dados de rascunho do modelo TSL. Scripts: Scripts de análise de dados, incluindo dados de rascunho do script.	A migração suporta produtos e dispositivos que utilizam certificados por dispositivo ou por produto para autenticação de pré-registro. Para subdispositivos de gateway, o relacionamento de topologia permanece inalterado durante a migração. Após a migração, eles podem se conectar ao IoT Platform normalmente. Portanto, ao migrar um dispositivo de gateway ou seus subdispositivos, migre todos juntos para a mesma instância Enterprise. Produtos e dispositivos autorizados não podem ser migrados. O recurso de autorização para produtos e dispositivos não é suportado em instâncias Enterprise. Não é possível migrar produtos e dispositivos que utilizam o DataService Studio. Produtos e dispositivos com o serviço de vídeo ativado não podem ser migrados. A migração não suporta produtos e dispositivos conectados ao IoT Edge ou Link WAN. Após a migração, o tipo de validação do modelo TSL do produto permanece inalterado. Os dados originais são mantidos na instância pública legada após a migração. Para evitar operações acidentais, exclua manualmente esses dados depois que a migração da instância for concluída e você confirmar que seus serviços estão funcionando normalmente.
  Dispositivo	Informações do dispositivo: Informações do certificado do dispositivo. O certificado do dispositivo tem garantia de unicidade global. Dados do dispositivo: Dados de propriedade, evento e serviço do modelo TSL.	Importante Dispositivos distribuídos sob a instância não podem ser migrados. Os dispositivos a migrar devem possuir um recurso de reconexão. Conclua o desenvolvimento do SDK no lado do dispositivo e conectá-lo ao IoT Platform para comunicação normal. Nota Se você utilizar o Link SDK fornecido pelo IoT Platform para desenvolver o dispositivo, o lado do dispositivo se conectará automaticamente à instância Enterprise. Não é necessário modificar o nome de domínio de conexão do dispositivo. Para mais informações sobre o Link SDK, consulte Conexão do dispositivo. Caso não utilize o SDK do lado do dispositivo fornecido pelo IoT Platform, modifique o nome de domínio de conexão do dispositivo e desenvolva sua própria lógica de reconexão. Durante a migração, se um dispositivo estiver online, ele será forçado a ficar offline. Após a migração, os dispositivos migrados são excluídos automaticamente da instância pública legada. Não é necessário modificar o SDK do lado do dispositivo. Os dispositivos conseguirão se conectar à instância Enterprise de destino e se comunicar normalmente. Apenas usuários na lista de permissões podem migrar dispositivos que usam autenticação baseada em ID². Você pode abrir um ticket para solicitar permissão na lista de permissões. Para mais informações sobre autenticação baseada em ID², consulte Dispositivos autenticados por ID². Instruções para migração de dados do modelo TSL: Por padrão, a sincronização de dados está desativada. Após criar a tarefa de migração, ative manualmente a sincronização de dados para garantir que seus serviços não sejam afetados durante a migração da instância. Ao ativar a sincronização de dados, os dados reportados pelos dispositivos do produto a ser migrado na instância pública são sincronizados para a instância Enterprise de destino. A sincronização inicia com um atraso máximo de 1 minuto. A partir do dia em que você ativa a sincronização, os dados podem ser sincronizados por até 30 dias. É possível desativar e reativar manualmente o recurso de sincronização de dados do dispositivo. Caso não o desative manualmente, o sistema desativa a sincronização automaticamente após 30 dias. Antes que a sincronização seja desativada, certifique-se de concluir a migração da instância para evitar impactos nos serviços relacionados. A sincronização de dados é unidirecional. Ela suporta apenas a sincronização de dados reportados pelos dispositivos do produto a ser migrado da instância pública para a instância Enterprise. Quando a sincronização de dados está ativada, se um dispositivo for revertido da instância Enterprise para a instância pública, os dados migrados do dispositivo não serão revertidos. Quando o dispositivo for migrado novamente para a instância Enterprise, os dados nela estarão completos, mas os dados na instância pública ficarão incompletos.
  Encaminhamento de mensagens	Assinatura do lado do servidor: Configurações e relacionamentos de assinatura do lado do servidor AMQP e MNS. Encaminhamento de dados: Regras de encaminhamento, incluindo configurações SQL, fontes de dados, destinos de dados como RocketMQ, TSDB, RDS e FC, além de scripts de análise. Grupos de consumidores: Informações do grupo de consumidores. Após a migração, um novo ID de grupo de consumidores é criado.	Após a migração, os dados originais são mantidos na instância pública legada. Para evitar operações acidentais, exclua manualmente esses dados depois que a migração da instância for concluída e você confirmar que seus serviços estão funcionando normalmente. Se você configurou assinatura do lado do servidor AMQP ou encaminhamento de mensagens para AMQP, inicie dois clientes AMQP. Isso garante que tanto a instância pública quanto a instância Enterprise tenham um cliente AMQP para receber dados, prevenindo perda de dados. Instâncias Enterprise não suportam assinatura do lado do servidor via HTTPS. Altere o método de assinatura do lado do servidor de HTTPS na instância pública original para AMQP.

• Uso de recursos:

  Depois que os dispositivos forem migrados para a instância Enterprise de destino, continue usando as configurações migradas. Para utilizar recursos adicionais, reconfigure-os na instância Enterprise. Para mais informações sobre o uso de recursos, consulte Uso de recursos após a migração.

• Faturamento:

  Para dispositivos migrados para uma instância Enterprise, não há mais cobrança por comunicação de mensagens, duração de conexão ou atualizações over-the-air (OTA).

Preparações antes da migração

Avalie o impacto no negócio e modifique seus sistemas antes de migrar a instância para garantir que os dispositivos se comuniquem normalmente após a migração.

Fluxo geral de migração

O fluxo de migração da instância consiste nas quatro partes a seguir.

Procedimento de migração

1. Etapa 1: Criar uma tarefa de migração. Adicione uma tarefa de migração para um produto especificado.

   Importante

   Para garantir que seus serviços não sejam afetados durante a migração da instância, ative manualmente a sincronização de dados após criar a tarefa de migração. Essa ação migra os dados reportados pelos dispositivos do produto a migrar da instância pública para a instância Enterprise de destino. Para mais informações, consulte Ativar sincronização de dados.

2. Etapa 2: Realizar uma migração em escala cinza. Copie sequencialmente os dados de produto e de encaminhamento de mensagens e, em seguida, migre os dados para os dispositivos de escala cinza especificados.

   Aviso

   Se você configurou assinatura do lado do servidor AMQP ou encaminhamento de mensagens para AMQP, copie e atualize o ID do grupo de consumidores e inicie o novo SDK do cliente AMQP para receber dados após a conclusão da migração em escala cinza.

   Monitore a tarefa e garanta que a migração não afete seus serviços antes de realizar a migração completa.

3. Etapa 3: Realizar uma migração completa. Consulte todos os dados sob o produto especificado e migre todos os dados do dispositivo.

   Aviso

   Certifique-se de que a refatoração do sistema esteja concluída e publicada. Por exemplo, as chamadas de API na nuvem devem incluir o ID da instância Enterprise, e o ID do grupo de consumidores no SDK do cliente AMQP deve estar atualizado. Para mais informações, consulte Preparações antes da migração.

   Após o sucesso da migração completa, verifique o status e os resultados da execução do serviço para garantir que as chamadas de API na nuvem tenham sido trocadas para a instância Enterprise de destino.

4. Opcional: Reverter a tarefa de migração. Se a migração falhar ou ocorrer um problema, reverta todos os dados de dispositivo migrados, como informações de certificado do dispositivo e dados do modelo da Thing Specification Language (TSL), para a instância pública a fim de restaurar a operação normal. Esta operação não exclui os dados de assinatura do lado do servidor ou de encaminhamento de mensagens migrados da instância Enterprise de destino.

Referências

• Melhores práticas de migração de instância

• Perguntas frequentes sobre migração de instância

Perguntas frequentes

Antes da migração

• O que preciso saber ao migrar uma instância pública legada para uma instância Enterprise?

• A migração de uma instância pública legada para uma instância Enterprise consome as especificações de recursos da instância Enterprise?

• Posso migrar uma instância pública legada do IoT Platform de uma conta para uma instância Enterprise de outra conta?

• Posso migrar uma instância Enterprise do IoT Platform? Se sim, como?

• Ao migrar uma instância pública do IoT Platform para uma instância Enterprise, os pacotes de atualização OTA também podem ser migrados?

• Produtos e dispositivos autorizados em uma instância pública legada podem ser migrados para uma instância Enterprise?

• Uma instância pública legada pode ser migrada para todos os tipos de instâncias Enterprise?

• A migração de uma instância pública legada suporta migração entre regiões ou entre contas para uma instância Enterprise?

Durante a migração

• O que significa migração em escala cinza no contexto de migração de instância?

• Ao migrar uma instância pública legada para uma instância Enterprise, preciso criar produtos e dispositivos e configurar o encaminhamento de mensagens na instância Enterprise primeiro?

• A migração de uma instância pública legada afetará os dispositivos conectados?

Após a migração

• Após uma migração em escala cinza de instâncias públicas legadas, a página de detalhes da migração não exibe dispositivos ou informações de migração

• Preciso atualizar o nome de domínio de conexão após migrar uma instância pública legada?

• Após a migração bem-sucedida de uma instância pública legada, as chamadas do lado do servidor para APIs na nuvem precisam incluir o ID da instância Enterprise?