Cómo instalar OCS Inventory Server en Ubuntu 22.04

OCS Inventory Server es un software de código abierto que te permite escanear e inventariar todos los dispositivos en tu entorno o departamentos de TI. Es una solución gratuita de gestión de inventarios y activos que te ayuda a mantener un seguimiento de toda la información de tus dispositivos y computadoras.

Hay 4 componentes principales del OCS Inventory Server: el servidor de base de datos, el servidor de comunicación, el servidor de administración y el servidor de implementación. El OCS Inventory Server te permite obtener los datos más recientes y relevantes sobre tus dispositivos. Puede ser instalado en múltiples sistemas operativos y proporciona paquetes de agente para múltiples sistemas operativos como Microsoft Windows, Linux, BSD, Sun Solaris, IBM AIX, HP-UX, MacOS X y Android.

En cuanto a los dispositivos de red, OCS Inventory soporta el descubrimiento de red y agentes SNMP. Puedes agregar e insertar información sobre tu hardware de red: impresoras, switches, computadoras (que no tienen un agente OCS instalado), etc., a través del descubrimiento de red y agentes SNMP.

En esta guía, instalarás OCS Inventory Server en un servidor Ubuntu 22.04. Instalarás OCS Inventory Server con el servidor web Apache2, el servidor de base de datos MariaDB y PHP. Esto también incluye la instalación de ocsreports, que es una aplicación basada en PHP que proporciona un panel de administración web para el OCS Inventory Server y se ejecutará con Apache2 y PHP.

Requisitos previos

Para completar esta guía, debes tener los siguientes requisitos:

• Un servidor Linux que ejecute Ubuntu 22.04 - Este ejemplo utiliza un servidor Ubuntu genérico y nuevo con el nombre de host ‘ocs-server‘ y la dirección IP ‘192.168.5.20‘.
• Un usuario no root con privilegios de administrador sudo/root.

Cuando esos requisitos estén listos, continúa y comienza la instalación del OCS Inventory Server.

Instalando Dependencias

En esta primera sección, debes instalar algunas dependencias que se utilizarán para instalar y ejecutar OCS Inventory Server. Esta instalación incluirá los siguientes paquetes:

• Dependencias básicas - Estos paquetes se utilizarán para compilar algunos módulos de Perl.
• Perl y algunos paquetes adicionales de Perl - OCS Inventory Server está escrito en Perl, por lo que debes instalar Perl en tu servidor. Algunos paquetes adicionales de Perl aquí incluyen el controlador de base de datos Perl y el paquete SOAP de Perl para la API REST.
• LAMP Stack - El OCS Inventory Server se ejecutará con Apache2 y la base de datos MariaDB. Los paquetes de PHP se utilizarán por el ‘ocsreports‘, que es el panel de aplicación web del OCS Inventory Server.
• Módulos adicionales de Perl - Instalarás algunos módulos de Perl a través de CPAN (The Comprehensive Perl Archive Network).

Antes de comenzar, ingresa el siguiente comando para actualizar y refrescar tu índice de paquetes de Ubuntu.

sudo apt update

Ingresa el siguiente comando ‘apt install‘ para instalar algunas dependencias de desarrollo básicas. Estos paquetes se utilizan principalmente para compilar algunos módulos de Perl.

sudo apt install git curl wget make cmake gcc make

Cuando se te pida, ingresa y para confirmar y presiona ENTER para continuar.

Ahora instala Perl y algunos paquetes de Perl a través del comando ‘apt install‘ a continuación. OCS Inventory Server está principalmente escrito en Perl, por lo que debes instalar los paquetes de Perl antes de instalar el 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

Ingresa y cuando se te pida y presiona ENTER para continuar.

A continuación, instala el LAMP Stack con algunos paquetes adicionales como ‘libapache2-mod-perl2‘ y ‘composer‘ a través del siguiente comando ‘apt install‘. El servidor web Apache y los paquetes de PHP se utilizarán para ejecutar el panel de administración web para OCS Inventory Server, y MariaDB se utiliza como backend de base de datos.

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

Ingresa y cuando se te pida, luego presiona ENTER.

Con el LAMP Stack y Composer instalados, ingresa los siguientes comandos para verificar el estado del servicio Apache2 y MariaDB, luego verifica la versión de PHP y Composer.

Verifica el servicio Apache2 a través del comando ‘systemctl‘ a continuación. Una salida ‘enabled‘ confirma que el servidor web Apache2 se iniciará automáticamente al arrancar el sistema, y la salida ‘active (running)‘ confirma que el servidor web Apache2 está en funcionamiento.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Verifica el servicio MariaDB a través del comando ‘systemctl‘ a continuación. Una salida ‘enabled‘ confirma que el servidor MariaDB se iniciará automáticamente al arrancar el sistema, y la salida ‘active (running)‘ confirma que el servicio MariaDB está en funcionamiento.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Verifica la versión de PHP usando el siguiente comando. En el momento de escribir esto, PHP 8.1 está instalado en el servidor, que es proporcionado por el repositorio de Ubuntu.

php -v

Verifica la versión de Composer ingresando el siguiente comando.

sudo -u www-data composer -v

Con las dependencias básicas instaladas, ingresa el siguiente comando para instalar algunos módulos de Perl que son necesarios para 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'

Se te pedirá que configures CPAN por primera vez. Ingresa ‘yes‘ para confirmar y configurar CPAN automáticamente. La instalación de los módulos de Perl debería comenzar ahora.

Cuando la instalación de los módulos de Perl haya terminado, esto confirma que las dependencias de paquetes para OCS Inventory Server están ahora instaladas. En el siguiente paso, configurarás el servidor MariaDB y PHP.

Configurando el Servidor MariaDB

En esta sección, configurarás y asegurarás la implementación del servidor MariaDB a través del comando ‘mariadb-secure-installation‘. Luego, crearás una nueva base de datos y un usuario que serán utilizados por el OCS Inventory Server.

Ingresa el siguiente comando para comenzar a configurar y asegurar la implementación del servidor MariaDB.

sudo mariadb-secure-installation

Se te preguntará sobre las siguientes configuraciones de MariaDB:

• ¿Cambiar la autenticación local a unix_socket? Ingresa n.
• ¿Configurar la nueva contraseña de root de MariaDB? Ingresa y para confirmar, luego escribe la nueva contraseña para tu implementación del servidor MariaDB.
• ¿Eliminar el usuario anónimo? Ingresa y para confirmar.
• ¿Eliminar la base de datos de prueba predeterminada de la implementación? Ingresa y para confirmar.
• ¿Deshabilitar el inicio de sesión de root de MariaDB desde conexiones remotas? Ingresa y para confirmar.
• ¿Recargar los privilegios de la tabla y aplicar los cambios? Ingresa y y presiona ENTER.

Con esto, ahora has asegurado la implementación del servidor MariaDB y configurado la contraseña para el usuario root de MariaDB.

Ahora inicia sesión en el shell de MariaDB usando el siguiente comando. Estarás creando una nueva base de datos de MariaDB y un usuario para la aplicación OCS Inventory Server.

sudo mariadb -u root -p

Ingresa las siguientes consultas para crear una nueva base de datos ‘ocsdb‘ y el usuario ‘ocs@localhost’. Además, asegúrate de cambiar la siguiente contraseña del usuario de MariaDB.

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

Por último, ingresa la siguiente consulta para verificar la lista de privilegios del nuevo usuario ‘ocs@localhost‘. Deberías ver que el usuario de MariaDB ‘ocs@localhost‘ tiene acceso a la base de datos ‘ocsdb‘ que será utilizada por OCS Inventory Server.

SHOW GRANTS FOR ocs@localhost;  
QUIT;

En esta sección, has asegurado la implementación del servidor MariaDB y configurado la contraseña de root de MariaDB a través del comando ‘mariadb-secure-installation‘. También has creado una nueva base de datos de MariaDB y un usuario para la instalación de OCS Inventory Server. En el siguiente paso, configurarás una configuración de PHP que será utilizada para ejecutar el ‘ocsreports‘ o el panel de administración de OCS.

Configurando PHP

Después de configurar el servidor MariaDB, ahora configurarás la instalación de PHP que será utilizada por ocsreports o el Servidor de Administración OCS. Necesitarás cambiar algunos parámetros en el archivo ‘php.ini‘ y reiniciar el servicio Apache2 para aplicar los cambios que has realizado.

Abre el archivo de configuración de PHP ‘/etc/php/8.1/apache2/php.ini‘ usando el siguiente comando del editor nano.

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

Cambia los parámetros predeterminados con las siguientes líneas. Asegúrate de ajustar el parámetro ‘date.timezone‘ con tu zona horaria.

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

Guarda y cierra el archivo cuando termines.

Ahora ingresa el siguiente comando de systemctl para reiniciar el servicio Apache2 y aplicar los cambios.

sudo systemctl restart apache2

Con esto, la configuración básica del LAMP Stack para el OCS Inventory Server está terminada. En el siguiente paso, configurarás el firewall UFW y abrirás algunos puertos o servicios.

Configurando el Firewall UFW

En el servidor Ubuntu, ufw es el firewall predeterminado que está instalado. Está instalado, pero aún no se está ejecutando en el sistema. En esta sección, agregarás los servicios OpenSSH y ‘Apache Full‘ al ufw. Luego, iniciarás ufw en tu servidor y lo habilitarás para que se ejecute automáticamente al arrancar el sistema.

Ingresa el siguiente comando ‘ufw allow‘ para abrir las aplicaciones OpenSSH y ‘Apache Full‘. La aplicación OpenSSH abrirá el puerto SSH predeterminado 22/tcp y el servicio ‘Apache Full’ abrirá los puertos HTTP y HTTPS predeterminados - 80/tcp y 443/tcp.

sudo ufw allow OpenSSH  
sudo ufw allow 'Apache Full'

Ahora ejecuta el siguiente comando para iniciar y habilitar el firewall UFW. Cuando se te pida, ingresa y para confirmar y presiona ENTER para continuar.

sudo ufw enable

Una salida ‘Firewall is active and enabled on system startup‘ confirma que el UFW está habilitado y se ejecutará automáticamente al arrancar el sistema. Y el UFW debería estar en funcionamiento después de que se ejecute el comando.

Ingresa el siguiente comando para verificar el estado del firewall UFW. Una salida ‘Status: Active‘ confirma que el UFW está en funcionamiento, también verás que ambas aplicaciones ‘OpenSSH‘ y ‘Apache Full‘ han sido agregadas y están disponibles en el firewall UFW.

sudo ufw status

En este punto, has terminado la instalación y las configuraciones básicas de las dependencias de paquetes para la instalación de OCS Inventory Server. Pasa a la siguiente sección para comenzar la instalación de OCS Inventory Server.

Instalando OCS Inventory Server

OCS Inventory Server puede ser instalado en diferentes sistemas operativos como Linux, Unix y Windows. Está disponible en diferentes paquetes y proporciona repositorios oficiales para diferentes distribuciones de Linux, incluyendo Ubuntu, Debian y CentOS.

Para este ejemplo, instalarás OCS Inventory Server manualmente desde la fuente y lo configurarás con el servidor de base de datos MariaDB. También instalarás los ocsreports que se utilizarán como la aplicación gráfica y proporcionan un panel de administración web para la aplicación OCS Inventory Server.

Mueve tu directorio de trabajo a ‘/var/www‘ y descarga el código fuente de OCS Inventory Server a través del comando ‘git clone‘ a continuación. El código fuente debería estar disponible en el directorio ‘OCSInventory-Server‘.

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

Mueve al directorio ‘OCSInventory-Server’ y descarga la aplicación ‘ocsreports‘ a través del comando ‘git clone‘ a continuación. El ‘ocsreports‘ es una aplicación web PHP que se utilizará como la consola web o el panel de administración web del OCS Inventory Server, y esto se almacenará en el directorio ‘ocsreports‘.

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

Mueve al directorio ‘ocsreports‘ y ejecuta el comando ‘composer install‘ para instalar las dependencias de PHP para la aplicación web ocsreports.

cd ocsreports/  
sudo -u www-data composer install

A continuación, ve al directorio raíz de instalación de OCS Inventory Server ‘/var/www/OCSInventory-Server/‘ y abre el script bash ‘setup.sh‘ usando el siguiente comando del editor nano. El script ‘setup.sh‘ se utilizará para instalar el OCS Inventory Server.

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

Cambia los parámetros de la base de datos con los detalles de tu base de datos que incluyen el nombre de la base de datos, el nombre de usuario y la contraseña.

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

Guarda y cierra el archivo cuando termines.

Ahora ejecuta el script ‘setup.sh‘ para comenzar la instalación de OCS Inventory Server. Durante la instalación, se te pedirá algunas configuraciones del servidor OCS.

./setup.sh

Primero, el script ‘setup.sh‘ verificará y comprobará las dependencias para la instalación del OCS Inventory Server. Si la configuración del servidor cumple con los requisitos del servidor OCS, deberías recibir el mensaje de bienvenida del script instalador.

Ingresa y para continuar.

Ahora el script instalador verificará los detalles de la base de datos que serán utilizados por OCS Inventory Server. Presiona ENTER para usar el valor predeterminado para el host y puerto de la base de datos.

A continuación, se te preguntará sobre las configuraciones del servidor web Apache2. Esto incluye la ubicación del archivo binario ‘apachectl‘, la configuración predeterminada de Apache ‘apache.conf’, el usuario y grupo predeterminados que ejecutan el servicio Apache2, y la ruta predeterminada que utiliza Apache2 para almacenar archivos de configuración adicionales.

Presiona ENTER para usar la configuración predeterminada para el servidor web Apache2.

Ahora se te preguntará sobre el archivo binario de ‘perl‘. Déjalo como predeterminado y presiona ENTER para continuar.

Cuando se te pregunte si deseas configurar el ‘Servidor de Comunicación‘ en la máquina actual, ingresa y para confirmar. Ahora el script instalador verificará algunas dependencias para instalar el ‘Servidor de Comunicación‘.

Además, se te preguntará sobre algunas configuraciones que serán utilizadas por el ‘Servidor de Comunicación‘. Presiona ENTER para usar la configuración predeterminada.

A continuación, el script instalador ‘setup.sh‘ se asegurará de que los módulos de Perl requeridos estén disponibles en tu sistema. Una salida ‘Found that PERL module … is available‘ confirma que el módulo está disponible.

Luego, se te preguntará si deseas configurar la API REST del OCS Inventory Server. Ingresa y para confirmar y presiona ENTER para el resto de la configuración.

Con esto, comenzará la instalación del ‘Servidor de Comunicación‘ o del OCS Inventory Server. A continuación se muestran algunas capturas de pantalla de la instalación del OCS Inventory Server.

Instalación y configuración de los módulos Perl del ‘Servidor de Comunicación‘.

Configurando directorios de configuración para el ‘Servidor de Comunicación‘.

La instalación del ‘Servidor de Comunicación‘ ha terminado. Además, cuando se te pida renombrar el archivo de configuración predeterminado de Apache2 para OCS Inventory Server, ingresa y para confirmar y presiona ENTER para continuar.

A continuación, se te preguntará si deseas configurar e instalar el panel de administración web ‘ocsreports’. Ingresa y para confirmar.

Luego, el instalador te preguntará sobre la fuente de ‘ocsreports‘, que se descargó y las dependencias de PHP se instalaron a través de Composer. Ingresa y nuevamente para confirmar la instalación y presiona ENTER para el resto de las configuraciones para usar los valores predeterminados.

La instalación de ocsreports comenzará ahora.

Una vez finalizada, deberías recibir un mensaje como ‘OK, Administration server installation finished‘ impreso en tu terminal.

Con esto, la instalación del ‘Servidor de Comunicación‘ o del OCS Inventory Server y el ‘Servidor de Administración‘ o ocsreports ha terminado.

En este punto, la instalación básica y la configuración del OCS Inventory Server están terminadas, también se generan algunos archivos y directorios de configuración predeterminados. En el siguiente paso, activarás los archivos de configuración adicionales de Apache2 que son utilizados por OCS Inventory Server y ocsreports.

Aplicando Configuraciones de Apache2 para OCS Inventory Server

Después de instalar el OCS Inventory Server y ocsreports, ahora aplicarás las configuraciones de Apache2 generadas para la instalación de OCS. Las configuraciones adicionales de Apache2 generadas por el script ‘setup.sh’ se encuentran en el directorio ‘/etc/apache2/conf-available/‘.

Ahora activarás las configuraciones de Apache2 que se utilizarán para el OCS Inventory Server creando un enlace simbólico del archivo de configuración al directorio de destino ‘/etc/apache2/conf-enabled/‘.

Ingresa el siguiente comando para habilitar los archivos de configuración de Apache2 para OCS Inventory Server.

El archivo ‘ocsinventory-reports.conf‘ se utiliza para ejecutar la aplicación web ocsreports, el archivo ‘z-ocsinventory-server.conf‘ es utilizado por el OCS Inventory Server, y el archivo ‘zz-ocsinventory-restapi.conf‘ es utilizado por la API REST del 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

Ahora ingresa el siguiente comando para asegurarte de que el usuario y grupo ‘www-data‘ puedan escribir en el directorio de datos de ocsreports ‘/var/lib/ocsinventory-reports‘. Luego, verifica las configuraciones de Apache2 a través del comando ‘apachectl‘ a continuación.

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

Una salida ‘Syntax OK‘ confirma que tienes archivos de configuración de Apache2 correctos y adecuados.

Ingresa el siguiente comando de systemctl para reiniciar el servicio Apache2 y aplicar los cambios. Con esto, el OCS Inventory Server debería ser accesible a través de la dirección IP del servidor.

sudo systemctl restart apache2

Instalando OCS Inventory Server y OCS Reports

Abre tu navegador web y visita la dirección IP del servidor seguida de la ruta del panel de administración web ‘ocsreports‘ (es decir: http://192.168.5.20/ocsreports/install.php).

Ingresa los detalles de la base de datos para tu instalación de OCS Inventory Server y haz clic en ‘Enviar‘ para confirmar.

Una vez que la instalación haya terminado, deberías recibir una página como esta - En la parte inferior de la página, deberías obtener un mensaje como ‘Installation finished..‘. También obtendrás el enlace al panel de administración web de ocsreports.

Haz clic en el enlace para acceder a la página de inicio de sesión de ocsreports.

En la página de inicio de sesión de OCS, ingresa el usuario y la contraseña de administración predeterminados ‘admin‘. Luego, haz clic en ‘Enviar‘ para continuar.

Cuando sea exitoso, deberías obtener el panel de administración de ocsreports, que es la gestión gráfica para OCS Inventory Server.

En la parte superior del panel de ocsreports, deberías ver el mensaje ‘SECURITY ALERT‘. Esto te indica que elimines el script de instalación ‘/ usr/share/ocsinventory-reports/ocsreports/install.php‘ y cambies el usuario y la contraseña de administrador predeterminados.

Regresa a la terminal del OCS Inventory Server y ejecuta el siguiente comando para eliminar el script de instalación ‘install.php‘.

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

A continuación, regresa al panel de ocsreports y haz clic en el menú de configuración en la parte superior derecha, luego selecciona el menú ‘Mi cuenta‘.

Cambia el usuario de administrador predeterminado, el correo electrónico y la contraseña. Luego haz clic en ‘OK‘ para confirmar.

Con el script de instalación ‘install.php‘ eliminado y el usuario y la contraseña de administrador predeterminados cambiados, el mensaje ‘SECURITY ALERT‘ desaparecerá del panel de administración web de ocsreports.

Conclusión

En esta guía, instalaste y configuraste OCS Inventory Server en un servidor Ubuntu 22.04. Has instalado manualmente el OCS Inventory Server desde el código fuente y configurado el LAMP Stack (Apache2, MariaDB y PHP) utilizado para ejecutar el OCS Inventory Server y la aplicación web ocsreports.

Además de eso, también has instalado los ocsreports como la consola web y el panel de administración para el OCS Inventory Server. Has terminado de instalar la aplicación web de OCS reports con el LAMP Stack.

Con esto en mente, ahora puedes fácilmente gestionar tus dispositivos a través del OCS Agent, que puede ser instalado en múltiples sistemas operativos como distribuciones de Linux, Windows, macOS y BSD. También puedes asegurar tu OCS Inventory Server implementando HTTPS seguro en el servidor web Apache. Para aprender más, visita la documentación oficial del OCS Inventory Server.