Como Instalar o Servidor OCS Inventory no Ubuntu 22.04

OCS Inventory Server é um software de código aberto que permite escanear e inventariar todos os dispositivos em seu ambiente ou departamentos de TI. É uma solução gratuita de gerenciamento de inventário e ativos que ajuda você a acompanhar todas as informações dos seus dispositivos e computadores.

Existem 4 componentes principais do OCS Inventory Server: o servidor de banco de dados, o servidor de comunicação, o servidor de administração e o servidor de implantação. O OCS Inventory Server permite que você obtenha os dados mais recentes e relevantes sobre seus dispositivos. Ele pode ser instalado em vários sistemas operacionais e fornece pacotes de agente para vários sistemas operacionais, como Microsoft Windows, Linux, BSD, Sun Solaris, IBM AIX, HP-UX, MacOS X e Android.

Quanto aos dispositivos de rede, o OCS Inventory suporta descoberta de rede e agentes SNMP. Você pode adicionar e inserir informações sobre seu hardware de rede: impressoras, switches, computadores (que não têm um agente OCS instalado), etc., via descoberta de rede e agentes SNMP.

Neste guia, você instalará o OCS Inventory Server em um servidor Ubuntu 22.04. Você instalará o OCS Inventory Server com o servidor web Apache2, o servidor de banco de dados MariaDB e o PHP. Isso também inclui a instalação do ocsreports, que é uma aplicação baseada em PHP que fornece um painel de administração web para o OCS Inventory Server e será executado com Apache2 e PHP.

Pré-requisitos

Para completar este guia, você deve ter os seguintes requisitos:

• Um servidor Linux executando Ubuntu 22.04 - Este exemplo usa um servidor Ubuntu genérico e novo com o nome do host ‘ocs-server‘ e o endereço IP ‘192.168.5.20‘.
• Um usuário não-root com privilégios de administrador sudo/root.

Quando esses requisitos estiverem prontos, vá em frente e comece a instalação do OCS Inventory Server.

Instalando Dependências

Nesta primeira seção, você deve instalar algumas dependências que serão usadas para instalar e executar o OCS Inventory Server. Esta instalação incluirá os seguintes pacotes:

• Dependências básicas - Esses pacotes serão usados para compilar alguns módulos Perl.
• Perl e alguns pacotes Perl adicionais - O OCS Inventory Server é escrito em Perl, então você deve instalar o Perl em seu servidor. Alguns pacotes Perl adicionais aqui incluem o driver de banco de dados Perl e o pacote SOAP Perl para a API REST.
• Pilha LAMP - O OCS Inventory Server será executado com Apache2 e banco de dados MariaDB. Os pacotes PHP serão usados pelo ‘ocsreports‘, que é o painel da aplicação web do OCS Inventory Server.
• Módulos Perl adicionais - Você instalará alguns módulos Perl via CPAN (The Comprehensive Perl Archive Network).

Antes de começar, insira o seguinte comando para atualizar e refrescar o índice de pacotes do Ubuntu.

sudo apt update

Insira o seguinte comando ‘apt install‘ para instalar algumas dependências básicas de desenvolvimento. Esses pacotes são usados principalmente para compilar alguns módulos Perl.

sudo apt install git curl wget make cmake gcc make

Quando solicitado, digite y para confirmar e pressione ENTER para prosseguir.

Agora instale o Perl e alguns pacotes Perl via o comando ‘apt install‘ abaixo. O OCS Inventory Server é principalmente escrito em Perl, então você deve instalar os pacotes Perl antes de instalar o OCS Inventory Server.

sudo apt install perl libxml-simple-perl libcompress-zlib-perl libdbi-perl libdbd-mysql-perl libnet-ip-perl libsoap-lite-perl libio-compress-perl

Digite y quando solicitado e pressione ENTER para prosseguir.

Em seguida, instale a Pilha LAMP com alguns pacotes adicionais, como ‘libapache2-mod-perl2‘ e ‘composer‘ via o seguinte comando ‘apt install‘. O servidor web Apache e os pacotes PHP serão usados para executar o painel de administração web do OCS Inventory Server, e o MariaDB é usado como o backend do banco de dados.

sudo apt install apache2 libapache2-mod-perl2 libapache2-mod-perl2-dev libapache-dbi-perl libapache-db-perl libapache2-mod-php libarchive-zip-perl mariadb-server composer php-mbstring php-xml php-mysql php-zip php-pclzip php-gd php-soap php-curl php-json

Digite y quando solicitado, em seguida pressione ENTER.

Com a Pilha LAMP e o Composer instalados, insira os seguintes comandos para verificar o status do serviço Apache2 e MariaDB, em seguida, verifique a versão do PHP e do Composer.

Verifique o serviço Apache2 via o comando ‘systemctl‘ abaixo. Uma saída ‘enabled‘ confirma que o servidor web Apache2 será iniciado automaticamente na inicialização do sistema, e a saída ‘active (running)‘ confirma que o servidor web Apache2 está em execução.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Verifique o serviço MariaDB via o comando ‘systemctl‘ abaixo. Uma saída ‘enabled‘ confirma que o servidor MariaDB será iniciado automaticamente na inicialização do sistema, e a saída ‘active (running)‘ confirma que o serviço MariaDB está em execução.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Verifique a versão do PHP usando o comando abaixo. No momento da redação deste texto, o PHP 8.1 está instalado no servidor, que é fornecido pelo repositório do Ubuntu.

php -v

Verifique a versão do Composer inserindo o seguinte comando.

sudo -u www-data composer -v

Com as dependências básicas instaladas, insira o seguinte comando para instalar alguns módulos Perl que são necessários para o OCS Inventory Server.

sudo perl -MCPAN -e 'install Apache2::SOAP'  
sudo perl -MCPAN -e 'install XML::Entities'  
sudo perl -MCPAN -e 'install Net::IP'  
sudo perl -MCPAN -e 'install Apache::DBI'  
sudo perl -MCPAN -e 'install Mojolicious'  
sudo perl -MCPAN -e 'install Switch'  
sudo perl -MCPAN -e 'install Plack::Handler'

Você será solicitado a configurar o CPAN pela primeira vez. Digite ‘yes‘ para confirmar e configurar o CPAN automaticamente. A instalação dos módulos Perl deve agora começar.

Quando a instalação dos módulos Perl terminar, isso confirma que as dependências de pacotes para o OCS Inventory Server estão agora instaladas. Na próxima etapa, você configurará o servidor MariaDB e o PHP.

Configurando o Servidor MariaDB

Nesta seção, você configurará e protegerá a implantação do servidor MariaDB via o comando ‘mariadb-secure-installation‘. Em seguida, você criará um novo banco de dados e usuário que serão usados pelo OCS Inventory Server.

Insira o seguinte comando para começar a configurar e proteger a implantação do servidor MariaDB.

sudo mariadb-secure-installation

Você será questionado sobre as seguintes configurações do MariaDB:

• Mudar a autenticação local para unix_socket? Digite n.
• Configurar a nova senha root do MariaDB? Digite y para confirmar, em seguida, digite a nova senha para a implantação do seu servidor MariaDB.
• Remover usuário anônimo? Digite y para confirmar.
• Remover o banco de dados padrão de teste da implantação? Digite y para confirmar.
• Proibir login root do MariaDB a partir de conexões remotas? Digite y para confirmar.
• Recarregar privilégios de tabela e aplicar as alterações? Digite y e pressione ENTER.

Com isso, você agora protegeu a implantação do servidor MariaDB e configurou a senha para o usuário root do MariaDB.

Agora faça login no shell do MariaDB usando o comando abaixo. Você estará criando um novo banco de dados MariaDB e usuário para a aplicação OCS Inventory Server.

sudo mariadb -u root -p

Insira as seguintes consultas para criar um novo banco de dados ‘ocsdb‘ e o usuário ‘ocs@localhost’. Além disso, certifique-se de alterar a senha do usuário MariaDB a seguir.

CREATE DATABASE ocsdb;  
GRANT ALL PRIVILEGES ON ocsdb.* TO ocs@localhost IDENTIFIED BY "ocsP4ssw0rd";  
FLUSH PRIVILEGES;

Por último, insira a seguinte consulta para verificar a lista de privilégios do novo usuário ‘ocs@localhost‘. Você deve ver que o usuário MariaDB ‘ocs@localhost‘ tem acesso ao banco de dados ‘ocsdb‘ que será usado pelo OCS Inventory Server.

SHOW GRANTS FOR ocs@localhost;  
QUIT;

Nesta seção, você protegeu a implantação do servidor MariaDB e configurou a senha root do MariaDB via o comando ‘mariadb-secure-installation‘. Você também criou um novo banco de dados MariaDB e usuário para a instalação do OCS Inventory Server. Na próxima etapa, você configurará uma configuração PHP que será usada para executar o ‘ocsreports‘ ou painel de administração do OCS.

Configurando o PHP

Após configurar o servidor MariaDB, você agora configurará a instalação do PHP que será usada pelo ocsreports ou Servidor de Administração OCS. Você precisará alterar alguns parâmetros no arquivo ‘php.ini‘ e reiniciar o serviço Apache2 para aplicar as alterações que você fez.

Abra o arquivo de configuração do PHP ‘/etc/php/8.1/apache2/php.ini‘ usando o seguinte comando do editor nano.

sudo nano /etc/php/8.1/apache2/php.ini

Altere os parâmetros padrão com as seguintes linhas. Certifique-se de ajustar o parâmetro ‘date.timezone‘ com seu fuso horário.

memory_limit = 512M  
post_max_size = 100M  
upload_max_filesize = 100M  
max_execution_time = 360  
date.timezone = Europe/Stockholm

Salve e feche o arquivo quando terminar.

Agora insira o seguinte comando do systemctl para reiniciar o serviço Apache2 e aplicar as alterações.

sudo systemctl restart apache2

Com isso, a configuração básica da Pilha LAMP para o OCS Inventory Server está finalizada. Na próxima etapa, você configurará o firewall UFW e abrirá algumas portas ou serviços.

Configurando o Firewall UFW

No servidor Ubuntu, o ufw é o firewall padrão que está instalado. Ele está instalado, mas ainda não está em execução no sistema. Nesta seção, você adicionará os serviços OpenSSH e ‘Apache Full‘ ao ufw. Em seguida, você iniciará o ufw em seu servidor e habilitará para ser executado automaticamente na inicialização do sistema.

Insira o seguinte comando ‘ufw allow‘ para abrir os aplicativos OpenSSH e ‘Apache Full‘. O aplicativo OpenSSH abrirá a porta SSH padrão 22/tcp e o serviço ‘Apache Full’ abrirá as portas padrão HTTP e HTTPS - 80/tcp e 443/tcp.

sudo ufw allow OpenSSH  
sudo ufw allow 'Apache Full'

Agora execute o seguinte comando para iniciar e habilitar o firewall UFW. Quando solicitado, digite y para confirmar e pressione ENTER para prosseguir.

sudo ufw enable

Uma saída ‘Firewall is active and enabled on system startup‘ confirma que o UFW está habilitado e será executado automaticamente na inicialização do sistema. E o UFW deve estar em execução após o comando ser executado.

Insira o seguinte comando para verificar o status do firewall UFW. Uma saída ‘Status: Active‘ confirma que o UFW está em execução, você também verá ambos os aplicativos ‘OpenSSH‘ e ‘Apache Full‘ adicionados e disponíveis no firewall UFW.

sudo ufw status

Neste ponto, você agora terminou a instalação e as configurações básicas das dependências de pacotes para a instalação do OCS Inventory Server. Vá para a próxima seção para iniciar a instalação do OCS Inventory Server.

Instalando o OCS Inventory Server

O OCS Inventory Server pode ser instalado em diferentes sistemas operacionais, como Linux, Unix e Windows. Está disponível em diferentes pacotes e fornece repositórios oficiais para diferentes distribuições Linux, incluindo Ubuntu, Debian e CentOS.

Para este exemplo, você instalará o OCS Inventory Server manualmente a partir do código-fonte e o configurará com o servidor de banco de dados MariaDB. Você também instalará o ocsreports que será usado como a aplicação gráfica e fornece um painel de administração web para a aplicação OCS Inventory Server.

Mova seu diretório de trabalho para ‘/var/www‘ e baixe o código-fonte do OCS Inventory Server via o comando ‘git clone‘ abaixo. O código-fonte deve estar disponível no diretório ‘OCSInventory-Server‘.

cd /var/www/  
git clone https://github.com/OCSInventory-NG/OCSInventory-Server.git

Mova para o diretório ‘OCSInventory-Server’ e baixe a aplicação ‘ocsreports‘ via o comando ‘git clone‘ abaixo. O ‘ocsreports‘ é uma aplicação web PHP que será usada como o console web ou painel de administração web do OCS Inventory Server, e isso será armazenado no diretório ‘ocsreports‘.

cd OCSInventory-Server/  
git clone https://github.com/OCSInventory-NG/OCSInventory-ocsreports.git ocsreports

Mova para o diretório ‘ocsreports‘ e execute o comando ‘composer install‘ para instalar as dependências PHP para a aplicação web ocsreports.

cd ocsreports/  
sudo -u www-data composer install

Em seguida, vá para o diretório raiz da instalação do OCS Inventory Server ‘/var/www/OCSInventory-Server/‘ e abra o script bash ‘setup.sh‘ usando o seguinte comando do editor nano. O script ‘setup.sh‘ será usado para instalar o OCS Inventory Server.

cd /var/www/OCSInventory-Server/  
nano setup.sh

Altere os parâmetros do banco de dados com os detalhes do seu banco de dados, que incluem o nome do banco de dados, nome de usuário e senha.

DB_SERVER_HOST="localhost"  
DB_SERVER_PORT="3306"  
DB_SERVER_USER="ocs"  
DB_SERVER_PWD="ocsP4ssw0rd"

Salve e feche o arquivo quando terminar.

Agora execute o script ‘setup.sh‘ para iniciar a instalação do OCS Inventory Server. Durante a instalação, você será solicitado a algumas configurações do servidor OCS.

./setup.sh

Primeiro, o script ‘setup.sh‘ verificará e confirmará as dependências para a instalação do OCS Inventory Server. Se a configuração do servidor atender aos requisitos do servidor OCS, você deve receber a mensagem de boas-vindas do script de instalação.

Digite y para continuar.

Agora o script de instalação verificará os detalhes do banco de dados que serão usados pelo OCS Inventory Server. Pressione ENTER para usar o valor padrão para o host e porta do banco de dados.

Em seguida, você será questionado sobre as configurações do servidor web Apache2. Isso inclui a localização do arquivo binário ‘apachectl‘, a configuração padrão do Apache ‘apache.conf‘, o usuário e grupo padrão que executam o serviço Apache2 e o caminho padrão que é usado pelo Apache2 para armazenar arquivos de configuração adicionais.

Pressione ENTER para usar as configurações padrão para o servidor web Apache2.

Agora você será questionado sobre o arquivo binário do ‘perl‘. Deixe como padrão e pressione ENTER para continuar.

Quando solicitado a configurar o ‘servidor de comunicação‘ na máquina atual, digite y para confirmar. Agora o script de instalação verificará algumas dependências para instalar o ‘servidor de comunicação‘.

Além disso, você será questionado sobre algumas configurações que serão usadas pelo ‘servidor de comunicação‘. Pressione ENTER para usar as configurações padrão.

Em seguida, o script de instalação ‘setup.sh‘ garantirá que os módulos Perl necessários estejam disponíveis em seu sistema. Uma saída ‘Found that PERL module … is available‘ confirma que o módulo está disponível.

Então, você será solicitado a configurar a API REST do OCS Inventory Server. Digite y para confirmar e pressione ENTER para as demais configurações.

Com isso, a instalação do ‘servidor de comunicação‘ ou OCS Inventory Server começará. Abaixo estão algumas capturas de tela da instalação do OCS Inventory Server.

Instalação e configuração dos módulos Perl do ‘servidor de comunicação‘.

Configurando diretórios de configuração para o ‘servidor de comunicação‘.

A instalação do ‘servidor de comunicação‘ está finalizada. Além disso, quando solicitado a renomear o arquivo de configuração padrão do Apache2 para o OCS Inventory Server, digite y para confirmar e pressione ENTER para prosseguir.

Em seguida, você será solicitado a configurar e instalar o painel de administração web ‘ocsreports’. Digite y para confirmar.

Então, o instalador será questionado sobre a fonte do ‘ocsreports‘, que foi baixada e as dependências PHP foram instaladas via Composer. Digite y novamente para confirmar a instalação e pressione ENTER para as demais configurações para usar as configurações padrão.

A instalação do ocsreports agora começará.

Uma vez finalizado, você deve receber uma mensagem como ‘OK, instalação do servidor de administração finalizada‘ impressa em seu terminal.

Com isso, a instalação do ‘servidor de comunicação‘ ou OCS Inventory Server e do ‘servidor de administração‘ ou ocsreports está finalizada.

Neste ponto, a instalação e configuração básica do OCS Inventory Server estão finalizadas, além de alguns arquivos e diretórios de configuração padrão serem gerados. Na próxima etapa, você ativará os arquivos de configuração adicionais do Apache2 que são usados pelo OCS Inventory Server e o ocsreports.

Aplicando Configurações do Apache2 para o OCS Inventory Server

Após instalar o OCS Inventory Server e o ocsreports, você agora aplicará as configurações do Apache2 geradas para a instalação do OCS. As configurações adicionais do Apache2 geradas pelo script ‘setup.sh‘ do OCS para o diretório ‘/etc/apache2/conf-available/‘.

Agora você ativará os arquivos de configuração do Apache2 que serão usados para o OCS Inventory Server criando um symlink do arquivo de configuração para o diretório de destino ‘/etc/apache2/conf-enabled/‘.

Insira o seguinte comando para habilitar os arquivos de configuração do Apache2 para o OCS Inventory Server.

O arquivo ‘ocsinventory-reports.conf‘ é usado para executar a aplicação web ocsreports, o arquivo ‘z-ocsinventory-server.conf‘ é usado pelo OCS Inventory Server, e o arquivo ‘zz-ocsinventory-restapi.conf‘ é usado pela API REST do OCS Server.

sudo ln -s /etc/apache2/conf-available/ocsinventory-reports.conf /etc/apache2/conf-enabled/ocsinventory-reports.conf  
sudo ln -s /etc/apache2/conf-available/z-ocsinventory-server.conf /etc/apache2/conf-enabled/z-ocsinventory-server.conf  
sudo ln -s /etc/apache2/conf-available/zz-ocsinventory-restapi.conf /etc/apache2/conf-enabled/zz-ocsinventory-restapi.conf

Agora insira o seguinte comando para garantir que o usuário e grupo ‘www-data‘ possam escrever no diretório de dados do ocsreports ‘/var/lib/ocsinventory-reports‘. Em seguida, verifique as configurações do Apache2 via o comando ‘apachectl‘ abaixo.

sudo chown -R www-data:www-data /var/lib/ocsinventory-reports  
sudo apachectl configtest

Uma saída ‘Syntax OK‘ confirma que você possui arquivos de configuração do Apache2 corretos e adequados.

Insira o seguinte comando do systemctl para reiniciar o serviço Apache2 e aplicar as alterações. Com isso, o OCS Inventory Server deve agora ser acessível via o endereço IP do servidor.

sudo systemctl restart apache2

Instalando OCS Inventory Server e OCS Reports

Abra seu navegador web e visite o endereço IP do servidor seguido do caminho do painel de administração web ‘ocsreports‘ (ou seja: http://192.168.5.20/ocsreports/install.php).

Insira os detalhes do banco de dados para a sua instalação do OCS Inventory Server e clique em ‘Enviar‘ para confirmar.

Uma vez que a instalação esteja finalizada, você deve receber uma página como esta - Na parte inferior da página, você deve receber uma mensagem como ‘Instalação finalizada..‘. Você também receberá o link para o painel de administração web ocsreports.

Clique no link para acessar a página de login do ocsreports.

Na página de login do OCS, insira o usuário e senha de administração padrão ‘admin‘. Em seguida, clique em ‘Enviar‘ para continuar.

Quando bem-sucedido, você deve obter o painel de administração do ocsreports, que é o gerenciamento gráfico para o OCS Inventory Server.

Na parte superior do painel do ocsreports, você deve ver a mensagem ‘ALERTA DE SEGURANÇA‘. Isso instrui você a remover o script de instalação ‘/ usr/share/ocsinventory-reports/ocsreports/install.php‘ e alterar o usuário e senha de admin padrão.

Volte para o terminal do OCS Inventory Server e execute o comando abaixo para remover o script de instalação ‘install.php‘.

rm -f /usr/share/ocsinventory-reports/ocsreports/install.php

Em seguida, volte para o painel do ocsreports e clique no menu de configurações no canto superior direito, depois selecione o menu ‘Minha conta‘.

Altere o usuário, e-mail e senha de admin padrão. Em seguida, clique em ‘OK‘ para confirmar.

Com o script de instalação ‘install.php‘ removido e o usuário e senha de admin padrão alterados, a mensagem ‘ALERTA DE SEGURANÇA‘ desaparecerá do painel de administração web do ocsreports.

Conclusão

Neste guia, você instalou e configurou o OCS Inventory Server em um servidor Ubuntu 22.04. Você instalou manualmente o OCS Inventory Server a partir do código-fonte e configurou a Pilha LAMP (Apache2, MariaDB e PHP) usada para executar o OCS Inventory Server e a aplicação web ocsreports.

Além disso, você também instalou o ocsreports como o console web e painel de administração para o OCS Inventory Server. Você terminou de instalar a aplicação web ocsreports com a Pilha LAMP.

Com isso em mente, você agora pode facilmente gerenciar seus dispositivos via OCS Agent, que pode ser instalado em vários sistemas operacionais, como distribuições Linux, Windows, macOS e BSDs. Você também pode proteger seu OCS Inventory Server implementando o HTTPS seguro no servidor web Apache. Para saber mais, visite a documentação oficial do OCS Inventory Server.