diff options
Diffstat (limited to 'spss.server/doc/moa_spss/sp-admin_3.htm')
| -rw-r--r-- | spss.server/doc/moa_spss/sp-admin_3.htm | 237 |
1 files changed, 0 insertions, 237 deletions
diff --git a/spss.server/doc/moa_spss/sp-admin_3.htm b/spss.server/doc/moa_spss/sp-admin_3.htm deleted file mode 100644 index 2e8152abf..000000000 --- a/spss.server/doc/moa_spss/sp-admin_3.htm +++ /dev/null @@ -1,237 +0,0 @@ -<html> -<head> - <title>MOA SP/SS-Administration</title> - <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> - <meta content="heinz.rosenkranz@brz.gv.at" name="author"/> - -<style type="text/css"> - body { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; } - td { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; } - th { font-family:"Verdana", "Arial"; font-size:10pt; font-weight:bold; color:#d8d8d8; background:#505050} - li { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; margin-top:3px } - ul { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; margin-top:3px } - tt { font-size:9pt; color:#505060; } - #titel { font-family:"Verdana", "Arial"; font-size:18pt; color:#505060; } - #subtitel { font-family:"Verdana", "Arial"; font-size:12pt; font-weight:bold; color:#505060; } - #slogan { font-family:"Verdana", "Arial"; font-size:8pt; color:#808090; text-align:justify; width:160px } - #block { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; text-align:justify } - #klein { font-family:"Verdana", "Arial"; font-size:9pt; color:#505060; margin-top:3px } - #info { font-family:"Verdana", "Arial"; font-size:8pt; color:#505060; padding:3px; border:solid 1px #c0c0c0 } - #infolist { font-family:"Verdana", "Arial"; font-size:8pt; color:#505060; } - a:link {color:#000090} - a:visited {color:#000090} - a:hover {color:#c03030} - a {text-decoration: none} -</style> - -<script language="JavaScript"> -<!-- -function goWin(url) { - Fenster=window.open(url,"smallWin","toolbar=0,location=0,directories=0,status=0,menubar=0,resizable=yes,scrollbars=yes,width=500,height=480,top=20,screenY=0,left=20,screenX=0"); - window.setTimeout("showWin()",300); -} -function showWin() { Fenster.focus(); } -// --> -</script> -</head> - -<body bgcolor="#FFFFFF" > -<div style="width:650px"> - -<!-- Projekt-Logo --> -<div style="height:42px; font-size:16pt; color:#b0b8c0; background:#003050"> - Module f�r Online-Applikationen -</div> -<div style="margin-left:8px; margin-top:3px; font-size:8pt; color:#707070; "> -<!-- Development Center der BRZ GmbH, A-Trust und IAIK Graz -->  -</div> -<div style="margin-top:-65px; text-align:right; font-size:8pt; font-weight:bold; color:#d04040;" > -Projekt <span style="font-size:48pt; ">moa</span>  -</div> -<br /> - -<!-- First Section with Navigation --> -<table width="650" border="0" cellpadding="10" cellspacing="0"> -<tr> -<td width="170" valign="top"> -<div style="font-weight:bold; margin-top:12px">MOA-SP/SS</div><br /> -<div id="klein"><a href="sp-admin.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> - <b> �bersicht</b></a></div> -<div id="klein"><a href="sp-admin_1.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> - <b> Basis-Installation<br />    (Webservice)</b></a></div> -<div id="klein"><a href="sp-admin_4.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> - <b> Basis-Installation<br />    (Klassenbibliothek)</b></a></div> -<div id="klein"><a href="sp-admin_2.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> - <b> Konfiguration </b></a></div> -<div id="klein"><img src="../moa_images/select.gif" border="0" width="13" height="14" /> - <b> Optionale<br />    Komponenten</b></div> -<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 /> -<div id="slogan"> -<b>Optionale <br />Komponenten</b><br /> -<a href="#IIS"><b>IIS </b></a><br /> -<a href="#Apache"><b>Apache </b></a><br /> -<a href="#HSM"><b>HSM </b></a><br /> -<a href="#SQL"><b>PostgreSQL </b></a><br /> -</div> -</td> - -<div id="IIS" /> -<td valign="top"> -<p id="titel">Konfiguration der optionalen Komponenten</p> -<p id="subtitel">Konfiguration des Microsoft Internet Information Server (optional)</p> -<div id="block"> -Den MOA SP/SS Webservices kann optional ein MS IIS vorgeschaltet sein. In diesem Fall �bernimmt der MS IIS die HTTP- bzw. HTTPS-Kommunikation mit dem Aufrufer des Webservices. Die Kommunikation zwischen MS IIS und dem in Tomcat deployten Webservice wird durch Jakarta mod_jk durchgef�hrt. Die angef�hrten Konfigurationsschritte gehen von einer MS IIS Standard-Installation aus.<br /><br /> -<b>Konfiguration von Jakarta mod_jk im MS IIS</b><br /> -F�r die Kommunikation des MS IIS mit dem im Tomcat deployten Webservice wird das ISAPI-Modul von Jakarta mod_jk im MS IIS installiert und konfiguriert. Eine detaillierte Installations- und Konfigurationsanleitung gibt das <a href="http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/jk/iishowto.html" target="_new">mod_jk IIS HowTo</a>. Beispiele f�r <tt>workers.properties</tt> und <tt>uriworkermap.properties</tt> Dateien liegen im Verzeichnis $MOA_SPSS_INST/tomcat bei. -<br /><br /> -<b>Konfiguration von Tomcat</b><br /> -Damit Tomcat die Aufrufe, die von MS IIS mittels Jakarta mod_jk weiterleitet, entgegennehmen kann, muss in $CATALINA_HOME/conf/server.xml der AJP 1.3 Connector aktiviert werden. Im Gegenzug k�nnen die Connectoren f�r HTTP und HTTPS deaktiviert werden. Das geschieht am einfachsten durch Ein- bzw. Auskommentieren der entsprechenden <tt>Connector</tt> Konfigurations-Elemente in dieser Datei. Die Datei $MOA_SPSS_INST/tomcat/server.mod_jk.xml enth�lt eine Konfiguration, die ausschlie�lich den Port f�r den mod_jk Connector offen l�sst. -<br /><br /> -</div> -<div id="block"> -<b>Konfiguration von SSL</b><br /> -Die Dokumentation zum Einrichten von SSL auf dem MS IIS steht nach Installation des IIS unter http://localhost/iisHelp/ bzw. <a href="http://www.microsoft.com/windows2000/en/server/iis/default.asp" target="_new">online</a> zur Verf�gung. -</div> -</td></tr></table> -<br /><br /> - - -<div id="Apache" /> -<table width="650" border="0" cellpadding="10" cellspacing="0"> -<tr> -<td width="170" valign="top" id="klein"> -<p id="subtitel"> </p> -<div id="slogan"> -<br /><br /> -</div> -</td> -<td valign="top"> -<p id="subtitel">Konfiguration des Apache Webservers (optional)</p> -<div id="block"> -Den MOA SP/SS Webservices kann ein Apache Webserver vorgeschaltet sein. Das Prinzip funktioniert wie bei MS IIS, auch hier wird Jakarta mod_jk f�r die Kommunikation zwischen Webserver und Tomcat eingesetzt. Die angef�hrten Konfigurationsschritte gehen von einer Standard-Installation des Apache Webservers aus und sind ident f�r die Versionen 1.3.x und 2.0.x. -<br /><br /> -<b>Konfiguration von Jakarta mod_jk im Apache Webserver</b><br /> - Um das MOA-SPSS Webservice hinter einem Apache Webserver zu betreiben, ist die Konfiguration des Apache-Moduls mod_jk erforderlich. Eine detaillierte Installations- und Konfigurationsanleitung gibt das <a href="http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/jk/aphowto.html" target="_new">mod_jk Apache HowTo</a>. Ein Beispiel f�r eine <tt>workers.properties</tt> Datei liegt im Verzeichnis $MOA_SPSS_INST/tomcat bei.<br /> -Um das MOA SP/SS Webservice dem Apache Webserver bekannt zu machen, sind zumindest folgende Eintr�ge im globalen Kontext der Apache-Konfigurationsdatei notwendig: -<pre> - LoadModule jk_module /usr/lib/apache/mod_jk.so - AddModule jk_module - JkOptions +ForwardKeySize +ForwardURICompat - -ForwardDirectories - JkWorkersFile conf/workers.properties - JkMount /moa-spss/* moaworker -</pre> - -Die Pfad- und Dateinamen k�nnen je nach existierender Apache Installation geringf�gig variieren. - -<br /><br /> -<b>Konfiguration von Tomcat</b><br /> -Die Konfiguration von Tomcat ist analog wie im Abschnitt �ber den MS IIS durchzuf�hren. -<br /><br /> - -<b>Konfiguration von SSL mit mod_SSL </b><br /> -Apache kann in Verbindung mit mod_SSL als SSL-Endpunkt f�r das MOA SP/SS Webservice fungieren. In diesem Fall entf�llt die SSL-Konfiguration in Tomcat, da Apache und Tomcat auch im Fall von SSL Daten via mod_jk austauschen. Eine detaillierte Installations- und Konfigurationsanleitung von mod_SSL gibt die <a href="http://www.modssl.org/docs/" target="_new">Online-Dokumentation</a>. -<br /><br /> -Bei der Verwendung von Client-Authentisierung muss darauf geachtet werden, dass mod_ssl die HTTP-Header mit den Informationen �ber das Client-Zertifikat exportiert. Dies wird durch Angabe der Option<br /> -<pre> - SSLOptions +ExportCertData +StdEnvVars -</pre> -in der Apache-Konfiguration erreicht. Je nach vorhandener SSL-Konfiguration des Apache Webservers kann diese Option im globalen Kontext, im Kontext des Virtual Hosts oder im Kontexts eines Verzeichnisses spezifiziert werden.<br /> - -</div> -</td></tr></table> -<br /><br /> - - -<div id="HSM" /> -<table width="650" border="0" cellpadding="10" cellspacing="0"> -<tr> -<td width="170" valign="top" id="klein"> -<p id="subtitel"> </p> -<div id="slogan"> -<br /><br /> -</div> -</td> -<td valign="top"> -<p id="subtitel">HSM, am Beispiel Eracom protectserver orange external (optional) </p> -<div id="block"> -Eracom protectserver orange external wird gem�� der Installationsanleitung installiert. -<p> -Die Bibliotheken in $MOA_SPSS_INST/pkcs11 m�ssen anschlie�end in den Library-Pfad -des jeweiligen Betriebssystems kopiert werden (Windows 2000: ein Verzeichnis, das -in der Umgebungsvariablen PATH vorhanden ist; Linux: ein Verzeichnis, das in der -Umgebungsvariablen LD_LIBRARY_PATH vorhanden ist). Der Name der PKCS#11-Bibliothek -wird als Wert des Attributs <a href="sp-admin_2.htm#HardwareKeyModule"> -<tt>/MOAConfiguration/HardwareKeyModule/@name</tt></a> in der -Konfigurationsdatei verwendet. -<br /> -<br /><br /> -</div> -</td></tr></table> - - -<div id="SQL" /> -<table width="650" border="0" cellpadding="10" cellspacing="0"> -<tr> -<td width="170" valign="top" id="klein"> -<p id="subtitel"> </p> -</td> -<td valign="top"> -<p id="subtitel">Konfiguration von PostgreSQL (optional)</p> -<div id="block"> -Die MOA SP/SS Module k�nnen PostgreSQL zum Zwischenspeichern von Certificate Revocation Lists (CRLs) und zum Abspeichern von Log-Meldungen verwenden. In beiden F�llen wird eine installierte und konfigurierte Datenbank vorausgesetzt. Eine detaillierte �bersicht �ber die Installation und Konfiguration von PostgreSQL gibt die <a href="http://techdocs.postgresql.org/">Online-Dokumentation</a>. <b>Hinweis:</b> Eine M�glichkeit, PostgreSQL unter MS Windows zu installieren, besteht darin, <a href="http://sources.redhat.com/cygwin/">Cygwin</a> mit dem PostgreSQL-Package zu installieren. Alternative Installationsvarianten werden auf <a href="http://techdocs.postgresql.org/guides/Windows">dieser Seite</a> angef�hrt.<br /><br /> -<b>Anlegen eines Benutzers und einer Datenbank f�r MOA</b><br /> -Damit die MOA SP/SS Module eine Verbindung zu PostgreSQL aufbauen kann, m�ssen der Name eines PostgreSQL-Benutzers und einer -Datenbank bekannt sein. Sollten diese nicht vorhanden sein, kann mit folgenden Kommandos ein Benutzer namens <tt>moa</tt> und eine Datenbank namens <tt>moadb</tt> angelegt werden: <br /> -<pre> - createuser -U postgres -d -A -P moa - createdb -U moa moadb -</pre> - -Da die MOA SP/SS Module �ber JDBC mit der Datenbank kommunizieren, ist in der Folge die Angabe einer JDBC-URL notwendig, die die Verbindungsparameter enth�lt. Wurden der Benutzer und die Datenbank wie im obigen Beispiel angelegt, ist folgende JDBC-URL anzugeben (durchgeschrieben, in einer Zeile): -<pre> - jdbc:postgresql://host/moadb?user=moa& - password=moapass -</pre> -(Annahme: als Passwort f�r den Benutzer <tt>moa</tt> wurde <tt>moapass</tt> gew�hlt). -Die Zeichen <tt>jdbc:postgresql://</tt> sind unver�nderliche Bestandteile einer PostgreSQL JDBC-URL. <tt>host</tt> gibt den Rechner an, auf dem PostgreSQL l�uft. Der n�chste Parameter (<tt>moadb</tt>) identifiziert den Namen der Datenbank. �ber die Parameter <tt>user=</tt> und <tt>pass=</tt> werden Benutzer und Passwort bekanntgegeben. - - -<br /><br /> - -<b>Caching von CRLs</b><br /> -Zum Cachen von CRLs m�ssen in der MOA SP/SS Konfigurationsdatei die Eintr�ge <tt>archiveRevocationInfo</tt> auf <tt>true</tt> und <tt>DataBaseArchiveParameter.JDBCUrl</tt> auf eine g�ltige JDBC-URL gesetzt werden. Da es sich hier um einen Eintrag in eine XML-Datei handelt, muss das Zeichen "&" in der oben gezeigten JDBC-URL durch die Zeichenfolge "&amp;" ersetzt werden. -<br /><br /> -<b>Logging</b><br /> -F�r das Logging in eine PostgreSQL Datenbank mittels Jakarta Log4j muss zun�chst eine Tabelle f�r die Log-Meldungen angelegt werden. Dies kann mit folgendem SQL-Statement erreicht werden: -<pre> - create table spss_log - (log_time timestamp, - log_level varchar(5), - log_msg text); -</pre> -Um das Logging in die Datenbank Log4j bekannt zu machen, muss die Log4j-Konfiguration adaptiert werden. Die Datei $MOA_SPSS_INST/conf/moa-spss/log4j.properties enth�lt bereits eine beispielhafte Jakarta Log4j-Konfiguration f�r das Logging in eine PostgreSQL Datenbank, die standardm��ig ausgeschaltet ist. Wie beim Caching von CRLs ist auch hier die Angabe einer JDBC-URL notwendig, damit die MOA SP/SS Module eine Verbindung zur Datenbank aufnehmen k�nnen.<br /> -<b>Hinweis:</b> Bei Tests hat sich das Logging in eine Datenbank mit Jakarta Log4j als Performance-Engpass herausgestellt. Es wird deshalb empfohlen, auf dieses Feature zu verzichten. -<br /><br /> -</div> - -</td></tr></table> -<br /><br /> - - - -<table width="650" border="0" cellpadding="10" cellspacing="0"> -<tr> -<td width="170" valign="top"><br /></td> -<td valign="top"> -<hr /> -<div style="font-size:8pt; color:#909090">© 2003 <!-- Development Center, BRZ GmbH --></div> -</td></tr></table> -<br /> - - -</div> -</body> -</html>
\ No newline at end of file |