Installation

I. Choose a WebServer
II. XSP
III. Apache Web Server

I. Choose a WebServer

The first step is to setup a webserver. Currently, there are two options.

XSP, a webserver, written in C#, that can make use of the ASP.NET classes.
Apache with mod_mono

While XSP is faster to setup, it requires no configuration, for production enviroments Apache is strongly recomended, because it offers smooth integration with existing web technologies, like PHP, and is much wider deployed.

II. XSP

1. Get XSP

Get XSP from CVS or untar a release (go-mono.org).

2. Installing XSP

Eventually untar, then "make" in /path/to/xsp/

3. Configuration is not needed, but possible.

Currently you can set the port value in server.config

It can easily be run, by typing "mono server.exe" in path/to/xsp/server/test.
You should put all your aspx files in path/to/xsp/server/test, too.

III. mod_mono

If not already done, you need to compile Apache2:

0. Install Apache 2, with loadable module support

Go to http://www.apache.org and download Apache 2,
the filename will be something like httpd-2.0.43.tar.gz

Unpack it :

tar xvfz httpd-2.0.43.tar.gz
cd httpd-2.0.43
./configure --prefix=/home/username/apache2 --enable-so
make
make install

1. Building and installing mod_mono

Go to http://www.apacheworld.org/modmono/ and download mod_mono or get it from CVS.
Untar, then run:

./configure --with-apache2=/home/username/apache2
make
make install

If everything goes well, you will have the following library:
/home/user/mono/mod_mono/src/.libs/libmod_mono.so

2. Building ModMono.dll

The ModMono.cs file is located in the src/ directory
This is the command I use to build ModMono.dll:

mcs ModMono.cs -target:library -reference:/home/user/mono/install/lib/System.Web.dll

3. Configuring Apache

Copy the file /home/user/mono/mod_mono/src/.libs/libmod_mono.so to /home/user/mono/install/apache2/lib/
Copy ModMono.dll to /home/user/mono/xsp/server/test/ModMono.dll

Edit /home/user/mono/install/apache2/conf/httpd.conf :

Listen 8080
LoadModule mono_module /home/user/mono/install/apache2/lib/libmod_mono.so
LoadModMonoDll /home/user/mono/xsp/server/test/ModMono.dll

Alias /mono /home/user/mono/xsp/server/test

<location /mono/*.aspx>
SetHandler application/x-httpd-mono
</location>

You can now start Apache with
/home/user/mono/install/apache2/bin/apachectl start

First ASP.NET page

After sucessful installation, point your browser to http://localhost:8080/index.aspx . There is a wide range of examples available, to test your server.

A. Credits