Instalação do GLPI Inventory no Linux

1. Nome do computador a ser inventariado

Para inventariar um computador Linux no GLPI, instale o GLPI Agent no equipamento. Este manual descreve a instalação e as configurações utilizadas no Campus Araquari, com comandos para Debian e Ubuntu com systemd.

ATENÇÃO: antes da instalação, altere o nome do computador conforme a normativa institucional de padronização de nomes. Se a alteração exigir uma reinicialização, conclua-a antes de prosseguir.

Exemplo de nome: ara-ad-pc-bib01.

Confira o nome atual do equipamento no terminal:

hostnamectl status

Se for necessário alterá-lo, utilize o comando abaixo, substituindo o exemplo pelo nome definido para o equipamento:

sudo hostnamectl set-hostname ara-ad-pc-bib01

Confira também se o arquivo /etc/hosts contém uma referência ao nome antigo, como na entrada 127.0.1.1. Se houver, atualize somente o nome correspondente, preservando os demais registros.

2. Download do GLPI Inventory

Para o download do agente, use o seguinte link:
https://github.com/glpi-project/glpi-agent/releases

OBS: Para máquinas Linux utilize a ÚLTIMA VERSÃO "Linux Installer" disponível do seu SO (no nosso caso, Debian, Ubuntu, etc.) para download. Será um arquivo com extensão .pl (utilize a versão que contenha o instalador "snap").

ATENÇÃO: Os comandos a seguir utilizam a versão 1.21, disponível na revisão deste manual. Ao utilizar uma versão posterior, atualize o número da versão no endereço de download e em todos os nomes de arquivo dos comandos.

3. Instalação do GLPI Inventory

Abra um terminal com uma conta que tenha permissão para executar comandos com sudo. Garanta que o computador tenha acesso à internet e aos repositórios da distribuição.

Em Debian ou Ubuntu, instale as ferramentas utilizadas neste procedimento:

sudo apt update
sudo apt install perl wget ca-certificates nano

Acesse o diretório /tmp e faça o download do instalador oficial:

cd /tmp
sudo wget -c https://github.com/glpi-project/glpi-agent/releases/download/1.21/glpi-agent-1.21-with-snap-linux-installer.pl

Em seguida, execute o instalador com Perl. Como o arquivo será aberto pelo interpretador, não é necessário conceder permissão de execução com chmod:

sudo perl glpi-agent-1.21-with-snap-linux-installer.pl

Acompanhe as mensagens no terminal. Quando solicitado, confirme a instalação dos pacotes e mantenha o agente configurado para execução como serviço.

Se o instalador solicitar o endereço do servidor (Provide an URL...), informe o endereço abaixo:

https://helpdesk.ifc.edu.br/front/inventory.php

Se solicitar a tag (Provide a tag...), informe:

ARAQUARI

OBS: a tag deve ser ARAQUARI, em letras maiúsculas. 

As perguntas podem variar conforme a versão do instalador. Confira os valores antes de aceitar as opções padrão. Independentemente das perguntas exibidas, revise as configurações na etapa abaixo.

3.1. Configuração do servidor e da tag

A configuração principal fica em /etc/glpi-agent/agent.cfg. Para manter os ajustes institucionais separados das configurações do pacote, utilize um arquivo com extensão .cfg no diretório /etc/glpi-agent/conf.d/

Confira se a linha include conf.d/ está ativa no arquivo principal, sem o caractere # no início:

sudo nano /etc/glpi-agent/agent.cfg

Em seguida, crie ou edite o arquivo de configuração institucional:

sudo nano /etc/glpi-agent/conf.d/00-institucional.cfg

Insira as seguintes configurações no arquivo criado, preservando o endereço completo do servidor e a tag em letras maiúsculas:

server = https://helpdesk.ifc.edu.br/front/inventory.php
tag = ARAQUARI

3.2. Gravação do inventário local em JSON

Para manter uma cópia local do inventário em JSON, como na configuração apresentada no manual do Windows, crie um diretório para os arquivos:

sudo mkdir -p /var/lib/glpi-agent/inventory

Acrescente as linhas abaixo ao arquivo /etc/glpi-agent/conf.d/00-institucional.cfg e salve:

local = /var/lib/glpi-agent/inventory
json = 1

Essa configuração mantém a gravação local e o envio ao servidor. O parâmetro local não substitui o parâmetro server.

A configuração final do arquivo ficará conforme a imagem abaixo:

3.3. Remoção do arquivo de instalação

Em alguns casos, o instalador do GLPI Agent pode criar o arquivo 00-install.cfg no diretório /etc/glpi-agent/conf.d/. É necessário remover esse arquivo para evitar conflitos com as informações do arquivo 00-institucional.cfg, criado anteriormente. Remova-o com o seguinte comando:

rm -rf /etc/glpi-agent/conf.d/00-install.cfg

ATENÇÃO: dependendo da versão do GLPI Agent, o nome do arquivo pode apresentar variações de install, como installation. Confira o nome do arquivo e ajuste o comando antes de executá-lo.

3.4. Inicialização do serviço

Habilite a inicialização automática do agente e reinicie o serviço para aplicar as configurações:

sudo systemctl enable glpi-agent.service
sudo systemctl restart glpi-agent.service
sudo systemctl status glpi-agent.service --no-pager

PRONTO: o GLPI Agent foi instalado e configurado. Confira se o serviço apresenta o estado active (running) e prossiga com a verificação do inventário.

4. Verificação do GLPI Agent

No Linux, acompanhe o agente pelo serviço e, quando habilitada, pela interface web local. No navegador do próprio equipamento, acesse:

http://localhost:62354

Se a interface estiver acessível e a opção estiver disponível, clique em Force an Inventory para solicitar uma execução. O estado de espera (waiting) entre as execuções pode ser normal.

Caso a opção Force an Inventory não estiver disponível, executar o inventário pelo terminal:

sudo glpi-agent --force

Aguarde a conclusão e observe as mensagens. Depois, acesse o GLPI institucional, abra Ativos → Computadores e localize o equipamento pelo nome. Confira o número de série e a data do último inventário.

ATENÇÃO o serviço em execução ou a página local acessível não confirmam, por si só, o recebimento do inventário no servidor. Essa confirmação deve ser feita no cadastro do computador no GLPI.

5. Resolução de problemas

Se o inventário não aparecer no GLPI, confira o endereço do servidor, a tag ARAQUARI, a inclusão do arquivo institucional.cfg no diretório conf.d/ e a existência de configurações antigas ou conflitantes. Após qualquer alteração, reinicie o serviço.

Para consultar as mensagens recentes do serviço, utilize:

sudo journalctl -u glpi-agent -n 100 --no-pager

Para acompanhar uma execução manual com mais detalhes, utilize:

sudo glpi-agent --force --debug

Se o agente estiver configurado para gravar logs em arquivo, consulte também o caminho definido pelo parâmetro logfile. Verifique mensagens sobre conexão, resolução de nomes, certificados e rejeição do inventário.

Se a interface local não abrir, confira se o serviço está em execução e se a interface HTTP está habilitada na porta configurada. Se o serviço indicar falha, utilize as mensagens de diagnóstico para identificar a causa antes de tentar novamente.

OBS: os caminhos e os comandos deste manual consideram a instalação com pacotes DEB e serviço systemd. Instalações por Snap ou por outros métodos podem utilizar comandos de serviço e caminhos diferentes.