Mecalux/mcp-wms-wiki

Fork 0

Files

T

Arthur Ria 23eb3f3c84 màj wiki avec retour MES lot-5 AD

2026-05-20 09:41:27 +02:00

10 KiB

Raw Permalink Blame History

Premier déploiement

Source : Confluence EasyWMS France
Dernière mise à jour : 07/08/2025 (v39)

1 - Vérifier le fichier "DeployConfig.yaml"

Aller dans le dossier build du répertoire GIT du projet. Vous devez y trouver un fichier DeployConfig.yaml, sinon le télécharger et l'y placer.

Vérifier les champs suivants :

TenantName / TenantCode — nom et code de l'application souhaitée :

TenantName: MonNomProjet
TenantCode: MonCodeProjet

DBEngine — moteur de base de données (doit correspondre à celui défini dans env.secrets.yaml situé dans C:\deploy de la VM) :

DBEngine: Oracle  # SQLServer, MySQL, Oracle, PostgreSQL

MAPSeed — dernière version WMS disponible ici :

MAPSeed: 22.9.19.1  # Any version published on mapdeploy.mecalux.com

License — doit être défini à ENTERPRISE :

License: ENTERPRISE  # PRO, ADVANCE, ENTERPRISE

Warehouse — chemin d'accès au fichier de configuration de l'entrepôt (normalement dans layout_config) :

Warehouse: layout_config/MAPAB_layout.cfg2014  # [OPTIONAL] Relative path to the layout file

Data — chemin d'accès aux fichiers de configuration du WMS (normalement dans test) :

Data: test  # [OPTIONAL] Relative path to the folder that has the data for uGNA

StandardApplications — applications souhaitées selon l'analyse fonctionnelle (reprendre les entrées Use="Yes" de la balise <ExtraApps> du fichier responses.xml) :

StandardApplications:  # The applications to install, listed with the same names as in the responses.xml
    - SmartUI

Exemple de responses.xml correspondant

<ExtraApps>
    <Item Use="Yes" Name="SmartUI" ... />
    <Item Use="No" Name="AccountDirective" ... />
    <Item Use="No" Name="Billing" ... />
    <Item Use="No" Name="CashAndCarry" ... />
    <Item Use="No" Name="Dashboard" ... />
    <Item Use="No" Name="Deliveries" ... />
    <Item Use="No" Name="Ecommerce" ... />
    <Item Use="No" Name="ExternalDevices" ... />
    <Item Use="No" Name="GalileoFaults" ... />
    <Item Use="No" Name="LaborManagement" ... />
    <Item Use="No" Name="Manufacturing" ... />
    <Item Use="No" Name="OwnerExtensions" ... />
    <Item Use="No" Name="PalletShuttle" ... />
    <Item Use="No" Name="Sage200c" ... />
    <Item Use="No" Name="Slotting" ... />
    <Item Use="No" Name="TPLPortal" ... />
    <Item Use="No" Name="ValueAddedService" ... />
    <Item Use="No" Name="YardManagement" ... />
</ExtraApps>

Customs — laisser vide pour l'instant (sera renseigné à l'étape 10) :

Customs:  # [OPTIONAL] Relative path to the custom applications exported as text

EnaledModules — liste de tous les modules à activer (reprendre la balise <Modules> du responses.xml, sauf EasyWMS qui est inclus de base) :

⚠️ Problème connu sur les versions 24.xx.xx.xx : l'action "Importing apps with AD..." peut durer très longtemps et être suivie d'une erreur System.Management.Automation.RuntimeException. Dans ce cas, ajouter ToggleService à la liste.

EnabledModules:
    - SmartUI
    - AccountDirective
    - Billing
    - CashAndCarry
    - Dashboard
    - Deliveries
    - Ecommerce
    - GalileoFaults
    - LaborManagement
    - Manufacturing
    - MarketPlace
    - OwnerExtensions
    - PalletShuttle
    - Sage200c
    - SageX3
    - Slotting
    - TPLPortal
    - ValueAddedService
    - YardManagement
    - EDSService
    - ExternalDevices
    - GalileoDesigner
    - Gateway
    - GNA
    - PrinterService
    - PTLService
    - PalletShuttleService
    - VoicePicking
    - ToggleService  # Needed in version >24.XX.XX.XX

Exemple de responses.xml correspondant

<Modules>
    <Module Name="EasyWMS" LicenseLevel="ENTERPRISE" />
    <Module Name="SmartUI" LicenseLevel="ENABLED" />
    <Module Name="AccountDirective" LicenseLevel="ENABLED" />
    <Module Name="Billing" LicenseLevel="ENABLED" />
    <Module Name="CashAndCarry" LicenseLevel="ENABLED" />
    <Module Name="Dashboard" LicenseLevel="ENABLED" />
    <Module Name="Deliveries" LicenseLevel="ENABLED" />
    <Module Name="Ecommerce" LicenseLevel="ENABLED" />
    <Module Name="GalileoFaults" LicenseLevel="ENABLED" />
    <Module Name="LaborManagement" LicenseLevel="ENABLED" />
    <Module Name="Manufacturing" LicenseLevel="ENABLED" />
    <Module Name="MarketPlace" LicenseLevel="ENABLED" />
    <Module Name="OwnerExtensions" LicenseLevel="ENABLED" />
    <Module Name="PalletShuttle" LicenseLevel="ENABLED" />
    <Module Name="Sage200c" LicenseLevel="ENABLED" />
    <Module Name="SageX3" LicenseLevel="ENABLED" />
    <Module Name="Slotting" LicenseLevel="ENABLED" />
    <Module Name="TPLPortal" LicenseLevel="ENABLED" />
    <Module Name="ValueAddedService" LicenseLevel="ENABLED" />
    <Module Name="YardManagement" LicenseLevel="ENABLED" />
    <Module Name="EDSService" LicenseLevel="ENABLED" />
    <Module Name="ExternalDevices" LicenseLevel="ENABLED" />
    <Module Name="GalileoDesigner" LicenseLevel="ENABLED" />
    <Module Name="Gateway" LicenseLevel="ENABLED" />
    <Module Name="GNA" LicenseLevel="ENABLED" />
    <Module Name="PrinterService" LicenseLevel="ENABLED" />
    <Module Name="PTLService" LicenseLevel="ENABLED" />
    <Module Name="PalletShuttleService" LicenseLevel="ENABLED" />
    <Module Name="VoicePicking" LicenseLevel="ENABLED" />
</Modules>

Users — laisser vide pour ne garder que l'utilisateur mecalux par défaut, ou définir des utilisateurs supplémentaires :

Users:  # [OPTIONAL] "mecalux" user can be overwritten
    - UserName:
        Password: UserPassword
        Groups: SuperAdmin,Administrators,Managers,Operators

2 - Déplacer le fichier de config entrepôt

Placer le fichier de configuration de l'entrepôt EasyS dans le dossier layout_config du répertoire GIT du projet.

⚠️ Ne pas oublier de commit et push le répertoire Git.

3 - Vérifier le fichier "env.secrets.yaml" du dossier Deploy (sur la VM)

Vérifier les informations concernant la base de données utilisée sur le projet :

Paramètre	Valeur par défaut
`Engine`	`Oracle`
`Server`	`localhost/orcl`
`Password` (des différentes bases)	`robmec`

4 - Déploiement complet

Ouvrir PowerShell en administrateur dans le dossier Deploy de la VM et exécuter :

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

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

Exemple pour le projet Ma_Pieces_Autos_Bretagne :

.\deploy_repository.ps1 1707_FRANCE_MA_PIECES_AUTOS_BRETAGNE

Plus de détails sur l'exécution du script : Documentation Mecalux

Cas d'erreurs classiques :

VM non connectée à internet : lancer Internet Explorer pour se connecter à Zscaler.
- ⚠️ VPN désactivé si vous êtes au bureau. VPN actif en télétravail.
Git non installé sur la VM : https://git-scm.com/download/win
Autres erreurs : consulter la page Installation machine virtuelle de développement au paragraphe "Deploy 1".

✅ Sans erreur, vous pouvez sauter les étapes 5, 6 et 7.

5 - Deploy 1 (anciens scripts de deploy uniquement)

Ouvrir PowerShell en administrateur dans le dossier Deploy de la VM et exécuter :

.\deploy.ps1

Choisir "1. Complete".

En cas d'erreur : consulter la page Installation machine virtuelle de développement au paragraphe "Deploy 1".

6 - Intégrer la configuration d'entrepôt (anciens scripts de deploy uniquement)

Ouvrir PowerShell en administrateur dans le dossier Deploy de la VM et exécuter :

.\deploy.ps1

Choisir "2. Load".

Cela transfèrera :

La configuration entrepôt depuis C:\deploy\Config
Les paramètres exportés via uGNA depuis C:\deploy\Data

Il est également possible d'utiliser EasyS pour charger le fichier de config via un Transfert Data vers la VM.

7 - Assignation de l'utilisateur à l'entrepôt (anciens scripts de deploy uniquement)

Ouvrir PowerShell en administrateur dans C:\deploy et exécuter :

.\Commands\commands.ps1

Il est aussi possible de faire l'assignation via le WMS : dans SmartUI, aller dans "Organisation" → "Utilisateurs", sélectionner l'utilisateur (par défaut mecalux) et l'éditer pour ajouter les sites autorisés.

8 - Désactiver les instances stockées sur la base de données

Dans le fichier Tenants.xml situé dans C:\inetpub\wwwroot\ApplicationService, remplacer la ligne :

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

par :

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

Puis effectuer un redémarrage de l'application (iisreset ou recyclage du pool de l'ApplicationService).

⚠️ Sans cette modification, les instances ne fonctionneront pas.

9 - Créer l'application custom

Procéder à la création de l'application custom avec l'export sur le GIT.

Voir : Gestion de la custom application — Création

10 - Mettre à jour le fichier "DeployConfig.yaml"

Ajouter le chemin de l'application custom dans le fichier DeployConfig.yaml (dossier build du projet GIT) :

Customs:  # [OPTIONAL] Relative path to the custom applications exported as text
    - NomApplication: chemin/du/dossier/GIT/de/lapplication

Exemple :

Customs:
    - CustomApplication: source/CustomApplication

10 KiB Raw Permalink Blame History