GeneWeb - Server eller CGI

När "gwd" är startad, är den en server. Normalt, ska den tredje adressen: "http://computer:2317/base" användas för externa personer.

Hursomhelst, detta gäller bara för datorer synliga på Internet, vilket betyder de som är direkt anslutna till Internet.

Om du använder en Internetleverantör är din dator inte synlig. I detta fallet, finns det ingen lösning. Det är Internetleverantörens ansvar att installera GeneWeb. Vid denna tidpunkt (februari 2000) har bara en Internetleveratör installerat den.

Således, det följande gäller bara de som har en direkt anslutning till Internet.

Om du kör under Unix eller Windows NT (alltså inte Windows 95/98), måste du ange ett användarnamn när du startar datorn, där du anger ditt login namn och ditt passord. Kanske vill du kunna logga ut utan att GeneWeb stannar.

Du har då två lösningar för detta problem: installation i "service" och installation i "CGI".

Installation i "service"

I denna mod behöver du inte ha en webbserver installerad på din dator. Gwd är en webbserver i sig självt. Den enda skillnaden mot andra servers är att den bara betjänar genealogi.

Om du är under Unix, istället för att skriva bara "gwd", skriv:
```
     nohup gwd 2>&1 &             (under "sh", "ksh", "bash")
     nohup gwd >& nohup.out &     (under "csh", "tcsh")
```
Då kan du logga ut. Gwd kommer att fortsätta köra och sända dess utskrift till filen "nohup.out" som du kan titta på sedan. För att stoppa den, titta efter dess process nummer med kommandot "ps" och döda den med kommandot "kill".

Om du kör Windows NT, måste du installera "gwd" som en "service" genom att använda programmet "srvany.exe", du måste vara inloggad som Administrator. Från Windows NT Ressource Kit behöver du: "srvany.exe", "instsrv.exe", kanske "srvinstw.exe" och "delsrv.exe" också. Kopiera först "srvany.exe" till en katalog på din dator (t.ex. C:\GeneWeb) och installera det som en "service" (ett trevligare verktyg för det, är det grafiska programmet "srvinstw.exe"):
```
     instsrv GeneWebServer c:\GeneWeb\srvany.exe
```
I "Services" i "Control Panel", klicka "GeneWebServer" och klicka sedan "Startup" för att välja "Automatic" eller "Manual". I "Log On As" rutan, välj kontot där servicen ska starta, fylla i det rätta passordet (detta måste göras för att komma åt nätverket). GeneWeb kommer att starta genom att specifiera de följande register värdena med "regedt32":
```
1. Under HKLM\System\CurrentControlSet\Services\GeneWebServer skapa
   en nytt värde "Parameters"
   
2. Skapa där två nya Värden (skriv REG_SZ) Application and AppDirectory, t.ex.
   Application: REG_SZ: C:\GeneWeb\gw\gwd.exe
   AppDirectory: REG_SZ: C:\GeneWeb\gw
```
Nu kan du kontrollera GeneWeb servicen i "Control Panel" -> "Services" -> "GeneWebServer" "Startup"/"Stop" eller genom att skriva "net start GeneWebServer" eller "net stop GeneWebServer" vid kommando prompten. För att ta bort GeneWebServer, stoppa den och skriv "delsrv GeneWebServer" eller "instsrv GeneWebServer remove".

Installation i "CGI"

I denna mod måste en webbserver köras på din dator. "CGI"s är program som webbservern kan starta. Endast systemadministratören är behörig att lägga till "CGI"s. Du måste be denna om lov.

Under Unix, om du installerade GeneWeb i katalogen "/home/svensson/geneweb", skapa en fil med namn "geneweb" som innehåller följande rader:
```
     #!/bin/sh
     DIR=/home/svensson/geneweb/gw
     cd $DIR
     $DIR/gwd -cgi 2>/dev/null
```
Gör den exekverbar (chmod +x geneweb) och be din systemadministratör att installera denna fil i "cgi" katalogen. Fråga vilken adress som ska användas. Den kommer förmodligen att se ut så här:
```
     http://blabla.xx.se/cgi-bin/geneweb
```
Om du öppnar URLen ovan i din webbläsare, kommer du att se en sida som frågar endast "Base:". Mata in namnet på din databas. Du kan också lägga till "?b=karlsson" till denna URL, om "karlsson" är din databas namn.
Obs:
- Om det senaste kommandot inte fungerar, är det möjligt att webbservern inte har åtkomst rättigheter till databasen och de andra katalogerna. Gör de följande åtgärderna:
```
     cd /home/svensson/geneweb/gw
     chmod 777 . lang images base.gwb
```
- Om den svarar men är väldigt seg, är det möjligt att åtkomsten till din databas är genom NFS (om du inte vet vad det betyder fråga din systemadministratör). Det vore bättre om så inte var fallet: om möjligt, kopiera katalogen geneweb till en lokal disk på webbservern. Om det inte är möjligt, lägg till optionen "-nolock" i anropet till kommandot "gwd" för filen "geneweb" ovan:
```
     $DIR/gwd -cgi -nolock
```

Under Windows NT, om du installerade GeneWeb i katalogen "c:\program\svensson\geneweb", skapa en fil som du döper till "gwd.arg" och som innehåller följande rader:
```
     -hd
     c:\program\svensson\geneweb\gw
     -bd
     c:\program\svensson\geneweb\gw
     -cgi
```
Dessa är de optioner som kan ges till kommandot "gwd". Skriv "gwd -help" för att se alla möjliga optioner.
Be din systemadministratör:
- Att installera "gwd.arg" i "cgi" katalogen.
- Att kopiera filen "gwd.exe" från "geneweb" katalogen till denna "cgi" katalog.
Fråga vilken adress som ska användas. Den kommer förmodligen att se ut så här:
```
     http://blabla.xx.se/cgi-bin/gwd.exe
```
Om du öppnar URLen ovan i din webbläsare, kommer du att se en sida som frågar endast "Base:". Mata in namnet på din databas. Du kan också lägga till "?b=karlsson" till denna URL, om "karlsson" är din databas namn.

Obs: om detta senaste kommando inte fungerar, är det möjligt att webbservern inte har åtkomst rättigheter till databasen och de andra katalogerna. Du måste ge läs och skriv rättigheter till katalogen "geneweb" och underkatalogerna "lang", "karlsson.gwb", "images" (och "cnt" om den katalogen finns).

Installation i "service" eller i "CGI"?

Om du har möjligheten att installera som "service" eller som "CGI", notera det följande:

I CGI mod är förfrågningar indirekta, eftersom de måste passera genom webbservern, vilket kan slöa ner behandlingen.
Under Unix är installationen i "service" enklare, eftersom den inte kräver tillåtelse eller hjälp av systemadministratören.
Under Windows NT, måste du alltid fråga din systemadministratör, vilken troligen kommer att föredra CGI mod vilken är enklare att installera och mer kontrollerbar.
Självklart, om det inte finns någon webbserver på din dator, är endast installation under "service" möjlig.

Tillbaka till bruksanvisningen