          Installing Roxen WebServer - the Source distribution
          ++++++++++++++++++++++++++++++++++++++++++++++++++++

Observe: To avoid permission problems for the running Roxen, the
installation of Roxen should be done as the user you intend to run
Roxen as.

  1. Get the source server package.

  2. Issue the command to unpack the archive:

          .tar.gz:
               If you have GNU tar; "tar xzf Roxen-archive-name"
               If you don't have GNU tar:
               "gunzip < Roxen-archive-name| tar xf -"
          .tar.Z
               If you have GNU tar; "tar xzf Roxen-archive-name"
               If you don't have GNU tar:
               "uncompress < Roxen-archive-name| tar xf -"
          .tar
               "tar xf Roxen-archive-name"

     (where "Roxen-archive-name" is the name of the Roxen archive
     file.).

  3. Type "cd <roxen_version>" to change to the new directory. This
     directory should contain at the very least two directories:
     roxen (Roxen server source) and pike (the Pike interpreter).

     (Where <roxen_version> is the name of the unarchived Roxen directory.)

     The directory may also contain sources for some useful libraries
     like gmp, odbc and zlib. Pike and Roxen requires gmp by default,
     so make sure you have it installed.

 4a. Type "make install" to install Roxen and Pike in /usr/local/roxen.

     If everything worked fine and the compilation is done, type
     "cd /usr/local/roxen/server-2.2.<x>" followed by
     "./create_configinterface". This creates an administration interface
     for the server.

     Follow the instructions found in the mysql/README file.

     After that (still standing in the server directory) type
     "./start" to start the server and put it in the background.

 4b. (This is an alternative method if you want to install Roxen somewhere
     else than /usr/local, or if method 4a fails. It is not
     recommended for beginners.)

     Type "./configure --prefix=<wanted_base_path_for_roxen>"
     (defaults to /usr/local, thus placing Roxen in /usr/local/roxen/)
     followed by make and make install to build the binaries and copy them
     to the correct place.

     If everything worked fine and the compilation is done, type
     "cd <dir>/server-2.2.<x>" followed by "./create_configinterface". 
     This creates an administration interface for the server.

     Follow the instructions found in the mysql/README file.

     After that (still standing in the server directory) type
     "./start" to start the server and put it in the background.

     (Where <dir> is /usr/local/roxen following 4a, or
      <wanted_base_path_for_roxen>/roxen if you used 4b.)

  5. Answer the simple questions and then start you favourite webbrowser
     and point it to the configuration interface you just set up.

  6. If everything worked, configure the server, otherwise move on to the
     troubleshooting section on the roxen WWW-pages.

 Once you have installed the server, consider joining the Roxen
 mailinglist (by sending a mail to roxen-request@roxen.com, with
 Subject: subscribe).

 For more information about Roxen, read the online documentation at
 http://www.roxen.com/

----------------------------------------------------------------------------
Example installation session using the 4b route:

bash$ tar xzf roxen-2.2.x.tar.gz
bash$ cd roxen_2.2.x-src
bash$ mkdir solaris
bash$ cd solaris
bash$ ../configure --prefix=/usr/www

<Lots and lots of checks...>

bash$ make install

<Lots and lots of compilations...>

bash$ cd /usr/www/roxen/server-2.2.x
bash$ more mysql/README

<install Mysql if needed...>

bash$ ./create_configinterface
<answer a few questions>

bash$ ./start

<Server is up and running>

----------------------------------------------------------------------------
Example installation session using the 4a route:

bash$ tar xzf roxen-2.2.x.tar.gz
bash$ cd roxen-2.2.x
bash$ make install

<Lots and lots of checks...>
<Lots and lots of compilations...>

bash$ cd /usr/local/roxen/server-2.2.x
bash$ more mysql/README

<install Mysql if needed...>

bash$ ./create_configinterface
<answer a few questions>

bash$ ./start

<Server is up and running>
