diff options
Diffstat (limited to 'devel-install.html')
| -rw-r--r-- | devel-install.html | 274 |
1 files changed, 69 insertions, 205 deletions
diff --git a/devel-install.html b/devel-install.html index f840564..21e5157 100644 --- a/devel-install.html +++ b/devel-install.html @@ -1,10 +1,9 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Mar 29, 2011 -->
+<!-- Generated by Apache Maven Doxia at Apr 12, 2011 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <title>DHBW Calendar - - Installation Guide</title>
+ <title>DHBW Calendar - Installation Guide</title>
<style type="text/css" media="all">
@import url("./css/maven-base.css");
@import url("./css/maven-theme.css");
@@ -12,7 +11,7 @@ </style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
<meta name="author" content="Yves Fischer" />
- <meta name="Date-Revision-yyyymmdd" content="20110329" />
+ <meta name="Date-Revision-yyyymmdd" content="20110412" />
<meta http-equiv="Content-Language" content="en" />
</head>
@@ -29,7 +28,7 @@ <div class="xleft">
- <span id="publishDate">Last Published: 2011-03-29</span>
+ <span id="publishDate">Last Published: 2011-04-12</span>
| <span id="projectVersion">Version: 1.0-SNAPSHOT</span>
</div>
<div class="xright">
@@ -73,7 +72,7 @@ <a href="user-lightning.html" title="Mozilla Lightning">Mozilla Lightning</a>
</li>
<li class="none">
- <a href="user-outlook.html" title="Microsoft Outlook">Microsoft Outlook</a>
+ <a href="user-windows.html" title="Microsoft Tools">Microsoft Tools</a>
</li>
</ul>
<h5>Entwickler</h5>
@@ -103,210 +102,75 @@ </div>
<div id="bodyColumn">
<div id="contentBox">
- - - <div class="section"><h2>Installation Guide<a name="Installation_Guide"></a></h2> - <div class="section"><h3>Mit Embedded Servlet Container<a name="Mit_Embedded_Servlet_Container"></a></h3> - <div class="source"><pre>mvn jetty:run</pre></div> - <p>Standardmäßig lauscht jetty nun auf Port 8080</p> - </div> - <div class="section"><h3>Mit .war File<a name="Mit_.war_File"></a></h3> - <p> - Ein Web-Archive (.war) kann mit dem Maven Kommando - <tt>mvn package</tt> - erzeugt werden. - </p> - </div> - </div> - <div class="section"><h2>Installation unter SLES 11.1<a name="Installation_unter_SLES_11.1"></a></h2> - <p> - Es muss ein halbwegs aktuelles Java-JDK installiert sein, dieses - kann von - <a class="externalLink" href="http://java.sun.com">java.sun.com</a> - für Linux/i386 heruntergeladen werden. - </p> - <p> - Für die Ausführung von dhbwcalender wird ein neuer Benutzer - mit Namen - <tt>dhbwcalendar</tt> - angelegt. - </p> - <p> - maven2 wird von - <a class="externalLink" href="http://maven.apache.org">maven.apache.org</a> - installiert in - <tt>/home/dhbwcalendar/share/apache-maven-2.2.1/</tt> - </p> - <p> - Für den Benutzer dhbwcalendar wird in seiner - <tt>.profile</tt> - Datei die Umgebungsvariablen - <tt>JAVA_HOME</tt> - , - <tt>M2_HOME</tt> - (maven) entsprechend gesetzt - </p> - <p> - git wird mit zypper installiert: - </p><div class="source"><pre># zypper ar \ - "http://download.opensuse.org/repositories/devel:/tools:/scm/SLE_11/devel:tools:scm.repo" - # zypper install git - # su -l dhbwcalendar - $ git clone ....</pre></div> - - <p> - Da im produktiven Setup jetty nicht von "aussen" erreichbar sein - soll wird jetty konfiguriert nur auf - <i>localhost</i> - zu horchen. - </p><div class="source"><pre> - <connectors> - <connector - implementation="org.mortbay.jetty.nio.SelectChannelConnector"> - <port>8080</port> - <host>127.0.0.1</host> - </connector> - </connectors></pre></div> - - <p> - Bei vaadin wird der - <i>productionMode</i> - aktiviert - <tt>src/main/webapp/WEB-INF/web.xml:</tt> - </p><div class="source"><pre> - <context-param> - <param-name>productionMode</param-name> - <param-value>true</param-value> - <description>Vaadin production mode</description> - </context-param></pre></div> - - <p> - <tt>mvn jetty:run</tt> - startet Jetty über Maven als embedded Servlet Container. - </p> - <div class="section"><h3>SSL<a name="SSL"></a></h3> - <p>Zertifikat erstellen:</p> - <div class="source"><pre> - % 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 - (ACHTUNG - Common-Name = Hostname!) - 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 + <div class="section"><h2>Installation<a name="Installation"></a></h2><div class="section"><h3>Mit Embedded Servlet Container<a name="Mit_Embedded_Servlet_Container"></a></h3><p><tt>mvn jetty:run</tt></p><p>Standardmäßig lauscht jetty nun auf Port 8080</p></div><div class="section"><h3>Mit Web-Archive (.war)<a name="Mit_Web-Archive_.war"></a></h3><p>Ein Web-Archive kann mit dem Maven Kommando <tt>mvn package</tt> gebaut werden.</p></div></div><div class="section"><h2>Installation unter SLES 11.1<a name="Installation_unter_SLES_11.1"></a></h2><div class="section"><h3>Vorbereitung<a name="Vorbereitung"></a></h3><p>Es muss ein halbwegs aktuelles Java-JDK installiert sein, dieses kann z.B. von <a class="externalLink" href="http://java.sun.com">}Oracle</a> für Linux/i386 bezogen werden.</p><p>Für die Ausführung von dhbw-calendar wird ein neuer Benutzer, z.B. mit namen <tt>dhbwcalendar</tt> angelegt.</p><p><a class="externalLink" href="http://maven.apache.org">Maven2</a> in <tt>$HOME/share/apache-maven-2.2.1</tt> installiert.</p><p>Für den angelegten Benutzer wird in seiner <tt>$HOME/.profile</tt>-Datei die Umgebungsvariablen <tt>JAVA_HOME</tt> und <tt>M2_HOME</tt> auf die jeweiligen Installationspfade gesetzt.</p><p>Git kann mit dem SuSe-Tool <tt>zypper</tt> installiert werden:</p><div><pre># zypper ar \ + "http://download.opensuse.org/repositories/devel:/tools:/scm/SLE_11/devel:tools:scm.repo" +# zypper install git</pre></div></div><div class="section"><h3>Einrichtung<a name="Einrichtung"></a></h3><p>Das Projektverzeichnis wird mit git geklont:</p><div><pre># su -l dhbwcalendar +$ git clone ....dhbw-calendar URL...</pre></div><p>Falls jetty verwendet wird und er im produktiven Setup nur auf dem Loopback Interface lauschen soll wird das in der <tt>pom.xml</tt> konfiguriert:</p><div><pre><connectors> + <connector + implementation="org.mortbay.jetty.nio.SelectChannelConnector"> + <port>8080</port> + <host>127.0.0.1</host> + </connector> +</connectors></pre></div><p>Bei vaadin wird der <i>productionmode</i> im Deskriptor der Web-Applikation aktiviert:</p><div><pre><context-param> + <param-name>productionMode</param-name> + <param-value>true</param-value> + <description>Vaadin production mode</description> +</context-param></pre></div></div><div class="section"><h3>SSL<a name="SSL"></a></h3><div class="section"><h4>Zertifikat erstellen<a name="Zertifikat_erstellen"></a></h4><p><i>Achtung:</i> Vor- Nachname ist der Common-Name = Hostname.</p><div><pre>% keytool -keystore keystore -alias jetty -genkey -keyalg RSA +Geben Sie das Keystore-Passwort ein: +Geben Sie das Passwort erneut ein: - Geben Sie das - Passwort für - <jetty> ein. - (EINGABETASTE, wenn Passwort dasselbe - wie für - Keystore): - </pre></div> - <p>SSL für Jetty konfigurieren:</p> - <div class="source"><pre> - <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> </pre></div> - <p>Fingerprint von Zertifikat:</p> - <div class="source"><pre> - % keytool -list -keystore server.keystore -rfc - Geben Sie das - Keystore-Passwort 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):</pre></div></div><div class="section"><h4>SSL in Jetty konfigurieren<a name="SSL_in_Jetty_konfigurieren"></a></h4><div><pre><configuration> + <connectors> + <connector + implementation="org.mortbay.jetty.nio.SelectChannelConnector"> + <port>8080</port> + </connector> - Keystore-Typ: JKS - Keystore-Provider: SUN + <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></pre></div></div><div class="section"><h4>Zertifikationsinfos<a name="Zertifikationsinfos"></a></h4><p>SSL-Fingerprint:</p><div><pre> +% 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. +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 +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----- - .... - -----END CERTIFICATE----- - </pre></div> - <p>Die Verbindung kann jetzt mit wget überprüft werden</p> - <div class="source"><pre> - wget --ca-certificate=certificate.pem - https://dualical.ba-horb.de:8443/dhbwcalendar/ - </pre></div> - <p>Weitere Informationen zum Zertifikat zeigt OpenSSL in Klartext - an:</p> - <div class="source"><pre> - openssl x509 -noout -text -in certificate.pem - </pre></div> - </div> - <div class="section"><h3>Zugriff von 'aussen'<a name="Zugriff_von_aussen"></a></h3> - <p> - Mittels php und curl lässt sich eine reverse-Proxy nachahmen. Ein - Beispiel findet sich unter: - <a href="ics.php.txt">ics.php.txt</a> - . - </p> - </div> - </div> - -
+ -----BEGIN CERTIFICATE----- +.... /Zertifikat im PEM Format/ + -----END CERTIFICATE-----</pre></div><p>Die Verbindung kann jetzt mit wget überprüft werden</p><div><pre># wget --ca-certificate=certificate.pem \ + https://dualical.ba-horb.de:8443/dhbwcalendar/</pre></div><p>Weitere Informationen zum Zertifikat zeigt OpenSSL in Klartext an:</p><div><pre># openssl x509 -noout -text -in certificate.pem</pre></div></div></div><div class="section"><h3>Zugriff von 'aussen'<a name="Zugriff_von_aussen"></a></h3><p>Mit php und curl lässt sich eine reverse-Proxy nachahmen. Ein Beispiel findet sich unter: <a href="./ics.php.txt">ics.php.txt</a>.</p></div></div>
</div>
</div>
<div class="clear">
|