Installatie op de server(s)

Laatst bijgewerkt op
Als PDF opslaan

Bij installatie van Getdown op de server(s) zijn er een aantal zaken waar rekening mee gehouden moet worden.

Minimale eisen

Getdown wordt sinds november 2015 automatisch meegeleverd met Wise in het pakket bxmbng-webstart. De server inrichting wordt op aanvraag gratis uitgevoerd door OCLC.

Gebruikte paden

Er wordt een aantal paden gebruikt:

/etc/bwise/bxmbng-webstart
Hier staan de configuratiebestanden van Getdown.
Deze staan dus naast de huidige bestanden waarmee de jnlp wordt gegenereerd.

/home/hka/bxmbng-webstart/docroot/getdown
Hier staat de installatie van Getdown.

/home/hka/bxmbng-webstart/BNG/ui/
Hier staan de iconen en graphics voor de installer.
Deze worden overschreven/aangevuld door de RPM!

/home/hka/bxmbng-webstart/BNG/util/
Hier staat het script bxm_gd_gen.pl, waarmee de configuratiebestanden worden omgezet naar een Getdown installatie. Zie

Fout! Verwijzingsbron niet gevonden. QQQQQ

Werking configuratiebestanden

Het installatiescript baseert zich op .txt-bestanden in /etc/bwise/bxmbng-webstart. Bij het bouwen van een getdown installatie zal het eerst zoeken naar een bestand met de naam getdown.txt. Alle sleutels die daar in voorkomen zijn default voor deze server. Daarna worden alle overige .txt-bestanden onderzocht. Het is dus van belang dat er geen extra .txt-bestanden staan in de directory /etc/bwise/bxmbng-webstart, omdat hierdoor extra Getdown installaties ontstaan.

Bij ieder .txt bestand worden alle sleutels uit getdown.txt ingelezen, en worden de sleutels uit het onderhanden .txt-bestand er overheen gezet. Hierbij wordt een uitzondering gemaakt voor sleutels die beginnen met jnlp. Deze worden allemaal overgenomen.

Voorbeeld:

getdown.txt:
BICATURL = http://bicatdb.domein.nl:2345/bxmas
GETDOWNURL = http://bicat.domein.nl/getdown
jnlp.fullscreen=1
jnlp.kaarturl=http://bicat.domein.nl/cgi-bin/bx.pl

productie.txt:
BICATURL = http://10.10.10.10:2345/bxmas
MAP=productie
jnlp.id_method=DOMAIN_CLIENT

Resultaat:
BICATURL = http://10.10.10.10:2345/bxmas
GETDOWNURL = http://bicat.domein.nl/getdown
MAP=productie
jnlp.fullscreen=1
jnlp.kaarturl=http://bicat.domein.nl/cgi-bin/bx.pl
jnlp.id_method=DOMAIN_CLIENT

Bij een standaard installatie staan op de OCLC Wise webserver de volgende bestanden:
getdown.txt
productie.txt
secure.txt
hka.txt

… en op de OCLC Wise testserver:
getdown.txt
test.txt
hka.txt

getdown.txt bevat dan steeds de serverspecifieke instellingen. hka.txt wordt gebruikt door OCLC om de client te starten. Gelieve deze niet te wijzigen. De overige .txt bestanden hebben bij voorkeur een unieke naam over alle servers heen. In elk geval moet iedere MAP= configuratie uniek zijn. Anders bestaat het risico dat twee clients elkaar overschrijven.

Mogelijke sleutels in de configuratiebestanden

GETDOWNURL	Waar staat de installatie van Getdown Vb: GETDOWNURL=http://bicat.domein.nl/getdown/
BICATURL	Waar is BXMAS bereikbaar voor deze client Vb: BICATURL=http://wisedb.domein.nl/bxmas/
ORGANISATIE	Naam van de organisatie
OMSCHRIJVING	Naam van de client Vb: OMSCHRIJVING=Client TEST
MAP	Map waarin de getdown installatie wordt geplaatst. Dit is de basismap voor de client-installatie. Op de server is dit relatief t.o.v. /home/hka/bxmbng-webstart/docroot/getdown Op de PC is dit een submap van de installatiedirectory. Vb: MAP=productie
LIBDIR	Geef een afwijkende libdir op, waar de OCLC Wise-software staat. Dit is relatief t.o.v. /home/hka/bxmbng-webstart/docroot/ LET OP: omdat deze libdir niet bijgewerkt wordt via de RPM, ontraden we het gebruik van LIBDIR. Het gebruik van deze optie wordt ontraden! Vb: LIBDIR=lib632
jnlp.id_method	Methode waarmee de client zijn naam doorgeeft aan de server Mogelijk waarden: DOMAIN_COMPUTER, DOMAIN_CLIENT, COMPUTER, CLIENT, DOMAIN_USER, USER Vb: jnlp.id_method=CLIENT
jnlp.work.dir	Cache-pad voor client - in plaats van getdown dir \| c:\bng \| User profile Vb: jnlp.work.dir=H:/bng
jnlp.kaarturl	URL voor printen van kaarten (theaterWise/ticketWise), tonen van covers in de bestelmodule en tonen van de titel in de webcat (de Wisecat+) Vb: jnlp.kaarturl=http://bicat.domein.nl/cgi-bin/bx.pl
jnlp.birturl	URL voor birt voor clients op extern/alternatief netwerk Vb: jnlp.birturl=http://birt.domein.nl/birt/run?__report=rapport/
jnlp.ws_export.url	URL voor downloaden van export (CSV) bestanden Vb: jnlp.ws_export.url=http://wisedb.domein.nl/divexport
jnlp.autologin	Onderdruk het automatisch inloggen in OCLC Wise Vb: jnlp.autologin=false
jnlp.repair_isils	Lijst van isil-codes waarvan RFID tags gerepareerd mogen worden door deze client Vb: jnlp.repair_isils=7006\|7007
jnlp.startfunc.ignore	Onderdruk de ingestelde automatische opstartfunctie Vb: jnlp.startfunc.ignore=true
jnlp.trust_server_cert	Sta het gebruik van self-signed certificates toe bij toegang over https Vb: jnlp.trust_server_cert=true
jnlp.locale.default	De client kan op termijn allerlei land/taalkodes aan, zogenaamde Locale coderingen. Bijvoorbeeld nl_NL of en_US of en_GB. Hier kan worden opgenomen: jnlp.locale.default=xx_XX (hier 1 Locale vastleggen)
jnlp.locales.supported	Moeten er meerdere Locales ondersteund worden dan kunnen die hier worden opgegeven: jnlp.locales.supported=xx_XX;yy_YY;zz_ZZ (kommagescheiden set opgeven). Onder werkplekbeheer zal in dat geval een taalkeuze verschijnen.

Inhoud Getdown-map

ini/	In deze map staan .ini-files die gebruikt worden door de Windows installer. De .ini-bestanden moeten met de hand geplaatst worden.
ui/	een symbolic link naar de UI directory met iconen en graphics. Deze wordt door de RPM aangemaakt.
getdown-x.y.jar	De daadwerkelijke Getdown software Deze wordt door de RPM geplaatst
getdown.jar	Een symbolic link naar de Getdown jar file. Deze wordt door de RPM aangemaakt.
install.txt	De clients die getoond mogen worden in de Windows installer. Hierin steeds verwijzingen naar een .ini file uit de /ini map Vb: productie=Productieomgeving
jrex.x.x_x.zip	ZIP-file met de te gebruiken Java versie. Deze kan opgehaald worden van http://www.bicat.com/getdown/ Gebruik de instructies die daar staan om het bestand op te halen en de bijbehorende .ini te maken
java.ini	Verwijzing naar de te gebruiken Java versie. [main] sourcefile=jrex.x.x_x.zip

Inhoud Getdown client map

Er is een map voor iedere Getdown installatie die op deze server bestaat. De mappen corresponderen met de MAP= regels in de .txt bestanden in /etc/bwise/bxmbng-webstart. Dus MAP=productie zorgt dat er een map productie wordt aangemaakt. Pas de bestanden in deze mappen niet aan, ze worden door Getdown gebouwd, en er is een checksum van berekend. In de map productie zouden nu de volgende bestanden moeten staan:

getdown.txt	De beschrijving van alle te downloaden bestanden en alle aanwijzingen die Getdown nodig heeft om een client te starten. De inhoud wordt bepaald door de .txt-bestanden in /etc/bwise/bxmbng-webstart
digest.txt	Bestand met checksums van alle te downloaden bestanden
productie.ini	Voorbeeld .ini bestand wat geplaatst kan worden in de ini-map
lib/	Snelkoppeling naar de centrale map met OCLC Wise software, of naar de afwijkende libmap indien de sleutel LIBDIR is gebruikt
ui/	Snelkoppeling naar de centrale map met graphics

Inhoud .ini-bestanden

In de .ini-bestanden kunnen verschillende sleutels gebruikt worden. De eerste regel moet altijd bestaan uit [main].

name	Alleen ter documentatie
folder	Map waarin de bestanden geplaatst moeten worden
url	URL waar getdown.txt voor deze client gevonden kan worden
login_allowed	Wordt de vraag gesteld voor een extra icoon met vrije inlog. Hiermee wordt de autologin van de client onderdrukt.
icon	Welk icoon moet er voor de snelkoppeling van deze client gebruikt worden? Momenteel is er keuze uit: icon_orange.ico (default voor productie) icon_green.ico (default voor test) icon_blue.ico (default voor acceptatie) icon_gray.ico icon_pink.ico icon_purple.ico icon_red.ico Als er geen keuze gemaakt wordt, dan wordt icon_orange.ico gebruikt.

Bijwerken Getdown-configuratie

Bij elke wijziging in de .txt-bestanden in /etc/bwise/bxmbng-webstart moet de configuratie worden bijgewerkt. Dit kan door de volgende commando's uit te voeren:

cd /etc/bwise/bxmbng-webstart

make

/home/hka/bxmbng-webstart/BNG/util/bxm_gd_gen.pl

Bij de installatie van de wise-bxmbng-webstart RPM wordt bxm_gd_gen.pl automatisch aangeroepen.