# Installer et Configurer GLPI 12

## 1. Présentation et prérequis

### Architecture

<table id="bkmrk-%C3%89l%C3%A9ment-choix-syst%C3%A8m"><thead><tr><th>Élément</th><th>Choix</th></tr></thead><tbody><tr><td>Système</td><td>Debian 13 « Trixie »</td></tr><tr><td>Serveur web</td><td>Apache 2.4 avec PHP-FPM</td></tr><tr><td>Base de données</td><td>MariaDB</td></tr><tr><td>Application</td><td>GLPI 12.0.0</td></tr><tr><td>Usage E6</td><td>Gestion des incidents et gestion des configurations</td></tr></tbody></table>

GLPI 12 exige PHP 8.3 ou plus récent. Debian 11 et 12 n'ont que PHP 7.4 et 8.2, donc elles ne conviennent pas. Si votre sandbox impose Debian 11, utilisez GLPI 10, ou une VM Debian 13.

Un retour d'installation de GLPI 12.0.0 sur Debian 13 mentionne PHP 8.4, Apache 2.4 et MariaDB 11.8. La version 12.0.1 corrige des failles de sécurité ; remplacez `VERSION` dans les commandes pour l'utiliser.

### Matériel conseillé pour la VM

- 2 vCPU, 4 Go de RAM, 30 Go de disque.
- Une adresse IP fixe.
- Un accès internet pendant l'installation.

## 2. Préparer le système

```
sudo apt update && sudo apt upgrade -y
sudo hostnamectl set-hostname glpi
sudo timedatectl set-timezone Europe/Paris
cat /etc/os-release
```

Installez les paquets. Les extensions obligatoires pour GLPI 11 et plus incluent `curl`, `gd`, `intl`, `mysqli`, `bcmath`, `mbstring` et `openssl`. `ldap` sert à l'authentification Active Directory, `zip` et `bz2` au marketplace.

```
sudo apt install -y apache2 mariadb-server wget tar \
  php php-cli php-fpm libapache2-mod-fcgid \
  php-curl php-gd php-intl php-mysql php-xml php-mbstring \
  php-bcmath php-zip php-bz2 php-ldap php-opcache php-apcu

php -v
```

La version affichée doit être 8.3 ou supérieure.

## 3. Installer et sécuriser MariaDB

```
sudo systemctl enable --now mariadb
sudo mysql_secure_installation
```

Créez la base et l'utilisateur, après avoir remplacé `MOT_DE_PASSE_GLPI` :

```
sudo mysql
```

```
CREATE DATABASE glpi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'glpi'@'localhost' IDENTIFIED BY 'MOT_DE_PASSE_GLPI';
GRANT ALL PRIVILEGES ON glpi.* TO 'glpi'@'localhost';
GRANT SELECT ON mysql.time_zone_name TO 'glpi'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```

Chargez les fuseaux horaires :

```
mariadb-tzinfo-to-sql /usr/share/zoneinfo | sudo mysql mysql
```

Vérifiez la connexion avec le mot de passe défini :

```
mysql -u glpi -p glpi -e "SELECT 1;"
```

## 4. Télécharger GLPI

Utilisez l'archive `glpi-VERSION.tgz` des releases, pas les archives « Source code » de GitHub.

```
cd /tmp
VERSION=12.0.0
wget https://github.com/glpi-project/glpi/releases/download/${VERSION}/glpi-${VERSION}.tgz
sudo tar -xzf glpi-${VERSION}.tgz -C /var/www/
ls /var/www/glpi
```

## 5. Séparer code, configuration et données

La documentation recommande de placer la configuration, les fichiers de données et les journaux hors du code, selon la norme FHS.

```
sudo mkdir -p /etc/glpi /var/lib/glpi /var/log/glpi
sudo cp -a /var/www/glpi/config /etc/glpi/
sudo cp -a /var/www/glpi/files /var/lib/glpi/
```

Créez `/var/www/glpi/inc/downstream.php` :

```
<?php
define('GLPI_CONFIG_DIR', '/etc/glpi/');

if (file_exists(GLPI_CONFIG_DIR . '/local_define.php')) {
   require_once GLPI_CONFIG_DIR . '/local_define.php';
}
```

Créez `/etc/glpi/local_define.php` :

```
<?php
define('GLPI_VAR_DIR', '/var/lib/glpi/files');
define('GLPI_LOG_DIR', '/var/log/glpi');
```

Appliquez les droits :

```
sudo chown -R root:root /var/www/glpi
sudo chown -R www-data:www-data /etc/glpi /var/lib/glpi /var/log/glpi
sudo chown -R www-data:www-data /var/www/glpi/marketplace
sudo find /var/www/glpi -type d -exec chmod 755 {} \;
sudo find /var/www/glpi -type f -exec chmod 644 {} \;
```

## 6. Configurer Apache et PHP

Le `DocumentRoot` doit pointer vers le dossier `public`, pas vers la racine de GLPI.

```
ls /run/php/
sudo nano /etc/apache2/sites-available/glpi.conf
```

```
<VirtualHost *:80>
    ServerName glpi.local
    DocumentRoot /var/www/glpi/public

    <Directory /var/www/glpi/public>
        Require all granted
        RewriteEngine On

        RewriteCond %{HTTP:Authorization} ^(.+)$
        RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteRule ^(.*)$ index.php [QSA,L]
    </Directory>

    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php-fpm.sock|fcgi://localhost"
    </FilesMatch>
</VirtualHost>
```

Si `php-fpm.sock` n'apparaît pas dans `/run/php/`, utilisez le nom réel du socket, par exemple `php8.4-fpm.sock`.

Activez les modules et le site :

```
sudo a2enmod rewrite proxy_fcgi setenvif
sudo a2dissite 000-default
sudo a2ensite glpi
sudo apache2ctl configtest
```

Sécurisez les sessions PHP dans le `php.ini` de PHP-FPM, en remplaçant `8.4` par votre version :

```
sudo nano /etc/php/8.4/fpm/php.ini
```

```
session.cookie_httponly = On
session.cookie_samesite = Lax
; session.cookie_secure = On   (uniquement après l'activation du HTTPS)
```

```
sudo systemctl restart php8.4-fpm apache2
sudo systemctl enable php8.4-fpm apache2
```

## 7. Terminer l'installation

### Par l'assistant web

Ouvrez `http://IP_DU_SERVEUR/`, puis :

1. Choisissez la langue et acceptez la licence.
2. Cliquez sur **Installer** et corrigez tout prérequis en rouge.
3. Renseignez la base : serveur `localhost`, utilisateur `glpi`, mot de passe `MOT_DE_PASSE_GLPI`.
4. Sélectionnez la base `glpi`.
5. Terminez l'installation.

### Par la ligne de commande

```
cd /var/www/glpi
sudo -u www-data php bin/console db:install \
  --db-host=localhost --db-name=glpi \
  --db-user=glpi --db-password='MOT_DE_PASSE_GLPI' \
  --default-language=fr_FR
```

## 8. Comptes par défaut

L'installation crée quatre comptes : `glpi/glpi` administrateur, `tech/tech` technicien, `normal/normal` utilisateur normal et `post-only/postonly` utilisateur limité aux tickets.

Après la première connexion :

1. Créez un nouvel utilisateur avec le profil `super-admin`.
2. Changez le mot de passe de `glpi`, ou désactivez ce compte.
3. Supprimez ou désactivez `tech`, `normal` et `post-only`, ou changez leurs mots de passe.
4. Ne touchez pas à `glpi-system`, utilisé par les fonctions automatiques.

Supprimez aussi le script d'installation s'il est resté présent :

```
sudo rm -f /var/www/glpi/install/install.php
```

## 9. Tâches planifiées et HTTPS

```
sudo crontab -u www-data -e
```

```
* * * * * /usr/bin/php /var/www/glpi/front/cron.php &>/dev/null
```

Pour une sandbox, créez un certificat auto-signé :

```
sudo a2enmod ssl headers
sudo mkdir -p /etc/ssl/glpi
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout /etc/ssl/glpi/glpi.key -out /etc/ssl/glpi/glpi.crt \
  -subj "/CN=glpi.local"
```

Ajoutez un second `VirtualHost *:443` qui reprend la configuration précédente avec :

```
SSLEngine on
SSLCertificateFile /etc/ssl/glpi/glpi.crt
SSLCertificateKeyFile /etc/ssl/glpi/glpi.key
```

Redirigez ensuite le port 80 vers le HTTPS, puis activez `session.cookie_secure = On` et redémarrez PHP-FPM et Apache.

## 10. Configuration pour l'E6

### Organisation

- Créez les entités, les profils, les groupes de techniciens et quelques utilisateurs de test.
- Configurez les catégories de tickets et les délais de prise en charge.

### Authentification Active Directory

Dans la liste de votre épreuve, l'annuaire est un Active Directory sous Windows Server 2019.

- Allez dans Configuration &gt; Authentification &gt; Annuaire LDAP.
- Renseignez le serveur AD, le DN de base et un compte de lecture dédié.
- Testez la connexion, puis importez des utilisateurs.

### Inventaire et gestion des configurations

- Activez l'inventaire natif dans Administration &gt; Inventaire.
- Installez l'agent GLPI sur un poste Windows et un serveur Linux.
- Vérifiez que les machines apparaissent dans le parc.
- Documentez les logiciels, versions et propriétaires.

### Gestion des incidents

- Configurez l'e-mail sortant pour les notifications.
- Créez un ticket de test, assignez-le, résolvez-le, puis documentez la solution.
- Associez le ticket à un équipement de l'inventaire.

### Lien avec Zabbix

Simulez un service arrêté sur une machine supervisée : Zabbix déclenche l'alerte, vous ouvrez le ticket dans GLPI, puis vous le résolvez. Cela montre la supervision, l'incident et la configuration avec deux outils.

## 11. Sauvegarde

```
sudo mkdir -p /root/backups-glpi
sudo mysqldump --single-transaction --routines --triggers glpi \
  > "/root/backups-glpi/glpi-$(date +%F).sql"
sudo tar -czf "/root/backups-glpi/glpi-files-$(date +%F).tar.gz" \
  /etc/glpi /var/lib/glpi /var/www/glpi/marketplace
```

Si vous utilisez PBS, sauvegardez la VM entière sur un stockage séparé de l'hôte Proxmox, puis testez une restauration.

## 12. Validation et dépannage

<table id="bkmrk-v%C3%A9rification-command"><thead><tr><th>Vérification</th><th>Commande ou action</th></tr></thead><tbody><tr><td>Services actifs</td><td><code>systemctl is&#45;active apache2 mariadb php8&#46;4&#45;fpm</code></td></tr><tr><td>Syntaxe Apache</td><td><code>sudo apache2ctl configtest</code></td></tr><tr><td>Journal Apache</td><td><code>sudo tail &#45;f &#47;var&#47;log&#47;apache2&#47;error&#46;log</code></td></tr><tr><td>Journal GLPI</td><td><code>sudo tail &#45;f &#47;var&#47;log&#47;glpi&#47;php&#45;errors&#46;log</code></td></tr><tr><td>Cron GLPI</td><td>Page Configuration &gt; Actions automatiques</td></tr></tbody></table>

<table id="bkmrk-sympt%C3%B4me-piste-page-"><thead><tr><th>Symptôme</th><th>Piste</th></tr></thead><tbody><tr><td>Page Apache par défaut</td><td><code>a2ensite glpi</code> et <code>a2dissite 000&#45;default</code></td></tr><tr><td>Erreur 500</td><td>Journal Apache, extension PHP manquante ou droits</td></tr><tr><td>Prérequis rouges</td><td>Installez le paquet <code>php&#45;&#46;&#46;&#46;</code> correspondant</td></tr><tr><td>Erreur d'écriture</td><td>Propriétaire <code>www&#45;data</code> sur <code>&#47;etc&#47;glpi</code>, <code>&#47;var&#47;lib&#47;glpi</code>, <code>&#47;var&#47;log&#47;glpi</code></td></tr><tr><td>Fuseaux horaires</td><td>Relancez <code>mariadb&#45;tzinfo&#45;to&#45;sql</code> et le <code>GRANT SELECT</code></td></tr></tbody></table>