Comment installer OCS Inventory Server sur Ubuntu 22.04

OCS Inventory Server est un logiciel open-source qui vous permet de scanner et d’inventorier tous les appareils de votre environnement ou de vos départements informatiques. C’est une solution gratuite de gestion des inventaires et des actifs qui vous aide à garder une trace de toutes les informations sur vos appareils et ordinateurs.

Il y a 4 composants principaux de l’OCS Inventory Server : le serveur de base de données, le serveur de communication, le serveur d’administration et le serveur de déploiement. L’OCS Inventory Server vous permet d’obtenir les données les plus récentes et les plus pertinentes sur vos appareils. Il peut être installé sur plusieurs systèmes d’exploitation et fournit des packages d’agent pour plusieurs systèmes d’exploitation tels que Microsoft Windows, Linux, BSD, Sun Solaris, IBM AIX, HP-UX, MacOS X et Android.

En ce qui concerne les appareils réseau, OCS Inventory prend en charge la découverte réseau et les agents SNMP. Vous pouvez ajouter et insérer des informations sur votre matériel réseau : imprimantes, commutateurs, ordinateurs (qui n’ont pas d’agent OCS installé), etc. via la découverte réseau et les agents SNMP.

Dans ce guide, vous allez installer OCS Inventory Server sur un serveur Ubuntu 22.04. Vous installerez OCS Inventory Server avec le serveur web Apache2, le serveur de base de données MariaDB et PHP. Cela inclut également l’installation d’ocsreports, qui est une application basée sur PHP fournissant un tableau de bord d’administration web pour l’OCS Inventory Server et qui sera exécutée avec Apache2 et PHP.

Prérequis

Pour compléter ce guide, vous devez avoir les exigences suivantes :

• Un serveur Linux exécutant Ubuntu 22.04 - Cet exemple utilise un serveur Ubuntu frais et générique avec le nom d’hôte ‘ocs-server‘ et l’adresse IP ‘192.168.5.20‘.
• Un utilisateur non-root avec des privilèges d’administrateur sudo/root.

Lorsque ces exigences sont prêtes, allez-y et commencez l’installation de l’OCS Inventory Server.

Installation des dépendances

Dans cette première section, vous devez installer certaines dépendances qui seront utilisées pour installer et exécuter OCS Inventory Server. Cette installation comprendra les packages suivants :

• Dépendances de base - Ces packages seront utilisés pour compiler certains modules Perl.
• Perl et quelques packages Perl supplémentaires - OCS Inventory Server est écrit en Perl, donc vous devez installer Perl sur votre serveur. Certains packages Perl supplémentaires ici incluent le pilote de base de données Perl et le package Perl soap pour l’API REST.
• LAMP Stack - L’OCS Inventory Server fonctionnera avec Apache2, la base de données MariaDB. Les packages PHP seront utilisés par ‘ocsreports‘, qui est le tableau de bord de l’application web de l’OCS Inventory Server.
• Modules Perl supplémentaires - Vous installerez certains modules Perl via CPAN (The Comprehensive Perl Archive Network).

Avant de commencer, entrez la commande suivante pour mettre à jour et rafraîchir votre index de packages Ubuntu.

sudo apt update

Entrez la commande ‘apt install‘ suivante pour installer certaines dépendances de développement de base. Ces packages sont principalement utilisés pour compiler certains modules Perl.

sudo apt install git curl wget make cmake gcc make

Lorsque vous y êtes invité, saisissez y pour confirmer et appuyez sur ENTRER pour continuer.

Maintenant, installez Perl et quelques packages Perl via la commande ‘apt install‘ ci-dessous. OCS Inventory Server est principalement écrit en Perl, donc vous devez installer les packages Perl avant d’installer 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

Saisissez y lorsque vous y êtes invité et appuyez sur ENTRER pour continuer.

Ensuite, installez le LAMP Stack avec quelques packages supplémentaires tels que ‘libapache2-mod-perl2‘ et ‘composer‘ via la commande ‘apt install‘ suivante. Le serveur web Apache et les packages PHP seront utilisés pour exécuter le tableau de bord d’administration web pour l’OCS Inventory Server, et MariaDB est utilisé comme backend de base de données.

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

Saisissez y lorsque vous y êtes invité, puis appuyez sur ENTRER.

Avec le LAMP Stack et Composer installés, entrez les commandes suivantes pour vérifier l’état du service Apache2, puis vérifiez la version de PHP et de Composer.

Vérifiez le service Apache2 via la commande ‘systemctl‘ ci-dessous. Une sortie ‘enabled‘ confirme que le serveur web Apache2 démarrera automatiquement au démarrage du système, et la sortie ‘active (running)‘ confirme que le serveur web Apache2 est en cours d’exécution.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Vérifiez le service MariaDB via la commande ‘systemctl‘ ci-dessous. Une sortie ‘enabled‘ confirme que le serveur MariaDB démarrera automatiquement au démarrage du système, et la sortie ‘active (running)‘ confirme que le service MariaDB est en cours d’exécution.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Vérifiez la version de PHP en utilisant la commande ci-dessous. Au moment de la rédaction de cet article, PHP 8.1 est installé sur le serveur, ce qui est fourni par le dépôt Ubuntu.

php -v

Vérifiez la version de Composer en entrant la commande suivante.

sudo -u www-data composer -v

Avec les dépendances de base installées, entrez la commande suivante pour installer certains modules Perl nécessaires à 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'

Vous serez invité à configurer CPAN pour la première fois. Saisissez ‘yes‘ pour confirmer et configurer CPAN automatiquement. L’installation des modules Perl devrait maintenant commencer.

Lorsque l’installation des modules Perl est terminée, cela confirme que les dépendances de package pour OCS Inventory Server sont maintenant installées. Dans l’étape suivante, vous allez configurer le serveur MariaDB et PHP.

Configuration du serveur MariaDB

Dans cette section, vous allez configurer et sécuriser le déploiement du serveur MariaDB via la commande ‘mariadb-secure-installation‘. Ensuite, vous allez créer une nouvelle base de données et un utilisateur qui seront utilisés par l’OCS Inventory Server.

Entrez la commande suivante pour commencer à configurer et sécuriser le déploiement du serveur MariaDB.

sudo mariadb-secure-installation

Vous serez interrogé sur les configurations suivantes de MariaDB :

• Passer l’authentification locale à unix_socket ? Saisissez n.
• Configurer le nouveau mot de passe root de MariaDB ? Saisissez y pour confirmer, puis tapez le nouveau mot de passe pour votre déploiement de serveur MariaDB.
• Supprimer l’utilisateur anonyme ? Saisissez y pour confirmer.
• Supprimer la base de données par défaut test du déploiement ? Saisissez y pour confirmer.
• Interdire la connexion root de MariaDB à partir de connexions distantes ? Saisissez y pour confirmer.
• Recharger les privilèges de table et appliquer les modifications ? Saisissez y et appuyez sur ENTRER.

Avec cela, vous avez maintenant sécurisé le déploiement du serveur MariaDB et configuré le mot de passe pour l’utilisateur root de MariaDB.

Connectez-vous maintenant à la console MariaDB en utilisant la commande ci-dessous. Vous allez créer une nouvelle base de données MariaDB et un utilisateur pour l’application OCS Inventory Server.

sudo mariadb -u root -p

Entrez les requêtes suivantes pour créer une nouvelle base de données ‘ocsdb‘ et l’utilisateur ‘ocs@localhost’. Assurez-vous également de changer le mot de passe de l’utilisateur MariaDB suivant.

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

Enfin, entrez la requête suivante pour vérifier la liste des privilèges du nouvel utilisateur ‘ocs@localhost‘. Vous devriez voir que l’utilisateur MariaDB ‘ocs@localhost‘ a accès à la base de données ‘ocsdb‘ qui sera utilisée par OCS Inventory Server.

SHOW GRANTS FOR ocs@localhost;  
QUIT;

Dans cette section, vous avez sécurisé le déploiement du serveur MariaDB et configuré le mot de passe root de MariaDB via la commande ‘mariadb-secure-installation‘. Vous avez également créé une nouvelle base de données MariaDB et un utilisateur pour l’installation de l’OCS Inventory Server. Dans l’étape suivante, vous allez configurer une configuration PHP qui sera utilisée pour exécuter ‘ocsreports‘ ou le tableau de bord d’administration OCS.

Configuration de PHP

Après avoir configuré le serveur MariaDB, vous allez maintenant configurer l’installation de PHP qui sera utilisée par ocsreports ou le serveur d’administration OCS. Vous devrez modifier certains paramètres dans le fichier ‘php.ini‘ et redémarrer le service Apache2 pour appliquer les modifications que vous avez effectuées.

Ouvrez le fichier de configuration PHP ‘/etc/php/8.1/apache2/php.ini‘ en utilisant la commande suivante de l’éditeur nano.

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

Changez les paramètres par défaut avec les lignes suivantes. Assurez-vous d’ajuster le paramètre ‘date.timezone‘ avec votre fuseau horaire.

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

Enregistrez et fermez le fichier lorsque vous avez terminé.

Entrez maintenant la commande suivante de systemctl pour redémarrer le service Apache2 et appliquer les modifications.

sudo systemctl restart apache2

Avec cela, la configuration de base de la pile LAMP pour l’OCS Inventory Server est terminée. Dans l’étape suivante, vous allez configurer le pare-feu UFW et ouvrir certains ports ou services.

Configuration du pare-feu UFW

Sur le serveur Ubuntu, ufw est le pare-feu par défaut qui est installé. Il est installé, mais pas encore en cours d’exécution sur le système. Dans cette section, vous allez ajouter les services OpenSSH et ‘Apache Full‘ à l’ufw. Ensuite, vous allez démarrer ufw sur votre serveur et l’activer pour qu’il s’exécute automatiquement au démarrage du système.

Entrez la commande ‘ufw allow‘ suivante pour ouvrir les applications OpenSSH et ‘Apache Full‘. L’application OpenSSH ouvrira le port SSH par défaut 22/tcp et le service ‘Apache Full’ ouvrira les ports HTTP et HTTPS par défaut - 80/tcp et 443/tcp.

sudo ufw allow OpenSSH  
sudo ufw allow 'Apache Full'

Exécutez maintenant la commande suivante pour démarrer et activer le pare-feu UFW. Lorsque vous y êtes invité, saisissez y pour confirmer et appuyez sur ENTRER pour continuer.

sudo ufw enable

Une sortie ‘Le pare-feu est actif et activé au démarrage du système‘ confirme que l’UFW est activé et sera exécuté automatiquement au démarrage du système. Et l’UFW devrait être en cours d’exécution après l’exécution de la commande.

Entrez la commande suivante pour vérifier l’état du pare-feu UFW. Une sortie ‘Statut : Actif‘ confirme que l’UFW est en cours d’exécution, vous verrez également que les applications ‘OpenSSH‘ et ‘Apache Full‘ ont été ajoutées et sont disponibles sur le pare-feu UFW.

sudo ufw status

À ce stade, vous avez maintenant terminé l’installation et les configurations de base des dépendances de package pour l’installation de l’OCS Inventory Server. Passez à la section suivante pour commencer l’installation de l’OCS Inventory Server.

Installation de l’OCS Inventory Server

L’OCS Inventory Server peut être installé sur différents systèmes d’exploitation tels que Linux, Unix et Windows. Il est disponible dans différents packages et fournit des dépôts officiels pour différentes distributions Linux, y compris Ubuntu, Debian et CentOS.

Pour cet exemple, vous allez installer OCS Inventory Server manuellement à partir de la source et le configurer avec le serveur de base de données MariaDB. Vous allez également installer les ocsreports qui seront utilisés comme application graphique et fourniront un tableau de bord d’administration web pour l’application OCS Inventory Server.

Déplacez votre répertoire de travail vers ‘/var/www‘ et téléchargez le code source de l’OCS Inventory Server via la commande ‘git clone‘ ci-dessous. Le code source devrait être disponible dans le répertoire ‘OCSInventory-Server‘.

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

Déplacez-vous dans le répertoire ‘OCSInventory-Server’ et téléchargez l’application ‘ocsreports‘ via la commande ‘git clone‘ ci-dessous. Les ‘ocsreports‘ sont une application web PHP qui sera utilisée comme console web ou tableau de bord d’administration web de l’OCS Inventory Server, et cela sera stocké dans le répertoire ‘ocsreports‘.

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

Déplacez-vous dans le répertoire ‘ocsreports‘ et exécutez la commande ‘composer install‘ pour installer les dépendances PHP pour l’application web ocsreports.

cd ocsreports/  
sudo -u www-data composer install

Ensuite, allez dans le répertoire racine d’installation de l’OCS Inventory Server ‘/var/www/OCSInventory-Server/‘ et ouvrez le script bash ‘setup.sh‘ en utilisant la commande suivante de l’éditeur nano. Le script ‘setup.sh‘ sera utilisé pour installer l’OCS Inventory Server.

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

Changez les paramètres de base de données avec vos détails de base de données, y compris le nom de la base de données, le nom d’utilisateur et le mot de passe.

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

Enregistrez et fermez le fichier lorsque vous avez terminé.

Maintenant, exécutez le script ‘setup.sh‘ pour commencer l’installation de l’OCS Inventory Server. Pendant l’installation, vous serez invité à certaines configurations du serveur OCS.

./setup.sh

Tout d’abord, le script ‘setup.sh‘ vérifiera et validera les dépendances pour l’installation de l’OCS Inventory Server. Si la configuration du serveur répond aux exigences du serveur OCS, vous devriez recevoir le message de bienvenue du script d’installation.

Saisissez y pour continuer.

Maintenant, le script d’installation vérifiera les détails de la base de données qui seront utilisés par l’OCS Inventory Server. Appuyez sur ENTRER pour utiliser la valeur par défaut pour l’hôte de base de données et le port.

Ensuite, vous serez interrogé sur les configurations du serveur web Apache2. Cela inclut des éléments tels que l’emplacement du fichier binaire ‘apachectl‘, la configuration par défaut d’Apache ‘apache.conf‘, l’utilisateur et le groupe par défaut qui exécutent le service Apache2, et le chemin par défaut utilisé par Apache2 pour stocker des fichiers de configuration supplémentaires.

Appuyez sur ENTRER pour utiliser les paramètres par défaut pour le serveur web Apache2.

Maintenant, vous serez interrogé sur le fichier binaire de ‘perl‘. Laissez-le par défaut et appuyez sur ENTRER pour continuer.

Lorsque vous serez invité à configurer le ‘serveur de communication‘ sur la machine actuelle, saisissez y pour confirmer. Maintenant, le script d’installation vérifiera certaines dépendances pour installer le ‘serveur de communication‘.

De plus, vous serez interrogé sur certains paramètres qui seront utilisés par le ‘serveur de communication‘. Appuyez sur ENTRER pour utiliser les paramètres par défaut.

Ensuite, le script d’installation ‘setup.sh‘ s’assurera que les modules Perl requis sont disponibles sur votre système. Une sortie ‘Found that PERL module … is available‘ confirme que le module est disponible.

Ensuite, vous serez invité à configurer l’API REST de l’OCS Inventory Server. Saisissez y pour confirmer et appuyez sur ENTRER pour les autres paramètres.

Avec cela, l’installation du ‘serveur de communication‘ ou de l’OCS Inventory Server va commencer. Voici quelques captures d’écran de l’installation de l’OCS Inventory Server.

Installation et configuration des modules Perl du ‘serveur de communication‘.

Configuration des répertoires de configuration pour le ‘serveur de communication‘.

L’installation du ‘serveur de communication‘ est terminée. De plus, lorsque vous serez invité à renommer le fichier de configuration par défaut d’Apache2 pour l’OCS Inventory Server, saisissez y pour confirmer et appuyez sur ENTRER pour continuer.

Ensuite, vous serez invité à configurer et installer le tableau de bord d’administration web ocsreports. Saisissez y pour confirmer.

Ensuite, l’installateur sera interrogé sur la source ‘ocsreports‘, qui est téléchargée et les dépendances PHP sont installées via Composer. Saisissez y à nouveau pour confirmer l’installation et appuyez sur ENTRER pour les autres configurations afin d’utiliser les paramètres par défaut.

L’installation des ocsreports va maintenant commencer.

Une fois terminé, vous devriez avoir un message tel que ‘OK, l’installation du serveur d’administration est terminée‘ affiché sur votre terminal.

Avec cela, l’installation du ‘serveur de communication‘ ou de l’OCS Inventory Server et du ‘serveur d’administration‘ ou des ocsreports est terminée.

À ce stade, l’installation et la configuration de base de l’OCS Inventory Server sont terminées, également certains fichiers et répertoires de configuration par défaut sont générés. Dans l’étape suivante, vous allez activer les fichiers de configuration Apache2 supplémentaires qui sont utilisés par l’OCS Inventory Server et les ocsreports.

Application des configurations Apache2 pour l’OCS Inventory Server

Après avoir installé l’OCS Inventory Server et les ocsreports, vous allez maintenant appliquer les configurations Apache2 générées pour l’installation OCS. Des configurations Apache2 supplémentaires générées par le script ‘setup.sh‘ de l’OCS dans le répertoire ‘/etc/apache2/conf-available/‘.

Maintenant, vous allez activer les configurations Apache2 qui seront utilisées pour l’OCS Inventory Server en créant un lien symbolique du fichier de configuration vers le répertoire cible ‘/etc/apache2/conf-enabled/‘.

Entrez la commande suivante pour activer les fichiers de configuration Apache2 pour l’OCS Inventory Server.

Le fichier ‘ocsinventory-reports.conf‘ est utilisé pour exécuter l’application web ocsreports, le fichier ‘z-ocsinventory-server.conf‘ est utilisé par l’OCS Inventory Server, et le fichier ‘zz-ocsinventory-restapi.conf‘ est utilisé par l’API REST du serveur 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

Entrez maintenant la commande suivante pour vous assurer que l’utilisateur et le groupe ‘www-data‘ peuvent écrire dans le répertoire de données ocsreports ‘/var/lib/ocsinventory-reports‘. Ensuite, vérifiez les configurations Apache2 via la commande ‘apachectl‘ ci-dessous.

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

Une sortie ‘Syntax OK‘ confirme que vous avez des fichiers de configuration Apache2 corrects et appropriés.

Entrez la commande suivante de systemctl pour redémarrer le service Apache2 et appliquer les modifications. Avec cela, l’OCS Inventory Server devrait maintenant être accessible via l’adresse IP du serveur.

sudo systemctl restart apache2

Installation de l’OCS Inventory Server et des OCS Reports

Ouvrez votre navigateur web et visitez l’adresse IP du serveur suivie du chemin du tableau de bord d’administration web ‘ocsreports‘ (c’est-à-dire : http://192.168.5.20/ocsreports/install.php).

Saisissez les détails de la base de données pour votre installation de l’OCS Inventory Server et cliquez sur ‘Envoyer‘ pour confirmer.

Une fois l’installation terminée, vous devriez recevoir une page comme celle-ci - En bas de la page, vous devriez obtenir un message tel que ‘Installation terminée..‘. Vous obtenez également le lien vers le tableau de bord d’administration web ocsreports.

Cliquez sur le lien pour accéder à la page de connexion ocsreports.

Sur la page de connexion OCS, saisissez l’utilisateur et le mot de passe d’administration par défaut ‘admin‘. Ensuite, cliquez sur ‘Envoyer‘ pour continuer.

Lorsque vous réussissez, vous devriez obtenir le tableau de bord d’administration ocsreports, qui est la gestion graphique pour l’OCS Inventory Server.

En haut du tableau de bord ocsreports, vous devriez voir le message ‘ALERTE DE SÉCURITÉ‘. Cela vous demande de supprimer le script d’installation ‘/usr/share/ocsinventory-reports/ocsreports/install.php‘ et de changer l’utilisateur et le mot de passe administratifs par défaut.

Retournez au terminal de l’OCS Inventory Server et exécutez la commande ci-dessous pour supprimer le script d’installation ‘install.php‘.

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

Ensuite, retournez au tableau de bord ocsreports et cliquez sur le menu des paramètres en haut à droite, puis sélectionnez le menu ‘Mon compte‘.

Changez l’utilisateur administrateur par défaut, l’email et le mot de passe. Ensuite, cliquez sur ‘OK‘ pour confirmer.

Avec le script d’installation ‘install.php‘ supprimé et l’utilisateur et le mot de passe administratifs par défaut changés, le message ‘ALERTE DE SÉCURITÉ‘ disparaîtra du tableau de bord d’administration web ocsreports.

Conclusion

Dans ce guide, vous avez installé et configuré OCS Inventory Server sur un serveur Ubuntu 22.04. Vous avez installé manuellement l’OCS Inventory Server à partir du code source et configuré la pile LAMP (Apache2, MariaDB et PHP) utilisée pour exécuter l’OCS Inventory Server et l’application web ocsreports.

En plus de cela, vous avez également installé les ocsreports comme console web et tableau de bord d’administration pour l’OCS Inventory Server. Vous avez terminé l’installation de l’application web ocsreports avec la pile LAMP.

Avec cela en tête, vous pouvez maintenant facilement gérer vos appareils via l’agent OCS, qui peut être installé sur plusieurs systèmes d’exploitation tels que les distributions Linux, Windows, macOS et BSD. Vous pouvez également sécuriser votre OCS Inventory Server en mettant en œuvre le HTTPS sécurisé sur le serveur web Apache. Pour en savoir plus, visitez la documentation officielle de l’OCS Inventory Server.