Keeper of Secrets Files

KoS should in theory run in any servlet container with any DBMS. In practise I have only tested it with Tomcat 6 and PostgreSQL 8 and 9 so far.

With Tomcat I recommend placing the kos.war file somewhere other than the webapps directory. You will need to specify a context XML and place it (kos.xml) in $CATALINA_HOME/conf/Catalina/localhost in order to configure your database, like in the example below:

<Context path="/kos" docBase="/PATH/TO/FILE/kos.war">
	<Resource name="jdbc/kos" type="javax.sql.DataSource"
		auth="Container" username="YOURUSER" password="YOURPWD"
		driverClassName="org.postgresql.Driver"
		url="jdbc:postgresql://localhost/kos"
		maxActive="8" maxIdle="4" maxWait="10000" />
</Context>

You need to create the database yourself and place the PostgreSQL JDBC driver (or driver for whatever DBMS you use) in Tomcat's lib directory. The database tables will be created automatically on startup if you have set up everything correctly. If you use a DBMS other than PostgreSQL, you will also need to modify Hibernate's dialect setting (found in kos.war!/WEB-INF/lib/kos-dao-0.4.jar!/application-ds.xml) accordingly.

KoS uses Java's builtin cryptography to encrypt passwords. The key lengths of the ciphers provided by Java are by default limited (at least in Oracle's JRE they are). You might want to search for and download JCE Unlimited Strength Policy Files to lift these limitations, if doing so is legal in your country.

That's all the user docs for the 0.4 release. I will try and create more extensive documentation for 0.5, but now it's time to go to bed. Good night!