Stand-alone operation

The progams started by "gwd" and "gwsetup" operate by opening INTERNET ports which to the Browser can send requests. "gwsetup" uses port 2316 to administer the database whereas "gwd" uses port 2317 for normal access.

Stand-alone use of Geneweb entails mainly clicking on links in web pages; but a look at the URL field shows what messages are sent to which port. Some examples will show how this works:

 
http://localhost:2317/jv1
is a stand-alone request to "gwd" (listening on port 2317) to access the HOME page for the database "jv1". In requests to "gwd", the first parameter always gives the name of the database.

http://www.iro.umontreal.ca/~vaucher/Genealogy/geneweb.cgi?b=jv1
is the same request to Geneweb on a web server. It addresses the geneweb.cgi in my own account on the umontreal server.
Next is the request sent as a result of doing a search by surname from the Home page of database "jv1". It asks for a listing of all Vauchers and request an answer in French (lang=fr). Again we give both the stand-alone and the web versions. Note the identical part after the prefix part. http://localhost:2317/jv1?lang=fr&m=NG&n=Vaucher&t=PN
 
http://localhost:2316/en
will cause "gwsetup" to return its HOME page (in english)

http://localhost:2316/doc/en/start.htm
is a request for the "Getting Started" documentation (in English: "en")

http://localhost:2316/gwsetup?lang=fr;v=ged2gwb.htm
is a request to launch the "ged2gwd" utility to import a GEDCOM file and to use French (lang=fr) for the next page - asking for the file name.

http://localhost:2317/jv1
is a request to "gwd" (listening on port 2317) to access the HOME page for the database "jv1". In requests to "gwd", the first parameter always gives the name of the database.

http://localhost:2317/jv1?lang=fr&m=NG&n=Vaucher&t=PN
Here some parameters are obscure; but it is a request for a listing of persons with lastname "Vaucher" in database "jv1" and the returned page should be in Norwegian (lang=no)

Browser request (Unix layout)

The parameters of all (gwd) requests to Geneweb on a Unix server are identical to those in stand-alone mode. The only difference between both situations is in the first part of the requestwhich denotes the target. In my case it is geneweb.cgi :
	http://www.iro.umontreal.ca/~vaucher/Genealogy/geneweb.cgi
Here is the request (from the browser) for all Vauchers in the database jv1 in both situations
 
Stand-Alone
http://localhost:2317/jv1?lang=no&m=NG&n=Vaucher&t=PN

UNIX Web server
http://www.iro.umontreal.ca/~vaucher/Genealogy/geneweb.cgi?b=jv1&lang=no&m=NG&n=Vaucher&t=PN

Creative Commons License
GeneWeb Secrets by Jean Vaucher is licensed under a Creative Commons Attribution 4.0 International License.
Based on a work at http://www.iro.umontreal.ca/~vaucher/Genealogy/Secrets/GW_secrets.html