Wiki Server README

Getting started with WikiServer

When you unzip the WikiServer distribution, you should have the following directory structure:


  [root directory]

  :-WikiServer.exe

  :

  :-ReadMe.html (this)

  :

  :-Pages/

    :

    :-StartPage.wik

    :

    :-.wik

If this is in place, simply double-click the WikiServer.exe icon to run the server.

Direct your browser of choice to http://localhost and read on ...

If this doesn't work, or doesn't appear to work, see Troubleshooting below.

Specific instructions for the WikiServer executable can be found at http://localhost/LocalWikiAdmin

Enjoy! -- Eddie Edwards

Initialization

The wikiserver.ini file contains initialization settings for WxWikiServer. Look inside the file for details.

NOTE: The first thing you need to do when you start up wikiserver is to set the Hostname flag in config.wkc.
Go to AdminLogin, type in admin as the username, and password as the password.
Next, go to the first option "Edit Basic Configuration settings".
Now enter the following line in the text box:
Hostname=[host]
where [host] is the hostname of your site. If you don't know what that means, or you don't have a hostname, type in localhost:[port] where [port] is the port you started the server at (see wikiserver.ini).

Online documentation

Most of the documentation for wikiserver is online. Just run the wikiserver and go to WikiWikiInfo (You'll see it in the start page).

Troubleshooting

A few things to note about WikiServer:

WikiServer attaches to port 80 (HTTP) by default. If you are running another webserver on port 80, WikiServer will fail to start. This can be fixed using the -p
option: e.g.
```
WikiServer -p81
```
runs the server on port 81. You then attach to it using the URL
```
http://localhost:81
```
WikiServer is a console application. Therefore, by default, it opens a console window when you double-click on the icon. If you close this window, you shut WikiServer down. If you don't like the window, use the -c option: e.g.
```
WikiServer -c
```
WikiServer is a TCP/IP application. If you run WikiServer while online, others can access your Wiki. This is not generally a big deal. They cannot access any files not in the Pages directory. There are no known exploits for WikiServer. This does not make WikiServer "secure" in any way. I make no guarantees. If you are at all concerned about hackers, script kiddies or just plain vandals then do not run WikiServer when your machine is online. WikiServer can however be run safely behind a firewall, for instance within an office intranet environment. Check with your netadmin that local servers on port 80 are blocked from external access.

You can check to see if you have a webserver running on port 80 by opening your browser without WikiServer running and going to http://localhost. If a page comes up, you're running a web server. It is possible, given Microsoft's default security policies, that you are running a webserver and don't even know it.