BaanERP Installation Guide BaanERP on OS/390 UNIX System Services

Transcription

1 BaaERP Istallatio Guide BaaERP o OS/390 UNIX System Services

2 A publicatio of: Baa Developmet B.V. P.O.Box AC Bareveld The Netherlads Prited i the Netherlads Baa Developmet B.V All rights reserved. The iformatio i this documet is subject to chage without otice. No part of this documet may be reproduced, stored or trasmitted i ay form or by ay meas, electroic or mechaical, for ay purpose, without the express writte permissio of Baa Developmet B.V. Baa Developmet B.V. assumes o liability for ay damages icurred, directly or idirectly, from ay errors, omissios or discrepacies betwee the software ad the iformatio cotaied i this documet. Documet Iformatio Code: U7171B US Group: User Documetatio Editio: B Date: March, 1999

3 Table of cotets 1 Itroductio 1-1 Commad sytax ad covetios Istallatio precoditios 2-1 Workstatio 2-1 Software levels 2-1 Disk space 2-2 Virtual storage 2-2 OS/ OS/390 UNIX System Services 2-3 OS/390 UNIX System Services Coectio Scalig 2-3 DB2 2-7 Load cosideratios 2-7 User IDs 2-8 TCP/IP 2-9 IP Pritway setup 2-9 EBCDIC 2-9 Agreemets with the customer 2-10 System cofiguratio 2-10 Baa dowtime 2-10 Who does what? 2-10 Time frame To istall the BaaERP software 3-1 To load the software 3-1 Create stadard users 3-1 Defie the Hierarchical File System (HFS) 3-3 Copy the CD-ROM 3-4 To perform additioal tasks after the software is istalled 3-14 Ru-time cosideratios 3-16 Usig multiple file systems 3-16 To ru from Lik Pack Area (LPA) 3-18 To clea the user ID alias table To customize the BaaERP software 4-1 To istall the demo tables 4-2 To create tables for the demo models 4-3 To import the versio dumps 4-4 Istallatio Guide BaaERP o OS/390 UNIX System Services i

4 Table of cotets To iitialize parameters 4-5 To reorgaize tables 4-6 To cofigure shared memory 4-7 To set up shared memory 4-7 To create the audit database ad to assig tables 4-9 To validate the system 4-10 Defiig the default currecies 4-13 To chage passwords 4-14 To cofigure priters To customize DB2 for BaaERP 5-1 DB2 parameters for BaaERP 5-1 Subsystem parameters 5-1 DSNHDECP DB2 parameters 5-2 CCSID cofiguratio 5-2 DB2 Attach cosideratios 5-3 RRS 5-3 CAF 5-3 To prepare the BaaERP istallatio 5-3 BIND cosideratios 5-4 To ru db2_istall6.2 for BaaERP 5-5 To create storage groups 5-6 To create the database 5-7 To create the tablespace 5-7 To create admiistrative files 5-8 Database admiistratio DB2 database driver iterals ad exterals 6-1 DB2 driver exterals 6-1 DB2 table ad idex locatio 6-1 Storage file format 6-1 Security 6-5 Appedix A Process Maager overview 1 A.1 Process Maager overview 1 A.2 Commuicatio betwee the cliet ad the server 3 Appedix B Priter cofiguratio details 1 B.1 IP Pritway cofiguratio 1 B.2 To defie a paper type ad fots 4 B.3 To defie a priter 5 B.4 To cofigure priter for bar codes 6 Istallatio Guide BaaERP o OS/390 UNIX System Services ii

5 Table of cotets Appedix C Istallatio checklist 1 C.1 Preistall activities 1 C.2 Post-istall activities 3 Appedix D Modificatios ad preistallatio tasks 1 Based o istallatio with portig set PA Checklist preistallatio tasks 2 Appedix E Sample DDL to defie DB2 database for BaaERP 1 Istallatio Guide BaaERP o OS/390 UNIX System Services iii

6 Table of cotets Istallatio Guide BaaERP o OS/390 UNIX System Services iv

7 About this documet This guide describes how you ca istall BaaERP o OS/390. The cotets of this documet are as follows: Chapter 1 itroduces this guide ad its covetios. Chapter 2 describes prerequisites ad plaig. Chapter 3 describes how you ca istall the BaaERP software. Chapter 4 describes how you ca customize the BaaERP software. Chapter 5 describes how you ca customize DB2 for BaaERP. Chapter 6 describes the DB2 database driver iterals ad exterals. Appedix A provides a overview of the Process Maager. Appedix B describes how you ca cofigure a priter. Appedix C describes a istallatio checklist. Appedix D describes some modificatios ad preistallatio tasks. Appedix E provides a sample DDL to defie a DB2 database. Istallatio Guide BaaERP o OS/390 UNIX System Services v

8 About this documet Istallatio Guide BaaERP o OS/390 UNIX System Services vi

9 1 Itroductio This documet is iteded for those resposible for istallig BaaERP, ad assumes a basic kowledge of UNIX ad the Baa software. Kowledge of DB2, OS/390, RACF, TCP/IP, TSO/E, ISPF, telecommuicatios, ad etworkig is also required. Commad sytax ad covetios The followig otatio covetio is used i this maual. Keystrokes are placed betwee brackets: agle brackets (< >) for fuctio keys ad square brackets ([ ]) for letters ad typographic characters. The followig examples show these covetios i use: press <Ctrl>[C]; use the <Shift> key; ad use [C] to edit the scree. OS/390 UNIX System Services keywords, path ames, ad so o, are prited i bold (case-sesitive) ad prefixed with a greater-tha sig (>): for example, the > cpio commad; use > licmo6.2 -b; ad > cd $BSE/bi. OS/390 commads are prefixed with a percet sig (%): for example, % D OMVS,O. Commads that ca be issued at a TSO prompt (or at optio 6 from the ISPF/PDF mai meu), ad optios to select from ISH are prefixed with a right arrow sig (Ð): for example, Ð ISH; ad, select optio Ð Setup. I the latter case, you move the cursor to the optios metioed or type the correspodig umber. Variables of ay kid are i italics: for example, create the directory pathame/baa (which asks you to create a subdirectory/baa somewhere i the file system: for example, /usr3/baa or /disk1/temp/baa). Istallatio Guide BaaERP o OS/390 UNIX System Services 1-1

10 Itroductio Istallatio Guide BaaERP o OS/390 UNIX System Services 1-2

11 2 Istallatio precoditios This chapter describes what you must cosider before you istall BaaERP o a OS/390 system. First, the prerequisites are described, followed by some issues that must be agreed upo with the customer. Before you start the istallatio script for BaaERP o a OS/390 system, you must check or cofigure the followig items: Workstatio Software levels Disk space Virtual storage OS/390 DB2 User IDs TCP/IP IP Pritway The followig sectios describe each topic. Workstatio You eed a PC with both a 3270 termial emulator (or 3270 telet cliet) ad a stadard telet cliet with VTxxx support. You also eed access to a CD-ROM reader ad FTP. Software levels The followig miimum software levels are required: OS/390 Versio 2, Release 6 (5647-A01), PTFs UW49691, UW53341, UW51307, ad UW OS/390 Versio 2, Release 6 Laguage Eviromet (5647-A01), PTFs UQ23194, UQ24359, UQ21379, ad UQ DB2 Versio 5, Release 1, with service through 06/30/98, plus PTFs UQ18604, UQ19012 (APAR PQ14391), ad UQ Read the iformatio i APAR PQ14391 to lear about the use of the storage cotractio support shipped via that APAR. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-1

12 Istallatio precoditios OS/390 UNIX System Services Coectio Scalig Kit (program umber 5647-A01, feature umber 5785), with PTFs UW56015 ad UW54946, ad APAR OW Refer to the OS/390 UNIX System Services Coectio Scalig Program Directory for the list of required software ad their required levels. The code cotaied i the OS/390 UNIX System Services Coectio Scalig kit is itegrated ito the OS/390 base startig i OS/390 Versio 2, Release 7, but the fixes listed above are still required. If ruig without Process Maager, ad TCP/IP fix UQ24539 is istalled (or UQ24540 if you are ruig OS/390 Versio 2, Release 7), you must specify the -s optio i the rexecd lie i ietd.cof. This will force rexec to read each user s.profile. Disk space The followig amout of storage is required for the OS/390 system: The Baa Software Eviromet (BSE) requires about 500MB of disk space. Istallig multiple laguages requires additioal disk space. Loadig the sample data ad compay 000 requires about 500MB of DB2 data ad 500MB of DB2 idex space. Loadig the istallatio CD-ROMs durig the istallatio requires aother 1GB of disk space. These estimates iclude oly the space eeded for the software. The amout of space eeded for data migratio caot be determied at this time. At a miimum, the BSE should be i a separate file system. If you pla to use auditig, you must have access to at least oe more file system. Virtual storage Reserve approximately 30MB of additioal virtual storage for each logged-o Baa user. This amout is geerous; the actual storage requiremet for each logged-o user is less tha 20MB. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-2

13 Istallatio precoditios OS/390 OS/390 UNIX System Services Verify that there are eough resources available for the istallatio. The followig parameters i the BPXPRMxx member of SYS1.PARMLIB i OS/390 UNIX System Services must be verified: MAXFILEPROC=4096 MAXCPUTIME= MAXSOCKETS AF_UNIX=32000 AF_INET=32000 MAXPROCSYS=30000 MAXPROCUSER=30000 MAXSHAREPAGES= MAXASSIZE= MAXUIDS=2000 IPCSHMSPAGES= IPCSHMMPAGES=25600 IPCSHMMSEGS=1000 MAXTHREADS=500 MAXTHREADTASKS=75 These parameters are suggested values for a large istallatio ad are fully explaied i the OS/390 UNIX System Services Plaig maual. You should also check the commad >file to get the iformatio about the filetypes. The filetypes are defied i the magic file i /etc. If this file is ot filled, you ca fid a example i /samples. OS/390 UNIX System Services Coectio Scalig Baa o OS/390 exploits the features of the OS/390 UNIX System Services Coectio Scalig compoets: Coectio Maager ad Process Maager. Coectio Maager is required for Baa o OS/390. Process Maager istallatio is required, but the activatio is optioal ad recommeded uder most circumstaces. Detailed iformatio o how to istall ad customize Coectio Maager ad Process Maager ca be foud i the OS/390 UNIX System Services Coectio Scalig Program Directory ad the OS/390 UNIX System Services Coectio Scalig Referece. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-3

14 Istallatio precoditios Coectio Maager cofiguratio file You must istall Coectio Maager APARs OW36187 ad OW37302 o the OS/390 system. Also, the LIBPATH eivromet variable of each BAAN user must cotai the directory, /usr/lpp/cmx/lib. The Coectio Maager cofiguratio file is /etc/cmx/cmx.cof, which has four sectios. The NAMES sectio icludes the DB2 subsystem ame ad pla ame. The CCSID sectio idetifies the ccsid that the Coectio Maager must use. The TRACE sectio should oly be used whe it is requested by service support. The ERROR sectio is for DB2 error loggig. A sample /etc/cmx/cmx.cof is show below. Note that the commet lies start with two slashes [//]: // BAAN Coectio Maager Resources [NAMES] DB2SubSystem=DBA1 DB2PlaName=CMBSRV2 // DB2PlaName=CMBIND DB2Attach=RRS DB2datefmt=ISO [CCSID] DB2ccsID=819 [TRACE] Trace=0 TraceWrap=0 TraceUser=ALL // TraceUser=/baaERP/bse/lib/MVS/user.file [ERROR] DB2ErrorLog=0 DB2IgoreErr=-803 Istallatio Guide BaaERP o OS/390 UNIX System Services 2-4

15 Istallatio precoditios This example results i the followig: The NAMES sectio tells the Coectio Maager to use the DB2 subsystem amed DBA1, the pla amed CMBSRV2, ad RRS for the DB2Attach type. The CMBIND pla is commeted out. The DB2CCSID parameter of the CCSID sectio tells Coectio Maager to use CCSID 819. The DB2datefmt parameter of the CCSID sectio is optioal. This parameter tells Coectio Maager the type of date format specified withi DB2. The date format i DB2 must match the date format specified i the Coectio Maager cofiguratio file. The date fomat optios are ISO, EUR, USA, ad JIS. The default is ISO. The TRACE sectio tells the Coectio Maager that o tracig is performed. If tracig is eeded, the /baaerp/bse/lib/mvs/user.file will hold the list of users to be traced. The Error sectio tells Coectio Maager that all egative SQL retur codes (sqlcodes) other tha 100 are ot to be logged. The oly other value allowed is DB2ErrorLog=1, which logs egative sqlcodes. Durig istallatio, keepig the 0 (o loggig) is recommeded. The DB2IgoreErr parameter elimiates the logig of SQL codes i the Coectio Maager log. For BAAN applicatios, the suggested value for this parameter is -803, as show i the example. For further details, see the OS/390 UNIX System Services Coectio Scalig Referece maual. Process Maager cofiguratio file Process Maager uses the /etc/bpa/bpares.cfg cofiguratio file to defie all parameters eeded to ru Process Maager. See the OS/390 UNIX System Services Coectio Scalig Referece maual for additioal iformatio o the required parameters. See Appedix A for a overview of Process Maager. Process Maager prerequisites All executable ad DLLs (dyamic-lik libraries) that ru i the address spaces maaged by Process Maager must have the program cotrolled exteded attribute set. This exteded attribute is set with the followig commad: extattr +ps <file> You must ru this commad for the executables that belog to $BSE/bi after the istall6.2 istallatio script was ru. You must also ru this commad for Coectio Maager dll: /usr/lpp/cmx/lib/cmxdll. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-5

16 Istallatio precoditios NOTE The file system that cotais the Process Maager directory /usr/lpp/bpa must be mouted without NOSETUID activated. The same is valid for all Baa executables ad other DLLs that ru uder Process Maager. Eablig the Baa cliet to work with Process Maager To eable the Baa cliet to work with Process Maager whe you coect to the Baa applicatio, make the followig etry i the /etc/services file of that cliet: BaaRexec <Portumber>/tcp where <portumber> is the umber of the port to which the Process Maager listes. The port umber is defied i the /etc/bpa/bpares.cfg Process Maager cofiguratio file. # # Withi the file /etc/services Network services # are defied... exec 512/tcp # This is the stadard port used for "rexec()"... BaaRexec 6000/tcp # This port is used to cotact the Process Maager Daemo... NOTE If the etry does ot exist, rexec() uses the stadard port for commuicatio services. The stadard port is defied as exec service i the same file. The port umber specified behid BaaRexec ca be chose arbitrarily, but it must match the umber specified i the cofiguratio file o the server. // This is the cofiguratio file of the Process Maager Daemo which is ruig o the //server machie cotacted by the cliet above.... [DAEMON] Port=6000 Istallatio Guide BaaERP o OS/390 UNIX System Services 2-6

17 Istallatio precoditios To ru the Baa Server applicatio without Process Maager To ru the Baa Server applicatio without Process Maager, the Process Maager must be istalled, eve if the Baa applicatios are ot beig cotrolled by Process Maager. If you are ot ruig Process Maager: Do ot start Process Maager. Do ot add the BaaRexec etry ito the /etc/services file at the cliet machies. Make sure the LIBPATH eviromet variable poits to /usr/lpp/bpa/lib. Make sure the NLSPATH eviromet variable poits to /usr/lpp/bpa/ls/msg/%l/%n for the Baa users that are defied uder UNIX Systems Services. DB2 DB2 5.1 must be istalled ad ruig. Durig the Baa istallatio process, the db2_istall6.2 script prompts you to defie databases, tablespaces, storage groups, ad storage defiitios. Outside Baa, you must defie the DB2 subsystem. Load cosideratios The DB2 driver uses the defiitios i $BSE/lib/db2/db2_storage whe it creates the tables ad idexes. Durig loadig, a rather extesive db2_storage file ca be used. For further iformatio about the layout, see the DB2 product publicatios. The supported DB2 storage parameters (the last parameter o the lie) are: STOGROUP PRIQTY SECQTY BUFFERPOOL FREEPAGE PCTFREE DEFER I the table etries, you ca specify the tablespace for data (T_SPACE) ad the STOGROUP for idexes. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-7

18 Istallatio precoditios Be sure to use a DB2 pla that specifies DYNAMICRULES(RUN) whe you load the database. The followig users must poit to a specific Coectio Maager cmx.cof file that cotais a DB2 pla ame boud with DYNAMICRULES(RUN): root bsp Ay user workig o developmet Baa is a large system. After the base istall, there are about 400 tables o the system ad about 2000 idexes. After loadig the demo compaies 550 ad 740, over 5,000 tables ad approximately 19,000 idexes exist. Therefore, you must cosider the followig factors: Sufficiet space o the VTOCs ad VTOCINDEXes o the idex volumes. A large catalog for the catalog to which the VCAT poits. Use at least oe database per (demo)compay, but multiple databases per (productio) compay is preferred (at least oe database per package per compay). A tablespace per package, per module, per compay works well. Refer to the DB2 for OS/390Referece Maual for BaaERP, which cotais a DDL example i the Appedix for additioal iformatio. User IDs The istallatio requires two specific user IDs ad oe group. For iformatio o these user IDs, refer to Creatig stadard users (0). OS/390 requires uppercase user IDs. Therefore, all users who will coect to Baa must have a user ID i uppercase. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-8

19 Istallatio precoditios TCP/IP To start the licese daemo, TCP/IP must be cofigured correctly. A good test is to check if the: pig hostame commad produces correct results. Also, verify that the respose time for pig is o loger tha 20 secods. O the IBM host sheliak, for example, pig sheliak 65 7 produces the followig output: sheliak> pig sheliak 65 7 PING sheliak.baan.l ( ): 65 data bytes 73 bytes from : icmp_seq=0 ttl=255 time=1 ms 73 bytes from : icmp_seq=1 ttl=255 time=1 ms 73 bytes from : icmp_seq=2 ttl=255 time=1 ms 73 bytes from : icmp_seq=3 ttl=255 time=1 ms 73 bytes from : icmp_seq=4 ttl=255 time=1 ms 73 bytes from : icmp_seq=5 ttl=255 time=1 ms 73 bytes from : icmp_seq=6 ttl=255 time=1 ms --- sheliak.baan.l pig statistics packets trasmitted, 7 packets received, 0% packet loss roud-trip mi/avg./max = 1/1/1 ms IP Pritway setup Network pritig from OS/390 system is based o two compoets: IP Pritway Prit Iterface You must cofigure these two compoets ad successfully complete pritig to your etwork priters before you customize your Baa applicatio. Refer to Appedix B for further iformatio o IP Pritway cofiguratio. EBCDIC OS/390 is EBCDIC based. BAAN was origially developed for ASCII based UNIX platforms. Follow the istallatio procedure carefully to covert the dump files delivered by BAAN before usig them. Oce istallatio is complete, all BAAN text files are i EBCDIC format. Stadard UNIX editig tools, such as vi or the OS/390 specific oedit ca be used to update or view these files. These files iclude BAAN cofiguratio files ad BAAN error log files. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-9

20 Istallatio precoditios Agreemets with the customer Before you start the BaaERP istallatio, establish agreemets with the customer. The followig sectios cover some poits that must be part of the agreemets. NOTE System cofiguratio Examie the system to determie the possible cofiguratios, discuss the optios with the customer. Take ito accout features such as RAID5 or mirrorig. Make sure that the customer explicitly agrees with the fial cofiguratio pla. Baa dowtime If there is a operatioal eviromet o the same system, users will experiece some performace degradatio durig the istallatio process. This oce-oly degradatio will occur specifically durig the steps that make heavy use of system resources, such as ruig the istallatio script, decompressig demo tables, ad creatig the ru-time DD. Who does what? Depedig o your OS/390 ad DB2 kowledge, you may eed the assistace of system programmers ad DB2 admiistrators, particularly durig the preistall phase. Time frame The time required for the istallatio depeds to a great extet o the system ad its usage. Assumig the istallatio script is started o the eveig of the first day, the istallatio process will cotiue for four to eight hours ito the secod day. Durig the first day, you will eed time to copy the CD-ROM, ad about a half hour to prepare the istallatio. This assumes that the other precoditios are all doe before. The copy time varies depedig o FTP throughput. The istallatio script itself rus for about three to eight hours, depedig o the cofiguratio ad load o the machies. If specific lie-of-busiess software has bee purchased, istallig this software requires additioal time. Istallatio Guide BaaERP o OS/390 UNIX System Services 2-10

21 3 To istall the BaaERP software This chapter describes how to istall the BaaERP software, which requires you: To load the software from CD-ROM To istall the software To perform additioal tasks after the software is istalled The followig sectios describe each actio. To load the software This sectio describes how to load the BaaERP software. NOTE Create stadard users OS/390 user IDs are i uppercase (as i ROOT or BSP). Baa requires two special user IDs i lowercase: root ad bsp. I this sectio, OS/390 user IDs appear i uppercase (ROOT), ad Baa user IDs appear i lowercase (root), except whe they must be etered literally, i which case they are bold. Whe users coect to UNIX System Services directly through logo, the user s user ID is i uppercase. Whe users remotely coect through a Baa presetatio layer that is o a cliet machie, Baa recogizes the case of the user s user ID o the cliet machie. For example, if the cliet machie defies a user ame as joe, ad joe coects to a Baa applicatio ruig o OS/390, the Baa applicatio o OS/390 will recogize this user as joe. However, if joe coects directly with UNIX System Services o OS/390 via a logo widow, his ID will be JOE. This differece betwee uppercase ad lowercase ca cause problems if the Baa userame file i $BSE/lib/user for this user is ot set up appropriately o the OS/390 machie. Whe you specify iformatio i the User Data (ttaad2500m000) sessio, be sure to specify uppercase for the System Logo field. The Baa User field must i be the same case as the user ID o the cliet machie. You must defie a OS/390 user ID BSP with a OMVS segmet with user ID 125, that belogs to a group (preferably BSPGRP) with group ID 125. Furthermore, this user ID must be DBADMIN for the DB2 databases that must cotai the Baa tables ad idexes. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-1

22 To istall the BaaERP software A super user, ROOT, must exist with user ID 0. This user must also be part of the BSPGRP. Ideally, this user ID should also be DBADMIN. At least oe of these user IDs (ROOT or BSP) should have access to TSO. After the user IDs ad groups have bee defied, perform the followig checks: 1 Log o as ROOT to OS/390 UNIX System Services. 2 Check your ID ad group coectio with the ID commad ad esure that your UID is 0, ad your ame root. 3 Set up a user ID alias table, eve if you are ROOT. To do so, issue the % D OMVS,O commad at a cosole (or at your 3270 emulator, usig TSO ad SDSF). Sca the output for USER IDALIASTABLE=. If this lie does ot cotai a value, you ca create a ew file, preferably /etc/alias. If the lie does cotai a value, edit the specified file. You the relate the user ID foud at the ID commad to the Baa user ID root. 4 Perform the same check for user BSP (log o, check the ID, ad make a etry i the user ID alias table). 5 Relate the group BSPGRP to BSP. The file must the have at least the followig etries: :user IDs ROOT BSP root bsp :groups BSPGRP bsp NOTE Here, ROOT ad BSP are the user IDs foud with the ID commad. BSPGRP is the group i which both ROOT ad BSP are members. The secod word of each lie must start at positio 10 ad be lowercase. 6 After you save the file, issue the % SETOMVS User IDALIASTABLE= /etc/alias commad (or whatever file ame was i use) at a cosole. The case i the file ame i the SETOMVS commad must match the case i the file ame. Therefore, you might eed a real cosole for this commad. Reissue the ID commad as a fial check. You might eed to log o as ROOT while this user ID alias table is i effect. Other users that must be defied are DEMO, TOOLS, ad APPLIC. These are cosidered to be ormal users, so they ca be defied to Baa i lowercase, ad to OS/390 i uppercase. There is o special actio, as described above, required for these user IDs. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-2

23 To istall the BaaERP software The followig table ca be used as a referece. Logo ID User ID Primary group Group ID Home directory Password BSP 125 Bsp 125 $BSE/home/bsp 250bSp DEMO 128 Bsp 125 $BSE/home/demo 123demo TOOLS 129 Bsp 125 $BSE/home/tools 123tools APPLIC 130 Bsp 125 $BSE/home/applic 123applic ROOT 0 Bsp 125 NOTE If you wat to defie the $BSE variables i the.profiles of the users (istead of to the system wide /etc/profile), be aware of the followig: durig the istallatio, the ${BSE}/home/logiid directories are created (if they do ot already exist), ad the BaaERP.profiles are created ad placed i these directories. If you already have (default).profiles i these directories, these profiles will ot be overwritte. Defie the Hierarchical File System (HFS) The file systems are cotaied i OS/390 data sets. If the data sets are ot defied to OS/390, have the local system programmer perform the followig steps: 1 Establish data set ames. Cosult the local system programmer about amig covetios. You should use OS/390 data set ames with the followig amig covetios: High Level Qualifier: Baa. Middle qualifier: versio idetifier (such as ERP). Suffix type: see the table later i this sectio for the recommeded types. 2 Defie the istallatio data sets to the security subsystem (optioal). 3 Defie a ALIAS to the OS/390 master catalog (optioal). 4 Allocate the data sets (required) by usig [Ð ISH, optio ÐFile_Systems/ÐNew]. Type the fully qualified ame, (such as BAAN.ERP.BSE) ext to the file system ame. Next, eter the umber of cyliders. The umber of cyliders depeds o the device type i use at your istallatio. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-3

24 To istall the BaaERP software Use the followig table to determie the umber of primary cyliders: Type Cyls (3380) Cyls (3390) BSE AUDIT * * DUMP * * INSTALL Your data set ame Your moutpoit * The size of the HFS will vary depedig o the actual size of the tables, history to be kept olie, tables to be audited, ad so forth. These ca be defied later. Durig the istallatio, they ca be part of the BSE file system. The umber of secodary cyliders for type BSE must be 0. You ca select a relatively small umber of primary cyliders ad a large umber of secodary cyliders for the other data sets. Cosult the systems programmer for all storage classes, maagemet classes, ad data classes, because they are site depedet. For performace reasos, you ca choose to spread the data sets over several volumes. After allocatig the data sets, mout the data sets usig ormal UNIX rules (such as, create the directory first). You must be a super user to mout the data sets. If you are ot logged o as root, try to switch user by selectig ÐSetup i ISH s Mai meu, ÐEable superuser mode. Next, reselect ÐFile_Systems/ Ð Mout. O this pael, eter the mout poit, the file system ame, ad the file system type (HFS). Update the SYS1.PARMLIB to automate the mout of HFS. This eds, for ow, the steps to be performed by the local systems programmer. Copy the CD-ROM Usig (biary) FTP from ay workstatio that is equipped with a CD-Rom reader ad the appropriate software, copy the istallatio CD(s) to the INSTALL moutpoit you just defied. First, copy applicatio CD 1, the (if preset) applicatio CD 2, ad the the portig set CD. After the copy is complete, issue the followig commads to extract the archived files: pax rvf fileame from CD1 -o from=iso8859-1,to=ibm-1047 pax rvf fileame from CD2 -o from=iso8859-1,to=ibm-1047 pax rvf port_390.pax You must covert the data packaged i CD1 (ad CD2) from ASCII to EBCDIC. The data packaged i the portig set CD is already i EBCDIC. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-4

25 To istall the BaaERP software NOTE To istall the software After you have extracted the software, istall it with the istall6.2 istallatio script. DB2 must be istalled ad ruig before the BaaERP software ca be istalled. Eve if you ited to use Process Maager, you must complete the istallatio without ruig Process Maager. Take the followig steps to istall the BaaERP software: 1 Log o as user ROOT (do ot use the su commad). Set the TERM variable to vt100 or ay other valid value. Use ev to display the OS/390 eviromet settigs. To determie the valid BaaERP values, check the subdirectories of l.0000/bse/lib/termif uder the istallatio directory. Istallatio moves this directory to $BSE/lib/termif. 2 Set the _CEE_RUNOPTS ad the other eviromet variables as follows: DB2_MVS_SYNTAX=1 _CEE_RUNOPTS= HEAP(24M),STACK(131072,131072,ANYWHERE,KEEP),ALL31(ON), TERMTHDACT(UADUMP) _BPX_SPAWN_SCRIPT=YES LIBPATH=/usr/lpp/bpa/lib:/baaERP/bse/bi: /usr/lpp/cmx/lib:$libpath NLSPATH=/usr/lpp/bpa/ls/msg/%L/%N:/usr/lpp/cmx/ls/msg/%L/%N:$NLSPATH export DB2_MVS_SYNTAX _CEE_RUNOPTS _BPX_SPAWN_SCRIPT LIBPATH NLSPATH NOTE CAUTION 3 Chage directories to the directory i which the BaaERP files were extracted ad eter the followig commad: #../istall6.2 You ca stop the istallatio script at ay poit before the fial questio: Are you ready for istallatio? To stop the script, press the iterrupt <CTRL>[C]. The script ca be restarted as ofte as you like. From the script, a subshell ca be activated by pressig EXCLAMATION POINT. To ed this subshell, type exit at the OS/390 prompt. You will retur to the script at the poit where you left. Never use the tee commad to create a log file. The istallatio script will start the bshell ad if the tee commad has bee used, o bshell widow will appear o the scree. Durig the istallatio, the logfile log.istall6.2 is geerated i the directory where the istallatio was started. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-5

26 To istall the BaaERP software NOTE NOTE 4 After a temporary bse eviromet is created uder the istallatio directory, you are asked to supply the path to the BSE directory. Be sure to eter the complete path. The path must be at least two directories deep, for example, /usr2/bse. Use a BSE path such as /usr2/baan5/bse. If you have multiple istallatios, a path ame such as this allows you to easily see which software belogs to each eviromet. 5 You are asked to specify the eviromet variable BSE_TMP. Supply the path or accept the displayed default. 6 Whe you are asked if you wat to write the values of the $BSE-related variable to the /etc/profile systemwide profile or to the.profile files of the idividual users, ad you do ot wat your existig path to be overwritte, you must click No. If you are usig Process maager, the profiles of each user are ot used. 7 Whe you are asked to eter the host ames of the systems for which a licese is required, the istallatio procedure displays the ame of the local system as the default. Supply the host ame(s). 8 You are asked to specify a database driver for compay 000. Type the umber correspodig to DB2 i the list of database drivers. Press ENTER. 9 You are asked to supply the value of the DB2INSTANCE eviromet variable. This is the ame of the DB2subsystem metioed i the preistallatio tasks. I the example istallatio, the DB2 istace ame is DBA1. 10 You are asked to specify iformatio for oe or more other compaies. Eter the same iformatio as you did for Compay 000 or choose differet database drivers ad istaces for the other compaies. 11 A list of drivers selected for each compay appears. If the displayed list is correct, press ENTER to cotiue. If the list is ot correct, eter the correct iformatio. 12 You are asked to supply the path for the directories where the Dictioary tables are to be stored. Type a directory path or press ENTER to accept the default path. Press ENTER to cotiue. 13 You are asked to supply the path for the directories where the dumps of the Demo tables are to be stored. Type a directory path or press ENTER to accept the default path. Press ENTER to cotiue. Agai, press ENTER to cotiue. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-6

27 To istall the BaaERP software EXAMPLE 14 You are asked which VRC of the BaaERP packages you wat to iclude i the package combiatio. Select B50 (Versio), b (Release) for all BaaERP packages. 15 You are ow asked to eter the ame of the package combiatio to be created. Type the ame of the package combiatio or press ENTER to accept the default. If oly stadard VRCs are available, create a stadard package combiatio with the ame b50srelease, for example b50sa. 16 You are asked for a descriptio of the package combiatio. Type the descriptio or press ENTER to accept the default. 17 A list of packages that will be istalled for the package combiatio etered appears. Press ENTER to accept. 18 You are asked if you wat to ru multiple bshells. This is ot yet supported o this release. Press ENTER to cotiue ad get the default of No. 19 If the biaries to be istalled ca accommodate multibyte, the system will ask a umber of questios relatig to multibyte. Because multibyte is ot yet supported by the portig set, you must aswer No to these questios. 20 At this poit of the istallatio, you are asked if the istallatio is ready to start. Type Yes ad the system starts the istallatio process. 21 The preist utility that checks the UNIX eviromet is ot used for OS/ The you will be asked to set up the RDBMS layout of your eviromet. You must use the db2_istall6.2 script located uder $BSE/bi to set up your database eviromet, which must be started i a separate sessio. This script ca oly be started after completio of the OS/390 UNIX System Services Coectio Scalig kit istallatio. For more iformatio o ruig db2_istall6.2, see Chapter 6, DB2 database driver iterals ad exterals. 23 You must retur to the scree you left whe you opeed a ew sessio to start the db2_istall6.2 script. Press ENTER to cotiue. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-7

28 To istall the BaaERP software 24 You are iformed that the shared memory for the temporary eviromet is beig stopped. At this poit, you must istall either BI or BW to complete the istallatio. The followig message appears. The host ame ad directory paths will be differet for your istallatio. Istallatio iterrupted: Thu Feb 26 13:12:17 MET 1998 You ca use BI or BW to cotiue the istallatio Whe usig BI: istall BI o your HTTP server - copy the HTML page /usr1/tape/istall.html to the BI subdirectory cliet - start your iteret browser ad select page istall.html Whe usig BW: istall BW o your workstatio (from /usr4/baa/bse/mswidows) - start BW usig the followig cofiguratio: Hostame: Coect As: BSE Commad: cosmos root /usr1/baa/bse --ottiex1287 /usr1/tape Whe BI or BW has fiished executig, you ca cotiue this istallatio Cotiue? (y/): 25 Do ot press [Y] to cotiue util you have istalled BW. 26 To istall BW, you must dowload the BW biary files to your Widows NT or 95 workstatio, for example \TEMP. 27 Ope a DOS commad prompt ad chage to the directory where you wat to place the files: cd \temp 28 Start ftp with the followig commad: ftp hostame where hostame is the ame of the OS/390 host system. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-8

29 To istall the BaaERP software 29 You are prompted for your user ame ad password o the host. Log o as OS/390 user root. 30 Type the followig commads to chage to the OS/390 directory where the BW files are stored ad to fid the ame of the BW directory: cd bse/mswidows/bw ls where bse is the complete path to the BSE. 31 Chage directories to i386 or alpha, depedig o which cliet you are istallig. 32 Type the followig commads to retrieve the BW biary files i biary mode with the iteractive mode tured off for coveiece: bi prompt mget * 33 The files will be dowloaded to the directory you created for BW. Eter bye to leave ftp ad go to Widows Explorer ad ope this directory. Doubleclick the setup file. This starts the BW istallatio program. 34 A Welcome message appears. Click Next. 35 A Licece Agreemet message appears. Click Yes. 36 The Select Eviromet dialog box appears. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-9

30 To istall the BaaERP software If you perform a fresh istallatio, select Istall ew eviromet ad eter a ame for the ew istallatio. If you wat to upgrade a existig BW istallatio, you must select Select existig eviromet. Click Next to cotiue. 37 The Choose Destiatio Locatio dialog box appears. The layout of the dialog box depeds o whether you are istallig BW o a PC cliet or a Widows NT server. If you are istallig o a PC cliet, the followig dialog box appears: Istallatio Guide BaaERP o OS/390 UNIX System Services 3-10

31 To istall the BaaERP software If you are istallig o a Widows NT server, the followig dialog box appears: Accept the default path or click Browse to eter aother path. Click Next to cotiue. 38 The Select Program Folder dialog box appears. Select the program folder to which the BaaERP Widows icos must be added (default BaaERP) ad click Next. 39 The Setup Iformatio dialog box appears. Click Next to cotiue with the displayed setup (or click Back to chage the displayed setup). Istallatio Guide BaaERP o OS/390 UNIX System Services 3-11

32 To istall the BaaERP software 40 Whe setup is complete, click OK. Start BW by selectig BW from the BaaERP program group. The BW Cofiguratio dialog box appears. Type the ame of the OS/390 host computer i the Host ame field. Coect as root. Type the complete path ame to the BSE, the bshell ame, ad the commad. Click RUN! NOTE Check the ipc_ifo file (see appedix B for settigs i this versio) Istallatio Guide BaaERP o OS/390 UNIX System Services 3-12

33 To istall the BaaERP software 41 Whe the istallatio is complete, switch back to the OS/390 widow show below: Istallatio iterrupted: Thu Feb 26 13:12:17 MET 1998 You ca use BI or BW to cotiue the istallatio Whe usig BI: istall BI o your HTTP server - copy the HTML page /usr1/tape/istall.html to the BI subdirectory cliet - start your iteret browser ad select page istall.html Whe usig BW: istall BW o your workstatio (from /usr4/baa/bse/mswidows) - start BW usig the followig cofiguratio: Hostame: Coect As: BSE Commad: cosmos root /usr1/baa/bse --ottiex1287 /usr1/tape Whe BI or BW has fiished executig, you ca cotiue this istallatio Cotiue? (y/): 42 Press [Y] to cotiue. You are retured to the bshell prompt. A patch tape (if preset) must be istalled after the istallatio of BaaERP is completed. Use the istall6.2 script i the directory i which the patch tape is read. Before you istall the patch, first read the readme file i the patch directory. Refer to the istallatio maual of the patch tape for more details. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-13

34 To istall the BaaERP software To perform additioal tasks after the software is istalled After the istallatio has fiished, you must perform the followig steps: 1 Verify that the istallatio directory is empty. The log files for the istallatio are i $BSE/log. Check these log files, especially log.istall Make sure that the moutpoit ad file system ame are specified i the BPXPRMxx member i SYS1.PARMLIB. The local system programmer must update the member. 3 Make sure the home directories of the stadard users are the home directories created durig the istallatio. Modify the.profiles, if ecessary. The lies i the followig example must be icluded for Baa users. I this example, assume the $BSE eviromet variable /baaerp/bse. The _CEE_ RUNOPTS variable ca be differet depedig o the type of users. DB2_MVS_SYNTAX=1 _CEE_RUNOPTS= HEAP(17M,1M,ANYWHERE,KEEP),STACK(131072,131072,ANYWHERE,KEEP),ALL31(o ), LIBSTACK(8),TERMTHDACT(UADUMP) _BPX_SHAREAS=YES LIBPATH=/usr/lpp/bpa/lib:/baaERP/bse/bi: /usr/lpp/cmx/lib:$libpath NLSPATH=usr/lpp/bpa/ls/msg/%L/%N:/usr/lpp/cmx/ls/msg/%L/%N: $NLSPATH export DB2_MVS_SYNTAX _CEE_RUNOPTS _BPX_SHAREAS LIBPATH NLSPATH 4 Create a eviromet settigs file i the $BSE directory by usig the file ame setbse. You ca use this file to set the Baa eviromet variables at ay time by eterig../setbse while you are i the $BSE directory. I this file, set the variables for BSE, BSE_TMP, PATH=$BSE/bi:$PATH, LIBPATH=$LIBPATH:/usr/lpp/bpa/lib:usr/lpp/cmx/lib:baaERP/bse/bi ad TERM (for example =vt100). Do ot forget to isert the lie export BSE BSE_TMP PATH TERM. For example, see the followig sample setbse file. BSE=/baaERP/bse BSE_TMP=$BSE/tmp PATH=$BSE/bi:$PATH TERM=vt100 LIBPATH=$LIBPATH:/usr/lpp/bpa/lib:/baaERP/bse/bi export BSE BSE_TMP PATH TERM LIBPATH Istallatio Guide BaaERP o OS/390 UNIX System Services 3-14

35 To istall the BaaERP software 5 Your user profiles must ivoke the setbse script created i the previous step so that each user has the BSE, BSE_TMP, PATH, LIBPATH ad TERM eviromet variables specified. For example:./baaerp/bse/setbse DB2_MVS_SYNTAX=1 _CEE_RUNOPTS= HEAP(17M,1M,ANYWHERE,KEEP),STACK(131072,131072,ANYWHERE,KEEP),ALL31(O N), LIBSTACK(8),TERMTHDACT(UADUMP) _BPX_SHAREAS=YES LIBPATH=/usr/lpp/bpa/lib:/baaERP/bse/bi: /usr/lpp/cmx/lib:$libpath NLSPATH=usr/lpp/bpa/ls/msg/%L/%N:/usr/lpp/cmx/ls/msg/%L/%N:$NLSPATH export DB2_MVS_SYNTAX _CEE_RUNOPTS _BPX_SHAREAS LIBPATH NLSPATH 6 If you are usig Process Maager, the.profile i the home directory of each user is ot processed. Istead, you ca create a file called bpaprofile that cotais the ames ad values of eviromet variables to export. Place the bpaprofile ito the home directory of the user, where the.profile would geerally reside. For example, to set the eviromet variables that are described i this sectio, the bpaprofile for a user would be: //sample bpaprofile this is a commet lie BSE=/baaERP/bse BSE_TMP=/baaERP/bse/tmp PATH=$BSE/bi:$PATH TERM=vt100 DB2_MVS_SYNTAX=1 _CEE_RUNOPTS= HEAP(17M,1M,ANYWHERE,KEEP),STACK(131072,131072,ANYWHERE,KEEP),ALL31(O N), LIBSTACK(8),TERMTHDACT(UADUMP) BPX_SHAREAS=YES _BPX_SPAWN_SCRIPT=YES LIBPATH:=/usr/lpp/bpa/lib: /usr/lpp/cmx/lib: baaerp/bse/bi: $LIBPATH NLSPATH=/usr/lpp/bpa/ls/msg/%L/%N:/usr/lpp/cmx/ls/msg/%L/%N:$NLSPATH export BSE BSE_TMP PATH TERM DB2 MVS_SYNTAX _CEE_RUNOPTS _BPX_SHAREAS LIBPATH NLSPATH No quotes or spaces are allowed i the specificatio of the eviromet variable values. Each user ca have a differet bpaprofile, which ca be used to set the _CEE_RUNOPTS settig to appropriate HEAP values for each user. For example, if you have a specific user that could ru ito storage costraits with a 17MB HEAP, you ca icrease that user s HEAP size by chagig the _CEE_RUNOPTS settig i that user s bpaprofile. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-15

36 To istall the BaaERP software Ru-time cosideratios For performace beefits durig ormal operatios, you ca use a smaller db2_storage file that cotais geeric wild card characters. Make sure the file is as small as possible. You ca also use a DB2 pla with DYNAMICRULES(BIND) durig ru time. DYNAMICRULES(BIND) ca supply some storage savigs but supports oly DML (o table defiitive statemets). Commuicatio betwee the bshell applicatio ad the DB driver executable is usually accomplished by usig sockets, pipes, or message queues. For Baa o OS/390, a additioal commuicatio mode exists that is supported, amely DIRECT. Whe you use this mode of commuicatio, the bshell process ad the DB driver process are actually combied ito oe, ad the commuicatio is performed by call ad retur. Direct mode is helpful for performace. To use direct mode, you must modify the $BSE/lib/ipc_ifo to specify a d for the commuicatio method to the db2srv62 executable. For example, this is the $BSE/lib/ipc_ifo file that uses the PIPE mode of commuicatio. Note the p for PIPE i colum 5: db2 s p ${BSE}/bi/db2srv62 I the ext example, the $BSE/lib/ipc_ifo file uses the direct mode of commuicatio. Note the d for direct i colum 5: db2 s d ${BSE}/bi/db2srv62 Oly the db2srv62 executable supports the direct mode of commuicatio. Whe you use the direct mode, you must apped the $BSE/bi directory to the LIBPATH eviromet variable. For example, if your $BSE eviromet variable is /baaerp/bse, the followig must appear i the user s profile: export LIBPATH=$LIBPATH:/baaERP/bse/bi The LIBPATH update was also explaied at the begiig of this chapter. Usig multiple file systems For better performace ad system maagemet, you must defie multiple HFS data sets for differet parts of the applicatio eviromet: for example, BSE, DICT, AUDIT, APPLICATION, ad HOME. There are umerous ways to lay out the OS/390 UNIX System Services file systems for a Baa cofiguratio. If ecessary, you ca use oly oe file system for all the Baa directories, or you ca use umerous file systems ad specify the appropriate mout poits. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-16

37 To istall the BaaERP software The followig example shows a possible cofiguratio for HFS data sets, which assumes that the $BSE eviromet variable at your site is /baaerp/bse. If the eviromet variable is differet, your amig covetios ca vary: HFS dataset BAAN.ERP.ROOT BAAN.ERP.AUDIT BAAN.ERP.DICT BAAN.ERP.TEST BAAN.ERP.BSE.APPLIC BAAN.ERP.BSE.BIN BAAN.ERP.BSE.LIB BAAN.ERP.BSE.LOG BAAN.ERP.BSE.TOOLS BAAN.ERP.BSE.TMP BAAN.ERP.BSE.HOME Mout poit /baaerp /baaerp/audit /baaerp/dict /baaerp/test /baaerp/bse/applicatio /baaerp/bse/bi /baaerp/bse/lib /baaerp/bse/log /baaerp/bse/tools /baaerp/bse/tmp /baaerp/bse/home Oe advatage of havig umerous file systems is that you ca distribute these file systems amog various volumes i your storage groups. There are also maiteace beefits, because each file system ca grow to the maximum size of the volume o which it resides. If you choose to have umerous file systems, you may wat to add these to the list of file systems to mout durig IPL. These file systems are foud i your BPXPRMxx member of SYS1.PARMLIB, ad this locatio esures that all file systems will be mouted durig a system IPL. Furthermore, you must perform the followig fuctios: Mout the ew file systems uder a temporary mout poit Copy the directories to the temp mout poits Remove the origial ad temp mout poits Mout the ew mout poits at the right place Ufortuately, you caot set up the file system durig istallatio because the istallatio scripts try to move directories. You caot move directories to mout poits, but you ca copy them. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-17

38 To istall the BaaERP software To ru from Lik Pack Area (LPA) For both storage savigs ad improved performace, you should ru the mai BAAN executables ad the Coectio Maager dll (cmxdll) from LPA. The two pricipal executables are the bshell ad the DB2 driver, but you ca also load sh_server6.2, sort6.2, audit_srv6.2, globlv6.2, cmxdll, bpassp, bpsspm, ad bpadll ito LPA. The local systems programmer ca take the followig steps : 1 Verify that PTF UW49280 is istalled. Ru the followig sample JCL to add the bshell ad sh_driver, as well as sort to LPA. These executables origiate i the HFS ad are located i the directory idetified by the INLMOD statemet. 2 Specify a absolute path ame, ad this value is case sesitive. I this example, the executables are located i /baaerp/bse/bi, /usr/lpp/bpa/lib, ad /usr/lpp/cmx/lib. The modules must be liked ito a partitioed data set (PDS) that is part of the LPALST cocateatio durig IPL (defied i the LPALSTxx member of SYS1.PARMLIB). Cosult your OS/390 systems programmer for the ame of a PDS that is cocateated to LPALST for your system. The ame of the PDS must be specified i the SYSLMOD value I the followig example, the PDS, SYS1.BAAN.LPALIB, is used as the SYSLMOD value. The INCLUDE INLMOD statemet idetifies the ame of the executable as it appears i the hfs, ad it is case-sesitive. The NAME statemet is a symbolic referece to the module. This statemet must be less tha or equal to eight characters, ad it caot cotai ay special characters such as a period (.) or a uderscore (_). //JOBNAME JOB (add the local job ifo here ) //* //DBDLINKC EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /baaerp/bse/bi DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(db2srv62) ENTRY CEESTART /* NAME DB2SRV62(R) Istallatio Guide BaaERP o OS/390 UNIX System Services 3-18

39 To istall the BaaERP software //BSHLINK EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /baaerp/bse/bi DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(bshell6.2) ENTRY NAME CEESTART BSHELL62(R) /* //SHSLINK EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /baaerp/bse/bi DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(sh_server6.2) ENTRY NAME CEESTART SHSERV62(R) /* //SRTLINK EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /baaerp/bse/bi DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(sort6.2) ENTRY NAME CEESTART SORT62(R) /* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD DD PATH= /baaerp/bse/bi Istallatio Guide BaaERP o OS/390 UNIX System Services 3-19

40 To istall the BaaERP software //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(audit_srv6.2) ENTRY NAME CEESTART AUDITS62(R) /* //GLOBLVAR EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /baaerp/bse/bi DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(globlv62) ENTRY NAME CEESTART GLOBLV62(R) /* //BPADLL EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /usr/lpp/bpa/lib DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(bpadll) ENTRY NAME CEESTART BPADLL(R) /* //BPASSP EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /usr/lpp/bpa/bi DD UNIT=SYSDA,SPACE=(CYL,(10,10)) Istallatio Guide BaaERP o OS/390 UNIX System Services 3-20

41 To istall the BaaERP software //SYSLIN DD * INCLUDE INLMOD(bpassp) ENTRY NAME CEESTART BPASSP(R) /* //BPASSPM EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /usr/lpp/bpa/bi DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(bpasspm) ENTRY NAME CEESTART BPASSPM(R) /* //CMXDLL EXEC PGM=IEWL, // PARM= LIST,XREF,LET,RENT,REUS,AMODE=31,RMODE=ANY,CASE=MIXED //SYSPRINT DD SYSOUT=* //SYSLMOD DD DISP=SHR,DSN=SYS1.BAAN.LPALIB //INLMOD //SYSUT1 DD PATH= /usr/lpp/cmx/lib DD UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSLIN DD * INCLUDE INLMOD(cmxdll) ENTRY NAME CEESTART CMXDLL(R) /* Istallatio Guide BaaERP o OS/390 UNIX System Services 3-21

42 To istall the BaaERP software I this example, the followig HFS files are liked ito LPA: Origial HFS file bshell6.2 db2srv62 sh_server6.2 sort6.2 globlvar bpadll audit_srv6.2 bpassp bpasspm cmxdll LPA module from NAME statemet bshell62 db2srv62 shserv62 sort62 Globlvar Bpadll audits62 Bpassp Bpasspm Cmxdll NOTE I these statemets, db2srv62, globlv62, ad sort62 are required ames. I this statemet, db2srv62 is the DB driver, ad it must be liked ito LPA with this ame. The sort6.2 executable must be liked ito LPA with the ame sort62. The bshell62, shserv62, ad audirs62 ames are of your ow choosig, but they must coform to the amig covetios for LPA modules ad match with the ames from the file ipc_ifo. The executables, bpadll, bpassp, ad bpasspm are Process Maager executables ad these ames are required. The executable cmxdll is a Coectio Maager executable, ad the ame, cmxdll, is required. 3 To use the executables from LPA, you must have a file with a ame that matches the LPA module. For example, you must have bshell62, globlvar, db2srv62, shserv62, ad sort62 files i the $BSE/bi directory. The globlvar ad db2srv62 files already exist. However, the other files must be created i the $BSE/bi directory. These files ca be empty, as i the followig example: touch bshell62 touch shserv62 touch sort62 Istallatio Guide BaaERP o OS/390 UNIX System Services 3-22

43 To istall the BaaERP software NOTE Next, you must tur o the sticky bit for these modules. This actio idicates to OS/390 that the LPA versios of these modules must be used. All modules that you wat to use from LPA must have the sticky bit, icludig the DB driver: chmod ugo+t bshell62 chmod ugo+t db2srv62 chmod ugo+t shserv62 chmod ugo+t sort62 chmod ugo+t globlvar chmod ugo+t /usr/lpp/bpa/lib/bpadll chmod ugo+t /usr/lpp/bpa/bi/bpassp chmod ugo+t /usr/lpp/bpa/bi/bpaspm chmod ugo+t /usr/lpp/cmx/lib/cmxdll These ew LPALST members ca be activated by either a IPL or, dyamically, by usig SETPROG LPA. Next, use the ADD commad. 4 Specify the executables to be used i the $BSE/lib/ipc_ifo file, as follows: bshell s 0 0 p ${BSE}/bi/bshell62 sh_server s 0 0 p ${BSE}/bi/shserv62 audit fs6.2 s p ${BSE}/bi/audits62 s m ${BSE}/bi/fs6.2 server s 0 0 s ${BSE}/bi/server62 db2 server6.2 s d ${BSE}/bi/db2srv62 s p ${BSE}/bi/server6.2 NOTE The sort62, globlvar, bpadll, ad cmxdll will be automatically used from LPA if they are liked properly ad if they have the sticky bit tured o. To clea the user ID alias table Try to avoid cleaig the user ID alias table. However, if you thik you will have serious problems if you do ot clea this table, you ca remove the etry for root from the user ID alias table. Leave the bsp ad bspgrp etries i the file. Issue the % SETOMVS User IDALIASTABLE= /etc/alias commad agai after savig the file. Istallatio Guide BaaERP o OS/390 UNIX System Services 3-23

44 To istall the BaaERP software Istallatio Guide BaaERP o OS/390 UNIX System Services 3-24

45 4 To customize the BaaERP software NOTE After BaaERP is istalled, the demo tables must be created ad filled ad several aspects must be cofigured. These tasks are performed o the Widows NT or Widows 95 machie o which BW was istalled i the previous chapter. This chapter describes how you ca do the followig: Istall the demo tables Create tables for the demo models Import the versio dumps Iitialize parameters Reorgaize tables Cofigure shared memory Create the audit database ad assigig tables Validate the system Defie the default currecies Chage passwords Notes for developer data Notes to set up priters I the followig descriptios you must choose the Covert to Ru Time commad several times. Note that you must save the chages before you use the Covert to Ru Time commad. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-1

46 To customize the BaaERP software NOTE To istall the demo tables At this poit you must istall the demo tables for Compay 000 ad for the demo compay or compaies. To istall the demo tables, do the followig: If you are usig 1 database/1 tablespace, you must stop the priter daemo first. Otherwise, you will ecouter deadlocks (Baa error 850). 1 Start BW ad log o as bsp. O the File meu i the Meu Browser, choose Ru Program. 2 Type ttiex1290m000 i the Program/Sessio field. Click OK. 3 The ttiex1290m000: Istall Demo Tables dialog box appears. I the From field, eter 000. Click the Browse butto ext to the To field (the triagle to the right of the field). 4 A scree appears showig iformatio o all the Baa compaies. Click the compay for which you wat to istall tables ad click OK. If you wat to istall the demo tables for all compaies, click the compay with the largest compay umber ad click OK. The compay umber appears i the To field of the Istall Demo Tables dialog box. 5 Select the Overwrite Existig Tables check box. Click Istall. 6 The cursor chages to the hourglass shape while the demo tables are istalled. Whe the cursor returs to the arrow shape, click Close. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-2

47 To customize the BaaERP software To create tables for the demo models You must ow create tables for each compay for which you istalled demo tables i the previous sectio. To create these tables, do the followig (i the example below tables are created for compay 813 through 900): 1 O the File meu i the Meu Browser, choose Ru Program. 2 Type ttaad4230m000 i the Program/Sessio field. Click OK. 3 The ttaad4230m000 : Create Tables dialog box appears. Type 813 i the From field ad 900 i the To field. Click Create. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-3

48 To customize the BaaERP software 4 The Select Device dialog box appears. Choose the device where you wat messages to appear. For example, type d i the Device field to have messages prited to the scree. Click Cotiue. 5 Whe the tables have bee created, click Close. CAUTION To import the versio dumps Now that the tables have bee created for the demo compaies, you must import the versio dump for each demo compay. To import the versio dumps, do the followig: 1 Start BW. O the Optios meu, i the Meu Browser, choose Chage Compay. Chage to oe of the demo compaies. Compay 000 is ot a demo compay, so do ot select Compay O the File meu, choose Ru Program. 3 Type tgbrg1245m000 i the Program/Sessio field ad click OK. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-4

49 To customize the BaaERP software 4 The tgbrg1245m000: Import Versio Dump dialog box appears. I the File field, type the file ame for the demo compay. Note that you must select the Overwrite check box. The followig example shows the file ame for demo compay 813: path/test/tgb50_b/813/813/baanerp-pd.z NOTE where path is the path of the Baa directory, for example /usr2/baa. 5 Click Import. The cursor chages to the hourglass shape while the versio dumps are beig imported. A scree will appear askig if you wat to import compoets from BaaERP 1. Click Yes. 6 Whe the import is complete, ad there is more tha oe demo compay, repeat steps 2-5 for each demo compay. 7 Click Close o the tgbrg1245m000 : Import Versio Dump dialog box. This may take several miutes. You might have to stop ad restart shared memory oce this sessio is completed. To iitialize parameters Take the followig steps to iitialize the parameters: 1 Log o as user bsp ad switch to a compay other tha 000. To switch to aother compay, o the Optios meu, choose Chage Compay. 2 O the File meu, choose Ru Program to eter tcmcs0295m000 (Iitialize Parameters). 3 Click Cotiue. 4 Repeat steps 2 ad 3 for all demo compaies except compay 000. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-5

50 To customize the BaaERP software To reorgaize tables Take the followig steps to reorgaize the tables: 1 Log o as user bsp ad switch to a compay other tha 000. To switch to aother compay, o the Optios meu, choose the Chage Compay. 2 O the File meu, choose Ru Program ad eter the sessio code ttaad4225m000 (Reorgaize tables). 3 Click Reorgaize. 4 Repeat the steps 2 ad 3 for all demo compaies except compay 000. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-6

51 To customize the BaaERP software To cofigure shared memory To improve processig speed, frequetly used data objects ca be stored i shared memory where all ruig Baa processes ca access them. To set up shared memory To specify which objects are stored i shared memory, do the followig: 1 Start BaaERP. O the File meu i the Meu Browser, select Ru Program. Type ttaad4150m000 i the Program/Sessio field. Click OK. The Shared Memory Data (ttaad4150m000) sessio appears. O the Group meu, choose Fid. 2 I Shared Memory Data Type field, select Program Objects. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-7

52 To customize the BaaERP software 3 O the Specific meu, choose Copy Object from DD. 4 The Copy Program Objects (ttaad4252s000) sessio is started. Eter the followig iformatio: 5 The Shared Memory Data (ttaad4150m000) sessio is redisplayed, this time filled with data. 6 Repeat steps 4 ad 5 for the programs dsk to dskzzzzzzz ad stp to stpzzzzzzz. Click OK i the scree that appears. 7 O the Specific meu, choose Covert to Rutime. 8 Exit the BaaERP sessio ad log o to the BaaERP server as user root. 9 Eter the followig commads to reload shared memory: # cd $BSE/bi #./srdd_iit6.2 -i Istallatio Guide BaaERP o OS/390 UNIX System Services 4-8

53 To customize the BaaERP software To create the audit database ad to assig tables BaaERP icludes a audit facility that ca log all parameter chages. To use this audit, you must first create a audit database ad assig tables to it. To do so, follow the steps described below: 1 Log o as user bsp. 2 O the Tools meu, go to the Database Maagemet meu,. 3 O the Database Defiitios ad Directories meu, double-click the Audit File Directories (ttaad4116m000) sessio. 4 I the Table Selectio field, select All (other) Tables ad isert the path ame for the $BSE/audit /# audit directory (the umber sig idicates that for each compay a separate directory is created uder $BSE/audit). 5 O the Specific meu, choose the Covert to Ru Time commad ad close ad restart the bshell. 6 Log o as user bsp. 7 O the Tools meu, go to the Database Maagemet meu. 8 O the Database Defiitios ad Directories meu, double-click the Tables by Database (ttaad4111m000) sessio. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-9

54 To customize the BaaERP software 9 Isert all tables you wat audited. Note that the database field must be filled with the 001 database. The Table Selectio field eables you to specify idividual tables, all tables i certai modules, ad all (other) tables. To isert the madatory tables, o the Specific meu, choose Load Madatory Tables for Audit. 10 O the Specific meu, select the Covert to Ru Time commad. Close ad restart the bshell. IMPORTANT NOTE To validate the system This sectio describes how to validate your BaaERP system. The procedure described below assumes that the customer code ad licese code are kow. So, the Baa Compay must have set these codes after receivig the order form. Take the followig steps to validate the system: 1 Log o as root. 2 Go to the Software Istallatio folder i BaaERP Tools. 3 From the Validatio folder, double-click the Requested System Cofiguratio (ttiex3101m000) sessio. You are asked to supply a password. You must eter the default password Yi984. Do ot give the default password to uauthorized people, because iexperieced people ca seriously damage your system. 4 O the Group meu, choose New. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-10

55 To customize the BaaERP software 5 Eter the start date i the From Date field ad press the <TAB> key. Eter the ed date of your licese i the Ed Date field ad press the <TAB> key agai to supply the Number of Seats (that is, the umber of cocurret users). 6 To select the supported database (the RDBMS o which the BaaERP istallatio is ruig), select the correspodig Ruable check box. Select the Ruable check box for the other licesed parts as well. 7 Save ad exit the sessio. 8 From the Validatio folder, double-click the Prit Requested System Cofiguratio (ttiex3400m000) sessio, ad prit your system cofiguratio. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-11

56 To customize the BaaERP software 9 Supply the requested iformatio ad click Cotiue. 10 The Select Device sessio is started. Select a priter ad click Cotiue. 11 Provide this pritout to the Baa Compay. This will be used to create the validatio key. Whe you receive this key i a pritout from the Baa Compay, you ca proceed with the validatio. 12 From the Validatio folder, double-click the Security Code/Validatio Key (ttiex3102m000) sessio. 13 Fill i the Validatio Key (Tools) field ad the Validatio Key Software (Stadard) field. Make sure the security key matches the security key o the Baa pritout. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-12

57 To customize the BaaERP software 14 Save ad exit the sessio. From the Validatio folder, start the Validate Tools Set (ttiex3220m000) sessio. Click Cotiue. If the validatio process succeeds, the followig message appears. Click OK. 15 A warig message appears. Read the message ad click Close. 16 Exit the BaaERP sessio. Start a commad lie sessio o your BaaERP server by loggig o as user root. 17 Check the licese daemo by eterig the ps ef grep licd or licmo6.2 b commad. The licese daemo is a process with the ame licd6.2. If ecessary, start the licese daemo by eterig the $BSE/bi/licd6.2 commad. It may take a few momets before the licece daemo is recogized by the bshell. 18 Log off as root ad start a ew BaaERP sessio by loggig o as bsp. 19 From the Validatio folder, double-click the Cofigure Applicatio (ttiex3225m000) sessio. 20 You are asked if you wat to start the licese daemo. Click Yes. Defiig the default currecies Take the followig steps to defie the default currecies: 1 Log o as user bsp. 2 O the Tools meu, go to the Applicatio Cofiguratio meu. 3 From the Compaies ad Package Combiatios folder, double-click the Compaies (ttaad1100m000) sessio. 4 Defie the default currecy for all compaies, for example, USD. 5 O the Specific meu, choose Covert to Ru Time. Istallatio Guide BaaERP o OS/390 UNIX System Services 4-13