Les cours du BTS SIO

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Guide : installer Proxmox VE dans WSL ======

===== Installation de la distribution Debian de WSL avec le nom pve=====
<WRAP center round info>
Lors de l'installation de la distribution Debian, WSL sera installé s'il n'est pas encore configuré dans votre ordinateur Windows.
</WRAP>
 
  * installer la distribution Debian en la renommant **pve** depuis l'invite de commande cmd ou Powershell :

<code shell>
PS/> wsl --install -d debian --name pve
Installation en cours : Sous-système Windows pour Linux
[=                          3,0%                           ]
Téléchargement : Debian GNU/Linux 
Installation : Debian GNU/Linux 
L’opération demandée est réussie. Les modifications ne seront pas effectives avant que le système ne soit réamorcé.
La distribution a été installée. Il peut être lancé via 'wsl.exe -d pve'
</code>

  * Un redémarrage de Windows est nécessaire s'il s'agit de la première installation de WSL.
  * Vérifiez la présence de la distribution pve (la distribution est installée mais stoppée) :

<code shell>
PS/> wsl -l -v
  NAME    STATE           VERSION 
* pve     Stopped         2 
</code>


===== Modifier la configuration de WSL =====
Créez puis modifiez le fichier de configuration WSL de votre compte utilisateur Windows (%UserProfile%%%\%%.wslconfig) pour : 
  * définir le mode réseau de WSL en NAT (configuration par défaut) ;
  * **forcer WSL2** à passer entièrement aux **cgroups v2**
<WRAP center round info>
Utilisez l’éditeur en ligne de commande nano pour modifier le contenu des fichiers.
</WRAP>


Le fichier **.wslconfig** doit contenir dans la section [wsl2] avec les deux lignes suivantes:
<code file .wslconfig>
[wsl2]
networkingMode =  NAT
kernelCommandLine = systemd.unified_cgroup_hierarchy=1 cgroup_no_v1=all
</code> 

===== Configurer la distribution pve =====


  * Démarrez la distribution pve.

<code shell>
wsl -d pve
</code>

  * Lors du premier lancement de la distribution, vous devez créer un compte utilisateur et son mot de passe :
    * créez le compte utilisateur sio ;
    * avec le mot de passe Sio1234*

  * Passez **root** pour changer le mot de passe de ce compte car il devra être utilisé pour se connecter à l'interface d'administration de Proxmox VE.

<code shell>
# Passer en root
$ sudo -i

# Définir le mot de passe du compte root nécessaire pour s'authentifier dans l'interface Web d'administration de Proxmox.
passwd

# Vérifier la version de Debian pour connaître quelle version récente de Proxmox est installable
# cat /etc/os-release
# VERSION="12 (bookworm)"
Se rendre à l'URL du Wiki de PVE (https://pve.proxmox.com/wiki/FAQ#faq-support-table) et prenez connaissance de la version à installer. Pour Debian 12 c'est PVE 8.x.
</code>

==== Vérifier l'activation de systemd (cela est fait défaut)====
Vérifiez dans le fichier **/etc/wsl.conf** la présence de la ligne suivante dans la rubrique boot:

<code>
# cat /etc/wsl.conf
[boot]
systemd=true
</code>



==== Configuration réseau ====
<WRAP center round important>
Important : une configuration incorrecte de la configuration IP de la distribution ne permettra pas d'accéder à l'interface Web de Proxmox
</WRAP>

  * Configurer WSL2 :
    * pour ne pas réécrire le fichier **/etc/hosts** ainsi que le fichier **/etc/resolv.conf** à chaque démarrage de la distribution, ajoutez les lignes ci-dessous au fichier **/etc/wsl.conf** de la distribution pve en  créant une rubrique [network] ; 
    * pour personnalisez également le nom de la distribution afin de l'appeler **pve** en  mettant à jour le fichier **/etc/hosts**.

Voici le contenu actualisé du fichier  **/etc/wsl.conf** qui contient déjà une section [boot] pour activer **systemd** :

<code file wsl.conf>
[boot]
systemd=true

[network]
hostname = pve
generateHosts = false
generateResolvConf = false
</code>

=== Modification manuelle du fichier /etc/hosts (une modification automatique sera ensuite configurée)===

  * prenez connaissance de l'adresse IP de la distribution (pour exemple 172.28.38.112/20) :

<code>
# ip a
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether 00:15:5d:23:ef:de brd ff:ff:ff:ff:ff:ff
    inet 172.28.38.112/20 brd 172.28.47.255 scope global eth0
</code>
 
  * mettre à jour le fichier **/etc/hosts** en ajoutant une entrée pour votre adresse IP de votre distribution pve car le nom d’hôte de votre machine doit pouvoir être résolu via **/etc/hosts**. Pour cela il faut remplacer l’adresse 127.0.1.1 présente par défaut par l'adresse IP de votre distribution. Par exemple, si votre PC Windows se nomme PC-perso avec l'adresse IP de la distribution **172.28.38.112/20**, pour utiliser le nom **pve**, votre fichier **/etc/hosts** pourrait ressembler à :

<code >
127.0.0.1            localhost
#127.0.0.1           PC-perso.    PC-perso
172.28.38.112        pve          pve

# The following lines are desirable for IPv6 capable hosts
::1     localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</code>

=== Modification automatique du fichier /etc/hosts ===
  * Création du fichier **/usr/local/bin/pvepreup.sh**  avec le contenu suivant : 

<code file pvepreup.sh>
#!/bin/bash

ip4addr=`ip -4 a show eth0 | awk '/inet .* scope global/ {split($2,out,"/");print out[1]}'`

awk "/^127\.0\.0\.1.*`hostname`/ {next} /`hostname`/ {\$1 = \"$ip4addr\"} // {print}" /etc/hosts > /etc/hosts.new && mv /etc/hosts.new /etc/hosts
</code>

  * création du fichier **/etc/systemd/system/pvepreup.service** :

<code file pvepreup.service>
[Unit]
Description=Fix /etc/hosts before starting PVE
Before=pve-cluster.service
After=network.target
DefaultDependencies=no
Before=shutdown.target
Conflicts=shutdown.target

[Service]
ExecStart=/usr/local/bin/pvepreup.sh
KillMode=mixed
TimeoutStopSec=10
Type=oneshot

[Install]
WantedBy=multi-user.target
</code>

  * activez le service

<code>
chmod +x /usr/local/bin/pvepreup.sh
systemctl daemon-reload
systemctl enable pvepreup
systemctl status pvepreup
</code>
=== Tests ===

  * Tout d'abord, depuis Powershell, arrêtez et redémarrez la distribution pve en ouvrant une session directement avec le compte root.

<code>
# exit                      # fermer la session root
$ exit                      # fermer la session sio
PS> wsl --shutdown          # arrêter la distribution
PS> wsl -d pve --user root  # démarrer la distribution et ouvrir une session avec le compte root
</code>

<WRAP center round info>
La mise à jour automatique du fichier **/etc/resolv.conf** ayant été désactivée dans  WSL (generateResolvConf = false dans le fichier **/etc/wsl.conf**), il est **nécessaire de créer** ce fichier **/etc/resolv.conf** pour indiquer l'adresse IP du serveur DNS de votre choix.
</WRAP>

  * Créez le fichier **/etc/resolv.conf** pour indiquer l'adresse IP du serveur de nom de votre choix

<code>
nameserver 8.8.8.8
</code>



  * Testez si votre configuration est correcte à l’aide de la commande hostname (l'adresse IP doit être celle de votre distribution pve) :

<code>
# hostname
pve

# hostname --ip-address
172.28.38.112 
</code>

===== Installer les prérequis =====


<code>
apt update && apt upgrade -y
apt install -y apt-transport-https python3-requests lsb-release
</code>

  * Ajoutez le dépôt de Proxmox VE

<code>
echo "deb [arch=amd64] http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-install-repo.list
</code>

  * Ajoutez la clé du dépôt de Proxmox VE :

<code>
apt install -y wget

wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg

# verifier la clé
sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg 
7da6fe34168adc6e479327ba517796d4702fa2f8b4f0a9833f5ea6e6b48f6507a6da403a274fe201595edc86a84463d50383d07f64bdde2e3658108db7d6dc87  /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg 
</code> 


===== Mettre à jour le référentiel et le système =====

<code>
apt update && apt full-upgrade
</code>

===== Installer le noyau Proxmox VE =====

<code>
apt install -y proxmox-default-kernel
systemctl reboot
</code>

  * ouvrez à nouveau une session dans la distribution pve avec le compte root :

<code>
PS> wsl -d pve --user root
</code> 

===== Installer et configurer de Postfix =====
L'installation et la configuration de Postfix est nécessaire pour pouvoir ensuite installer Proxmox :
  * installation de Postfix ;
  * choisissez comme configuration **Local only** ;
  * gardez le nom de domaine **pve** proposé.
<code>
apt install postfix -y
systemctl restart postfix
</code>

===== Installer Proxmox VE =====
  * Lancez l'installation de Proxmox VE :

<code>
apt install -y proxmox-ve  open-iscsi chrony
</code>

  * Il est recommandéde supprimer le paquet logiciel **os-prober** quand le dual-boot n'est pas géré :

<code>
apt remove -y os-prober
</code>

===== Permettre l'utilisation des conteneurs LXC  =====
Proxmox détecte qu'il est virtualisé et ne permet pas la création de conteneurs LXC.

Pour le permettre, modifiez la condition suivante dans le fichier **/lib/systemd/system/lxcfs.service** 
  * remplacez 

<code>
[Unit]
ConditionVirtualization=!container
</code>

  * par 

<code>
[Unit]
ConditionVirtualization=container
</code>



===== Vérifiez que tout fonctionne =====

Redémarrez la distribution **pve** et connectez-vous avec le compte root depuis PowerShell:

<code>
# exit                      # fermer la session
PS> wsl --shutdown          # arrêter la distribution
PS> wsl -d pve --user root  # démarrer la distribution et ouvrir une session avec le compte root
</code>
Proxmox devrait fonctionner. L’interface utilisateur Web est accessible à l’adresse https://localhost:8006.


Pour un accès en SSH, déposez votre clé publique dans **/root/.ssh/authorized_keys**.

<WRAP center round info>
L'adresse IP de la distribution **pve** est dans le plan d'adressage **172.28.32.0/20** de WSL en mode réseau NAT.

Exemple : 
<code>
# ip a
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether 00:15:5d:a5:6c:be brd ff:ff:ff:ff:ff:ff
    inet 172.28.38.112/20 brd 172.28.47.255 scope global eth0
</code>

</WRAP>



===== Debogage =====
  * Vérifiez la présence de la ligne suivante dans le fichier **/etc/hosts** de la distribution **pve** afin d'avoir une entrée pour l'adresse IP de la distribution associée au nom **pve**. 

Exemple avec l'adresse IP de la distribution qui serait 172.28.38.112/20 :

<code>
172.28.38.112        pve      pve
</code>

  * Vérifiez que le fichier **/etc/resolv.conf** contient une ligne pour indiquer l'adresse IP du serveur de nom de (DNS) votre choix

<code>
nameserver 8.8.8.8
</code>

  * Consultez les logs : 

<code>
# log
journalctl -xe

# les services
systemctl status pve-cluster 
</code>





===== Exporter / importer / renommer la distribution pve =====

  * Exporter la distribution

<code shell>
wsl --export pve C:\chemin\vers\pve.tar
</code>

  * Désenregistrer l'ancienne distribution :

<code shell>
wsl --unregister pve
</code>

  * Importer la distribution avec un nouveau nom :

<code shell>
wsl --import nouveaupve C:\nouvel\emplacement C:\chemin\vers\pve.tar
</code>





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


====== Retour accueil Installer Proxmox avec WSL ======

  * [[reseau:cloud:proxmox:installwsl|Installer Proxmox avec WSL]]