Administration notes

Trac has been installed via apt-get, and plugged into apache using mod_python (see /etc/apache2/sites-available/default). The project environment for Ciao was created at /home/clip/Systems/CiaoDE-trac using trac-admin, and it was given proper permissions and owner (wwwd group).

How to register new users

Trac relies on the web server to implement authorization. A file passwd was created in CiaoDE-trac/db. To register you must be a Ciao developer, login as root and do:

$ cd /home/clip/Systems/CiaoDE-trac/db
$ htpasswd passwd USERNAME

where USERNAME is your user name. It will ask for a password.

How Emacs support was added

Trac wiki pages can be edited from emacs in this installation.

From the server side, it was necessary to install by hand the XML-RPC plug-in. The last version is not working properly, so the last trunk version was installed instead.

For each user

As a user, you need XML_RPC privileges to gain access to the XML-RPC service, which enable remote interaction with Trac via XML. This is done by:

clip:/home/clip/Systems/CiaoDE-trac# trac-admin .
Trac [/home/clip/Systems/CiaoDE-trac]> permission add YOUR_USER_NAME XML_RPC

Then you must install the trac-wiki.el mode, which also requires the xml-rpl.el mode. Copy those .el files in your emacs site-lisp directory, and load the mode by adding in your .emacs:

(required 'trac-wiki)

Then, once trac-wiki is loaded, it is ready to use. Use trac-wiki-define-project to define a project for Ciao. For example:

(trac-wiki-define-project "trac-ciao"
			  "http://clip.dia.fi.upm.es/Software/Ciao/trac/" t)