aboutsummaryrefslogtreecommitdiff
path: root/id.server/doc/moa_id/id-admin_1.htm
diff options
context:
space:
mode:
authorrudolf <rudolf@d688527b-c9ab-4aba-bd8d-4036d912da1d>2003-12-19 09:09:41 +0000
committerrudolf <rudolf@d688527b-c9ab-4aba-bd8d-4036d912da1d>2003-12-19 09:09:41 +0000
commitedc10681ce6d045d57d5dc7a544f3081f6eb41a7 (patch)
treec02ed4f975ca42a23eac2926033fbc01985840fc /id.server/doc/moa_id/id-admin_1.htm
parentb6e8e0a8f45c10d9a0cd77807db7107430752981 (diff)
downloadmoa-id-spss-edc10681ce6d045d57d5dc7a544f3081f6eb41a7.tar.gz
moa-id-spss-edc10681ce6d045d57d5dc7a544f3081f6eb41a7.tar.bz2
moa-id-spss-edc10681ce6d045d57d5dc7a544f3081f6eb41a7.zip
MOA-ID 1.1.1D01
git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@82 d688527b-c9ab-4aba-bd8d-4036d912da1d
Diffstat (limited to 'id.server/doc/moa_id/id-admin_1.htm')
-rw-r--r--id.server/doc/moa_id/id-admin_1.htm275
1 files changed, 196 insertions, 79 deletions
diff --git a/id.server/doc/moa_id/id-admin_1.htm b/id.server/doc/moa_id/id-admin_1.htm
index f56338747..73d5e3ef9 100644
--- a/id.server/doc/moa_id/id-admin_1.htm
+++ b/id.server/doc/moa_id/id-admin_1.htm
@@ -67,7 +67,7 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
<br />
<div id="klein"><a href="moa.htm"><img src="../moa_images/west.gif" border="0" width="13" height="14" />
<b> Zur&uuml;ck</b></a></div>
-</br /><br />
+<br />
<div id="slogan">
<b>Installationsschritte: </b>
<br />
@@ -87,25 +87,59 @@ Unterschiede sind in der Installationsanweisung angef&uuml;hrt.
<div id="vorbereitung" />
<p id="subtitel">Vorbereitung</p>
<div id="block">
-<b>Installation des JDK</b><br />
-Installieren Sie das JDK 1.3.1 oder JDK 1.4.1 in ein beliebiges Verzeichnis. Das Wurzelverzeichnis der JDK-Installation wird im weiteren Verlauf als $JAVA_HOME bezeichnet.
-<br /><br />
-<b>Installation von Tomcat</b><br />
-Installieren Sie Tomcat in ein Verzeichnis, das keine Leerzeichen im Pfadnamen enth&auml;lt. Das Wurzelverzeichnis der Tomcat-Installation wird im weiteren Verlauf als $CATALINA_HOME bezeichnet. <b>Hinweis:</b> Tomcat wird in einer Distribution f&uuml;r JDKs ab Version 1.2 und in einer Distribution speziell f&uuml;r JDK 1.4 ausgeliefert. Installieren Sie die zur Version Ihres JDK passende Tomcat-Version.
-<br /><br />
-<b>Entpacken der MOA ID Webapplikation</b><br />
-Entpacken Sie die ausgelieferten Dateien der Webapplikation (moa-id-auth-x.y.zip oder moa-id-proxy-x.y.zip; ersetzen Sie x.y durch die Releasenummer von MOA-ID-AUTH bzw. MOA-ID-PROXY) in ein beliebiges Verzeichnis. Diese Verzeichnisse werden im weiteren Verlauf als $MOA_ID_INST_AUTH bzw. $MOA_ID_INST_PROXY bezeichnet.
-<br /><br />
-<b>Installation der IAIK JCE, des IAIK LDAP Protocol Handlers und von JSSE (JDK 1.3.1)</b><br />
-Da Java in der Version 1.3.1 ohne Unterst&uuml;tzung f&uuml;r Kryptographie, LDAP und SSL ausgeliefert wird, m&uuml;ssen diese Funktionalit&auml;ten nachtr&auml;glich installiert werden. Es stehen hierf&uuml;r zwei M&ouml;glichkeiten zur Verf&uuml;gung: <br />
-1. Installation innerhalb des JDK 1.3.1:<br />
-Die Dateien aus dem Verzeichnis $MOA_ID_INST_AUTH/ext13 (oder $MOA_ID_INST_PROXY/ext13) m&uuml;ssen in das Verzeichnis $JAVA_HOME/jre/lib/ext kopiert werden. Anschlie&szlig;end steht eine Unterst&uuml;tzung f&uuml;r Kryptographie und SSL jeder Java-Anwendung die dieses JDK verwendet zur Verf&uuml;gung.<br />
-2. Installation ausschlie&szlig;lich f&uuml;r Applikationen innerhalb von Tomcat:<br />
-Um die o.g. Unterst&uuml;tzung nur Tomcat-Anwendungen zu erm&ouml;glichen, k&ouml;nnen die Dateien aus dem Verzeichnis $MOA_ID_INST_AUTH/ext13 (oder $MOA_ID_INST_PROXY/ext13) in ein beliebiges Verzeichnis kopiert werden. Im Folgenden wird dieses Verzeichnis $MOA_ID_EXT genannt. Anschlie&szlig;end muss der Tomcat-Klassenpfad angepasst werden:<br/>
-F&uuml;r Windows-Betriebssysteme ist daf&uuml;r die Datei $CATALINA_HOME\bin\setclasspath.bat anzupassen:<br/>
-Hinter <i>'set CLASSPATH=%JAVA_HOME%\lib\tools.jar'</i> m&uuml;ssen nun jeweils mit Semikolon getrennt, die Dateien aus $MOA_ID_EXT inklusive der vollst&auml;ndigen Pfadangaben angef&uuml;gt werden.<br/>
-Anschlie&szlig;end sieht diese Zeile beispielsweise folgenderma&szlig;en aus:
-<pre>
+ <p><b>Installation des JDK</b><br />
+ Installieren Sie das JDK 1.3.1, JDK 1.4.1 oder JDK 1.4.2 in ein
+ beliebiges Verzeichnis. Das Wurzelverzeichnis der JDK-Installation
+ wird im weiteren Verlauf als $JAVA_HOME bezeichnet. <br />
+ <br />
+ <b>Installation von Tomcat</b><br />
+ Installieren Sie Tomcat in ein Verzeichnis, das <b>keine Leer- und
+ Sonderzeichen</b> im Pfadnamen enth&auml;lt. Am Besten verwenden
+ die referenzierte Version von Tomcat im zip-Format. (Hinweis f.
+ Windows: nicht die selbstinstallierende exe Version verwenden.)
+ Das Wurzelverzeichnis der Tomcat-Installation wird im weiteren Verlauf
+ als $CATALINA_HOME bezeichnet. </p>
+ <p><b>Hinweis:</b> Tomcat 4.1.18 wird in einer Distribution f&uuml;r
+ JDKs ab Version 1.2 und in einer Distribution speziell f&uuml;r
+ JDK 1.4 ausgeliefert. Installieren Sie die zur Version Ihres JDK
+ passende Tomcat-Version. </p>
+ <p><b>Hinweis:</b> Wenn Sie Tomcat 4.1.27 einsetzen, so m&uuml;ssen
+ sie $CATALINA_HOME/server/lib/tomcat-util.jar durch die gepatchte
+ Version welche in der MOA-ID Distribution (*) enthalten ist ersetzen.<br />
+ <br />
+ <b>Entpacken der MOA ID Webapplikation</b><br />
+ Entpacken Sie die ausgelieferten Dateien der Webapplikation (moa-id-auth-x.y.zip
+ oder moa-id-proxy-x.y.zip; ersetzen Sie x.y durch die Releasenummer
+ von MOA-ID-AUTH bzw. MOA-ID-PROXY) in ein beliebiges Verzeichnis.
+ Diese Verzeichnisse werden im weiteren Verlauf als $MOA_ID_INST_AUTH
+ bzw. $MOA_ID_INST_PROXY bezeichnet. <br />
+ <br />
+ <b>Installation der IAIK JCE, des IAIK LDAP Protocol Handlers und
+ von JSSE (JDK 1.3.1)</b><br />
+ Da Java in der Version 1.3.1 ohne Unterst&uuml;tzung f&uuml;r Kryptographie,
+ LDAP und SSL ausgeliefert wird, m&uuml;ssen diese Funktionalit&auml;ten
+ nachtr&auml;glich installiert werden. Es stehen hierf&uuml;r zwei
+ M&ouml;glichkeiten zur Verf&uuml;gung: <br />
+ 1. Installation innerhalb des JDK 1.3.1:<br />
+ Die Dateien aus dem Verzeichnis $MOA_ID_INST_AUTH/ext13 (oder $MOA_ID_INST_PROXY/ext13)
+ m&uuml;ssen in das Verzeichnis $JAVA_HOME/jre/lib/ext kopiert werden.
+ Anschlie&szlig;end steht eine Unterst&uuml;tzung f&uuml;r Kryptographie
+ und SSL jeder Java-Anwendung die dieses JDK verwendet zur Verf&uuml;gung.<br />
+ 2. Installation ausschlie&szlig;lich f&uuml;r Applikationen innerhalb
+ von Tomcat:<br />
+ Um die o.g. Unterst&uuml;tzung nur Tomcat-Anwendungen zu erm&ouml;glichen,
+ k&ouml;nnen die Dateien aus dem Verzeichnis $MOA_ID_INST_AUTH/ext13
+ (oder $MOA_ID_INST_PROXY/ext13) in ein beliebiges Verzeichnis kopiert
+ werden. Im Folgenden wird dieses Verzeichnis $MOA_ID_EXT genannt.
+ Anschlie&szlig;end muss der Tomcat-Klassenpfad angepasst werden:<br/>
+ F&uuml;r Windows-Betriebssysteme ist daf&uuml;r die Datei $CATALINA_HOME\bin\setclasspath.bat
+ anzupassen:<br/>
+ Hinter <i>'set CLASSPATH=%JAVA_HOME%\lib\tools.jar'</i> m&uuml;ssen
+ nun jeweils mit Semikolon getrennt, die Dateien aus $MOA_ID_EXT
+ inklusive der vollst&auml;ndigen Pfadangaben angef&uuml;gt werden.<br/>
+ Anschlie&szlig;end sieht diese Zeile beispielsweise folgenderma&szlig;en
+ aus: </p>
+ <pre>
set CLASSPATH=%JAVA_HOME%\lib\tools.jar;
$MOA_ID_EXT\iaik_jce_full.jar;
$MOA_ID_EXT\iaik_ldap.jar;
@@ -113,14 +147,29 @@ Anschlie&szlig;end sieht diese Zeile beispielsweise folgenderma&szlig;en aus:
$MOA_ID_EXT\jnet.jar;
$MOA_ID_EXT\jsse.jar
</pre>
-($MOA_ID_EXT ist durch den tats&auml;chlichen Pfad zu ersetzen)<br />
-Unix/Linux-Anwender verfahren analog mit der Datei $CATALINA_HOME/bin/setclasspath.sh wobei ';' durch ':' zu ersetzen ist.<br /><br />
-<b>Installation der IAIK JCE und des IAIK LDAP Protocol Handlers (JDK 1.4.1)</b><br />
-Die Dateien aus dem Verzeichnis $MOA_ID_INST_AUTH/ext14 (oder $MOA_ID_INST_PROXY/ext14) m&uuml;ssen in das Verzeichnis $JAVA_HOME/jre/lib/ext kopiert werden. Anschlie&szlig;end steht eine Unterst&uuml;tzung f&uuml;r Kryptographie und SSL jeder Java-Anwendung die dieses JDK verwendet zur Verf&uuml;gung.<br />
-Zus&auml;tzlich m&uuml;ssen die so genannten "Unlimited Strength Jurisdiction Policy Files 1.4.1" heruntergeladen, entpackt und ins Verzeichnis $JAVA_HOME/jre/lib/security kopiert werden. Der Download f&uuml;r diese Dateien findet sich am unteren Ende der <a href="http://java.sun.com/j2se/1.4.1/download.html">Download-Seite f&uuml;r das JDK 1.4.1</a> in der Sektion "Other Downloads".
-</div>
+ <p>($MOA_ID_EXT ist durch den tats&auml;chlichen Pfad zu ersetzen)<br />
+ Unix/Linux-Anwender verfahren analog mit der Datei $CATALINA_HOME/bin/setclasspath.sh
+ wobei ';' durch ':' zu ersetzen ist.<br />
+ <br />
+ <b>Installation der IAIK JCE und des IAIK LDAP Protocol Handlers
+ (JDK 1.4.1 bzw. JDK 1.4.2)</b><br />
+ Die Dateien aus dem Verzeichnis $MOA_ID_INST_AUTH/ext14 (oder $MOA_ID_INST_PROXY/ext14)
+ m&uuml;ssen in das Verzeichnis $JAVA_HOME/jre/lib/ext kopiert werden.
+ Anschlie&szlig;end steht eine Unterst&uuml;tzung f&uuml;r Kryptographie
+ und SSL jeder Java-Anwendung die dieses JDK verwendet zur Verf&uuml;gung.<br>
+ <br />
+ Zus&auml;tzlich m&uuml;ssen die so genannten Unlimited Strength
+ Jurisdiction Policy Files 1.4.1 (bzw. 1.4.2) heruntergeladen, entpackt
+ und ins Verzeichnis $JAVA_HOME/jre/lib/security kopiert werden.
+ </p>
+ <p>Der Download f&uuml;r diese Dateien findet sich am unteren Ende
+ der Download-Seite des jeweiligen JDK 1.4.x in der Sektion "Other
+ Downloads". D.h. <a href="http://java.sun.com/j2se/1.4.1/download.html">JDK
+ hier f&uuml;r 1.4.1</a> bzw. das JDK <a href="http://java.sun.com/j2se/1.4.2/download.html">hier
+ f&uuml;r 1.4.2</a>.</p>
+ </div>
-</td></tr></table>
+</div></td></tr></table>
<div id="Tomcat" />
<table width="650" border="0" cellpadding="10" cellspacing="0">
@@ -174,24 +223,49 @@ Um diese Benutzer-Rolle und einen oder mehrere Benutzer einzurichten, m&uuml;sse
<p id="subtitel">Deployment von MOA-ID-AUTH in Tomcat</p>
<div id="block">
Um MOA-ID-AUTH in Tomcat f&uuml;r den Ablauf vorzubereiten, sind folgende Schritte notwendig: <br />
-<ul>
-<li>Die Datei $MOA_ID_INST_AUTH/moa-id-auth.war wird ins Verzeichnis $CATALINA_HOME/webapps kopiert. Dort wird sie beim ersten Start von Tomcat automatisch ins Verzeichnis $CATALINA_HOME/webapps/moa-id-auth entpackt. </li>
-<li>Die MOA-ID Konfigurationsdatei und die zugeh&ouml;rigen Verzeichnisse "certs" und "transforms" werden in ein beliebiges Verzeichnis im Filesystem kopiert (z.B. $CATALINA_HOME/conf/moa-id). <br />In $MOA_ID_INST_AUTH/conf/moa-id befindet sich eine funktionsf&auml;hige Konfiguration, die als Ausgangspunkt f&uuml;r die Konfiguration von MOA-ID-AUTH dienen kann. </li>
-<li>Die endorsed Libraries f&uuml;r Tomcat m&uuml;ssen aus dem Verzeichnis $MOA_ID_INST_AUTH/endorsed in das Tomcat-Verzeichnis $CATALINA_HOME/common/endorsed kopieren werden. Folgende Libraries sind f&uuml;r das Deployment im endorsed Verzeichnis vorgesehen:
-<ul>
-<li id="klein">Xerces-J-2.0.2 (bestehend aus xercesImpl.jar und xmlParserAPIs.jar)</li>
-</ul>
-Eventuell vorhandene Dateien mit dem gleichen Namen m&uuml;ssen ersetzt werden.
-</li>
-<li>Folgende Java System Properties sind zu setzen: <br />
-<ul id="klein">
-<li id="klein">moa.id.configuration=Name der MOA ID Konfigurationsdatei. Eine beispielhafte MOA ID Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/ SampleMOAIDConfiguration.xml enthalten.</li>
-<li id="klein">log4j.configuration=URL der Log4j Konfigurationsdatei. Eine beispielhafte Log4j-Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/log4j.properties enthalten. </li>
-<li id="klein">javax.net.ssl.trustStore=Name des Truststores f&uuml;r vertrauensw&uuml;rdige SSL Client-Zertifikate (optional; nur, wenn SSL Client-Authentisierung durchgef&uuml;hrt werden soll). </li>
-</ul>
-Diese Java System-Properties werden Tomcat &uuml;ber die Umgebungsvariable CATALINA_OPTS mitgeteilt
-(siehe Beispiele f&uuml;r <a href="examples/moa-id-env-windows.txt">Windows</a> und f&uuml;r <a href="examples/moa-id-env-linux.txt">Linux</a>).
-</ul>
+ <ul>
+ <li>Die Datei $MOA_ID_INST_AUTH/moa-id-auth.war wird ins Verzeichnis
+ $CATALINA_HOME/webapps kopiert. Dort wird sie beim ersten Start
+ von Tomcat automatisch ins Verzeichnis $CATALINA_HOME/webapps/moa-id-auth
+ entpackt. </li>
+ <li>Die MOA-ID Konfigurationsdatei und die zugeh&ouml;rigen Verzeichnisse
+ "certs" und "transforms" werden in ein beliebiges Verzeichnis
+ im Filesystem kopiert (z.B. $CATALINA_HOME/conf/moa-id). <br />
+ In $MOA_ID_INST_AUTH/conf/moa-id befindet sich eine funktionsf&auml;hige
+ Konfiguration, die als Ausgangspunkt f&uuml;r die Konfiguration
+ von MOA-ID-AUTH dienen kann. </li>
+ <li>Die endorsed Libraries f&uuml;r Tomcat m&uuml;ssen aus dem
+ Verzeichnis $MOA_ID_INST_AUTH/endorsed in das Tomcat-Verzeichnis
+ $CATALINA_HOME/common/endorsed kopieren werden. Folgende Libraries
+ sind f&uuml;r das Deployment im endorsed Verzeichnis vorgesehen:
+ <ul>
+ <li id="klein">Xerces-J-2.0.2 (bestehend aus xercesImpl.jar
+ und xmlParserAPIs.jar) - f&uuml;r alle JDKs.<br>
+ </li>
+ <li>Nur im Fall von JDK 1.4.1: kopieren sie auch die Xalan-j-2.2
+ Libraries ( bestehend aus bsf.jar und xalan.jar).</li>
+ </ul>
+ Eventuell vorhandene Dateien mit dem gleichen Namen m&uuml;ssen
+ ersetzt werden.</li>
+ <li>Folgende Java System Properties sind zu setzen: <br />
+ <ul id="klein">
+ <li id="klein">moa.id.configuration=Name der MOA ID Konfigurationsdatei.
+ Eine beispielhafte MOA ID Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/
+ SampleMOAIDConfiguration.xml enthalten.</li>
+ <li id="klein">log4j.configuration=URL der Log4j Konfigurationsdatei.
+ Eine beispielhafte Log4j-Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/log4j.properties
+ enthalten. </li>
+ <li id="klein">javax.net.ssl.trustStore=Name des Truststores
+ f&uuml;r vertrauensw&uuml;rdige SSL Client-Zertifikate (optional;
+ nur, wenn SSL Client-Authentisierung durchgef&uuml;hrt werden
+ soll). </li>
+ </ul>
+ Diese Java System-Properties werden Tomcat &uuml;ber die Umgebungsvariable
+ CATALINA_OPTS mitgeteilt (Beispiel-Skripte zum Setzen dieser
+ Properties f&uuml;r <b>Windows</b> und f&uuml;r <b>Unix bzw
+ Linux</b> finden sie unter $MOA_ID_INST_AUTH/tomcat/win32 bzw.
+ $MOA_ID_INST_AUTH/tomcat/unix).
+ </ul>
</div>
</td></tr></table>
@@ -208,29 +282,62 @@ Diese Java System-Properties werden Tomcat &uuml;ber die Umgebungsvariable CATAL
<p id="subtitel">Deployment von MOA-ID-PROXY in Tomcat</p>
<div id="block">
Um MOA-ID-PROXY in Tomcat f&uuml;r den Ablauf vorzubereiten, sind folgende Schritte notwendig: <br />
-<ul>
-<li>Die Datei $MOA_ID_INST_PROXY/moa-id-proxy.war wird in ein beliebiges Verzeichnis (bspw. $CATALINA_HOME) kopiert. <b>HINWEIS: Das Verzeichnis darf NICHT $CATALINA_HOME/webapps sein!</b><br />
- Anschliessend muss in der Datei <tt>$CATALINA_HOME/conf/server.xml</tt> der Tomcat-Root-Context auf diese Datei gesetzt werden: wenn das war-file sich in $CATALINA_HOME befindet, geschieht dies mit dem Einf&uuml;gen von folgendem Element innerhalb von <tt>&lt;Server&gt;...&lt;Service&gt;...&lt;Engine&gt;...&lt;Host&gt;</tt>: </li>
-<pre>&lt;Context path="" docBase="../moa-id-proxy.war" debug="0"/&gt;</pre>
-Anmerkung: Der Root-Context von Tomcat ist normalerweise auskommentiert. <br /><br />
-<li>Die MOA-ID Konfigurationsdatei und die zugeh&ouml;rigen Verzeichnisse "certs" und "oa" werden in ein beliebiges Verzeichnis im Filesystem kopiert (z.B. $CATALINA_HOME/ conf/moa-id). <br />
-In $MOA_ID_INST_PROXY/conf/moa-id befindet sich eine funktionsf&auml;hige Konfiguration, die als Ausgangspunkt f&uuml;r die Konfiguration von MOA-ID-PROXY dienen kann. </li>
-<li>Die endorsed Libraries f&uuml;r Tomcat m&uuml;ssen aus dem Verzeichnis $MOA_ID_INST_PROXY/endorsed in das Tomcat-Verzeichnis $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries sind f&uuml;r das Deployment im endorsed Verzeichnis vorgesehen:
-<ul>
-<li id="klein">Xerces-J-2.0.2 (bestehend aus xercesImpl.jar und xmlParserAPIs.jar)</li>
-</ul>
-Eventuell vorhandene Dateien mit dem gleichen Namen m&uuml;ssen ersetzt werden.
-</li>
-<li>Folgende Java System Properties sind zu setzen: <br />
-<ul id="klein">
-<li id="klein">moa.id.configuration=Name der MOA ID Konfigurationsdatei. Eine beispielhafte MOA ID Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/ SampleMOAIDConfiguration.xml enthalten.</li>
-<li id="klein">log4j.configuration=URL der Log4j Konfigurationsdatei. Eine beispielhafte Log4j-Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/log4j.properties enthalten. </li>
-<li id="klein">javax.net.ssl.trustStore=Name des Truststores f&uuml;r vertrauensw&uuml;rdige SSL Client-Zertifikate (optional; nur, wenn SSL Client-Authentisierung durchgef&uuml;hrt werden soll). </li>
-</ul>
-Diese Java System-Properties werden Tomcat &uuml;ber die Umgebungsvariable CATALINA_OPTS mitgeteilt
-(siehe Beispiele f&uuml;r <a href="examples/moa-id-env-windows.txt">Windows</a> und f&uuml;r <a href="examples/moa-id-env-linux.txt">Linux</a>).
-</ul>
-</div>
+ <ul>
+ <li>Die Datei $MOA_ID_INST_PROXY/moa-id-proxy.war wird in ein
+ beliebiges Verzeichnis (bspw. $CATALINA_HOME) kopiert. <b>HINWEIS:
+ Das Verzeichnis darf NICHT $CATALINA_HOME/webapps sein!</b><br>
+ <br />
+ Anschliessend muss in der Datei <tt>$CATALINA_HOME/conf/server.xml</tt>
+ der Tomcat-Root-Context auf diese Datei gesetzt werden: wenn
+ das war-file sich in $CATALINA_HOME befindet, geschieht dies
+ mit dem Einf&uuml;gen von folgendem Element innerhalb von
+ <tt>&lt;Server&gt;...&lt;Service&gt;...&lt;Engine&gt;...&lt;Host&gt;</tt>:
+ </li>
+ <pre>&lt;Context path="" docBase="../moa-id-proxy.war" debug="0"/&gt;</pre>
+ Anmerkung: Der Root-Context von Tomcat ist normalerweise auskommentiert.
+ <br />
+ <br />
+ <li>Die MOA-ID Konfigurationsdatei und die zugeh&ouml;rigen
+ Verzeichnisse "certs" und "oa" werden in ein beliebiges Verzeichnis
+ im Filesystem kopiert (z.B. $CATALINA_HOME/ conf/moa-id).
+ <br />
+ In $MOA_ID_INST_PROXY/conf/moa-id befindet sich eine funktionsf&auml;hige
+ Konfiguration, die als Ausgangspunkt f&uuml;r die Konfiguration
+ von MOA-ID-PROXY dienen kann. </li>
+ <li>Die endorsed Libraries f&uuml;r Tomcat m&uuml;ssen aus dem
+ Verzeichnis $MOA_ID_INST_PROXY/endorsed in das Tomcat-Verzeichnis
+ $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries
+ sind f&uuml;r das Deployment im endorsed Verzeichnis vorgesehen:
+ <ul>
+ <li id="klein">Xerces-J-2.0.2 (bestehend aus xercesImpl.jar
+ und xmlParserAPIs.jar)</li>
+ </ul>
+ Eventuell vorhandene Dateien mit dem gleichen Namen m&uuml;ssen
+ ersetzt werden. </li>
+ <li>Folgende Java System Properties sind zu setzen: <br />
+ <ul id="klein">
+ <li id="klein">moa.id.configuration=Name der MOA ID Konfigurationsdatei.
+ Eine beispielhafte MOA ID Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/
+ SampleMOAIDConfiguration.xml enthalten.</li>
+ <li id="klein">log4j.configuration=URL der Log4j Konfigurationsdatei.
+ Eine beispielhafte Log4j-Konfiguration ist in $MOA_ID_INST_AUTH/conf/moa-id/log4j.properties
+ enthalten. </li>
+ <li id="klein">javax.net.ssl.trustStore=Name des Truststores
+ f&uuml;r vertrauensw&uuml;rdige SSL Client-Zertifikate
+ (optional; nur, wenn SSL Client-Authentisierung durchgef&uuml;hrt
+ werden soll). </li>
+ </ul>
+ Diese Java System-Properties werden Tomcat &uuml;ber die Umgebungsvariable
+ CATALINA_OPTS mitgeteilt (siehe Beispiele f&uuml;r <a href="examples/startTomcat.bat.txt">Windows</a>
+ und f&uuml;r <a href="examples/moa-id-env.sh.txt">Unix/Linux</a>).
+ <br>
+ <br>
+ Beispiel-Skripts zum Setzen von CATALINA_OPTS und zum Starten
+ von Tomcat sind in $MOA_ID_INST_AUTH\tomcat\ zu finden - Sie
+ k&ouml;nnen diese f&uuml;r Ihre Zwecke adaptieren (JAVA_HOME
+ und $CATALINA_HOME setzen) und nach $CATALINA_HOME kopieren.
+ </ul>
+ </div>
</td></tr></table>
<div id="Tomcat_Start" />
@@ -243,10 +350,11 @@ Diese Java System-Properties werden Tomcat &uuml;ber die Umgebungsvariable CATAL
</td>
<td valign="top">
<p id="subtitel">Starten und Stoppen von Tomcat </p>
-<div id="block">
-Nach dem Deployment und der Konfiguration kann Tomcat aus seinem Wurzelverzeichnis mit <br />
-<pre>
- bin\catalina start (unter Windows) oder
+ <div id="block"> Nach dem Deployment und der Konfiguration kann
+ Tomcat aus seinem Wurzelverzeichnis ($CATALINA_HOME) mit <br />
+ <pre>
+ startTomcat (unter Windows) oder
+ moa-id-env.sh
bin/catalina.sh start (unter Unix/Linux)
</pre>
gestartet werden. Das Stoppen von Tomcat erfolgt analog mit <br />
@@ -293,7 +401,7 @@ FATAL | 03 13:19:06,924 | main | Fehler
</pre>
In diesem Fall geben die WARN bzw. ERROR Log-Meldungen unmittelbar davor Aufschluss &uuml;ber den genaueren Grund. <br />
</div>
-</td></tr></table>
+</div></td></tr></table>
<div id="Logging" />
@@ -376,11 +484,20 @@ Wenn nun versucht wird, eine Transaktion mit einer ung&uumlltigen SessionID fort
(MOASessionID=-8650403497547200032)
</pre>
<div id="block">
-In diesem Fall gibt der mitgeloggte Stacktrace Auskunft &uuml;ber die Art des Fehlers. Der Aufrufer der MOA ID Webapplikation bekommt einen Fehlercode sowie eine kurze Beschreibung des Fehlers als Antwort zur&uuml;ck.
-<br /><br />
-Die Tats&auml;chlich &uuml;bertragenen Anfragen bzw. Antworten werden aus Effizienzgr&uuml;nden nur im Log-Level DEBUG angezeigt.
-</div>
-</td></tr></table>
+ <p>In diesem Fall gibt der mitgeloggte Stacktrace Auskunft
+ &uuml;ber die Art des Fehlers. Der Aufrufer der MOA ID
+ Webapplikation bekommt einen Fehlercode sowie eine kurze
+ Beschreibung des Fehlers als Antwort zur&uuml;ck. <br />
+ <br />
+ Die Tats&auml;chlich &uuml;bertragenen Anfragen bzw. Antworten
+ werden aus Effizienzgr&uuml;nden nur im Log-Level DEBUG
+ angezeigt. </p>
+ <hr />
+ <p>(*) Die gepatchte Version von tomcat-util.jar ist im
+ Verzeichnis $MOA_ID_INST_AUTH\tomcat\tomcat-util-4.1.27-patched\
+ zu finden.</p>
+ </div>
+</div></td></tr></table>
<br /><br />
@@ -396,5 +513,5 @@ Die Tats&auml;chlich &uuml;bertragenen Anfragen bzw. Antworten werden aus Effizi
</div>
-</body>
+</div></div></div></div></div></body>
</html> \ No newline at end of file