OPALE - 10.1 - Programme de Duplication d'environnements MAPDUPENV

Différence entre versions

De MappingDoc
(Option 1 : Importation des paramètres d'un environnement MAPPING vers un autre)
Ligne 92 : Ligne 92 :
 
Le sous système de l'environnement MAP400BIS arrêté
 
Le sous système de l'environnement MAP400BIS arrêté
  
====Option 1 : Importation des paramètres d'un environnement MAPPING vers un autre====
+
====Option 2 : Création d'un nouvel environnement à partir d'un autre====
 +
 
 +
 
 
=====Prérequis=====
 
=====Prérequis=====
*SAVF de la bibliothèque source MAP400            (SAVOBJ OBJ(*ALL) LIB(MAP400) DEV(*SAVF) SAVF(QGPL/MAP400)
+
Avoir un autre environnement validé (Ex : MAP400BIS)
*SAVF du contenu du répertoire IFS /home/mapping/ (SAV DEV('/qsys.lib/QGPL.lib/MAP400IFS.FILE') OBJ(('/home/MAP720/*'
 
)))                                                               
 
*Avoir installé un nouvel environnement (Ex : MAP400BIS) avec le setup correspondant sur l'environnement de destination.
 
  
 
=====Principes techniques=====
 
=====Principes techniques=====
L'option 1 consiste à importer les objets de l'environnement source MAP400 (règles, actions, maquettes) vers l'environnement courant (MAP400BIS). Cela aura pour but d'alimenter un deuxième environnement avec le contenu du premier en le rendant étanche par rapport à ce premier. <br>
+
L'option 2 consiste à la création de l'environnement de production (Ex : MAP400TER) se basant sur un autre (Ex : MAP400BIS). (sans devoir lancer de setup) <br>
(Exemple : Créer un environnement pour tester une mise à jour)
+
(Exemple : Créer un environnement de production (Ex : MAP400TER) à partir d'un environnement de qualification validé (Ex : MAP400BIS))
  
 
=====Ecran=====
 
=====Ecran=====
Ligne 107 : Ligne 106 :
 
L'écran contient les paramètres suivants :
 
L'écran contient les paramètres suivants :
  
  Environnement de destination    (1)            (Ex : MAP400BIS)                                       
+
  Environnement de destination    MAPDUPENV                   
                                         
+
Environnement d'origine                                    
                                         
+
                                                           
                                         
+
Nom du savefile pour la biblio                              
Environnement d'origine : (2)                  (Ex : MAP400)               
+
Nom du savefile pour l'IFS . .                              
                                         
+
Nouvel environnement à créer .                             
Nom du savefile pour la biblio : (3)          (Ex : MAP400)         
+
Nom du sous-système  . . . . .  MAPS                       
Nom du savefile pour l'IFS . . (4)            (Ex : SAVIFS)
+
Copie de                       Origine : *ORIGINAL *CURRENT
 
+
Paramètres d'environnement . .  *CURRENT                   
(1) Environnement de destination : Environnement MAPPING courant (MAPENV en ligne)<br>
+
Règles Mapping . . . . . . . .  *CURRENT                   
(2) Environnement d'origine : Nom de la bibliothèque MAPPING présent dans le SAVFILE indiqué dans le paramètre (3) <br>
+
Actions  . . . . . . . . . . .  *CURRENT                   
(3) Nom du savefile pour la biblio : Nom du savfile contenant la bibliothèque source (sans extension) (Ex : MAP400) <br>
+
Relations entre outq . . . . .  *CURRENT                   
(4) Nom du savefile pour l'IFS : Nom du savfile contenant le contenu du répertoire IFS mapping (sans extension) (Ex : /home/mapping) <br>
+
Paramètres imprimantes . . . .  *CURRENT                   
 +
Formats Mapping  . . . . . . .  *CURRENT                   
 +
Taux de conversion . . . . . .  *CURRENT                   
 +
Paramètres des mails . . . . . *CURRENT                   
 +
Historique des mails . . . . . *CURRENT                   
 +
Formats M-Connect  . . . . . .  *CURRENT                   
  
 
=====Résultat final obtenu=====
 
=====Résultat final obtenu=====

Version du 26 février 2020 à 13:51

Introduction

Ce programme tourne exclusivement sur IBM-i. Celui-ci permet de façiliter les duplications d'environnements MAPPING IBM-i.

Cas d'usages possibles

Il y a plusieurs cas d'usages possibles pour ce programme :

  • Besoin de duplication d'un environnement à l'identique (Pour faire des tests sans impacter l'environnement de production)
  • Besoin de duplication d'un environnement avec une version plus récente afin de préparer une mise à jour.
  • Besoin de création d'un environnement à partir d'un autre environnement sans passer par le setup


Ce programme composé de 3 options qui consistent à :

   Option 1 : Importation de la configuration d'un autre environnement MAPPING (Ex : MAP400BIS)
   Option 2 : Création d'un nouvel environnement (Ex : MAP400TER) à partir d'un autre environnement MAPPING (MAP400 et/ou MAP400BIS et/ou autres)
   Option 3 : Mise en place de ce nouvel environnement (MAP400TER) sur le serveur de production (A utiliser que si le serveur de production n'est pas le même que le serveur de dev)

Limites

   Ce programme ne gère pas les cas où la bibliotèque de fichiers est différente de celle de programmes.
   Ce programme ne gère pas les appel de CL dans les actions (L'exécution de ces CLs sur MAP400BIS pourront impacter MAP400)
   Ce programme ne gère pas les clefs. Les clefs devront être entrées dans les nouveaux environnements.
   Les outqs monitorées par MAPPING ne peuvent pas avoir le même nom dans des libs différentes. (exemple : QUSRSYS/OUTQIN et QGPL/OUTQIN)

Suppositions

Dans cette documentation, on prend pour supposition les choses suivantes :

   IFS de production : /home/mapping
   MAP400 : bibliotèque d'origine copié (Exemple : Production)
   MAP400BIS : bibliotèque intermédiaire à créer (Exemple : Qualification)
   MAP400TER : Nouvelle bibliothèque finale à créer (Exemple : Future production)
   MAP400.SAVF : Fichier SAVF contenant la bibliotèque à dupliquer (Exemple : Production)
   SAVIFS.SAVF : Fichier SAVF contenant le contenu du répertoire /home/mapping à copier (Exemple : Production)
   SAVIFSQ.SAVF : Fichier SAVF contenant le contenu du répertoire /home/MAP400BIS/mapping à copier (Exemple : Qualification)

Nom du programme

MAPDUPENV

Version

Disponible à partir de la version : IBM-i v10.0 (OPALE)

Appel du programme

CALL PGM(MAPDUPENV)

Détails techniques

Menu principal

L'appel du programme (CALL PGM(MAPDUPENV) affiche un menu mettant en avant 3 options distinctes :

   Option 1 : Importation de la configuration d'un autre environnement MAPPING
   Option 2 : Création d'un nouvel environnement à partir d'un autre environnement MAPPING (MAP400 et/ou MAP400BIS et/ou autres)
   Option 3 : Mise en place de ce nouvel environnement sur autre autre serveur distant (Dans notre use case, A utiliser que si le serveur de production n'est pas le même que le serveur de dev)

Option 1 : Importation des paramètres d'un environnement MAPPING vers un autre

Prérequis
  • SAVF de la bibliothèque source MAP400 (SAVOBJ OBJ(*ALL) LIB(MAP400) DEV(*SAVF) SAVF(QGPL/MAP400)
  • SAVF du contenu du répertoire IFS /home/mapping/ (SAV DEV('/qsys.lib/QGPL.lib/MAP400IFS.FILE') OBJ(('/home/MAP720/*'

)))

  • Avoir installé un nouvel environnement (Ex : MAP400BIS) avec le setup correspondant sur l'environnement de destination.
Principes techniques

L'option 1 consiste à importer les objets de l'environnement source MAP400 (règles, actions, maquettes) vers l'environnement courant (MAP400BIS). Cela aura pour but d'alimenter un deuxième environnement avec le contenu du premier en le rendant étanche par rapport à ce premier.
(Exemple : Créer un environnement pour tester une mise à jour)

Ecran

L'écran contient les paramètres suivants :

Environnement de destination    (1)            (Ex : MAP400BIS)                                         
                                          
                                          
                                          
Environnement d'origine : (2)                  (Ex : MAP400)                
                                          
Nom du savefile pour la biblio : (3)           (Ex : MAP400)           
Nom du savefile pour l'IFS . . (4)             (Ex : SAVIFS)

(1) Environnement de destination : Environnement MAPPING courant (MAPENV en ligne)
(2) Environnement d'origine : Nom de la bibliothèque MAPPING présent dans le SAVFILE indiqué dans le paramètre (3)
(3) Nom du savefile pour la biblio : Nom du savfile contenant la bibliothèque source (sans extension) (Ex : MAP400)
(4) Nom du savefile pour l'IFS : Nom du savfile contenant le contenu du répertoire IFS mapping (sans extension) (Ex : /home/mapping)

Résultat final obtenu

Nouvel environnement (MAP400BIS) prêt à l'emploi ISO avec l'environnement copié (Exemple:MAP400) (avec toutes les OUTQs monitorées dans MAP400BIS) à l'exception des clés logiciels. Le sous système de l'environnement MAP400BIS arrêté

Option 2 : Création d'un nouvel environnement à partir d'un autre

Prérequis

Avoir un autre environnement validé (Ex : MAP400BIS)

Principes techniques

L'option 2 consiste à la création de l'environnement de production (Ex : MAP400TER) se basant sur un autre (Ex : MAP400BIS). (sans devoir lancer de setup)
(Exemple : Créer un environnement de production (Ex : MAP400TER) à partir d'un environnement de qualification validé (Ex : MAP400BIS))

Ecran

L'écran contient les paramètres suivants :

Environnement de destination    MAPDUPENV                    

Environnement d'origine

Nom du savefile pour la biblio Nom du savefile pour l'IFS . . Nouvel environnement à créer . Nom du sous-système . . . . . MAPS Copie de Origine : *ORIGINAL *CURRENT Paramètres d'environnement . . *CURRENT Règles Mapping . . . . . . . . *CURRENT Actions . . . . . . . . . . . *CURRENT Relations entre outq . . . . . *CURRENT Paramètres imprimantes . . . . *CURRENT Formats Mapping . . . . . . . *CURRENT Taux de conversion . . . . . . *CURRENT Paramètres des mails . . . . . *CURRENT Historique des mails . . . . . *CURRENT Formats M-Connect . . . . . . *CURRENT

Résultat final obtenu

Nouvel environnement (MAP400BIS) prêt à l'emploi ISO avec l'environnement copié (Exemple:MAP400) (avec toutes les OUTQs monitorées dans MAP400BIS) à l'exception des clés logiciels. Le sous système de l'environnement MAP400BIS arrêté