Table of Contents

Installing

Unix installation
1 To install the Unix version of Roxen Challenger, you will need the GNU tar or gunzip/gzip program, as Roxen is normally distributed as a tar.gz archive. To install the source package on Unix you will need an ANSI C compiler.

Binary distribution

  1. Get the binary server package appropriate for your architecture.

  2. Issue the command to unpack the archive:

    If you have GNU tar;
    tar xzf Roxen-archive-name

    If you don't have GNU tar:
    gunzip Roxen-archive-name
    tar xf Roxen-archive-name

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

  3. Type
    cd roxen_version/server

    to change to the server directory in the new directory.

    (Where roxen_version is the name of the unpacked Roxen directory.)

  4. Start the install script by typing
    ./install

  5. Answer the simple questions and wait for your client.

  6. Choose a password.

  7. Set up the necessary variables.

You can later on move the directory to anywhere in your file system. Roxen does not keep any absolute paths.

Example installation session:
bash$ tar xzf roxen_1.2.tar.gz
bash$ cd roxen_1.2/server
bash$ ./install

Answer a few questions.

Source distribution

  1. Get the source server package.

  2. Issue the command to unpack the archive:

    If you have GNU tar;
    tar xzf Roxen-archive-name

    If you don't have GNU tar:
    gunzip Roxen-archive-name
    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 four directories: server (Roxen server source), pike (the Pike interpreter), extern (misc. programs used by Roxen) and tools (misc tools). See README for more information about the directory structure.

    (Where roxen_version is the name of the unpacked Roxen directory.)

  4. Type
    make install

    to install Roxen Challenger in /usr/local/roxen.

    (If you do not wish to install roxen in /usr/local/roxen, see "Alternative installation" below.)

  5. Answer the simple questions and wait for your client.

  6. Choose a password.

  7. Set up the necessary variables.

Example installation session using the above route:

bash$ tar xzf roxen_1.2.tar.gz
bash$ cd roxen_1.2
bash$ make install

Lots and lots of checks ...
Lots and lots of compilations
answer a few questions

Alternative installation:
This is an alternative method if you want to install Roxen somewhere else than /usr/local/roxen, or if method 4 fails.

Follow the points in the normal installation, but replace 4 with this:

  1. 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.

    You can later on move the roxen directory that will be created when you type make install to anywhere in your file system. Roxen does not keep any absolute paths.

  2. If everything worked fine and the compilation is done, type
    cd dir/server

    (Where dir is wanted_base_path_for_roxen/roxen)

  3. Start the install script by typing
    ./install.

Example installation session using the alternative route:
bash$ tar xzf roxen_1.2.tar.gz
bash$ cd roxen_1.2
bash$ ./configure --prefix=/usr/www

Lots and lots of checks ...

bash$ make install

Lots and lots of compilations

bash$ cd /usr/www/roxen/server
bash$ ./install

Answer a few questions.

Microsoft Windows installation
The Microsoft Windows version is distributed as a self-extracting .EXE file, containing a graphical installation program.

  1. Run the self-extracting archive file and follow the instructions given by the installation wizard. You will be prompted to select where you want the Challenger files to be stored.

  2. Answer yes or no when asked if Roxen should be run as a service. (Windows NT only)

  3. Challenger is started by choosing Start Roxen from the Start menu. Once Challenger is started you can connect to the configuration interface, that will be reachable at http://localhost:22202 given that you run your browser on the same machine as Challenger.

Running Roxen as a console application

  • Choose "Roxen console mode" from the start menu

    or

  • Double-click on ntroxenloader.pike where Roxen was installed.

Running Roxen as a Windows NT Service
To register the Roxen-service, run:

roxen-dir\server\bin\roxen_service.exe -install

To remove the Roxen-service, run:

roxen-dir\server\bin\roxen_service.exe -remove

You should of course replace roxen-dir with the path to the directory where you installed Roxen.

To start or stop the the Roxen service:

  • Start the "Control panel"
  • Run "Services"
  • Find "Roxen service" and click on start or stop
or run:
net start roxen_service
net stop roxen_service