OPALE - 10.0 - Installation - Installation OPALE Server

Différence entre versions

De MappingDoc
(Transfert par FTP)
 
(37 révisions intermédiaires par 7 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
==Pré-requis==
+
<languages />
 +
<translate>
 +
==Pré-requis== <!--T:1-->
  
 +
<!--T:2-->
 
Ce guide décrit les procédures d’installation et de mise à jour du produit OPALE Server sur un système IBM i.  
 
Ce guide décrit les procédures d’installation et de mise à jour du produit OPALE Server sur un système IBM i.  
  
 +
<!--T:3-->
 
Pour rappel, il est recommandé de mettre à jour les autres modules de la solution Mapping en même temps. Cela afin d'éviter toute erreur de compatibilité.
 
Pour rappel, il est recommandé de mettre à jour les autres modules de la solution Mapping en même temps. Cela afin d'éviter toute erreur de compatibilité.
  
===Système===
+
===Système=== <!--T:4-->
  
 +
<!--T:5-->
 
Configuration minimale requise :
 
Configuration minimale requise :
  
*OS/400 V7R1 ou supérieur
+
<!--T:6-->
 +
*OS/400 V7R2 ou supérieur
 
*2 Go d’espace disque
 
*2 Go d’espace disque
 
*Connexion FTP
 
*Connexion FTP
Ligne 15 : Ligne 21 :
 
En cas de mise à jour de M-Processing Server :
 
En cas de mise à jour de M-Processing Server :
  
 +
<!--T:7-->
 
*Se référer au process d'upgrade/migration : [[OPALE:10.0:Migration:Process de migration|Process d'upgrade/Migration]]
 
*Se référer au process d'upgrade/migration : [[OPALE:10.0:Migration:Process de migration|Process d'upgrade/Migration]]
  
 +
<!--T:8-->
 
Remarque : Sur OS/400 V7R1 et supérieur, les versions de M-Processing Server antérieures à la 7.1 ne sont pas compatibles avec Opale.
 
Remarque : Sur OS/400 V7R1 et supérieur, les versions de M-Processing Server antérieures à la 7.1 ne sont pas compatibles avec Opale.
  
===Sécurité===
+
===Sécurité=== <!--T:9-->
  
Le profil <code>QSECOFR</code> est requis pour l’installation.
+
<!--T:10-->
 +
Le profil <code>QSECOFR</code> est requis pour l’installation jusqu'en Opale 10.1.0 (exclut).
  
==Prodécure d’installation ou de mise à jour==
+
A partir de Opale 10.1.0, seul un utilisateur <code>*SECOFR</code> est nécessaire.
  
===Informations de mise à jour===
+
===Console===
 +
Pour le bon affichage de certains menus, il est nécessaire de configurer l'affichage de la console en 27x132 au lieu de 24x80.
 +
 
 +
==Procédure d’installation ou de mise à jour== <!--T:11-->
 +
 
 +
===Informations de mise à jour=== <!--T:12-->
 
Voir process de migration/Upgrade : [[OPALE:10.0:Migration:Process de migration|Process de migration/Update]]
 
Voir process de migration/Upgrade : [[OPALE:10.0:Migration:Process de migration|Process de migration/Update]]
 
===Préparation===
 
===Préparation===
  
 +
<!--T:13-->
 
Le programme d’installation peut être téléchargé depuis le serveur technique Mapping-Suite à l’adresse :
 
Le programme d’installation peut être téléchargé depuis le serveur technique Mapping-Suite à l’adresse :
 
https://server.mappingsuite.com.
 
https://server.mappingsuite.com.
  
 +
<!--T:14-->
 
Il porte un nom suivant le motif '''setup_Opale_vXX.X.X.XXXXX.zip'''.
 
Il porte un nom suivant le motif '''setup_Opale_vXX.X.X.XXXXX.zip'''.
  
 +
<!--T:15-->
 
Après l’avoir téléchargé et décompressé, le fichier d'installation peut être renommé '''<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span>'''.
 
Après l’avoir téléchargé et décompressé, le fichier d'installation peut être renommé '''<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span>'''.
  
===Installation ou mise à jour===
+
===Installation ou mise à jour=== <!--T:16-->
Deux méthodes de transfert du fichier SAVF depuis un PC vers l'IBM sont disponibles :
 
  
*En transfert par FTP
 
*En transfert par SSH vers l'IFS
 
  
 +
====Création du SAVF de restauration==== <!--T:17-->
  
====Création du SAVF de restauration====
+
<!--T:18-->
 
 
 
Exécuter cette commande :
 
Exécuter cette commande :
 
  CRTSAVF FILE(QGPL/<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX</span>)
 
  CRTSAVF FILE(QGPL/<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX</span>)
  
====Transfert par FTP====
+
====Transfert et création du contenu de la librairie==== <!--T:19-->
 +
 
 +
<!--T:20-->
 +
3 solutions sont proposées :
 +
 
 +
<!--T:21-->
 +
*Transfert du fichier <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> par FTP vers la librairie précédemment créée. (Recommandée)
 +
*Transfert du fichier <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> par SCP vers la librairie précédemment créée.
 +
 
 +
<!--T:22-->
 +
Mais il est aussi possible de transférer l'archive ZIP et ensuite :
  
=====Transfert du SAVF vers le Sytème IBM i=====
+
<!--T:23-->
 +
*D'extraire l'archive directement dans la librairie précédemment créée.
  
 +
 +
=====Transfert FTP du SAVF vers le Système IBM i===== <!--T:24-->
 +
 +
<!--T:25-->
 
Transfert du fichier MXXXXX.SAVF vers la librairie créée.
 
Transfert du fichier MXXXXX.SAVF vers la librairie créée.
  
 +
<!--T:26-->
 
*Sous Windows dans Démarrer/Programmes, choisir '''Invite de commande MS-DOS''' (cmd)
 
*Sous Windows dans Démarrer/Programmes, choisir '''Invite de commande MS-DOS''' (cmd)
 
*Se placer dans le dossier où se trouve le fichier qui vient d’être téléchargé. Exemple : '''CD Mes documents\Mapping'''
 
*Se placer dans le dossier où se trouve le fichier qui vient d’être téléchargé. Exemple : '''CD Mes documents\Mapping'''
*Entrer '''ftp "adresse IP de l’AS/400 "''' (sans les guillemets), par exemple ftp 9.5.5.3
+
*Entrer '''ftp ''adresse IP de l’AS/400'' ''', par exemple ftp 9.5.5.3
 
*Puis se reconnecter à l’AS/400 avec utilisateur et mot de passe
 
*Puis se reconnecter à l’AS/400 avec utilisateur et mot de passe
 
*Entrer '''binary'''
 
*Entrer '''binary'''
Ligne 66 : Ligne 96 :
 
*Et enfin '''exit'''
 
*Et enfin '''exit'''
  
 +
 +
<!--T:27-->
 
[[File:Cmdftp.PNG|none|700px]]
 
[[File:Cmdftp.PNG|none|700px]]
  
 +
 +
<!--T:28-->
 
Puis passer à l'étape '''Restauration du SAVF'''.
 
Puis passer à l'étape '''Restauration du SAVF'''.
  
====Transfert SSH sur l'IFS====
+
=====Transfert SSH sur l'IFS===== <!--T:29-->
 
Solution alternative, si l'IBM a son serveur SSH configuré.
 
Solution alternative, si l'IBM a son serveur SSH configuré.
  
Transférer le fichier SAVF (ou directement le ZIP) par le protocole SCP (ex: logiciel WinSCP) vers un dossier de l'IFS.
+
<!--T:30-->
 +
Transférer le fichier SAVF (ou directement le ZIP) par le protocole SCP (ex: logiciel WinSCP) vers la librairie.
  
=====Extraction du SAVF sur l'IFS=====
+
  <!--T:31-->
Si c'est le zip qui a été transféré sur l'AS, l'outils <code>jar</code> sous <code>qsh</code> permet de dézipper des archives.
+
scp <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> user@as400:/QSYS.LIB/QGPL.LIB
  
jar xf setup_Opale_server_v10.0.2.XXXXX.zip
+
<!--T:32-->
 +
Puis passer à l'étape '''Restauration du SAVF'''.
  
Le fichier extrait doit être <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span>
 
  
=====Copie du SAVF dans la librairie=====
+
=====Extraction du SAVF sur l'IFS===== <!--T:33-->
Puis copier ce fichier SAVF brut dans une librairie prévue pour l'occasion, toujours sous <code>qsh</code> :
+
Si c'est le zip qui  a été transféré sur l'AS, l'outils <code>jar</code> permet de dézipper des archives, sous <code>qsh</code>.
  
cp /home/setup/<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> /QSYS.LIB/QGPL.LIB/<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX</span>.FILE
+
<!--T:34-->
 +
Le fichier extrait doit être <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> :
  
====Restauration du SAVF====
+
<!--T:35-->
 +
jar xf setup_Opale_server_v10.0.2.XXXXX.zip
 +
cp <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> /QSYS.LIB/QGPL.LIB/<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX</span>.FILE
  
 +
<!--T:36-->
 +
Puis passer à l'étape '''Restauration du SAVF'''.
 +
 +
====Restauration du SAVF==== <!--T:37-->
 +
 +
<!--T:38-->
 
Exécuter la commande suivante :
 
Exécuter la commande suivante :
 
  RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX</span>)
 
  RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/<span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX</span>)
  
====Lancement du script d'installation====
+
====Lancement du script d'installation==== <!--T:39-->
  
 +
<!--T:40-->
 
Exécuter la commande suivante :
 
Exécuter la commande suivante :
 
  CALL PGM(QTEMP/RUNSETUP)
 
  CALL PGM(QTEMP/RUNSETUP)
  
====Écrans d'installation====
+
====Écrans d'installation==== <!--T:41-->
  
 +
<!--T:42-->
 
Saisir le nom de la bibliothèque à installer.<br />
 
Saisir le nom de la bibliothèque à installer.<br />
 
<u>Attention</u> : Que se soit pour une nouvelle installation ou une mise à jour, ne jamais réutiliser le nom d'une bibliothèque de production. Pour la mise à jour de celle-ci veuillez-vous référer au process de migration/Upgrade suivant :
 
<u>Attention</u> : Que se soit pour une nouvelle installation ou une mise à jour, ne jamais réutiliser le nom d'une bibliothèque de production. Pour la mise à jour de celle-ci veuillez-vous référer au process de migration/Upgrade suivant :
 
[[OPALE:10.0:Migration:Process de migration|Process de migration/Update]]
 
[[OPALE:10.0:Migration:Process de migration|Process de migration/Update]]
  
 +
<!--T:43-->
 
[[File:Install0.PNG|700px|none]]
 
[[File:Install0.PNG|700px|none]]
  
 
   
 
   
 +
<!--T:44-->
 
Il faut renseigner :
 
Il faut renseigner :
  
 +
<!--T:45-->
 
*Le nom du sous-système
 
*Le nom du sous-système
 
*Les dossiers d’installation
 
*Les dossiers d’installation
 
*Le LANGID et la page de code du système
 
*Le LANGID et la page de code du système
  
 +
 +
<!--T:46-->
 
[[File:Install1.PNG|700px|none|]]
 
[[File:Install1.PNG|700px|none|]]
  
  
 +
<!--T:47-->
 
Remarque : La page de code est toujours sur 4 chiffres, par exemple 0037 ou 0500.
 
Remarque : La page de code est toujours sur 4 chiffres, par exemple 0037 ou 0500.
 +
 +
<!--T:48-->
 
Exemple de page de code : <br />
 
Exemple de page de code : <br />
 
0297 : Français sans le caractère euro €<br />
 
0297 : Français sans le caractère euro €<br />
 
1147 : Français avec le caractère Euro € <br />
 
1147 : Français avec le caractère Euro € <br />
  
 +
<!--T:49-->
 
Après cela, lors d'une installation du produit, il faudra [[OPALE:10.0:Saisie_de_la_clef_logicielle|entrer les codes d’activation appelés clés de licence logicielle]]. Vous pouvez également choisir de le faire plus tard en exécutant la commande '''MAPKEY'''. Voir Activation du logiciel. S’il s’agit d’une mise à jour, ou si vous n’avez pas les clés logicielles, appuyez sur <kbd>F3</kbd> pour passer.
 
Après cela, lors d'une installation du produit, il faudra [[OPALE:10.0:Saisie_de_la_clef_logicielle|entrer les codes d’activation appelés clés de licence logicielle]]. Vous pouvez également choisir de le faire plus tard en exécutant la commande '''MAPKEY'''. Voir Activation du logiciel. S’il s’agit d’une mise à jour, ou si vous n’avez pas les clés logicielles, appuyez sur <kbd>F3</kbd> pour passer.
  
 +
 +
<!--T:50-->
 
[[File:Activ1-2.PNG|700px|none]]
 
[[File:Activ1-2.PNG|700px|none]]
  
  
L’installation est terminée lorsque l’écran ci-dessous s’affiche (Paramètres d'environnement de Mapping). Appuyez sur Entrée pour continuer.
+
<!--T:51-->
 +
L’installation est terminée lorsque l’écran ci-dessous s’affiche (Paramètres d'environnement de Mapping). Appuyer sur <kbd>Entrée</kbd> pour continuer.
 
   
 
   
 +
 +
<!--T:52-->
 
[[File:Install param env.PNG|700px|none]]
 
[[File:Install param env.PNG|700px|none]]
  
  
 +
<!--T:53-->
 
Remarque : Après installation et avant d’utiliser le produit, il faudra terminer la session puis se reconnecter.
 
Remarque : Après installation et avant d’utiliser le produit, il faudra terminer la session puis se reconnecter.
  
===Langue===
+
===Langue=== <!--T:54-->
 
====Sélection de la langue dans le menu Mapping====
 
====Sélection de la langue dans le menu Mapping====
  
 +
<!--T:55-->
 
Les écrans du menu Mapping sont disponibles dans les langues suivantes :
 
Les écrans du menu Mapping sont disponibles dans les langues suivantes :
  
 +
<!--T:56-->
 
*Français : MAPMSGFRA
 
*Français : MAPMSGFRA
 
*Anglais : MAPMSGENU
 
*Anglais : MAPMSGENU
 
*Japonais : MAPMSGJPN
 
*Japonais : MAPMSGJPN
  
 +
<!--T:57-->
 
La langue est renseignée dans les paramètres d’environnement (fichier langue + ID langue) :  
 
La langue est renseignée dans les paramètres d’environnement (fichier langue + ID langue) :  
  
 +
<!--T:58-->
 
Menu Mapping (en tapant la commande <code>GO MAPPING</code>), option <kbd>14</kbd> puis option <kbd>1</kbd>.
 
Menu Mapping (en tapant la commande <code>GO MAPPING</code>), option <kbd>14</kbd> puis option <kbd>1</kbd>.
ou dans le menu général Mapping : Menu Exploitations / Paramètre général
+
ou dans le menu général Mapping : Menu Exploitation / Paramètres d'environnement
  
 +
<!--T:59-->
 
Sinon dans le menus OPALE, aller dans exploitation puis choisir le sous menu "Paramètres d'environnement Mapping"
 
Sinon dans le menus OPALE, aller dans exploitation puis choisir le sous menu "Paramètres d'environnement Mapping"
  
 +
<!--T:60-->
 
[[File:Param lang.PNG|600px|none]]
 
[[File:Param lang.PNG|600px|none]]
 
 
 
[[File:Langopale.PNG|600px|none]]
 
[[File:Langopale.PNG|600px|none]]
  
====Pages de code====
+
====Pages de code==== <!--T:61-->
  
=====Pages de code supportées=====
+
=====Pages de code supportées===== <!--T:62-->
 
{| class="wikitable"
 
{| class="wikitable"
 
!Code
 
!Code
Ligne 404 : Ligne 471 :
  
  
=====Pages de code non supportées=====
+
=====Pages de code non supportées===== <!--T:63-->
 
{| class="wikitable"
 
{| class="wikitable"
 
!Code
 
!Code
Ligne 451 : Ligne 518 :
 
|}
 
|}
  
==Activation du logiciel==
+
==Activation du logiciel== <!--T:64-->
  
 +
<!--T:65-->
 
Après installation du logiciel, il faudra saisir les codes d’activation appelés clés de licence logicielle. Les clés sont propres à la machine sur laquelle le logiciel est installé. Pour obtenir les clés logicielles pour votre machine, il est nécessaire de :
 
Après installation du logiciel, il faudra saisir les codes d’activation appelés clés de licence logicielle. Les clés sont propres à la machine sur laquelle le logiciel est installé. Pour obtenir les clés logicielles pour votre machine, il est nécessaire de :
  
 +
<!--T:66-->
 
*Récupérer l’identifiant du système
 
*Récupérer l’identifiant du système
 
*Contacter le Support Technique, ou vous connecter sur http://server.mappingsuite.com
 
*Contacter le Support Technique, ou vous connecter sur http://server.mappingsuite.com
  
 +
<!--T:67-->
 
Remarque : Si les clés logicielles ne sont pas saisies, certains écrans du menu Mapping ne seront pas accessibles.
 
Remarque : Si les clés logicielles ne sont pas saisies, certains écrans du menu Mapping ne seront pas accessibles.
  
===Identifiant serveur===
+
===Identifiant serveur=== <!--T:68-->
  
 +
<!--T:69-->
 
Exécuter la commande <code>MAPKEY</code> pour récupérer les informations nécessaires à la génération de vos clés de licence.
 
Exécuter la commande <code>MAPKEY</code> pour récupérer les informations nécessaires à la génération de vos clés de licence.
 
   
 
   
 
Noter les informations ci-dessous, puis appuyer sur <kbd>F3</kbd> pour sortir.
 
Noter les informations ci-dessous, puis appuyer sur <kbd>F3</kbd> pour sortir.
  
 +
<!--T:70-->
 
*Serial Number
 
*Serial Number
 
*Model Number
 
*Model Number
 
*Processor Type
 
*Processor Type
  
 +
<!--T:71-->
 
[[File:Activ-infos.PNG|600px|none]]
 
[[File:Activ-infos.PNG|600px|none]]
  
===Saisie des clés de Licence===
+
===Saisie des clés de Licence=== <!--T:72-->
  
 +
<!--T:73-->
 
Le nombre de clés de licence requises dépend des options achetées.
 
Le nombre de clés de licence requises dépend des options achetées.
  
Pour chaque clé, exécuter la commande <code>MAPKEY</code> et [[OPALE:10.0:Saisie_de_la_clef_logicielle|saisir le numéro du produit associé à la clé]], puis appuyer sur Entrée pour valider.  
+
<!--T:74-->
 +
Pour chaque clé, exécuter la commande <code>MAPKEY</code> et [[OPALE:10.0:Saisie_de_la_clef_logicielle|saisir le numéro du produit associé à la clé]], puis appuyer sur <kbd>Entrée</kbd> pour valider.  
  
 +
<!--T:75-->
 
[[File:Activ1-3.PNG|600px|none]]
 
[[File:Activ1-3.PNG|600px|none]]
  
  
Remarque : Si la clé saisie est correcte, l’écran suivant s’affiche. Sinon, la clé est mise en surbrillance comme illustré ci-dessous :
+
<!--T:76-->
 
+
Remarque : Si la clé saisie est correcte, l’écran ci-dessus s’affiche et il n'y a pas de message de confirmation. Sinon, la clé est mise en surbrillance.
[[File:Erroroactivation.PNG|600px|none]]
 
  
==Vérification après installation==
+
==Vérification après installation== <!--T:78-->
  
 +
<!--T:79-->
 
Ce chapitre est conçu pour vous aider à contrôler que le processus d’installation s’est déroulé sans accroc et que l’environnement Mapping est configuré correctement.
 
Ce chapitre est conçu pour vous aider à contrôler que le processus d’installation s’est déroulé sans accroc et que l’environnement Mapping est configuré correctement.
  
 +
<!--T:80-->
 
Il suffit de suivre chaque étape pas à pas. Tous les points à vérifier sont listés ci-dessous.
 
Il suffit de suivre chaque étape pas à pas. Tous les points à vérifier sont listés ci-dessous.
  
===Activation du profil utilisateur MAPPING===
+
===Activation du profil utilisateur MAPPING=== <!--T:81-->
  
 +
<!--T:82-->
 
La première chose à faire est d’activer le profil MAPPING sur le système.
 
La première chose à faire est d’activer le profil MAPPING sur le système.
  
 +
<!--T:83-->
 
Par défaut, lors de l’installation, le profil utilisateur MAPPING est créé avec le mot de passe à blanc.
 
Par défaut, lors de l’installation, le profil utilisateur MAPPING est créé avec le mot de passe à blanc.
  
 +
<!--T:84-->
 
Exécuter la commande <code>CHGUSRPRF</code> pour définir un mot de passe pour l’utilisateur MAPPING.
 
Exécuter la commande <code>CHGUSRPRF</code> pour définir un mot de passe pour l’utilisateur MAPPING.
  
 +
<!--T:85-->
 
Si cela n’est pas fait, vous ne pourrez pas utiliser ce profil à des fins de test.
 
Si cela n’est pas fait, vous ne pourrez pas utiliser ce profil à des fins de test.
  
 +
<!--T:86-->
 
Ce profil a toutes les autorisations nécessaires à l’utilisation du logiciel MAPPING. Il s’agit d’un profil de type <code>*PGMR</code> qui peut être utilisé comme bon vous semble si nécessaire.
 
Ce profil a toutes les autorisations nécessaires à l’utilisation du logiciel MAPPING. Il s’agit d’un profil de type <code>*PGMR</code> qui peut être utilisé comme bon vous semble si nécessaire.
  
===Vérification de l’environnement MAPPING===
+
===Vérification de l’environnement MAPPING=== <!--T:87-->
  
 +
<!--T:88-->
 
Sur la ligne de commande, taper <code>MAPPING</code> pour accéder au menu principal.
 
Sur la ligne de commande, taper <code>MAPPING</code> pour accéder au menu principal.
  
 +
<!--T:89-->
 
Sélectionner l’option "Paramètres d'environnement Mapping" dans le menu Exploitation.
 
Sélectionner l’option "Paramètres d'environnement Mapping" dans le menu Exploitation.
  
 +
<!--T:90-->
 
Les chemins sont affichés en bas de l’écran et les valeurs dépendent du langage système (les valeurs peuvent changer selon le système sur lequel le logiciel est installé).
 
Les chemins sont affichés en bas de l’écran et les valeurs dépendent du langage système (les valeurs peuvent changer selon le système sur lequel le logiciel est installé).
  
===Vérification de l’IFS===
+
===Vérification de l’IFS=== <!--T:91-->
  
 +
<!--T:92-->
 
Il est aussi recommandé de vérifier l’IFS lui-même. La façon la plus rapide de faire cela est d’utiliser la commande WRKLNK.  
 
Il est aussi recommandé de vérifier l’IFS lui-même. La façon la plus rapide de faire cela est d’utiliser la commande WRKLNK.  
 
Dans tous les cas, les dossiers suivants doivent être présents dans l’IFS : mapout, mapping, mapreport, mapsend.
 
Dans tous les cas, les dossiers suivants doivent être présents dans l’IFS : mapout, mapping, mapreport, mapsend.
  
===Objets système requis par le logiciel MAPPING===
+
===Objets système requis par le logiciel MAPPING=== <!--T:93-->
  
 +
<!--T:94-->
 
Pour approfondir le diagnostic, il faudrait vérifier les Job Queues et les Job Descriptions. Utiliser la commande WRKOBJ pour afficher les objets MAP* requis par le logiciel.
 
Pour approfondir le diagnostic, il faudrait vérifier les Job Queues et les Job Descriptions. Utiliser la commande WRKOBJ pour afficher les objets MAP* requis par le logiciel.
  
 +
<!--T:95-->
 
Les Job Queues suivantes doivent apparaitre :  
 
Les Job Queues suivantes doivent apparaitre :  
 
  MAPQFIND, MAPQMIDDLE, MAPQROBOT, MAPQSLOW, MAPQSMTP, MAPQSMTP2, MAPQSPEED, MAPQTCPIP
 
  MAPQFIND, MAPQMIDDLE, MAPQROBOT, MAPQSLOW, MAPQSMTP, MAPQSMTP2, MAPQSPEED, MAPQTCPIP
  
 +
<!--T:96-->
 
Les Job Descriptions suivantes doivent apparaitre :  
 
Les Job Descriptions suivantes doivent apparaitre :  
 
  MAPDFIND, MAPDMIDDLE, MAPDROBOT, MAPDSLOW, MAPDSMTP, MAPDSMTP2, MAPDSPEED, MAPDTCPIP
 
  MAPDFIND, MAPDMIDDLE, MAPDROBOT, MAPDSLOW, MAPDSMTP, MAPDSMTP2, MAPDSPEED, MAPDTCPIP
  
===Démarrage du Robot===
+
===Démarrage du Robot=== <!--T:97-->
  
 +
<!--T:98-->
 
Démarrer le robot à l’aide de la commande <code>STRRBT</code>, puis afficher le sous-système à l’aide de la commande <code>WRKSBS</code>.
 
Démarrer le robot à l’aide de la commande <code>STRRBT</code>, puis afficher le sous-système à l’aide de la commande <code>WRKSBS</code>.
[[Category:AS400]]
+
</translate>

Version actuelle datée du 19 novembre 2021 à 09:44

Autres langues :
English • ‎français

Pré-requis

Ce guide décrit les procédures d’installation et de mise à jour du produit OPALE Server sur un système IBM i.

Pour rappel, il est recommandé de mettre à jour les autres modules de la solution Mapping en même temps. Cela afin d'éviter toute erreur de compatibilité.

Système

Configuration minimale requise :

  • OS/400 V7R2 ou supérieur
  • 2 Go d’espace disque
  • Connexion FTP

En cas de mise à jour de M-Processing Server :

Remarque : Sur OS/400 V7R1 et supérieur, les versions de M-Processing Server antérieures à la 7.1 ne sont pas compatibles avec Opale.

Sécurité

Le profil QSECOFR est requis pour l’installation jusqu'en Opale 10.1.0 (exclut).

A partir de Opale 10.1.0, seul un utilisateur *SECOFR est nécessaire.

Console

Pour le bon affichage de certains menus, il est nécessaire de configurer l'affichage de la console en 27x132 au lieu de 24x80.

Procédure d’installation ou de mise à jour

Informations de mise à jour

Voir process de migration/Upgrade : Process de migration/Update

Préparation

Le programme d’installation peut être téléchargé depuis le serveur technique Mapping-Suite à l’adresse : https://server.mappingsuite.com.

Il porte un nom suivant le motif setup_Opale_vXX.X.X.XXXXX.zip.

Après l’avoir téléchargé et décompressé, le fichier d'installation peut être renommé MXXXXX.SAVF.

Installation ou mise à jour

Création du SAVF de restauration

Exécuter cette commande :

CRTSAVF FILE(QGPL/MXXXXX)

Transfert et création du contenu de la librairie

3 solutions sont proposées :

  • Transfert du fichier MXXXXX.SAVF par FTP vers la librairie précédemment créée. (Recommandée)
  • Transfert du fichier MXXXXX.SAVF par SCP vers la librairie précédemment créée.

Mais il est aussi possible de transférer l'archive ZIP et ensuite :

  • D'extraire l'archive directement dans la librairie précédemment créée.


Transfert FTP du SAVF vers le Système IBM i

Transfert du fichier MXXXXX.SAVF vers la librairie créée.

  • Sous Windows dans Démarrer/Programmes, choisir Invite de commande MS-DOS (cmd)
  • Se placer dans le dossier où se trouve le fichier qui vient d’être téléchargé. Exemple : CD Mes documents\Mapping
  • Entrer ftp adresse IP de l’AS/400 , par exemple ftp 9.5.5.3
  • Puis se reconnecter à l’AS/400 avec utilisateur et mot de passe
  • Entrer binary
  • Entrer cd qgpl (ou la bibliothèque où se trouve le fichier savf qui a été créé)
  • Entrer put MXXXXX.savf
  • … (le fichier est transféré puis vous récupérez le contrôle)
  • Entrer close
  • Puis quit
  • Et enfin exit


Cmdftp.PNG


Puis passer à l'étape Restauration du SAVF.

Transfert SSH sur l'IFS

Solution alternative, si l'IBM a son serveur SSH configuré.

Transférer le fichier SAVF (ou directement le ZIP) par le protocole SCP (ex: logiciel WinSCP) vers la librairie.

scp MXXXXX.SAVF user@as400:/QSYS.LIB/QGPL.LIB

Puis passer à l'étape Restauration du SAVF.


Extraction du SAVF sur l'IFS

Si c'est le zip qui a été transféré sur l'AS, l'outils jar permet de dézipper des archives, sous qsh.

Le fichier extrait doit être MXXXXX.SAVF :

jar xf setup_Opale_server_v10.0.2.XXXXX.zip
cp MXXXXX.SAVF /QSYS.LIB/QGPL.LIB/MXXXXX.FILE

Puis passer à l'étape Restauration du SAVF.

Restauration du SAVF

Exécuter la commande suivante :

RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/MXXXXX)

Lancement du script d'installation

Exécuter la commande suivante :

CALL PGM(QTEMP/RUNSETUP)

Écrans d'installation

Saisir le nom de la bibliothèque à installer.
Attention : Que se soit pour une nouvelle installation ou une mise à jour, ne jamais réutiliser le nom d'une bibliothèque de production. Pour la mise à jour de celle-ci veuillez-vous référer au process de migration/Upgrade suivant : Process de migration/Update

Install0.PNG


Il faut renseigner :

  • Le nom du sous-système
  • Les dossiers d’installation
  • Le LANGID et la page de code du système


Install1.PNG


Remarque : La page de code est toujours sur 4 chiffres, par exemple 0037 ou 0500.

Exemple de page de code :
0297 : Français sans le caractère euro €
1147 : Français avec le caractère Euro €

Après cela, lors d'une installation du produit, il faudra entrer les codes d’activation appelés clés de licence logicielle. Vous pouvez également choisir de le faire plus tard en exécutant la commande MAPKEY. Voir Activation du logiciel. S’il s’agit d’une mise à jour, ou si vous n’avez pas les clés logicielles, appuyez sur F3 pour passer.


Activ1-2.PNG


L’installation est terminée lorsque l’écran ci-dessous s’affiche (Paramètres d'environnement de Mapping). Appuyer sur Entrée pour continuer.


Install param env.PNG


Remarque : Après installation et avant d’utiliser le produit, il faudra terminer la session puis se reconnecter.

Langue

Sélection de la langue dans le menu Mapping

Les écrans du menu Mapping sont disponibles dans les langues suivantes :

  • Français : MAPMSGFRA
  • Anglais : MAPMSGENU
  • Japonais : MAPMSGJPN

La langue est renseignée dans les paramètres d’environnement (fichier langue + ID langue) :

Menu Mapping (en tapant la commande GO MAPPING), option 14 puis option 1. ou dans le menu général Mapping : Menu Exploitation / Paramètres d'environnement

Sinon dans le menus OPALE, aller dans exploitation puis choisir le sous menu "Paramètres d'environnement Mapping"

Param lang.PNG

Langopale.PNG

Pages de code

Pages de code supportées
Code Codepage ISO Nom Fichier
AFR (037) {latin1:1252} Afrikaans [Q037_19U-Q19U_037]
BEL (1025,1154) {Russian:1251} Byelorussian [Q1154_9R-Q9R-1154]
BGR (1025,1154) {Russian:1251} Bulgarian [Q1154_9R-Q9R-1154]
CSY (0870,1153) {latin2:1250} Czech [Q1153_9E-Q9E_1153]
DES (0500) {latin1:1252} Swiss German [Q1141_19U-Q19U_1141]
DEU (0273,1141) {latin1:1252} German [Q1141_19U-Q19U_1141]
CHS {0836} {s.chinese:00935} Simplified Chinese [Q013_19U-Q19U_037- S_Chinese_base1993.tbl]
CHT {0037} {t.chinese:00937} Traditional Chinese [Q013_19U-Q19U_037- T_Chinese_base1999.tbl]
ELL (0875) {Greek:1253} Greek [Q875_9G-Q9G_875]
ENA (037) {latin1:1252} Australian English [Q037_19U-Q19U_037]
ENG (0285,1146) {latin1:1252} United Kingdom English [Q285_19U-Q19U_285]
ENP (037) {latin1:1252} Uppercase English [Q037_19U-Q19U_037]
ENU (037) {latin1:1252} United States English [Q037_19U-Q19U_037]
ESP (0284,1145) {latin1:1252} Spanish [Q1145_19U-Q19U_1145]
FRA (0297,1147) {latin1:1252} French [Q1147_19U-Q19U_1147]
FRB (0500,1148) {latin1:1252} Belgian French [Q1148_19U-Q19U_1148]
FRC (0500) {latin1:1252} Canadian French [Q1148_19U-Q19U_1148]
FRS (0500) {latin1:1252} Swiss French [Q1148_19U-Q19U_1148]
GAE (0285,1146) {latin1:1252} Irish Gaelic [Q285_19U-Q19U_285]
HRV (0870,1153) {latin2:1250} Croatian [Q1153_9E-Q9E_1153]
HUN (0870,1153) {latin2:1250} Hungarian [Q1153_9E-Q9E_1153]
ITA (0280,1144) {latin1:1252} Italian [Q1144_19U-Q19U_1144]
ITS (0500) {latin1:1252} Swiss Italian [Q1148_19U-Q19U_1148]
JPN {0290} {Japanese:05026} Japanese Katakana [Q013_19U-Q19U_037- Japanese_base1996.tbl]
KOR {0833} {Korean:00933} Korean [Q013_19U-Q19U_037- Korean_base1992.tbl]
MKD (1025,1154) {Russian:1251} Macedonian [Q1154_9R-Q9R-1154]
NLB (0500,1148) {latin1:1252) Belgian Dutch [Q1148_19U-Q19U_1148]
NLD (037,1140) {latin1:1252} Dutch [Q037_19U-Q19U_037]
PLK (0870,1153) {latin2:1250} Polish [Q1153_9E-Q9E_1153]
PTB (037) {latin1:1252} Brazilian Portuguese [Q037_19U-Q19U_037]
PTG (037,1140) {latin1:1252} Portuguese [Q037_19U-Q19U_037]
ROM (0870,1153) {latin2:1250} Romanian [Q1153_9E-Q9E_1153]
RUS (1025,1154) {Russian:1251} Russian [Q1154_9R-Q9R_1154]
SKY (0870,1153) {latin2:1250} Slovakian [Q1153_9E-Q9E_1153]
SLO (0870,1153) {latin2:1250} Slovenian [Q1153_9E-Q9E_1153]
SQI (0500) {latin1:1252} Albanian [Q1148_19U-Q19U_1148]
SRB (1025,1154) {Russian:1251} Serbian Cyrillic [Q1154_9R-Q9R-1154]
SRL (0870,1153) {latin2:1250} Serbian Latin [Q1153_9E-Q9E_1153]
TRK (1026,1155) {Turkish:1254} Turkish [Q1155_5T-Q5T_1155]
THA {0838} {Thai :874} Thai [Q838_0T-Q0T_383]


Pages de code non supportées
Code Codepage Nom
ARA 0420 Arabic
CAT 0284 Catalan
DAN 0277 Danish
FAR 1097 Farsi
FIN 0278 Finnish
HEB 0424 None Hebrew
ISL 0871 1149 Icelandic
NON 0277 Norwegian Nynorsk
NOR 0277 Norwegian Bokmal
SVE 0278 Swedish

Activation du logiciel

Après installation du logiciel, il faudra saisir les codes d’activation appelés clés de licence logicielle. Les clés sont propres à la machine sur laquelle le logiciel est installé. Pour obtenir les clés logicielles pour votre machine, il est nécessaire de :

Remarque : Si les clés logicielles ne sont pas saisies, certains écrans du menu Mapping ne seront pas accessibles.

Identifiant serveur

Exécuter la commande MAPKEY pour récupérer les informations nécessaires à la génération de vos clés de licence.

Noter les informations ci-dessous, puis appuyer sur F3 pour sortir.

  • Serial Number
  • Model Number
  • Processor Type
Activ-infos.PNG

Saisie des clés de Licence

Le nombre de clés de licence requises dépend des options achetées.

Pour chaque clé, exécuter la commande MAPKEY et saisir le numéro du produit associé à la clé, puis appuyer sur Entrée pour valider.

Activ1-3.PNG


Remarque : Si la clé saisie est correcte, l’écran ci-dessus s’affiche et il n'y a pas de message de confirmation. Sinon, la clé est mise en surbrillance.

Vérification après installation

Ce chapitre est conçu pour vous aider à contrôler que le processus d’installation s’est déroulé sans accroc et que l’environnement Mapping est configuré correctement.

Il suffit de suivre chaque étape pas à pas. Tous les points à vérifier sont listés ci-dessous.

Activation du profil utilisateur MAPPING

La première chose à faire est d’activer le profil MAPPING sur le système.

Par défaut, lors de l’installation, le profil utilisateur MAPPING est créé avec le mot de passe à blanc.

Exécuter la commande CHGUSRPRF pour définir un mot de passe pour l’utilisateur MAPPING.

Si cela n’est pas fait, vous ne pourrez pas utiliser ce profil à des fins de test.

Ce profil a toutes les autorisations nécessaires à l’utilisation du logiciel MAPPING. Il s’agit d’un profil de type *PGMR qui peut être utilisé comme bon vous semble si nécessaire.

Vérification de l’environnement MAPPING

Sur la ligne de commande, taper MAPPING pour accéder au menu principal.

Sélectionner l’option "Paramètres d'environnement Mapping" dans le menu Exploitation.

Les chemins sont affichés en bas de l’écran et les valeurs dépendent du langage système (les valeurs peuvent changer selon le système sur lequel le logiciel est installé).

Vérification de l’IFS

Il est aussi recommandé de vérifier l’IFS lui-même. La façon la plus rapide de faire cela est d’utiliser la commande WRKLNK. Dans tous les cas, les dossiers suivants doivent être présents dans l’IFS : mapout, mapping, mapreport, mapsend.

Objets système requis par le logiciel MAPPING

Pour approfondir le diagnostic, il faudrait vérifier les Job Queues et les Job Descriptions. Utiliser la commande WRKOBJ pour afficher les objets MAP* requis par le logiciel.

Les Job Queues suivantes doivent apparaitre :

MAPQFIND, MAPQMIDDLE, MAPQROBOT, MAPQSLOW, MAPQSMTP, MAPQSMTP2, MAPQSPEED, MAPQTCPIP

Les Job Descriptions suivantes doivent apparaitre :

MAPDFIND, MAPDMIDDLE, MAPDROBOT, MAPDSLOW, MAPDSMTP, MAPDSMTP2, MAPDSPEED, MAPDTCPIP

Démarrage du Robot

Démarrer le robot à l’aide de la commande STRRBT, puis afficher le sous-système à l’aide de la commande WRKSBS.