mcp-wms-wiki/wiki/operations/vm-network-routing.md

title, type, sources, related, last_compiled

title	type	sources	related	last_compiled
VM Network Routing (NAT, Localhost, IP, VPN)	operation	sources/archives/Routage_vers_les_VM.md	operations/vm-installation.md operations/deploy-test-application.md	2026-04-17

VM Network Routing (NAT, Localhost, IP, VPN)

Overview

Référence des règles de routage réseau entre le PC hôte et la VM EasyWMS de développement (Hyper-V, commutateur InternoNAT). Lors de la création de la VM (vm-installation), un NAT est configuré pour rediriger certains ports du PC hôte vers la VM, afin de ne pas bloquer les ports applicatifs standards (80/443/3389/1521/445) côté PC.

Cette page décrit :

• La table de correspondance des ports (interne VM ↔ externe PC)
• Les modes d'accès (localhost depuis la VM, IP depuis un autre poste)
• Les passerelles VPN à utiliser depuis une délégation Europe

Source : Confluence EasyWMS France - Routage vers les VM (v7, 11/08/2023).

1. Tableau de correspondance NAT

Service	Port interne VM	Port externe PC n°1	Port externe PC n°2
HTTP	80	8080	8008
HTTPS	443	4430	4431
Connexion bureau à distance (RDP)	3389	33890	33891
Oracle	1521	15210	15211
SMB	445	4450	4451

Toute requête TCP reçue sur le PC hôte sur le port 8080 est redirigée vers 10.255.255.2:80 (l'IP fixe de la VM, cf. vm-installation). Le port externe n°2 sert quand on doit faire tourner deux VMs en parallèle sur le même hôte.

Commandes Windows utiles

Get-NetAdapter            # Liste tous les adaptateurs réseau
Get-NetNatStaticMapping   # Affiche les routes statiques NAT (PC ↔ VM)

2. Accès depuis la VM (en local)

Depuis l'intérieur de la VM, on utilise localhost + port interne, ou directement le DNS de la VM (sans port).

Cible	URL
EasyBuilder en HTTPS	localhost:4430
SmartUI via DNS	https://<nom_vm>/smartui/

Note : 4430 est le port externe NAT - depuis la VM, accéder via localhost:443 fonctionne aussi pour HTTPS interne. La doc Confluence donne localhost:4430 car la VM peut être interrogée via la machine hôte qui résout le NAT.

3. Accès depuis un autre PC

localhost et le DNS de la VM ne sont pas accessibles depuis un autre poste - il faut utiliser l'IP du PC hôte suivie du port externe NAT.

Récupérer son IP

Option A - Paramètres Windows :

1. Clic droit sur l'icône réseau dans la barre des tâches
2. "Ouvrir les paramètres réseau et Internet"
3. "Propriétés" de l'adaptateur Ethernet
4. Récupérer l'adresse IPv4

Option B - PowerShell :

ipconfig

Récupérer l'IPv4 de l'adaptateur Ethernet.

Exemples d'accès distants

Cible	URL exemple (IP 192.168.164.214)
EasyBuilder HTTPS	192.168.164.214:4430
EasyS HTTPS	192.168.164.214:4430
SmartUI	192.168.164.214:4430/smartui
Bureau à distance (RDP)	192.168.164.214:33890

Pour que SmartUI s'affiche correctement depuis le PC hôte, il faut aussi avoir vidé defaultURL dans SmartUI\script\config.js (cf. vm-installation - Validation).

4. Utilisation avec le VPN Mecalux

Note Espagne : délégations Europe (sauf Gijón) → utiliser Europe 4 ou Europe uniquement via SSL.

Passerelle	Adresse	Port
Europe	vpn-europa@mecalux.com	4443
Europe 4	vpn-europa4@mecalux.com	443

Conflits VPN connus

Si la connexion VPN échoue malgré tout, vérifier la présence de ZAPP ou Zscaler APP sur la machine physique :

1. Désinstaller ZAPP / Zscaler APP
2. Redémarrer le poste
3. Réessayer la connexion

Si le problème persiste, envoyer un mail à it@mecalux.com avec l'objet :

No Hyper-V NAT connectivity

Common errors

• SmartUI accessible depuis la VM mais pas depuis le PC hôte → vérifier defaultURL (vide) dans SmartUI\script\config.js côté VM (cf. vm-installation).
• EasyBuilder en HTTPS répond connexion refusée sur :4430 → règle NAT manquante ou commutateur InternoNAT mal sélectionné lors de la création de la VM. Vérifier Get-NetNatStaticMapping.
• Connexion RDP impossible depuis un autre poste → utiliser le port externe 33890, pas 3389 (3389 n'est pas redirigé sur le PC hôte).
• VPN Europe répond mais aucune VM accessible → ZAPP / Zscaler installé : désinstaller + redémarrer.
• Pas d'accès aux URL Mecalux et VPN OK → ouvrir un ticket No Hyper-V NAT connectivity à it@mecalux.com.

Related

• VM Installation (Hyper-V) & Validation - création de la VM, IP fixe 10.255.255.2, commutateur InternoNAT
• Deploy Test Application - déploiement d'une livraison sur la VM de test (utilise ces accès réseau)