From be7dd529e039636f6a3bfef50d037afcec3f04d2 Mon Sep 17 00:00:00 2001 From: gregor Date: Tue, 19 Apr 2005 14:24:56 +0000 Subject: =?UTF-8?q?Zwischenspeicherung:=20Starten/Stoppen=20von=20Tomcat?= =?UTF-8?q?=20und=20Konfigurations=C3=A4nderungen=20im=20laufenden=20Betri?= =?UTF-8?q?eb=20hinzugef=C3=BCgt.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@309 d688527b-c9ab-4aba-bd8d-4036d912da1d --- spss.handbook/handbook/install/install.html | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) (limited to 'spss.handbook/handbook') diff --git a/spss.handbook/handbook/install/install.html b/spss.handbook/handbook/install/install.html index 0a31cb42c..b380cdd40 100644 --- a/spss.handbook/handbook/install/install.html +++ b/spss.handbook/handbook/install/install.html @@ -45,7 +45,7 @@
  • Prüfen des erfolgreichen Starts
    • -
  • Änderung der Konfiguration im laufenden Betrieb
    • +
  • Änderung der Konfiguration im laufenden Betrieb
    • @@ -114,7 +114,7 @@

    Die Konfiguration des HTTPS Connectors kann entfallen, wenn Tomcat ein Webserver vorgeschaltet ist, und dieser die SSL-Kommunikation mit dem Kunden übernimmt (siehe Abschnitt 2.2.1).

    2.1.2.2.3 Einrichten des MOA SP/SS Administrators
    -

    Das MOA SP/SS Webservice kann remote durch den Aufruf einer speziellen URL des Webservices dazu veranlasst werden, seine Konfiguration neu einzulesen. Der Zugriff auf diese URL ist durch eine Passwort-Abfrage geschützt, und kann nur von Tomcat-Benutzern aufgerufen werden, denen die Tomcat-Benutzer-Rolle moa-admin zugeordnet wurde.

    +

    Das MOA SP/SS Webservice kann remote durch den Aufruf einer speziellen URL des Webservices dazu veranlasst werden, seine Konfiguration neu einzulesen (vergleiche Abschnitt 2.1.2.5). Der Zugriff auf diese URL ist durch eine Passwort-Abfrage geschützt, und kann nur von Tomcat-Benutzern aufgerufen werden, denen die Tomcat-Benutzer-Rolle moa-admin zugeordnet wurde.

    Um diese Benutzer-Rolle und einen oder mehrere Benutzer einzurichten, müssen in der Datei $CATALINA_HOME/conf/tomcat-users.xml unter dem Element <tomcat-users> sinngemäß folgende Einträge hinzugefügt werden: 

    <role rolename="moa-admin"/> 
@@ -146,26 +146,33 @@
 
    2.1.2.4.2 Unter Unix
    
 
    Zunächst müssen die  in Abschnitt 2.1.2.3 besprochenen System Properties mit Hilfe der Umgebungsvariablen CATALINA_OPTS gesetzt sein. Die Datei $MOA_SPSS_INST/tomcat/unix/moa-env.sh enthält ein Beispiel dafür. Weiters müssen noch die Umgebungsvariablen JAVA_HOME (Basisverzeichnis des eingesetzten J2SE SDK) und CATALINA_HOME (Basisverzeichnis der eingesetzten Tomcat-Installation) angepasst werden.
    
 
    Nun kann Tomcat aus seinem Basisverzeichnis mit 
    
-
        bin/catalina.sh start
    
+
    bin/catalina.sh start
    
 gestartet werden. Das Stoppen von Tomcat erfolgt analog mit
-
        bin/catalina.sh stop
    
+
    bin/catalina.sh stop
    
 
    2.1.2.4.3 Prüfen des erfolgreichen Starts 
    
 
    
-  
    Ein erfolgreicher Startvorgang ist an folgender Log-Meldung ersichtlich: 
    
+  
    Ein erfolgreicher Start des MOA SP/SS Webservices ist an folgender Log-Meldung ersichtlich: 
    
   
    
 
    
-
        INFO | 18 10:09:45,155 | main | TID=startup NID=<null> MSG=MOA Konfiguration erfolgreich geladen
+
    INFO | 18 10:09:45,155 | main | TID=startup NID=<null> MSG=MOA Konfiguration erfolgreich geladen
 
    
 
    Bei leichten Fehlern in der Konfiguration geben WARN Log-Meldungen unmittelbar davor Aufschluss über fehlerhafte Konfigurations-Einträge.
   Nach dem Starten von Tomcat steht das MOA SP/SS Webservice für die Server-Signatur und Signatur-Prüfung unter den Endpunkten 
    
-
        http://<host>:<port>/moa-spss/services/SignatureCreation
+
    http://<host>:<port>/moa-spss/services/SignatureCreation
 
    
 
    bzw.
 
    
-
        http://<host>:<port>/moa-spss/services/SignatureVerification
+
    http://<host>:<port>/moa-spss/services/SignatureVerification
 
    
 
    zur Verfügung. Die Verfügbarkeit des Services können Sie einfach überprüfen, indem Sie die Endpunkte mit einem Web-Browser aufgerufen; dies sollte nach erfolgreichem Start zur Anzeige einer Informationsseite führen. 
    
-
      
    
+
    Konnte das MOA SP/SS Webservice nicht ordnungsgemäß  gestartet werden, führt das zu folgender Log-Meldung:
    
+
    FATAL | 18 10:17:03,475 | main | TID=startup NID=<null> 
      MSG=Fehler beim Lesen der MOA Konfiguration: das Service steht nicht zur Verfügung
+
    
+In diesem Fall geben die WARN bzw. ERROR Log-Meldungen unmittelbar davor Aufschluss über den genaueren Grund.
+
    2.1.2.5 Änderung der Konfiguration im laufenden Betrieb 
    
+
     Sie können die Konfiguration für MOA SP/SS im laufenden Betrieb aktualisieren, in dem Sie mittels eines Web-Browsers folgende URL aufrufen:
    
+
     http://<host>:<port>/moa-spss/ConfigurationUpdate 
    
+
    Damit dies funktioniert, muss in der Konfiguration von Tomcat ein spezieller Benutzer sowie eine spezielle Benutzerrolle eingerichtet werden (vergleiche Abschnitt 2.1.2.2.3). 
    
 
    2.2 Erweiterungsmöglichkeiten
    
 
    Ausgehend von der Basisinstallation können die optionalen Erweiterungen, die in den nachfolgenden Abschnitten beschrieben werden, unabhängig und in beliebiger Kombination aufgesetzt werden.
    
   
    2.2.1 Vorgeschalteter Webserver
    
-- 
cgit v1.2.3