diff options
Diffstat (limited to 'spss.server/doc/moa_spss/sp-admin_1.htm')
| -rw-r--r-- | spss.server/doc/moa_spss/sp-admin_1.htm | 119 |
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>  <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 |