OPALE - 10.0 - Installation - Installing OPALE Server

Différence entre versions

De MappingDoc
imported>Izarai
(CHECKING THE MAPPING ENVIRONMENT)
 
imported>Rdal
(INSTALLATION STEPS)
 
(33 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 
==REQUIREMENTS==
 
==REQUIREMENTS==
  
This guide explains the installation and update procedures for M-Processing Server on an IBM i system. 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.
+
This guide explains the installation and update procedures for OPALE Server on an IBM i system. 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===
 
===SYSTEM===
Ligne 10 : Ligne 10 :
 
*FTP connection
 
*FTP connection
  
If you are updating M-Processing Server:
+
If you are updating from an older version, please refer to the [[OPALE:10.0:Migration:Migration Process|Upgrade Process]].
*An interruption of the print service should be planned
 
*Make sure you back up the production library
 
  
 
Note: On OS/400 V7R1 and higher, the versions of M-Processing Server older than 7.1 are not compatible.
 
Note: On OS/400 V7R1 and higher, the versions of M-Processing Server older than 7.1 are not compatible.
Ligne 24 : Ligne 22 :
 
===UPDATE INFORMATION===
 
===UPDATE INFORMATION===
  
The installation program updates all the binaries used by the application.
+
Please refer to the [[OPALE:10.0:Migration:Migration Process|Upgrade Process]]
 
 
The M-Processing Server configuration files and objects declared (robots, queues, rules, actions, etc.) are not modified.
 
  
 
===PREPARATION===
 
===PREPARATION===
  
The software installation program can be downloaded from the Mapping Suite technical server at https://server.mappingsuite.com. It is called Mxxxxx.SAVF.zip.
+
The software installation program can be downloaded from the Mapping Suite technical server at https://server.mappingsuite.com.  
  
After downloading and uncompressing, it can safely be renamed to MSETUP.SAVF.
+
It is called '''setup_Opale_vXX.X.X.XXXXX.zip'''.
  
===BEFORE UPDATING===
+
After downloading and uncompressing, it can safely be renamed to MXXXXX.SAVF.
1. Stop the MAPPING sub-system
 
  
2. Stop printing
+
===INSTALLING OR UPDATING BY FTP===
  
3. Exit the menus
+
====FTP TRANSFER====
  
4. Run this command to check that the library is not in use:
+
=====CREATING THE RESTORE SAVF=====  
WRKOBJLCK QSYS/MAP400 *LIB
 
 
 
5. Run the following commands to check who’s the owner of the Mapping library. The name of the Mapping library is MAP400 by default:
 
DSPOBJD OBJ(MAP400/*ALL) OBJTYPE(*ALL) OUTPUT(*OUTFILE) OUTFILE(QTEMP/CHECKOWN)
 
STRSQL
 
SELECT * FROM QTEMP/CHECKOWN WHERE ODOBOW <> 'QPGMR'
 
 
 
If there are objects that are not owned by <code>QPGMR</code>, you will need to change that, or they will not be restored. Run the <code>CHGOBJOWN</code> command to change the owner.
 
 
 
Example:
 
CHGOBJOWN OBJ(MAPOBJ) OBJTYPE(*FILE) NEWOWN(QPGMR) CUROWNAUT(*SAME)
 
 
 
To change the owner of all objects in a library:
 
CHGOWN OBJ('/qsys.lib/map400_sd.lib/*.*') NEWOWN(QPGMR)
 
 
 
===INSTALLING OR UPDATING BY FTP===
 
 
 
====CREATING THE RESTORE SAVF:====  
 
  
 
Run this command:   
 
Run this command:   
CRTSAVF FILE(QGPL/MSETUP)
+
CRTSAVF FILE(QGPL/MXXXXX)
  
====TRANSFERRING THE MSETUP.SAVF FILE TO THE ISERIES:====
+
=====TRANSFERRING THE MXXXXX.SAVF FILE TO THE ISERIES=====
  
Under Windows in Start/Programs, choose MS-DOS Command Prompt:
+
#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
  
Go to the folder where the file you have just downloaded is saved e.g. CD My documents\Mapping
+
[[File:Cmdftp.PNG|none|700px]]
  
Enter ftp "AS400 IP address" (no quotes) e.g. ftp 9.5.5.3
+
Then, skip to [[OPALE:10.0:Installation:Installing_OPALE_Server#RESTORING_THE_SAVF|Restoring the SAVF]]
  
And then sign in on the IBM i:
+
====SSH TRANSFER TO THE IFS====
 +
If the IBM has its SSH server configured.
  
user :
+
Transfer the SAVF using the SCP protocol (e.g. using WinSCP) to a folder on the IFS.
 
pwd :
 
  
Enter binary
+
Then, copy the SAVF to a library used only for this:
  
Enter cd qgpl (or the library of the savf file you have created)
+
qsh
 +
cp /home/setup/M31213.SAVF /QSYS.LIB/GBARRET.LIB/SETUP.FILE
  
Enter put msetup.savf
+
====RESTORING THE SAVF====
 
 
… (the file is being transferred and then you regain control)
 
 
 
Enter close
 
 
 
Then quit
 
 
 
And then exit
 
 
 
====RESTORING THE SAVF:====
 
  
 
Run this command:   
 
Run this command:   
 
  RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/MSETUP)
 
  RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/MSETUP)
  
====LAUNCH THE INSTALLATION SCRIPT:====
+
====LAUNCH THE INSTALLATION SCRIPT====
  
 
Run this command:   
 
Run this command:   
Ligne 104 : Ligne 81 :
 
====INSTALLATION STEPS====
 
====INSTALLATION STEPS====
  
Enter the name of the library you want to install or update:
+
Enter the name of the library you want to install or update.
 +
 
 +
<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:Migration Process|Upgrade Process]]
 +
 
 +
[[File:Install0.PNG|700px|none]]
  
If you are installing the product, you will need to specify the:
 
  
 +
You will need to specify the:
 
*Sub-system name (the sub-system is created in the library where the product is restored)
 
*Sub-system name (the sub-system is created in the library where the product is restored)
 
*Installation folders
 
*Installation folders
 
*System LANGID and code page
 
*System LANGID and code page
  
Note: The code page must always be 4 digits. Example 0037 or 0500
 
  
After that if you are installing the product, you will need to enter the software activation codes called software keys. If you do not do it now, you can do it later by running the MAPKEY command. See Software Activation.
+
Note: The code page must always be 4 digits. Example 0037 or 0500.
 +
 
 +
After that if you are installing the product, you will need to enter the software activation codes called software keys. If you do not do it now, you can do it later by running the <code>MAPKEY</code> command. See [[OPALE:10.0:Installation:Installing_OPALE_Server#SOFTWARE_ACTIVATION|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]]
  
If you are updating the product or do not have the software activation keys now, press F3 to skip.
 
  
 
Installation is complete when the following screen is displayed. Press Enter to continue.
 
Installation is complete when the following screen is displayed. Press Enter to continue.
 +
[[File:Install param env.PNG|700px|none]]
  
INSERT SCREENSHOT HERE
 
  
 
Note: After installing and before using the product, you will need to end the session and sign back in.
 
Note: After installing and before using the product, you will need to end the session and sign back in.
 
===AFTER UPDATING===
 
 
1. Run non-regression tests
 
 
2. Activate the MAPPING sub-system:
 
STRRBT LOG(*YES)
 
 
3. Checks for any errors:
 
 
Run this command to see installation messages:
 
DSPJOBLOG OUTPUT(*PRINT)
 
 
Other points you might want to check:
 
Read the DSPJOBLOG at the end of the process.
 
If you sign off, do a SIGNOFF *LIST to retrieve installation errors or warnings
 
 
To check for any restore errors (object locked, wrong owner, etc.), run this command in STRSQL:
 
SELECT * FROM qtemp/RSTMAP400 WHERE RSOSTA = '0'
 
 
You should have two backups:
 
The first one in the MAP$$400 library. If there’s a problem, you can rename it to MAP400.
 
The second one in the MAP$$400SF library contains all SAVFs of all installations on this system.
 
You can free up disk space by deleting both libraries.
 
  
 
===LANGUAGE===
 
===LANGUAGE===
Ligne 160 : Ligne 120 :
 
The language is specified in the environment settings (Language File + Language ID).
 
The language is specified in the environment settings (Language File + Language ID).
  
Mapping menu, Option 14 and then Option 1.
+
Menu Mapping (enter the command <code>GO MAPPING</code>), option <kbd>14</kbd> then option <kbd>1</kbd>.
 +
or from the general Mapping menu: Operations menu / General Parameters
 +
 
 +
From the OPALE menu, choose Operations and then "Mapping Environment Parameters"
 +
 
 +
[[File:Param lang.PNG|600px|none]]
 +
 +
[[File:Langopale.PNG|600px|none]]
 +
 
 +
====CODE PAGES====
  
 
=====SUPPORTED CODE PAGES =====
 
=====SUPPORTED CODE PAGES =====
* AFR (037) {latin1:1252} Afrikaans [Q037_19U-Q19U_037]
+
{| class="wikitable"
* BEL (1025,1154) {Russian:1251} Byelorussian [Q1154_9R-Q9R-1154]
+
! Code
* BGR (1025,1154) {Russian:1251} Bulgarian [Q1154_9R-Q9R-1154]
+
! Codepage
* CSY (0870,1153) {latin2:1250} Czech [Q1153_9E-Q9E_1153]
+
! ISO
* DES (0500) {latin1:1252} Swiss German [Q1141_19U-Q19U_1141]
+
! Nom
* DEU (0273,1141) {latin1:1252} German [Q1141_19U-Q19U_1141]
+
! Fichier
* 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]   
+
! AFR  
* ELL (0875) {Greek:1253} Greek [Q875_9G-Q9G_875]
+
| (037)
* ENA (037) {latin1:1252} Australian English [Q037_19U-Q19U_037]
+
| {latin1:1252}
* ENG (0285,1146) {latin1:1252} United Kingdom English [Q285_19U-Q19U_285]
+
| Afrikaans
* ENP (037) {latin1:1252} Uppercase English [Q037_19U-Q19U_037]
+
| [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]
+
! BEL  
* FRA (0297,1147) {latin1:1252} French [Q1147_19U-Q19U_1147]
+
| (1025,1154)
* FRB (0500,1148) {latin1:1252} Belgian French [Q1148_19U-Q19U_1148]
+
| {Russian:1251}
* FRC (0500) {latin1:1252} Canadian French [Q1148_19U-Q19U_1148]
+
| Byelorussian
* FRS (0500) {latin1:1252} Swiss French [Q1148_19U-Q19U_1148]
+
| [Q1154_9R-Q9R-1154]
* GAE (0285,1146) {latin1:1252} Irish Gaelic [Q285_19U-Q19U_285]
+
|-
* HRV (0870,1153) {latin2:1250} Croatian [Q1153_9E-Q9E_1153]
+
! BGR  
* HUN (0870,1153) {latin2:1250} Hungarian [Q1153_9E-Q9E_1153]
+
| (1025,1154)
* ITA (0280,1144) {latin1:1252} Italian [Q1144_19U-Q19U_1144]
+
| {Russian:1251}
* ITS (0500) {latin1:1252} Swiss Italian [Q1148_19U-Q19U_1148]
+
| Bulgarian
* JPN {0290} {Japanese:05026} Japanese Katakana [Q013_19U-Q19U_037- Japanese_base1996.tbl]   
+
| [Q1154_9R-Q9R-1154]
* KOR {0833} {Korean:00933} Korean [Q013_19U-Q19U_037- Korean_base1992.tbl]   
+
|-
* MKD (1025,1154) {Russian:1251} Macedonian [Q1154_9R-Q9R-1154]
+
! CSY  
* NLB (0500,1148) {latin1:1252) Belgian Dutch [Q1148_19U-Q19U_1148]
+
| (0870,1153)
* NLD (037,1140) {latin1:1252} Dutch [Q037_19U-Q19U_037]
+
| {latin2:1250}
* PLK (0870,1153) {latin2:1250} Polish [Q1153_9E-Q9E_1153]
+
| Czech
* PTB (037) {latin1:1252} Brazilian Portuguese [Q037_19U-Q19U_037]
+
| [Q1153_9E-Q9E_1153]
* PTG (037,1140) {latin1:1252} Portuguese [Q037_19U-Q19U_037]
+
|-
* ROM (0870,1153) {latin2:1250} Romanian [Q1153_9E-Q9E_1153]
+
! DES  
* RUS (1025,1154) {Russian:1251} Russian [Q1154_9R-Q9R_1154]
+
| (0500)
* SKY (0870,1153) {latin2:1250} Slovakian [Q1153_9E-Q9E_1153]
+
| {latin1:1252}
* SLO (0870,1153) {latin2:1250} Slovenian [Q1153_9E-Q9E_1153]
+
| Swiss German
* SQI (0500) {latin1:1252} Albanian [Q1148_19U-Q19U_1148]
+
| [Q1141_19U-Q19U_1141]
* SRB (1025,1154) {Russian:1251} Serbian Cyrillic [Q1154_9R-Q9R-1154]
+
|-
* SRL (0870,1153) {latin2:1250} Serbian Latin [Q1153_9E-Q9E_1153]
+
! DEU
* TRK (1026,1155) {Turkish:1254} Turkish [Q1155_5T-Q5T_1155]
+
| (0273,1141)
* THA {0838} {Thai :874} Thai [Q838_0T-Q0T_383]
+
| {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 =====
+
=====UNSUPPORTED CODE PAGES=====
* ARA 0420 Arabic
+
{| class="wikitable"
* CAT 0284 Catalan
+
! Code
* DAN 0277 Danish
+
! Codepage
* FAR 1097 Farsi
+
! Nom
* FIN 0278 Finnish
+
|-
* HEB 0424 None Hebrew
+
! ARA  
* ISL 0871 1149 Icelandic
+
| 0420  
* NON 0277 Norwegian Nynorsk
+
| Arabic
* NOR 0277 Norwegian Bokmal
+
|-
* SVE 0278 Swedish
+
! 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==
 
==SOFTWARE ACTIVATION==
Ligne 226 : Ligne 439 :
 
===SERVER ID===
 
===SERVER ID===
  
Run the MAPKEY command to retrieve the information needed to generate your license keys.
+
Run the <code>MAPKEY</code> command to retrieve the information needed to generate your license keys.
 
   
 
   
Write down the information below and then press F3 to exit.
+
Write down the information below and then press <kbd>F3</kbd> to exit.
 +
* Serial Number
 +
* Model Number
 +
* Processor Type
 +
 
 +
[[File:Activ-infos.PNG|600px|none]]
  
 
===ENTERING THE LICENSE KEYS===
 
===ENTERING THE LICENSE KEYS===
Ligne 234 : Ligne 452 :
 
The number of license keys required depends on the options purchased.
 
The number of license 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.  
+
For each key, run the <code>MAPKEY</code> command and enter the product number associated with the key, and then press Enter to save.
 +
 
 +
[[File:Activ1-3.PNG|600px|none]]
 +
 
 +
 
 +
Note: If the key you have entered is correct, the next screen is displayed. Else, the key is highlighted as shown below.
  
Note: If the key you have entered is incorrect, the key is highlighted.
+
[[File:Erroroactivation.PNG|600px|none]]
  
 
==POST-INSTALLATION CHECKLIST==
 
==POST-INSTALLATION CHECKLIST==
Ligne 248 : Ligne 471 :
 
By default during the installation process, the MAPPING user account is created with a blank password.
 
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.
+
Run the <code>CHGUSRPRF</code> command to set a password for the MAPPING user account.
  
 
If you do not do that, you will not be able to use this user account for test purposes.
 
If you do not do that, 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.
+
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.
  
 
===CHECKING THE MAPPING ENVIRONMENT===
 
===CHECKING THE MAPPING ENVIRONMENT===
On the command line, type GO MAPPING to open the main menu.
+
On the command line, type <code>MAPPING</code> to open the main menu.
  
Select option environment settings mapping from Exploitation menu.the paths are displayed in the lower end of the screen and the values depend on the system
+
Select option Mapping Environment Settings from the Operations menu.
  
language. The values may vary with the system on which the software is installed.
+
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===
 
===CHECKING THE IFS===
Ligne 269 : Ligne 492 :
 
Another thing you might want to do is check the Job Queues and Job Descriptions required for use with Mapping.
 
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.
+
Run the <code>WRKOBJ</code> command to list MAP* objects.
  
The following Job Queues are required: MAPQFIND, MAPQMIDDLE, MAPQROBOT, MAPQSLOW, MAPQSMTP, MAPQSMTP2, MAPQSPEED, MAPQTCPIP.
+
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.
+
The following Job Descriptions are required:  
 +
MAPDFIND, MAPDMIDDLE, MAPDROBOT, MAPDSLOW, MAPDSMTP, MAPDSMTP2, MAPDSPEED, MAPDTCPIP
  
 
===STARTING THE ROBOT===
 
===STARTING THE ROBOT===
Run the STRRBT command to start the robot, and then run the WRKSBS command to show the sub-system.
+
Run the <code>STRRBT</code> command to start the robot, and then run the <code>WRKSBS</code> command to show the sub-system.
 
[[Category:AS400]]
 
[[Category:AS400]]

Version actuelle datée du 13 mars 2019 à 16:31

REQUIREMENTS

This guide explains the installation and update procedures for OPALE Server on an IBM i system. 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

If you are updating from an older version, please refer to the Upgrade Process.

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

FTP TRANSFER

CREATING THE RESTORE SAVF

Run this command:

CRTSAVF FILE(QGPL/MXXXXX)
TRANSFERRING THE MXXXXX.SAVF FILE TO THE ISERIES
  1. Under Windows in Start/Programs, choose MS-DOS Command Prompt:
  2. Go to the folder where the file you have just downloaded is saved e.g. CD My documents\Mapping
  3. Enter ftp "AS400 IP address" (no quotes) e.g. ftp 9.5.5.3
  4. And then sign in on the IBM i
  5. Enter binary
  6. Enter cd qgpl (or the library of the savf file you have created)
  7. Enter put mxxxxx.savf
  8. … (the file is being transferred and then you regain control)
  9. Enter close
  10. Then quit
  11. And then exit
Cmdftp.PNG

Then, skip to Restoring the SAVF

SSH TRANSFER TO THE IFS

If the IBM has its SSH server configured.

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

Then, copy the SAVF to a library used only for this:

qsh
cp /home/setup/M31213.SAVF /QSYS.LIB/GBARRET.LIB/SETUP.FILE

RESTORING THE SAVF

Run this command:

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

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 (the sub-system is created in the library where the product is restored)
  • Installation folders
  • System LANGID and code page


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

After that if you are installing the product, you will need to enter the software activation codes called software keys. If you do not do it now, 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.

Activ1-2.PNG


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

Install param env.PNG


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:

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

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

Menu Mapping (enter the command GO MAPPING), option 14 then option 1. or from the general Mapping menu: Operations menu / General Parameters

From the OPALE menu, choose Operations and then "Mapping Environment Parameters"

Param lang.PNG

Langopale.PNG

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 license keys. The license keys are hardware-dependent. To obtain the license keys for your system, you will need to:

Note: If the license 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 license keys.

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

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

ENTERING THE LICENSE KEYS

The number of license 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.

Activ1-3.PNG


Note: If the key you have entered is correct, the next screen is displayed. Else, the key is highlighted as shown below.

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 do not do that, 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.

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.