Documentação do Oracle Cloud Infrastructure

Fazendo Upgrade do Software do Roving Edge Device enquanto Desconectado

Saiba como fazer upgrade do software do dispositivo Roving Edge enquanto o dispositivo não estiver conectado à tenancy da Oracle Cloud Infrastructure (OCI).

Observação

A capacidade de fazer upgrade do software do dispositivo enquanto o dispositivo está desconectado foi introduzida no software Roving Edge versão 2.6. Se seu dispositivo estiver executando uma versão anterior (2.5 ou anterior), você deve atualizar o software do dispositivo enquanto estiver conectado. Para localizar a versão do software do dispositivo, consulte Identificando a Versão do Software do Dispositivo.

O processo de upgrade desconectado consiste em várias tarefas:

  1. Obtenha a versão atual do software do dispositivo.
  2. No OCI, solicite um pacote de upgrade do sistema.
  3. Transfira o pacote de upgrade para um bucket no dispositivo Roving Edge.
  4. No dispositivo, importe o bundle de atualização.
  5. Faça upgrade do dispositivo.

As etapas de cada tarefa são descritas nesta seção.

Você deve ter as permissões necessárias para executar um upgrade de software em um dispositivo Roving Edge Infrastructure desconectado. Consulte Ativando a Entrega de Pacote de Upgrade Desconectado (Opcional).

Observação

Os pacotes de atualização do sistema podem ser muito grandes. Eles podem levar muito tempo para fazer download e upload. Planeje de acordo.

Após a atualização, o dispositivo é reinicializado e você deve usar o console serial para desbloquear o dispositivo. Para se preparar para usar a console serial, consulte Operando a Console Serial.

  • Tarefa 1 – Obter a Versão de Software Atual do Dispositivo

    1. Acesse a Console do Dispositivo do dispositivo Roving Edge que você planeja atualizar.

    2. Selecione o ícone Status do Sistema (Ícone Status do Sistema) no canto superior direito da Console do Dispositivo.

      Upgrades do Sistema exibe a versão atual do software.

    3. Registre a versão atual do software do sistema. Você o utilizará posteriormente no processo de atualização.

    Tarefa 2 – Solicitar um Pacote de Atualização do Sistema

    1. Na Console do Oracle Cloud, abra o menu da navegação, selecione Híbrido e Nós.

    2. Se necessário, altere o compartimento para localizar o recurso que você deseja.

    3. Selecione o nó do dispositivo que você planeja atualizar.

      A página Detalhes do Nó é exibida.

      O nó do dispositivo deve estar no estado Cliente Recebido ou Implantado pelo Cliente para solicitar um pacote de upgrade do sistema.

    4. Selecione a guia Upgrades do sistema.

    5. Selecione Solicitar pacote de atualização do sistema.

      A caixa de diálogo Solicitar Pacote de Upgrade de Nó é exibida.

    6. Especifique as informações necessárias:

      • Informe a versão de software atual do nó do dispositivo na caixa Versão de Software Atual e selecione Obter Próxima Versão de Upgrade.

        O número de versão inserido é comparado com os pacotes de atualização disponíveis para ver qual é a correspondência apropriada. A melhor correspondência é exibida na caixa Versão de Atualização Compatível. Às vezes, pode ser necessário executar uma atualização de software de sistema provisória antes de executar a atualização desejada. A caixa Versão de atualização compatível garante que você siga a ordem de atualização necessária.

      • Selecione um bucket na lista Bucket de Destino. O bloco selecionado recebe o pacote de sistema que você está solicitando. Selecione Alterar Compartimento para selecionar um bucket de destino que reside em outro compartimento.

    7. Selecione Solicitar Pacote de Upgrade do Sistema.

      A lista Solicitações de Pacote de Upgrade do Sistema mostra o andamento da transferência do pacote para o bucket de destino especificado.

      Após a conclusão da transferência, o arquivo do pacote de upgrade é armazenado no bucket do Object Storage e permanece lá até você excluí-lo.

    8. (Opcional) No menu Ações (Uma imagem do ícone de três pontos.), selecione Exibir Detalhes para mostrar mais informações na solicitação de pacote de upgrade do sistema.

      As solicitações de serviço de solicitação de pacote de upgrade permanecem listadas por 48 horas.
    Tarefa 3 – Transferir o Pacote de Atualização para o Dispositivo.
    1. (Embora ainda tenha acessado a Console do Oracle Cloud) Após a conclusão da transferência do pacote de upgrade, selecione o nome do Bucket de destino para exibir o arquivo no bucket do Object Storage.

    2. Ao lado do arquivo de pacote de upgrade, selecione o menu Ações (menu Ações (Uma imagem do ícone de três pontos.) e selecione Fazer Download.

      A caixa de diálogo Fazer Download do Objeto é exibida durante o download do objeto e mostra o status do download.

    3. Copie o pacote baixado para um computador que você possa conectar à mesma rede do dispositivo Roving Edge Infrastructure.

    4. Faça upload do pacote de upgrade para o bucket rover-system-upgrade-staging no Roving Edge Object Storage. Consulte Fazendo Upload de um Objeto para um Bucket do Serviço Object Storage em um Dispositivo.

    Tarefa 4 – No dispositivo, importar o bundle de atualização

    1. Acesse a Console do Dispositivo do dispositivo Roving Edge que você planeja atualizar.

    2. No menu de navegação, selecione Gerenciamento de Nós e Upgrades do Sistema Off-line.

      Os bundles de atualização anteriores são listados. Se esta for a primeira solicitação do pacote de upgrade, a lista estará vazia.

    3. Selecione Importar Pacote.

      O painel Importar Solicitações de Pacote é exibido.

    4. Em Nome do Objeto, selecione o pacote de upgrade no menu suspenso.

    5. Selecione Importar Pacote.

      O pacote de upgrade é importado para o dispositivo e colocado em um bucket do Object Storage chamado rover-system-upgrade-staging. Quando a importação for concluída, o estado do bundle importado será alterado para Importado, e você poderá continuar atualizando o dispositivo.

    Tarefa 5 – Atualizar o dispositivo

    1. (Enquanto ainda estiver conectado ao Console do Dispositivo) Certifique-se de que a importação do pacote de upgrade tenha sido concluída. Selecione o ícone Status do Sistema (Ícone Status do Sistema) no canto superior direito da Console do Dispositivo.

      A caixa de diálogo Upgrades do Sistema exibe o status dos vários estágios do processo de importação. Quando a importação estiver concluída, a caixa de diálogo exibirá a versão atual do software do sistema do dispositivo e a nova versão importada.

    2. No menu de navegação, selecione Gerenciamento de Nós > Nós.

    3. Na linha do nó do dispositivo, selecione o menu Ações (Uma imagem do ícone de três pontos.) e selecione Upgrade.

    4. Confirme a solicitação de upgrade.

      A caixa de diálogo Upgrades do Sistema indica quando o upgrade está concluído.

      O dispositivo é reinicializado automaticamente ao final do processo de atualização. Você deve desbloquear o dispositivo reinicializado usando a console serial. Consulte Operando a Console Serial.

  • Você pode usar a CLI para executar tarefas de preparação de upgrade, mas não pode usar a CLI para executar o upgrade. Use o Console do Dispositivo para fazer upgrade do dispositivo.

    Comandos da CLI de Preparação de Upgrade

    Observação

    Os comandos a seguir são executados na tenancy do OCI. Certifique-se de usar um perfil da CLI configurado para acessar a tenancy do OCI.

    • Obter a versão de upgrade compatível: Execute o comando oci rover node rover-bundle-version get e os parâmetros necessários para obter a versão de upgrade compatível para um dispositivo Roving Edge Infrastructure:

      oci rover node rover-bundle-version get --current-rover-bundle-version current_rover_bundle_version --rover-node-id rover_node_ocid [OPTIONS]

    • Solicitar um pacote de upgrade do sistema: Execute o comando oci rover node rover-bundle copy-to-customer e os parâmetros necessários para solicitar um pacote de upgrade do sistema para um dispositivo Roving Edge Infrastructure.

      oci rover node rover-bundle copy-to-customer --bundle-version bundle_version \
--destination-bucket-name destination_bucket_name --destination-compartment-id destination_compartment_ocid \
--rover-node-id rover_node_ocid [OPTIONS]

    • Listar solicitações do pacote de upgrade: Execute o comando oci rover node rover-bundle-request list e os parâmetros necessários para listar as solicitações do pacote de upgrade de um dispositivo do Roving Edge Infrastructure:

      oci rover node rover-bundle-request list --rover-node-id rover_node_ocid [OPTIONS]

    • Exibir o andamento da transferência de uma solicitação de upgrade: Execute o comando oci rover node rover-bundle get-status e os parâmetros necessários para exibir o andamento da transferência de uma solicitação de upgrade de um dispositivo Roving Edge Infrastructure:

      oci rover node rover-bundle get-status --rover-node-id rover_node_ocid --work-request-id work_request_ocid [OPTIONS]
    Observação

    Os comandos a seguir são executados no Roving Edge Device. Certifique-se de usar um perfil de CLI configurado para acessar o dispositivo (não sua tenancy do OCI).

    • Faça upload do pacote do sistema para o dispositivo em um bucket do Object Storage chamado rover-system-upgrade-staging: Execute o comando oci rover device system-upgrade upload-bundle e os parâmetros necessários. 

      oci rover device system-upgrade upload-bundle --endpoint device_object_storage_endpoint --file bundle_file_path

    • Importe o pacote de upgrade para um bucket do Object Storage no dispositivo: Execute o comando oci rover device system-upgrade import-bundle.

      oci rover device system-upgrade import-bundle --object-name object_name

      em que object_name é o nome do objeto do pacote de upgrade. Por exemplo: 2.5.3.20230808163434.rover_disconnected_release.tar.

    • Exibir todas as tarefas de importação: execute o comando oci rover device system-upgrade get-import-history.

      oci rover device system-upgrade get-import-history --endpoint upgrade_endpoint

    • Exibir uma tarefa específica: Execute o comando oci rover device system-upgrade get-import-status.

      oci rover device system-upgrade get-import-status --endpoint upgrade_endpoint --task-id task_ocid --wait true|false

    Depois que o status de importação indicar COMPLETED, você poderá prosseguir com a atualização normal do software do sistema usando o Console do Dispositivo.

  • Não é possível executar essa tarefa usando a API.