Installer le serveur WAPT sur Debian

Configuration du serveur GNU/Linux Debian

Afin d’installer un Debian Linux 11 Bullseye ou Ubuntu Focal LTS frais (physique ou virtuel).

Avertissement

  • Installer la version 64bits.

  • Installez le serveur sans interface graphique.

  • Systemd doit être activé

Attention

La procédure de mise à jour est différente de l’installation. Pour une mise à jour, rendez-vous sur la documentation pour mettre à jour le serveur WAPT.

Configurer les paramètres réseau

Les différents paramètres présentés ci-dessous ne sont pas spécifiques à WAPT, vous pouvez les adapter en fonction de votre environnement.

Modifiez les fichiers suivants afin d’obtenir une stratégie de nommage (FQDN) et d’adressage réseau appropriée.

Dans l’exemple suivant :

  • le nom FQDN est srvwapt.mydomain.lan ;

  • le nom court du serveur WAPT est srvwapt ;

  • le suffixe DNS est mydomain.lan ;

  • l’adresse IP est 10.0.0.10/24 ;

Configurer le nom du serveur WAPT

Indication

Le nom du serveur WAPT ne doit pas dépasser 15 caractères (limite liée au sAMAccountName dans Active Directory).

Le nom du serveur doit être un nom FQDN, c’est à dire à la fois le nom de machine et le suffixe DNS.

  • Modifier le fichier /etc/hostname et y renseigner le nom FQDN du serveur.

# /etc/hostname of the WAPT Server
srvwapt.mydomain.lan

  • Configurez le fichier /etc/hosts, assurez-vous de mettre à la fois le FQDN et le nom court du serveur.

# /etc/hosts of the WAPT Server
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
10.0.0.10   srvwapt.mydomain.lan srvwapt

Indication

  • Sur la ligne définissant l’adresse IP du serveur DNS, veillez à avoir l’IP du serveur (pas 127.0.0.1), puis le FQDN, puis le nom court.

  • Ne changez pas la ligne avec localhost.

Configurer l’adresse IP du serveur WAPT

  • Configurez l’adresse IP du serveur WAPT dans /etc/network/interfaces.

# /etc/network/interfaces of the WAPT Server
auto eth0
iface eth0 inet static
  address 10.0.0.10
  netmask 255.255.255.0
  gateway 10.0.0.254

  • Appliquez la configuration réseau en redémarrant la machine avec un reboot.

reboot

  • Si cela n’a pas déjà été fait, créez l’entrée DNS pour le serveur WAPT dans l’Active Directory de l” Organisation.

  • Après le redémarrage, configurez la langue du système en anglais afin d’avoir des journaux non localisés pour faciliter la recherche des erreurs courantes.

apt install locales-all -y
localectl set-locale LANG=en_US.UTF-8
localectl status

  • Vérifier si la machine est correctement synchronisée avec le serveur NTP. Si elle n’est pas synchronisée, se référer à la documentation du système d’exploitation pour configurer timedatectl.

timedatectl status

  • Mettre à jour et à niveau le système d’exploitation et s’assurer que le paquet d’Autorités de Certification par défaut de Debian est installé.

apt update && apt upgrade
apt install ca-certificates -y

  • Redémarrer le serveur.

reboot

Le serveur est maintenant prêt.

L’installation de la partie serveur de WAPT se décompose en plusieurs étapes:

  • Configurer les dépôts.

  • Installer les paquets Linux complémentaires.

  • Installation et provisionnement de la base de données PostgreSQL.

  • Post-configuration du serveur WAPT.

Note

Les paquets du serveur WAPT et le dépôt sont signés par Tranquil IT et il est nécessaire d’obtenir la clé publique gpg ci-dessous afin d’éviter les messages d’avertissement pendant l’installation.

Installer les paquets du Serveur WAPT

  • Mettre à jour la source APT, récupérer la clé .gpg de Tranquil IT, puis ajouter le dépôt de Tranquil IT.

    apt install apt-transport-https lsb-release gnupg wget -y
wget -O - https://wapt.tranquil.it/$(lsb_release -is)/tiswapt-pub.gpg | apt-key add -
echo "deb https://wapt.tranquil.it/$(lsb_release -is)/wapt-2.3/ $(lsb_release -c -s) main" > /etc/apt/sources.list.d/wapt.list

  • Installer les paquets du Serveur WAPT.

    export DEBIAN_FRONTEND=noninteractive
apt update
apt install tis-waptserver tis-waptsetup -y
unset DEBIAN_FRONTEND

Post-configuration

Script de post-configuration du serveur WAPT

Attention

Pour que le post-configuration fonctionne correctement, vous devez d’abord avoir un hostname pour le serveur WAPT. Pour vérifier, utilisez la commande echo $(hostname) qui doit retourner l’adresse DNS qui sera utilisé par les agents WAPT sur les ordinateurs clients.

Le script de post-configuration réécrit la configuration de nginx.

Ce script de post-configuration doit être exécuté en tant que root.

  • Lancez le script.

/opt/wapt/waptserver/scripts/postconf.sh

  • Cliquez sur Oui pour lancer le script de post-configuration.

do you want to launch post configuration tool?

            < yes >          < no >

  • Choisissez un mot de passe (si ce n’est pas déjà défini) pour le compte SuperAdmin du serveur WAPT (longueur minimale de 10 caractères).

Please enter the wapt server password (min. 10 characters)

*****************

                < OK >          < Cancel >

  • Confirmer le mot de passe.

Please enter the server password again:

*****************

                < OK >          < Cancel >

  • Choisissez le mode d’authentification pour l’enregistrement initial des agents WAPT:

    • Le choix #1 permet d’enregistrer les ordinateurs sans authentification. Le serveur WAPT enregistre tous les ordinateurs qui demandent à être enregistré.

    • Le choix #2 active l’enregistrement initial basé sur kerberos (vous pouvez l’activer plus tard).

    • Le choix #3 n’active pas le mécanisme d’authentification kerberos pour l’enregistrement initial des machines équipées de WAPT. Le serveur WAPT va demander un identifiant et mot de passe pour chaque machine qui s’enregistre.

WaptAgent Authentication type?

--------------------------------------------------------------------------
(x) 1 Allow unauthenticated registration
( ) 2 Enable kerberos authentication required for machines registration.
        Registration will ask for password if kerberos not available
( ) 3 Disable kerberos but registration require strong authentication
--------------------------------------------------------------------------
                                        < OK >          < Cancel >

  • Si vous souhaitez utiliser WAPT pour le déploiement de systèmes d’exploitation, sélectionnez Yes.

Do you want to activate os deployment?

        < Yes >        < No >

  • Si vous avez répondu Yes pour activer la fonctionnalité de déploiement de systèmes d’exploitation avec WAPT, le script de post-configuration vous demandera si vous souhaitez utiliser une authentification sécurisée afin de déployer l’image du système d’exploitation. Il vous demandera alors un utilisateur / mot de passe lorsque vous essayerez de déployer le système d’exploitation.

Would you like to activate secure authentication on wads?

        < Yes >        < No >

  • Toujours en ce qui concerne la fonction WADS, si vous avez répondu Yes aux 2 dernières questions, vous aurez une dernière question :

Would you like to mention an IP subnet exempt from wads authentication

        < Yes >        < No >

Si vous répondez Yes à cette question, vous devrez donner un sous-réseau IP qui peut être une liste (exemple : 192.168.0.0/24, 192.168.1.0/24).

  • Sélectionnez OK pour démarrer le serveur WAPT.

Press OK to start waptserver

             < OK >

  • Sélectionnez Oui pour configurer Nginx.

Do you want to configure nginx?

        < Yes >        < No >

  • Remplissez le FQDN du serveur WAPT.

FQDN for the WAPT Server (eg. wapt.example.com)

---------------------------------------------
wapt.mydomain.lan
---------------------------------------------

            < OK >          < Cancel >

  • Sélectionner OK et un certificat auto-signé sera généré, cette étape peut prendre un certain temps.

Generating DH parameters, 2048 bit long safe prime, generator 2 This is going to take a long time
.......................................+...............................+...

Nginx est maintenant configuré, sélectionnez OK pour redémarrer Nginx:

The Nginx config is done.
We need to restart Nginx?

              < OK >

Le post-confoguration est maintenant terminé.

Postconfiguration completed.
Please connect to https://wapt.mydomain.lan/ to access the WAPT Server.

                                  < OK >

Liste des options du script de post-configuration:

Options

Description

--force-https

Configurer Nginx de sorte que le port 80 soit redirigé de façon permanente vers le 443

Le serveur est maintenant prêt. Vous pouvez consulter la documentation sur l’installation de la console WAPT.