Information Center

Konfigurations-Servlet konfigurieren

Standardm��ig verwenden Host On-Demand-Clients Port 8999 f�r den Zugriff auf Konfigurationsdaten vom Service-Manager. Bei Host On-Demand-Clients, die mit dem HTML-basierten Modell erstellt werden, sind alle Konfigurationsdaten f�r die Hostsitzung in den HTML-Dateien selbst enthalten. Clients, die unter Verwendung des HTML-basierten Modells erstellt wurden, m�ssen ausschlie�lich dann auf den Server zugreifen, wenn die Z�hlung der Lizenzverwendung aktiviert ist. Sie k�nnen die Lizenzverwaltung inaktivieren, indem Sie im Fenster 'HTML-Parameter' unter 'Erweiterte Optionen' im Implementierungsassistenten einen Parameter 'Disable' mit dem Wert 'LUM' hinzuf�gen.

Wenn sich Ihre Clients au�erhalb einer Firewall befinden, muss der Firewall-Administrator beide Ausg�nge (intern und extern) f�r Port 8999 �ffnen. Sie k�nnen das �ffnen dieses Ports jedoch verhindern, indem Sie Ihre Clients so anpassen, dass das Konfigurations-Servlet f�r den Zugriff auf die Konfigurationsdaten verwendet wird. Das Konfigurations-Servlet �bertr�gt die Konfigurationsdaten im Tunnelungsverfahren �ber eine HTTP- oder HTTPS-Verbindung vom Client an den Konfigurationsserver und verwendet hierbei den definierten Konfigurationsserver-Port. Informationen zur Installation des Konfigurationsservlets finden Sie im Abschnitt �ber die Installation des Konfigurationsservlets des Buchs Host On-Demand planen, installieren und konfigurieren.

Servlet-Parameter konfigurieren

Das Konfigurations-Servlet von Host On-Demand kennt die unten aufgef�hrten Parameter. Anweisungen zur �bergabe von Parametern an ein Servlet finden Sie in den Dokumentationen zum Web-Server und zur Servlet-Steuerkomponente.

Parameter Standardwerte Beschreibung
ConfigServer 127.0.0.1 Hostname oder IP-Adresse des Host On-Demand-Servers.
ConfigServerPort 8999 Nummer des Ports, an dem der Service Manager von Host On-Demand empfangsbereit ist.
BufferSize 4096 Gr��e des Puffers f�r Eingabe- bzw. Ausgabedatenstr�me
PoolSize 5 Gr��e des zu verwaltenden Puffer- bzw. Socket-Pools. Bei PoolSize = 0 wird kein Pool verwendet.
Trace false Bei dem Wert 'true' schreibt das Konfigurations-Servlet Nachrichten in die Protokolldatei der Servlet-Steuerkomponente und schickt sie, falls gew�nscht, auch an den Browser; die Nachrichten dienen zur Fehlerbehebung.
ShowStatsfalse Bei dem Wert 'true' kann das Konfigurations-Servlet, bei entsprechenden Browser-Anforderungen, Konfigurationsdaten und -statistiken zur�ckgeben.

Clientparameter

Die Host On-Demand-Clients kennen, wie der Verwaltungs-Client (HODAdmin.html) und der zwischengespeicherte Client (HODCached.html), die folgenden Parameter:

Parameter Standardwerte Beschreibung
ConfigServer Host On-Demand-Server Hostname des Host On-Demand-Servers. Als Standardwert wird der Hostname aus der Clientadresse verwendet.
ConfigServerPort 8999 Nummer des Ports, an dem der Service Manager von Host On-Demand empfangsbereit ist.
ConfigServerURL Kein Standardwert Adresse oder Aliasname des Konfigurations-Servlets von Host On-Demand

Sie k�nnen Clientparameter im HTML-Code des Clients oder in der Datei 'config.properties', die Sie im Publikationsverzeichnis (dasselbe Verzeichnis wie das der Client-HTML-Dateien auf dem Server) speichern m�ssen, einstellen; Sie k�nnen aber auch zulassen, dass die Clients die Standardparameterwerte verwenden. Wenn die Clients geladen werden, suchen sie zun�chst im HTML-Code nach Parametern. Sind dort keine angegeben, suchen sie in der Datei 'config.properties', sofern diese Datei vorhanden ist. Wenn die Datei 'config.properties' keine Parameter enth�lt oder gar nicht vorhanden ist, verwenden die Clients die Standardeinstellungen. Die Datei 'config.properties' ist eine ASCII- oder UTF-8-Textdatei und enth�lt Wertepaare im Format name=wert. Zeilen, die mit dem Zeichen "#" beginnen, werden als Kommentarzeilen behandelt.

Wenn Sie 'config.properties' f�r einen z/OS-Server bearbeiten m�ssen, �bertragen Sie die Datei zun�chst bin�r an ein ASCII-System wie Windows oder Unix. Bearbeiten Sie die Datei, und �bertragen Sie sie anschlie�end wieder bin�r an das z/OS-System. Wenn Sie eine Datei 'config.properties' erstellen m�ssen, tun Sie dies auf einem ASCII-System, und �bertragen Sie die Datei anschlie�end bin�r an den z/OS-Server. Diese Ma�nahme ist notwendig, weil die Client-Applets in der Datei 'config.properties' ASCII-Text erwarten, auf dem z/OS-System erstellte Dateien jedoch in EBCDIC gespeichert werden.

Wenn Sie zum Beispiel den Standardwert f�r die Portnummer, die der Client f�r die Verbindung zum Service Manager verwendet, von 8999 in 12345 �ndern wollen, f�gen Sie den Eintrag 'ConfigServerPort=12345' als einzelne Zeile in die Datei 'config.properties' ein.

Befindet sich im Publikationsverzeichnis eine Datei mit dem Namen 'config.properties', wird sie von allen Clients verwendet. Wenn Sie wollen, dass manche Clients eigene eindeutige Einstellungen verwenden, k�nnen Sie die Optionen f�r die Serververbindung im Fenster 'Erweiterte Optionen' des Implementierungsassistenten konfigurieren, wenn Sie die HTML-Clientdateien erstellen oder bearbeiten.

Wenn Sie die Optionen zur Serververbindung f�r eine bestimmte HTML-Clientdatei angeben, �berschreiben die ausgew�hlten Optionen alle Systemwerte, die m�glicherweise in der Datei 'config.properties' definiert sind, beispielsweise also solche Werte, die Sie w�hrend des Installationsprozesses f�r Host On-Demand angegeben haben.

Der Implementierungsassistent kann nicht verwendet werden, um manuell erstellte HTML-Dateien zu bearbeiten. Au�erdem k�nnen Sie mit dem Implementierungsassistenten keine HTML-Dateien bearbeiten, die Sie mit dem Assistenten erstellt, sp�ter jedoch manuell bearbeitet haben.

Debug-Informationen

Das Konfigurations-Servlet kann Ihnen Trace-, Konfigurations- und Statistikdaten f�r die Fehlerbehebung zur Verf�gung stellen. Sie erhalten Zugriff auf Trace-Daten, indem Sie im Konfigurations-Applet f�r den Parameter 'Trace' den Wert 'true' einstellen. Laden Sie zur Anzeige der Trace-Daten in Ihrem Browser die Seite http://server_name/servlet_alias/HODConfig/trace. Die Trace-Daten des Konfigurations-Servlets werden im Browser angezeigt und in die Protokolldatei der Servlet-Steuerkomponente geschrieben.

Sie erhalten Zugriff auf Konfigurations- und Statistikdaten, indem Sie im Konfigurations-Applet f�r den Parameter 'ShowStats' den Wert 'true' einstellen. Laden Sie zur Anzeige der Daten im Browser die Seite http://server_name/servlet_location/HODConfig/info.

Zugeh�rige Abschnitte: