Installation

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

        
          $> java -jar kiskis-installer.jar
        
      

After that you need to follow the instructions. The installer provides all libraries needed and will create start links in the start menu if you want to.

Note

You will find a zip-file in the Download chapter as well which requires no installation. This zip-file can be unpacked to any USB-stick or directory.

Go to the destination directory and start the application with one of the start-scripts provided (Windows: kiskis.bat , *ix: kiskis.sh ).

Runtime Dependencies

For running KisKis™ you have to make sure, that the following libraries are available within your CLASSPATH . The installer and zip files contain all libraries needed. You need to install a Java Runtime Environment.

KisKis™ is using:

How to install Java Cryptography Extension

TODO

Running KisKis

Go to the KisKis™ installation directory and start the program with the following commands

          $> <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>]
        

Note

<lib/*.jar> has to be replaced with a sequence of JAR-files found in the lib -directory.

Command line options

Table 1. Command line options

OptionsDescription
-helpshows the options supported.
-file <datafile>open <datafile> immediately.
-lastFileopen the most recently used file.
-hidehide in system tray at startup.
-resetdelete all stored user preferences and exit (window positions and sizes, recently used files, default-look-and-feel, ...).
-validateactivate XML-validation for debugging.
-selftestAll encryption algorithms will be checked for correct functionality.


Building from source

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

  • Apache Ant 1.7 or equivalent, http://ant.apache.org

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

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

Once installed you only have to type

          $> ant create-dist
        

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

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

          $> svn co
            https://kiskis.svn.sourceforge.net/svnroot/kiskis/kiskis-application/trunk