mcp-wms-wiki/wiki/operations/deployment-existing-app.md

title, type, sources, related, last_compiled

title	type	sources	related	last_compiled
Deploy Existing Application	operation	sources/archives/Deploiement_application_existante.md	operations/vm-installation.md operations/first-deployment.md operations/deployment-specific-commit.md operations/custom-application-management.md operations/git-workflow.md operations/deploy-test-application.md	2026-04-17

Deploy Existing Application

Overview

Procédure de redéploiement d'un projet EasyWMS déjà initialisé sur une VM. À utiliser quand :

• Un nouveau développeur rejoint un projet en cours et doit préparer sa VM
• Un développeur applique un point de contrôle "Deploy 0" pour repartir d'une VM propre avant de travailler sur une autre branche
• Une mise à jour importante a été poussée sur le GIT et doit être redéployée
• On bascule d'une branche à une autre (ex : master → develop → branche de feature)

Elle ne couvre pas le premier déploiement d'un projet neuf (cf. first-deployment), ni le déploiement d'un commit figé (cf. deployment-specific-commit).

Source : Confluence EasyWMS France - Déploiement d'une application existante (v20, 04/07/2024).

Étape 1 - Vérifier env.secrets.yaml

Dans C:\deploy\env.secrets.yaml sur la VM, vérifier les paramètres BDD :

Oracle :

Paramètre	Valeur par défaut
Engine	Oracle
Server	localhost/orcl
Password (toutes BDD)	robmec

PostgreSQL :

Paramètre	Valeur par défaut
Engine	PostgreSQL
Server	localhost
Password (toutes BDD)	robmec

Étape 2 - Déploiement complet

Ouvrir PowerShell en administrateur dans C:\deploy de la VM (cd C:\deploy).

Par défaut le script cible la branche Master du GIT. Pour une autre branche, l'ajouter en 2ᵉ argument :

# Déploiement sur Master (défaut)
.\deploy_repository.ps1 NomDuProjetGit

# Déploiement sur une branche spécifique
.\deploy_repository.ps1 NomDuProjetGit Branche

Exemple :

.\deploy_repository.ps1 1707_FRANCE_MA_PIECES_AUTOS_BRETAGNE develop

ℹ️ D'après l'équipe Espagne, il devrait être possible de déployer n'importe quelle version depuis la 21.1.19.2 via ce script. En cas d'échec : ouvrir un ticket support.

En cas d'erreur : voir Confluence Installation machine virtuelle de développement, paragraphe "Deploy 1".

✅ Si aucune erreur : sauter étapes 3, 4, 5, 6. L'étape 7 reste obligatoire quoi qu'il arrive.

Étapes 3–6 (anciens scripts deploy.ps1)

À exécuter uniquement si le projet repose encore sur les anciens scripts (pas deploy_repository.ps1).

3 - Deploy 1 (Complete)

.\deploy.ps1   # choisir "1. Complete"

4 - Intégrer la config entrepôt (Load)

.\deploy.ps1   # choisir "2. Load"

Charge :

• Config entrepôt depuis C:\deploy\Config
• Paramètres uGNA depuis C:\deploy\Data

Alternative : EasyS → Transfert Data vers la VM.

5 - Assignation utilisateur

.\Commands\commands.ps1

Ou via SmartUI → Organisation → Utilisateurs → éditer mecalux → ajouter les sites autorisés.

6 - Import de l'application custom

Voir custom-application-management - Import.

Étape 7 - Désactiver les instances en BDD (OBLIGATOIRE)

⚠️ Sans cette étape, les instances ne fonctionneront pas - cette modification est requise à chaque redéploiement (le fichier Tenants.xml est régénéré).

Dans C:\inetpub\wwwroot\ApplicationService\Tenants.xml, remplacer :

<processStore name="TENANT ProcessStore" providerName="Oracle.ManagedDataAccess.Client" … />

par :

<processStore name="TENANT ProcessStore" providerName="InMemory" connectionString="MaxProcessInfoLogs=20;MaxProcessLogEntries=50"/>

Puis : iisreset ou recyclage du pool ApplicationService.

Astuce Notepad++ (multi-tenant)

Ctrl+H en mode Regular expression :

• Recherche : (<processStore name=")(.*)(ProcessStore.*$)
• Remplacement : <processStore name="\2ProcessStore" providerName="InMemory" connectionString="MaxProcessInfoLogs=20;MaxProcessLogEntries=50"/>

Checklist rapide

1. ✅ env.secrets.yaml cohérent avec la BDD template VM
2. ✅ deploy_repository.ps1 <Projet> [Branche] lancé en PowerShell admin
3. ✅ Tenants.xml → InMemory + iisreset (toujours)
4. ✅ Custom app importée si "anciens scripts" et que ce n'est pas le nouveau déploiement

Common errors

• Instances WMS ne démarrent pas après redéploiement → étape 7 oubliée. Obligatoire à chaque déploiement, même si tout semble OK.
• Script sort "repo non trouvé" → VM non connectée à internet (Zscaler), ou nom de projet erroné, ou branche inexistante.
• Version WMS < 21.1.19.2 → redéploiement peut échouer avec deploy_repository.ps1. Ouvrir un ticket ou repartir de zéro via first-deployment.
• deploy.ps1 inconnu → projet migré vers script unifié. Utiliser uniquement deploy_repository.ps1 et sauter étapes 3–6.
• Custom app manquante après déploiement → soit Customs: vide dans DeployConfig.yaml, soit (anciens scripts) étape 6 oubliée. Cf. custom-application-management.

Related

• VM Installation - pré-requis VM + validation
• First Deployment - à lire d'abord si le projet n'a jamais été déployé
• Deploy Specific Commit - variante pour cibler un commit figé plutôt qu'un HEAD de branche
• Custom Application Management - import/export de la custom app
• Git Workflow - sélection de la branche cible
• GNA, Services & License - réinstaller GNA après redéploiement si scripts BOO modifiés