Skip to end of banner
Go to start of banner

Installing KIWI 4.0

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

Besides KIWI 4.0 itself, there are also two dependencies, two complementary apps that are installed with it:

  • katl-commons – a library having countless utility routines, but most importantly, it contains a SIL language parser. You can think of the katl-commons as SIL engine for your SIL powered apps
  • warden – licensing support for several our apps

Installing via Atlassian Universal Plugin Manager

If you are connected to the Atlassian Marketplace website from your Jira administration console, you can install our apps directly from the Marketplace. For more information, see Installing add-ons and Universal Plugin Manager pages.

  1. Log into your Jira as Admin.
  2. In the cog wheel menu, go to Add-ons.
  3. In the search field of the Find new add-ons section, search for "KIWI".

This installation method is the quickest way. You can also install by file upload, as described in the next section.

Installing by file upload

It might seem more complicated but a manual install is quite easy to do. After all, all you have to do is to copy certain files. Here's how.

  1. Download the KIWI file from the Atlassian Marketplace.
  2. Log into your Jira as Admin.
  3. From Jira administration console, click the Manage add-ons link.
  4. Click Upload add-on and select the file you downloaded, and click Upload.
  5. [Optional, but highly recommended]: If not already done, enable logging on our modules. Open with a text editor of your choice the Jira log4j configuration file JIRA_INSTALL_DIR/atlassian-jira/WEB-INF/classes/log4j.properties and add these 2 lines at the end of it. Restart Jira.
log4j.logger.com.keplerrominfo=INFO, filelog
log4j.additivity.com.keplerrominfo=false

Good practice

If you are already using a previous version of this app and you are installing a new one, clear the cache of your browser after the installation to avoid errors due to the javascript changes.


What should I do if I installed an incompatible version?

KIWI 4.0 is only compatible with Jira 7.0; JDK version should be at level 8.

If you have installed an incompatible version, perform the following steps:

  1. Uninstall warden.
  2. Uninstall katl-commons.
  3. Uninstall KIWI.

  4. Install a version of KIWI that is compatible with your Jira version.
    katl-commons and warden should now have the right versions as well.

After you uninstall katl-commons and warden, some apps may remain disabled, so you may need to re-enable them manually.


What's next

After you install the app, see User Guide for details on how to use it.


  • No labels