OPALE - deploiementEnvironnement MAPDEPLOY

Différence entre versions

De MappingDoc
(Paramétrages généraux)
(Cette version a été marquée pour être traduite)
 
(49 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
==Introduction==
+
<languages/>
Depuis la 10.8, il est possible de déployer un environnement vers un autre environnement (distant ou local).Cela peut s'avérer très utile pour copier le paramétrage de l'environnement de développement vers l'environnement de production.
+
<translate>
 +
==Introduction== <!--T:1-->
 +
Depuis la 10.8, il est possible de déployer un environnement vers un autre environnement (distant ou local).Cela peut s'avérer très utile pour copier le paramétrage de l'environnement de '''préproduction vers un environnement''' de production.
  
 +
<!--T:2-->
 +
'''Important''' : Il est important de l'utiliser entre environnements de '''préproduction et production''' (et non de développement) car ce module permet la réplication à l'identique de 2 environnements (avec la possibilité de sélectionner un format en particulier afin d'éviter d'updater tous les formats). Si vous n'avez pas d'environnement de préproduction, il convient d'en créer un ou de ne pas utiliser ce module.
  
==Principe de fonctionnement==
+
==Principe de fonctionnement== <!--T:3-->
La commande MAPDPELOY (accessible via le meny Exploitation / Déploiement d'environnement) permet de déployer un environnement vers un autre environnement.  
+
La commande MAPDPELOY (accessible via le meny Exploitation / Déploiement d'environnement) permet de déployer un environnement de préproduction vers un environnement de production.  
En effet, dans la bonne pratique, il est conseillé de ne pas générer les maquettes ou de créer les rêgles/actions directement sur l'environnement de production mais bien sur l'environnement de développement. Une fois le ou les traitements  validés sur cet environnement de développement, il faut envoyer son paramétrage vers l'environnement de production. (Maquette, règles, actions, etc).
+
En effet, dans la bonne pratique, il est conseillé de ne pas générer les maquettes ou de créer les rêgles/actions directement sur l'environnement de production mais bien sur l'environnement de préproduction. Une fois le ou les traitements  validés sur cet environnement de préproduction, il convient d'envoyer son paramétrage vers l'environnement de production. (Maquette, règles, actions, etc).
 
Pour ce faire, il est très pratique d'utiliser le menu de déploiement d'environnements. Celui-ci permet de renseigner les hôtes destinataires, sélectionner le ou les formats à envoyer ou à supprimer ou bien d'envoyer carrément tout le paramétrage (tous les formats, toutes les règles et les actions)  
 
Pour ce faire, il est très pratique d'utiliser le menu de déploiement d'environnements. Celui-ci permet de renseigner les hôtes destinataires, sélectionner le ou les formats à envoyer ou à supprimer ou bien d'envoyer carrément tout le paramétrage (tous les formats, toutes les règles et les actions)  
  
==Menus==
+
<!--T:4-->
 +
Dans le cas où on souhaite envoyer  tout l'environnement (option 11 du menu), tous les formats, toutes les règles, actions, fichier de conversions, paramétrages imprimantes, etc  seront envoyés.
 +
Dans le cas d'un envoi simple de formats sélectionnés, uniquement ce format et quelques fichiers de paramétrages sont envoyés (voir tableau plus bas)
 +
 
 +
 
 +
==Menus== <!--T:5-->
 
La commande MAPDEPLOY comporte plusieurs menus :
 
La commande MAPDEPLOY comporte plusieurs menus :
  
 +
<!--T:6-->
 
<div style="background-color:black">
 
<div style="background-color:black">
<span style="background-color:Black;color:Lime;">1.    &nbsp;&nbsp;&nbsp;Paramètrage Généraux
+
<span style="background-color:Black;color:Lime;">1.    &nbsp;&nbsp;&nbsp;Paramètrage Généraux</span></BR>
 
<span style="background-color:Black;color:Lime;">2.    &nbsp;&nbsp;&nbsp;Paramètrage des serveurs hôtes</span></BR>
 
<span style="background-color:Black;color:Lime;">2.    &nbsp;&nbsp;&nbsp;Paramètrage des serveurs hôtes</span></BR>
 
</BR>
 
</BR>
Ligne 23 : Ligne 33 :
 
</div>
 
</div>
  
===Paramétrages généraux===
+
===Paramétrages généraux=== <!--T:7-->
Cette option permet de renseigner les paramètre globaux de la gestion des déploiements :
+
Cette option permet de renseigner les paramètre globaux de la gestion des déploiements.
 +
 
 +
<!--T:8-->
 +
*Bibliothèque MAPPING source
 +
*Bibliothèque UCS2
 +
*Chemin IFS                   
 +
*Bibliothèque intermédiaire   
 +
*Prefixe des savefiles         
 +
*Bibliothèque des savefiles   
 +
*Version cible minimum         
 +
*Bibliothèque du fichier log FT
 +
*Utilisateurs autorisés       
 +
</BR>
 +
'''Une aide contextuelle est disponible via la touche F1.'''
 +
 
 +
===Paramétrages des serveurs hôtes=== <!--T:9-->
 +
Cette option permet de renseigner les serveurs hôtes de destination. Le serveur hôte sera renseigné lors d'un déploiement (partiel ou global).
 +
Pour créer un nouvel hôte, il faut faire F6 :
 +
 
 +
<!--T:10-->
 +
*Nom du serveur     
 +
*Description       
 +
*Code Groupe       
 +
*Nom ou adresse serv.
 +
*Profil utilisateur 
 +
*Mot de passe       
 +
*Bibliothèque Opale 
 +
*Bibliothèque UCS2 
 +
*Chemin IFS
 +
</BR>
 +
'''Une aide contextuelle est disponible via la touche F1.'''
 +
 
 +
===Deploiement d'un environnement complet=== <!--T:11-->
 +
 
 +
<!--T:12-->
 +
*Serveurs de déploiement
 +
*Bibliothèque source
 +
*Bibliothèque UCS2
 +
*Chemin IFS
 +
*Traitement batch
 +
*Restaurer les savefiles
 +
</BR>
 +
'''Une aide contextuelle est disponible via la touche F1.'''
  
*Bibliothèque MAPPING source : La bibliothèque source est le nom de la bibliothèque contenant les objets mapping ... La bibliothèque UCS2 est le nom de la bibliothèque spécifique contenant les objets pour l'environnement UCS2
+
===Paramétrage des formats à déployer=== <!--T:13-->
*Bibliothèque UCS2 : La bibliothèque UCS2 contient les objets spécifiques que l'on ajoute à la liste des bibliothèques lorsque l'on   
+
*Option 1 devant un format pour le copier sur le serveur hôte
utilise certains formats en mode natif et d'autres en mode UCS2.</BR>                                                         
+
*Option 2 devant un format pour le supprimer sur le serveur hôte
Si vous n'utilisez pas cette bibliothèque, indiquez *NONE
+
</BR>
*Chemin IFS : Pour sauvegarder les fichiers IFS associés, indiquez le chemin d'accès, par exemple /Home/MapOpale/Mapping  </BR>                                                      
+
'''Une aide contextuelle est disponible via la touche F1.'''
La valeur d'environnement courant est récupérée par defaut
 
*Bibliothèque intermédiaire : Lorsque vous utilisez le déploiement partiel, une bibliothèque intermédiaire est créée pour contenir les formats sélectionnés.                                 
 
*Prefixe des savefiles : L'envoi des formats se fait via l'envoi de savefiles par FTP.Il peut y avoir jusque 4 savefiles. Vous pouvez indiquer ici un prefixe pour leur nom         
 
*Bibliothèque des savefiles : Les savefiles utilisés pour l'envoi des formats doivent se trouver dans une bibliothèque. Indiquez le nom de cette bibliothèque ici. Si la bibliothèque n'existe pas, elle sera créée lors de l'envoi des formats.                                       
 
*Version cible minimum : Veuillez indiquer la plus vieille version d'OS utilisée.Si vous utilisez plusieurs serveurs avec des versions d'OS différentes, il est nécessaire de sauvegarder les données en utilisant la plus vieille des versions d'OS.                       
 
*Bibliothèque du fichier log FT  : Les commandes FTP sont notées dans un fichier log. Cela peut être utile pour consulter les erreurs eventuelles
 
Indiquez le nom de la bibliothèque contenant le fichier log Si la bibliothèque n'existe pas, elle sera créée lors du prochain transfert.                                       
 
*Utilisateurs autorisés          (Nom, *SECADM, *ALL)  : Indiquez quels profils sont autorisés à utiliser MapDeploy
 
*ALL      : Tous les utilisateurs  </BR>                    
 
*SECADM    : Seuls les profils ayant la classe *SECADM    </BR>
 
xxxxxxxxxx : Seul le profil xxxxxxxxxx.       </BR>           
 
  
 +
===Deploiement des formats sélectionnés=== <!--T:14-->
  
Une aide contextuelle est disponible via la touche F1.
+
<!--T:15-->
 +
*Serveurs de déploiement
 +
*Bibliothèque source
 +
*Bibliothèque UCS2
 +
*Bibliothèque intermédiaire
 +
*Chemin IFS
 +
*Traitement batch
 +
*Restaurer les savefiles
 +
</BR>
 +
'''Une aide contextuelle est disponible via la touche F1.'''
  
===Paramétrages des serveyrs hôtes===
+
===Affichage de l'historique FTP=== <!--T:16-->
Cette option permet de renseigner les serveurs hôtes de destination. Le serveur hôte sera renseigné lors d'un déploiement (partiel ou global).
+
Affiche la log des commandes exécutées sur le serveur hôte
Pour créer un nouvel hôte, il faut faire F6 :
 
  
*Nom du serveur : Nom de l'hôte (à renseigner lors d'un déploiement)
+
==Contenu des savefiles de transfer== <!--T:17-->
*Description : Description du serveur hôte
+
===Deploiement des formats sélectionnés===
*Code Groupe :  Chaque serveur peut faire partie d'un groupe. Lors de l'envoi, vous pouvez indiquer *ALL, ou un nom de serveur, ou *GRPxxx pour indiquer tous les serveurs ayant un code groupe de xxx.
+
====TRANSFERR1 et TRANSFERS1====
*Nom ou adresse serveur
 
*Profil utilisateur : Indiquez le mot de passe pour le profil de connexion FTP
 
*Mot de passe : Indiquez le mot de passe pour le profil de connexion FTP
 
*Bibliothèque Opale : Indiquez le nom de la bibliothèque dans laquelle restaurer les formats déployés sur cette machine.                 
 
*Bibliothèque UCS2 : Si vous utilisez une bibliothèque spécifique pour modifier votre environnement UCS2 sur certains formats, indiquez son nom. Dans le cas contraire, indiquez *NONE                 
 
*Chemin IFS :  Indiquez le nom du répertoire IFS dans lequel restaurer les fichiers IFS utilisés par vos formats. Attention au niveau des répertoires. Le niveau doit correspondre à celui des fichiers sauvegardés (voir le paramétrage global). </BR>                                     
 
Exemple : Si vous sauvegardez /home/rep1/mapping, </BR>
 
restaurez dans le repertoire /home/rep2/mapping, </BR>   
 
et pas dans le répertoire /home/rep2 </BR>
 
  
==Exemple==
+
<!--T:18-->
 +
{| class="wikitable"
 +
|-
 +
! Nom de l'objet !! type de l'objet !! Fonction de l'objet
 +
|-
 +
| DEPLOY1 || *LIB || Bibliothèque contenant les formats à déployer (MAPENV, MAP1, MAP2, etc)
 +
|-
 +
| DPL003DLY || *PGM || Attend un temps pour avoir la fin des restaurations en cours
 +
|-
 +
| DPL005CPY || *PGM || Programme de copie du formats sélectionnés
 +
|-
 +
| MAP_C016P3 || *PGM || Teste l'existence d'un format et copie de celui-ci
 +
|-
 +
| MAP_C841 || *PGM || Copie des fichiers afpds si existants
 +
|-
 +
| MAP_C841P2 || *PGM || Copie des fichiers afpds si existants
 +
|-
 +
| MAP_MSG || *PGM || Récupère le texte d'un message d'après son ID
 +
|-
 +
| MAP_016CHK || *PGM || Teste l'existence d'un format dans les fichiers map et map1
 +
|-
 +
| MAP_016CPY || *PGM || Programme de copie d'un format de biblio à biblio
 +
|-
 +
| MAP_016DEL || *PGM || Programme de Partnair pour supprimer un format
 +
|-
 +
| DPLLIBINT || *DTAARA || Nom de la bibliothèque intermédiaire pour MAPDEPLOY
 +
|-
 +
| MAPENV || *DTAARA || Dataarea contenant le paramétrage de l'environnement source à déployer
 +
|-
 +
| CONVERT || *FILE || Fichier contenant les taux de conversions de l'environnement source à déployer
 +
|-
 +
| DPLFORMS || *FILE || Fichier contenant les formats sélectionnés à copier ou supprimer de l'environnement source à déployer
 +
|-
 +
| MAP || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAPARCH2 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAPARCH3  || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAPLNK || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAPLNKL1 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAPOBJ || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAP1 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAP2D || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAP2H || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAP3 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|-
 +
| MAP3L1 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
 +
|}
  
MAPENRSPLF SPLF(A000000001) SPLNUM(39) JOB(QPADEV0001) JOBNUM(001687) USER(JDIEU) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) SPLFOUT(MAPENRSPLF)
+
====TRANSFERR3 et TRANSFERS3==== <!--T:19-->
  
Cette commande prend en entrée le fichier spool SPLF(A000000001) SPLNUM(39) JOB(QPADEV0001) JOBNUM(001687) USER(JDIEU). La commande génèrera un fichier spool portant pour nom '''MAPENRSPLF''' et ayant le contenu suivant à la fin de sa première page
+
<!--T:20-->
 +
Ce savefile contient le contenu du répertoire lgobitmap et du répertoire ttf.
 +
</BR></BR>
 +
<u>Remarque</u> : Ce savefile, dans une prochaine version, va contenir uniquement le contenu du répertoire ttf, car le répertoire lgobitmap devra être géré manuellement, tout comme c'est déjà le cas pour les générations et importations de formats. En effet, un update massif non controlé du répertoire lgobitmap peut s'avérer risqué vu que ce répertoire contient des ressources transverses à plusieurs maquettes.
  
[%---------- MAPPING ENRICHMENT ----------%] 
+
==Idées d'évolutions== <!--T:21-->
      [%SPLF%] A000000001                   
+
*Ajouter un controle de ressources avant la copie des formats
    [%SPLNUM%] 000039                       
+
*Gérer la partie objets M-Connect (non géré actuellement)
      [%JOB%] QPADEV0001
+
*Possibilité de faire un rollback une fois déployé sur un environnement
    [%JOBNUM%] 001687   
 
      [%USER%] JDIEU     
 
    [%OWNER%] JDIEU     
 
  [%ACGCODE%]           
 
  [%USERDATA%]           
 
  [%PRTTEXT%]           
 
  [%USERTEXT%]           
 
[%USERDFNDTA%] *NONE     
 
  [%FORMTYPE%] *STD     
 
      [%HOLD%] *NO       
 
      [%SAVE%] *YES     
 
  [%TOTPAGES%] 000004   
 
  [%PRTPAGES%] 000004   
 
  [%STRPAGE%] 000001   
 
  [%ENDPAGE%] 000004   
 
    [%COPIES%] 001       
 
      [%LPI%] 06       
 
      [%CPI%] 10
 
  [%PRIORITY%]  5       
 
      [%OUTQ%] TESTAUTO 
 
    [%OUTQLIB%] TESTAUTO 
 
  [%OPENDATE%] 1180726   
 
  [%OPENTIME%] 180759   
 
    [%DEVICE%] RESTOREPAG
 
  [%DEVICELIB%] MAPCERT72 
 
      [%PROG%]           
 
    [%PROGLIB%]           
 
[%PAGEHEIGHT%] 255       
 
  [%PAGEWIDTH%] 360       
 
[%OVRFLWLINE%] 060       
 
      [%CHRID%] *DEVD     
 
      [%CCSID%] 065535
 
  
==Interprétation côté Onyx==
 
  
Avec cet exemple, il suffit ensuite de récupérer chacune des valeurs correspondantes à l'aide de '''boites workflow Attribut'''.
+
</translate>
Il sera alors possible de les utiliser dans le ou les workflows de traitements.
 

Version actuelle datée du 5 novembre 2024 à 10:35

Autres langues :
English • ‎français

Introduction

Depuis la 10.8, il est possible de déployer un environnement vers un autre environnement (distant ou local).Cela peut s'avérer très utile pour copier le paramétrage de l'environnement de préproduction vers un environnement de production.

Important : Il est important de l'utiliser entre environnements de préproduction et production (et non de développement) car ce module permet la réplication à l'identique de 2 environnements (avec la possibilité de sélectionner un format en particulier afin d'éviter d'updater tous les formats). Si vous n'avez pas d'environnement de préproduction, il convient d'en créer un ou de ne pas utiliser ce module.

Principe de fonctionnement

La commande MAPDPELOY (accessible via le meny Exploitation / Déploiement d'environnement) permet de déployer un environnement de préproduction vers un environnement de production. En effet, dans la bonne pratique, il est conseillé de ne pas générer les maquettes ou de créer les rêgles/actions directement sur l'environnement de production mais bien sur l'environnement de préproduction. Une fois le ou les traitements validés sur cet environnement de préproduction, il convient d'envoyer son paramétrage vers l'environnement de production. (Maquette, règles, actions, etc). Pour ce faire, il est très pratique d'utiliser le menu de déploiement d'environnements. Celui-ci permet de renseigner les hôtes destinataires, sélectionner le ou les formats à envoyer ou à supprimer ou bien d'envoyer carrément tout le paramétrage (tous les formats, toutes les règles et les actions)

Dans le cas où on souhaite envoyer tout l'environnement (option 11 du menu), tous les formats, toutes les règles, actions, fichier de conversions, paramétrages imprimantes, etc seront envoyés. Dans le cas d'un envoi simple de formats sélectionnés, uniquement ce format et quelques fichiers de paramétrages sont envoyés (voir tableau plus bas)


Menus

La commande MAPDEPLOY comporte plusieurs menus :

1.    Paramètrage Généraux
2.    Paramètrage des serveurs hôtes

11.  Deploiement d'un environnement complet

21.  Paramétrage des formats à déployer
22.  Deploiement des formats sélectionnés

31.  Affichage de l'historique FTP

Paramétrages généraux

Cette option permet de renseigner les paramètre globaux de la gestion des déploiements.

  • Bibliothèque MAPPING source
  • Bibliothèque UCS2
  • Chemin IFS
  • Bibliothèque intermédiaire
  • Prefixe des savefiles
  • Bibliothèque des savefiles
  • Version cible minimum
  • Bibliothèque du fichier log FT
  • Utilisateurs autorisés


Une aide contextuelle est disponible via la touche F1.

Paramétrages des serveurs hôtes

Cette option permet de renseigner les serveurs hôtes de destination. Le serveur hôte sera renseigné lors d'un déploiement (partiel ou global). Pour créer un nouvel hôte, il faut faire F6 :

  • Nom du serveur
  • Description
  • Code Groupe
  • Nom ou adresse serv.
  • Profil utilisateur
  • Mot de passe
  • Bibliothèque Opale
  • Bibliothèque UCS2
  • Chemin IFS


Une aide contextuelle est disponible via la touche F1.

Deploiement d'un environnement complet

  • Serveurs de déploiement
  • Bibliothèque source
  • Bibliothèque UCS2
  • Chemin IFS
  • Traitement batch
  • Restaurer les savefiles


Une aide contextuelle est disponible via la touche F1.

Paramétrage des formats à déployer

  • Option 1 devant un format pour le copier sur le serveur hôte
  • Option 2 devant un format pour le supprimer sur le serveur hôte


Une aide contextuelle est disponible via la touche F1.

Deploiement des formats sélectionnés

  • Serveurs de déploiement
  • Bibliothèque source
  • Bibliothèque UCS2
  • Bibliothèque intermédiaire
  • Chemin IFS
  • Traitement batch
  • Restaurer les savefiles


Une aide contextuelle est disponible via la touche F1.

Affichage de l'historique FTP

Affiche la log des commandes exécutées sur le serveur hôte

Contenu des savefiles de transfer

Deploiement des formats sélectionnés

TRANSFERR1 et TRANSFERS1

Nom de l'objet type de l'objet Fonction de l'objet
DEPLOY1 *LIB Bibliothèque contenant les formats à déployer (MAPENV, MAP1, MAP2, etc)
DPL003DLY *PGM Attend un temps pour avoir la fin des restaurations en cours
DPL005CPY *PGM Programme de copie du formats sélectionnés
MAP_C016P3 *PGM Teste l'existence d'un format et copie de celui-ci
MAP_C841 *PGM Copie des fichiers afpds si existants
MAP_C841P2 *PGM Copie des fichiers afpds si existants
MAP_MSG *PGM Récupère le texte d'un message d'après son ID
MAP_016CHK *PGM Teste l'existence d'un format dans les fichiers map et map1
MAP_016CPY *PGM Programme de copie d'un format de biblio à biblio
MAP_016DEL *PGM Programme de Partnair pour supprimer un format
DPLLIBINT *DTAARA Nom de la bibliothèque intermédiaire pour MAPDEPLOY
MAPENV *DTAARA Dataarea contenant le paramétrage de l'environnement source à déployer
CONVERT *FILE Fichier contenant les taux de conversions de l'environnement source à déployer
DPLFORMS *FILE Fichier contenant les formats sélectionnés à copier ou supprimer de l'environnement source à déployer
MAP *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAPARCH2 *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAPARCH3 *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAPLNK *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAPLNKL1 *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAPOBJ *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAP1 *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAP2D *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAP2H *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAP3 *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer
MAP3L1 *FILE Fichier contenant les objets des formats à copier de l'environnement source à déployer

TRANSFERR3 et TRANSFERS3

Ce savefile contient le contenu du répertoire lgobitmap et du répertoire ttf.

Remarque : Ce savefile, dans une prochaine version, va contenir uniquement le contenu du répertoire ttf, car le répertoire lgobitmap devra être géré manuellement, tout comme c'est déjà le cas pour les générations et importations de formats. En effet, un update massif non controlé du répertoire lgobitmap peut s'avérer risqué vu que ce répertoire contient des ressources transverses à plusieurs maquettes.

Idées d'évolutions

  • Ajouter un controle de ressources avant la copie des formats
  • Gérer la partie objets M-Connect (non géré actuellement)
  • Possibilité de faire un rollback une fois déployé sur un environnement