Sometimes you want to run multiple Wiki instances, for example one for each project you're managing. The projects have different members and different requirements; perhaps even different access rules.

Here's how you set up multiple wiki-instances:

Let us say that your main wiki instance is called ~GobbleWiki, because your company is called "Gobble Inc", and this is your intranet. You are using Tomcat, and you have installed it in /opt/tomcat. You have already set up the ~GobbleWiki directory, and customized your jspwiki.properties.

Now, you have a new project called "Zorp", and you want to establish a "~ZorpWiki" for it. Do as follows:

Put the following in the /opt/tomcat/conf/server.xml file, within your <Host> -section.

     <Context path="/ZorpWiki" docBase="GobbleWiki.war" debug="0">
          <Parameter name="jspwiki.propertyfile" value="/opt/tomcat/conf/ZorpWiki.properties"

Take a copy of the GobbleWiki/WEB-INF/jspwiki.properties -file, and put it in /opt/tomcat/conf/ZorpWiki.properties. Then edit it at will. You definitely want to change the following properties (at least):

  • jspwiki.applicationName
  • jspwiki.fileSystemProvider.pageDir (or whichever provider you're using)
  • jspwiki.basicAttachmentProvider.storageDir (or whichever provider you're using)
  • jspwiki.baseURL
  • log4j.appender.~FileLog.File (if you're using log4j file logger)

Restart Tomcat.

Upgrading to new version of JSPWiki#

Just drop the new "JSPWiki.war" into place as "~GobbleWiki.war". The ~ZorpWiki should then be automatically able to pick it up.


More Information#

There might be more information for this subject on one of the following: ...nobody