SRC Demo Application Installation Guide

Basic Installation

Java Requirements

Make sure the Java Development Kit, version 1.5.0 or higher, is installed on your system. You will need the JDK instead of the JRE, because it contains security tools and packages integral to the application.

SRC Demo Application

Download the most recent version of the SRC Demo Application Installer. You can find it from the downloads page:

http://www.sharedrecords.org/download

The installer comes in two forms - an ISO image that can be burned to a cd, and a zip file containing the contents of the installer.

When installing from a cd the installer should run automatically. When using the zip file, extract the contents to a local directory and run "SharedRecordsInstaller.exe". You will be asked for an installation directory and to create a "keystore" password. This is the administrator password that will later be used by the demo application.

NOTE 1: If not installing from a cd, or if you want to run the application with the cd removed, copy the private.key and public.key files into your local C: directory.

NOTE 2: If you change the default install directory you MUST manually change the [INSTALL_DIR]/etc/org.sharedrecords.properties file to reflect the change or the application may not run. This is a known issue.

The installer will create a default directory structure, including the local keystore. If you want to move the keystore or otherwise change the configuration, make sure you edit the file INSTALL_DIR/etc/org.sharedrecords.properties to reflect the new setup.

Troubleshooting the keystore

The demo application uses a password protected keystore. This needs to be initialized before the application can run.

If the keystore was not successfully created during installation, make sure that you have the Sun security packages installed (It comes with the JDK, but you can also download the sunjce from  http://java.sun.com ) and that keytool.exe is on your path. On a Windows system, click 'Start'->'Control Panel' and double click System. Open the Advanced Tab and click the button that says Environment Variables. Under System Variables, select Path and click Edit. In the variable value text field, add <jre home>/bin. On a typical Windows XP computer, the location of the JRE home directory is something like C:\Program Files\Java\jre<version number>.

Go to INSTALL_DIR/bin/localkeystore/ and run keystoreinit.bat. You will be prompted to create the keystore password.

Running the Demo Application

You should now be able to run the application. If you allowed the installer to create shortcuts to the applcation on your desktop and/or in your StartBar, you can find them there. Otherwise, run launch.bat in the installation directory.

Working with the Demo Application Source Code

Please consult Working with the Demo Source Code.