Installation

KisKis comes with a simple installation routine. Download the file kiskis-installer.jar and run

$> java -jar kiskis-installer.jar

After that you have just to follow the instructions. The installer provides all libraries needed. After this installation goto the destination directory and start the application with one of the start-scripts provided (Windows: kiskis.bat, *ix: kiskis.sh).

If you want to use the system-tray feature, you have to install SWT on your machine.

Runtime Dependencies

For running KisKis you have to make sure, that the following libraries are available within your CLASSPATH.

KisKis is using:

  1. Java Runtime 1.5 or equivalent with Java Cryptography Extension (JCE), Java 6 is recommended, http://java.sun.com/j2se/6/download.html

  2. Legion Of The Bouncy Castle Crypto API 1.25 or later, http://www.bouncycastle.org (you need the provider- and the OpenPGP-library)

  1. xom 1.1 or later, http://www.xom.org

  2. Kunststoff Look&Feel 2.0.2, http://www.incors.org/archive/

  3. Java-based Cracklib-implementation 0.5 from http://sourceforge.net/projects/solinger/

Building from source

KisKis can be compiled easily from source using Ant. Therefore you have to install the following libraries and tools:

  1. Apache Ant 1.6 or equivalent, http://ant.apache.org

  2. JUnit 4 or equivalent, http://www.junit.org

  3. Apache Log4J 1.2.8 or equivalent, http://logging.apache.org/log4j/docs

Once installed you only have to type

$> ant dist

in the project root directory. Then the binary-jars are build in the dist/-directory.

You can obtain the code and libraries from the CVS at sourceforge.net:

$> cvs -d \

pserver: anonymous@cvs.sourceforge.net :/cvsroot/kiskis \

login

$> cvs -z3 -d:\

pserver: anonymous@cvs.sourceforge.net :/cvsroot/kiskis \

checkout default

Running KisKis

If you have not used the installer, copy the content of the dist/- and lib/-directory in a directory of your choice with the start-scripts you need.

After that you can start the program with

$> <start-script-name> [-file <datafile>]

or

$> java -jar kiskis.jar [-file <datafile>]

or

$> java -classpath kiskis.jar:<lib/*.jar> de.tbuchloh.kiskis.KisKis \

[-file <datafile>]

<lib/*.jar> has to be replaced with a sequence of JAR-files found in the lib-directory. This can be omitted if you have copied this libraries into JRE_HOME/lib/ext. But this is NOT recommended!

Note: The System-Tray-Feature is only available when using the start-scripts!

Command-line options

Command-line options

Options

Description

-help

shows the supported options.

-file <datafile>

open <datafile> immediately

-lastFile

opens the most recently used file

-hide

hide in system tray at startup

-reset

delete all stored user preferences

(window positions and sizes, recently used files, default-look-and-feel, ...)

-validate

turn on XML-validation