Table of Contents
- Introduction
- Installation
- Handling Challenger

  | · Introduction · User Interface · Restarting · Log Files · Status · Maintenance · Threads

- 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

User Interface

Tabs
The Challenger configuration interface is divided into Virtual Servers, Global Variables, Event Log and Actions. The parts are divided by tabs, selecting a tab will take you to the corresponding part.

`Virtual servers`
  This is where you configure your virtual servers. The virtual servers chapter deals thoroughly with the concept of virtual servers.

`Global Variables`
  This is where you configure options that are global to the whole Challenger server, for example the port of the configuration interface.

`Event Log`
  The event log shows important events. These events are also sent to the debug log. You should regularly look at one of these logs, to make sure the server is operating smoothly.

`Actions`
  Here you find a number of tools for getting status about the server and performing maintenance.

Navigating

The Fold/Unfold principle
The configuration interface is based upon the principle of fold/unfold arrows. If you click on one of the arrows pointing right it will change into a down-pointing arrow and all the underlying items with their associated variables will become visible; they unfold. Clicking on a down-pointing arrow will fold the arrow again.

Fold/Unfold arrows

Focusing
It is also possible to click on the main menu items themselves, not only unfold them. Doing this is called focusing. Sometimes focusing is necessary to access certain functions and it also gives you a clearer overview of the variables residing under each item. We consider every clickable item a node.

When you have focused on an item, you will see an up pointing arrow to the left of the item. This item will now be the top-most visible header.

Focusing on fonts

Clicking on the up-pointing arrow will get you back one level in the configuration interface.

Clicking on the active tab, Global Variables in this case, returns you to an unfocused state. Note that the status row in the upper right corner always indicates where in the configuration interface you are.

Color encoding
The configuration interface uses color encoding. As soon as you have made some changes you will notice that the blue-colored arrows turn red. The red arrows are meant to draw your attention to where there are unsaved changes. In order to make your changes permanent you will have to click on the `Save` button at the bottom of the page. The arrows will then turn blue again.

Buttons
There are usually one or more buttons at the bottom of the page. On some nodes more buttons will appear to reflect what can be changed at that node.

`Save`
  Save changes of the configuration to disk. Changes made will take effect immediately, but they will not be saved on disk until you click this button. Restarting the server before saving to disk will undo the changes.

  The `Save` button will only appear when there are unsaved changes.

`New virtual server`
  Create a new virtual server. The `New virtual server` button appears on the top node of the Virtual Servers tab.

`Delete this server`
  Delete this virtual server. The `Delete this server` button appears on the virtual server nodes.

`Add module`
  Add a module to this virtual server. The `Add module` button appears on the virtual server nodes.

`Copy module`
  Add another copy of this module to the current virtual server. This option will only be available for modules that may have more than one copy run simultaneously. The `Copy module` button appears on the module nodes.

`Reload module`
  Reload this module. The module will be recompiled and then reloaded. For developing or upgrading modules. The `Reload module` button appears on the module nodes. This option is only available if `More options` has been selected.

`Delete module`
  Delete this module. The `Delete module` button appears on the module nodes.

`More options/Fewer options`
  The configuration interface allows you to choose between fewer and more options respectively. By default set to fewer options. More options can be chosen by simply pressing the `More options` button at the bottom of the page.

`Fold all`
  When you have made several changes or descended deep into the configuration hierarchy you can fold all the sub menus by clicking on the `Fold All` button at the bottom of the page.

`Unfold level`
  The `Unfold level` button unfolds all sub menus on this level.

`Unfold modified`
  The `Unfold modified` unfolds all nodes with unsaved changes.

`Clear module caches`
  This will clear the module caches.