This is how the JSPWiki is installed and configured at Aformatik. (http://www.aformatik.de/OpenSourceWiki/Wiki.jsp) Here are all the questions we came up with and their decisions. We think it could be usefull for beginners and advanced users could give their hints here.

Also this is a protocoll for us at Aformatik how we installed the JSPWiki and why we did it this way.

We did a default installation with the last stable version and it worked fine. But shortly after this we came up with some individual wishes. We decide to install it new and configure it well.

Before editing we copy the original version of the file as backup.

Which version should we use?#

We will use the newest version. For later upgrading see: UpgradingJSPWiki

• Pro: We want some individual settings which will use newer featuers or which will came up with them. Silly enchancing old code.
• Contra: Wiki might have problems and would not be stable.

We don't have much traffic on our wiki at the beginning. Later we are sure to get the wiki stable. We get good help at IrcChannel.

build the new version#

1. Get the newest nightly build

2. copy build.properties.win to build.properties.mine (you could change the properties, we let them and change the jspwiki.properties at the end)
otherwise build failed: ... JSPWiki-020404-cvs.tgz\JSPWiki\build.properties.mine) not found.

3. put the j2ee.jar in the classpath.
otherwise build failed: compile failed: javax.servlet classes are missing

4. build it with Ant. (add the war option, see JSPWikiDownload)

Properties#

Editing the jspwiki.properties. (Before this copying the original file as backup.)

jspwiki.applicationName = OpenSourceWiki#

Set your name here. Like awnsering the question what is on your wiki, not how is it implemented.

jspwiki.pageProvider = VersioningFileProvider#

We hope version of pages are shown in the directory. Maybe PageDeletion is easier.

jspwiki.fileSystemProvider.pageDir = C:\\OpenSourceWiki\\data#

see Placing pageDir below WEB-INF in StupidQuestions
see jspwiki.applicationName

jspwiki.basicAttachmentProvider.storageDir#

We will use the same as pageDir.

log4j.appender.FileLog.File = C:\\OpenSourceWiki\\jspwiki.log#

log4j was in the cvs allready
see jspwiki.applicationName

jspwiki.breakTitleWithSpaces = true#

nicer reading from titles. see also CanWeDisplaySplitPageName

jspwiki.specialPage#

fixing content of pages?

jspwiki.interWikiRef#

Rename WikiWikiWeb to C2-Wiki. We already call it C2-Wiki. 
There was once a WikiWikiWeb out there and the url leads to somewhere else.

#  JINX-Wiki a wiki for java
#  maybe some pages go wrong, because they are numbered in SWiki and the 
#  title matching could fail
jspwiki.interWikiRef.JINX-Swiki = http://jinx.swiki.net/%s

# insert others like java.net, javasource.org, sun java api for classes