Wiki configuration#

The least painful approach to defining the location of your Wiki files is to have them located at the same drive as your Tomcat (or other web server) installation, and define the location in Unix format. For example, files in C:\JSPWiki\files are defined in the configuration file as /JSPWiki/files.

Also make sure to change the setting for log4j.appender.FileLog.File in if you want a log-file to be created. This setting is hidden quite well near the end of the config-file. The format is the same as the jspwiki.fileSystemProvider.pageDir-setting, i.e. backslashes must be duplicated.

Unpacking a .war file#

The JSP Wiki web application files are distributed in a .war file. To unpack this file, change the file extension from .war to .zip then unzip the file using a windows utility.

Resetting a Password#

After running the Install.jsp page, an administrator account will be created with a username of 'admin' and a random password if want to access the 'admin' account or access any other account without the password, you can reset the password.

Passwords are generally stored only as an encrypted hash so they can't be easily recovered, only reset. To reset a password, create a new dummy username and password in the usual way, open the userdatabase.xml file that resides in the WEB-INF directory and copy the password hash from the dummy username and paste it over the password hash that you want to reset.

In windows you may have to change the security settings of the .xml file so you have permission to write to it.

Installing the core pages#

The core pages are distributed in a file with a name like '' and this file should be copied into the content folder. The address of the contect folder can be found in the file and will be defined in a line similar to the following.

jspwiki.fileSystemProvider.pageDir =/p/web/www-data/1000c/
When these 'core files' are present, the wiki should have some basic content such as wiki etiquette, help files etc.

Version control#

If you need RCS-based version control for your JSPWiki installation on a Windows machine, download the implementation from You only need the executables in the win32 directory of the

The RCS executables will not work unless you set:

  • PATH environment variable to point to the location of the executables
  • TZ environment variable to a value suitable for your locale (this value must be set; I have failed to get it working properly, though).
  • You also may need to set the LOGNAME environment variable; see JSPWikiOnWindows for more details.

Version control alternative#

You might also want to try out the VersioningFileProvider, which provides versioning without RCS. It has not been tested as extensively as RCSFileProvider, but it's quite a lot easier to set up.

Some potential issues:

  • JAVA_HOME must point to the sdk, not the jre.
  • In the properties file make sure your path names use double back slashes; alternatively you can replace them with single forward slashes
  • Make sure there are no trailing spaces at the ends of lines containing a path or class name.
  • In the properties file make sure your URL contains the port number. For example, enter something like http://localhost:8080.
  • Create the data directory specified in the properties file. It doesn't seem to be automatically created.
  • Resin ( is easier to install and much faster than Tomcat.

How To Link Tomcat 5 with IIS 6 on Windows 2003 Server using the JK2 ajp13 connector#

Comprehensive illustrated guide at

Further notes!#

See InstallAtAformatik and WindowsInstallQuestion for an example and more information.

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-49) was last changed on 12-May-2011 17:31 by Ben