OCS Inventory – Instalação e Configuração

O OCS Inventory (Open Computers and Software Inventory) é um software livre que permite o gerenciamento de inventário de hardware e software de uma rede de computadores. Através de um software cliente (agente) multiplataforma, todas as informações do equipamento são levantadas e enviadas à uma base de dados (servidor), qual pode ser acessada através de uma interface web simples e eficiente. O servidor também possui alguns recursos bem interessantes, como o IP Discovery, que utilizando SNMP, efetua uma varredura na rede para a coleta de informações sobre dispositivos e recursos como switches, roteadores, impressoras e outros.

Um software de inventário, como o OCS, é muito importante para o gerenciamento de uma rede, já que este permite mapear todo o parque de máquinas, suas configurações de hardware e informações de software. Com estes dados em mãos é possível responder, rapidamente, dúvidas comuns como sobre a performance de computadores, informações de acesso remoto, sistemas e aplicativos sem licença ou desatualizados e outras. Além disso, com um inventário atualizado, é possível identificar o número exato de computadores e dispositivos em uso, em estoque, em manutenção e que estão dentro ou fora da garantia, evitando erros em tomadas de decisões estratégicas, como em novos investimentos.

Neste artigo, faremos a instalação do OCS Inventory no Linux Ubuntu 16.04 LTS Server utilizando o Apache 2.4.18, PHP 7.0.28, PERL 5.22.1 e MySQL 5.7.21. A instalação no Linux Debian é muito semelhante, variando apenas algumas versões de determinados pacotes. Além disso, a instalação padrão do Debian não instala o MySQL e PHP, apenas o Apache.

Informações do ambiente

Considerando que o Linux Ubuntu 16, incluindo os pacotes LAMP Server (Apache, MySQL e PHP / PERL), já esteja instalado em seu ambiente, vamos à instalação e verificação dos pacotes adicionais.

A lista completa de requisitos e de pacotes necessários para a instalação do OCS Inventory Server está no final deste post.

Para verificar as versões dos pacotes, como PHP, PERL e MySQL use:

# php --version
# mysql --version
# perl --verson

Pacotes Adicionais

Para o correto funcionamento do sistema, incluindo suas funcionalidades avançadas, como o IP Discovery, alguns pacotes adicionais devem ser instalados:

– Pacotes padrão:

apt-get install make build-essential mysql-client snmp nmap

– PERL Módulos:

O OCS Web Communication requer, além do Apache, o PERL e alguns dos seus módulos adicionais:

apt-get install libxml-simple-perl
apt-get install libio-compress-perl
apt-get install libdbi-perl
apt-get install libdbd-mysql-perl
apt-get install libapache-dbi-perl
apt-get install libnet-ip-perl
apt-get install libsoap-lite-perl
apt-get install libarchive-zip-perl

cpan -i XML::Entities
cpan -i Compress::Zlib
cpan -i Apache::SOAP
cpan -i Apache2::SOAP

– PHP Módulos:

O OCS Web Administration Console requer, além do Apache, o PHP e alguns dos seus módulos adicionais:

apt-get install libphp-pclzip
apt-get install php-gd 
apt-get install php-curl php-xml php-soap php-mysql php-zip
apt-get install php-mbstring
apt-get install php-net-ldap (opcional) 

*A instalação destes pacotes podem variar conforme a versão do php, como: php5-gd ou php5-curl.

 

OCS Inventory Server Install

Baixe o OCS em seu site oficial, como através deste link da versão 2.4.

 wget https://github.com/OCSInventory-NG/OCSInventory-ocsreports/releases/download/2.4/OCSNG_UNIX_SERVER_2.4.tar.gz

Descompacte o arquivo baixado e acesse o diretório de instalação:

tar -xzvf OCSNG_UNIX_SERVER-2.4.tar.gz
cd OCSNG_UNIX_SERVER-2.4.tar.gz

Execute o instalador através do comando abaixo e então siga as instruções. Fique atento aos alertas exibidos pelo instalador em cada uma de suas interações.

sh setup.sh
Instalador do OCS Inventory

Em resumo, as ações padrões da instalação são:
– Continue = y
– Database server (localhost) = enter
– Database server Port (3306) = enter
– Apache daemon binary = enter
– Apache main config = enter
– User Apache web server (www-data) = enter
– Group Apache web server (www-data) = enter
– Apache include config directory = enter
– PERL interpreter = enter
– Communication server = y
– Communication server log = enter
– Communication server plugins config = enter
– Communication server plugins Perl = enter

Caso algum módulo PERL não esteja instalado o OCS Install informará, conforme abaixo:
*** Warning: PERL module Apache2::SOAP is not installed !
This module is only required by OCS Inventory NG SOAP Web Service
*** ERROR: PERL module Archive::Zip is not installed !
*** ERROR: There is one or more required PERL modules missing !
Tecle Yes para autorizar e aguarde pela instalação dos módulos faltantes (ou repita a operação caso necessário).

– Rest API server = no
– Communication server Apache config file “z-ocsinventory-server.conf” = y
– Administration Web Server = y
– Install Console on /var/lib/ocsinventory-reports = y
– Administration Server static files for PHP = enter
– Directories for packages, IPDiscovery and SNMP = enter

Feito isso, a instalação será concluída e uma mensagem de confirmação será exibida, como abaixo:


OK, Administration server installation finished.

Please, review /etc/apache2/conf-available/ocsinventory-reports.conf
to ensure all is good and restart Apache daemon. 

Then, point your browser to http://server//ocsreports
to configure database server and create/update schema.

Setup has created a log file /opt/OCSNG_UNIX_SERVER_2.4/ocs_server_setup.log. Please, save this file.
If you encounter error while running OCS Inventory NG Management server,
we can ask you to show us his content!

DON’T FORGET TO RESTART APACHE DAEMON!
Enjoy OCS Inventory NG!


 

Configuração do Apache e PHP:

Use os comandos abaixo para configurar o acesso web ao OCS Administration Web Server:

a2enconf ocsinventory-reports
a2enconf z-ocsinventory-server
chown -R www-data:www-data /var/lib/ocsinventory-reports/

/etc/init.d/apache2 restart ou service apache2 restart

Feito isso, vá para o navegador e entre com o endereço: http://ip-do-servidor/ocsreports ou http://dominio-do-servidor/ocsreports

 

Alertas do instalador

Atente-se aos alertas informados pelo sistema e corrija-os, como por exemplo:


WARNING: You will not be able to build any deployment package with size greater than 100MB
You must raise both post_max_size and upload_max_filesize in your vhost configuration to encrease this limit.

WARNING: If you change default database name (ocsweb) or user (ocs), don’t forget to update the file ‘z-ocsinventory-server.conf’ in your Apache configuration directory

ERROR: You need to install the following packages: php-curl


No exemplo acima, o sistema alerta sobre alguns parâmetros do PHP (php.ini), sobre o usuário e senha do banco de dados do OCS (ocsweb) e também que um pacote essencial está faltando (php-curl).

Para os pacotes essenciais ausentes, volte aos passos anteriores e proceda com a instalação.

Para a alterar a senha de acesso do usuário (ocs) do banco de dados (ocsweb), entre com os comandos abaixo:

mysql -u root -p
*Entre com a senha do usuário root do MySQL
UPDATE mysql.user SET Password=PASSWORD('new-passwd-here') WHERE User='ocs' AND host='localhost';
*Entre com o comando acima, substituindo o "new-passwd-here" pela senha desejada.

Feito isso, edite os arquivos e /usr/share/ocsinventory-reports/ocsreports/dbconfig.inc.php e /etc/apache2/conf-available/z-ocsinventory-server.conf, alterando o parâmetro passwd, qual contém a senha de acesso do usuário ocs ao banco de dados ocsweb.

Já para os alertas do PHP, edite o php.ini, conforme abaixo.

# vim /etc/php/7.0/apache2/php.ini

Parâmetros recomendados:
post_max_size = 512MB
upload_max_filesize = 512MB

Feito as atualizações no php.ini, reinicie o Apache:

# /etc/init.d/apache2 restart

Corrigido todos os alertas, insira as credenciais administrativas de acesso ao MySQL:

MySQL Login = root
MySQL Passwd = senha do user root
Database = ocsweb
MySQL Host = localhost ou IP do Servidor do MySQL

Feito isso, clique em Save e aguarde.

A instalação criará um banco de dados chamado ocsweb e um usuário chamado ocs (user: ocs / senha: ocs) com acesso exclusivo a este banco de dados.

Mensagem final da configuração web:

Installation finished you can log in index.php with:
login=admin
password=admin

Faça login no sistema usando as credenciais padrões (acima): http://ip-do-servidor/ocsreports

Note as mensagens de alerta de segurança no topo do sistema como sobre o arquivo install.php existente no diretório de instalação do sistema. Use o comando abaixo para removê-lo:

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

 

Fim da instalação e da configuração!

Agora você já pode executar o OCS Agent nos computadores da rede para cadastrá-los no inventário. A instalação do agente é bem intuitiva. A única configuração personalizada é o endereço do servidor, que deve ser: http://ip-do-servidor/ocsinventory, conforme imagem abaixo:

Instalação do OCS Agent em um computador com Windows

 


Diretórios e arquivos de configuração do OCS:

/etc/ocsinventory-server – PERL e Plugins
/etc/apache2/conf-available/z-ocsinventory-server.conf – Configs PERL / MySQL
/etc/apache2/conf-available/ocsinventory-reports.conf – Configs do OCS Server / PHP
/etc/apache2/conf.d/z-ocsinventory-server.conf  – Configs PERL / MySQL (Debian)
/usr/share/ocsinventory-reports – Arquivos do OCS Reports Web
/usr/share/ocsinventory-reports/ocsreports/dbconfig.inc.php – MySQL Config
/var/lib/ocsinventory-reports – Arquivos gerais
/opt/OCSNG_UNIX_SERVER-2.X.Y/ocs_server_setup.log – Logs da instalação
MySQL Config:
Debian – /etc/mysql/my.conf
Ubuntu – /etc/mysql/mysql.conf.d/mysqld.cnf
*Para importar bases de tamanhos grandes, altere o parâmetro:
max_allowed_packet = 16M para max_allowed_packet = 1024M, ou conforme sua necessidade.

Requisitos do OCS Inventory:
Apache version 1.3.33 or higher / Apache version 2.0.46 or higher.
Mod_perl version 1.29 or higher.
Mod_php version 4.3.2 or higher.
PHP 4.3.2 or higher, with ZIP and GD support enabled.
PERL 5.6 or higher.
Perl module XML::Simple version 2.12 or higher.
Perl module Compress::Zlib version 1.33 or higher.
Perl module DBI version 1.40 or higher.
Perl module DBD::Mysql version 2.9004 or higher.
Perl module Apache::DBI version 0.93 or higher.
Perl module Net::IP version 1.21 or higher.
Perl module SOAP::Lite version 0.66 or higher (optional)
MySQL version 4.1.0 or higher with InnoDB engine active.
Make utility such as GNU make.

Pacotes necessários:
– Mod_Perl
– Make
– GCC
– mysql-server
– apache2
– php
– php-mysql
– php-gd
– php-xml
– php-mbstring
– php-curl
– libxml-simple-perl
– libdbi-perl
– libdbd-mysql-perl
– libapache-dbi-perl
– libnet-ip-perl
– php-pclzip
– libarchive-zip-perl (providing Archive::Zip)
– libsoap-lite-perl (providing SOAP::Lite, plugin engine need it)
– libxml-simple-perl (providing XML:Entities)
– libnet-ip-perl (providing NET::IP)
– libapache-dbi-perl (providing Apache::DBI)


*Com informações de: OCS Inventory – Documentação Oficial, OCS Inventory – Site Oficial, OCS Forum – OCS 2.4 no Ubuntu 16, OCS Forum – OCS no Ubuntu 16.04 Server.

Leave a Reply

Your email address will not be published. Required fields are marked *

Time limit is exhausted. Please reload the CAPTCHA.