X-Git-Url: https://code.wpia.club/?a=blobdiff_plain;f=doc%2FbeforeYouStart.txt;h=1b9e7ff854a7bd2b7abb7ba7f23f27a8b8fa47c0;hb=b1b6ee219140ff4ca4c3e3dfcb1d17dd3f653e17;hp=62f4d6fa168a8b6e751c1eb4cc83b378a59a6be6;hpb=e969380aab23b46ffeac543a8fb4fa37db0222d5;p=gigi.git

diff --git a/doc/beforeYouStart.txt b/doc/beforeYouStart.txt
index 62f4d6fa..1b9e7ff8 100644
--- a/doc/beforeYouStart.txt
+++ b/doc/beforeYouStart.txt
@@ -1,9 +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/ 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)
 
-- download locales (util/ org.cacert.gigi.util.FetchLocales)
-- write your sql connection properties: config/sql.properties.template -> config/sql.properties
 - 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