From 064d0662ebac989091c087b31c1e757a5152cf0b Mon Sep 17 00:00:00 2001
From: tcarver <tjc>
Date: Tue, 8 Apr 2014 14:39:09 +0100
Subject: [PATCH] add documentation for creating signed jar and running tests
---
INSTALL | 47 ++++++++++++++++++++++++++++++++++++++++++-----
1 file changed, 42 insertions(+), 5 deletions(-)
diff --git a/INSTALL b/INSTALL
index 02404781e..9994e6d76 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,11 +1,10 @@
Installation instructions for UNIX
+==================================
1. change to /some/directory
-
2. uncompress and untar the artemis_compiled.tar.gz file
- On UNIX the command is: gzip -d < artemis_compiled.tar.gz | tar xf -
-
+ On UNIX the command is: tar xzvf artemis_compiled.tar.gz
This will create a "artemis" directory containing all the java classes. On
Unix the easiest way to run the program is to run the script called art in the
@@ -18,7 +17,8 @@ menus. From the File menu you can open a flat file containing an
entry. If it reads the entry successfully a new window will open,
which shows the sequence and features for the entry.
-====================================================================
+Download and Install from GitHub
+================================
Installation instructions for GitHub download
@@ -30,4 +30,41 @@ Installation instructions for GitHub download
3. Run Artemis:
./art
or ACT:
- ./act
\ No newline at end of file
+ ./act
+
+Makefile targets
+================
+
+make - compile code
+make jar - create an Artemis and ACT jar file in jar_build directory
+make dist - create a tar ball of the Artemis/ACT distribution
+
+Creating signed jar files for Artemis/ACT Java Web Start launch
+===============================================================
+
+Use 'make jar' to create jar_build/artemis.jar. See the following pages
+for a description of deploying and signing jar files:
+
+http://java.sun.com/docs/books/tutorial/deployment/webstart/deploying.html
+http://java.sun.com/docs/books/tutorial/deployment/jar/signing.html
+
+Use the Java keytool to generate a keystore (artemisstore) file:
+
+keytool -genkey -alias signFiles -dname "CN=$NAME, \
+ OU=$ORGU, O=$ORG, L=$LOC, S=$STATE, C=$CODE" \
+ -keypass $KEYPASS -storepass $STOREPASS -keystore artemisstore -validity $VALID
+
+The following cab be used view the key store and list the details:
+
+keytool -list -v -keystore artemisstore
+
+Then use that to create the signed jar that you point your JNLP to :
+
+jarsigner -keystore artemisstore -storepass $STOREPASS -keypass $KEYPASS \
+ -signedjar sartemis.jar artemis.jar signFiles
+
+Running the test suite
+======================
+
+cd test
+ant -f build-test.xml
--
GitLab