OPALE - 10.0 - Installation - Installation OPALE Server/en

Différence entre versions

De MappingDoc
(Page créée avec « ==Update or installation procedure== »)
(Contenu remplacé par « . »)
 
(136 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
==Pré-requis==
+
<languages />
 +
==Requirements==
  
Ce guide décrit les procédures d’installation et de mise à jour du produit OPALE Server sur un système IBM i.  
+
This guide explains how to install and update OPALE Server on an IBM i server.  
  
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é.
+
As a reminder, it is recommended to also update the other Mapping Suite software components at the same time to prevent errors due to version conflicts.
  
===Système===
+
===System===
  
Configuration minimale requise :
+
Minimum requirements:
  
*OS/400 V7R1 ou supérieur
+
*OS/400 V7R1 or higher
*2 Go d’espace disque
+
*2 Gb of free disk space
*Connexion FTP
+
*FTP connection
+
 
En cas de mise à jour de M-Processing Server :
+
In case of M-Processing Server update:
  
*Se référer au process d'upgrade/migration : [[OPALE:10.0:Migration:Process de migration|Process d'upgrade/Migration]]
+
*Please refer to the [[OPALE:10.0:Migration:Process de migration|Upgrade Process]].
  
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.
+
Note: On OS/400 V7R1 and higher, the versions of M-Processing Server older than 7.1 are not compatible.
  
===Sécurité===
+
===Security===
  
 
The <code>QSECOFR</code> profile is required to install the software.
 
The <code>QSECOFR</code> profile is required to install the software.
Ligne 25 : Ligne 26 :
 
==Update or installation procedure==
 
==Update or installation procedure==
  
===Informations de mise à jour===
+
===Update information===
Voir process de migration/Upgrade : [[OPALE:10.0:Migration:Process de migration|Process de migration/Update]]
+
Please refer to the : [[OPALE:10.0:Migration:Process de migration|Upgrade Process]]
===Préparation===
+
===Preparation===
  
Le programme d’installation peut être téléchargé depuis le serveur technique Mapping-Suite à l’adresse :
+
The software installation program can be downloaded from the Mapping Suite technical server at https://server.mappingsuite.com.
https://server.mappingsuite.com.
 
  
Il porte un nom suivant le motif '''setup_Opale_vXX.X.X.XXXXX.zip'''.
+
It is called setup_Opale_vXX.X.X.XXXXX.zip.
  
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>'''.
+
After downloading and uncompressing, it can safely be renamed to <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span>.
  
===Installation ou mise à jour===
+
===Installing or updating by FTP===
  
  
====Création du SAVF de restauration====
+
====Creating the restore SAVF====
  
Exécuter cette commande :
+
Run this command:
 
  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 et création du contenu de la librairie====
+
====Transferring and creating content from the library====
  
3 solutions sont proposées :
+
There are 3 solutions:
  
*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)
+
*Transferring the file <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> via FTP to the previously created library (recommended).
*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.
+
*Transferring the file <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> via SCP to the previously created library.
  
Mais il est aussi possible de transférer l'archive ZIP et ensuite :
+
However, it is also possible to transfer the ZIP archive and then:
  
*D'extraire l'archive directement dans la librairie précédemment créée.
+
*Extract the archive directly into the library created previously.
  
  
=====Transfert FTP du SAVF vers le Système IBM i=====
+
=====Transferring the SAVF to the IBM i using FTP=====
  
Transfert du fichier MXXXXX.SAVF vers la librairie créée.
+
Transferring the MXXXXX.SAVF to the created library.
  
*Sous Windows dans Démarrer/Programmes, choisir '''Invite de commande MS-DOS''' (cmd)
+
*Under Windows in Start/Programs, choose MS-DOS Command Prompt
*Se placer dans le dossier où se trouve le fichier qui vient d’être téléchargé. Exemple : '''CD Mes documents\Mapping'''
+
*Go to the folder where the file you have just downloaded is saved e.g. CD My documents\Mapping
*Entrer '''ftp "adresse IP de l’AS/400 "''' (sans les guillemets), par exemple ftp 9.5.5.3
+
*Enter ftp "AS400 IP address" (no quotes) e.g. ftp 9.5.5.3
*Puis se reconnecter à l’AS/400 avec utilisateur et mot de passe
+
*And then sign in on the IBM i
*Entrer '''binary'''
+
*Enter '''binary'''
*Entrer '''cd qgpl''' (ou la bibliothèque où se trouve le fichier savf qui a été créé)
+
*Enter '''cd qgpl''' (or the library of the savf file you have created)
*Entrer '''put <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.savf</span>'''
+
*Enter '''put <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.savf</span>'''
*… (le fichier est transféré puis vous récupérez le contrôle)
+
*… (the file is being transferred and then you regain control)
*Entrer '''close'''
+
*Enter '''close'''
*Puis '''quit'''
+
*Then '''quit'''
*Et enfin '''exit'''
+
*And then '''exit'''
  
  
Ligne 76 : Ligne 76 :
  
  
Puis passer à l'étape '''Restauration du SAVF'''.
+
Then, skip to '''Restoring the SAVF'''.
  
=====Transfert SSH sur l'IFS=====
+
=====SSH Transfer to the IFS=====
Solution alternative, si l'IBM a son serveur SSH configuré.
+
If the IBM i has its SSH server configured.
  
Transférer le fichier SAVF (ou directement le ZIP) par le protocole SCP (ex: logiciel WinSCP) vers la librairie.
+
Transfer the SAVF file (or the ZIP file) using the SCP protocol (e.g. using WinSCP) to a folder on the IFS.
  
 
  scp <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> user@as400:/QSYS.LIB/QGPL.LIB
 
  scp <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> user@as400:/QSYS.LIB/QGPL.LIB
  
Puis passer à l'étape '''Restauration du SAVF'''.
+
Then, skip to '''Restoring the SAVF'''.
  
  
=====Extraction du SAVF sur l'IFS=====
+
=====Extracting the SAVF to the IFS=====
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>.
+
If the ZIP archive has been transferred to the IBM i, you can use the <code>jar</code> tool to unzip it, under <code>qsh</code>.
  
Le fichier extrait doit être <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> :
+
The extracted file should be <span style="background-color:rgba(0, 0, 255, 0.2);">MXXXXX.SAVF</span> :
  
 
  jar xf setup_Opale_server_v10.0.2.XXXXX.zip
 
  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
 
  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
  
Puis passer à l'étape '''Restauration du SAVF'''.
+
Then skip to '''Restoring the SAVF'''.
  
====Restauration du SAVF====
+
====Restoring the SAVF====
  
Exécuter la commande suivante :
+
Run this command:
 
  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====
+
====Launch the installation script====
  
Exécuter la commande suivante :
+
Run this command:
 
  CALL PGM(QTEMP/RUNSETUP)
 
  CALL PGM(QTEMP/RUNSETUP)
  
====Écrans d'installation====
+
====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]]
 
[[File:Install0.PNG|700px|none]]
  
 
   
 
   
Il faut renseigner :
+
You will need to specify the:
  
*Le nom du sous-système
+
*Sub-system name
*Les dossiers d’installation
+
*Installation folders
*Le LANGID et la page de code du système
+
*System LANGID and code page
  
  
Ligne 127 : Ligne 126 :
  
  
Remarque : La page de code est toujours sur 4 chiffres, par exemple 0037 ou 0500.
+
Note: The code page must always be 4 digits. Example 0037 or 0500.
  
Exemple de page de code : <br />
+
Sample code page: <br />
0297 : Français sans le caractère euro €<br />
+
0297: French without Euro symbol<br />
1147 : Français avec le caractère Euro € <br />
+
1147: French with Euro € symbol <br />
  
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.
+
After that if you are installing the product, you will need to [[OPALE:10.0:Saisie_de_la_clef_logicielle|enter the software activation codes called software keys]]. If you skip this step, you can do it later by running the '''MAPKEY''' command. See Software Activation. If you are updating the product or do not have the software activation keys now, press <kbd>F3</kbd> to skip.
  
  
[[File:Activ1-2.PNG|700px|none]]
+
[[File:OP_S_MAPKEY_EN.JPG|700px|none]]
  
  
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.
+
Installation is complete when the following screen is displayed. Press  <kbd>Enter</kbd> to continue.
 
   
 
   
  
[[File:Install param env.PNG|700px|none]]
+
[[File:OP_S_environment_en.JPG|700px|none]]
  
  
Remarque : Après installation et avant d’utiliser le produit, il faudra terminer la session puis se reconnecter.
+
Note: After installing and before using the product, you will need to end the session and sign back in.
  
===Langue===
+
===Language===
====Sélection de la langue dans le menu Mapping====
+
====Selecting the language in the Mapping menu====
  
Les écrans du menu Mapping sont disponibles dans les langues suivantes :
+
The screens of the Mapping menu can be displayed in the following languages:
  
*Français : MAPMSGFRA
+
*French: MAPMSGFRA
*Anglais : MAPMSGENU
+
*English: MAPMSGENU
*Japonais : MAPMSGJPN
+
*Japanese: MAPMSGJPN
  
La langue est renseignée dans les paramètres d’environnement (fichier langue + ID langue) :
+
The language is specified in the environment settings (Language File + Language ID).
  
Menu Mapping (en tapant la commande <code>GO MAPPING</code>), option <kbd>14</kbd> puis option <kbd>1</kbd>.
+
Mapping Menu (enter the command <code>GO MAPPING</code>), choose Option <kbd>14</kbd> then Option <kbd>1</kbd>.
ou dans le menu général Mapping : Menu Exploitation / Paramètres d'environnement
+
or from the general Mapping menu: Operations menu / Mapping Environment Settings
  
Sinon dans le menus OPALE, aller dans exploitation puis choisir le sous menu "Paramètres d'environnement Mapping"
+
Otherwise, from the OPALE menu, choose Operations and then "Mapping Environment Settings"
  
[[File:Param lang.PNG|600px|none]]
+
[[File:OP_S_param_envir.JPG|700px|none]]
 
 
[[File:Langopale.PNG|600px|none]]
+
[[File:OP_S_environment_lang_en.jpg|700px|none]]
  
====Pages de code====
+
====Code pages====
  
=====Pages de code supportées=====
+
=====Supported code pages=====
 
{| class="wikitable"
 
{| class="wikitable"
 
!Code
 
!Code
Ligne 419 : Ligne 418 :
  
  
=====Pages de code non supportées=====
+
=====Unsupported code pages=====
 
{| class="wikitable"
 
{| class="wikitable"
 
!Code
 
!Code
Ligne 466 : Ligne 465 :
 
|}
 
|}
  
==Activation du logiciel==
+
==Software Activation==
  
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 :
+
After installing the software, you will need to enter activation codes called licence keys. The licence keys are hardware-dependent. To obtain the licence keys for your system, you will need to:
  
*Récupérer l’identifiant du système
+
*Retrieve the system id
*Contacter le Support Technique, ou vous connecter sur http://server.mappingsuite.com
+
*Contact Technical Support, or log on to https://server.mappingsuite.com
  
Remarque : Si les clés logicielles ne sont pas saisies, certains écrans du menu Mapping ne seront pas accessibles.
+
Note: If the licence keys are not entered, some screens in the Mapping menu cannot be accessed.
  
===Identifiant serveur===
+
===Server ID===
  
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.
+
Run the <code>MAPKEY</code> command to retrieve the information needed to generate your licence keys.
 
   
 
   
Noter les informations ci-dessous, puis appuyer sur <kbd>F3</kbd> pour sortir.
+
Write down the information below and then press <kbd>F3</kbd> to exit.
  
 
*Serial Number
 
*Serial Number
Ligne 485 : Ligne 484 :
 
*Processor Type
 
*Processor Type
  
[[File:Activ-infos.PNG|600px|none]]
+
[[File:OP_S_MAPKEY_EN.JPG|700px|none]]
  
===Saisie des clés de Licence===
+
===Entering licence keys===
  
Le nombre de clés de licence requises dépend des options achetées.
+
The number of licence keys required depends on the options purchased.
  
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.  
+
For each key, run the <code>MAPKEY</code> command and [[OPALE:10.0:Saisie_de_la_clef_logicielle|enter the product number associated with the key]], and then press <kbd>Enter</kbd> to save.  
  
[[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 :
+
Note: If the key you have entered is correct, the screen above is displayed and there is no confirmation message. If not, the key is highlighted as shown below but there is no error message.
  
 
[[File:Erroroactivation.PNG|600px|none]]
 
[[File:Erroroactivation.PNG|600px|none]]
  
==Vérification après installation==
+
==Post-Installation checklist==
  
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.
+
This section is designed to help you check that the installation process was successful, and that the Mapping environment is configured correctly.
  
Il suffit de suivre chaque étape pas à pas. Tous les points à vérifier sont listés ci-dessous.
+
Just follow each step as explained. All checkpoints are listed to ensure that you can use the software as intended.
  
===Activation du profil utilisateur MAPPING===
+
===Activating the MAPPING user account===
  
La première chose à faire est d’activer le profil MAPPING sur le système.
+
The first thing you want to do is to activate the MAPPING user account on the system.
  
Par défaut, lors de l’installation, le profil utilisateur MAPPING est créé avec le mot de passe à blanc.
+
By default during the installation process, the MAPPING user account is created with a blank password.
  
Exécuter la commande <code>CHGUSRPRF</code> pour définir un mot de passe pour l’utilisateur MAPPING.
+
Run the <code>CHGUSRPRF</code> command to set a password for the MAPPING user account.
  
Si cela n’est pas fait, vous ne pourrez pas utiliser ce profil à des fins de test.
+
If you skip this step, you will not be able to use this user account for test purposes.
  
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.
+
The MAPPING user account has all the permissions needed to use the MAPPING software. It’s an account of type <code>*PGMR</code> that can be used as you see fit, if necessary.
  
===Vérification de l’environnement MAPPING===
+
===Checking the MAPPING environment===
  
Sur la ligne de commande, taper <code>MAPPING</code> pour accéder au menu principal.
+
On the command line, type <code>MAPPING</code> to open the main menu.
  
Sélectionner l’option "Paramètres d'environnement Mapping" dans le menu Exploitation.
+
Select option "Mapping Environment Settings" from the Operations menu.
  
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é).
+
The paths are displayed in the lower end of the screen and the values depend on the system's language. The values may vary with the system on which the software is installed.
  
===Vérification de l’IFS===
+
===Checking the 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.  
+
It is also recommended that you check the IFS. The easiest way to do this is to run the WRKLNK command.
Dans tous les cas, les dossiers suivants doivent être présents dans l’IFS : mapout, mapping, mapreport, mapsend.
+
In any case, the following folders should be found in the IFS: mapout, mapping, mapreport, mapsend.
  
===Objets système requis par le logiciel MAPPING===
+
===System objects required by MAPPING software===
  
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.
+
Another thing you might want to do is check the Job Queues and Job Descriptions required for use with Mapping. Run the WRKOBJ command to list MAP* objects required by the software.
  
Les Job Queues suivantes doivent apparaitre :  
+
The following Job Queues are required:
 
  MAPQFIND, MAPQMIDDLE, MAPQROBOT, MAPQSLOW, MAPQSMTP, MAPQSMTP2, MAPQSPEED, MAPQTCPIP
 
  MAPQFIND, MAPQMIDDLE, MAPQROBOT, MAPQSLOW, MAPQSMTP, MAPQSMTP2, MAPQSPEED, MAPQTCPIP
  
Les Job Descriptions suivantes doivent apparaitre :  
+
The following Job Descriptions are required:
MAPDFIND, MAPDMIDDLE, MAPDROBOT, MAPDSLOW, MAPDSMTP, MAPDSMTP2, MAPDSPEED, MAPDTCPIP
+
MAPDFIND, MAPDMIDDLE, MAPDROBOT, MAPDSLOW, MAPDSMTP, MAPDSMTP2, MAPDSPEED, MAPDTCPIP
  
===Démarrage du Robot===
+
===Starting the Robot===
  
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>.
+
Run the <code>STRRBT</code> command to start the robot, and then run the <code>WRKSBS</code> command to show the sub-system.

Version actuelle datée du 6 juin 2019 à 12:27

Autres langues :
English • ‎français

Requirements

This guide explains how to install and update OPALE Server on an IBM i server.

As a reminder, it is recommended to also update the other Mapping Suite software components at the same time to prevent errors due to version conflicts.

System

Minimum requirements:

  • OS/400 V7R1 or higher
  • 2 Gb of free disk space
  • FTP connection

In case of M-Processing Server update:

Note: On OS/400 V7R1 and higher, the versions of M-Processing Server older than 7.1 are not compatible.

Security

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 (recommended).
  • Transferring the file MXXXXX.SAVF via SCP to the previously created library.

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

  • Extract the archive directly into the library created previously.


Transferring the SAVF to the IBM i using FTP

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


Cmdftp.PNG


Then, skip to Restoring the SAVF.

SSH Transfer to the IFS

If the IBM i 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 to the IFS

If the ZIP archive has been transferred to the IBM i, you can use the jar tool to unzip it, 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

Install0.PNG


You will need to specify the:

  • Sub-system name
  • Installation folders
  • System LANGID and code page


Install1.PNG


Note: The code page must always be 4 digits. Example 0037 or 0500.

Sample code page:
0297: French without Euro € symbol
1147: French with Euro € symbol

After that if you are installing the product, you will need to enter the software activation codes called software keys. If you skip this step, you can do it later by running the MAPKEY command. See Software Activation. If you are updating the product or do not have the software activation keys now, press F3 to skip.


OP S MAPKEY EN.JPG


Installation is complete when the following screen is displayed. Press Enter to continue.


OP S environment en.JPG


Note: After installing and before using the product, you will need to end the session and sign back in.

Language

Selecting the language in the Mapping menu

The screens of the Mapping menu can be displayed in the following languages:

  • French: MAPMSGFRA
  • English: MAPMSGENU
  • Japanese: MAPMSGJPN

The language is specified in the environment settings (Language File + Language ID).

Mapping Menu (enter the command GO MAPPING), choose Option 14 then Option 1. or from the general Mapping menu: Operations menu / Mapping Environment Settings

Otherwise, from the OPALE menu, choose Operations and then "Mapping Environment Settings"

OP S param envir.JPG

OP S environment lang en.jpg

Code pages

Supported code pages
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]


Unsupported code pages
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

Software Activation

After installing the software, you will need to enter activation codes called licence keys. The licence keys are hardware-dependent. To obtain the licence keys for your system, you will need to:

Note: If the licence keys are not entered, some screens in the Mapping menu cannot be accessed.

Server ID

Run the MAPKEY command to retrieve the information needed to generate your licence keys.

Write down the information below and then press F3 to exit.

  • Serial Number
  • Model Number
  • Processor Type
OP S MAPKEY EN.JPG

Entering licence keys

The number of licence keys required depends on the options purchased.

For each key, run the MAPKEY command and enter the product number associated with the key, and then press Enter to save.

.


Note: If the key you have entered is correct, the screen above is displayed and there is no confirmation message. If not, the key is highlighted as shown below but there is no error message.

Erroroactivation.PNG

Post-Installation checklist

This section is designed to help you check that the installation process was successful, and that the Mapping environment is configured correctly.

Just follow each step as explained. All checkpoints are listed to ensure that you can use the software as intended.

Activating the MAPPING user account

The first thing you want to do is to activate the MAPPING user account on the system.

By default during the installation process, the MAPPING user account is created with a blank password.

Run the CHGUSRPRF command to set a password for the MAPPING user account.

If you skip this step, you will not be able to use this user account for test purposes.

The MAPPING user account has all the permissions needed to use the MAPPING software. It’s an account of type *PGMR that can be used as you see fit, if necessary.

Checking the MAPPING environment

On the command line, type MAPPING to open the main menu.

Select option "Mapping Environment Settings" from the Operations menu.

The paths are displayed in the lower end of the screen and the values depend on the system's language. The values may vary with the system on which the software is installed.

Checking the IFS

It is also recommended that you check the IFS. The easiest way to do this is to run the WRKLNK command. In any case, the following folders should be found in the IFS: mapout, mapping, mapreport, mapsend.

System objects required by MAPPING software

Another thing you might want to do is check the Job Queues and Job Descriptions required for use with Mapping. Run the WRKOBJ command to list MAP* objects required by the software.

The following Job Queues are required:

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

The following Job Descriptions are required: MAPDFIND, MAPDMIDDLE, MAPDROBOT, MAPDSLOW, MAPDSMTP, MAPDSMTP2, MAPDSPEED, MAPDTCPIP

Starting the Robot

Run the STRRBT command to start the robot, and then run the WRKSBS command to show the sub-system.