Mecalux/mcp-wms-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9ce6ae37be08c793547e04e9027dc911e638a911
mcp-wms-wiki/wiki/operations/vm-installation.md
T
arthur 9ce6ae37be lint(standard): corrections completes mode standard 
- Em dashes: 1712 remplaces par tirets simples (86 fichiers + _index.md,
  en-tete section Limagrain conserve)
- Checklists: 24 '- [ ]' -> '- ☐' (3 pages operations, plus de todos Obsidian)
- Ancres: 33 reparees (slugs GitHub + ancres HTML <a id> reconnues),
  1 reciblee (manuel de reten)
- related: tenseflow -> tense-flow, pie -> mechanical-elements,
  group.md retire (doublon shipping)
- Registre: compteur global 122 -> 131 pages
- Rapport racine _lint_report.md mis a jour (scan v2 + re-scan final: 0 anomalie)
- Aucun fichier limagrain/ modifie (cloisonnement)
2026-07-20 13:01:21 +02:00

7.7 KiB
Raw Blame History

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.

  1. 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

Reference in New Issue View Git Blame Copy Permalink