Table of Contents

  • Introduction
  • Installation
    · Introduction
    · Windows installation
    · UNIX installation
    · Starting the Server
    · Directory Structure
  • Handling Challenger
  • Virtual Servers
  • Configuration Examples
  • Modules
  • Filesystems
  • RXML Tags
  • Graphics
  • Proxy
  • Databases
  • Miscellaneous Modules
  • Security Considerations
  • Scripting
  • Frontpage
  • Upgrading
  • Third Party Extensions
  • Portability
  • Reporting Bugs
  • Appendix
  • UNIX installation
    To install the Unix version of Challenger, you will need the GNU tar or gunzip/gzip program, as Challenger is normally distributed as a tar.gz archive. To install the source package on Unix you will need an ANSI C compiler. It is currently not possible to install the source distribution from scratch on Windows, since the compilation process is quite complex.

    Binary distribution

    1. cd
      to the directory where you want Challenger to be installed and place the archive there.

    2. Issue the following commands to unpack the archive:

      If you have GNU tar:
      tar xzf Roxen_1.2.tar.gz

      If you don't have GNU tar:
      gunzip Roxen_1.2.tar.gz
      tar xf Roxen_1.2.tar

    Now move on to the section "Finishing" below.

    Source distribution

    1. cd
      to the working directory where you want to compile Challenger.

    2. Issue the following commands to unpack the archive:

      If you have GNU tar:
      tar xzf Roxen_1.2.tar.gz

      If you don't have GNU tar:
      gunzip Roxen_1.2.tar.gz
      tar xf Roxen_1.2.tar

    3. Then type:

      cd Roxen_1.2

      to change to the Challenger directory.

    4. To continue with the default installation, type:

      make install

      This will configure Challenger with default values, compile it and then install it in /usr/local/roxen/. If you are happy with this then you can move on to step 5.

      If you prefer a custom installation, type:

      ./configure --prefix=path to Challenger

      prefix defaults to /usr/local/, witch places Challenger in /usr/local/roxen/

      This will take a while. When it's done, type:

      make install

    5. The Pike interpreter and various helper programs will now be compiled and then installed.

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

    Finishing the installation

    1. Type:

      cd roxen/server/

    2. Start the install script by typing ./install

    3. Answer the questions and connect to the configuration interface URL.

    Installing Pike separately

    Binary distribution
    For a binary installation, follow the steps for "Binary distribution" above to unpack the tar archive.

    1. cd
      to the roxen directory.

    2. Type:
      make install_pike

    Source distribution
    For a source installation, follow the steps for Source distribution for Challenger above, but type

    make install_all

    instead of just make install.
    or type

    make install_pike

    if you have already installed Challenger.