Opsætning af Application Server 10g miljø til EASY-A

EASY-A Opsætning af Application Server 10g miljø til EASY-A NOTAT Af: Ove Dalum, Mejar Singh 1. Formål... 2 2. Overordnet Arkitektur... 2 3. PC-klienter... 4 3.1 PDF Reader... 4 3.2 Browser... 4 4. Application Server (OAS platformen)... 5 4.1 Installation af Oracle Application Server (OAS)... 5 4.2 Opsætning efter installation af OAS... 15 4.3 Opsætning af Sqlnet... 15 4.4 Opsætning af Reportsserver... 15 4.5 APS-print... 15 4.6 Oracle Database 10g Client software... 16 4.7 Opsætning af PDF til APS-print output... 16 4.8 Installation af Udskriftsserver... 16 4.9 Rettigheder til udskrifts-katalog... 17 5. Database server (EASY-A opsætning)... 18 5.1 EASY UdskriftsServer... 18 5.2 EASY Oracle brugere... 20 5.3 REPW-jobtrin... 21 5.4 EXEC-jobtrin... 21 5.5 SQL-jobtrin... 21 6. Tjekliste til systemadministratorer... 22 6.1 PC-Klienter... 22 6.2 ApplicationServer... 22 6.3 DatabaseServer... 22 7. Referencer... 22 14.01.2008 A114.7536.3 Side 1 af 22

1. Formål Dette dokument er tilsigtet systemadministratorerne på skolerne. Formålet er at give indsigt i Applications Server arkitekturen og beskrive de indledende opsætninger, der er nødvendige for at køre EASY-A i dette miljø. Desuden beskrives de tilretninger, der skal foretages i EASY-A 10g efter der er opgraderet til version 08.1. 2. Overordnet Arkitektur Nedenfor er arkitekturen skitseret for EASY-A i Application Server miljøet. Miljøet består af 3 maskinlag: PC-klienter, Application Server og Database Server. PC-klienterne er brugernes lokale PC'er, hvor EASY-A tilgås via et browser windue. I browseren vises et billede af EASY-aplikationen, som reelt afvikles på Application Serveren. Application Serveren er en central Windows Server, som har installeret Oracle Application Server programmel, der muliggør afvikling af Oracle Forms i et web miljø. OAS programmellet muliggør kommunikation med Database Serveren, hvor data er placeret. Når der skal afvikles udskrifter kompliceres modellen, da udskrifter består af en række trin som håndteres af Database Serveren. Database-trin afvikles umiddelbart, men klient-trin skal særskilt startes på Application Serveren via et http kald til Udskriftsserveren. Udskriftsserveren er et egenudviklet program, som afløser den gamle klientafvikler. (Forskellen er at Udskriftsserveren ikke er et kontinuerligt kørende program som klientafvikleren var. Udskriftsserveren skal ikke startes, overvåges og vedligeholdes, men blot kaldes for hvert klient-trin). Udskriftsserveren undersøger selv om udskriften er en Reports-udskrift, APS-udskrift eller sql/flettefil, og sender opgaven videre til en af de 3 programmer med tilhørende parametre. Er det på bestillingen valgt Print udskrift printes output til den valgte printer. Til Reports og APS-udskrifter dannes altid PDF filer, som kan vises og printes via A103 Jobovervågning. Dette erstatter det gamle preview koncept. 14.01.2008 A114.7536.3 Side 2 af 22

14.01.2008 A114.7536.3 Side 3 af 22

3. PC-klienter Brugernes PC ere skal opsættes med de efterfølgende programmer. 3.1 PDF Reader Adobe Reader (nyeste version) eller andet produkt der kan vise PDF-filer skal installeres på klienterne for at se indhold af dannede PDF-filer. EASY-A leverer ikke programmet. Installeres af systemadministratoren. 3.2 Browser InternetExplorer 6 eller 7 installeres og opsættes så popups er tilladt til ApplicationServeren, så knappen Vis udskrift på A103 kan åbne nyt vindue til visning af PDF-filen. (Gøres måske nemmest ved første forsøg, hvor man får muligheden for altid at tillade popups fra en bestemt destination) Der kan også anvendes Firefox 2.0, dog er EASY-A ikke testet under Firefox og derfor ikke fuldt supporteret. Desuden skal Suns Java plugins være installeret. Min 1.5.0 Update 14. Der kan downloades fra: http://java.sun.com/j2se/1.5.0/download.html Hvor der vælges Java Runtime Environment (JRE) 5.0 Bemærk at hvis man starter EASY-A i en browser, der allerede har startet en anden applikation, som anvender en anden Java-version end EASY-A kræver, kan man blive bedt om at starte et nyt browser-vindue. Det anbefales at dette trin gennemføres så sent som muligt før omlægningen for at undgå at der kommer nyere Java-versioner i mellemtiden, EASY-A leverer ikke programmet. Installeres af systemadministratoren 14.01.2008 A114.7536.3 Side 4 af 22

4. Application Server (OAS platformen) For en udførlig installationsvejledning for 10g programmel henvises til dokumentet [Inst10g] nævnt i afsnit 7, i dette dokument er der også beskrevet hvor installationsprogrammellet kan downloades. 4.1 Installation af Oracle Application Server (OAS) På Windows Server 2003 R2 med minimum 4 Gb, installeres Oracle Application Server Forms & Reports Services Standalone 10g Release 2 (10.1.2.0.2). Installationspakken kan fx hentes fra Oracle s OTN hjemmeside, hvor installations-programmellet findes i filen: as_windows_x86_forms_reports_101202.zip (496.004.913 bytes) Nødvendig diskplads for selve OAS-installationen er ca. 900 Mb samt ca. 30 Mb i Temp-kataloget. I øvrigt henvises til dokumentet på UNI-C s Admsys hjemmeside vedr. hardware krav til 10g miljø og generelle pladskrav. Som en systemadministrator-bruger startes Setup.exe: På denne velkomst side trykkes blot Next. 14.01.2008 A114.7536.3 Side 5 af 22

I Name-feltet vælges et Oracle home navn til installationen i dette eksempel er valgt FRHome1 og tilhørende Oracle home installations-sti er valgt til D:\oracle\FRHome_1. Disse to Destinations-felter kan dog frit vælges efter forgodtbefindende. Afslutningsvis klikkes på Next-knappen. 14.01.2008 A114.7536.3 Side 6 af 22

I denne dialog kan der vælges yderligere sprog. Der sikres, at der er udvalgt Dansk og Engelsk. Efterflg. kan der fortsættes ved klik på Next-knappen. 14.01.2008 A114.7536.3 Side 7 af 22

Her er der mulighed for automatisk at lade installationsprogrammet fastlægge default porte til programkomponenterne i Forms & Reports Application Serveren. Disse default porte udvælges ved, at tjekke om default porten er i brug af en aktuel kørende proces og i såfald fortsættes med næste port-nr. i port-intervallet indtil der findes en ledig port. Der kan nævnes at default port-nr. for Oracle http Serveren er port 80 og hvis denne port er optaget findes en ledig port i intervallet 7777-7877. Der er som vist på ovenstående dialog-vindue mulighed for manuelt at udpege hvilke porte der ønskes benyttet, dette sker vha. der oprettes en tekstfil: staticport.ini. Hvis dette ønskes anvendt henvises til Oracle s installationsvejledning: http://www.oracle.com/technology/documentation/10g_forms.html part-number B16392-02 Der fortsættes ved klik på Next-knappen. 14.01.2008 A114.7536.3 Side 8 af 22

Her kan der angives en SMTP mail-server såfremt der ønskes mulighed for e-mail afsendelse af reports udskrifter. Da dette ikke pt. er aktuelt i EASY-A kan feltet evt. efterlades tomt og der fortsættes med klik på Next. 14.01.2008 A114.7536.3 Side 9 af 22

Her angives et instans-navn som unikt navngiver Forms&Reports OAS installations instansen. Her er valgt easya_oas. Desuden skal der vælges et password for administrator brugeren ias_admin. Vigtigt! noter dette password da det skal anvendes ved efterflg. vedligehold og installation af EASY-A komponenter fra installationswizarden. Der klikkes Next for at fortsætte. 14.01.2008 A114.7536.3 Side 10 af 22

Her opsummeres de valgte installations-parametre og der listes de program komponenter der vil blive installeret. Ved klik på Install-knappen startes installationen. 14.01.2008 A114.7536.3 Side 11 af 22

Efter endt installation vises næste dialog. 14.01.2008 A114.7536.3 Side 12 af 22

Her kan det anbefales at kopierer indholdet i tekstboksen og gemme dette i tekstfil. For der er listet url'er for Enterprise Manager og Oracle HTTP Server. Efter endt installation kan forms aftestes i en browser, ved kald af: http://<oas-server>:7778/forms/frmservlet bemærk at Oracle Http Serverens port-nr. i dette eksempel er sat til 7778 men kan være sat anderledes (se tidligere afsnit vedr. port-konfiguration). Listen over anvendte porte kan ses i den afsluttende dialog-boks vist ovenfor eller i filen: <OraHome>\install\portlist.ini Ovenstående opstart af forms vil spørge til installation af Oracle Jinitiator. Bemærk Jinitiator ikke skal benyttes til afvikling af den omlagte EASY-A, hvor der skal benyttes Suns Java plugin (se tidligere afsnit 3.2). Efter endt installation skal der yderligere installeres flg. patches i den listede rækkefølge: 1. Patch 4960210 10g release 2 Patch Set 2 (10.1.2.2.0) 2. Patch 5732133 3. Patch 2617419 4. Patch 6062255 Patchene kan downloades fra Admsys-webben eller evt. fra Oracle MetaLink fra: https://metalink.oracle.com 14.01.2008 A114.7536.3 Side 13 af 22

Se evt. beskrivelse af patches i Oracle Metalink note 404477.1, samt den udførlige installationsvejledning [Inst10g]. OAS'en vil i Control panel/administrative tools/services indlægge flg. to Oracle<OASHomeName>services: OracleFRHomeASControl OracleFRHomeProcessManager Indeholder fx EnterpriseManager Processmanager for OC4J, Oracle Http Server etc. Bemærk at for OracleFRHomeProcessManager er der på figuren ændret Log On As til en dedikeret bruger, så EASY-A udskriftsserveren der køres af denne process kan få rettigheder til at skrive til en UNC-sti hvori pdf-filer og flettefiler placeres - se evt. nærmere i afsnit 4.9. Såfremt pdf-filer og flettefiler skal placeres lokalt på applikationserver maskinen kan dette skift af "Log On As" undlades, men der sikres stadig at System-brugeren har de nødvendige filrettigheder. Installeres af systemadministratoren. 14.01.2008 A114.7536.3 Side 14 af 22

4.2 Opsætning efter installation af OAS For at undgå forms-fejlen FRM-92101 der typisk opstår efter der er mange brugere der har EASY-A åben, er det nødvendigt med at skrue op for flg. windows ressource i registrerings-databasen: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ Session Manager\SubSystems her dobbelt-klikkes på Windows-nøglen i højre vindues-afsnit og SharedSection sættes som vist herunder, hvor den sidste værdi er ændret fra 512 til 1024: Problemstillingen er nøjere beskrevet i Metalink note 207706.1 Efter ændringen er en windows genstart påkrævet. Installeres af systemadministratoren. 4.3 Opsætning af Sqlnet PÅ OAS'en i <OASHOME>\network\admin opsættes sqlnet.ora og tnsnames.ora. Kopier evt. filerne fra en anden maskine. Afslut med at teste, at du kan logge på EASY-A databasen vha. sqlplus: Sqlplus esasii/<passwd>@<dbalias> Databasen der forbindes til, skal være skolens driftsbase. Installeres af systemadministratoren. 4.4 Opsætning af Reportsserver Reportsserveren oprettes med navnet EASY-A_REPSRV af systemadministratoren på OAS'en vha. flg. kommando fra en dos kommando-prompt : Addnewservertarget EASY-A_REPSRV Installeres af systemadministratoren. 4.5 APS-print Programmet leveres med EASY-A installationen og placeres under <EASY-A-katalog>/bin/apsprint.exe Installeres af installationswizarden. 14.01.2008 A114.7536.3 Side 15 af 22

4.6 Oracle Database 10g Client software Der installeres Oracle Database 10g release 2 Client Software 10.2.0.1.0 på OAS, da denne programpakke skal benyttes af EASY-A Installationswizarden. Installeres af systemadministratoren. 4.7 Opsætning af PDF til APS-print output PDFCreator 0.9.5 skal installeres på ApplicationServeren som en printer-driver. For installationsvejledning henvises til [Inst10g]. Installeres af systemadministratoren. 4.8 Installation af Udskriftsserver Udskriftsserveren er afløseren for klientafvikleren og er implementeret som en javaservlet på OAS'en. Udskriftsserveren installeres automatisk af installationswizarden. 14.01.2008 A114.7536.3 Side 16 af 22

4.9 Rettigheder til udskrifts-katalog Den bruger som OAS en køres som er "Log on As" brugeren for servicen Oracle- FRHomeProcessManager (se sidst i afsnit 4.1), skal have tildelt rettigheder til udskriftskataloget hvor pdf- og flettefiler dannes for Easy Oracle-brugeren. Derfor tildeles fulde rettigheder til alle kataloger defineret i Stinavn-feltet på vinduet A555 (Se afsnit 5.2). Eksempel på katalog-rettigheder: Installeres af systemadministratoren 14.01.2008 A114.7536.3 Side 17 af 22

5. Database server (EASY-A opsætning) Følgende afsnit kan først gennemføres efter EASY-A version 08.1 er installeret. 5.1 EASY UdskriftsServer For at Jobafvikleren (på Databaseserveren) kan kalde Udskriftsserveren (på Application Serveren. se afsnit 1) i EXE, REPW og SQL trin, skal jobbet være bestilt til en rigtig UdskriftsServer (og ikke en gammel klientafvikler). Udskriftsserveren skal være oprettet i A107. A107 vil også vise alle gamle klientafviklere. Det anbefales at disse fjernes og der som udgangspunkt kun er en UdskriftsServer oprettet. Alternativt kan man genbruge/omdøbe og opdatere en gammel central klientafvikler. Herved kan man spare tilknytningen til brugerne i afsnit 5.2, hvis brugere havde tilknyttet den gamle klientafvikler tidligere. Felterne beskrives herunder: UdskriftsServer: Beskrivelse: URL: ReportsServer: Printer Betegnelse som identificere UdskriftsServeren Tekstuel beskrivelse URL til ApplicationServeren (Denne URL sammensættes med værdien i Trimmevariablen UdskriftsServer sti så jobafvikleren kan kalde Udskriftsserveren). Se nedenståened skærmdump for trimmeværdien. I dette eksempel dannes kaldet som: http://tier.wmdata.dk/easy- A/udskriftsserver. Her angives EASY-A_REPSRV, som er OracleReports Server programmellet på ApplicationServeren. Se afsnit 4.4 Her tilknyttes de printer som UdskriftsServeren kan benytte. 14.01.2008 A114.7536.3 Side 18 af 22

Installeres af systemadministratoren 14.01.2008 A114.7536.3 Side 19 af 22

5.2 EASY Oracle brugere Alle brugere skal have ændret deres default UdskriftsServer fra en gammel klientafvikler til den nye UdskriftsServer og Printeren skal være tilgængelig på Udskriftsserveren. Endelig skal Stinavn sættes til et personligt katalog på Applicationserveren eller på et andet netværksdrev. Det anbefales at der er et katalog for hver bruger, for ikke at al output blandes sammen. Det er også her at man pr. bruger angiver om der pr. default er markeret Print udskrift på A104 Jobbestilling (Markering kan naturligvis ændres på bestillingstidspunktet). Dette gøres ved at markere Print udskrift. Opsættes af systemadministratoren. 14.01.2008 A114.7536.3 Side 20 af 22

5.3 REPW-jobtrin Job trin med typen REPW og kommando: <modulnr>, vil blive afviklet af ReportsServeren. Bemærk at der ikke længere angives sti foran modulnr i jobdefinitionen, men Reportsmodulerne skal ligge i \reports\, som implicit sti. Jobafvikleren kalder Udskriftsserveren. REPW-typen afgør at Udskriftsserveren fordeler opgaven til ReportsServeren, som afvikler trinnet. EASY-A 08.1 stiller nu krav til at REPW-filer findes i EASY s reports katalog (eller underkataloger), så hvis skolen har lokale Reports udskrifter skal de placeres i Reports kataloget /reports eller et underkatalog. Ingen installation 5.4 EXEC-jobtrin Job trin med typen EXEC og kommando: bin\apsprint params, vil blive afviklet af APS-printprogrammet. Jobafvikleren kalder Udskriftsserveren. EXEC-typen afgør at Udskriftsserveren fordeler opgaven til APS print-programmet (angivet i kommandoen), som afvikler trinnet. Eksempel på EASY-A APS-kommando: bin\apsprint -u #p_ora_user -p #p_ora_pass -c #p_ora_db -j #p_bejo_id -v #p_preview -k #p_copy Man vil også kunne kalde 3-parts EXE-udskrifter, da Udskriftsserveren blot kalder det program, som er angivet i jobdefinitionen. Ingen installation 5.5 SQL-jobtrin Job trin med typen SQL og kommando: <modulnr>.sql, vil blive afviklet af SQL-plus. Jobafvikleren kalder Udskriftsserveren. SQL-typen afgør at Udskriftsserveren fordeler opgaven til SQL-plus, som afvikler trinnet. Til disse udskrifter benyttes blot SQL-plus til afvikling af SQL-trinnet. SQL-plus er en del af ApplicationServerens Oracle installation, og kan kaldes og afvikles umiddelbart. Ingen installation 14.01.2008 A114.7536.3 Side 21 af 22

6. Tjekliste til systemadministratorer 6.1 PC-Klienter Installation af PDF Reader (Kan gøres i god tid) Browseropsætning (Gøres umiddelbart før EASY-A 08.1 installationen) 6.2 ApplicationServer Installation af OAS (Kan gøres i god tid. Evt af Oracle leverandør) Manuel opsætning efter installation af OAS (Kan gøres i god tid) Opsætning af Sqlnet (Kan gøres i god tid, men tjekkes også efter at Oracle 10g basen er klar til drift) Opsætning af Reportsserver (Kan gøres i god tid) Installation af Oracle 10g release 2 Client software (Kan gøres i god tid) Installation af PDFCreator og opsætning (Kan gøres i god tid) Opsætning af rettigheder (Kan gøres i god tid) 6.3 DatabaseServer Oracle 10g DB (Kan gøres i god tid. Evt af Oracle leverandør) Oprettelse af EASY Udskriftsserver (Efter import og EASY 08.1 installation) Tilknytning af ny Udskriftsserver til brugerne. (Efter import og EASY 08.1 installation) 7. Referencer Dok. [Inst10g] Titel "Installation af Application Server 10g miljø til EASY-A" på Admsys-webben af Egon Nør. http://www.admsys.uni-c.dk/easy-a/ dokumenter/systemadministration/ Installation/10g_oas_ver_1.doc 14.01.2008 A114.7536.3 Side 22 af 22