src/wikipages/MultipleWikis.txt

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.