12. Tutoriel - WADS pour Linux 
¶
Indication
Documentation officielle de WADS ici
Note
WADS est une fonctionnalité de WAPT Enterprise. Veuillez vous assurer que vous disposez de la licence appropriée avant de commencer ce tutoriel.
12.1. Déploiement d’une machine Linux dans le domaine, avec jonction de domaine hors ligne¶
Dans cet exemple, nous allons déployer une machine Linux parce que l’ordinateur n’est pas éligible pour Windows 11. Si vous avez un poste de travail qui ne répond pas aux exigences de Windows 11, vous pouvez le recycler en poste de travail Linux. Le poste de travail existe déjà dans l’infrastructure, vous devrez donc le récupérer dans l’inventaire WAPT.
Puisque votre station de travail est listée dans l’inventaire, vous pouvez l’exporter vers OS Deploy en utilisant le wads button .
Vous pouvez renommer les hôtes en utilisant la touche clavier F2
12.1.1. Prérequis¶
Un serveur DHCP configuré.
Le serveur WAPT doit pouvoir échanger avec la machine à déployer.
Avoir une résolution DNS avec un contrôleur de domaine à partir de la console.
Utilisateur ayant des droits d’administrateur local sur le serveur WAPT.
Utilisateur qui a signé les fichiers exe ( Outils > Signer le fichier de déploiement) et les fichiers de configuration.
12.1.2. Création d’une configuration XML¶
Allez dans le panneau de configuration dans Déploiement d’OS.
Panneau de configuration¶
Cliquez sur le +.
Choisissez un nom de configuration. (1)
Décochez la case Pour Windows (2)
Ne choisissez pas d’ISO (2)
Choisissez un fichier de configuration en cliquant sur l’icône du document (dans ce quickstart, nous recommandons le mode hors ligne, afin de ne pas avoir à créer le compte de la machine dans Active Directory). (3)
Choisissez le fichier de script IPXE ( \wapt\templates\wads_template\linux\ipxescript\debian\debian.ipxe). (4)
Créer une configuration dans WADS pour Linux¶
Sauvegardez, vous avez créé une configuration dans WAPT. (5)
12.1.3. Ajouter le djoin sur votre poste¶
Faites un clic droit > Select a Configuration, prenez la configuration que vous avez faite précédemment et OK.
Cliquez avec le bouton droit de la souris sur l’ordinateur à déployer → prepare Djoin (cela vous permet de spécifier dans votre Active Directory l’unité organisationnelle où votre nouvelle machine sera enregistrée).
Complétez le domaine. (1)
Indiquez le contrôleur de domaine. (2)
Cliquez sur Connecter au domaine et recharger l’OU. (3)
Préférez l’option overwrite afin de réenregistrer l’ordinateur si nécessaire. (4)
Sélectionnez l’unité organisationationnelle de votre choix. (5)
Enregistrer. (6)
Editer le Djoin¶
Le commentaire Exist apparaît dans la colonne Djoin.
Sélectionnez l’ordinateur à déployer > Cliquez avec le bouton droit de la souris sur Démarrer le déploiement, un X apparaît dans la colonne En Attente de déploiement.
12.1.4. Sur l’ordinateur à déployer¶
Éteignez la machine
Démarrez l’ordinateur et chargez le menu de démarrage (utilisez F10 ou F12 au démarrage de l’ordinateur), sélectionnez LAN ou similaire.
Une fois l’opération terminée, la machine redémarre automatiquement.
Une fois le redémarrage terminé, votre machine est prête à fonctionner. Vous pouvez vous connecter avec un utilisateur du domaine.
Le déploiement de WADS est terminé et votre machine est enregistrée dans votre inventaire WAPT.
Note
Si votre ordinateur n’apparaît pas dans la bonne OU, vous pouvez vous identifier dans la console, et faire un clic droit Windows Computer management → Update AD Group Policies on hosts.
Explication technique du déroulé d'un déploiement linux via WADS
Présentation générale
Le déploiement de Linux avec WADS est piloté par un script iPXE. WADS n’a pas besoin de connaître la distribution Linux ni la syntaxe du fichier de configuration utilisé par le programme d’installation. Son rôle principal est de fournir :
le script iPXE associé à la configuration de déploiement ;
le fichier de configuration de l’installation automatisée, après avoir remplacé les variables WADS.
Le déroulement général est le suivant :
La machine démarre via PXE ou iPXE.
Le serveur WAPT renvoie le point d’entrée iPXE du WADS.
Le point d’entrée iPXE appelle la méthode « /api/v3/get_host_ipxe » en lui transmettant les identifiants matériels connus, tels que l’adresse MAC, l’adresse IP, l’UUID, le nom du fabricant, le nom du produit et le numéro de série.
WADS identifie la machine dans OS Deploy.
Si la machine est en attente de déploiement, WADS renvoie le script iPXE configuré pour cette machine.
Le script iPXE télécharge le noyau Linux et l’initrd.
Le script iPXE lance le programme d’installation Linux et lui transmet l’URL du point de terminaison WADS utilisée pour récupérer la configuration d’installation.
Le programme d’installation télécharge sa configuration automatique à partir de « /api/v3/get_wads_config ».
WADS génère cette configuration en remplaçant des variables telles que
{{hostname}}ou{{djoin}}.Le programme d’installation Linux applique les instructions contenues dans la configuration générée : partitionnement, installation des paquets, installation de l’agent WAPT, intégration au domaine, commandes post-installation, redémarrage, etc.
Note
WADS n’est pas lié à un programme d’installation Linux spécifique. C’est le script iPXE qui détermine quel noyau, quel initrd et quels paramètres de démarrage sont utilisés. Le fichier de configuration de l’installation définit ensuite les actions que le programme d’installation doit effectuer une fois lancé.
Rôle du script iPXE
Le script iPXE est l’élément central du déploiement Linux. Il définit la manière dont le programme d’installation est lancé.
Un script iPXE type doit :
télécharger le noyau Linux ;
télécharger l’initrd ou des fichiers de démarrage supplémentaires ;
transmettre les paramètres de démarrage requis au noyau ;
transmettre l’URL de configuration de WADS au programme d’installation ;
inclure les identifiants de la machine requis par le mode de correspondance de WADS.
Exemple Debian :
#!ipxe
kernel http://ftp.debian.org/debian/dists/stable/main/installer-amd64/current/images/netboot/debian-installer/amd64/linux initrd=initrd.gz initrd=firmware.cpio.gz auto=true fb=false priority=critical preseed/locale=en_US netcfg/get_hostname={{hostname}} netcfg/choose_interface=auto url={{server_url}}api/v3/get_wads_config?mac_address=${net0/mac}&conf_only=true&ip_address=${net0/ip}&uuid=${uuid} DEBCONF_DEBUG=5
initrd http://ftp.debian.org/debian/dists/stable/main/installer-amd64/current/images/netboot/debian-installer/amd64/initrd.gz
initrd http://cdimage.debian.org/cdimage/unofficial/non-free/firmware/stable/current/firmware.cpio.gz
boot
Dans cet exemple :
le script iPXE télécharge le noyau et les fichiers
initrdnécessaires au démarrage de l’installeur ;{{server_url}}est remplacé par WADS avant que le script ne soit renvoyé à iPXE ;{{hostname}}est remplacé par le nom d’hôte configuré dans Déploiement d’OS ;${net0/mac},${net0/ip}et${uuid}sont des variables iPXE évaluées côté client par iPXE ;conf_only=trueindique à WADS de ne renvoyer que le fichier de configuration d’installation généré ;le paramètre
url=transmet à l’installeur l’adresse du fichier de configuration généré par WADS.
Note
Des exemples de scripts iPXE et de fichiers de configuration d’installation sont fournis avec WAPT dans le répertoire suivant :
C:\Program Files (x86)\wapt\templates\wads_template\linux
Important
L’exemple ci-dessus illustre le principe général : le script iPXE démarre un installeur Linux et lui transmet l’URL de configuration WADS. Le nom exact des paramètres de démarrage dépend de l’installeur utilisé par le modèle. WADS se contente de fournir le script et de remplacer les variables ; il n’interprète pas les paramètres de démarrage.
Comment WADS fournit le script iPXE
Au démarrage de la machine, le premier point d’entrée iPXE de WADS appelle :
/api/v3/get_host_ipxe
Cet appel contient les informations collectées par iPXE, par exemple :
mac_address=${net0/mac}
ip_address=${net0/ip}
uuid=${uuid}
serial_number=${serial}
manufacturer=${manufacturer}
product=${product}
asset=${asset}
WADS interroge ensuite la base de données Déploiement d’OS :
si la machine est inconnue, WADS renvoie le comportement iPXE par défaut ;
si la machine est connue mais n’est pas en attente de déploiement, WADS interrompt le processus de déploiement ;
si la machine est en attente de déploiement et qu’un script iPXE personnalisé est configuré, WADS renvoie ce script après avoir remplacé les variables.
Rôle du script iPXE
{{server_url}}Remplacé par l’URL du serveur WAPT.
{{secondary_repo}}Remplacé par l’URL du dépôt WAPT sélectionné pour le réseau du client.
{{hostname}}Remplacé par le nom d’hôte configuré pour la machine dans Déploiement d’OS.
{{isohash}}Remplacé par le hash de l’ISO lorsqu’un ISO est associé à la configuration. Cette variable n’est généralement pas nécessaire dans un workflow iPXE Linux générique.
Note
Si WADS est configuré pour identifier les machines par numéro de série, le script iPXE doit envoyer serial_number=${serial} à WADS. Si la correspondance se fait par UUID ou par adresse MAC, vérifiez que la valeur correspondante est présente dans l’URL.
Comment WADS fournit la configuration d’installation
L’installeur Linux récupère sa configuration d’installation automatisée avec :
/api/v3/get_wads_config?mac_address=...&conf_only=true&ip_address=...&uuid=...&serial_number=...
Le paramètre conf_only=true est important. Il indique à WADS de renvoyer directement le fichier de configuration généré, au lieu de renvoyer une structure JSON.
Lorsque WADS reçoit cette requête, il :
identifie la machine à l’aide du mode de correspondance configuré ;
vérifie que la machine est en attente de déploiement ;
charge la configuration de déploiement sélectionnée pour cette machine ;
remplace les variables WADS dans le contenu de la configuration ;
renvoie la configuration générée à l’installeur.
Variables disponibles dans la configuration d’installation
{{server_url}}URL du serveur WAPT.
{{secondary_repo}}URL du dépôt WADS sélectionné pour le réseau du client.
{{hostname}}Nom d’hôte configuré pour la machine dans Déploiement d’OS.
{{djoin}}Blob de jonction de domaine hors ligne généré pour la machine.
{{url_conf_default}}URL du fichier de configuration par défaut de l’agent WAPT, provenant du répertoire
conf.ddu serveur WAPT.{{djoin_netbios_name}}Nom NetBIOS du domaine Active Directory extrait du blob djoin.
{{djoin_domain}}Domaine DNS Active Directory extrait du blob djoin.
{{djoin_domain_lower}}Domaine DNS Active Directory en minuscules.
{{djoin_domain_upper}}Domaine DNS Active Directory en majuscules.
Avertissement
Après avoir fourni la configuration de la machine, WADS efface la valeur djoin stockée pour des raisons de sécurité et retire le statut waiting to deploy de la machine. Si l’installeur échoue après avoir téléchargé la configuration, le déploiement doit être préparé à nouveau avant de réessayer.
Structure générique d’un modèle Linux piloté par iPXE
Un modèle Linux WADS se compose généralement de deux fichiers.
Le script iPXE
Ce fichier est exécuté par iPXE. Il est chargé de démarrer l’installeur.
Il doit contenir :
l’URL du noyau ;
l’URL de l’initrd ;
les paramètres de démarrage requis par l’installeur ;
l’URL de configuration WADS ;
les variables WADS qui doivent être remplacées avant le démarrage.
La configuration d’installation automatisée
Ce fichier est téléchargé par l’installeur une fois le noyau démarré. Il contient la logique d’installation proprement dite.
Il peut contenir des instructions pour :
le partitionnement et le formatage des disques ;
l’installation de paquets ;
les utilisateurs locaux et l’authentification ;
la configuration réseau ;
l’installation de l’agent WAPT ;
la jonction de domaine hors ligne ;
les commandes de post-installation ;
le redémarrage ou l’arrêt à la fin de l’installation.
Important
WADS ne valide pas la syntaxe de ce fichier. Il se contente de remplacer les variables et de renvoyer le résultat généré à l’installeur.
Utilisation de djoin dans un déploiement Linux
Le workflow djoin est facultatif. Lorsqu’il est utilisé, la console WAPT prépare un blob de jonction de domaine hors ligne pour la machine. Cette valeur est conservée dans Déploiement d’OS jusqu’à ce que l’installeur télécharge sa configuration.
Dans la configuration d’installation, la variable {{djoin}} est remplacée par la valeur djoin propre à la machine. La configuration doit ensuite écrire cette valeur dans le système installé et exécuter les commandes nécessaires pour l’exploiter.
WADS expose également des variables liées au domaine, extraites de la valeur djoin :
{{djoin_netbios_name}};{{djoin_domain}};{{djoin_domain_lower}};{{djoin_domain_upper}}.
Note
WADS ne joint pas directement le système Linux au domaine. Il se contente d’injecter les données djoin dans la configuration d’installation générée. Le modèle doit installer et configurer les composants Linux requis, puis exécuter la logique de jonction au domaine.
Installer et configurer l’agent WAPT
La configuration d’installation automatisée peut installer l’agent WAPT pendant la phase de post-installation.
Le modèle peut utiliser {{secondary_repo}} pour télécharger le paquet de l’agent depuis le dépôt sélectionné pour le réseau du client.
Après l’installation de l’agent, le modèle peut utiliser {{url_conf_default}} pour réinitialiser la configuration de l’agent à partir de la configuration par défaut du serveur WAPT.
Exemple générique :
# Download and install the WAPT agent package according to the URL format used by your template.
# Then reset the agent configuration from the server default configuration.
/opt/wapt/wapt-get.bin reset-config-from-url {{url_conf_default}}
Note
Le format exact du paquet et la commande d’installation dépendent du système Linux démarré par le script iPXE. WADS ne fournit que l’URL du dépôt et les variables de configuration générées.