Installatie handleiding reporttool

INSTALLATIE HANDLEIDING
IMTECH REPORT TOOL
© Imtech ICT Application Solutions
Zaltbommel, 2014
Imtech Report Tool™
Inhoudsopgave
Inhoudsopgave .........................................................................................................................................2
Downloaden ZIP file .................................................................................................................................3
Eerste installatie of upgrade? ...................................................................................................................4
Controle/voorbereiding configuratie WAS Server ....................................................................................5
1. Installatie Reporttool. ............................................................................................................................7
1.1 Parameter toevoegen. .......................................................................................... 7
1.2 Installeren reporttool op WAS server..................................................................... 8
1.3 Installatie vanuit de reporttool ............................................................................... 8
1.4 Starten van het reporttool.....................................................................................10
1.5 Testen van een rapport ........................................................................................10
2 Scheduling specifieke instellingen .......................................................................................................12
2.1 aanmaken map op IFS .........................................................................................12
2.2 locatie map toevoegen aan http-server ................................................................12
2.3 Alias toevoegen voor reporttool map. ...................................................................13
2.4 Herstarten HTTP server en aanpassen toegang ..................................................14
2.5 Toevoegen parameters ........................................................................................16
2.6 installatie van de JAR files ...................................................................................17
2.7 Job scheduler entry..............................................................................................17
2.8 Opvragen uitgevoerde rapporten .........................................................................18
3 Journaling van de SQL bestanden ......................................................................................................19
© Imtech ICT Application Solutions
Blz.2 van 19
Imtech Report Tool™
Downloaden ZIP file
Ga naar files.eniac.nl en kies voor Imtech Report tool
Van daaruit kan de reporttool.zip worden gedownload.
De ZIP file die gedownload wordt bevat de volgende inhoud:
© Imtech ICT Application Solutions
Blz.3 van 19
Imtech Report Tool™
Hieronder volgt een korte toelichting van de componenten:







EAR files voor het Business Application Framework (noodzakelijk voor het aanloggen
aan de Iseries):
o eu.imtech.egl.baf.ws.wasutilEAR.ear
o eu.imtech.egl.baf.ws.jt400EAR.ear
De map BirtReportEngine met de files voor de batch/scheduling functie van het
reporttool
De noodzakelijke jar files voor het uitvoeren van de report scheduling:
o fda7.jar
o jt400.jar
o mail.jar
o ReportScheduler.jar
De WAR file birt422.war met de (online) BIRT Report Viewer
EAR files voor de webapplicatie van het reporttool
o eu.imtech.egl.reporttool.app85EAR.ear
o eu.imtech.egl.reporttool.app.ws.dataEAR.ear
Installatiehandleiding
Save File REPORTTOOL.SAVF met de source voor uitvoeren scheduled reports
vanuit de Iseries Job Scheduler.
Eerste installatie of upgrade?
Als er sprake is van een upgrade kan direct gestart worden met de installatie van de EAR
files. Ga dan naar paragraaf 1.2.
Is dit de eerste installatie van het reporttool dan dienen onderstaande stappen uitgevoerd te
worden.
© Imtech ICT Application Solutions
Blz.4 van 19
Imtech Report Tool™
Controle/voorbereiding configuratie WAS Server
1. De volgende websphere variabelen dienen op de WAS server geconfigureerd te zijn op
het niveau van node, server:
 BAF_SERVER: deze verwijst naar de machine waarop de business application
server draait. Normaal is dit dezelfde machine als waarop het reporttool geinstalleerd
wordt.
 OS400_TOOLBOX_JDBC_DRIVER_PATH: dit is de verwijzing naar de IFS map
waar de jt400.jar staat. Standaard is dit /qibm/ProdData/HTTP/Public/jt400/lib
2. De websphere JDBC provider dient ingericht te zijn op DB2 UDB for Iseries (Toolbox).
3. De BAF server dient geïnstalleerd te zijn op de WAS server.
Dit betreft de volgende EAR files: eu.imtech.egl.baf.ws.wasutilEAR.ear en
eu.imtech.egl.baf.ws.jt400EAR.ear.
© Imtech ICT Application Solutions
Blz.5 van 19
Imtech Report Tool™
Indien deze nog niet geïnstalleerd zijn kunnen hiervoor de meegeleverde EAR files
gebruikt worden.
4. De JAVA versie op de ISeries dient minimaal versie 1.6 te zijn.
Dit kan gecontroleerd worden door vanuit een commandoregel QSH in te tikken.
Vervolgens in de qshell het commando java –version
5. De meegeleverde versie van de BIRT Viewer dient geïnstalleerd te zijn op de WAS
server. Mocht dit nog niet het geval zijn dan dient deze eerst geïnstalleerd te worden.
De handleiding daarvoor zit in de gedownloade ZIP file.
Op dit moment is versie 4_2_2 van de BIRT viewer actueel.
Herstart de server na de installatie van de BIRT viewer.
© Imtech ICT Application Solutions
Blz.6 van 19
Imtech Report Tool™
1. Installatie Reporttool.
Een aantal onderdelen dienen geïnstalleerd te worden op de WAS server.
 eu.imtech.egl.reporttool.app.ws.dataEAR.ear
 eu.imtech.egl.reporttool.app85EAR.ear
 Eclipse BIRT Report Viewer
Echter voordat dit gedaan kan worden zullen aanvullende acties uitgevoerd moeten worden.
1.1 Parameter toevoegen.
Er dient een parameter aangemaakt te worden op de WAS server welke de schema naam
van de reporttool database beschrijft. Dit kan gedaan worden via de Beheerconsole. De
beheerconsole kan gestart worden via de linkermenu optie “Beheerconsole starten” in de
httpAdmin console.
Via het menu “Environment” -> “Websphere variables” kan een variabele toegevoegd
worden.
Kies voor de scope op node, server niveau.
© Imtech ICT Application Solutions
Blz.7 van 19
Imtech Report Tool™
Kies daar voor de optie “new” en vul de volgende gegevens in:
Het Value waar hierboven “REPORTTOOL” staat kan zelf gekozen worden. Dit zal de library
worden waarin de SQL database van de reporttool aangemaakt zal worden.
Herstarten van de WAS server
Nadat de parameter is toegevoegd dient de WAS server opnieuw opgestart te worden om
deze actief te maken.
1.2 Installeren reporttool op WAS server
Nadat de library toegevoegd is aan het systeem kunnen de EAR files geïnstalleerd worden.
Zowel de “eu.imtech.egl.reporttool.app.ws.dataEAR.ear” als de
“eu.imtech.egl.reporttool.app85EAR.ear” dienen geïnstalleerd te worden via de httpAdmin
console.
Copier hiervoor de betreffende EAR files vanuit de gedownloade ZIP file naar de installable
apps map van de WAS server.
Hieronder staat een voorbeeld van de lokatie van de installable Apps map voor een server
versie 7 van de WAS server ENIACBS70.
\\10.20.30.5\qibm\UserData\WebSphere\AppServer\V7\Express\profiles\ENIACBS70\installa
bleApps
1.3 Installatie vanuit de reporttool
Nadat de ears draaien op het systeem kan de installatie opgestart worden vanuit de
reporttool. Via deze installatie zal de SQL database aangemaakt worden en tevens een
eerste beheergebruiker waar na creatie mee ingelogd kan worden.
© Imtech ICT Application Solutions
Blz.8 van 19
Imtech Report Tool™
Om de installatie te starten dient de AdminHandler opgestart te worden. Dit kan via een URL
in de browser. Type als eerste het adres van de server in gevolgd door een dubbele punt.
Vervolgens de poort waarop de WAS server te benaderen is gevolgd door:
/reporttool/AdminHandler-nl_NL.html.
De totale url ziet er als volgt uit: SERVER:poort//reporttool/AdminHandler-nl_NL.html
Bijvoorbeeld http://eniac02.eniac.nl:10086/reporttool/AdminHandler-nl_NL.html
De poort van de WAS server kan opgezocht worden door via het HTTP admin console naar
serverpoorten te gaan. Zie onderstaande screenshot. Neem de poort van de http server. In
onderstaande voorbeeld dus 10086.
Hierdoor zal volgend scherm verschijnen:
© Imtech ICT Application Solutions
Blz.9 van 19
Imtech Report Tool™
NB: oude versies van internet explorer hebben het probleem dat het gebruikersveld niet
goed wordt getoond. Het verdient dan aanbeveling op een versie van de explorer 9 of hoger
over te stappen. Daarnaast is firefox een alternatief.
Er kan ingelogd worden met een AS400 gebruikersnaam en wachtwoord. Voor deze
gebruiker zal een beheer account aangemaakt worden binnen de reporttool. Na inloggen
verschijnt het volgende scherm:
Via de button “Start Analyse” kan een analyse gestart worden om de juiste library op te halen
en om te kijken of en zo ja welke versie van de reporttool geïnstalleerd moet worden.
Aan de hand van de analyse zal wel of niet een button verschijnen waarmee de installatie
gestart kan worden. Sluit na klikken van deze button de browser niet af! Na het valtooien van
de installatie zal dit gemeld worden via een pop up window. Indien de installatie niet voltooid
kan worden zal bij de “installatie/Update output” de oorzaak hiervan vermeld worden. Bij een
geslaagde installatie zullen hier de uitgevoerde acties getoond worden.
1.4 Starten van het reporttool
Als de installatie succesvol is uitgevoerd kan via de volgende URL de applicatie gestart
worden:
http://eniac02.eniac.nl:10086/reporttool/MainHandler-nl_NL.html
Hierbij dient uiteraard het IP adres en de poort gebruikt te worden van de eigen websphere
server waarop de applicatie is geinstalleerd.
1.5 Testen van een rapport
Om te kunnen testen of het reporttool werkt wordt het testrapport birttest.rptdesign mee
uitgeleverd.
Dit kan rapport worden ingericht in het reporttool als rapport via de widget beheer rapporten.
Daarnaast dient een omgeving aangemaakt te worden. (ook als die niet in het rapport wordt
gebruikt is het verplicht minimaal 1 omgeving aan te maken en te selecteren bij de aanroep
van het rapport).
Zie voor de toelichting op de inrichting de meegeleverde gebruikershandleiding van het
reporttool.
De directory waar de rapportdefinities staan kan ingericht worden in de parameters van het
reporttool. Dit moet een subdirectory zijn van /usr/reports. Bijvoorbeeld: parameterwaarde is
gevuld met reporttool. Dan moet de directory /usr/reports/reporttool worden aangemaakt en
daar dienen de rapport bestanden dan neergezet te worden.
© Imtech ICT Application Solutions
Blz.10 van 19
Imtech Report Tool™
De bestanden birttest.rptdesign en birttest.rptconfig dienen gekopieerd te worden naar die
betreffende directory. Standaard is dit /usr/reports/reporttool.
Het starten van het rapport kan vanuit de widget mijn rapporten.
Als u geen gebruik gaat maken van de scheduling functionaliteiten is hiermee de installatie
van het reporttool voltooid.
© Imtech ICT Application Solutions
Blz.11 van 19
Imtech Report Tool™
2 Scheduling specifieke instellingen
Om de scheduling functionaliteit toe te voegen aan de reporttool zijn extra instellingen en
componenten nodig.
Onderstaande stappen dienen dus alleen uitgevoerd te worden indien gebruik gemaakt gaat
worden van de scheduling en mail functionaliteit binnen de reporttool.
2.1 aanmaken map op IFS
Op het IFS dient een map aangemaakt te worden waarin de rapporten die gedraaid worden
tijdelijk worden opgeslagen.
Deze map moet aangemaakt worden op het niveau waarin zich ook de map “installableApps”
bevind waarin de Ears van de reporttool staan. De map kan een naam naar keuze krijgen.
Voorkeur is naam /reporttoolBestanden.
2.2 locatie map toevoegen aan http-server
Via de HTTPAdmin moet de map toegevoegd worden aan de http-server.
Ga via de HTTPAdmin console naar de http-server behorende bij de toepassingsserver
waarop de reporttool is geïnstalleerd.
-
Via het linkermenu dient naar ‘servereigenschappen’ -> ‘Containerbeheer’
genavigeerd te worden.
-
Bij het tabblad “directory” dient een nieuwe directory toegevoegd te worden. Het
directory pad dient het volledige pad te zijn gezien vanuit de root van de server.
© Imtech ICT Application Solutions
Blz.12 van 19
Imtech Report Tool™
2.3 Alias toevoegen voor reporttool map.
Naast de map zelf dient ook een alias aangemaakt te worden om documenten in deze map
te kunnen open
-
Via het linkermenu dient naar ‘servereigenschappen’ -> ‘URL-toewijzing’ genavigeerd
te worden.
-
In het tabblad Aliassen dient een nieuwe allias aangemaakt te worden. Als URL pad
kan een naam naar keuze ingevoerd te worden vooraf gegaan door een /
Bij host directory dient de directory ingevoerd te worden die bij 2.2 als directory is
ingevoerd.
-
© Imtech ICT Application Solutions
Blz.13 van 19
Imtech Report Tool™
2.4 Herstarten HTTP server en aanpassen toegang
Nadat zowel de directory als de alias is aangemaakt dient de http server herstart te worden.
Om te testen of de Alias werkt kan een bestand in de aangemaakte IFS map gezet worden.
Deze zou dan via servernaam:httppoort/aliasnaam/naambestand te benaderen moeten zijn
vanuit de browser.
Het bestand imtech.png is in de ZIP file meegeleverd om als test hiervoor te kunnen
gebruiken.
Hierbij is de httppoort gelijk aan de poort van de http server.
Om te bepalen welke poort gebruikt moet worden ga je naar het beheer console.
Via het linker menu de optie servers, server type, webservers kiezen.
Vervolgens de server aanklikken en dan wordt de poort getoond die gebruikt dient te worden.
Het opstarten van de reporttool gaat dan dus bijvoorbeeld via:
http://eniac02.eniac.nl:10005/reporttool/MainHandler-nl_NL.html
© Imtech ICT Application Solutions
Blz.14 van 19
Imtech Report Tool™
Indien er nog geen toegang is tot de map dient de volgende aanpassing aan de
toegangsbesturing gedaan te worden:
NB: zorg dat het servergebied in de balk bovenaan op de aangemaakte directory staat.
-
Navigeer daarna in het linker menu naar beveiliging
-
Navigeer hier vervolgens naar het tabblad “toegang besturen”
Zet hier de “toegangsbesturing op basis van herkomst aanvraag: “ op “iedereen
toegang toestaan, behalve de volgende: “
© Imtech ICT Application Solutions
Blz.15 van 19
Imtech Report Tool™
Mocht het na deze aanpassing niet werken dan is het advies om de alias uit paragraaf 2.3 op
de ROOT map te maken. (dit heeft niet de voorkeur maar blijkt in sommige gevallen de enige
mogelijkheid om de autorisatie te regelen).
2.5 Toevoegen parameters
Voor de werking van de scheduling zijn extra parameters noodzakelijk. Deze parameters zijn
te vinden in de widget “Parameters”. De volgende parameters dienen ingevuld te worden.
ID
MAILSERVER
MAILPORT
DIRCRTRPT
ALIAS
© Imtech ICT Application Solutions
Waarde nodig
Hier dient de URL van de mail server ingevoerd te worden.
Bijvoorbeeld: 10.20.30.5
Hier dient de poort van de mailserver ingevoerd te worden
Bijvoorbeeld: 25
Dit is de naam van de map op het IFS waarin de rapport
gezet worden. De map wordt vooraf gegaan door een /
Bijvoorbeeld: /reporttoolBestanden
Hier wordt de naam van de alias neergezet die verwijst
naar de map welke beschreven wordt door parameter
DIRCRTRPT
Bijvoorbeeld: rpt
Blz.16 van 19
Imtech Report Tool™
2.6 installatie van de JAR files
De volgende 4 JAR bestanden uit de ZIP file dienen naar een map op het IFS van de Iseries
gezet te worden:
 fda7.jar
 jt400.jar
 mail.jar
 ReportScheduler.jar
Bij voorkeur in /Imake/reporttool.
Daarnaast dient de map /BirtReportEngine422 uit de ZIP file gerestored te worden op de
ROOT van het IFS.
2.7 Job scheduler entry
Voor het schedulen van de rapporten dient een entry in de jobscheduler aangemaakt te
worden. Afhankelijk van de wensen kan meerder keren per dag een entry in de jobscheduler
aangeroepen worden.
Alle rapporten die qua planning aan de beurt zijn vanaf de vorige run zullen uitgevoerd
worden.
In de meegeleverde source file REPORTTOOL.SAVF zit een voorbeeld source van een
JAVA call vanuit de jobscheduler. Deze dient naar de eigen inrichting aangepast te worden.
De user en wachtwoord dienen ingevuld te worden en vervolgens dient de CL gecompileerd
te worden en het object in de bibliotheek van het reporttool gezet te worden.
De directory waar de JAR files uit de vorige paragraaf zijn neergezet, en de bibliotheek
waarin het reporttool is geïnstalleerd, dienen als parameter vanuit de jobscheduler
doorgegeven te worden.
© Imtech ICT Application Solutions
Blz.17 van 19
Imtech Report Tool™
/*
PGM
PARM(&JAVADIR &FILELIB)
DCL
DCL
DCL
DCL
DCL
DCL
VAR(&JAVADIR) TYPE(*CHAR) LEN(25)
/* '/Imake/reporttool' */
VAR(&DIR) TYPE(*CHAR) LEN(25) VALUE(*BLANKS)
VAR(&FILELIB) TYPE(*CHAR) LEN(10)
/* REPORTTOOL */
VAR(&LIB) TYPE(*CHAR) LEN(11) VALUE(*BLANKS)
VAR(&USR) TYPE(*CHAR) LEN(10) VALUE('user')
VAR(&PWD) TYPE(*CHAR) LEN(10) VALUE('password')
CHGVAR
CHGVAR
VAR(&DIR) VALUE(&JAVADIR)
VAR(&LIB) VALUE(&FILELIB *TCAT '.')
CD
DIR(&DIR)
SET JAVA CLASS PATH
JAVA
/*
*/
+
CHGVAR
CHGVAR
CLASS('eu.imtech.egl.reporttool.programs.Re+
portScheduler') PARM(&LIB &USR &PWD) +
VAR(&DIR) VALUE(&JAVADIR)
VAR(&LIB) VALUE(&FILELIB *TCAT '.')
CD
DIR(&DIR)
SET JAVA CLASS PATH
JAVA
*/
+
CLASS('eu.imtech.egl.reporttool.programs.Re+
portScheduler') PARM(&LIB &USR &PWD) +
CLASSPATH('ReportScheduler.jar:fda7.jar:jt4+
00.jar:mail.jar:/BirtReportEngine422/lib/*') +
CHKPATH(*IGNORE) OPTIMIZE(20) OUTPUT(*PRINT)
ENDPGM
2.8 Opvragen uitgevoerde rapporten
De rapporten die via de scheduling zijn uitgevoerd worden opgeslagen als BLOB in SQL
bestanden.
Als hiervan gebruik wordt gemaakt dient het starten van het reporttool via een andere poort
te gebeuren om de rapporten op te kunnen vragen.
Dit is dezelfde poort als in paragraaf 2.4 is gebruikt!
© Imtech ICT Application Solutions
Blz.18 van 19
Imtech Report Tool™
3 Journaling van de SQL bestanden
Aangezien het reporttool gebruik maakt van SQL bestanden wordt default de journaling
geactiveerd.
Hiervoor maakt het systeem standaard journal QSQJRN aan in de reporttool library.
Om te voorkomen dat de journals onnodig lang worden bewaard dient het aangemaakte
journal via het CHGJRN commando op DLTRCV *YES gezet te worden.
Dan worden automatisch de journals verwijderd zodra ze zijn gesaved.
Journaal wijzigen (CHGJRN)
Typ waarden en druk op Enter.
Journaal . . . . . . . . . . . . JRN
Biblioth. . . . . . . . . . .
Journaalontvanger:
JRNRCV
Journaalontvanger . . . . . .
Biblioth. . . . . . . . . .
Journaalontvanger . . . . . .
Biblioth. . . . . . . . . .
Volgnummeroptie . . . . . . . . SEQOPT
Journaal-berichtenwachtrij . . . MSGQ
Biblioth. . . . . . . . . . .
Journaalontvangers beheren . . . MNGRCV
Journaalontvangers wissen . . . DLTRCV
Opties voor grootte ontvanger . RCVSIZOPT
+ voor meer waarden
Journaalstatus . . . . . . . . . JRNSTATE
© Imtech ICT Application Solutions
> QSQJRN
>
YAMS
*SAME
*CONT
QSYSOPR
*LIBL
*SYSTEM
*YES
*RMVINTENT
*MAXOPT2
*SAME
Blz.19 van 19

Download Report