Multiple Wikis

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"
                     override="false"/>
     </Context>

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.