Magic xpa – Configuration de l’IMM avec wsl

1.  Installer wsl

Afin d’installer wsl, vous devez exécuter la commande suivante :

wsl --update

Exécuter cette commande pour installer la version d’Ubuntu supportée par l’IMM.

wsl --install Ubuntu-22.04

Vous pouvez choisir par exemple « magic – magic » pour l’identifiant.

Ensuite, vous devez connaître l’adresse IP de l’instance wsl. Pour cela, vous devez installer net-tools :

sudo apt install net-tools

Ensuite, exécutez la commande suivante et récupérer la valeur de l’adresse IP de « eth0 », ici 172.21.76.111

ifconfig

2.  Installer MicroK8S

Exécuter cette commande pour installer MicroK8S :

sudo snap install microk8s --classic

sudo apt-get update
sudo apt-get install -yqq daemonize dbus-user-session fontconfig

sudo daemonize /usr/bin/unshare --fork --pid --mount-proc /lib/systemd/systemd --system-unit=basic.target

Exécuter la commande suivante dans une nouvelle invite de commande pour arrêter wsl et permettre la fin de la configuration :

wsl --shutdown

Ensuite, exécuter cette commande pour redémarrer wsl :

wsl

exec sudo nsenter -t $(pidof systemd) -a su - $LOGNAME

sudo snap install microk8s --classic

sudo microk8s status

Une fois MicroK8S installé, vous devez installer les modules d’extension microk8s.

Veuillez exécuter la commande suivant pour installer DNS :

sudo microk8s enable dns

Veuillez exécuter la commande suivant pour installer MetalLB :

sudo microk8s enable metallb

Lorsque le système demande une plage d’adresses IP, spécifiez là comme suit : <Adresse IP du WSL>-<Adresse IP du WSL>.

Une fois le MicroK8s installé, vous devrez également générer le fichier de configuration de Kubernetes (kubeconfig).
Ce fichier doit être copié sur le serveur Windows pour établir la connectivité et exécuter des commandes sur le cluster IMM fonctionnant sur la machine Linux.

Pour générer le fichier de configuration, exécutez la commande suivante à partir du serveur Linux

sudo microk8s config

Cette commande permet d’imprimer la configuration sur le terminal.
Copiez le contenu de l’écran et collez-le dans un fichier vierge que vous nommerez config.
Vous devrez copier ce fichier sur la machine Windows à l’emplacement <Drive>:\Users\<user>\.kube\.

Ensuite, vous devez ajouter l’entrée de l’adresse IP de la machine Linux au fichier hosts de la machine Windows.
Pour cela, accédez au dossier C:\Windows\System32\drivers\etc.
Ouvrez le fichier hosts dans ce dossier dans un éditeur de texte.
Ajoutez l’entrée dans le format suivant.
Le nom de domaine est le même que celui que vous avez fourni lors de l’installation de Magic xpi.
<Adresse IP du WSL> <Nom du domaine>
Exemple :
172.21.76.111 immxpa.com

3.  Mise en place de l’IMM

Ouvrez une nouvelle invite de commande et positionnez vous dans le dossier <Magic_xpa_Home>\InMemoryMiddleware\deploy\.

cd C:\MSE\Magicxpa411\InMemoryMiddleware\deploy

Exécuter la commande :

deploy-imm.bat

Remarque : si les fichiers (imm.crt, imm.key, imm.pem) sont présents dans InMemoryMiddleware\config, c’est que l’IMM est déployé à l’aide de HTTPS. Dans ce cas, accédez au moniteur et au tunnel IMM en utilisant HTTPS. Dans le cas contraire, l’IMM est déployé en HTTP.

Il vous sera demandé d’entrer les détails suivants :

• Entrez le nom de domaine. Par exemple, immxpa.com.
• Entrez le nom d’utilisateur et le mot de passe pour IMM DB et LOG DB.

Mettre à jour les fichiers .INI et .ENV avec l’adresse IP du wsl :
<Magic_xpa_home>\Magic.ini
ImmHost=<Nom du domaine>
<Magic_xpa_home>\Scripts\Config\mgreq.ini
IMM_HOST=http://<Nom du domaine>/immtunnel
<Magic_xpa_home>\InMemoryMiddleware\agent.env
IMM_HOST=<Nom du domaine>

Documentation de référence – Setting up IMM in WSL