diff options
Diffstat (limited to 'spss.server/doc')
-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 |