OpenForum is built on the free, open source web server Metro. Metro is developed in Java as an alternative to a J2EE server.
The Metro server makes possible the definition of multiple servers and services. Servers can be defined for different combinations of address and port and services can be defined to be available for different host names and HTTP header parameters.
The Metro Server can be run in two modes, configuration mode and service mode. In the bin sub directory of the OpenForum directory, you will find to files to start the server:
The Metro configuration application has a screen split into three sections. The left area is a tree view of the configuration, the middle area is a form for configuring the element of the server selected in the left area and the right area is a log of activity on the server when it is running.
The screen shot below is of the Metro server configuration page with a server Vanilla Server selected. The form has entry boxes for entering the server name, address and port. There are buttons to start and stop the server and a check box Autostart that marks the server to automatically start when Metro is started.
Below the Server configuration in the tree view on the left is the mime-types confiruration area. This lists all the resource types that Metro recognises and matches the files extension with its mime type. You can add a new mime type by right clicking on the mime-types label and selecting Add and New mime type.
The services configuration is where you add and configure services for use by servers. An http-server just serves static pages whereas the http-openforum-wiki-service adds an instance of the OpenForum wiki.
All of the data that defines the Wiki services is held in the OpenForum subdirctory data. OpenForum comes with a default service contained in a folder vanilla. Make a copy of the vanilla folder in the data folder and give it a new name. Add an http-openforum-wiki-service to the services node in the configuration tool and set the root to the new folder either as an absolute path using the browse option or as a relative path from the bin folder.
Add a server to the servers node in the configuration tool. Set the desired ip address and port.
Add a new service to the server. Select the wiki service in the definition form and give it a name. Add a condition to the service if you want more than one service per server . In this example the service is configured using a pattern where the service is used if the requested host is www.mydomain.com
Now start and stop the server to apply the changes. Once tested save the configuration as xapp-server-data.xml in the server. Stop the Metro Configuration Tool and restart the server using run-as-service.cmd
You can set up OpenForum as a Windows service by following the procedure here