Kunagi is a Java web application. You can deploy it to your favourite web application server on your favourite operating system, running Java 6. For the majority of servers, all you have to do, is to copy the current
kunagi.war to the
Installation on Ubuntu
Download the debian package
kunagi.deb package from kunagi.org/download.html and install it.
For german users, there is an article on ubuntuusers.de.
Installation on Windows
kunagiXX.exe starter from kunagi.org/download.html and run it. It will download the latest Kunagi web application and start it with an embedded Tomcat.
Installation with Tomcat
If you don't have a web application server yet, here is an example, how to install Kunagi with Apache Tomcat.
- Install Sun Java 6 and verify by executing the command
- Make sure that an environment variable
JRE_HOME(in case of Java JRE) or
JAVA_HOME(in case of SDK) is set to the Java installation path.
- Download Tomcat from tomcat.apache.org .
- Extract the downloaded Tomcat archive.
- Download Kunagi from kunagi.org/download.html and copy the
.warfile to the
webappsdirectory of your Tomcat.
- Make sure, the working directory or the home direcotry of the user, which is running Tomcat is writable for him.
- Start Tomcat by executing the
startup.sh(Linux) script from the
- Check Tomcat and Kunagi log file
By default, Tomcat listens on port 8080. So you can access Kunagi by opening http://localhost:8080/kunagi/.
Depending on your operating system or distribution, some of the steps might be unnecessary if Tomcat is installed via an installation wizard (Windows) or software repositories (Linux).
Ubuntu users can just download the new
.deb package and install it.
Windows users who are using the
kunagi.exe starter will get the new version automatically.
- Stop your web application server (Tomcat).
- Backup the data directory.
- Replace the old
kunagi.warwith the new one.
- Start your web application server.
Kunagi stores all data as XML files in the data directory
kunagi-data. The full path is shown on startup in the logs and on the Administration -> System configuration page in Kunagi.
To create a backup, copy, zip or rsync the data directory.
To restore a backup, replace the contents in the data directory with your backup contents.
Generating websites for projects
Kunagi can help you create websites for projects. It uses Velocity templates to generate the pages.
- Create a website directory on the same server, where Kunagi is installed and set up your web server to serve this directory.
- Give the user, who is running the Kunagi web application server write permissions to this directory.
- Set the path to the website directory in Kunagi, Administration -> Project administration -> Homepage -> Homepage directory.
- Create a subdirectory called
velocityinside of the website directory and put your Velocity templates there.
Every file inside the
velocity subdirectory, which ends with
.vm will be interpreted as a template. Kunagi reads this template, merges it with the project data and writes it back directly to the website directory into a file named the same as the template, but without the
.vm suffix. There are some special cases for entity templates like
sto.vm. These are processed not once, but for every entity. By creating the
VM_global_library.vm template file, you can define macros and reuse them in all other templates.