Come installare OCS Inventory Server su Ubuntu 22.04

OCS Inventory Server è un software open-source che consente di scansionare e inventariare tutti i dispositivi nel tuo ambiente o nei dipartimenti IT. È una soluzione gratuita per la gestione dell’inventario e degli asset che ti aiuta a tenere traccia di tutte le informazioni sui tuoi dispositivi e computer.

Ci sono 4 componenti principali dell’OCS Inventory Server: il server Database, il server di Comunicazione, il server di Amministrazione e il server di Distribuzione. L’OCS Inventory Server ti consente di ottenere i dati più recenti e pertinenti sui tuoi dispositivi. Può essere installato su più sistemi operativi e fornisce pacchetti agent per più sistemi operativi come Microsoft Windows, Linux, BSD, Sun Solaris, IBM AIX, HP-UX, MacOS X e Android.

Per quanto riguarda i dispositivi di rete, OCS Inventory supporta la scoperta di rete e gli agent SNMP. Puoi aggiungere e inserire informazioni sull’hardware di rete: stampanti, switch, computer (che non hanno un agente OCS installato), ecc. tramite la scoperta di rete e gli agent SNMP.

In questa guida, installerai OCS Inventory Server su un server Ubuntu 22.04. Installerai OCS Inventory Server con il server web Apache2, il server database MariaDB e PHP. Questo include anche l’installazione di ocsreports, che è un’applicazione basata su PHP che fornisce un dashboard di amministrazione web per l’OCS Inventory Server e verrà eseguita con Apache2 e PHP.

Prerequisiti

Per completare questa guida, devi avere i seguenti requisiti:

• Un server Linux che esegue Ubuntu 22.04 - Questo esempio utilizza un server Ubuntu fresco e generico con il nome host ‘ocs-server‘ e l’indirizzo IP ‘192.168.5.20‘.
• Un utente non root con privilegi di amministratore sudo/root.

Quando questi requisiti sono pronti, procedi e inizia l’installazione di OCS Inventory Server.

Installazione delle dipendenze

In questa prima sezione, devi installare alcune dipendenze che verranno utilizzate per installare e eseguire OCS Inventory Server. Questa installazione includerà i seguenti pacchetti:

• Dipendenze di base - Questi pacchetti verranno utilizzati per compilare alcuni moduli Perl.
• Perl e alcuni pacchetti Perl aggiuntivi - OCS Inventory Server è scritto in Perl, quindi devi installare Perl sul tuo server. Alcuni pacchetti Perl aggiuntivi qui includono il driver del database Perl e il pacchetto Perl soap per l’API REST.
• LAMP Stack - L’OCS Inventory Server verrà eseguito con Apache2 e il database MariaDB. I pacchetti PHP verranno utilizzati da ‘ocsreports‘, che è il dashboard dell’applicazione web dell’OCS Inventory Server.
• Moduli Perl aggiuntivi - Installerai alcuni moduli Perl tramite CPAN (The Comprehensive Perl Archive Network).

Prima di iniziare, inserisci il seguente comando per aggiornare e rinfrescare l’indice dei pacchetti di Ubuntu.

sudo apt update

Inserisci il seguente comando ‘apt install‘ per installare alcune dipendenze di sviluppo di base. Questi pacchetti sono principalmente utilizzati per compilare alcuni moduli Perl.

sudo apt install git curl wget make cmake gcc make

Quando richiesto, inserisci y per confermare e premi INVIO per procedere.

Ora installa Perl e alcuni pacchetti Perl tramite il comando ‘apt install‘ qui sotto. OCS Inventory Server è principalmente scritto in Perl, quindi devi installare i pacchetti Perl prima di installare l’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

Inserisci y quando richiesto e premi INVIO per procedere.

Successivamente, installa il LAMP Stack con alcuni pacchetti aggiuntivi come ‘libapache2-mod-perl2‘ e ‘composer‘ tramite il seguente comando ‘apt install‘. Il server web Apache e i pacchetti PHP verranno utilizzati per eseguire il dashboard di amministrazione web per OCS Inventory Server, e MariaDB viene utilizzato come backend del database.

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

Inserisci y quando richiesto, quindi premi INVIO.

Con il LAMP Stack e Composer installati, inserisci i seguenti comandi per verificare lo stato del servizio Apache2 e di MariaDB, quindi verifica la versione di PHP e Composer.

Verifica il servizio Apache2 tramite il comando ‘systemctl‘ qui sotto. Un output ‘enabled‘ conferma che il server web Apache2 si avvierà automaticamente all’avvio del sistema, e l’output ‘active (running)‘ conferma che il server web Apache2 è in esecuzione.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Verifica il servizio MariaDB tramite il comando ‘systemctl‘ qui sotto. Un output ‘enabled‘ conferma che il server MariaDB si avvierà automaticamente all’avvio del sistema, e l’output ‘active (running)‘ conferma che il servizio MariaDB è in esecuzione.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Verifica la versione di PHP utilizzando il comando qui sotto. Al momento della scrittura, PHP 8.1 è installato sul server, fornito dal repository di Ubuntu.

php -v

Verifica la versione di Composer inserendo il seguente comando.

sudo -u www-data composer -v

Con le dipendenze di base installate, inserisci il seguente comando per installare alcuni moduli Perl necessari per 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'

Ti verrà chiesto di configurare CPAN per la prima volta. Inserisci ‘yes‘ per confermare e configurare CPAN automaticamente. L’installazione dei moduli Perl dovrebbe ora iniziare.

Quando l’installazione dei moduli Perl è terminata, questo conferma che le dipendenze del pacchetto per OCS Inventory Server sono ora installate. Nella prossima fase, configurerai il server MariaDB e PHP.

Configurazione del server MariaDB

In questa sezione, configurerai e metterai in sicurezza il deployment del server MariaDB tramite il comando ‘mariadb-secure-installation‘. Quindi, creerai un nuovo database e un utente che verranno utilizzati dall’OCS Inventory Server.

Inserisci il seguente comando per iniziare a configurare e mettere in sicurezza il deployment del server MariaDB.

sudo mariadb-secure-installation

Ti verrà chiesto riguardo le seguenti configurazioni di MariaDB:

• Passare l’autenticazione locale a unix_socket? Inserisci n.
• Configurare la nuova password di root di MariaDB? Inserisci y per confermare, quindi digita la nuova password per il tuo deployment del server MariaDB.
• Rimuovere l’utente anonimo? Inserisci y per confermare.
• Rimuovere il database di test predefinito dal deployment? Inserisci y per confermare.
• Vietare il login di root di MariaDB da connessioni remote? Inserisci y per confermare.
• Ricaricare i privilegi delle tabelle e applicare le modifiche? Inserisci y e premi INVIO.

Con questo, hai ora messo in sicurezza il deployment del server MariaDB e configurato la password per l’utente root di MariaDB.

Ora accedi alla shell di MariaDB utilizzando il comando qui sotto. Creerai un nuovo database MariaDB e un utente per l’applicazione OCS Inventory Server.

sudo mariadb -u root -p

Inserisci le seguenti query per creare un nuovo database ‘ocsdb‘ e l’utente ‘ocs@localhost‘. Assicurati anche di cambiare la seguente password dell’utente MariaDB.

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

Infine, inserisci la seguente query per verificare i privilegi dell’utente ‘ ocs@localhost ‘. Dovresti vedere che l’utente MariaDB ‘ocs@localhost‘ ha accesso al database ‘ocsdb‘ che verrà utilizzato dall’OCS Inventory Server.

SHOW GRANTS FOR ocs@localhost;  
QUIT;

In questa sezione, hai messo in sicurezza il deployment del server MariaDB e configurato la password di root di MariaDB tramite il comando ‘mariadb-secure-installation‘. Hai anche creato un nuovo database MariaDB e un utente per l’installazione di OCS Inventory Server. Nella prossima fase, configurerai una configurazione PHP che verrà utilizzata per eseguire ‘ocsreports‘ o il dashboard di amministrazione OCS.

Configurazione di PHP

Dopo aver configurato il server MariaDB, ora configurerai l’installazione di PHP che verrà utilizzata da ocsreports o dal server di amministrazione OCS. Dovrai modificare alcuni parametri nel file ‘php.ini‘ e riavviare il servizio Apache2 per applicare le modifiche che hai effettuato.

Apri il file di configurazione PHP ‘/etc/php/8.1/apache2/php.ini‘ utilizzando il seguente comando dell’editor nano.

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

Cambia i parametri predefiniti con le seguenti righe. Assicurati di regolare il parametro ‘date.timezone‘ con il tuo fuso orario.

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

Salva e chiudi il file quando hai finito.

Ora inserisci il seguente comando systemctl per riavviare il servizio Apache2 e applicare le modifiche.

sudo systemctl restart apache2

Con questo, la configurazione di base del LAMP Stack per l’OCS Inventory Server è terminata. Nella prossima fase, configurerai il firewall UFW e aprirai alcune porte o servizi.

Configurazione del firewall UFW

Sul server Ubuntu, ufw è il firewall predefinito che è installato. È installato, ma non è ancora in esecuzione sul sistema. In questa sezione, aggiungerai i servizi OpenSSH e ‘Apache Full‘ al ufw. Quindi, avvierai ufw sul tuo server e lo abiliterai per l’esecuzione automatica all’avvio del sistema.

Inserisci il seguente comando ‘ufw allow‘ per aprire le applicazioni OpenSSH e ‘Apache Full‘. L’applicazione OpenSSH aprirà la porta SSH predefinita 22/tcp e il servizio ‘Apache Full’ aprirà le porte HTTP e HTTPS predefinite - 80/tcp e 443/tcp.

sudo ufw allow OpenSSH  
sudo ufw allow 'Apache Full'

Ora esegui il seguente comando per avviare e abilitare il firewall UFW. Quando richiesto, inserisci y per confermare e premi INVIO per procedere.

sudo ufw enable

Un output ‘Firewall is active and enabled on system startup‘ conferma che l’UFW è abilitato e verrà eseguito automaticamente all’avvio del sistema. E l’UFW dovrebbe essere in esecuzione dopo che il comando è stato eseguito.

Inserisci il seguente comando per verificare lo stato del firewall UFW. Un output ‘Status: Active‘ conferma che l’UFW è in esecuzione, vedrai anche entrambe le applicazioni ‘OpenSSH‘ e ‘Apache Full‘ aggiunte e disponibili sul firewall UFW.

sudo ufw status

A questo punto, hai ora terminato l’installazione e le configurazioni di base delle dipendenze del pacchetto per l’installazione di OCS Inventory Server. Passa alla sezione successiva per avviare l’installazione di OCS Inventory Server.

Installazione di OCS Inventory Server

OCS Inventory Server può essere installato su diversi sistemi operativi come Linux, Unix e Windows. È disponibile in diversi pacchetti e fornisce repository ufficiali per diverse distribuzioni Linux, tra cui Ubuntu, Debian e CentOS.

Per questo esempio, installerai OCS Inventory Server manualmente dal sorgente e lo configurerai con il server database MariaDB. Installerai anche ocsreports che verrà utilizzato come applicazione grafica e fornisce un dashboard di amministrazione web per l’applicazione OCS Inventory Server.

Sposta la tua directory di lavoro in ‘/var/www‘ e scarica il codice sorgente di OCS Inventory Server tramite il comando ‘git clone‘ qui sotto. Il codice sorgente dovrebbe essere disponibile nella directory ‘OCSInventory-Server‘.

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

Spostati nella directory ‘OCSInventory-Server’ e scarica l’applicazione ‘ocsreports‘ tramite il comando ‘git clone‘ qui sotto. L’ocsreports è un’applicazione web PHP che verrà utilizzata come console web o dashboard di amministrazione web dell’OCS Inventory Server, e questa sarà memorizzata nella directory ‘ocsreports‘.

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

Spostati nella directory ‘ocsreports‘ e esegui il comando ‘composer install‘ per installare le dipendenze PHP per l’applicazione web ocsreports.

cd ocsreports/  
sudo -u www-data composer install

Successivamente, vai alla directory radice di installazione di OCS Inventory Server ‘/var/www/OCSInventory-Server/‘ e apri lo script bash ‘setup.sh‘ utilizzando il seguente comando dell’editor nano. Lo script ‘setup.sh‘ verrà utilizzato per installare l’OCS Inventory Server.

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

Cambia i parametri del database con i dettagli del tuo database che includono il nome del database, nome utente e password.

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

Salva e chiudi il file quando hai finito.

Ora esegui lo script ‘setup.sh‘ per avviare l’installazione di OCS Inventory Server. Durante l’installazione, ti verrà chiesto di alcune configurazioni del server OCS.

./setup.sh

Per prima cosa, lo script ‘setup.sh‘ verificherà e controllerà le dipendenze per l’installazione dell’OCS Inventory Server. Se la configurazione del server soddisfa i requisiti del server OCS, dovresti ricevere il messaggio di benvenuto dallo script di installazione.

Inserisci y per continuare.

Ora lo script di installazione verificherà i dettagli del database che verranno utilizzati dall’OCS Inventory Server. Premi INVIO per utilizzare il valore predefinito per l’host e la porta del database.

Successivamente, ti verrà chiesto riguardo le configurazioni del server web Apache2. Questo include la posizione del file binario ‘apachectl‘, la configurazione predefinita di Apache ‘apache.conf‘, l’utente e il gruppo predefiniti che eseguono il servizio Apache2 e il percorso predefinito utilizzato da Apache2 per memorizzare file di configurazione aggiuntivi.

Premi INVIO per utilizzare le impostazioni predefinite per il server web Apache2.

Ora ti verrà chiesto riguardo il file binario di ‘perl‘. Lascialo come predefinito e premi INVIO per continuare.

Quando ti verrà chiesto di configurare il ‘Communication server‘ sulla macchina corrente, inserisci y per confermare. Ora lo script di installazione verificherà alcune dipendenze per installare il ‘Communication server‘.

Inoltre, ti verrà chiesto riguardo alcune impostazioni che verranno utilizzate dal ‘Communication server‘. Premi INVIO per utilizzare le impostazioni predefinite.

Successivamente, lo script di installazione ‘setup.sh‘ si assicurerà che i moduli Perl richiesti siano disponibili sul tuo sistema. Un output ‘Found that PERL module … is available‘ conferma che il modulo è disponibile.

Poi, ti verrà chiesto di configurare l’API REST dell’OCS Inventory Server. Inserisci y per confermare e premi INVIO per il resto delle impostazioni.

Con questo, l’installazione del ‘Communication server‘ o dell’OCS Inventory Server inizierà. Di seguito sono riportati alcuni screenshot dell’installazione dell’OCS Inventory Server.

Installazione e configurazione dei moduli Perl del ‘Communication server‘.

Impostazione delle directory di configurazione per il ‘Communication server‘.

L’installazione del ‘Communication server‘ è terminata. Inoltre, quando ti verrà chiesto di rinominare il file di configurazione predefinito di Apache2 per l’OCS Inventory Server, inserisci y per confermare e premi INVIO per procedere.

Successivamente, ti verrà chiesto di configurare e installare il dashboard di amministrazione web ‘ocsreports’. Inserisci y per confermare.

Quindi, l’installatore verrà chiesto riguardo la sorgente di ‘ocsreports‘, che è stata scaricata e le dipendenze PHP sono state installate tramite Composer. Inserisci y di nuovo per confermare l’installazione e premi INVIO per il resto delle configurazioni per utilizzare le impostazioni predefinite.

L’installazione di ocsreports inizierà ora.

Una volta terminato, dovresti ricevere un messaggio come ‘OK, Administration server installation finished‘ stampato nel tuo terminale.

Con questo, l’installazione del ‘Communication server‘ o dell’OCS Inventory Server e del ‘Administration server‘ o di ocsreports è terminata.

A questo punto, l’installazione e la configurazione di base dell’OCS Inventory Server sono terminate, sono stati generati anche alcuni file e directory di configurazione predefiniti. Nella prossima fase, attiverai i file di configurazione aggiuntivi di Apache2 che vengono utilizzati dall’OCS Inventory Server e da ocsreports.

Applicazione delle configurazioni di Apache2 per OCS Inventory Server

Dopo aver installato l’OCS Inventory Server e ocsreports, ora applicherai le configurazioni di Apache2 generate per l’installazione OCS. Ulteriori configurazioni di Apache2 generate dallo script ‘setup.sh‘ dell’OCS nella directory ‘/etc/apache2/conf-available/‘.

Ora attiverai le configurazioni di Apache2 che verranno utilizzate per l’OCS Inventory Server creando un collegamento simbolico del file di configurazione nella directory di destinazione ‘/etc/apache2/conf-enabled/‘.

Inserisci il seguente comando per abilitare i file di configurazione di Apache2 per l’OCS Inventory Server.

Il file ‘ocsinventory-reports.conf‘ viene utilizzato per eseguire l’applicazione web ocsreports, il file ‘z-ocsinventory-server.conf‘ è utilizzato dall’OCS Inventory Server e il file ‘zz-ocsinventory-restapi.conf‘ è utilizzato dall’API REST del server OCS.

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

Ora inserisci il seguente comando per assicurarti che l’utente e il gruppo ‘www-data‘ possano scrivere nella directory dei dati di ocsreports ‘/var/lib/ocsinventory-reports‘. Quindi, verifica le configurazioni di Apache2 tramite il comando ‘apachectl‘ qui sotto.

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

Un output ‘Syntax OK‘ conferma che hai file di configurazione di Apache2 corretti e appropriati.

Inserisci il seguente comando systemctl per riavviare il servizio Apache2 e applicare le modifiche. Con questo, l’OCS Inventory Server dovrebbe ora essere accessibile tramite l’indirizzo IP del server.

sudo systemctl restart apache2

Installazione di OCS Inventory Server e OCS Reports

Apri il tuo browser web e visita l’indirizzo IP del server seguito dal percorso del dashboard di amministrazione web ‘ocsreports‘ (ad es: http://192.168.5.20/ocsreports/install.php).

Inserisci i dettagli del database per la tua installazione di OCS Inventory Server e fai clic su ‘Invia‘ per confermare.

Una volta terminata l’installazione, dovresti ricevere una pagina come questa - In fondo alla pagina, dovresti ricevere un messaggio come ‘Installation finished..‘. Riceverai anche il link al dashboard di amministrazione web di ocsreports.

Fai clic sul link per accedere alla pagina di login di ocsreports.

Nella pagina di login di OCS, inserisci l’utente e la password di amministrazione predefiniti ‘admin‘. Quindi, fai clic su ‘Invia‘ per continuare.

Quando avrai successo, dovresti ottenere il dashboard di amministrazione di ocsreports, che è la gestione grafica per l’OCS Inventory Server.

In cima al dashboard di ocsreports, dovresti vedere il messaggio ‘SECURITY ALERT‘. Questo ti istruisce a rimuovere lo script di installazione ‘/ usr/share/ocsinventory-reports/ocsreports/install.php‘ e cambiare l’utente e la password di amministrazione predefiniti.

Torna al terminale dell’OCS Inventory Server ed esegui il seguente comando per rimuovere lo script di installazione ‘install.php‘.

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

Successivamente, torna al dashboard di ocsreports e fai clic sul menu impostazioni in alto a destra, quindi seleziona il menu ‘Il mio account‘.

Cambia l’utente di amministrazione predefinito, l’email e la password. Quindi fai clic su ‘OK‘ per confermare.

Con lo script di installazione ‘install.php‘ rimosso e l’utente e la password di amministrazione predefiniti cambiati, il messaggio ‘SECURITY ALERT‘ scomparirà dal dashboard di amministrazione web di ocsreports.

Conclusione

In questa guida, hai installato e configurato OCS Inventory Server su un server Ubuntu 22.04. Hai installato manualmente l’OCS Inventory Server dal codice sorgente e configurato il LAMP Stack (Apache2, MariaDB e PHP) utilizzato per eseguire l’OCS Inventory Server e l’applicazione web ocsreports.

In aggiunta a ciò, hai anche installato ocsreports come console web e dashboard di amministrazione per l’OCS Inventory Server. Hai terminato l’installazione dell’applicazione web ocsreports con il LAMP Stack.

Tenendo questo a mente, ora puoi facilmente gestire i tuoi dispositivi tramite OCS Agent, che può essere installato su più sistemi operativi come distribuzioni Linux, Windows, macOS e BSD. Puoi anche mettere in sicurezza il tuo OCS Inventory Server implementando HTTPS sicuro sul server web Apache. Per saperne di più, visita la documentazione ufficiale dell’OCS Inventory Server.