From 1e26d40c195612c03561b359058bd45fd20578d6 Mon Sep 17 00:00:00 2001 From: gregor Date: Fri, 11 Jul 2003 09:38:10 +0000 Subject: Bugs 8 and 9 fixed. git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@9 d688527b-c9ab-4aba-bd8d-4036d912da1d --- spss.server/doc/moa_spss/sp-admin_1.htm | 119 +++++++++++++++++++++++--------- 1 file changed, 85 insertions(+), 34 deletions(-) (limited to 'spss.server/doc/moa_spss') 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 moa 
Zurück
-

+
Installationsschritte: -

+
Vorbereitung
Tomcat Konfiguration
Webservice Deployment
@@ -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.

Installation der IAIK JCE im JDK 1.4.1
-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 Download-Seite für das JDK 1.4.1 in der Sektion "Other Downloads". -

+ 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 Download-Seite + für das JDK 1.4.1 in der Sektion "Other Downloads".
+
- +
@@ -153,32 +160,76 @@ Um diese Benutzer-Rolle und einen oder mehrere Benutzer einzurichten, m

Deployment des MOA SP/SS Webservices in Tomcat

Um das MOA SP/SS Webservice in Tomcat für den Ablauf vorzubereiten, sind folgende Schritte notwendig:
-
    -
  • 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.
    • -
  • 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).
    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.
    • -
  • 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: -
      -
    • Xerces-J-2.0.2 (bestehend aus xercesImpl.jar und xmlParserAPIs.jar).
      • -
    -Eventuell vorhandene Dateien mit dem gleichen Namen müssen ersetzt werden. -
    • -
  • 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: -
      -
    • Xalan-J-2.2.0 (bestehend aus xalan.jar.jar und bsf.jar).
      • -
    -Eventuell vorhandene Dateien mit dem gleichen Namen müssen ersetzt werden. -
    • -
  • Folgende Java System-Properties können optional gesetzt sein:
    -
      -
    • 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 WEB-INF/conf enthaltene Default-Konfiguration herangezogen.
      • -
    • 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 WEB-INF/classes enthaltene Default-Konfiguration herangezogen.
      • -
    • 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.
      • -
    • 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.
      • -
    • javax.net.ssl.trustStorePassword=Passwort für den Truststore (optional; nur, wenn SSL Client-Authentisierung durchgeführt werden soll).
      • -
    • 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.
      • -
    -Diese Java System-Properties werden Tomcat über die Umgebungsvariable CATALINA_OPTS mitgeteilt. Die Dateien $MOA_SPSS_INST/tomcat/moa-env.bat und
    $MOA_SPSS_INST/tomcat/moa-env.sh enthalten Beispiele zum Setzen dieser Umgebungsvariablen unter Windows bzw. Unix/Linux. -
+
    +
  • 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.
    • +
  • 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).
    + 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.
    • +
  • 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: +
      +
    • Xerces-J-2.0.2 (bestehend aus xercesImpl.jar + und xmlParserAPIs.jar).
      • +
    + Eventuell vorhandene Dateien mit dem gleichen Namen müssen ersetzt + werden.
    • +
  • 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: +
      +
    • Xerces-J-2.0.2 (bestehend aus xercesImpl.jar + und xmlParserAPIs.jar).
      • +
    • Xalan-J-2.2.0 (bestehend aus xalan.jar.jar + und bsf.jar).
      • +
    + Eventuell vorhandene Dateien mit dem gleichen Namen müssen ersetzt + werden.
    • +
  • Folgende Java System-Properties können optional gesetzt sein:
    +
      +
    • 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 WEB-INF/conf + enthaltene Default-Konfiguration herangezogen.
      • +
    • 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 WEB-INF/classes + enthaltene Default-Konfiguration herangezogen.
      • +
    • 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.
      • +
    • 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.
      • +
    • javax.net.ssl.trustStorePassword=Passwort für + den Truststore (optional; nur, wenn SSL Client-Authentisierung + durchgeführt werden soll).
      • +
    • 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.
      • +
    + Diese Java System-Properties werden Tomcat über die Umgebungsvariable + CATALINA_OPTS mitgeteilt. Die Dateien $MOA_SPSS_INST/tomcat/moa-env.bat + und
    + $MOA_SPSS_INST/tomcat/moa-env.sh enthalten Beispiele zum Setzen + dieser Umgebungsvariablen unter Windows bzw. Unix/Linux. +
@@ -232,7 +283,7 @@ Konnte das MOA-SPSS Webservice nicht ordnungsgem In diesem Fall geben die WARN bzw. ERROR Log-Meldungen unmittelbar davor Aufschluss über den genaueren Grund.
- +
@@ -335,7 +386,7 @@ In diesem Fall gibt der mitgeloggte Stacktrace Auskunft

Die Tatsächlich übertragenen Anfragen bzw. Antworten werden aus Effizienzgründen nur im Log-Level DEBUG angezeigt.
- +

@@ -351,5 +402,5 @@ Die Tats - + \ No newline at end of file -- cgit v1.2.3