Installatie op de server(s)
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 |
/home/hka/bxmbng-webstart/docroot/getdown |
/home/hka/bxmbng-webstart/BNG/ui/ |
/home/hka/bxmbng-webstart/BNG/util/ |
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 |
BICATURL |
Waar is BXMAS bereikbaar voor deze client |
ORGANISATIE |
Naam van de organisatie |
OMSCHRIJVING |
Naam van de client |
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. Op de PC is dit een submap van de installatiedirectory. |
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. Vb: LIBDIR=lib632 |
jnlp.id_method |
Methode waarmee de client zijn naam doorgeeft aan de server |
jnlp.work.dir |
Cache-pad voor client - in plaats van 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.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). |
Inhoud Getdown-map
ini/ |
In deze map staan .ini-files die gebruikt worden door de Windows installer. |
ui/ |
een symbolic link naar de UI directory met iconen en graphics. |
getdown-x.y.jar |
De daadwerkelijke Getdown software |
getdown.jar |
Een symbolic link naar de Getdown jar file. |
install.txt |
De clients die getoond mogen worden in de Windows installer. Vb: productie=Productieomgeving |
jrex.x.x_x.zip |
ZIP-file met de te gebruiken Java versie. |
java.ini |
Verwijzing naar de te gebruiken Java versie. |
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:
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
OF
/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.