mcp-wms-wiki/wiki/operations/vm-installation.md

title, type, sources, related, last_compiled

title	type	sources	related	last_compiled
VM Installation (Hyper-V) & Validation	operation	sources/archives/Installation_VM_Hyper-V.md sources/archives/Valider_sa_machine_virtuelle.md	architecture/overview.md operations/first-deployment.md operations/development-methodology.md operations/vm-network-routing.md operations/deploy-test-application.md	2026-04-17

VM Installation (Hyper-V) & Validation

Overview

Procédure interne Mecalux EasyWMS France pour créer et valider une machine virtuelle de développement sous Hyper-V. Chaque développeur dispose de sa propre VM locale (ou hébergée sur serveur), préparée à partir d'un template fourni par l'équipe, puis configurée pour être jointe au réseau Mecalux et permettre le déploiement d'un projet.

La VM sert de cible de déploiement pour :

• Le core EasyWMS (via script deploy_repository.ps1)
• La configuration entrepôt (via EasyS / uGNA)
• La custom application du projet (via EasyBuilder)
• Les services adjacents (GNA, Printer Service, EasySTS License, SmartUI, etc.)

Sources : Confluence EasyWMS France — Installation de la VM sur Hyper-V (v30, 02/12/2025) + Valider sa machine virtuelle (v7, 14/02/2023).

Prérequis

• Accès réseau au partage \\lyoitsw02\TEMPLATE\
• Rôle Hyper-V activé sur le poste (ou serveur Hyper-V disponible)
• Droits administrateur local

1. Récupérer le template de VM

1. Ouvrir \\lyoitsw02\TEMPLATE\ dans l'explorateur
2. Copier le dossier TEMPLATE_INTEGRATION_[DB] en local, par exemple dans D:\Hyper-V\DEV

Choix de la base de données selon le mode de déploiement cible en production :

Mode	BDD
SaaS	PostgreSQL
On-premise	Oracle

2. Création de la VM dans Hyper-V

Étape	Paramètre	Valeur
Génération	-	Génération 2 (toutes fonctionnalités)
Nom	Convention	DEV-<PRENOM> (ex : DEV-NICO)
RAM	Initiale	4 Go (4096 Mo) avec mémoire dynamique activée
Connexion réseau	Poste local	InternoNAT
Connexion réseau	Serveur	VMs
Disque dur	Source	Existant → win10ent.vhdx du dossier template

La convention DEV-<PRENOM> évite les interconnexions non désirées entre VM de différents développeurs.

3. Configuration post-création (dans Hyper-V)

Ne pas faire le paramétrage NAT si c'est une VM d'intégration.

Paramètre	Valeur	Raison
RAM dynamique max	6 Go (6144 Mo)	Éviter qu'Hyper-V dépasse la capacité du poste
Processeurs	4	Performances compilation / WMS
Points de contrôle	Activés	Snapshot "Deploy 0" après config initiale

4. Configuration réseau (dans la VM locale)

À faire uniquement sur VM locale. Sur VM hébergée sur serveur → passer à l'étape 5.

1. Windows + R → NCPA.CPL
2. Propriétés du réseau Ethernet → protocole IPv4
3. Saisir :
   • IP : 10.255.255.2
   • Masque : 255.255.255.0
   • Passerelle : 10.255.255.1
4. Advanced → DNS — saisir les 4 serveurs DNS Mecalux :
   • 192.168.0.102
   • 192.168.0.104
   • 192.168.0.56
   • 192.168.66.250
5. Suffixe DNS : mecalux.com

5. Renommer la VM (Windows)

1. Paramètres Windows → System → About (en bas du volet gauche)
2. "Rename this PC" — saisir le nom de la VM

⚠️ Avant redémarrage, mettre à jour les fichiers Oracle suivants (remplacer localhost par le nouveau nom) :

• tnsnames.ora
• listener.ora

Localisation selon template :

• Template Oracle 12 : C:\Mecalux\Motor\oracle\product\12.2.0\dbhome_1\network\admin
• Template Oracle 19 : C:\Mecalux\Motor\oracle\Product\19.17.0.0\dbhome_1\network\admin

⚠️ Pour les templates Oracle : nom limité à 15 caractères.

3. Redémarrer la VM

6. Installation des logiciels personnels

Avant le premier point de contrôle, installer ce qui est nécessaire :

• Git (obligatoire) — vérifier avec git --version ; à défaut : git-scm.com/download/win
• Éditeurs personnels (Sublime Text, VSCode, Notepad++…)
• SourceTree si absent du template (voir git-workflow)

7. Point de contrôle "Deploy 0"

Créer un point de contrôle "Deploy 0" — c'est le snapshot de référence à partir duquel un nouveau projet pourra être déployé (cf. first-deployment).

Entre deux projets, on applique ce point de contrôle pour repartir d'une VM propre.

Validation de la VM

Après le premier déploiement d'un projet sur la VM (cf. first-deployment), vérifier que l'installation est fonctionnelle.

1. Vérifier les services et IIS

1. Service Windows MongoDB démarré (sinon : démarrer)
2. IIS Manager — pour chacune des applications ci-dessous, Browse doit ouvrir la page sans erreur :
   • AD (Application Dictionary API)
   • ApplicationService
   • EasySTS (License)
   • SmartUI
   • SmartUIServices

ℹ️ Si IIS remonte "ne trouve pas localhost/<service>", c'est un problème IIS et pas forcément d'installation. Tester dans un navigateur depuis la VM sur localhost/smartui.

2. Accès depuis le PC physique

Si SmartUI fonctionne depuis la VM mais pas depuis le PC hôte :

1. Ouvrir C:\inetpub\wwwroot\SmartUI\script\config.js
2. Mettre la variable defaultURL à vide
3. Vérifier que les lignes standards sont bien présentes dans config.js (si la page reste bloquée sur le grand "M" de Mecalux)

3. Activer consoleRF (si besoin)

Si la connexion à consoleRF boucle sur l'input du nom d'utilisateur :

1. Aller sur https://<votre_vm>/SmartUIservices/home
2. Se connecter avec mecalux / mecalux
3. Parameters → chercher EnableLegacyRFMode
4. Activer sa 2e checkbox
5. Sauvegarder (bouton en bas à droite)

Common errors

• VM ne démarre pas / Génération 1 choisie par erreur → recréer la VM en Génération 2. La Génération 2 est requise pour disposer de toutes les fonctionnalités (secure boot, UEFI, disque VHDX).
• Conflits IP entre VM de devs différents → respecter la convention DEV-<PRENOM> et utiliser InternoNAT (pas le switch par défaut). Sur serveur, utiliser la connexion VMs.
• Oracle ne démarre pas après renommage → tnsnames.ora / listener.ora non mis à jour avec le nouveau hostname. Vérifier chemin selon version Oracle template.
• Nom de VM refusé par Oracle → dépasser 15 caractères sur template Oracle casse les services. Raccourcir le nom Windows.
• SmartUI inaccessible depuis le PC hôte → config.js → defaultURL doit être vide. Sinon SmartUI tente de joindre une URL relative au serveur de template.
• consoleRF boucle sur le login → activer EnableLegacyRFMode (2e checkbox) dans SmartUIservices/Parameters.
• localhost/<service> introuvable dans IIS → faux positif classique. Tester localhost/smartui dans un navigateur sur la VM avant de conclure.
• Mémoire dynamique > RAM du poste hôte → Hyper-V peut saturer l'hôte. Toujours borner la RAM dynamique max à 6 Go.

Related

• System Architecture Overview — stack IIS/ASP.NET Core/Oracle/PostgreSQL déployée sur la VM
• First Deployment — déploiement initial d'un projet sur une VM fraîchement créée
• Deploy Existing Application — redéploiement sur VM déjà préparée
• GNA, Services & License — installation des services adjacents (GNA, Printer, License WMS)
• Development Methodology — méthode de travail et stratégie de branches autour de la VM