OPALE - 10.0 - Migration - Process de migration
Différence entre versions
(7 révisions intermédiaires par 4 utilisateurs non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
− | + | <languages /> | |
<translate> | <translate> | ||
==Introduction== <!--T:1--> | ==Introduction== <!--T:1--> | ||
<!--T:2--> | <!--T:2--> | ||
− | Cet article décrit le processus permettant de mettre à niveau OPALE Server sur un serveur | + | Cet article décrit le processus permettant de mettre à niveau OPALE Server sur un serveur IBM i. Cette procédure s'applique également à une mise à niveau vers M-PS 7.2. |
== Déroulement de la mise à jour == <!--T:3--> | == Déroulement de la mise à jour == <!--T:3--> | ||
Ligne 40 : | Ligne 40 : | ||
- Avoir un fichier PDF et/ou .dmp du fichier à imprimer pour chacun des ses documents<br /> | - Avoir un fichier PDF et/ou .dmp du fichier à imprimer pour chacun des ses documents<br /> | ||
- Définir les règles stratégiques mises en place sur l'environnement de production<br /> | - Définir les règles stratégiques mises en place sur l'environnement de production<br /> | ||
− | - Rassembler les différents fichiers spool | + | - Rassembler les différents fichiers spool IBM i(dans une outq: MAPREF/MAPQUALREF) ainsi que leurs Mapping de sortie d'impression (PCL, ZPL, TEC, etc) correspondants générés avec la version actuelle de Mapping sur le serveur de production. |
<!--T:12--> | <!--T:12--> | ||
Ligne 101 : | Ligne 101 : | ||
===Type SIMPLE : Copie simple de maquettes=== <!--T:28--> | ===Type SIMPLE : Copie simple de maquettes=== <!--T:28--> | ||
− | Ce type consiste à une simple copie de fichiers ressources | + | Ce type consiste à une simple copie de fichiers ressources IBM i afin de copier les formats Designer et Connect ainsi que les règles et relations entre Outqs. Les maquettes ne sont pas regénérées. |
− | ====Etape 1 : Copie des formats Designer==== <!--T:29--> | + | ====Etape 1 : Copie des formats Designer et Connect==== <!--T:29--> |
<u>Fichiers à copier de MAPPINGCPY vers MAPPINGQUA</u> : | <u>Fichiers à copier de MAPPINGCPY vers MAPPINGQUA</u> : | ||
=====Copie de certains formats===== | =====Copie de certains formats===== | ||
Ligne 111 : | Ligne 111 : | ||
S'il y a beaucoup de formats et que nous voulons tout prendre, nous pouvons copier les fichiers physiques (MAPLNK, MAPLNKL1, MAPOBJ, MAP1, MAP2D, MAP2H, MAP3, MAP3L1, MAP) | S'il y a beaucoup de formats et que nous voulons tout prendre, nous pouvons copier les fichiers physiques (MAPLNK, MAPLNKL1, MAPOBJ, MAP1, MAP2D, MAP2H, MAP3, MAP3L1, MAP) | ||
− | =====Procédure pour copier les fichiers concernant les Formats M-Designer===== <!--T:31--> | + | =====Procédure pour copier les fichiers concernant les Formats M-Designer et M-Connect===== <!--T:31--> |
<!--T:32--> | <!--T:32--> | ||
Ligne 172 : | Ligne 172 : | ||
Option 3 devant MAP3L1 | Option 3 devant MAP3L1 | ||
Dans la bibliothèque : MAPPINGQUA | Dans la bibliothèque : MAPPINGQUA | ||
+ | |||
+ | <u>Remplacement de l'ancien MAPRPTDBC par le nouveau</u> | ||
+ | strpdm | ||
+ | Option 2 | ||
+ | Bibliothèque : MAPPINGCPY | ||
+ | Nom : MAPRPTDBC | ||
+ | Option 3 devant MAPRPTDBC | ||
+ | Dans la bibliothèque : MAPPINGQUA | ||
+ | Suppression de l'objet existant : O | ||
+ | |||
+ | <u>Remplacement de l'ancien MAPRPTDBF par le nouveau</u> | ||
+ | strpdm | ||
+ | Option 2 | ||
+ | Bibliothèque : MAPPINGCPY | ||
+ | Nom : MAPRPTDBF | ||
+ | Option 3 devant MAPRPTDBF | ||
+ | Dans la bibliothèque : MAPPINGQUA | ||
+ | Suppression de l'objet existant : O | ||
+ | |||
+ | <u>Remplacement de l'ancien MAPRPTDBL par le nouveau</u> | ||
+ | strpdm | ||
+ | Option 2 | ||
+ | Bibliothèque : MAPPINGCPY | ||
+ | Nom : MAPRPTDBL | ||
+ | Option 3 devant MAPRPTDBL | ||
+ | Dans la bibliothèque : MAPPINGQUA | ||
+ | Suppression de l'objet existant : O | ||
+ | |||
+ | <u>Remplacement de l'ancien MAPRPTDBW par le nouveau</u> | ||
+ | strpdm | ||
+ | Option 2 | ||
+ | Bibliothèque : MAPPINGCPY | ||
+ | Nom : MAPRPTDBW | ||
+ | Option 3 devant MAPRPTDBW | ||
+ | Dans la bibliothèque : MAPPINGQUA | ||
+ | Suppression de l'objet existant : O | ||
<!--T:40--> | <!--T:40--> | ||
Ligne 185 : | Ligne 221 : | ||
<!--T:41--> | <!--T:41--> | ||
− | Répéter l'opération pour les objets suivants : MAP1, MAP2D, MAP2H, MAP | + | Répéter l'opération pour les objets suivants : MAP1, MAP2D, MAP2H, MAP, MAPLOAD |
− | ====Etape 2 : Copie du paramétrage des OUTQ==== <!--T:42--> | + | ====Etape 2 : Copie du paramétrage des OUTQ (Définir les paramètres imprimantes)==== <!--T:42--> |
<!--T:43--> | <!--T:43--> | ||
Ligne 291 : | Ligne 327 : | ||
<!--T:67--> | <!--T:67--> | ||
− | Le type de fichier en entrée est paramétré grâce au paramètre XXXXXXXXXXXXXX | + | Le type de fichier en entrée est paramétré grâce au paramètre XXXXXXXXXXXXXX. |
<!--T:68--> | <!--T:68--> | ||
− | Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY | + | Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY. |
====Etape 2 : Copie du paramétrage des OUTQ==== <!--T:69--> | ====Etape 2 : Copie du paramétrage des OUTQ==== <!--T:69--> | ||
Ligne 383 : | Ligne 419 : | ||
<!--T:86--> | <!--T:86--> | ||
A savoir : Les chemins devront être changés en fonction de votre contexte | A savoir : Les chemins devront être changés en fonction de votre contexte | ||
− | Le type de fichier en entrée est paramétré grace au paramètre XXXXXXXXXXXXXX | + | Le type de fichier en entrée est paramétré grace au paramètre XXXXXXXXXXXXXX |
− | Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY | + | Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY |
Version actuelle datée du 23 mars 2021 à 17:11
Sommaire
- 1 Introduction
- 2 Déroulement de la mise à jour
- 3 Prérequis client
- 4 Prise en main de l'environnement de client
- 5 Installation
- 6 Paramétrage de l'environnement (selon le type de migration choisi)
- 6.1 Type SIMPLE : Copie simple de maquettes
- 6.1.1 Etape 1 : Copie des formats Designer et Connect
- 6.1.2 Etape 2 : Copie du paramétrage des OUTQ (Définir les paramètres imprimantes)
- 6.1.3 Etape 3 : Copie des règles et actions
- 6.1.4 Etape 4 : Copie des données de l'IFS
- 6.1.5 Etape 5 : Reconstruction du LSTOBJ.TXT
- 6.1.6 Etape 6 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)
- 6.1.7 Gestion des bugs sur un document
- 6.2 Type avancé: Régénération systématique des maquettes (dans le langage d'origine)
- 6.2.1 Étape 1 : Régénération des projets Designer
- 6.2.2 Etape 2 : Copie du paramétrage des OUTQ
- 6.2.3 Etape 3 : Copie des règles et action
- 6.2.4 Étape 4 : Copie des données de l'IFS
- 6.2.5 Étape 5 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)
- 6.2.6 Gestion des bugs sur un document
- 6.3 Type AVANCÉ XPS: Passage en XPS de toutes les maquettes
- 6.3.1 Etape 1 : Régénération des projets Designer
- 6.3.2 Etape 2 : Copie du paramétrage des OUTQ
- 6.3.3 Etape 3 : Copie des règles et action
- 6.3.4 Etape 4 : Copie des données de l'IFS
- 6.3.5 Etape 5 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)
- 6.3.6 Gestion des bugs sur un document
- 6.4 Gestion des cas particulier
- 6.1 Type SIMPLE : Copie simple de maquettes
- 7 Phase de tests
- 8 Validation
- 9 Passage en production
- 10 Retour arrière en cas de problème
- 11 Troubleshooting
Introduction
Cet article décrit le processus permettant de mettre à niveau OPALE Server sur un serveur IBM i. Cette procédure s'applique également à une mise à niveau vers M-PS 7.2.
Déroulement de la mise à jour
Cette présente procédure considère que l'environnement de production que nous voulons migrer se trouve dans une bibliothèque nommée MAP400.
Le déroulement de la mise à jour d'OPALE Server se compose des points suivants :
- Installation d'un environnement de développement (avec version de destination OPALE Server)
- Copie du paramétrage de l'environnement de production sur l'environnement de développement
- Création d'une OUTQ monitorée par Mapping + modification des règles éventuelles pour modification des routages d'impressions (Optionnel)
- Déroulement des tests
- Passage en production
- Rollback en cas de problème
- Troubleshooting
Toute modification de maquette (lié à une modification souhaitée ou un delta suite à la mise à jour) sera alors réalisée avec un Designer ayant la même version qu'OPALE Server et en UNICODE.
Prérequis client
Profil utilisateur
- Avoir accès au profil QSECOFR pour l'installation du produit
Eléments à rassembler
Le client doit avoir une bonne connaissance de leur environnement. Pour cela, il devra être capable de :
- Définir les documents clés devant être testés par MAPPING ou un de leurs partenaires certifiés
- Connaitre et retrouver les fichiers spools bruts pour chacun des ses documents
- Retrouver les projets Designer(.mpi, mpp et mpw) pour chacun de ces documents ainsi que leurs composants éventuels
- Avoir un fichier PDF et/ou .dmp du fichier à imprimer pour chacun des ses documents
- Définir les règles stratégiques mises en place sur l'environnement de production
- Rassembler les différents fichiers spool IBM i(dans une outq: MAPREF/MAPQUALREF) ainsi que leurs Mapping de sortie d'impression (PCL, ZPL, TEC, etc) correspondants générés avec la version actuelle de Mapping sur le serveur de production.
Important : Les polices utilisées doivent être au format TTF (toutes autres types de polices devront être remplacés par des polices TTF par le client)
Tous les fichiers sources "Windows" devront être classés dans des répertoires de façon méthodique : Un répertoire par document
Remarque : Un chiffrage d'upgrade pourra alors être réalisé par MAPPING.
ATTENTION : Si ce prérequis n'est pas respecté, un audit pourra être réalisé par Mapping ou un partenaire certifié Mapping pour reprendre la main sur l'environnement et en identifier tous les éléments importants.
Prise en main de l'environnement de client
Mapping ou Partenaire certifié Mapping : Prendre connaissance de l'environnement du client
- Vérifier si MAPPING est configuré en UNICODE ou non UNICODE : Option 14/1
- Regarder le type de règles et d'actions utilisées par le client
- Regarder le nom de société renseigné dans les paramètres (Option 14/1) et remettre le même nom dans la future bibliothèque de test
- Valider que la configuration (Option 14/1) soit la même sur MAPPINGQUA que MAP400 (hormis les chemins IFS)
- Vérifier les paramètres de MAPSND (Menu MapSend option 1)
Installation
Copie de l'environnement de production
Avant toute chose, faire une copie de la bibliothèque de production du client. Toute manipulation de données de l'environnement de production se fera à travers cette copie : MAPPINGCPY
CPYLIB FROMLIB(MAP400) TOLIB(MAPPINGCPY)
Le but de ces noms différents étant d'éviter des erreurs de manipulation en confondant MAP400 avec par exemple MAP400CPY. C'est pour cela que le nom MAPPINGCPY a été choisi. Toute manipulation avec les objets de production devra être faite au travers de MAPPINGCPY et non MAP400.
Récupérer le dernier Setup disponible
Récupérer le dernier setup mis à disposition par Mapping.
Installer le produit dans une nouvelle bibliothèque
Installer la nouvelle version d'OPALE Server: Installation OPALE Server
ATTENTION : NE PAS GARDER MAP400 en bibliothèque d'installation lors de la mise à jour
- Nom de la bibliothèque : MAPPINGQUA
- Nom du sous système : MAPSQUAL
- Arborescence IFS: "/home/MAPQUAL/mapping" (mapsend,mapreport,mapout)
Paramétrage de l'environnement (selon le type de migration choisi)
Quel que soit le type de migration choisi (listé ci-dessous), les tests doivent être réalisés sur l'environnement nouvellement installé : MAPPINGQUA.
En aucun cas l'environnement de production (ex : MAP400) ne doit être modifié. L'environnement de production devra rester intact durant toute la migration et au-delà.
Type SIMPLE : Copie simple de maquettes
Ce type consiste à une simple copie de fichiers ressources IBM i afin de copier les formats Designer et Connect ainsi que les règles et relations entre Outqs. Les maquettes ne sont pas regénérées.
Etape 1 : Copie des formats Designer et Connect
Fichiers à copier de MAPPINGCPY vers MAPPINGQUA :
Copie de certains formats
Copier les formats de MAPPINGCPY vers MAPPINGQUA (Option 3 puis 3/Copier Formats Designer)
Copie de tous les formats d'un seul coup
S'il y a beaucoup de formats et que nous voulons tout prendre, nous pouvons copier les fichiers physiques (MAPLNK, MAPLNKL1, MAPOBJ, MAP1, MAP2D, MAP2H, MAP3, MAP3L1, MAP)
Procédure pour copier les fichiers concernant les Formats M-Designer et M-Connect
Cas particulier du MAPLNK/MAPLNKL1 :
Suppression de l'ancien objet MAPLNKL1 avant la copie du MAPLNK strpdm Option 2 Bibliothèque : MAPPINGQUA Nom : MAPLNKL1 Option 4 pour supprimer MAPLNKL1
Remplacement de l'ancien MAPLNK par le nouveau strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPLNK Option 3 devant MAPLNK Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Copie du nouveau MAPLNKL1 une fois le MAPLNK copié strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPLNKL1 Option 3 devant MAPLNKL1 Dans la bibliothèque : MAPPINGQUA
Cas particulier du MAP3/MAP3L1 :
Suppression de l'ancien objet MAP3L1 avant la copie du MAP3 strpdm Option 2 Bibliothèque : MAPPINGQUA Nom : MAP3L1 Option 4 pour supprimer MAP3L1
Remplacement de l'ancien MAP3 par le nouveau strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAP3 Option 3 devant MAP3 Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Copie du nouveau MAP3L1 une fois le MAP3 copié strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAP3L1 Option 3 devant MAP3L1 Dans la bibliothèque : MAPPINGQUA
Remplacement de l'ancien MAPRPTDBC par le nouveau
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPRPTDBC Option 3 devant MAPRPTDBC Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Remplacement de l'ancien MAPRPTDBF par le nouveau
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPRPTDBF Option 3 devant MAPRPTDBF Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Remplacement de l'ancien MAPRPTDBL par le nouveau
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPRPTDBL Option 3 devant MAPRPTDBL Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Remplacement de l'ancien MAPRPTDBW par le nouveau
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPRPTDBW Option 3 devant MAPRPTDBW Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Cas générique des autres objets :
Copie du nouveau MAPOBJ strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPOBJ Option 3 devant MAPOBJ Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Répéter l'opération pour les objets suivants : MAP1, MAP2D, MAP2H, MAP, MAPLOAD
Etape 2 : Copie du paramétrage des OUTQ (Définir les paramètres imprimantes)
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPOUTQ Option 3 devant MAPOUTQ Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Etape 3 : Copie des règles et actions
Copier les fichiers physiques MAPPINGCPY/SPLMAP, ACTLIG et ACTION (pas OUTOUT) dans la bibliothèque MAPPINGQUA
Copie du nouveau SPLMAP
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : SPLMAP Option 3 devant SPLMAP Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Répéter l'opération pour les objets suivants : SPLMAP, ACTLIG, ACTION
Etape 4 : Copie des données de l'IFS
- Copier dans le répertoire "/home/MAPQUAL/mapping/docPC/M-Designer_BACKUP_VersionMPSixxxx/" tous les différents projets M-Designer pour conserver la version d'origine. (remplacer le xxxx par la numéro de version MPS-i)
- Copier dans le répertoire "home/MAPQUAL/mapping/ttf/" le contenu de "home/mapping/ttf/"
- Copier dans le répertoire "/home/MAPQUAL/mapping/lgobitmap/" le contenu de "/home/mapping/lgobitmap"
Etape 5 : Reconstruction du LSTOBJ.TXT
Lancer la commande :
CALL MAP_823
Etape 6 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)
Si non réalisé, les commandes de tests devront être lancées en interactif
- OutqName: MAPQUALIN
- DATAQ: DTAQUAL
- LIB: MAPPINGQUA
- Imprimante par défaut: “A définir avec le client”
Gestion des bugs sur un document
Aucun bug détecté
Rien de particulier. Il faudra bien que le client range leurs fichiers sources Designer (mpi, mpp et mpw) de façon à les retrouver façilement.
Conseil : Créer un répertoire par maquette avec le spool d'entrée en PAG ou XML (selon si c'est un fichier texte paginé ou XML)
Gestion des bugs détectés
Le projet Designer devra être regénéré avec la dernière version Designer adapté à la version du serveur (Opale, 7.2).
Il pourra être regénéré en Unicode ou en Non Unicode (selon configuration du client).
A ce moment-là, nous avons deux choix possibles :
1. La regénération résoud le bug (avec ou sans modification de la maquette)
Rien d'autre n'est nécessaire. Il faudra juste bien classer les fichiers sources du projet (mpi, mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.
2. La regénération ne résoud pas le bug
Dans ce cas-là, il faudra passer le document en UNICODE :
- Génération en Unicode (code page 1200)
- Exécution de la maquette en UNICODE sur le serveur
Si ceci corrige le problème, il ne faut rien faire de plus.
Sinon, un ticket devra être ouvert auprès du support MAPPING.
Attention : La correction se fera uniquement en UNICODE.
Type avancé: Régénération systématique des maquettes (dans le langage d'origine)
Ce type consiste à une régénération systématique de toutes les maquettes (En UNICODE : Code page 1200 sur Designer). Uniquement la copie des fichiers ressources pour les règles et relations entre Outqs sera réalisée.
Étape 1 : Régénération des projets Designer
- Installer le dernier setup de Designer correspondant à la version de votre nouvelle installation du serveur
- Ouvrir chaque maquette et la générer manuellement en code page 1200 sur le nouveau serveur
Remarque : Il est possible d'automatiser la génération des maquettes grâce à un script.
Pour cela, il faut :
- Identifier pour chaque projet, leur type de fichier en entrée (XML et SPOOL) et leur langage de génération (PCL,ZPL,etc) et les ranger dans des dossiers séparés par langage de génération ET type de fichier en entrée
- Exécuter le script suivant qui permettra de lancer automatiquement la génération :
for %%X in ("C:\MAPPING\M-Processing Server\Import\docpc\*.mpp") do ("C:\MAPPING\M-Designer\M-Designer.exe" "-Generate" "-ProjectFile:%%X" "-Hide")
À savoir : Les chemins devront être changés en fonction du contexte.
Le type de fichier en entrée est paramétré grâce au paramètre XXXXXXXXXXXXXX.
Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY.
Etape 2 : Copie du paramétrage des OUTQ
Fichiers à copier de MAPPINGCPY vers MAPPINGQUA :
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPOUTQ Option 3 devant MAPOUTQ Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Etape 3 : Copie des règles et action
Copier les fichiers physiques MAPPINGCPY/SPLMAP, ACTLIG et ACTION (pas OUTOUT) dans la bibliothèque MAPPINGQUA
Copie du nouveau SPLMAP
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : SPLMAP Option 3 devant SPLMAP Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Répéter l'opération pour les objets suivants : SPLMAP, ACTLIG , ACTION
Étape 4 : Copie des données de l'IFS
- Copier dans le répertoire "/home/MAPQUAL/mapping/docPC/M-Designer_BACKUP_VersionMPSixxxx/" tous les différents projets M-Designer pour conserver la version d'origine. (remplacer le xxxx par la numéro de version MPS-i)
- Copier dans le répertoire "/home/MAPQUAL/mapping/lgobitmap/" le contenu de "/home/mapping/lgobitmap"
Étape 5 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)
Si cette étape n'est pas réalisée, les commandes de test devront être lancées en interactif
- OutqName: MAPQUALIN
- DATAQ: DTAQUAL
- LIB: MAPPINGQUA
- Imprimante par défaut: “à définir avec le client”
Gestion des bugs sur un document
Aucun bug détecté
Le client pourra continuer d'utiliser le document tel quel.
Gestion des bugs détectés
Selon le problème :
- alignements de zones : Modifier la maquette pour que l'alignement de zone soit OK en preview. Valider que le document final (imprimé, PDF, etc) soit cohérent par rapport à la preview
- Code barre :
- Problèmes d'alignements : Vérifier la preview sur la maquette et corriger la maquette si besoin
- Problème de labélisation : Cocher ou décocher le label du code barre (propriétés de la zone Code barre)
- A compléter
A ce moment là, nous avons deux choix possibles :
- Les corrections de la maquette corrige bien les problèmes (Preview et sortie cohérents) : Rien d'autre n'est à faire.
Rien d'autre n'est nécessaire. Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.
- Les modifications de la maquette ne sont pas concluantes.
Un ticket devra être ouvert au support MAPPING.
.
Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.
Attention : La correction se fera uniquement en UNICODE.
Type AVANCÉ XPS: Passage en XPS de toutes les maquettes
Ce type consiste au passage systématique de toutes les maquettes en XPS (En UNICODE : Code page 1200 sur Designer + Génération XPS). Uniquement la copie des fichiers ressources pour les règles et relations entre Outqs sera réalisée.
Etape 1 : Régénération des projets Designer
- Installer le dernier setup de Designer (correspondant à la version de votre nouvelle installation du serveur)
- Ouvrez chaque maquette et générer manuellement en code page 1200 en XPS sur le nouveau serveur
Remarque: Il est possible de scripter leurs générations. Pour cela, il faut:
- identifier pour chaque projet, leur type de fichier en entrée (XML et SPOOL) et leur langage de génération (PCL,ZPL,etc) et les ranger dans des dossiers séparés par langage de génération ET type de fichier en entrée
- Exécuter le script suivant qui permettra de lancer automatiquement la génération
for %%X in ("C:\MAPPING\M-Processing Server\Import\docpc\*.mpp") do ("C:\MAPPING\M-Designer\M-Designer.exe" "-Generate" "-ProjectFile:%%X" "-Hide")
A savoir : Les chemins devront être changés en fonction de votre contexte Le type de fichier en entrée est paramétré grace au paramètre XXXXXXXXXXXXXX Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY
Etape 2 : Copie du paramétrage des OUTQ
Fichiers à copier de MAPPINGCPY vers MAPPINGQUA :
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : MAPOUTQ Option 3 devant MAPOUTQ Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Etape 3 : Copie des règles et action
Copier les fichiers physiques MAPPINGCPY/SPLMAP, ACTLIG et ACTION (pas OUTOUT) dans la bibliothèque MAPPINGQUA
Copie du nouveau SPLMAP
strpdm Option 2 Bibliothèque : MAPPINGCPY Nom : SPLMAP Option 3 devant SPLMAP Dans la bibliothèque : MAPPINGQUA Suppression de l'objet existant : O
Répéter l'opération pour les objets suivants : SPLMAP, ACTLIG , ACTION
Etape 4 : Copie des données de l'IFS
- Copier dans le répertoire "/home/MAPQUAL/mapping/docPC/M-Designer_BACKUP_VersionMPSixxxx/" tous les différents projets M-Designer pour conserver la version d'origine. (remplacer le xxxx par la numéro de version MPS-i)
- Copier dans le répertoire "/home/MAPQUAL/mapping/lgobitmap/" le contenu de "/home/mapping/lgobitmap"
Etape 5 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)
Si non réalisé, les commandes de tests devront être lancées en interactif
- OutqName: MAPQUALIN
- DATAQ: DTAQUAL
- LIB: MAPPINGQUA
- Imprimante par défaut: “A définir avec le client”
Gestion des bugs sur un document
Aucun bug détecté
Le client pourra continuer d'utiliser leur document tel quel.
Gestion des bugs détectés
Selon le problème :
- alignements de zones : Modifier la maquette pour que l'alignement de zone soit OK en preview. Valider que le document final (imprimé, PDF, etc) soit cohérent par rapport à la preview
- Code barre :
- Problèmes d'alignements : Vérifier la preview sur la maquette et corriger la maquette si besoin
- Problème de labélisation : Cocher ou décocher le label du code barre (propriétés de la zone Code barre)
- A compléter
A ce moment là, nous avons deux choix possibles :
- Les corrections de la maquette corrige bien les problèmes (Preview et sortie cohérents) : Rien d'autre n'est à faire.
Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.
- Les modifications de la maquette ne sont pas concluantes.
Un ticket devra être ouvert au support MAPPING.
.
Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.
Attention : La correction se fera uniquement en UNICODE.
Gestion des cas particulier
Les 3 types définis ci-dessus sont de façon générale toujours vrai. Cependant il peut exister quelques cas particuliers :
Passage partiel en XPS
Pour plusieurs raison, un client peut passer en XPS uniquement sur quelques documents. Voici quelques besoins pouvant nécessité cela :
- Simplifier la gestion des maquettes pour un document donné car celui-ci a trop de maquette (La maquette en XPS pouvant gérer tous les langages)
- Besoin de post traitement plus important pour un document :
- Fusion du document avec d'autres documents Mapping ou autres
- Conversion d'un flux vers un autre (PDF vers XPS et ensuite concaténation avec un autre document par exemple)
- Autres
Utilisation de flux thermique (Zebra, TEC)
Il est fortement conseillé par Mapping de passer les maquettes thermiques en XPS. Les raisons principales sont :
- Aperçu Designer et impression finale bien plus fiable en XPS qu'en natif
- XPS to TEC ou ZPL plus fiable et intuitif en XPS
Phase de tests
Cas des tests exécutés de façon interactive
Le principe est d'exécuter chaque commande manuellement pour chacun des spooled files et chacune des maquettes à tester.
Cas des tests exécutés de façon automatiques
Le principe est de déposer les spooled files d'entrée dans l'outq test d'entrée. Le robot récupèrera alors les spooled files et éxécutera les bonnes commandes paramétrées dans le robot Mapping. Dans ce cas, il faut bien s'assurer que l'Outq d'entrée soit bien paramétrée et que l'imprimante par défaut soit bien renseigné dans les règles.
- Aller sur les règles utilisées pour tester et choisir l'imprimante de test (Option 14, 3 et 8)
- Copier les fichiers spool d'entrée du client un par un dans l'output queue Mapping monitorée et vérifier les résultats par rapport aux fichiers de référence.
Validation
La mise à niveau finale de l'environnement de production sera réalisée lorsque le client aura validé à l'écrit tous les documents.
Passage en production
Une fois la validation client réalisée, il est temps de passer en production. Le principe est de faire une autre installation et d'utiliser cette nouvelle bibliothèque comme bibliothèque de production. De ce fait, nous ne touchons pas à l'ancienne bibliothèque de production, ce qui pourrait être très utile en cas de besoin de retour arrière si un problème survient sur le nouvel environnement de production.
- Copier la bibliothèque de production MAP400 en MAPPRODCPY
- Lancer le setup de la nouvelle version en spécifiant MAP400_XX pour bibliothèque d'installation et MAPSRBT_XX (avec XX le numéro de version : 71,72 ou OP Exemple : MAP400_OP et MAPSRBT_OP)
ATTENTION : Ne pas laisser MAP400 par défaut
- Entrer les clefs d'activation du logiciel
- Copier les objets (règles, action et relations outqs) suivants de MAPPRODCPY vers MAP400_XX : OUTOUT, SPLMAP, ACTLIG et ACTION (voir procédure de copie d'objets ci-dessus)
ATTENTION : NE PAS FAIRE L ERREUR ENTRE MAP400 et MAP400_XX
- Copier les objets (Formats Designer) suivants de MAPPINGQUA vers MAP400_XX : MAPLNK, MAPLNKL1, MAPOBJ, MAP1, MAP2D, MAP2H, MAP3, MAP3L1, MAP (voir procédure de copie d'objets ci-dessus)
ATTENTION : NE PAS FAIRE L ERREUR ENTRE MAP400 et MAP400_XX
- Arrêter le sous-système de production MAPSROBOT
- Renommer l'ancienne bibliothèque MAP400 en MAP400OLD
- Démarrer le sous-système MAPSRBT_XX
- Lancer des traitements en mode production
Retour arrière en cas de problème
- Arrêter le sous-système MAPSRBT_XX
- Renommer la bibliothèque MAP400_XX en MAP400_KO
- Renommer la bibliothèque MAP400OLD en MAP400
- Redémarrer le sous-système MAPSROBOT (ancien sous-système)
Mapping tourne alors avec son ancienne version.
Troubleshooting
Problème 1 : Vous constatez un écart sur un document entre celui produit à l'aide de l'ancienne version (avant upgrade) et la nouvelle (après upgrade)
Solution : Consulter la marche à suivre ci-dessus selon le type d'upgrade choisi
Problème 2 : Les mails ne partent pas et le job MAPSMTP ne démarre pas
Solution : Vérifier le contenu de la dataq MAP400_XX :
DSPDTAQ DTAQ(MAP400_XX/MAPSMTP)
Si celle-ci contient des STOP, à ce moment-là, faire un
CLRDTAQ DTAQ(MAP400_XX/MAPSMTP)
Renvoyer les e-mails.
Problème 3 : Vérification que tout se soit bien passé lors de l'installation Exécuter cette commande pour voir les messages d’installation :
DSPJOBLOG OUTPUT(*PRINT)
Autres points à vérifier :
- Lire le DSPJOBLOG à la fin du processus
- En cas de déconnexion, la commande SIGNOFF *LIST permet de récupérer les erreurs ou alertes d’installation
Pour vérifier les erreurs de restauration (objet verrouillé, mauvais propriétaire, etc.), exécuter la commande suivante dans STRSQL :
SELECT * FROM qtemp/RSTMAP400 WHERE RSOSTA = '0'