W3C AnnoteaDocumentation

Annotation Server HOWTO for Windows NT Systems

Annotea project | server status | mailing list archive

These are additional instructions for the instructions in http://www.w3.org/1999/02/26-modules/User/Annotations-HOWTO. These instructions provide help when installing Annotation Server for NT.

Setuping Apache Web server

These instructions are for Apache Web server. If Indigo Perl is used some additional actions may be required. Apache may be installed as service, or separately startable program. Configuration could be tested from start menu with test configuration -program. Following modifications have to be made to httpd.conf -file:

There should be lines "AddHandler cgi-script .pl" and "AddHandler cgi-script .cgi" in section 2. They might be commented out, but those comment marks (#) should be taken away.

Then there have to be added few lines to aliases -section including lines from http://www.w3.org/1999/02/26-modules/User/Annotations-HOWTO under Configure the Web Server and Access Control -headers. In the lines "Require group registered", registered is the name of the group where the users should belong (more of this below). It has to be ensured that the paths in the first lines are correct. The AuthDBMUserFile and AuthDBMGroupFile could be the same (recommended).

Setuping ActiveState Perl

More instructions in http://www.activestate.com/

Setuping Amaya

More instructions in http://www.w3.org/Amaya/

Setuping Perllib

More instructions in http://www.w3.org/1999/02/26-modules/Distribution.html and http://www.w3.org/1999/02/26-modules/cvs.html. WinCVS 1.2 (http://www.wincvs.org/) and TCL833 shell (http://aspn.activestate.com/aspn/downloads/activetcl/ or http://www.scriptics.com/) are very helpful in this part and also recommended. With WinCVS the most recent files could easily be downloaded and it uses TCL833 shell.

Setuping MySQL and My_ODBC

More instructions in http://www.mysql.com/doc/W/i/Windows_installation.html. After installation in shell should be written: "mysql -u root mysql" and to the line that appears:

"INSERT INTO user VALUES ('%','AnnotateServer',password('AnnotatesPassword'),'Y','Y','Y','Y','N','N','N','N','N','N','N','N','N','N');"

In the instructions at http://www.mysql.com/doc/W/i/Windows_installation.html there is longer command but this is enough in this case.

Building up MySQL RDF database

Building up MySQL RDF database happens with command: "mysql <c:/W3C/Rdf/bin/RdfObjects.mysql". So, it is like this, if c:/W3C/Rdf/bin/RdfObjects.mysql is the right path to RdfObjects.mysql in the system used.

Adding Conf/rdf.prop

There has to be added Conf/rdf.prop -file into the file system (instructions in http://ww.w3.org/1999/02/26-modules/User/RdfSQL-HOWTO.html) and has to be ensured that it is in the right place. In the other that words in files (like CGIApp.pm or algae) that are calling rdf.prop, the paths point to right place. The rdf.prop should look like this:

user: AnnotateServer
password: AnnotatePassword
database: rdf
queryHost: localhost

Getting nmake

Nmake could be needed to use makefiles in installing Perl modules. You can get it from http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe.

Modifying annotate -file

It has to be ensured that in annotate -file (in W3c/annotations/cgi/) and like every other perl scripts, the first line is #!perl or #!<path>/perl where <path> is the path to the perl.exe. Default in these files is usually #!/usr/bin/perl or something like that. There may also be some invalid form of xml; Most of the <br> -tags are not correct (they should be as <br />) and many <hr> and <input> -tags doesn't have end tags like they should. There are also size -attributes without quotation marks like size=55 but they should be like size="55".

Modifying algae -file

In algae -file there are same kinds of problems as in annotate. There are many <p>, <br>, <input>, <li> and <hr> -tags missing end tags.

Adding users to database

Finally user(s) should be added to users and to a group. This can be done by using dbmmanage script which should be in Apache -directory. More instructions could be found from http://httpd.apache.org/docs/programs/dbmmanage.html. For example in shell it should be written "perl dbmmanage.pl c:\<path>\users.txt adduser "username" "userpassword" "groupname". Of course username is users name and user password is users own password. The groupname has to be the same as in step 1 mentioned groupname, default "registered". <path> could be like c:\W3C\Users\ or something like that.

Ville Maijala (ville.maijala@hut.fi)