OPALE - deploiementEnvironnement MAPDEPLOY

Différence entre versions

De MappingDoc
(Menus)
(Cette version a été marquée pour être traduite)
 
(71 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></BR>
 
<span style="background-color:Black;color:Lime;">1.    &nbsp;&nbsp;&nbsp;Paramètrage Généraux</span></BR>
Ligne 23 : Ligne 33 :
 
</div>
 
</div>
  
==Exemple==
+
===Paramétrages généraux=== <!--T:7-->
 +
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.'''
 +
 
 +
===Paramétrage des formats à déployer=== <!--T:13-->
 +
*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
 +
</BR>
 +
'''Une aide contextuelle est disponible via la touche F1.'''
 +
 
 +
===Deploiement des formats sélectionnés=== <!--T:14-->
 +
 
 +
<!--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.'''
 +
 
 +
===Affichage de l'historique FTP=== <!--T:16-->
 +
Affiche la log des commandes exécutées sur le serveur hôte
 +
 
 +
==Contenu des savefiles de transfer== <!--T:17-->
 +
===Deploiement des formats sélectionnés===
 +
====TRANSFERR1 et TRANSFERS1====
 +
 
 +
<!--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