Migration Process

Introduction

This article describes the process that must be applied to upgrade OPALE Server on a iSeries server. This procedure also applies to an upgrade to M-PS 7.2.

General steps

The procedure below is based on the assumption that the production environment that will be migrated is set up in a library called MAP400.

The update procedure for OPALE Server includes the following steps:

• Setting up of a development environment where OPALE Server will be installed
• Copying the production environment settings to the development environment
• Creating an OUTQ monitored by Mapping and edit print routing rules accordingly
• Running tests
• Moving to production
• Rollback in case there is a problem
• Troubleshooting

Any changes made to templates (wether it be intentional or because of a delta following the update) will need to be made using a Designer in the same version as OPALE Server and with UNICODE.

Requirements

User profile

- Access to the QSECOFR profile has to be granted for you to install the product

Elements gathering

The user should have a relatively good knowledge of the environment. To do so, one should be able to:

- Identify the key documents that need to be tested by Mapping or by a certified partner
- Identify the raw spooled files for each of the documents
- Identify the Designer projects (.mpp, .mpw and .mpi files) for each of the documents as well as the possible components
- Have a PDF and/or .dmp file for each document that needs to be printed
- Identify the strategic rules in the production environment
- Gather the different iSeries spooled files (in an outq: MAPREF/MAPQUALREF) with their corresponding Mapping output results (PCL, ZPL, TEC, etc) generated with the current Mapping production server.

Caution : All fonts used have to be in TTF format (all other types of fonts will have to be switched for TTF fonts)

Tous les fichiers sources "Windows" devront être classés dans des répertoire 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

1. Vérifier si MAPPING est configuré en UNICODE ou non UNICODE : Option 14/1
   
2. Regarder le type de règles et d'actions utilisées par le client
3. 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
   
4. Valider que la configuration (Option 14/1) soit la même sur MAPPINGQUA que MAP400 (hormis les chemins IFS)
5. 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 AS400 afin de copier les formats Designer ainsi que les règles et relations entre Outqs. Les maquettes ne sont pas regénérées.

Etape 1 : Copie des formats Designer

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

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

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

Etape 2 : Copie du paramétrage des OUTQ

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

1. 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)
2. Copier dans le répertoire "home/MAPQUAL/mapping/ttf/" le contenu de "home/mapping/ttf/"
3. 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

1. Installer le dernier setup de Designer correspondant à la version de votre nouvelle installation du serveur
2. 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 :

1. 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
2. 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 (à terminer).

Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY (à terminer).

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

1. 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)
2. 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 :

1. 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
2. Code barre :
   1. Problèmes d'alignements : Vérifier la preview sur la maquette et corriger la maquette si besoin
   2. Problème de labélisation : Cocher ou décocher le label du code barre (propriétés de la zone Code barre)
   3. A compléter

A ce moment là, nous avons deux choix possibles :

1. 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.

1. 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

1. Installer le dernier setup de Designer (correspondant à la version de votre nouvelle installation du serveur)
2. 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:

1. 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
2. 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 (A terminer) Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY (A terminer)

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

1. 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)
2. 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 :

1. 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
2. Code barre :
   1. Problèmes d'alignements : Vérifier la preview sur la maquette et corriger la maquette si besoin
   2. Problème de labélisation : Cocher ou décocher le label du code barre (propriétés de la zone Code barre)
   3. A compléter

A ce moment là, nous avons deux choix possibles :

1. 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.

1. 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 :

1. 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)
2. Besoin de post traitement plus important pour un document :
   1. Fusion du document avec d'autres documents Mapping ou autres
   2. Conversion d'un flux vers un autre (PDF vers XPS et ensuite concaténation avec un autre document par exemple)
   3. Autres

Utilisation de flux thermique (Zebra, TEC)

Il est fortement conseillé par Mapping de passer les maquettes thermiques en XPS. Les raisons principales sont :

1. Aperçu Designer et impression finale bien plus fiable en XPS qu'en natif
2. 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'