Différence entre versions

Version du 20 mai 2019 à 14:00

Sommaire

1 Pré-requis
- 1.1 Système
- 1.2 Sécurité
2 Update or installation procedure
3 Activation du logiciel
- 3.1 Identifiant serveur
- 3.2 Saisie des clés de Licence
4 Vérification après installation

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 V7R1 ou supérieur
2 Go d’espace disque
Connexion FTP

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

Se référer au process d'upgrade/migration : Process d'upgrade/Migration

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é

The QSECOFR profile is required to install the software.

Update or installation procedure

Update information

Please refer to the : Upgrade Process

Preparation

The software installation program can be downloaded from the Mapping Suite technical server at https://server.mappingsuite.com.

It is called setup_Opale_vXX.X.X.XXXXX.zip.

After downloading and uncompressing, it can safely be renamed to MXXXXX.SAVF.

Installing or updating by FTP

Creating the restore SAVF

Run this command:

CRTSAVF FILE(QGPL/MXXXXX)

Transferring and creating content from the library

There are 3 solutions

Transferring the file MXXXXX.SAVF via FTP to the previously created library. (Recommanded)
Transferring the file MXXXXX.SAVF via SCP to the previously created library.

However, it is also possible to transfer the ZIP archive and afterwards:

to extract the archive directly from the previously created library.

Transferring FTP from the SAVF to the IBM i system

Transferring the MXXXXX.SAVF to the created library.

Under Windows in Start/Programs, choose MS-DOS Command Prompt
Go to the folder where the file you have just downloaded is saved e.g. CD My documents\Mapping
Enter ftp "AS400 IP address" (no quotes) e.g. ftp 9.5.5.3
And then sign in on the IBM i
Enter binary
Enter cd qgpl (or the library of the savf file you have created)
Enter put MXXXXX.savf
… (the file is being transferred and then you regain control)
Enter close
Then quit
And then exit

Then, skip to Restoring the SAVF.

SSH Transfer to the IFS

If the IBM has its SSH server configured.

Transfer the SAVF file (or the ZIP file) using the SCP protocol (e.g. using WinSCP) to a folder on the IFS.

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

Then, skip to Restoring the SAVF.

Extracting the SAVF from the IFS

If the ZIP has been transfered to the AS, the jar tool allows you to unzip archives, under qsh.

The extracted file should be MXXXXX.SAVF :

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

Then skip to Restoring the SAVF.

Restoring the SAVF

Run this command:

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

Launch the installation script

Run this command:

CALL PGM(QTEMP/RUNSETUP)

Installation steps

Enter the name of the library you want to install or update.
Caution : Whether this is a new install or an upgrade, do not use a production library. Please refer to the Upgrade process

Il faut renseigner :

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

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.

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

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"

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 :

Récupérer l’identifiant du système
Contacter le Support Technique, ou vous connecter sur http://server.mappingsuite.com

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

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.

Remarque : Si la clé saisie est correcte, l’écran suivant s’affiche. Sinon, la clé est mise en surbrillance comme illustré ci-dessous :

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.

@@ Ligne 109 : / Ligne 109 : @@
 ====Installation steps====
-Saisir le nom de la bibliothèque à installer.<br />
+Enter the name of the library you want to install or update.<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>Caution</u> : Whether this is a new install or an upgrade, do not use a production library. Please refer to the [[OPALE:10.0:Migration:Process de migration|Upgrade process]]
-[[OPALE:10.0:Migration:Process de migration|Process de migration/Update]]
 [[File:Install0.PNG|700px|none]]