Installation
Araneida is distributed as an ASDF System. You
may want to investigate whether there is a convertor from ASDF systems
to your platform's package standard, in which case installation will
be a simple matter of apt-get or pkg_add or something and you can skip
to Use. Otherwise, read on ...
- You need a CMUCL or SBCL implementation that has asdf loaded into it
- From your favourite cCLan
mirror, download cl-db-sockets,
net-telent-date and araneida, and
untar them somewhere.
- Create symlinks to the unpacked .asd files in a directory on your
asdf *central-registry* list. For example
* asdf::*central-registry*
(*DEFAULT-PATHNAME-DEFAULTS* "/home/dan/src/defsystems/")
$ cd /home/dan/src/defsystems/
$ ln -s ../telent/araneida/araneida.asd ../telent/net-telent-date/net-telent-date.asd ../telent/db-sockets/db-sockets.asd .
- You should now be able to compile and load the systems with
* (asdf:oos 'asdf:load-op 'araneida)
- Congratulations. It's now working
Oh, you wanted to be able to actually use it?
- There are example handlers in the examples/ subdirectory.
Copy them to a scratch directory, and symlink the araneida-examples.asd
file into somewhere on *central-registry* (as before)
- Edit per-host.lisp to have appropriate values for your
local setup. You can override any setting in variables.lisp
- (asdf:oos 'asdf:load-op 'araneida-examples)
- Prepare an Apache installation with proxy support. Configure it
to include /tmp/apache.cf.inc or whatever you specified for
*apache-config-segment* above.
Configuring Apache is Outside The Scope of these instructions, but
as a start, here are the relevant lines from my Debian laptop:
LoadModule proxy_module /usr/lib/apache/1.3/libproxy.so
NameVirtualHost noetboot.telent.net
Include /tmp/apache.cf.inc
- Write the apache config file segment using
(araneida-examples::init) - now start or restart Apache
- Start the server event handlers using (araneida-examples::start)
- Fire up a web browser. Browse.
- Observe that the toplevel also still works
- Read ../examples/main.lisp to
see how it works. Your own web application will need to do similar
things.
- Stop the web server event handlers with (araneida-examples:stop)
- Send me mail and tell me how
badly broken these instructions are. And, ideally, in what ways.