OPALE - deploiementEnvironnement MAPDEPLOY/en

Différence entre versions

De MappingDoc
(Page créée avec « OPALE:EnvironmentDeployment_MAPDEPLOY »)
 
(Page créée avec « ==Ideas for evolution== *Add a resource check before copying formats *Manage the M-Connect object part (not currently managed) *Possibility to do a rollback once deployed... »)
 
(23 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 +
<languages/>
 
==Introduction==
 
==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.
+
Since 10.8, it is possible to deploy an environment to another environment (remote or local). This can be very useful for copying the environment setting from Preproduction to a 'production'' environment.
  
'''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.
+
'''Important''': It is important to use it between ''''pre-production and production''' environments (and not development) because this module allows the identical replication of 2 environments (with the possibility of selecting a particular format in order to avoid updating all the formats). If you don't have a staging environment, you should create one or not use this module.
  
==Principe de fonctionnement==
+
==Principle of operation==
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.  
+
The MAPDPELOY command (accessible via the Exploitation / Environment Deployment meny) allows you to deploy a staging environment to a production environment.  
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).
+
Indeed, in good practice, it is advisable not to generate the models or to create the rules/actions directly on the production environment but on the pre-production environment. Once the processing(s) have been validated on this pre-production environment, it is necessary to send its configuration to the production environment. (Model, rules, 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)  
+
To do this, it is very convenient to use the environment deployment menu. This allows you to fill in the recipient hosts, select the format(s) to send or delete or to send the entire configuration (all formats, rules and 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.
+
In case you want to send the whole environment (option 11 of the menu), all formats, rules, actions, conversion files, printer settings, etc. will be sent.
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)
+
In the case of a simple sending of selected formats, only this format and a few configuration files are sent (see table below)
  
  
 
==Menus==
 
==Menus==
La commande MAPDEPLOY comporte plusieurs menus :
+
The MAPDEPLOY command has several menus:
  
 
<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;General settings</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;Host server settings</span></BR>
 
</BR>
 
</BR>
<span style="background-color:Black;color:Lime;">11.   &nbsp;Deploiement d'un environnement complet</span></BR>
+
<span style="background-color:Black;color:Lime;">11. &nbsp;Deploying a full environment</span></BR>
 
</BR>
 
</BR>
<span style="background-color:Black;color:Lime;">21.   &nbsp;Paramétrage des formats à déployer</span></BR>
+
<span style="background-color:Black;color:Lime;">21. &nbsp;Setting up the formats to be deployed</span></BR>
<span style="background-color:Black;color:Lime;">22.   &nbsp;Deploiement des formats sélectionnés</span></BR>
+
<span style="background-color:Black;color:Lime;">22. &nbsp;Deploying Selected Formats</span></BR>
 
</BR>
 
</BR>
<span style="background-color:Black;color:Lime;">31. &nbsp;Affichage de l'historique FTP</span></BR>
+
<span style="background-color:Black;color:Lime;">31. &nbsp;Viewing FTP History</span></BR>
 
</div>
 
</div>
  
===Paramétrages généraux===
+
===General settings===
Cette option permet de renseigner les paramètre globaux de la gestion des déploiements.  
+
Use this option to fill in the global settings for deployment management.  
  
*Bibliothèque MAPPING source
+
*Source MAPPING library
*Bibliothèque UCS2
+
*UCS2 Library
*Chemin IFS                     
+
*IFS Path                      
*Bibliothèque intermédiaire      
+
*Intermediate library      
*Prefixe des savefiles           
+
*Prefix of savefiles           
*Bibliothèque des savefiles      
+
*Savefile library      
*Version cible minimum          
+
*Minimum target version          
*Bibliothèque du fichier log FT
+
*FT log file library
*Utilisateurs autorisés          
+
*Authorized users          
 
</BR>
 
</BR>
'''Une aide contextuelle est disponible via la touche F1.'''
 
  
===Paramétrages des serveurs hôtes===
+
'''Context-sensitive help is available via the F1 key.'''
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      
+
===Host server settings===
 +
This option allows you to populate the destination host servers. The host server will be populated during a deployment (partial or global).
 +
To create a new host, you need to do F6:
 +
 
 +
*Server Name      
 
*Description         
 
*Description         
*Code Groupe          
+
*Group code          
*Nom ou adresse serv.
+
*Name or address serv.
*Profil utilisateur  
+
*User profile  
*Mot de passe        
+
*Password        
*Bibliothèque Opale  
+
*Opal Library  
*Bibliothèque UCS2   
+
*UCS2 Library    
*Chemin IFS
+
*IFS Path
 
</BR>
 
</BR>
'''Une aide contextuelle est disponible via la touche F1.'''
+
'''Context-sensitive help is available via the F1 key.'''
  
===Deploiement d'un environnement complet===
+
===Deploying a full environment===
  
*Serveurs de déploiement
+
*Deployment servers
*Bibliothèque source
+
*Source library
*Bibliothèque UCS2
+
*UCS2 Library
*Chemin IFS
+
*IFS Path
*Traitement batch
+
*Batch processing
*Restaurer les savefiles
+
*Restore savefiles
 
</BR>
 
</BR>
'''Une aide contextuelle est disponible via la touche F1.'''
+
'''Context-sensitive help is available via the F1 key.'''
  
===Paramétrage des formats à déployer===
+
===Setting up the formats to be deployed===
*Option 1 devant un format pour le copier sur le serveur hôte
+
*Option 1 in front of a format to copy to the host server
*Option 2 devant un format pour le supprimer sur le serveur hôte
+
*Option 2 in front of a format to delete it on the host server
 
</BR>
 
</BR>
'''Une aide contextuelle est disponible via la touche F1.'''
+
'''Context-sensitive help is available via the F1 key.'''
  
===Deploiement des formats sélectionnés===
+
===Deploying Selected Formats===
  
*Serveurs de déploiement
+
*Deployment servers
*Bibliothèque source
+
*Source library
*Bibliothèque UCS2
+
*UCS2 Library
*Bibliothèque intermédiaire
+
*Intermediate library
*Chemin IFS  
+
*IFS Path
*Traitement batch
+
*Batch processing
*Restaurer les savefiles
+
*Restore savefiles
 
</BR>
 
</BR>
'''Une aide contextuelle est disponible via la touche F1.'''
+
'''Context-sensitive help is available via the F1 key.'''
  
===Affichage de l'historique FTP===
+
===Viewing FTP History===
Affiche la log des commandes exécutées sur le serveur hôte
+
Displays the log of commands executed on the host server
  
==Contenu des savefiles de transfer==
+
==Content of transfer savefiles==
===Deploiement des formats sélectionnés===
+
===Deploying Selected Formats===
====TRANSFERR1 et TRANSFERS1====
+
====TRANSFERR1 and TRANSFERS1====
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Nom de l'objet !! type de l'objet !! Fonction de l'objet
+
! Item Name!! type of the object!! Function of the object
 
|-
 
|-
| DEPLOY1 || *LIB || Bibliothèque contenant les formats à déployer (MAPENV, MAP1, MAP2, etc)
+
| DEPLOY1 || *LIB || Library containing the formats to be deployed (MAPENV, MAP1, MAP2, etc.)
 
|-
 
|-
| DPL003DLY || *PGM || Attend un temps pour avoir la fin des restaurations en cours
+
| DPL003DLY || *PGM || Wait a while for the completion of the ongoing restorations
 
|-
 
|-
| DPL005CPY || *PGM || Programme de copie du formats sélectionnés
+
| DPL005CPY || *PGM || Program for copying selected formats
 
|-
 
|-
| MAP_C016P3 || *PGM || Teste l'existence d'un format et copie de celui-ci
+
| MAP_C016P3 || *PGM || Tests for the existence of a format and copies it
 
|-
 
|-
| MAP_C841 || *PGM || Copie des fichiers afpds si existants
+
| MAP_C841 || *PGM || Copying afpds files if existing
 
|-
 
|-
| MAP_C841P2 || *PGM || Copie des fichiers afpds si existants
+
| MAP_C841P2 || *PGM || Copying afpds files if existing
 
|-
 
|-
| MAP_MSG || *PGM || Récupère le texte d'un message d'après son ID
+
| MAP_MSG || *PGM || Retrieves the text of a message based on its ID
 
|-
 
|-
| MAP_016CHK || *PGM || Teste l'existence d'un format dans les fichiers map et map1
+
| MAP_016CHK || *PGM || Tests for the existence of a format in the map and map1 files
 
|-
 
|-
| MAP_016CPY || *PGM || Programme de copie d'un format de biblio à biblio
+
| MAP_016CPY || *PGM || Program for copying a format from library to library
 
|-
 
|-
| MAP_016DEL || *PGM || Programme de Partnair pour supprimer un format
+
| MAP_016DEL || *PGM || Partnernair's program to remove a format
 
|-
 
|-
| DPLLIBINT || *DTAARA || Nom de la bibliothèque intermédiaire pour MAPDEPLOY
+
| DPLLIBINT || *DTAARA || Intermediate library name for MAPDEPLOY
 
|-
 
|-
| MAPENV || *DTAARA || Dataarea contenant le paramétrage de l'environnement source à déployer
+
| MAPENV || *DTAARA || Dataarea containing the settings of the source environment to be deployed
 
|-
 
|-
| CONVERT || *FILE || Fichier contenant les taux de conversions de l'environnement source à déployer
+
| CONVERT || *FILE || File containing the conversion rates of the source environment to be deployed
 
|-
 
|-
| DPLFORMS || *FILE || Fichier contenant les formats sélectionnés à copier ou supprimer de l'environnement source à déployer
+
| DPLFORMS || *FILE || A file containing the selected formats to be copied or deleted from the source environment to be deployed
 
|-
 
|-
| MAP || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAP || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAPARCH2 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAPARCH2 || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAPARCH3 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAPARCH3 || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAPLNK || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAPLNK || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAPLNKL1 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAPLNKL1 || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAPOBJ || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAPOBJ || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-  
 
|-  
| MAP1 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAP1 || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAP2D || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAP2D || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAP2H || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAP2H || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAP3 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAP3 || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|-
 
|-
| MAP3L1 || *FILE || Fichier contenant les objets des formats à copier de l'environnement source à déployer
+
| MAP3L1 || *FILE || File containing the objects of the formats to be copied from the source environment to be deployed
 
|}
 
|}
  
====TRANSFERR3 et TRANSFERS3====
+
====TRANSFERR3 and TRANSFERS3====
  
Ce savefile contient le contenu du répertoire lgobitmap et du répertoire ttf.  
+
This savefile contains the contents of the lgobitmap directory and the ttf directory.  
 
</BR></BR>
 
</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.
+
<u>Note</u>: This savefile, in a future release, will contain only the contents of the ttf directory, as the lgobitmap directory will have to be managed manually, just as it is already the case for format builds and imports. Indeed, a massive uncontrolled update of the lgobitmap directory can be risky since this directory contains cross-functional resources with several models.
 +
 
 +
==Ideas for evolution==
 +
*Add a resource check before copying formats
 +
*Manage the M-Connect object part (not currently managed)
 +
*Possibility to do a rollback once deployed on an environment

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

Autres langues :
English • ‎français

Introduction

Since 10.8, it is possible to deploy an environment to another environment (remote or local). This can be very useful for copying the environment setting from Preproduction to a 'production environment.

Important: It is important to use it between 'pre-production and production environments (and not development) because this module allows the identical replication of 2 environments (with the possibility of selecting a particular format in order to avoid updating all the formats). If you don't have a staging environment, you should create one or not use this module.

Principle of operation

The MAPDPELOY command (accessible via the Exploitation / Environment Deployment meny) allows you to deploy a staging environment to a production environment. Indeed, in good practice, it is advisable not to generate the models or to create the rules/actions directly on the production environment but on the pre-production environment. Once the processing(s) have been validated on this pre-production environment, it is necessary to send its configuration to the production environment. (Model, rules, actions, etc.). To do this, it is very convenient to use the environment deployment menu. This allows you to fill in the recipient hosts, select the format(s) to send or delete or to send the entire configuration (all formats, rules and actions)

In case you want to send the whole environment (option 11 of the menu), all formats, rules, actions, conversion files, printer settings, etc. will be sent. In the case of a simple sending of selected formats, only this format and a few configuration files are sent (see table below)


Menus

The MAPDEPLOY command has several menus:

1.    General settings
2.    Host server settings

11.  Deploying a full environment

21.  Setting up the formats to be deployed
22.  Deploying Selected Formats

31.  Viewing FTP History

General settings

Use this option to fill in the global settings for deployment management.

  • Source MAPPING library
  • UCS2 Library
  • IFS Path
  • Intermediate library
  • Prefix of savefiles
  • Savefile library
  • Minimum target version
  • FT log file library
  • Authorized users


Context-sensitive help is available via the F1 key.

Host server settings

This option allows you to populate the destination host servers. The host server will be populated during a deployment (partial or global). To create a new host, you need to do F6:

  • Server Name
  • Description
  • Group code
  • Name or address serv.
  • User profile
  • Password
  • Opal Library
  • UCS2 Library
  • IFS Path


Context-sensitive help is available via the F1 key.

Deploying a full environment

  • Deployment servers
  • Source library
  • UCS2 Library
  • IFS Path
  • Batch processing
  • Restore savefiles


Context-sensitive help is available via the F1 key.

Setting up the formats to be deployed

  • Option 1 in front of a format to copy to the host server
  • Option 2 in front of a format to delete it on the host server


Context-sensitive help is available via the F1 key.

Deploying Selected Formats

  • Deployment servers
  • Source library
  • UCS2 Library
  • Intermediate library
  • IFS Path
  • Batch processing
  • Restore savefiles


Context-sensitive help is available via the F1 key.

Viewing FTP History

Displays the log of commands executed on the host server

Content of transfer savefiles

Deploying Selected Formats

TRANSFERR1 and TRANSFERS1

Item Name type of the object Function of the object
DEPLOY1 *LIB Library containing the formats to be deployed (MAPENV, MAP1, MAP2, etc.)
DPL003DLY *PGM Wait a while for the completion of the ongoing restorations
DPL005CPY *PGM Program for copying selected formats
MAP_C016P3 *PGM Tests for the existence of a format and copies it
MAP_C841 *PGM Copying afpds files if existing
MAP_C841P2 *PGM Copying afpds files if existing
MAP_MSG *PGM Retrieves the text of a message based on its ID
MAP_016CHK *PGM Tests for the existence of a format in the map and map1 files
MAP_016CPY *PGM Program for copying a format from library to library
MAP_016DEL *PGM Partnernair's program to remove a format
DPLLIBINT *DTAARA Intermediate library name for MAPDEPLOY
MAPENV *DTAARA Dataarea containing the settings of the source environment to be deployed
CONVERT *FILE File containing the conversion rates of the source environment to be deployed
DPLFORMS *FILE A file containing the selected formats to be copied or deleted from the source environment to be deployed
MAP *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAPARCH2 *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAPARCH3 *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAPLNK *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAPLNKL1 *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAPOBJ *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAP1 *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAP2D *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAP2H *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAP3 *FILE File containing the objects of the formats to be copied from the source environment to be deployed
MAP3L1 *FILE File containing the objects of the formats to be copied from the source environment to be deployed

TRANSFERR3 and TRANSFERS3

This savefile contains the contents of the lgobitmap directory and the ttf directory.

Note: This savefile, in a future release, will contain only the contents of the ttf directory, as the lgobitmap directory will have to be managed manually, just as it is already the case for format builds and imports. Indeed, a massive uncontrolled update of the lgobitmap directory can be risky since this directory contains cross-functional resources with several models.

Ideas for evolution

  • Add a resource check before copying formats
  • Manage the M-Connect object part (not currently managed)
  • Possibility to do a rollback once deployed on an environment