Para que uma máquina virtual ou física rodando Armbian (arquitetura ARM) seja gerenciada e monitorada corretamente pelo Xen Orchestra, você precisa instalar o Xen Guest Agent. Esse agente reporta ao painel do Xen Orchestra informações cruciais como o endereço IP real, estatísticas de consumo, versão do Kernel e permite comandos de desligamento/reboot limpos.
Como o Armbian roda em processadores ARM (como Raspberry Pi, Orange Pi ou TV Boxes), você deve usar a versão do agente reescrita em Rust pelo projeto oficial do Xen, compatível com essa arquitetura.
Siga o passo a passo abaixo via terminal SSH no seu Armbian:
1. Adicionar o Repositório Oficial do Xen Guest Agent
O projeto Xen disponibiliza pacotes .deb universais compilados em Rust. Adicione o repositório oficial diretamente no Armbian executando o comando:
bash
echo "deb [trusted=yes] https://gitlab.com/api/v4/projects/xen-project%252Fxen-guest-agent/packages/generic/deb-amd64/ release/" | sudo tee -a /etc/apt/sources.list.d/xen-guest-agent.list
Use o código com cuidado.
(Nota: Apesar do nome do diretório conter “amd64” na URL da API de pacotes genéricos do GitLab, o repositório serve os binários multiplataforma em Rust compatíveis com ARM através do gerenciador de pacotes).
2. Atualizar os Índices do Sistema
Atualize a lista de pacotes do Armbian para reconhecer o novo repositório adicionado: [1]
bash
sudo apt updateUse o código com cuidado.
3. Instalar o Agente de Gerenciamento
Instale o pacote do agente com o comando:
bash
sudo apt install xen-guest-agent -yUse o código com cuidado.
4. Habilitar e Iniciar o Serviço
Certifique-se de que o serviço do agente está ativo e configurado para iniciar automaticamente junto com o sistema:
bash
sudo systemctl enable xen-guest-agent
sudo systemctl start xen-guest-agentUse o código com cuidado.
5. Verificar o Status
Confirme se o agente está rodando sem erros no Armbian:
bash
sudo systemctl status xen-guest-agentUse o código com cuidado.
O que muda no Xen Orchestra?
Assim que o serviço for iniciado, acesse a interface web do seu Xen Orchestra:
- Vá até a aba Home > VMs.
- Selecione a sua máquina Armbian.
- Na aba General, você notará que o aviso de “Management agent not detected” sumirá.
- O Xen Orchestra passará a exibir o endereço IP correto da máquina, gráficos detalhados de RAM/CPU e liberará as funções seguras de gerenciamento de energia.
Caso o Agente não se conete pode executar essas etapas
O Xen Guest Agent do Armbian não precisa de configuração de IP ou senha para se conectar ao Xen/Xen Orchestra. A comunicação acontece de forma totalmente automática através do Xenstore (um banco de dados compartilhado na memória entre o Hypervisor/Dom0 e a sua máquina virtual).
Se você já instalou o agente e ele ainda não aparece como conectado no Xen Orchestra, o problema geralmente está relacionado a dependências ausentes do sistema ou à inicialização do canal de comunicação.
Siga estes passos para fazer o agente se comunicar:
1. Garantir as Dependências de Comunicação (Xenstore)
O agente em Rust precisa interagir com a biblioteca do Xenstore do Linux. Se ela não estiver instalada, ele roda em “loop invisível” e não envia dados ao Xen. No Armbian, instale a biblioteca executando:
bash
sudo apt update && sudo apt install libxenstore4 -yUse o código com cuidado.
(Caso sua versão do Armbian seja mais antiga e reporte que o pacote não foi encontrado, tente sudo apt install libxenstore3.0 -y).
2. Reiniciar o Serviço do Agente
Após garantir a biblioteca, force o reinício do serviço para que ele abra o canal de comunicação com o Xen:
bash
sudo systemctl restart xen-guest-agentUse o código com cuidado.
3. Verificar se o Agente está Ativo e “Conversando”
Verifique o status do serviço rodando:
bash
sudo systemctl status xen-guest-agentUse o código com cuidado.
O que procurar nos logs:
- Se aparecer
Active: active (running), significa que o software está rodando. - Se notar erros como
Failed to write to XenstoreouXenstore not available, a sua máquina virtual pode não estar identificando que está dentro de um ambiente Xen.
4. O “Pulo do Gato”: Reiniciar a VM pelo Painel
Muitas vezes, o Hypervisor (XCP-ng ou Citrix XenServer) só atualiza os metadados e ativa os drivers paravirtualizados após um ciclo completo de boot da VM.
- Vá até o Xen Orchestra.
- Dê um Reboot (ou Desligar e Ligar) na VM do Armbian.
- Ao iniciar, o Xen Orchestra lerá os blocos de memória atualizados pelo agente e mudará o status para conectado.
Se após o reboot o Xen Orchestra continuar dizendo que o agente não está instalado, me diga: qual é a mensagem de erro exata que aparece ao rodar o sudo systemctl status xen-guest-agent? Posso te ajudar a diagnosticar o log!
Perito em Computação Forense e Crimes Cibernéticos
Investigação Digital | Laudos Técnicos | Resposta a Incidentes
Bacharel em Sistemas da Informação, Certificado Microsoft Azure IA e MOS. Trabalho como Administrador de Redes, Firewall e Servidores Windows e Linux!
Minhas atividades favoritas são: Caminhar, Fazer Trilhas, Natureza, Insetos e claro ler sobre Tecnologia.