Installatie op de PC

Ophalen installatieprogramma voor Windows

OCLC levert voor elk OCLC Wise systeem een installatieprogramma voor Windows. Dit is te downloaden vanaf https://www.wise-nl.oclc.org/getdown/<organisatie>. Tijdens de installatie verneemt u wat voor uw systeem ingevuld moet worden op de plaats van <organisatie>.

Bij het ophalen van de URL zal de browser de executable starten of lokaal opslaan. Mocht bij het downloaden van de executable een waarschuwing verschijnen over het starten van programma's vanaf het Internet, gelieve dan op 'uitvoeren' te klikken.

Installatie

Bij het starten van het installatieprogramma wordt eerst een welkomstscherm getoond.
In de rechterbovenhoek is te zien of het programma voor het juiste systeem is opgestart:

De eerste vraag die vervolgens gesteld wordt, is in welke map de client geplaatst mag worden. Standaard is dit c:\bng. Dit moet in elk geval een map zijn waar de gebruiker schrijfrechten heeft. Deze map zal door Getdown gebruikt worden om de client in te downloaden. De client zal deze map ook gebruiken om de werkbestanden in op te slaan, tenzij in getdown.txt een property jnlp.work.dir wordt opgenomen, bijvoorbeeld jnlp.work.dir=H:/bng Dit heeft met Getdown alleen weinig zin, want dan was het verstandiger geweest om direct te kiezen voor de installatiemap H:\bng.

Als gekozen wordt voor een servermap, dan dient dit wel een lokale server te zijn. Anders moet de client steeds over een WAN-lijn naar de opslag, wat de performance erg negatief zal beïnvloeden.

Op het volgende scherm wordt gevraagd welke omgeving geïnstalleerd moet worden. Binnen het VPN van de bibliotheek zal dat meestal productie zijn, buiten de bibliotheek (scholen, servicepunten etc.) zal dat secure zijn. De omschrijvingen die hier worden getoond komen uit install.txt op de OCLC Wise webserver. De gekozen naam (productie, secure) moet corresponderen met een .ini-file in de map getdown/ini van de OCLC Wise webserver.

Het is ook mogelijk hier extra .ini-bestanden te plaatsen, en die niet op te nemen in install.txt. Het is dan mogelijk de naam (zonder .ini) in te typen bij server. Zo kunnen dus clients geïnstalleerd worden voor de test- en acceptatie servers zonder dat iedere medewerker dit standaard aangeboden krijgt.

In onderstaand voorbeeld wordt dus op de server gezocht naar ini/proef.ini:
In het volgende scherm kan worden opgegeven in welke map van het startmenu de snelkoppeling gemaakt mag worden. De installatie begint nu, en afhankelijk van de downloadsnelheid kan dit enkele minuten duren. Nu wordt namelijk de eigen Java-versie van de server opgehaald. Afhankelijk van de instelling login_allowed in de gekozen .ini-file kan er nu nog een vraag volgen:

Wordt hier 'Ja' gekozen, dan wordt er een tweede icoontje gemaakt.

Als dit gestart wordt, dan wordt de autologin functie van de client overgeslagen.

De installer voert de volgende acties uit:

• Aanmaken van de map die is opgegeven (installatiemap)
• Ophalen van <omgeving>.ini
• Aanmaken van de map die in <omgeving>.ini is opgegeven binnen de installatiemap
• Aanmaken getdown.txt
• Ophalen getdown.jar, iconen en grafische bestanden
• Ophalen java.ini
• Eventueel ophalen nieuwe java-versie
• Eventueel nieuwe java-versie plaatsen
• Aanmaken java-class file
• Aanmaken snelkoppeling(en) op het bureaublad

De installers worden automatisch ondertekend als zijnde afkomstig van 'Huijsmans & Kuijpers' / OCLC.

Bijwerken van Java

De installer zal altijd eerst java.ini ophalen van de OCLC Wise webserver. Dan wordt deze vergeleken met de eventueel lokaal aanwezige versie van java.ini. Als er nog geen java.ini is in de installatiemap, of er is een versieverschil, dan wordt de zip-file die in java.ini staat opgehaald. Nu wordt geprobeerd <installatiemap>/java_vm/bin/javaw.exe te verwijderen.

Mislukt dat, dan wordt de installatie afgebroken.

As het verwijderen wel lukt, dan wordt de nieuwe javaversie geplaatst. Als deze fout wordt getoond, dan is er vermoedelijk een client gestart die Java in gebruik houdt. Deze moet eerst gesloten worden. Vervolgens kan de installatie opnieuw worden gestart. De eerder opgehaalde .zip-file met Java wordt dan hergebruikt, dus de installatie zal aanzienlijk sneller zijn. Het is ook mogelijk om zelf de .zip-file uit te pakken, maar dan moet daarna het volgende commando worden uitgevoerd:

<installatiemap>/java_vm/bin/javaw -Xshare:dump

Dit zorgt ervoor dat Java aanzienlijk sneller start; dit wordt normaal uitgevoerd door de installer na het plaatsen van de nieuwe Java versie. Als er een nieuwe Java versie gewenst is, kan deze opgehaald worden van

http://www.bicat.com/getdown/.

Het gemakkelijkste is om het ophalen vanaf de OCLC Wise webserver te doen, vanuit de map /home/hka/bxmbng-webstart/docroot/getdown. Hier kunnen de getoonde commando's worden uitgevoerd.

Bijvoorbeeld:

wget http://www.bicat.com/getdown/jre1.8.0_60.zip;
echo -e "[main]\nsourcefile=jre1.8.0_60.zip\n" > java.ini

Daardoor wordt ook direct de juiste java.ini geplaatst. Neem contact op met OCLC indien de gewenste Java versie nog niet beschikbaar is op http://www.bicat.com/getdown/.

Getdown herkennen

Versie 6.3.3: Clients die worden gestart met Getdown zijn in de poortentabel te herkennen aan [GD] in het veld 'environment' (achteraan). Gebruik select * from poorten where environment like '%[gd]%'; om dit te achterhalen.

Bijv. Java 1.7.0_09 (32 bits) on Windows 7 (version 6.1) [GD]