màj wiki avec retour MES lot-5 AD

2026-05-20 09:41:27 +02:00
commit 23eb3f3c84
4106 changed files with 469381 additions and 0 deletions
@@ -0,0 +1,316 @@
+# Premier déploiement
+
+> Source : [Confluence EasyWMS France](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/3000088396042/Premier+d%C3%A9ploiement)  
+> 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 :
+
+```yaml
+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) :
+
+```yaml
+DBEngine: Oracle  # SQLServer, MySQL, Oracle, PostgreSQL
+```
+
+- **MAPSeed** — dernière version WMS [disponible ici](https://msscc.mecalux.com/documentation/documentation/master/EN/ReleaseNotes.md) :
+
+```yaml
+MAPSeed: 22.9.19.1  # Any version published on mapdeploy.mecalux.com
+```
+
+- **License** — doit être défini à `ENTERPRISE` :
+
+```yaml
+License: ENTERPRISE  # PRO, ADVANCE, ENTERPRISE
+```
+
+- **Warehouse** — chemin d'accès au fichier de configuration de l'entrepôt (normalement dans `layout_config`) :
+
+```yaml
+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`) :
+
+```yaml
+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`) :
+
+```yaml
+StandardApplications:  # The applications to install, listed with the same names as in the responses.xml
+    - SmartUI
+```
+
+<details>
+<summary>Exemple de responses.xml correspondant</summary>
+
+```xml
+<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>
+```
+
+</details>
+
+- **Customs** — laisser vide pour l'instant (sera renseigné à l'étape 10) :
+
+```yaml
+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.
+
+```yaml
+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
+```
+
+<details>
+<summary>Exemple de responses.xml correspondant</summary>
+
+```xml
+<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>
+```
+
+</details>
+
+- **Users** — laisser vide pour ne garder que l'utilisateur `mecalux` par défaut, ou définir des utilisateurs supplémentaires :
+
+```yaml
+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 :
+
+```powershell
+# 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` :
+
+```powershell
+.\deploy_repository.ps1 1707_FRANCE_MA_PIECES_AUTOS_BRETAGNE
+```
+
+> Plus de détails sur l'exécution du script : [Documentation Mecalux](https://mssdoc.mecalux.com/en_US/my_documentation/doc/ExternalProcedures/master/ProfessionalServices/TaskWorkBreakDownAndVerification/TaskWorkBreakdownAndVerification.md#md-deployscriptfordevelopmentenvironments)
+
+**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](https://git-scm.com/download/win)
+- Autres erreurs : consulter la page [Installation machine virtuelle de développement](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/2786690269319) 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 :
+
+```powershell
+.\deploy.ps1
+```
+
+Choisir **"1. Complete"**.
+
+> En cas d'erreur : consulter la page [Installation machine virtuelle de développement](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/2786690269319) 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 :
+
+```powershell
+.\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 :
+
+```powershell
+.\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 :
+
+```xml
+<processStore name="TENANT ProcessStore" providerName="Oracle.ManagedDataAccess.Client" … />
+```
+
+par :
+
+```xml
+<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](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/3000089673775/Gestion+de+la+custom+application#1---Cr%C3%A9ation-de-l%E2%80%99application-custom)
+
+---
+
+### 10 - Mettre à jour le fichier "DeployConfig.yaml"
+
+Ajouter le chemin de l'application custom dans le fichier **`DeployConfig.yaml`** (dossier `build` du projet GIT) :
+
+```yaml
+Customs:  # [OPTIONAL] Relative path to the custom applications exported as text
+    - NomApplication: chemin/du/dossier/GIT/de/lapplication
+```
+
+Exemple :
+
+```yaml
+Customs:
+    - CustomApplication: source/CustomApplication
+```