RAIOP · Agent Linux

Ajuda e instalação

Esta documentação cobre o fluxo oficial do beta Linux. Use sempre o artefato e o checksum fornecidos pelo canal autorizado do beta; não instale binários de URLs desconhecidas.

Requisitos

• Linux compatível com a release beta.9, arquitetura publicada para o artefato escolhido e acesso de saída ao control plane.
• Permissão administrativa somente durante a instalação/serviço, conforme o pacote entregue.
• Relógio do sistema razoavelmente correto, DNS funcional e firewall permitindo o endpoint configurado.

Windows, Android, macOS e distribuições não verificadas não são suportados oficialmente neste beta.

Instalação

1. Obtenha o artefato beta por um canal autorizado.
2. Verifique o checksum publicado antes de instalar.
3. Execute o installer da própria release com privilégios mínimos; não copie comandos de terceiros.
4. Confirme que o serviço inicia e registre somente a saída sanitizada necessária ao suporte.

O repositório mantém o procedimento operacional em pipeline de release; a URL é apenas referência pública e não contém credenciais.

Pairing

1. Abra o fluxo de adicionar device no control plane.
2. Inicie o pairing no Agent e mantenha o código de usuário privado.
3. Confirme a organização e aprove somente o device correto.
4. Valide o status online e execute primeiro uma operação read-only.

Revogar device

No control plane, abra Dispositivos → Detalhes → Revogar. A credential deixa de ser válida, a sessão WSS é encerrada e novas operações devem ser negadas. Em suspeita de comprometimento, faça isso antes de investigar.

Atualizar e voltar atrás

Use somente artifacts beta assinados/checados, respeitando o canal e a política do device. Se uma atualização falhar, preserve a evidência sanitizada, interrompa novas tentativas e siga o runbook operacional. Rollback não deve usar URL arbitrária nem payload de terceiro.

Troubleshooting

• Pairing expira: confira relógio, conectividade e código; gere um novo pairing.
• Device offline: confira o serviço, DNS, firewall e logs locais sem credenciais.
• Operação pendente: verifique aprovação, policy, capability anunciada e conectividade.
• Falha após update: pare, registre versão/build e use o fluxo de rollback autorizado.

Remover o Agent

Use o desinstalador da mesma release e confirme que o serviço foi parado/removido. Depois, revogue o device no control plane. Apague apenas os dados locais indicados pelo pacote; preserve evidência somente se houver incidente.

Limitações

Veja o Aviso de Beta. Para suporte, use o canal configurado em Ajuda e suporte.