Merge "upd: remove 'browser install'"

[gigi.git] / doc / beforeYouStart.txt

diff --git a/doc/beforeYouStart.txt b/doc/beforeYouStart.txt
index bfa3f39e591dc4b464f84593977c9a166c19ade2..1b9e7ff854a7bd2b7abb7ba7f23f27a8b8fa47c0 100644 (file)
--- a/doc/beforeYouStart.txt
+++ b/doc/beforeYouStart.txt
@@ -1,12 +1,22 @@
 Before you start using you might want to:
 
-- create a keypair for the server (scripts/generateKeys.sh)
-- create a truststore for the server (scripts/generateTruststore.sh)
+- use wpia-nre to generate a roots structure
+- extract the gigi-*.tar.gz file into "config"
+- execute "generateTruststore.sh" there
+- extract the signer-server-*.tar.gz into "signer"
 
-- download locales (util/ org.cacert.gigi.util.FetchLocales)
+- download locales (util/ club.wpia.gigi.util.FetchLocales)
 - write your sql connection properties: config/gigi.properties.template -> config/gigi.properties
+- install "hosts" entries for the hosts you entered in "gigi.properties"
+   (be aware if you change the default ones you need to change the CN given in the certificates)
+
 - add the corresponding jdbc connector to your path.
 
 - on unix-like systems: to securely run on privileged ports <= 1024 build the native setuid library (run the makefile in natives/).
   This expects JAVA_HOME to be set.
 
+For local testing you should:
+- start util-testing/club/wpia/gigi/DevelLauncher.java and util-testing/club/wpia/gigi/util/SimpleSigner.java
+- use the doc/sampleData.sql.template to create a doc/sampleData.sql file with a testing user.
+  If you start the local test environment with util-testing/club/wpia/gigi/DevelLauncher.java, this user is automatically logged into the system via ticket bypass.
+- in the case while starting the application a database error occurs use util-testing/club/wpia/gigi/util/DatabaseManager.java to adjust the database to the current requirements