Doku deve/install im APT-Format statt xdoc

1 files changed, 174 insertions, 0 deletions

diff --git a/src/site/apt/devel-install.apt b/src/site/apt/devel-install.apt
new file mode 100644
index 0000000..01c4ae1
--- /dev/null
+++ b/src/site/apt/devel-install.apt
@@ -0,0 +1,174 @@
+            ------
+        Installation Guide
+            ------
+          Yves Fischer
+            ------
+          05.04.2011
+
+Installation
+
+* Mit Embedded Servlet Container
+  
+  <<<mvn jetty:run>>>
+
+  Standardmäßig lauscht jetty nun auf Port 8080
+
+* Mit Web-Archive (.war)
+
+  Ein Web-Archive kann mit dem Maven Kommando <<<mvn package>>> gebaut werden.
+
+
+Installation unter SLES 11.1
+
+* Vorbereitung
+
+  Es muss ein halbwegs aktuelles Java-JDK installiert sein, dieses
+kann z.B. von {{{http://java.sun.com}}Oracle}} für Linux/i386 bezogen
+werden.
+
+  Für die Ausführung von dhbw-calendar wird ein neuer Benutzer,
+z.B. mit namen <<<dhbwcalendar>>> angelegt.
+
+  {{{http://maven.apache.org}Maven2}} in
+<<<$HOME/share/apache-maven-2.2.1>>> installiert.
+
+  Für den angelegten Benutzer wird in seiner
+<<<$HOME/.profile>>>-Datei die Umgebungsvariablen <<<JAVA_HOME>>> und
+<<<M2_HOME>>> auf die jeweiligen Installationspfade gesetzt.
+
+  Git kann mit dem SuSe-Tool <<<zypper>>> installiert werden:
+
+---------------------------
+# zypper ar \
+  "http://download.opensuse.org/repositories/devel:/tools:/scm/SLE_11/devel:tools:scm.repo"
+# zypper install git
+---------------------------
+
+
+* Einrichtung
+
+  Das Projektverzeichnis wird mit git geklont:
+
+---------------------------------
+# su -l dhbwcalendar
+$ git clone ....dhbw-calendar URL...
+---------------------------------
+
+  Falls jetty verwendet wird und er im produktiven Setup nur auf dem Loopback
+Interface lauschen soll wird das in der <<<pom.xml>>> konfiguriert:
+
+--------------------------------------
+<connectors>
+  <connector
+      implementation="org.mortbay.jetty.nio.SelectChannelConnector">
+    <port>8080</port>
+    <host>127.0.0.1</host>
+  </connector>
+</connectors>
+--------------------------------------
+
+  Bei vaadin wird der <productionmode> im Deskriptor der Web-Applikation
+aktiviert:
+
+---------------------------
+<context-param>
+  <param-name>productionMode</param-name>
+  <param-value>true</param-value>
+  <description>Vaadin production mode</description>
+</context-param>
+---------------------------
+
+* SSL
+
+** Zertifikat erstellen
+
+  <Achtung:> Vor- Nachname ist der Common-Name = Hostname.
+
+---------------------------------------
+% keytool -keystore keystore -alias jetty -genkey -keyalg RSA
+Geben Sie das Keystore-Passwort ein:
+Geben Sie das Passwort erneut ein:
+
+Wie lautet Ihr Vor- und Nachname?
+[Unknown]: dualical.ba-horb.de
+Wie lautet der Name Ihrer organisatorischen Einheit?
+[Unknown]: DHBW Stuttgart Campus Horb
+Wie lautet der Name Ihrer Organisation?
+[Unknown]: Duale Hochschule Baden-Württemberg
+Wie lautet der Name Ihrer Stadt oder Gemeinde?
+[Unknown]: Horb
+Wie lautet der Name Ihres Bundeslandes oder Ihrer Provinz?
+[Unknown]: Baden-Württemberg
+Wie lautet der Landescode (zwei	Buchstaben) für	diese Einheit?
+[Unknown]: DE
+Ist CN=DHBW Calendar,OU=DHBW Stuttgart Campus Horb, O=Duale Hochschule Baden-Württemberg, L=Horb, ST=Baden-Württemberg,	C=DE richtig?
+[Nein]: Ja
+Geben Sie das Passwort für "jetty" ein.
+(EINGABETASTE, wenn Passwort dasselbe wie für Keystore):
+---------------------------------------
+
+** SSL in Jetty konfigurieren
+
+----------------------------------------------
+<configuration>
+  <connectors>
+    <connector
+        implementation="org.mortbay.jetty.nio.SelectChannelConnector">
+      <port>8080</port>
+    </connector>
+
+    <connector
+        implementation="org.mortbay.jetty.ssl.SslSelectChannelConnector">
+      <port>8443</port>
+      <keystore>${basedir}/server.keystore</keystore>
+      <keyPassword>bla</keyPassword>
+      <password>bla</password>
+    </connector>
+  </connectors>
+</configuration>
+<dependencies>
+  <dependency>
+    <groupId>org.mortbay.jetty</groupId>
+    <artifactId>jetty-ssl</artifactId>
+    <version>7.0.0.pre5</version>
+  </dependency>
+</dependencies> 
+-----------------------------------------------
+
+** Zertifikationsinfos
+
+  SSL-Fingerprint:
+
+--------------------------------
+
+% keytool -list -keystore server.keystore -rfc
+Geben Sie das Keystore-Passwort ein:
+Keystore-Typ: JKS
+Keystore-Provider: SUN
+
+Ihr Keystore enthält 1 Eintrag/-äge.
+
+jetty, 29.03.2011, PrivateKeyEntry, Zertifikatsfingerabdruck (MD5):
+B6:CA:AF:1C:8C:B7:38:38:36:2A:30:3C:A5:C2:54:20
+
+  -----BEGIN CERTIFICATE-----
+.... /Zertifikat im PEM Format/
+  -----END CERTIFICATE-----				
+--------------------------------
+
+  Die Verbindung kann jetzt mit wget überprüft werden
+
+--------------------------------
+# wget --ca-certificate=certificate.pem \
+      https://dualical.ba-horb.de:8443/dhbwcalendar/
+--------------------------------
+				
+  Weitere Informationen zum Zertifikat zeigt OpenSSL in Klartext an:
+
+--------------------------------
+# openssl x509 -noout -text -in certificate.pem
+--------------------------------
+				
+* Zugriff von 'aussen'
+
+  Mit php und curl lässt sich eine reverse-Proxy nachahmen. Ein Beispiel findet sich unter: {{{./ics.php.txt}ics.php.txt}}.
\ No newline at end of file