Autoprovisionando um Roving Edge Device

Pré-requisitos

As seguintes tarefas devem ser concluídas para que você possa provisionar o dispositivo automaticamente:

Prepare-se para Autoprovisionar o Dispositivo

1. Acesse a tenancy do OCI em que o recurso de infraestrutura do Compute Cloud@Customer foi criado para o novo dispositivo Roving Edge e salve as seguintes informações para recuperá-lo posteriormente:

   • OCID da Tenancy – Para localizar o OCID da tenancy do OCI, acesse a Console do OCI, selecione o menu de navegação (ícone de hambúrguer) e vá para Governança e Administração > Detalhes da Tenancy. Copie o OCID da tenancy do OCI associada a esse dispositivo.

   • Enquanto estiver conectado à tenancy, no menu de navegação, selecione Híbrido e Multinuvem e, em seguida, selecione Oracle Compute Cloud@Customer. Selecione a infraestrutura que foi criada para este dispositivo. Selecione o botão de cópia do OCID.

2. Estabeleça uma sessão temporária da CLI do OCI no emulador de terminal em seu host de controle:

   Para obter mais informações, consulte Autenticação Baseada em Token para a CLI.

   Observação
   
   

   A sessão expira após 24 horas. Se o autoprovisionamento levar mais tempo do que isso, você deverá estabelecer uma nova sessão.

   1. Gere um token de sessão criando uma sessão temporária usada para autenticação com o OCI durante o autoprovisionamento:

      oci session authenticate

   2. Exibe o arquivo de configuração que foi criado para a sessão temporária.

      Você se refere a essa saída em uma tarefa subsequente. Exemplo:

      $ cat ~/.oci/config
      [profile]
      fingerprint = 1a:2b:3c:4d:5e:6f:7g:8h:9i:0k:e7:07:fa:b0:34:56
      key_file = /Users/user1/.oci/sessions/profile/oci_api_key.pem
      tenancy = ocid1.tenancy.oc1..unique-id
      region = us-phoenix-1
      security_token_file = /Users/user1/.oci/sessions/profile/token

   3. Exibe o conteúdo do diretório no qual o arquivo de token de segurança é armazenado de acordo com o arquivo de configuração da CLI do OCI.

      Você precisa de tokens e chaves em uma tarefa subsequente. Exemplo:

      $ ls ~/.oci/sessions/<my-profile>
      oci_api_key_public.pem	oci_api_key.pem		token

Iniciar o Processo de Autoprovisionamento

O seguinte menu é exibido quando o dispositivo é inicialmente ligado e inicializa pela primeira vez (consulte Ligar o Dispositivo):

Roving Edge Basic Configuration Interface (ver. 2.0.58)
Number selects a menu item, Enter accepts the selection, Ctrl+Z refreshes the
menu, Ctrl+C returns to main menu, Backspace deletes a character.

1) Select Platform
2) Advanced Operations

Select option (1-2):

Ao trabalhar com os menus do console serial, insira o número do menu da opção de menu.

1. Informe o número para Selecionar Plataforma.

   Exemplo:

   Select option (1-2): 1
   
   Roving Edge Basic Configuration Interface (ver. 2.0.58) / Select Platform
   Number selects a menu item, Enter accepts the selection, Ctrl+Z refreshes the
   menu, Ctrl+C returns to main menu, Backspace deletes a character.
   
   1) Roving Edge Classic
   2) OCI Edge Platform
   
   Select option (1-2):

2. Selecione OCI Edge Platform.

   O menu principal de autoprovisionamento é exibido.

   Roving Edge Basic Configuration Interface - OCI Edge Platform (ver. 2.0.58)
   Number selects a menu item, Enter accepts the selection, Ctrl+Z refreshes the
   menu, Ctrl+C returns to main menu, Backspace deletes a character.
   
   1) Configure Networking
   2) Set Up OCI Connectivity
   3) Set Up Credentials
   4) Advanced Operations
   
   Select option (1-4):

   Observação
   
   

   O menu principal exibe a lista de operações de alto nível. Cada operação tem submenus. Você pode pressionar Ctrl+C para retornar ao menu principal em um submenu. Se quiser cancelar ou voltar da operação atual ou se o processo parar e não responder, use Ctrl+Z para atualizar a tela. Certas operações impedem o uso de Ctrl+C ou Ctrl+Z enquanto ainda estão em andamento.

Configurar rede de dispositivos

Esta tarefa configura as configurações de rede do dispositivo para permitir acesso à rede pública.

1. Selecione Configurar Rede.

   O submenu de rede é exibido.

   Roving Edge Basic Configuration Interface - OCI Edge Platform (ver. 2.0.58) / Configure Networking
   Number selects a menu item, Enter accepts the selection, Ctrl+Z refreshes the
   menu, Ctrl+C returns to main menu, Backspace deletes a character.
   
   1) IP Address:
   2) Gateway:
   3) DNS Servers: 206.223.27.1, 206.223.27.2
   4) NTP Servers:
   5) Proxy URL:
   6) Test Network Connectivity to OCI
   7) Check OCI Server Clock and Device Clock
   
   Select option (1-7):

2. Use as opções de menu para configurar os parâmetros de rede do dispositivo de acordo com seu ambiente de rede:

   • Endereço IP: Informe um endereço IP para o dispositivo físico usando um destes formatos:

     A.B.C.D/P ou A.B.C.D/M (P - comprimento do prefixo ou M - máscara de rede). Exemplo: 203.0.113.2/24

   • Gateway: Informe o endereço IP do gateway. Exemplo: 203.0.113.1

   • Servidores DNS: Informe endereços IP de servidores DNS, como A.B.C.D, separados por vírgula. Exemplo: 216.146.35.35,216.146.36.36,

   • (Opcional, mas altamente recomendado) Servidores NTP: Informe endereços IP do servidor NTP separados por uma vírgula. Exemplo: 203.0.113.15,203.0.113.16,203.0.113.17,

     O uso do NTP impede que o relógio do dispositivo fique à deriva, o que causaria problemas de TLS.

   • (Opcional) URL do Proxy: Se um proxy for necessário para acesso à Internet, informe o URL. Exemplo: https://<hostname>:<port>. Somente proxy de encaminhamento básico é suportado: host e porta configurados manualmente sem autenticação ou recursos avançados.

3. Selecione Testar Conectividade de Rede com o OCI. O dispositivo faz uma chamada HTTP para o OCI para verificar o acesso à rede pública e a resolução de nomes.

4. Selecione Verificar Relógio do Servidor OCI e Relógio do Dispositivo. O dispositivo extrai o relógio do servidor do OCI e o compara com o relógio do dispositivo.

   A autenticação falha se o relógio do cliente estiver desviado mais de 5 minutos do relógio do servidor. Para obter mais informações, consulte Diferença Máxima Permitida para o Clock do Cliente. Se o relógio do dispositivo estiver desviado mais de 5 minutos do relógio do servidor, informe novamente os Servidores NTP para atualizar e sincronizar o horário. Em seguida, execute a verificação do relógio novamente.

Configurar Conectividade com o OCI

Esta tarefa registra o dispositivo no OCI. O registro valida o dispositivo e o associa à infraestrutura correspondente em sua tenancy do OCI.

Use os parâmetros que você pesquisou e salvou ao se preparar para autoprovisionamento. Consulte Pré-requisitos e Preparar para Autoprovisionar o Dispositivo.

1. Na console serial, digite Ctrl+C para retornar ao menu principal.

2. Informe o número para Configurar Conectividade do OCI.

   O submenu Configurar Conectividade do OCI é exibido.

   Roving Edge Basic Configuration Interface - OCI Edge Platform (ver. 2.0.58) / Set Up OCI Connectivity
   Number selects a menu item, Enter accepts the selection, Ctrl+Z refreshes the
   menu, Ctrl+C returns to main menu, Backspace deletes a character.
   
   1) Region:
   2) Tenancy ID:
   3) Infra ID:
   4) Session Token:
   5) Session Private Key:
   6) Register Device to OCI
   7) Retry Obtaining Resource Principal
   
   Select option (1-7):

3. Use as opções de menu sucessivas para configurar a conectividade do OCI:

   • Selecione Região: Informe a região que foi listada na saída do arquivo config. Exemplos: us-ashburn-1, uk-london-1, us-phoenix-1

   • Selecione ID da Tenancy: Informe o ID da Tenancy no Formato do OCID. Por exemplo, ocid1.tenancy.<REALM>..uniqueID

   • Selecione OCID da Infraestrutura: Digite o OCID da infraestrutura.

   • Selecione Token de Sessão: Este é o token gerado para sua sessão temporária da CLI do OCI durante a preparação. Informe o conteúdo do security_token_file que foi listado na saída do arquivo config.

     Certifique-se de selecionar apenas a saída do token de sessão. Omita quaisquer símbolos e caracteres circundantes.

     $ cat token && echo ""
     abcdefghijklmnopqrstuvwxyzeyJraWQiOiJhc[...]3dfaWFkXzhia04-YzxddQ12345677890

   • Selecione Chave Privada da Sessão: Informe o conteúdo do key_file que está listado na saída do arquivo config.

     Só copie as linhas que começam com BEGIN PRIVATE KEY e terminam com END PRIVATE KEY. Omita quaisquer outros caracteres.

     $ cat oci_api_key.pem | sed '$d'
     -----BEGIN PRIVATE KEY-----
     MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQD7EqlbJj7l1DD0
     {...}
     QEuLAD1TE6M312345677890==
     -----END PRIVATE KEY-----
     $

     Este arquivo contém várias entradas. Portanto, depois de colar a tecla, você deve pressionar Return duas vezes para sair do modo de entrada.

   • Selecione Registrar Dispositivo no OCI.

     O número de série do dispositivo é registrado no recurso de infraestrutura em sua tenancy do OCI. Um controlador de recursos é obtido automaticamente.

     Se a etapa final falhar, tente novamente executando Repetir Obtenção do Controlador de Recursos.

Fazer Download e Instalar o Software Edge Platform

O dispositivo é fornecido com um pequeno sistema operacional instalador. Nesta tarefa, você faz download e instala o software Roving Edge completo.

Recomendamos que você use uma rede de alta velocidade para esta tarefa.

1. Na console serial, digite Ctrl+C para retornar ao menu principal.

2. Selecione Instalar Imagem da Plataforma.

   O seguinte menu é exibido:

   Roving Edge Basic Configuration Interface - OCI Edge Platform (ver. 2.0.58) / Install Platform Image
   Number selects a menu item, Enter accepts the selection, Ctrl+Z refreshes the
   menu, Ctrl+C returns to main menu, Backspace deletes a character.
   
   1) Download Installation Files
   2) Start Installation
   
   Select option (1-2):

3. Selecione Download de Arquivos de Instalação.

   Vários arquivos de imagem ISO são baixados. Aguarde a conclusão do download.

4. No final do download, a versão ISO é exibida. Pressione qualquer tecla para continuar e iniciar a instalação.

5. Selecione Iniciar Instalação.

   Quando o processo é concluído, uma mensagem é exibida para indicar que a instalação foi concluída e que o dispositivo será reinicializado.

6. Após a reinicialização, um menu GRUB aparece com apenas uma opção de inicialização: SO Edge com inicialização segura. Se não iniciar automaticamente, selecione-o com as teclas de seta e pressione Return. O processo de inicialização pode levar 10 minutos.

7. Quando o dispositivo conclui a sequência de inicialização, a Tela de Bloqueio da Console Serial do OCI Edge Platform é exibida.

   Defina uma frase-senha inicial para a console serial. Se você precisar gerenciar essa senha no futuro, consulte Alterando a Frase-Senha da Console Serial.

   Requisitos de frase secreta:

   • Tamanho Mínimo: 8 caracteres

   • Tamanho Máximo: 64 caracteres

   • Deve incluir os seguintes caracteres:

     • Um caractere minúsculo
     • Um caractere maiúsculo
     • Um dígito
     • Um caractere especial desta lista:

       [ ] ! @ # % ^ & * ( ) _ = + " ` ~ $ - { } | \ ; < > . / ? ,

   Pressione Return para voltar para a tela principal.

8. Informe a frase-senha para desbloquear a console serial.

   O menu da console serial do OCI Edge Platform é exibido.

      OCI Edge Platform
      ---------------------------
   1) Change Passphrase
   2) Check Network Configuration
   3) Show Status
   4) Show System Diagnostics
   5) Shutdown Device
   6) Reboot Device
   7) Advanced Menu
   8) Help
   9) Lock Screen
   
   Enter command number:

   Todo o acesso futuro à console serial requer a frase-senha de desbloqueio do dispositivo.

   Se a instalação falhar, a interface exibirá uma string codificada em BASE64 que contém um arquivo compactado com os logs. Por exemplo:

   BASE64 encoded output for the logs archive follows:
   ============
   <BASE64_string>
   ============

   Copie e salve a saída BASE64 (texto entre linhas ===) em um arquivo. Em seguida, envie o arquivo para o Oracle Support. Consulte Autoprovisionamento. Você também pode reiniciar a instalação.

9. Aguarde a conclusão dos processos em segundo plano de instalação do software. Verifique o status a ser confirmado:

   1. No menu da console serial do OCI Edge Platform, selecione Menu Avançado e, em seguida, selecione Instalar Gerenciamento.

         Install Management
         -----------------------------
      1) Monitor Installation Progress
      2) Number of Log Lines

   2. No menu Install Management, selecione Monitorar Andamento da Instalação.

      Por padrão, as últimas 20 linhas do log de instalação são exibidas. Você pode personalizar essa configuração usando a opção de menu Número de Linhas de Log.

       These are the last 20 lines from the installation log:
      =============================================================
      Tuesday 03 February 2026  00:12:59 +0000 (0:00:00.361)       0:00:03.843 ******
      changed: [100.96.2.33]
      
      TASK [add the reprovision complete lock for this node] *************************
      Tuesday 03 February 2026  00:13:00 +0000 (0:00:00.468)       0:00:04.311 ******
      skipping: [100.96.2.33]
      
      PLAY RECAP *********************************************************************
      100.96.2.33                : ok=6    changed=3    unreachable=0    failed=0    skipped=1    rescued=0    igno0
      
      Tuesday 03 February 2026  00:13:00 +0000 (0:00:00.008)       0:00:04.319 ******
      ===============================================================================
      Gathering Facts --------------------------------------------------------- 2.60s
      Copy Install Logs ------------------------------------------------------- 0.81s
      add the install complete lock for this node ----------------------------- 0.47s
      Copy platform log ------------------------------------------------------- 0.36s
      Include pca-system-config ----------------------------------------------- 0.04s
      Check for tag ----------------------------------------------------------- 0.03s
      add the reprovision complete lock for this node ------------------------- 0.01s
      Tue Feb  3 00:13:00 UTC 2026  Install completed on pcamn01.
      =============================================================
      
      Installation is COMPLETE.
      Press ENTER to return... 

   3. Continue monitorando até que a saída do log informe que a instalação foi concluída. Em seguida, retorne ao menu principal.

10. Mantenha-se conectado ao console serial. Você a usa novamente em Concluindo a Configuração e a Configuração Iniciais do Software Edge Platform.

O Que Há a Seguir?

• Configuring the Edge Platform Software from the Graphical User Interface (preferencial)
• Configurando o Software da Plataforma de Borda na CLI de Serviço