Configuring Web Server#

First install a web server such as Tomcat 6.0 and Java JDK 1.6.

Test that the webserver is working ok by opening one of the sample applications that ship with Tomcat. To do this, you will need to Run Tomcat as a 'service', then enter a URL in a browser window similar to 'http://localhost:8080/examples/jsp/chat/login.jsp' Note the first part of the URL 'http://localhost:8080/' directs the browser to the 'webapps' directory where Tomcat stores its web application files.

When you've confirmed the webserver is working ok you can install a wiki.

Stage 1. Download the files.
#

1.1 Download the 'JSPWiki-2.8.4bin.zip' file and save it in a temporary directory.
1.2 Unzip the 'JSPWiki-2.8.4bin.zip' file and it will create a directory called JSPWiki which contains all required files.
1.3 Locate the file 'JSPWiki.war' in the directory JSPWiki and rename the file to 'JSPWiki.zip'. This file contains all the executable JSP and jar files and is essentialy the application without any user generated content.

Stage 2. Set up your application directory
#

2.1 Create a folder inside the Tomcat 'webapps' folder with the name of your application 'JSPwiki' is the default, but you call it anything meaningful eg 'myWikiJSP_ApplicationFiles'. Note, this folder should be located directly in the webapps folder and not in a subfolder otherwise some of the JSP pages won't work.
2.2 Copy the file JSPWiki.zip into the folder you just created to hold your application files and unzip it here.

Stage 3 - set up your wiki content directory
#

3.1 Create a directory somewhere for your content. This can be anywhere on your computer and doesn't have to be in the webapps directory. You could call it 'C:\wikiContent' or some other meaningful name.
3.2 Find the corepages zip file in your prefered language (e.g. 'JSPcorepages-en.zip') and unzip it into the content directory you just created.

Stage 4 - run the Install.jsp utility
#

4.1 Stop Tomcat and restart it (this will clear any assigned variables).
4.2 Open a browser and enter the URL of the Install utility eg 'http://localhost/JSPWiki/Install.jsp' or if you called your application folder 'myWikiJSP_ApplicationFiles', the URL will be 'http://localhost/myWikiJSP_ApplicationFiles/Install.jsp'

Note, you can only run the install utility once. It cannot be run twice for security reasons. If you get something wrong you can fix it by editing the 'jspwiki.properties' file which is located in the 'WEB-INF' folder in your application folder. Alternatively you can delete the application folder and start the over from step 2.

Stage 5 - run the wiki application
#

5.1 Stop Tomcat and restart it.
5.2 Open a browser and enter the URL of the main page eg 'http://localhost:8080/JSPWiki/' or if you called your application folder 'myWikiJSP_ApplicationFiles' then the URL will be 'http://localhost:8080/myWikiJSP_ApplicationFiles/'