Laatstelijk bijgewerkt op 16 mei 2001.
Installatieproblemen
Op deze pagina staan de oplossingen voor de meest voorkomende problemen bij de installatie van de netwerkversie van de repertorium cd. Voor de stand-alone versie is een andere pagina beschikbaar.
Vooraf
Aangezien niet alle netwerken hetzelfde zijn, moet u de hieronder gegeven aanwijzingen op uw eigen situatie toesnijden. Het enige 'harde' vereiste is dat uw netwerk voorzien is van het TCP/IP protocol.
Dat het repertorium aangeboden wordt als web-site is ingegeven door de keuze voor een maximum aan flexibiliteit en compatibiliteit. Dat brengt mee dat installatie op uw netwerk niet altijd even eenvoudig zal zijn.
De CD is gemaakt voor een min of meer automatische installatie onder Windows. Als dat in uw netwerk niet van toepassing is, vindt u hieronder (Installatie met de hand) aanwijzingen om andere situaties het hoofd te bieden.
Installatie onder Windows
De installatieprocedure gaat er vanuit dat u het repertorium onder Windows installeert en dat Windows nog niet is voorzien van een web-server / intranet.
Met de CD in de drive opent u [Deze computer] en klikt u met de RECHTER-muisknop op de CD en start u vervolgens de volledige installatie.
Eerst installeert zich nu Xitami, de webserver. U krijgt verschillende vragen te zien, u kunt overal doorklikken [Next] behalve wanneer u gevraagd wordt om een naam en password. Zowel voor de naam als voor het wachtwoord vult u 'nefarma' in. Vervolgens kunt u weer verder. Tenslotte kiest u voor 'Finish'. Nu blijft er een klein venstertje open met het Xitami ikoon.
Op de achtergrond worden nu de verder benodigde bestanden gekopieerd. Dit proces loopt vanzelf af.
Wat overblijft is het venstertje met Xitami (later ook te vinden onder het menu 'Start'->'Programma's'->'Internet Tools'->'Xitami webserver').
Start Xitami, u ziet rechts onder op de taakbalk een groen ikoontje ten teken dat Xitami gestart is. Mocht u per ongeluk het programma nogmaals starten, dan krijgt u een foutmelding omtrent het al bezet zijn van een TCP/IP-poort.
Klik vervolgens met de RECHTER muisknop op het bureaublad, maar niet op een ikoon. Van het menu kiest u nu 'Nieuw'->'Snelkoppeling'. Vul in: http://127.0.0.1/index.html en klik op 'Volgende'. Vul vervolgens in 'Repertorium' en klik op 'Einde'. U hebt nu een snelkoppeling naar de repertorium-bestanden.
Wanneer u nu eerst Xitami start en vervolgens deze snelkoppeling start, komt u in de Internet Explorer (of andere default-browser) op de startpagina van het repertorium.
Na gebruik van het repertorium kunt u Xitami afsluiten door met de RECHTER muisknop te klikken op het groene ikoontje rechtsonder op de taakbalk, en te kiezen voor 'Terminate'.
Installatie met de hand
Om verschillende redenen kan het nodig zijn de bestanden met de hand te installeren: er is al een intranet, u gebruikt een ander Operating System, of u hebt liever totale controle over de installatie.
Op de CD kunt u de 4 benodigde elementen vinden:
- de web-server
- netscape
- nfiles
- perl
Soms kan het aanbeveling verdienen de CD toch eerst 'automatisch' te installeren op een webserver-vrije computer, zodat u kunt zien wat de bedoeling is.
Eerste stap: de webserver
In de directory 'xitami' treft u verschillende varianten van de http-server xitami aan, voor verschillende operating systems en verschillende platforms. Mocht er voor uw platform/operating system geen versie aanwezig zijn, dan zult u op Internet een geschikte server moeten zoeken (bijv. Apache).
U kunt de werking van uw webserver testen met een browser via http://127.0.0.1/ op de machine waar de webserver op staat, of via http://xxx.xxx.xxx.xxx/ op een andere machine in het netwerk, waarbij xxx.xxx.xxx.xxx het IP-adres is van de machine waarop de webserver staat. De handleiding van de webserver bevat meestal ook een test-procedure.
Tweede stap: Perl
Wanneer uw webserver werkt, moet u zich ervan verzekeren dat Perl functioneert. Sommige webservers hebben Perl 'ingebakken', bij andere moet u het apart toevoegen. In de directory nfiles\perl vindt u een 'uitgeklede' versie van Perl, geschikt voor gebruik onder Windows. Wanneer u meer wilt van uw intranet doet u er verstandig aan een volledige versie van Perl op te halen. Op Internet kunt u voor alle platforms/operating systems wel een versie van Perl vinden, inclusief tests om te kijken of alles goed ingesteld is.
Derde stap: repertorium bestanden
De directory nfiles\nefarma bevat verschillende categorieën van bestanden:
- de html-, gif- en jpeg-bestanden, die tezamen de inhoud van het repertorium bevatten;
- nefarma1.pl is het script om een nieuwe index te genereren;
- nefarma.idx en stopword.txt, twee bestanden die de index bevatten;
- nefarma.css, het stylesheet
- index.html, clear_stage.html, clear_directory.html, header.html, footer.html en help.html, tezamen met de subdirectory 'graphics' bevatten de 'organisatie' van de site
Alle bestanden moeten bij elkaar in één directory blijven,
Bij de webserver wordt meestal al een standaard gegevensdirectory aangemaakt, vaak kunt u die directory ook zelf instellen of veranderen (in een configuratie-bestand). Voorts is het vaak mogelijk een zogenaamde virtuele host aan te maken, waardoor de inrichting van uw intranet wat beheersbaarder wordt.
Vierde stap: de zoekmachine
In de directory nfiles\cgi-bin staat het bestand nefarma2.pl, de zoekmachine. Uw webserver schrijft voor in welke directory u Perl-scripts moet installeren, maar in het algemeen zal dat een directory zijn met de naam cgi-bin of iets vergelijkbaars. Daar moet u 'nefarma2.pl' in plaatsen.
Testen
Wanneer alles goed is ingesteld, kunt u met een browser naar http://xxx.xxx.xxx.xxx/index.html surfen, en krijgt u dan het repertorium te zien: links een javascript menu, boven en onder een blauwe balk, en een uitgebreide inhoudsopgave in het hoofd-frame. Onderaan het menu vindt u de verwijzing naar de zoek-pagina. Wanneer u de zoek-pagina niet te zien krijgt, maar in plaats daarvan een foutmelding, dan kunnen er twee oorzaken zijn: Perl werkt niet, of nefarma2.pl staat niet op de goede plaats.
Wanneer u de zoek-pagina wel te zien krijgt, kunt u vervolgens een zoekterm invoeren, bijvoorbeeld aspirine, en vervolgens op 'Zoek' klikken. Vervolgens krijgt u een lijstje met gevonden resultaten, of niet. In dat laatste geval zijn er weer verschillende oorzaken mogelijk. Het meest waarschijnlijk is dat in nefarma1.pl en nefarma2.pl verkeerde directories staan aangegeven waar de diverse bestanden zich zouden moeten bevinden. Om dat goed te krijgen, moet u beide scripts, nefarma1.pl en nefarma2.pl aanpassen (met een text-editor, niet met een tekstverwerker) aan uw situatie. In beide scripts staan op strategische plaatsen aanwijzingen waarmee u de scripts aan uw situatie kunt aanpassen.
Ten slotte kan het nodig zijn het bestand nefarma.idx aan te passen. Als u nefarma.idx opent (met een text-editor, niet met een tekstverwerker) zult u zien dat de index opgebouwd is uit twee blokken: het eerste blok is de woordenlijst met achter ieder woord de code van het html-bestand waarin dat woord voorkomt, het laatste blok is een lijst van codes met het daarbij behorende html-bestand. Op de grens van die twee blokken vindt u het volgende fragment:
zyprexa 848C
zyrtec 1AA
--
1 003_xyloc_22524.html /987607128 XYLOCAINE 5 met glucose
10 089_pneum_18141.html /987811017 PNEUMUNE
Op de lege regel (onder de streepjes) moet u, afhankelijk van uw installatie, invullen in welke subdirectory de html files staan, m.a.w. het pad dat u daar invult, bepaalt waar de html-bestanden gezocht moeten worden, die als resultaat van een zoekactie op uw scherm staan.
U kunt de juistheid van dit pad controleren door een link te bekijken die op de resultatenlijst van een zoekactie staat. U ziet dan snel genoeg of de aanpassing goed is.
Als het niet werkt
Ga eerst de diverse onderdelen van de installatie na:
- Is de webserver operationeel (problemen met TCP/IP, browser, poort)?
- Kunt u index.html, de startpagina van het repertorium, openen op de webserver (problemen met frames, javascript, stylesheet)?
- Kunt u de zoeker-pagina (/cgi-bin/nefarma2.pl) zien nadat u die hebt aangeklikt op het menu (problemen met perl, cgi-bin directory, inhoud van nefarma2.pl zelf)?
- Krijgt u een resultatenlijst te zien na een zoekactie (problemen met nefarma2.pl, nefarma.idx)?
- Krijgt u de gevraagde pagina te zien wanneer u op een link op de resultatenlijst klikt (probleem met nefarma.idx)?
Als inpassing in uw eigen intranet niet werkt, of u dat liever niet wilt, zijn er alternatieven: u kunt een tweede webserver installeren, hetzij op een andere computer, hetzij
op dezelfde computer als waar al een webserver staat. In het laatste geval moet u voor de tweede webserver een andere IP-adres gebruiken of een andere poort gebruiken.
Om de repertorium CD zo snel en gemakkelijk mogelijk 'aan de praat' te krijgen, kunt u het best de standaard installatie uitvoeren op een Windows-computer. Aan de hand daarvan kunt u ook inzicht krijgen in de opzet van het repertorium als web-site.
Software
Internet adressen voor de gebruikte software (en alternatieven):
web-servers:
perl:
browser
ice:
Specifieke foutmeldingen
U kunt mailen naar nefarma@xs4all.nl