Installation of Groowiki

Groowiki 1.1.0 Community Edition is delivered as a war file. You should install it as you would do with any other web application that is delivered in a web archive file. There is detailed description in the Users' Guide how to install Groowiki under Tomcat 5.5

After you have installed Groowiki you have to configure it before starting. There is a configuration file in the war file named WEB-INF/classes/config.xml. Using this file you should configure where the configuration files are. This provides very flexible configuration management provided by the Apache Commons Config configuration handler library Groowiki uses. Looking at the current version you see that Groowiki was developed on a Windows box where I stored the configuration files in a directory D:/PROJECTS/research/groowiki/src/main/resources/.

It is recommended that you make a copy of the files groowiki.xml and mimeTypes.xml and modify config.xml in the war file to point to your local copies. This way you will be able to keep your local configuration after an upgrade.

The most important part of the configuration defines the URL of the repository that Groowiki will connect to and the code page that the repository uses. It is important to set this because other SVN clients (like tortoise) may not be configurable and may display funny properties if groowiki uses utf-8.

<repository>
  <url>file:///research/svntestrepo$lt;/url>
  <charset>ISO-8859-2</charset>
</repository>
                

Note that these configuration keys were changed from version 1.0.1 to 1.1.0

You also have to configure where your templates are:

            

<velocity>
    <templates>
        <root>/main/resources/templates/</root>
    </templates>
<velocity>
                

The basic set of templates are in the war file. You can copy them to a separate directory and configure here the location. This way you may easily keep the locally modified templates after an upgrade.

In addition to this you should configure the log4j logging system before starting Groowiki.

The rest of the configuration is generally OK for all installations and some of the keys are for later later releases of Groowiki.

Detailed information on configuration can be found in the Users' Guide.