aboutsummaryrefslogtreecommitdiff
path: root/spss.server/doc
diff options
context:
space:
mode:
Diffstat (limited to 'spss.server/doc')
-rw-r--r--spss.server/doc/moa_spss/sp-admin_1.htm119
1 files changed, 85 insertions, 34 deletions
diff --git a/spss.server/doc/moa_spss/sp-admin_1.htm b/spss.server/doc/moa_spss/sp-admin_1.htm
index 4c3d5c1fb..26120ab9c 100644
--- a/spss.server/doc/moa_spss/sp-admin_1.htm
+++ b/spss.server/doc/moa_spss/sp-admin_1.htm
@@ -69,10 +69,10 @@ 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�ck</b></a></div>
-</br /><br />
+<br />
<div id="slogan">
<b>Installationsschritte: </b>
-</br /><br />
+<br />
<a href="#vorbereitung"><b>Vorbereitung</b></a><br />
<a href="#Tomcat"><b>Tomcat Konfiguration</b></a><br />
<a href="#deployment"><b>Webservice Deployment</b></a><br />
@@ -99,10 +99,17 @@ Entpacken Sie die Datei moa-spss-1.0.x.zip in ein beliebiges Verzeichnis. Dieses
Da Java in der Version 1.3.1 ohne Unterst�tzung f�r Kryptographie und SSL ausgeliefert wird, muss dies manuell nachtr�glich installiert werden. F�r den Betrieb des MOA SP/SS Webservices ist es deshalb notwendig, die Dateien aus dem Verzeichnis $MOA_SPSS_INST/ext13 in das Verzeichnis $JAVA_HOME/jre/lib/ext zu kopieren.
<br /><br />
<b>Installation der IAIK JCE im JDK 1.4.1</b><br />
-Um die mit MOA SP/SS ausgelieferte IAIK JCE im JDK 1.4.1 zu installieren, m�ssen die Dateien aus dem Verzeichnis $MOA_SPSS_INST/ext14 in das Verzeichnis $JAVA_HOME/lib/ext kopiert werden. Zus�tzlich m�ssen die sogenannten "Unlimited Strength Jurisdiction Policy Files 1.4.1" heruntergeladen, entpackt und ins Verzeichnis $JAVA_HOME/jre/lib/security kopiert werden. Der Download f�r diese Dateien findet sich am unteren Ende der <a href="http://java.sun.com/j2se/1.4.1/download.html">Download-Seite f�r das JDK 1.4.1</a> in der Sektion "Other Downloads".
-<br /><br />
+ Um die mit MOA SP/SS ausgelieferte IAIK JCE im JDK 1.4.1 zu installieren,
+ m�ssen die Dateien aus dem Verzeichnis $MOA_SPSS_INST/ext14 in das
+ Verzeichnis $JAVA_HOME/jre/lib/ext kopiert werden. Zus�tzlich m�ssen
+ die sogenannten "Unlimited Strength Jurisdiction Policy Files 1.4.1"
+ heruntergeladen, entpackt und ins Verzeichnis $JAVA_HOME/jre/lib/security
+ kopiert werden. Der Download f�r diese Dateien findet sich am unteren
+ Ende der <a href="http://java.sun.com/j2se/1.4.1/download.html">Download-Seite
+ f�r das JDK 1.4.1</a> in der Sektion "Other Downloads". <br />
+ <br />
</div>
-</td></tr></table>
+</div></td></tr></table>
<div id="Tomcat" />
@@ -153,32 +160,76 @@ Um diese Benutzer-Rolle und einen oder mehrere Benutzer einzurichten, m�ssen in
<p id="subtitel">Deployment des MOA SP/SS Webservices in Tomcat</p>
<div id="block">
Um das MOA SP/SS Webservice in Tomcat f�r den Ablauf vorzubereiten, sind folgende Schritte notwendig: <br />
-<ul>
-<li>Die Datei $MOA_SPSS_INST/moa-spss.war enth�lt das einsatzfertige MOA SP/SS Webarchiv und muss ins Verzeichnis Verzeichnis $CATALINA_HOME/webapps kopiert werden. Dort wird sie beim ersten Start von Tomcat automatisch ins Verzeichnis $CATALINA_HOME/webapps/ moa-spss entpackt. </li>
-<li>Die MOA SP/SS Konfigurationsdatei und zugeh�rige Profil-Verzeichnisse m�ssen in ein beliebiges Verzeichnis im Filesystem kopiert werden (z.B. $CATALINA_HOME/ conf/moa). <br />In $MOA_SPSS_INST/conf befindet sich eine funktionsf�hige Konfiguration, die als Ausgangspunkt f�r die Konfiguration des MOA SP/SS Webservices dienen kann. </li>
-<li>Wird Tomcat unter JDK 1.3.1 betrieben, m�ssen die Dateien aus dem Verzeichnis $MOA_SPSS_INST/endorsed13 in das Tomcat-Verzeichnis $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries sind f�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�ssen ersetzt werden.
-</li>
-<li>Wird Tomcat unter JDK 1.4.1 betrieben, m�ssen die Dateien aus dem Verzeichnis $MOA_SPSS_INST/endorsed14 in das Tomcat-Verzeichnis $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries sind f�r das Deployment im endorsed Verzeichnis vorgesehen:
-<ul>
-<li id="klein">Xalan-J-2.2.0 (bestehend aus xalan.jar.jar und bsf.jar).</li>
-</ul>
-Eventuell vorhandene Dateien mit dem gleichen Namen m�ssen ersetzt werden.
-</li>
-<li>Folgende Java System-Properties k�nnen optional gesetzt sein:<br />
-<ul>
-<li id="klein">moa.spss.server.configuration=Name der MOA SP/SS Konfigurationsdatei. Eine beispielhafte MOA SP/SS Konfiguration ist in $MOA_SPSS_INST/conf/moa-spss/ MOA-SPSSConfiguration.xml enthalten. Ist diese System-Property nicht gesetzt, wird automatisch eine im Web-Archive unter <tt>WEB-INF/conf</tt> enthaltene Default-Konfiguration herangezogen.</li>
-<li id="klein">log4j.configuration=URL der Log4j Konfigurationsdatei. Eine beispielhafte Log4j-Konfiguration ist in $MOA_SPSS_INST/conf/moa-spss/log4j.properties enthalten. Ist diese System-Property nicht gesetzt, wird automatisch eine im Web-Archive unter <tt>WEB-INF/classes</tt> enthaltene Default-Konfiguration herangezogen.</li>
-<li id="klein">moa.node.id=Name des Rechner-Knotens, auf dem MOA SP/SS l�uft. Der Name des Knotens wird bei Log-Ausgaben von MOA SP/SS angef�hrt und dient zur Unterscheidung mehrerer gleichzeitig betriebener MOA SP/SS Webservice-Instanzen. Der Name des Knotens ist frei w�hlbar.</li>
-<li id="klein">javax.net.ssl.trustStore=Dateiname des Truststores f�r vertrauensw�rdige SSL Client-Zertifikate (optional; nur, wenn SSL Client-Authentisierung durchgef�hrt werden soll). Relative Dateinamen werden zum Verzeichnis, von dem Tomcat gestartet wird, aufgel�st.</li>
-<li id="klein">javax.net.ssl.trustStorePassword=Passwort f�r den Truststore (optional; nur, wenn SSL Client-Authentisierung durchgef�hrt werden soll). </li>
-<li id="klein">javax.net.ssl.trustStoreType=Truststore-Typ (optional; nur, wenn SSL Client-Authentisierung durchgef�hrt werden soll). Je nach verwendetem Keystore-Typ ist "jks" oder "pkcs12" �blich.</li>
-</ul>
-Diese Java System-Properties werden Tomcat �ber die Umgebungsvariable CATALINA_OPTS mitgeteilt. Die Dateien $MOA_SPSS_INST/tomcat/moa-env.bat und <br />$MOA_SPSS_INST/tomcat/moa-env.sh enthalten Beispiele zum Setzen dieser Umgebungsvariablen unter Windows bzw. Unix/Linux.
-</ul>
+ <ul>
+ <li>Die Datei $MOA_SPSS_INST/moa-spss.war enth�lt das einsatzfertige
+ MOA SP/SS Webarchiv und muss ins Verzeichnis Verzeichnis $CATALINA_HOME/webapps
+ kopiert werden. Dort wird sie beim ersten Start von Tomcat automatisch
+ ins Verzeichnis $CATALINA_HOME/webapps/ moa-spss entpackt. </li>
+ <li>Die MOA SP/SS Konfigurationsdatei und zugeh�rige Profil-Verzeichnisse
+ m�ssen in ein beliebiges Verzeichnis im Filesystem kopiert werden
+ (z.B. $CATALINA_HOME/ conf/moa). <br />
+ In $MOA_SPSS_INST/conf befindet sich eine funktionsf�hige Konfiguration,
+ die als Ausgangspunkt f�r die Konfiguration des MOA SP/SS Webservices
+ dienen kann. </li>
+ <li>Wird Tomcat unter JDK 1.3.1 betrieben, m�ssen die Dateien
+ aus dem Verzeichnis $MOA_SPSS_INST/endorsed13 in das Tomcat-Verzeichnis
+ $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries
+ sind f�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�ssen ersetzt
+ werden. </li>
+ <li>Wird Tomcat unter JDK 1.4.1 betrieben, m�ssen die Dateien
+ aus dem Verzeichnis $MOA_SPSS_INST/endorsed14 in das Tomcat-Verzeichnis
+ $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries
+ sind f�r das Deployment im endorsed Verzeichnis vorgesehen:
+ <ul>
+ <li id="klein">Xerces-J-2.0.2 (bestehend aus xercesImpl.jar
+ und xmlParserAPIs.jar).</li>
+ <li id="klein">Xalan-J-2.2.0 (bestehend aus xalan.jar.jar
+ und bsf.jar).</li>
+ </ul>
+ Eventuell vorhandene Dateien mit dem gleichen Namen m�ssen ersetzt
+ werden. </li>
+ <li>Folgende Java System-Properties k�nnen optional gesetzt sein:<br />
+ <ul>
+ <li id="klein">moa.spss.server.configuration=Name der MOA
+ SP/SS Konfigurationsdatei. Eine beispielhafte MOA SP/SS
+ Konfiguration ist in $MOA_SPSS_INST/conf/moa-spss/ MOA-SPSSConfiguration.xml
+ enthalten. Ist diese System-Property nicht gesetzt, wird
+ automatisch eine im Web-Archive unter <tt>WEB-INF/conf</tt>
+ enthaltene Default-Konfiguration herangezogen.</li>
+ <li id="klein">log4j.configuration=URL der Log4j Konfigurationsdatei.
+ Eine beispielhafte Log4j-Konfiguration ist in $MOA_SPSS_INST/conf/moa-spss/log4j.properties
+ enthalten. Ist diese System-Property nicht gesetzt, wird
+ automatisch eine im Web-Archive unter <tt>WEB-INF/classes</tt>
+ enthaltene Default-Konfiguration herangezogen.</li>
+ <li id="klein">moa.node.id=Name des Rechner-Knotens, auf dem
+ MOA SP/SS l�uft. Der Name des Knotens wird bei Log-Ausgaben
+ von MOA SP/SS angef�hrt und dient zur Unterscheidung mehrerer
+ gleichzeitig betriebener MOA SP/SS Webservice-Instanzen.
+ Der Name des Knotens ist frei w�hlbar.</li>
+ <li id="klein">javax.net.ssl.trustStore=Dateiname des Truststores
+ f�r vertrauensw�rdige SSL Client-Zertifikate (optional;
+ nur, wenn SSL Client-Authentisierung durchgef�hrt werden
+ soll). Relative Dateinamen werden zum Verzeichnis, von dem
+ Tomcat gestartet wird, aufgel�st.</li>
+ <li id="klein">javax.net.ssl.trustStorePassword=Passwort f�r
+ den Truststore (optional; nur, wenn SSL Client-Authentisierung
+ durchgef�hrt werden soll). </li>
+ <li id="klein">javax.net.ssl.trustStoreType=Truststore-Typ
+ (optional; nur, wenn SSL Client-Authentisierung durchgef�hrt
+ werden soll). Je nach verwendetem Keystore-Typ ist "jks"
+ oder "pkcs12" �blich.</li>
+ </ul>
+ Diese Java System-Properties werden Tomcat �ber die Umgebungsvariable
+ CATALINA_OPTS mitgeteilt. Die Dateien $MOA_SPSS_INST/tomcat/moa-env.bat
+ und <br />
+ $MOA_SPSS_INST/tomcat/moa-env.sh enthalten Beispiele zum Setzen
+ dieser Umgebungsvariablen unter Windows bzw. Unix/Linux.
+ </ul>
</div>
</td></tr></table>
@@ -232,7 +283,7 @@ Konnte das MOA-SPSS Webservice nicht ordnungsgem�� konfiguriert und gestartet we
</pre>
In diesem Fall geben die WARN bzw. ERROR Log-Meldungen unmittelbar davor Aufschluss �ber den genaueren Grund.
</div>
-</td></tr></table>
+</div></td></tr></table>
<div id="Logging" />
@@ -335,7 +386,7 @@ In diesem Fall gibt der mitgeloggte Stacktrace Auskunft �ber die Art des Fehlers
<br /><br />
Die Tats�chlich �bertragenen Anfragen bzw. Antworten werden aus Effizienzgr�nden nur im Log-Level DEBUG angezeigt.
</div>
-</td></tr></table>
+</div></td></tr></table>
<br /><br />
@@ -351,5 +402,5 @@ Die Tats�chlich �bertragenen Anfragen bzw. Antworten werden aus Effizienzgr�nden
</div>
-</body>
+</div></div></div></div></body>
</html> \ No newline at end of file