2.1. Sistema operacional
Nesse documento, o OCS-NG será instalado no
Debian 8 (Jessie) amd64. O Debian foi escolhido devido à sua estabilidade e também a constante atualização do sistema operacional, claro que a facilidade de suporte e de utilização do sistema também foram pontos extremamente relevantes para sua escolha como base para esse projeto. O Debian tem um excelente desempenho, mesmo com inúmeras adversidades e funciona extremamente bem em qualquer circunstância.
A instalação do sistema operacional, nesse caso, não contou com nenhum passo fora do comum, a mesma não será abordada com profundidade, visto que não é o foco deste documento. Foram criadas 3 partições Home, SWAP e / (Partição raiz do sistema operacional, equivalente ao disco C do Windows), durante a instalação foi utilizado um espelho de rede para configurar o APT e também para manter o sistema atualizado desde a instalação, o espelho utilizado foi "ftp.br.debian.org".
Foi finalizada a instalação utilizando somente as opções standard do sistema operacional, sem nenhum pacote adicional até o momento. Todas as instalações necessárias serão feitas no momento em que as mesmas forem solicitadas, lembrando que esse servidor está sendo montado, única e exclusivamente, para o uso do OCS-NG, ou seja, inventário será a única função desse servidor. Não é uma exigência, o servidor pode ter mais de uma função.
2.2. OCS - NG
2.2.1 - Preparação:
Antes de iniciar os procedimentos de instalação, é necessário que alguns ajustes sejam feitos no servidor (considerando um servidor que acabou de ser instalado).
Setar IP fixo no servidor, para que o Agente sempre saiba com quem se comunicar, o procedimento será realizado da seguinte forma.
Edite o arquivo interfaces:
# nano /etc/network/interfaces
E substitua:
#The primary network interface
allow-hotplug eth0
iface eth0 inet dhcp
Por:
auto eth0
iface eth0 inet static
address 192.168.XXX.XXX
netmask 255.255.XXX.XXX
gateway 192.168.XXX.XXX
Claramente, colocando informações reais da sua rede local.
Alterar o arquivo "sources.list" para ignorar o CD de instalação na busca por pacotes, basta editar o arquivo com o comando:
# nano /etc/apt/sources.list
E comentar, utilizando o carácter
# no inicio das linhas que comecem com "deb cdrom".
Preparações finalizadas, vamos prosseguir com a instalação.
2.2.2 - Instalação:
A instalação do OCS-NG pode ser feita utilizando seu código fonte, junto com a documentação oficial do produto, disponível em:
Nesse documento, faremos o download do código fonte e compilaremos o mesmo. A instalação se inicia com os seguintes passos, sega os comandos:
Obs.: absolutamente, todos os comandos desse documento precisam ser executados como
root.
# apt update && apt upgrade
# apt install apt-build vim
ATENÇÃO: nesse momento, será solicitado a senha do MySQL-Server
# apt install apache2 libmysqlclient15-dev mysql-server php5 php5-gd php5-mysql php5-curl php5-imap php5-ldap
# apt install libapache-dbi-perl libnet-ip-perl libsoap-lite-perl libapache2-mod-perl2 libxml-simple-perl libcompress-zlib-perl libdbi-perl libdbd-mysql-perl
Os módulos do CPAN precisam ser instalados manualmente:
# perl -e shell -MCPAN
CPAN*>
install CPAN
CPAN*>
reload CPAN
CPAN*>
install XML::Entities
CAPN*>
exit
Reinicie o serviço do Apache, para que as configurações entrem em vigor.
# /etc/init.d/apache2 restart
Nesse momento, temos um ambiente preparado para receber o OCS-NG com servidor WEB Apache e também o servidor de banco de dados MySQL, sendo assim, podemos prosseguir para a instalação do OCS-NG propriamente dita. Será feito download, compilação e instalação do OCS-NG, passo a passo.
Pasta escolhida para download
/opt.
# cd /opt
# wget https://github.com/OCSInventory-NG/OCSInventory-ocsreports/releases/download/2.3.1/OCSNG_UNIX_SERVER-2.3.1.tar.gz
# tar -xzvf OCSNG_UNIX_SERVER-2.3.1.tar.gz
# cd /OCSNG_UNIX_SERVER-2.3.1
# chmod 777 setup.sh
# ./setup.sh
Algumas perguntas serão feitas:
- Todas devem ser mantidas com a resposta padrão, pressionando Enter.
- Exceto: Where is Apache Include configuration directory [] ?
- Deve ser substituído por: /etc/apache2/conf-enabled
Ajustando parâmetros no PHP:
# vim /etc/php5/apache2/php.ini
Parâmetros a serem alterados:
- Para encontrar as linhas mais facilmente, pressione a tecla Esc e digite o comando → :set line
- Depois, pode utilizar → :numerodalinha, para navegar diretamente a linha desejada.
- Linha 372: max_execution_time = 200
- Linha 382: max_input_time = 200
- Linha 393: memory_limit = 512M
- Linha 660: post_max_size = 300M
- Linha 820: upload_max_filesize = 300M
Ajustando parâmetros do OCS:
# vim /etc/apache2/conf-enabled/ocsinventory-reports.conf
- Linha 49: php_value post_max_size 300m
- Linha 50: php_value upload_max_filesize 300m
# /etc/init.d/apache2 restart
Criando o banco de dados
# mysql -u root -p
Será necessário entrar com a senha que foi selecionada no banco de dados no momento da instalação.
mysql>
CREATE DATABASE ocsweb character set utf8;
mysql>
CREATE USER ocs@localhost IDENTIFIED BY 'senha_ocsweb';
"senha_ocsweb" deve ser alterada por uma senha para o usuário" ocs".
mysql>
GRANT ALL PRIVILEGES ON *.* TO ocs@localhost;
mysql>
flush privileges;
mysql>
exit;
# cd /etc/apache2/conf-enabled
Pode também estar localizado em
/etc/apache2/conf.d/.
# vim z-ocsinventory-server.conf
Alterar o usuário para se conectar ao banco de dados:
- Linha 29: PerlSetEnv OCS_DB_USER ocs
- Senha do usuário
- Linha 31: PerlSetVar OCS_DB_PWD senha_ocsweb */
# cd /usr/share/ocsinventory-reports/ocsreports/
# vim dbconfig.inc.php file
/* define("DB_NAME", "ocsweb");
* define("SERVER_READ","localhost");
* define("SERVER_WRITE","localhost");
* define("COMPTE_BASE","ocs");
* define("PSWD_BASE","senha_ocsweb"); */
Realizados esses procedimentos, é necessário acessar pelo servidor o link do OCS-NG:
→ http://ipdoservidor/ocsreports
Depois de acessado, será apresentado uma tela solicitando algumas informações, que devem ser preenchidas da seguinte forma:
- Login MySQL: < ocs >
- MySQL Password: < senhaocsweb >
- MySQL Database: < ocsweb >
- Mysql Hostanme: < localhost ou o IP do servidor de banco de dados >
A instalação será feita e será apresentada a tela de login, a senha e usuário padrão é:
- Usuário: admin
- Senha: admin
No primeiro login, será exibida uma mensagem com um erro de segurança, pra resolver, será necessário entrar no terminal, via SSH ou localmente mesmo, e executar o seguinte comando:
# rm /usr/share/ocsinventory-reports/ocsreports/install.php
Realizados os procedimentos, o OCS-NG estará funcionando, será somente necessário baixar e instalar os agentes em seus clientes e começarem o inventário e armazenamento das informações, os agentes estão disponíveis para download em: