Konfigurationsscripts für Servereinstellungen

Die Scripting-Bibliothek enthält mehrere Scriptprozeduren für die Automatisierung Ihrer Anwendungsserverkonfigurationen. Verwenden Sie die Scripts für Anwendungsserver, um Klassenlader, JVM-Einstellungen, EJB-Container, Leistungsüberwachung, den dynamischen Cache usw. zu konfigurieren. Sie können jedes Script einzeln ausführen oder Prozeduren kombinieren, um angepasste Automationsscripts für Ihre Umgebung zu erstellen.

Alle Scriptprozeduren für die Serververwaltung befinden sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers/scriptLibraries/servers/V70.

Verwenden Sie die folgenden Scriptprozeduren, um Web-Container für Ihren Anwendungsserver zu konfigurieren:
Verwenden Sie die folgenden Scriptprozeduren, um Protokolle zu konfigurieren und die Leistung Ihres Anwendungsservers zu überwachen:

configureAdminService

Dieses Script konfiguriert Einstellungen für die Schnittstelle "AdminService". Die Schnittstelle "AdminService" ist die serverseitige Schnittstelle zu den Verwaltungsfunktionen des Anwendungsservers.

Tabelle 1. Beschreibungen der Argumente für "configureAdminService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Protokoll für lokale Verbindungen und dem Protokoll für ferne Verbindungen aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
lokales_Verwaltungsprotokoll Gibt den Typ von Connector an, der verwendet werden soll, um eine lokale Verbindung zwischen der Schnittstelle "AdminService" mit dem Anwendungsserver herzustellen.
fernes_Verwaltungsprotokoll Gibt den Typ von Connector an, der verwendet werden soll, um eine Fernverbindung zwischen der Schnittstelle "AdminService" mit dem Anwendungsserver herzustellen.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute im folgenden Format an: [["enabled", "true"], ["pluginConfigService", "(cells/timmieNode02Cell/nodes/timmieNode01/servers/server1|server.xml#PluginConfigService_1183122130078)"]]

Syntax

AdminServerManagement.configureAdminService(Knotenname, Servername, lokales_Verwaltungsprotokoll, fernes_Verwaltungsprotokoll, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureAdminService(""myNode"", "myServer", "IPC", "SOAP",
    [["enabled", "true"], ["pluginConfigService",
       "(cells/timmieNode02Cell/nodes/timmieNode01/servers/server1|server.xml#PluginConfigService_1183122130078)"]])

configureApplicationServerClassloader

Dieses Script konfiguriert einen Klassenlader für den Anwendungsserver. Klassenlader ermöglichen Anwendungen, die im Anwendungsserver implementiert sind, den Zugriff auf Repositorys mit verfügbaren Klassen und Ressourcen.

Tabelle 2. Beschreibungen der Argumente für "configureApplicationServerClassloader". Führen Sie das Script mit dem Knotennamen, dem Servernamen, der Richtlinie, dem Modus und dem Bibliotheksnamen als Argumenten aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Richtlinie Gibt die Richtlinie für Anwendungsklassenlader an. Die gültigen Werte sind SINGLE und MULTIPLE. Geben Sie SINGLE an, um die Isolation von Anwendungen zu verhindern und den Anwendungsserver so zu konfigurieren, dass ein einziger Anwendungsklassenlader verwendet wird, um alle EJB-Module, gemeinsam genutzten Bibliotheken und abhängigen JAR-Dateien im System zu laden. Geben Sie MULTIPLE an, um Anwendungen zu isolieren und jeder Anwendung einen eigenen Klassenlader bereitzustellen, der EJB-Module, gemeinsam genutzte Bibliotheken und abhängige JAR-Dateien lädt.
Modus Gibt den Klassenladermodus an. Die gültigen Werte sind PARENT_FIRST und APPLICATION_FIRST. Die Option PARENT_FIRST bewirkt, dass der Klassenlader das Laden von Klassen an den übergeordneten Klassenlader delegiert und anschließend versucht, die Klasse über den lokalen Klassenpfad zu laden. Die Option APPLICATION_FIRST bewirkt, dass der Klassenlader zuerst versucht, die Klassen aus seinem lokalen Klassenpfad zu laden, bevor er das Laden der Klassen an seinen übergeordneten Klassenlader delegiert. Diese Richtlinie ermöglicht dem Klassenlader für Anwendungen, eine im übergeordneten Klassenlader vorhandene Klasse zu überschreiben und seine eigene Version bereitzustellen.
Bibliotheksname Gibt den Namen der gewünschten gemeinsam genutzten Bibliothek an.

Syntax

AdminServerManagement.configureApplicationServerClassloader(Knotenname, Servername,
 Richtlinie, Modus, Bibliotheksname)

Verwendungsbeispiel

AdminServerManagement.configureApplicationServerClassloader("myNode", "myServer", "MULTIPLE", "PARENT_FIRST", 
"myLibraryReference")

configureDynamicCache

Dieses Script konfiguriert den dynamischen Cache-Service in Ihrer Serverkonfiguration. Der dynamischer Cache-Service arbeitet in einer JVM des Anwendungsservers und fängt Aufrufe für zwischenspeicherbare Objekte ab. Er fängt z. B. Aufrufe über die Methode "service" eines Servlets oder die Methode "execute" eines Befehls ab und speichert die Ausgabe des Objekts oder stellt den Inhalt des Objekts bereit.

Tabelle 3. Beschreibungen der Argumente für "configureDynamicCache". Führen Sie das Script mit dem Knotennamen, dem Servernamen, der Standardpriorität, der Cachegröße, dem Namen der externen Cachegruppe und dem Typ der externen Cachegruppe als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Standardpriorität Gibt die Standardpriorität für Cacheeinträge an und legt fest, wie lange ein Eintrag in einem vollen Cache bleibt. Geben Sie eine ganze Zahl zwischen 1 und 255 an.
Cachegröße Eine positive ganze Zahl als Wert für die Maximalanzahl der im Cache gespeicherten Einträge. Geben Sie in diesem Feld die Cachegröße ein. Der gültige Wertebereich liegt zwischen 100 und 200000.
Name_der_externen_Cachegruppe Der Name der externen Cachegruppe muss mit der Eigenschaft "ExternalCache", die in der Servlet- bzw. JSP-Datei "cachespec.xml" definiert ist, übereinstimmen. Bei Aktivierung des externen Caching gleicht der Cache Seiten mit seinen URI ab und sendet übereinstimmende Seiten an den externen Cache. Die Einträge können dann aus dem externen Cache bereitgestellt und müssen nicht vom Anwendungsserver abgerufen werden.
Typ_der_externen_Cachegruppe Gibt den Typ der externen Cachegruppe an.
Liste_weiterer_Attribute (Optional) Gibt weitere Konfigurationsoptionen für den dynamischen Cache-Service im folgenden Format an: [["cacheProvider", "myProvider"], ["diskCacheCleanupFrequency", 2], ["flushToDiskOnStop", "true"]]

Syntax

AdminServerManagement.configureDynamicCache(Knotenname, Servername, Standardpriorität,
    Cachegröße, Name_der_externen_Cachegruppe, Typ_der_externen_Cachegruppe,
    Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureDynamicCache("myNode", "myServer", 2, 5000, "EsiInvalidator",
   "SHARED", [["cacheProvider", "myProvider"], ["diskCacheCleanupFrequency", 2], ["flushToDiskOnStop","true"]])

configureEJBContainer

Dieses Script konfiguriert einen EJB-Container in Ihrer Serverkonfiguration. Ein EJB-Container stellt eine Laufzeitumgebung für Enterprise-Beans im Anwendungsserver bereit. Der Container ist für alle Aspekte der Ausführung einer Enterprise-Bean im Anwendungsserver zuständig und wirkt als Vermittler zwischen der benutzerdefinierten Geschäftslogik der Bean und dem Rest der Anwendungsserverumgebung.

Tabelle 4. Beschreibungen der Argumente für "configureEJBContainer". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Auslagerungsverzeichnis und dem JNDI-Namen der Standarddatenquelle als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Auslagerungsverzeichnis Das Verzeichnis, in dem der Container den persistenten Status inaktivierter Stateful-Session-Beans speichert. Dieses Verzeichnis muss bereits vorhanden sein. Es wird nicht automatisch erstellt.
JNDI-Name_der_Standarddatenquelle Der JNDI-Name einer Datenquelle, der zu verwenden ist, wenn keine Datenquelle bei der Implementierung von Anwendungen angegeben wurde. Diese Einstellung ist nur für EJB-2.x-kompatible CMP-Beans gültig.

Syntax

AdminServerManagement.configureEJBContainer(Knotenname, Servername,
Auslagerungsverzeichnis, JNDI-Name_der_Standarddatenquelle)

Verwendungsbeispiel

[Windows]
AdminServerManagement.configureEJBContainer(myNode, myServer, C:\temp\myDir, jndi1)
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
AdminServerManagement.configureEJBContainer(myNode, myServer, /temp/myDir, jndi1)

configureFileTransferService

Dieses Script konfiguriert den Dateiübertragungsservice für den Anwendungsserver. Der Dateiübertragungsservice überträgt Dateien vom Deployment Manager auf einzelne ferne Knoten.

Tabelle 5. Beschreibungen der Argumente für "configureFileTransferService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, der maximal zulässigen Anzahl an Dateiübertragungswiederholungen und der Wartezeit zwischen den Dateiübertragungswiederholungen aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Wiederholungsanzahl Gibt an, wie oft der Dateiübertragungsservice versuchen soll, nach dem Auftreten eines Übertragungsfehlers eine Datei erneut zu senden oder zu empfangen. Der Standardwert ist 3.
Wartezeit_für_Wiederholung Gibt an, wie lange (in Sekunden) der Dateiübertragungsservice warten soll, bevor er versucht, eine fehlgeschlagene Dateiübertragung zu wiederholen. Der Standardwert ist 10.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute im folgenden Format an: [["enable", "true"]]

Syntax

AdminServerManagement.configureFileTransferService(nodeName, serverName, retriesCount, retryWaitTime, otherAttributeList)

Verwendungsbeispiel

AdminServerManagement.configureFileTransferService(myNode, myServer, 5, 600, [["enable", "true"]])

configureListenerPortForMessageListenerService

Dieses Script konfiguriert den Listener-Port für den Nachrichten-Listener-Service in Ihrer Serverkonfiguration. Der Nachrichten-Listener-Service ist eine Erweiterung der JVM-Funktionen des JMS-Providers. Der Service stellt einen Listener-Manager bereit, der einen oder mehrere JMS-Listener steuert und überwacht, die ein JMS-Ziel für eine implementierte Message-driven Bean überwachen.

Tabelle 6. Beschreibungen der Argumente für "configureListenerPortForMessageListenerService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Namen des Listener-Ports, dem JNDI-Namen der Verbindungsfactory, dem JNDI-Namen des Ziels, der maximalen Nachrichtenanzahl, der maximalen Wiederholungsanzahl und der maximalen Sitzungsanzahl als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Name_des_Listener-Ports Der Name, mit dem der Listener-Port für die Administration bezeichnet wird.
JNDI-Name_der_Verbindungsfactory Der JNDI-Name für die JMS-Verbindungsfactory, der vom Listener-Port verwendet werden soll, z. B. jms/connFactory1.
JNDI-Name_des_Ziels Der JNDI-Name für das vom Listener-Port zu verwendende Ziel, z. B. jms/destn1.
maximale_Nachrichtenanzahl Die maximale Anzahl an Nachrichten, die der Listener in einer Transaktion verarbeiten kann.Wenn die Warteschlange leer ist, verarbeitet der Listener-Prozess jede Nachricht, sobald sie ankommt. Jede Nachricht wird in einer separaten Transaktion verarbeitet.
maximale_Wiederholungsanzahl Gibt an, wie oft der Listener versucht, eine Nachricht abzusetzen, bevor er gestoppt wird. Die zulässigen Werte liegen im Bereich von 0 bis 2147483647.Gibt an, wie oft der Listener versucht, eine Nachricht an eine MDB-Instanz abzusetzen, bevor der Listener gestoppt wird.
maximale_Sitzungsanzahl Gib die maximale Anzahl gleichzeitiger Sitzungen an, die ein Listener zum JMS-Server für die Verarbeitung von Nachrichten aufbauen kann. Jede Sitzung entspricht einem eigenen Listener-Thread und steuert damit die Anzahl gleichzeitig verarbeiteter Nachrichten. Passen Sie diesen Parameter an, wenn der Server die verfügbare Kapazität der Maschine nicht vollständig nutzt und die Nachrichten nicht in einer bestimmten Reihenfolge verarbeitet werden müssen.

Syntax

AdminServerManagement.configureListenerPortForMessageListener(Knotenname, Servername,
 Name_des_Listener-Ports, JNDI-Name_der_Verbindungsfactory,
     JNDI-Name_des_Ziels, maximale_Nachrichtenanzahl, maximale_Wiederholungsanzahl, maximale_Sitzungsanzahl)

Verwendungsbeispiel

AdminServerManagement.configureListenerPortForMessageListener("myNode", "myServer", myListenerPort,
 connJNDI, "destJNDI", 5, 2, 3)

configureMessageListenerService

Dieses Script konfiguriert den Nachrichten-Listener-Service in Ihrer Serverkonfiguration. Der Nachrichten-Listener-Service ist eine Erweiterung der JVM-Funktionen des JMS-Providers. Der Service stellt einen Listener-Manager bereit, der einen oder mehrere JMS-Listener steuert und überwacht, die ein JMS-Ziel für eine implementierte Message-driven Bean überwachen.

Tabelle 7. Beschreibungen der Argumente für "configureMessageListenerService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, der maximalen Wiederholungsanzahl für den Listener, dem Wiederanlaufintervall für den Listener, dem Pooling-Schwellenwert und dem Pooling-Zeitlimit als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
maximale_Wiederholungsanzahl_für_Listener Gibt an, wie oft ein von diesem Service verwalteter Listener-Port maximal einen Wiederanlaufversuch startet. Wenn der zugehörige Listener-Port gestoppt wird, wechselt er in den Stoppstatus.
Wiederanlaufintervall_für_Listener Gibt die Wartezeit (in Sekunden) zwischen den Wiederholungsversuchen für einen Wiederanlauf nach einem Fehler eines Listener-Port an.
Pooling-Schwellenwert Gibt die Maximalanzahl der nicht verwendeten Verbindungen im Pool an. Der Standardwert ist 10.
Pooling-Zeitlimit Gibt den Zeitraum (in Millisekunden) an, nach dem eine Verbindung im Pool gelöscht wird, wenn sie nicht verwendet wurde.Ein MQSimpleConnectionManager ordnet die Verbindungen, die am häufigsten verwendet werden, zu und löscht die Verbindungen, die am seltensten verwendet werden. Die Standardeinstellung sieht vor, dass eine Verbindung gelöscht wird, wenn sie fünf Minuten nicht verwendet wurde.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute für den Nachrichten-Listener im folgenden Format an: [["description", "test message listener"], ["isGrowable", "true"], ["maximumSize", 100], ["minimumSize", 5]]

Syntax

AdminServerManagement.configureMessageListenerService(Knotenname, Servername,
 maximale_Wiederholungsanzahl_für_Listener, Wiederanlaufintervall_für_Listener,
     Pooling-Schwellenwert, Pooling-Zeitlimit, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120,
 20, 600000, myProp, myValue,
      [["description", "test message listener"], ["isGrowable", "true"], ["maximumSize", 100], ["minimumSize", 5]])

configureStateManageable

Dieses Script konfiguriert den Anfangsstatus des Anwendungsservers. Der Anfangsstatus gibt den gewünschten Status der Komponente an, wenn der Serverprozess gestartet wird.

Tabelle 8. Beschreibungen der Argumente für "configureStateManageable". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem übergeordneten Typ und dem Anfangsstatus als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
übergeordneter_Typ Gibt den Typ der zu ändernden Komponente an.
Anfangsstatus Gibt den gewünschten Status der Komponente an, wenn der Serverprozess gestartet wird. Die gültigen Werte sind START und STOP.

Syntax

AdminServerManagement.configureStateManageable(Knotenname, Servername,
 übergeordneter_Typ, Anfangsstatus)

Verwendungsbeispiel

AdminServerManagement.configureStateManageable(myNode, myServer, "Server", "START")

configureCustomProperty

Dieses Script konfiguriert angepasste Eigenschaften in Ihrer Anwendungsserverkonfiguration. Sie können angepasste Eigenschaften verwenden, um interne Systemeigenschaften zu konfigurieren, die von einigen Komponenten verwendet werden, z. B., um Informationen an einen Web-Container zu übergeben.

Tabelle 9. Beschreibungen der Argumente für "configureCustomProperty". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem übergeordneten Typ, dem Eigenschaftsnamen und dem Eigenschaftswert als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
übergeordneter_Typ Gibt den Typ der zu zu konfigurierenden Komponente an.
Eigenschaftsname Gibt die zu konfigurierende angepasste Eigenschaft an.
Eigenschaftswert Gibt den Wert der zu konfigurierenden angepassten Eigenschaft an.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute im folgenden Format an: [["commTraceEnabled", "true"], ["enable", "true"]]

Syntax

AdminServerManagement.configureCustomProperty(nodeName, serverName, parentType, propertyName, propertyValue, otherAttributeList)

Verwendungsbeispiel

AdminServerManagement.configureCustomProperty("myNode", "myServer", "ThreadPool", "myProp1", "myPropValue",
    [["description", "my property test"], ["required", "false"]])

configureCustomService

Dieses Script konfiguriert einen angepassten Service in Ihrer Anwendungsserverkonfiguration. Jeder angepasste Service definiert eine Klasse, die bei jedem Start und Herunterfahren des Servers geladen und initialisiert wird. Jede dieser Klassen muss die Schnittstelle "com.ibm.websphere.runtime.CustomService" implementieren. Nachdem Sie einen angepassten Service erstellt haben, konfigurieren Sie diesen mithilfe der Administrationskonsole für Ihre Anwendungsserver.

Tabelle 10. Beschreibungen der Argumente für "configureCustomService". Führen Sie das Script mit dem Knotennamen, dem Servernamen und dem bevorzugten Connector-Typ aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Klassenname Gibt den Klassennamen der Serviceimplementierung an. Diese Klasse muss die Schnittstelle des angepassten Service implementieren.
Anzeigename Gibt den Namen des Service an.
Klassenpfad Gibt den Klassenpfad an, der zum Lokalisieren der Klassen und JAR-Dateien für diesen Service verwendet wird.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute im folgenden Format an: [["description", "test custom service"], ["enable", "true"]]

Syntax

AdminServerManagement.configureCustomService(nodeName, serverName, classname, displayname, classpath, otherAttributeList)

Verwendungsbeispiel

[Windows]
AdminServerManagement.configureCustomService("myNode", "myServer", "myClass", "myName", "C:\temp\boo.jar",
     [["description", "test custom service"], ["enable", "true"]])
[AIX][HP-UX][Linux][Solaris][IBM i][z/OS]
AdminServerManagement.configureCustomService("myNode", "myServer", "myClass", "myName", "/temp/boo.jar",
     [["description", "test custom service"], ["enable", "true"]])

configureEndPointsHost

Tabelle 11. Beschreibungen der Argumente für "configureEndPointsHost". Führen Sie das Script aus, um den Hostnamen der Serverendpunkte zu konfigurieren. Geben Sie den Knotennamen, den Servernamen und den Hostnamen als Argumente an.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Hostname Gibt den Namen des gewünschten Hosts an.

Syntax

AdminServerManagement.configureEndPointsHost(Knotenname, Servername, Hostname)

Verwendungsbeispiel

AdminServerManagement.configureEndPointsHost(myNode, AppServer01, myHostname)

configureJavaVirtualMachine

Dieses Script konfiguriert eine Java Virtual Machine (JVM). Für die Ausführung des Anwendungsservers, eines Java-Prozesses, und für die Unterstützung der Java-Anwendungen, die auf dem Anwendungsserver ausgeführt werden, ist JVM erforderlich.

Tabelle 12. Beschreibungen der Argumente für "configureJavaVirtualMachine". Führen Sie das Script mit der Konfigurations-ID der gewünschten JVM, der Einstellung für den Debugmodus und weiteren Debugargumenten aus.
Argument Beschreibung
JVM-Konfigurations-ID Gibt die Java Virtual Machine der Java™ Virtual Machine an, die Sie ändern möchten.
debugMode Gibt an, ob die JVM im Debugmodus ausgeführt werden soll. Der Standardwert sieht vor, dass der Debugmodus nicht aktiviert wird. Wenn Sie das Argument "debugMode" auf true setzen, müssen Sie Debugargumente angeben.
Debugargumente Gibt die Debugargumente an, die an den JVM-Code, der den Anwendungsserverprozess startet, übergeben werden sollen. Wenn Sie das Debugging in mehreren Anwendungsservern auf demselben Knoten aktivieren, müssen Sie sicherstellen, dass die Server unterschiedliche Adressargumente verwenden, die den Debug-Port definieren. Beispiel: Wenn Sie das Debugging in zwei Servern aktivieren und für beide Server den Debug-Port auf address=7777 einstellen, werden die Server möglicherweise nicht gestartet.
Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Name/Wert-Paar-Format an: [["internalClassAccessMode", "RESTRICT"], ["disableJIT", "false"], ["verboseModeJNI", "false"]]

Syntax

AdminServerManagement.configureJavaVirtualMachine(JVM-Konfigurations-ID,
 Debugmodus, Debugargumente, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureJavaVirtualMachine
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaVirtualMachine_1208188803955)", "true",
   mydebug, [["internalClassAccessMode", "RESTRICT"], ["disableJIT", "false"], ["verboseModeJNI", "false"]])

configureORBService

Dieses Script konfiguriert einen ORB-Service (Object Request Broker) in Ihrer Serverkonfiguration. Ein Object Request Broker (ORB) verwaltet die Interaktion zwischen Clients und Servern mit dem Protokoll IIOP (Internet InterORB Protocol). Er ermöglicht Clients, in einer Netzumgebung Anforderungen abzusetzen und Antworten von Servern zu empfangen.

Tabelle 13. Beschreibungen der Argumente für "configureORBService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Anforderungszeitlimit, der Anzahl der Anforderungswiederholungen, der Verzögerung zwischen den Anforderungswiederholungen, der maximalen Größe des Verbindungscache, der Mindestgröße des Verbindungscache und dem Zeitlimit für die Suche von Anforderungen (LocateRequest) als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Anforderungszeitlimit Die Wartezeit in Sekunden, nach der eine Zeitlimitüberschreitung für eine Anforderungsnachricht eintritt.

[AIX Solaris HP-UX Linux Windows][IBM i]Anzahl_der_Anforderungswiederholungen

[AIX Solaris HP-UX Linux Windows][IBM i]Dieser Wert gibt an, wie oft der ORB versucht, eine Anforderung zu senden, wenn der Server ausfällt. Eine Wiederholung dieses Vorgangs ermöglicht die Fehlerbehebung in temporären Netzen. Dieses Feld wird auf der Plattform z/OS ignoriert.

[AIX Solaris HP-UX Linux Windows][IBM i]Verzögerung_zwischen_Anforderungswiederholungen

[AIX Solaris HP-UX Linux Windows][IBM i]Das Zeitintervall zwischen Anforderungswiederholungen (in Millisekunden). Dieses Feld wird auf der Plattform z/OS ignoriert.

[AIX Solaris HP-UX Linux Windows][IBM i]maximale_Verbindungscacheeinträge

[AIX Solaris HP-UX Linux Windows][IBM i]Gibt die maximale Anzahl der Einträge an, die in den ORB-Verbindungscache aufgenommen werden können, bevor der ORB damit beginnt, inaktive Verbindungen aus dem Cache zu entfernen. Dieses Feld wird auf der Plattform z/OS ignoriert. Es ist möglich, dass die Anzahl aktiver Verbindungen im Cache diesen Schwellenwert vorübergehend überschreitet. Sofern erforderlich, fügt der ORB so lange weitere Verbindungen hinzu, wie Ressourcen verfügbar sind.

[AIX Solaris HP-UX Linux Windows][IBM i]minimale_Verbindungscacheeinträge

[AIX Solaris HP-UX Linux Windows][IBM i]Gibt die Mindestanzahl der Einträge für den ORB-Verbindungscache an. Dieses Feld wird auf der Plattform z/OS ignoriert. Der ORB entfernt keine inaktiven Verbindungen, solange die Anzahl der Einträge unter diesem Wert liegt.

locateRequest-Zeitlimit Gibt an, wie lange (in Minuten) gewartet wird, bis eine Zeitlimitüberschreitung für eine LocateRequest-Nachricht protokolliert wird. Dieses Feld wird auf der Plattform z/OS ignoriert.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute im folgenden Format an: [["commTraceEnabled", "true"], ["enable", "true"]]

Syntax

AdminServerManagement.configureORBService(nodeName, serverName, requestTimeout, requestRetriesCount, requestRetriesDelay,
   maximale_Verbindungscacheeinträge, minimale_Verbindungscacheeinträge, connectionCacheMin, locateRequest-Zeitlimit, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120, 20, 600000, 20, 300, 
[["commTraceEnabled", "true"], ["enable", "true"]])

configureProcessDefinition

Dieses Script konfiguriert die Serverprozessdefinition. Sie können die Operation eines Anwendungsservers erweitern, indem Sie Befehlszeileninformationen zum Starten oder Initialisieren des Anwendungsserverprozesses definieren. Prozessdefinitionseinstellungen definieren Laufzeiteigenschaften, wie z. B. das auszuführende Programm, Argumente für die Ausführung des Programms oder das Arbeitsverzeichnis.

Zum Ausführen des Scripts geben Sie gemäß der Definition in der folgenden Tabelle den Knotennamen und den Servernamen als Argumente an:
Tabelle 14. Beschreibungen der Argumente für "configureProcessDefinition". Führen Sie das Script mit dem Knotennamen, dem Servernamen und bei Bedarf weiteren Parametern aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Liste_weiterer_Attribute Gibt weitere Parameter für die Prozessdefinitionskonfiguration im folgenden Format an: [["Name_der_ausführbaren_Datei", "Wert1"], ["Argumente_für_ausfühbare_Datei", "Wert2"], ["Arbeitsverzeichnis", "Wert3"]]

Syntax

AdminServerManagement.configureProcessDefintion(Knotenname, Servername, Liste_weiterer_Parameter)

Verwendungsbeispiel

AdminServerManagement.configureProcessDefinition(myNode, myServer,
   [[Name_der_ausführbaren_Datei, "Wert1"],["Argumente_für_ausführbare_Datei"."Wert2"],["Arbeitsverzeichnis","Wert3"]])

configureRuntimeTransactionService

Dieses Script konfiguriert den Transaktionsservice für Ihre Serverkonfiguration. Der Transaktionsservice ist eine Laufzeitkomponente des Servers, die Aktualisierungen für mehrere Ressourcenmanager koordiniert, um die atomare Aktualisierung von Daten zu gewährleisten. Transaktionen werden von Anwendungen oder von dem Container, in dem die Anwendungen implementiert sind, gestartet und beendet.

Tabelle 15. Beschreibungen der Argumente für "configureRuntimeTransactionService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Zeitlimit für die Gesamttransaktionslebensdauer und dem Zeitlimit für Clientinaktivität als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Zeitlimit_für_Gesamttransaktionslebensdauer Gibt die maximale Zeit (in Sekunden) für eine Transaktion an, die auf diesem Server gestartet wurde, bevor der Transaktionsservice das Ende des Zeitlimits ausgibt. Alle Transaktionen, die bei Ablauf dieses Zeitlimits noch nicht abgeschlossen sind, werden rückgängig gemacht.
Zeitlimit_für_Clientinaktivität Gibt den maximalen Zeitraum (in Sekunden) zwischen den Transaktionsanforderungen eines fernen Clients an. Alle Clientinaktivitätszeiträume, die dieses Zeitlimit überschreiten, führen dazu, dass die Transaktion in diesem Anwendungsserver rückgängig gemacht wird. Wenn Sie diese Einstellung auf 0 setzen, besteht kein Zeitlimit.

Syntax

AdminServerManagement.configureRuntimeTransactionService(Knotenname, Servername,
 Zeitlimit_für_Gesamttransaktionslebensdauer, Zeitlimit_für_Clientinaktivität)

Verwendungsbeispiel

AdminServerManagement.configureRuntimeTransactionService(myNode, myServer, "600", "600")
[AIX Solaris HP-UX Linux Windows][IBM i]

configureThreadPool

Dieses Script konfiguriert Thread-Pools in Ihrer Serverkonfiguration. Ein Thread-Pool ermöglicht den Serverkomponenten, Threads wiederzuverwenden. Auf diese Weise wird verhindert, dass zur Laufzeit neue Threads erstellt werden müssen. Das Erstellen neuer Threads ist zeit- und ressourcenintensiv.

Tabelle 16. Beschreibungen der Argumente für "configureThreadPool". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem übergeordneten Typ, dem Namen des Thread-Pools, der maximalen Größe, der minimalen Größe und dem Zeitlimit aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
übergeordneter_Typ Gibt den Typ der zu zu konfigurierenden Komponente an.
Name_des_Thread-Pools Gibt den Namen des gewünschten Thread-Pools an.
maximale_Größe Gibt die maximale Anzahl der Threads an, die im Standard-Thread-Pool (Default) verwaltet werden sollen. Falls der Tivoli Performance Viewer anzeigt, dass der Grenzwert in Prozent konstant im zweistelligen Bereich liegt, sollten Sie die maximale Größe erhöhen. Der Grenzwert in Prozent gibt Aufschluss über die Verwendungsdauer der konfigurierten Threads.
Mindestgröße Gibt die zulässige Mindestanzahl von Threads im Pool an. Wenn ein Anwendungsserver gestartet wird, werden dem Thread-Pool zunächst keine Threads zugeordnet. Wenn es die Workload des Anwendungsservers erfordert, werden dem Thread-Pool so viele Threads hinzugefügt, bis die Anzahl der Threads im Pool dem im Feld "Mindestgröße" angegebenen Wert entspricht. Danach werden in Anpassung an die Workload weitere Threads hinzugefügt bzw. entfernt. Die Anzahl der Threads im Pool fällt jedoch niemals unter den im Feld "Mindestanzahl" angegebenen Wert, selbst wenn einige der Threads inaktiv sind.
Inaktivitätszeitlimit Gibt den Zeitraum der Inaktivität an (in Millisekunden). Nach Ablauf dieses Zeitraums wird ein Thread wiederhergestellt. Der Wert 0 steht für keine Wartezeit, ein negativer Wert (kleiner als 0) steht für eine unbegrenzte Wartezeit.
Liste_weiterer_Attribute Gibt weitere Konfigurationsattribute im folgenden Format an: [["description", "testing thread pool"], ["isGrowable", "true"], ["name", "myThreadPool"]]

Syntax

AdminServerManagement.configureThreadPool(Knotenname, Servername,
 übergeordneter_Typ, Name_des_Thread-Pools, maximale_Größe,
 minimale_Größe, Inaktivitätszeitlimit, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureThreadPool
   ("acmeNode2", "server1", "ThreadPoolManager", "WebContainer", 15, 25, 60)

configureTransactionService

Dieses Script konfiguriert den Transaktionsservice für Ihren Anwendungsserver. Sie können Transaktionen für Ihre Anwendungen verwenden, um mehrere Aktualisierungen für Ressourcen als eine unteilbare Arbeitseinheit zu koordinieren, sodass alle Aktualisierungen permanent werden oder keine der Aktualisierungen permanent wird.

Tabelle 17. Beschreibungen der Argumente für "configureTransactionService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Zeitlimit für die Gesamttransaktionslebensdauer, dem Zeitlimit für Clientinaktivität, dem maximalen Transaktionszeitlimit, dem Limit für die Anzahl heuristischer Wiederholungen, der Wartezeit für heuristische Wiederholung, dem Zeitlimit für die Lebensdauer von Weitergabe- und BMT-Transaktionen und dem Zeitlimit für asynchrone Antworten als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Zeitlimit_für_Gesamttransaktionslebensdauer

Gibt die maximale Zeit (in Sekunden) für eine Transaktion an, die auf diesem Server gestartet wurde, bevor der Transaktionsservice das Ende des Zeitlimits ausgibt. Jede Transaktion, die vor Eintreten dieser Zeitlimitüberschreitung nicht abgeschlossen ist, wird zurückgesetzt. Dieses Zeitlimit wird nur verwendet, wenn die Anwendungskomponente kein eigenes Transaktionszeitlimit setzt.

Nachfristen sind nur für das Zeitlimit für Gesamtlebensdauer einer Transaktion und das maximale Zeitlimit für Transaktionen verfügbar. Sie können die Nachfristen mit der angepassten Eigenschaft DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD inaktivieren.

Zeitlimit_für_Clientinaktivität Gibt den maximalen Zeitraum (in Sekunden) zwischen den Transaktionsanforderungen eines fernen Clients an. Alle Clientinaktivitätszeiträume, die dieses Zeitlimit überschreiten, führen dazu, dass die Transaktion in diesem Anwendungsserver rückgängig gemacht wird. Wenn Sie diese Einstellung auf 0 setzen, besteht kein Zeitlimit.
maximales_Transaktionszeitlimit Gibt die Obergrenze für das Transaktionszeitlimit (in Sekunden) für Transaktionen an, die in diesem Server ausgeführt werden. Dieser Wert muss größer-gleich dem Gesamttransaktionszeitlimit sein. Dieses Zeitlimit beschränkt den oberen Grenzwert aller anderen Transaktionszeitlimits.
Limit_für_heuristische_Wiederholungen Gibt an, wie oft der Anwendungsserver ein Beendigungssignal (z. B. Commit oder Rollback) wiederholt. Wiederholungen treten nach einer vorübergehenden Ausnahme von einem Ressourcenmanager oder fernen Partner auf oder wenn das konfigurierte Zeitlimit für asynchrone Antworten abläuft, bevor alle WS-AT-Partner (Web Services Atomic Transaction) geantwortet haben.
Wartezeit_für_heuristische_Wiederholung Gibt an, wie lange (in Sekunden) der Anwendungsserver wartet, bevor er ein Beendigungssignal (z. B. Commit oder Rollback) nach einer vorübergehenden Ausnahme von einem Ressourcenmanager oder fernen Partner wiederholt.
Zeitlimit_für_Lebensdauer_von_Weitergabe-und_BMT-Transaktionen Gibt die zulässige Inaktivitätszeit (in Sekunden) für Transaktionen an, bevor sie rückgängig gemacht werden.
Zeitlimit_für_asynchrone_Antworten Gibt an, wie lange (in Sekunden) der Server auf eingehende WS-AT-Protokollantworten wartet, bevor die vorherige WS-AT-Protokollnachricht erneut gesendet wird.
Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Format an: [["LPSHeuristicCompletion", "ROLLBACK"], ["WSTransactionSpecificationLevel", "WSTX_10"], ["enable", "true"]]

Syntax

AdminServerManagement.configureTransactionService(Knotenname, Servername,
Zeitlimit_für_Gesamttransaktionslebensdauer, Zeitlimit_für_Clientinaktivität,
   maximales_Transaktionszeitlimit, Limit_für_heuristische_Wiederholungen, Wartezeit_für-heuristische_Wiederholungen,
   Zeitlimit_für_Lebensdauer_von_Weitergabe-und_BMT-Transaktionen, Zeitlimit_für_asynchrone_Antworten, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureTransactionService(myNode, myServer, 
    120, 60, 5, 2, 5, 300, 30, 
    [["LPSHeuristicCompletion", "ROLLBACK"], ["WSTransactionSpecificationLevel", "WSTX_10"], ["enable", "true"]])

setJVMProperties

Dieses Script legt weitere Eigenschaften für Ihre JVM-Konfiguration fest.

Tabelle 18. Beschreibungen der Argumente für "setJVMProperties". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Klassenpfad, dem Boot-Klassenpfad, der Anfangsgröße des Heapspeichers, der maximalen Größe des Heapspeichers, der Einstellung für den Debugmodus und Debugargumenten aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Klassenpfad (Optional) Gibt den Standardklassenpfad an, in dem der Code der Java Virtual Machine nach Klassen sucht.
Boot-Klassenpfad (Optional) Gibt die Bootstrapklassen und -Ressourcen für den JVM-Code an. Diese Option ist nur für JVM-Anweisungen verfügbar, die Klassen des Bootprogramms und Ressourcen unterstützen.
Anfangsgröße_des_Heapspeichers (Optional) Gibt die Anfangsgröße des Heapspeichers für den JVM-Code in Megabytes an. Die Startzeit kann sich verkürzen, wenn Sie die Mindestgröße für den Heapspeicher heraufsetzen. Die Anzahl der Garbage-Collection-Durchläufe wird reduziert, wodurch eine Durchsatzsteigerung von 10 % realisiert werden kann. Mit einer höheren Java-Heapspeichergröße verbessert sich im Allgemeinen der Durchsatz, bis sich der Heapspeicher nicht mehr im physischen Hauptspeicher befindet. Sobald der Heapspeicher auf die Platte ausgelagert wird, nimmt die Java-Leistung drastisch ab.
maximale_Größe_des_Heapspeichers (Optional) Gibt die maximale Größe des Heapspeichers, die dem JVM-Code zur Verfügung steht, in MB an. Die Startzeit kann sich verkürzen, wenn Sie die Größe des Heapspeichers heraufsetzen. Durch eine Erhöhung der Größe des Heapspeichers können Sie die Anzahl der Garbage-Collection-Durchläufe reduzieren und damit eine Durchsatzsteigerung von 10 % realisieren.
debugMode (Optional) Gibt an, ob die JVM im Debugmodus ausgeführt werden soll. Der Standardwert sieht vor, dass der Debugmodus nicht aktiviert wird. Wenn Sie das Argument "debugMode" auf true setzen, müssen Sie Debugargumente angeben.
Debugargumente (Optional) Gibt die Debugargumente an, die an den JVM-Code, der den Anwendungsserverprozess startet, übergeben werden sollen. Wenn Sie das Debugging in mehreren Anwendungsservern auf demselben Knoten aktivieren, müssen Sie sicherstellen, dass die Server unterschiedliche Adressargumente verwenden, die den Debug-Port definieren. Beispiel: Wenn Sie das Debugging in zwei Servern aktivieren und für beide Server den Debug-Port auf address=7777 einstellen, werden die Server möglicherweise nicht gestartet.

Syntax

AdminServerManagement.setJVMProperties(Knotenname, Servername,
Klassenpfad, Bootklassenpfad, Anfangsgröße_des_Heapspeichers,
maximale_Größe_des_Heapspeichers, Debugmodus, Debugargumente)

Verwendungsbeispiel

[Windows]
AdminServerManagement.setJVMProperties(myNode, myServer, "c:\a.jar", "", "”, "", "", "")
[Linux][AIX][HP-UX][Solaris][z/OS][IBM i]
AdminServerManagement.setJVMProperties(myNode, myServer, "/a.jar", "", "”, "", "", "")

setTraceSpecification

Dieses Script definiert die Tracespezifikation für Ihre Konfiguration.

Tabelle 19. Beschreibungen der Argumente für "setTraceSpecification". Führen Sie das Script mit dem Knotennamen, dem Servernamen und der Tracespezifikation als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Tracespezifikation (Optional) Gibt die Debugargumente an, die an den JVM-Code, der den Anwendungsserverprozess startet, übergeben werden sollen. Wenn Sie das Debugging in mehreren Anwendungsservern auf demselben Knoten aktivieren, müssen Sie sicherstellen, dass die Server unterschiedliche Adressargumente verwenden, die den Debug-Port definieren. Beispiel: Wenn Sie das Debugging in zwei Servern aktivieren und für beide Server den Debug-Port auf address=7777 einstellen, werden die Server möglicherweise nicht gestartet.

Syntax

AdminServerManagement.setJVMProperties(Knotenname, Servername, Tracespezifikation)

Verwendungsbeispiel

AdminServerManagement.setTraceSpecification(myNode, myServer, "com.ibm.ws.management.*=all")

configureCookieForServer

Dieses Script konfiguriert Cookies in Ihrer Anwendungsserverkonfiguration. Konfigurieren Sie Cookies, um Sitzungen zu überwachen.

Tabelle 20. Beschreibungen der Argumente für "configureCookieForServer". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Cookie-Namen, der Domäne, dem maximalen Cookie-Alter und der Einstellung für Cookie-Sicherung aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Cookie-Name Gibt einen eindeutigen Namen für den Cookie der Sitzungsverwaltung an. Laut Servletspezifikation muss dieser Name JSESSIONID lauten. Aus Flexibilitätsgründen kann dieser Wert jedoch konfiguriert werden.
Domäne Gibt das Domänenfeld eines Cookies für die Sitzungsüberwachung an. Dieser Wert legt fest, ob ein Browser ein Cookie an bestimmte Server sendet. Wenn Sie beispielsweise eine bestimmte Domäne angeben, werden Sitzungscookies an Hosts in dieser Domäne gesendet. Die Standarddomäne ist der Server.
maximales_Alter Gibt den Zeitraum an, für den das Cookie im Client-Browser aktiv bleibt. Sie können festlegen, dass das Cookie für die aktuelle Browsersitzung oder für eine maximale Lebensdauer aktiv sein soll. Wenn Sie die Option für maximale Lebensdauer auswählen, müssen Sie die Lebensdauer in Sekunden angeben. Dieser Wert entspricht der Lebensdauer (Time To Live, TTL), die in der Cookie-Spezifikation beschrieben ist. Der Standardwert ist -1 und bezeichnet die aktuelle Browsersitzung.
secure Gibt an, ob Sitzungscookies das Feld "secure" (sicher) enthalten. Das Aktivieren des Features (Einstellung "true") begrenzt den Austausch von Cookies ausschließlich auf HTTPS-Sitzungen.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute im folgenden Format an: [["Pfad", "C:/temp/mycookie"]]

Syntax

AdminServerManagement.configureCookieForServer(nodeName, serverName, cookieName, domain, maximumAge, secure, otherAttributeList)

Verwendungsbeispiel

AdminServerManagement.configureCookieForServer(myNode, myServer, myCookie, "uk.kingdom.com", -1, "true", [["path", "C:/temp/mycookie"]])

configureHTTPTransportForWebContainer

Dieses Script konfiguriert HTTP-Transporte für einen Web-Container. Transporte stellen Anforderungswarteschlangen zwischen Anwendungsserver-Plug-ins für Web-Server und Web-Containern bereit, in denen sich die Webmodule von Anwendungen befinden. Wenn Sie eine Anwendung auf einem Web-Browser anfordern, wird die Anforderung an den Web-Server und dann an den Web-Container übermittelt.

Tabelle 21. Beschreibungen der Argumente für "configureHTTPTransportForWebContainer". Führen Sie das Script mit dem Knotennamen, dem Servernamen, der Einstellung für Portanpassung, der Einstellung für externe Verwendung, der zu verwendenden SSL-Konfiguration (Secure Socket Layer) und der Einstellung für SSL-Aktivierung aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
adjustPort Gibt an, ob der Port für den gewünschten Web-Container automatisch angepasst werden soll.
external Gibt an, ob der HTTP-Transport für den Web-Container als externer Transport festgelegt werden soll.
SSL-Konfiguration Gibt den Typ der SSL-Einstellungen (Secure Sockets Layer) für Verbindungen zwischen dem Plug-in von WebSphere Application Server und dem Anwendungsserver an. Zu den Optionen gehören eine oder mehrere SSL-Einstellungen im Sicherheitscenter: z. B. DefaultSSLSettings, ORBSSLSettings oder LDAPSSLSettings.
sslEnabled Gibt an, ob Verbindungen zwischen dem Plug-in von WebSphere Application Server und dem Anwendungsserver mit Secure Sockets Layer (SSL) geschützt werden. Die Standardeinstellung sieht vor, dass SSL nicht verwendet wird.

Syntax

AdminServerManagement.configureHTTPTransportForWebContainer(Knotenname, Servername,
 adjustPort, external, sslConfig, sslEnabled)

Verwendungsbeispiel

AdminServerManagement.configureHTTPTransportForWebContainer(myNode, myServer, "true", "true", "mySSLConfig", "true")

configureSessionManagerForServer

Dieses Script konfiguriert den Sitzungsmanager für den Anwendungsserver. Mit Hilfe von Sitzungen können Anwendungen, die in einem Web-Container ausgeführt werden, Angaben zu einzelnen Benutzern protokollieren.

Tabelle 22. Beschreibungen der Argumente für "configureSessionManagerForServer". Führen Sie das Script mit dem Knotennamen, dem Servernamen und dem Modus für Sitzungspersistenz aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Modus_für_Sitzungspersistenz Gibt den Modus für die Sitzungspersistenz an. Die gültigen Werte sind DATABASE, DATA_REPLICATION, und NONE.
Liste_weiterer_Attribute (Optional) Gibt weitere Attribute im folgenden Format an: [["accessSessionOnTimeout", "true"], ["enabled", "true"]]

Syntax

AdminServerManagement.configureSessionManagerForServer(Knotenname, Servername,
Modus_für_Sitzungspersistenz, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureSessionManagerForServer(myNode, myServer, "DATABASE", 
[["accessSessionOnTimeout", "true"], ["enabled", "true"]])

configureWebContainer

Dieses Script konfiguriert Web-Container in Ihrer Anwendungsserverkonfiguration. Ein Web-Container verarbeitet Anforderungen, die sich auf Servlets, JSP-Dateien und andere Arten von Dateien mit serverseitigem Code beziehen. Der Web-Container erstellt Servletinstanzen, lädt und entlädt Servlets, erstellt und verwaltet Anforderungs- und Antwortobjekte und führt andere Tasks zur Verwaltung von Servlets aus.

Tabelle 23. Beschreibungen der Argumente für "configureWebContainer". Führen Sie das Script mit dem Knotennamen, dem Servernamen, dem Namen des virtuellen Standardhosts und der Einstellung für Servlet-Cache-Aktivierung aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Name_des_Web-Containers Gibt den Namen des gewünschten Web-Containers an.
Name_des_virtuellen_Standardhosts Gibt einen virtuellen Host an, der es einer Hostmaschine ermöglicht, wie mehrere Hostmaschinen aufzutreten. Ressourcen, die einem virtuellen Host zugeordnet sind, können mit anderen Ressourcen, die einem anderen virtuellen Host zugeordnet sind, keine Daten gemeinsam benutzen, selbst wenn die virtuellen Hosts auf demselben physischen System installiert sind. Gültige Werte:
default_host
Das Produkt stellt einen virtuellen Standard-Host mit einigen allgemeinen Aliasnamen bereit, wie z. B. IP-Adresse der Maschine, kurzer Hostname und vollständig qualifizierter Hostname. Der Aliasname umfasst den ersten Teil des Pfads für den Zugriff auf eine Ressource, z. B. ein Servlet. In der Anforderung "http://localhost:9080/myServlet" ist dies beispielsweise localhost:9080.
admin_host
Das ist ein anderer Name für den Anwendungsserver; wird in der Basisinstallation auch als "server1" bezeichnet. Dieser Prozess unterstützt die Verwendung der Administrationskonsole.
proxy_host
Der virtuelle Host mit dem Namen proxy_host enthält Standardportdefinitionen, Port 80 und 443, die gewöhnlich während der Initialisierung des Proxy-Servers initialisiert werden. Verwenden Sie diesen Proxy-Host mit Routing-Regel für den Proxy-Server.
enableServletCaching

Gibt an, dass ein Cacheeintrag erstellt wird, wenn ein Servlet aufgerufen wird und eine zwischenzuspeichernde Ausgabe generiert. Der Cacheeintrag beinhaltet auch Nebeneffekte des Aufrufvorgangs. Diese Nebeneffekte können darin bestehen, dass andere Servlets oder JSP-Dateien (JavaServer Pages) aufgerufen werden. Möglicherweise sind Metadaten zu einem Eintrag einschließlich der Angaben zu Zeitlimit und Priorität enthalten.

Für das Caching von Portletfragmenten muss das Servlet-Caching aktiviert sein. Deshalb wird beim Aktivieren des Caching von Portletfragmenten automatisch das Servlet-Caching aktiviert. Wenn Sie das Servlet-Caching inaktivieren, wird das Caching von Portlet-Fragmenten automatisch inaktiviert.

Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Format an: [["allowAsyncRequestDispatching", "true"], ["disablePooling", "true"], ["sessionAffinityTimeout", 20]]

Syntax

AdminServerManagement.configureWebContainer(Knotenname, Servername,
Name_des_virtuellen_Standardhosts, enableServletCaching, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureWebContainer(myNode, myServer, myVH.uk.kingdom.com,
 "true", [["allowAsyncRequestDispatching", "true"], ["disablePooling", "true"], ["sessionAffinityTimeout", 20]])

configureJavaProcessLogs

Dieses Script konfiguriert Java-Prozessprotokolle für den Anwendungsserver. Das System erstellt die JVM-Protokolle durch Umleitung der System.out- und System.err-Datenströme der JVM an unabhängige Protokolldateien.

Tabelle 24. Beschreibungen der Argumente für "configureJavaProcessLogs". Führen Sie das Script mit der gewünschten Java-Prozessdefinition und dem Stammverzeichnis für die Prozessprotokolle als Argumente aus.
Argument Beschreibung
Konfigurations-ID_der_Java-Prozessdefinition Gibt die Konfigurations-ID der angegebenen Java-Prozessdefinition an.
Stammverzeichnis_für_Prozessprotokolle Gibt das Stammverzeichnis für die Prozessprotokolle an.
Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Name/Wert-Paar-Format an: [["Name_der_stdin-Datei", "/temp/mystdin.log"]]

Syntax

AdminServerManagement.configureJavaProcessLogs(Konfigurations-ID_der_Java-Prozessdefinition, Stammverzeichnis_des_Prozessprotokolls,
 Liste_weiterer_Attribute)

Verwendungsbeispiel

[Windows]
AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
   C:\temp\myJavaLog, [[Name_der_stdin-Datei, c:\temp\mystdin.log]])
[AIX][HP-UX][Solaris][Linux][IBM i][z/OS]
AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)", 
   		/temp/myJavaLog, [[Name_der_stdin-Datei, /temp/mystdin.log]])

configurePerformanceMonitoringService

Dieses Script konfiguriert PMI (Performance Monitoring Infrastructure) in Ihrer Konfiguration. PMI ermöglicht dem Server, Leistungsdaten verschiedener Produktkomponenten zu erfassen. Performance Monitoring Infrastructure (PMI) liefert Statistiken zur durchschnittlichen Auslastung der Systemressourcen ohne Korrelation zwischen den Daten der verschiedenen Komponenten.

Tabelle 25. Beschreibungen der Argumente für "configurePerformanceMonitoringService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, der Einstellung für PMI-Aktivierung und der Anfangsspezifikationsstufe als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
aktivieren Gibt an, ob der Anwendungsserver versucht, Performance Monitoring Infrastructure (PMI) zu aktivieren. Wenn ein Anwendungsserver gestartet wird und PMI inaktiviert ist, müssen Sie den Server erneut starten, um PMI zu aktivieren.
Anfangsspezifikationsstufe Gibt eine vordefinierte Gruppe von PMI-Statistiken (Performance Monitoring Infrastructure) für alle Komponenten im Server an.
None
Alle Statistiken sind inaktiviert.
Basic
Unterstützt die Basisüberwachung für Anwendungsserverressourcen und Anwendungen. Dazu gehören Java EE-Komponenten, HTTP-Sitzungsinformationen, Informationen zur CPU-Belastung usw. sowie die Top 38 Statistiken. Dies ist die Standardeinstellung.
Extended
Stellt erweiterte Überwachungsfunktionen bereit, einschließlich der Basisstufe sowie Workload-Monitor, Leistungsadvisor und Tivoli-Ressourcenmodellen. Diese Einstellung liefert die Hauptstatistiken für häufig verwendete Komponenten von WebSphere Application Server.
All
Es sind alle Statistiken aktiviert.
Custom
Unterstützt eine detaillierte Steuerung mit der Möglichkeit, einzelne Statistiken zu aktivieren und zu inaktivieren.
Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Name/Wert-Paar-Format an: [["statisticSet", "test statistic set"], ["synchronizedUpdate", "true"]]

Syntax

AdminServerManagement.configurePerformanceMonitoringService(Knotenname, Servername,
enable, Anfangsspezifikationsstufe, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configurePerformanceMonitoringService(myNode, myServer, "true", "Basic", 
[["statisticSet", "test statistic set"], ["synchronizedUpdate", "true"]])

configurePMIRequestMetrics

Dieses Script konfiguriert PMI Request Metrics in Ihrer Konfiguration. Request Metrics stellt Daten zu jeder einzelnen Transaktion mit Korrelation zu den verschiedenen Produktkomponenten bereit und liefert somit ein umfassendes Bild der Transaktion.
Tabelle 26. Beschreibungen der Argumente für "configurePMIRequestMetrics". Führen Sie das Script mit der Einstellung für Request-Metric-Aktivierung und der Tracestufe als Argumente aus.
Argument Beschreibung
aktivieren Gibt an, ob das Feature "Request Metrics" aktiviert werden soll. Wenn diese Einstellung inaktiviert ist, ist die Funktion Request Metrics inaktiviert.
Tracestufe Gibt an, wie viele Tracedaten für eine bestimmte Transaktion erfasst werden sollen. Die Tracestufe und die zu instrumentierenden Komponenten steuern gemeinsam, ob eine Anforderung instrumentiert wird oder nicht.
NONE
Keine Instrumentierung
HOPS
Generiert nur Instrumentierungsinformationen zu den Prozessgrenzen (z. B. eine Servletanforderung, die von einem Browser oder einem Web-Server empfangen wird, oder eine JDBC-Anforderung, die an eine Datenbank gesendet wird).
PERFORMANCE_DEBUG
Generiert die Daten auf Hopebene und die erste Ebene des prozessinternen Servlet- und EJB-Aufrufs (Enterprise JavaBeans) (z. B., wenn ein eingehendes Servlet Daten an ein Servlet weiterleitet und eine eingehende EJB eine andere EJB aufruft). Andere prozessinterne Aufrufe wie Benennung und Service Integration Bus (SIB) sind auf dieser Stufe nicht aktiviert.
DEBUG
Diese Option liefert detaillierte Instrumentierungsdaten einschließlich der Antwortzeiten für alle prozessinternen Aufrufe. Auf dieser Stufe werden nur Anforderungen an Servletfilter instrumentiert.
Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Name/Wert-Paar-Format an: [["armType", "TIVOLI_ARM"], ["enableARM", "true"]]

Syntax

AdminServerManagement.configurePMIRequestMetrics(enable, Tracestufe, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configurePMIRequestMetrics("true", "DEBUG", 
   [["armType", "TIVOLI_ARM"], ["enableARM", "true"]])
[z/OS]

configureRASLoggingService

Dieses Script konfiguriert die RAS-Protokollierung in Ihrer Anwendungsserverkonfiguration.
Tabelle 27. Beschreibungen der Argumente für "configureRASLoggingService". Führen Sie das Script mit dem Knotennamen, dem Servernamen und dem Stammverzeichnis für die RAS-Protokolle aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Stammverzeichnis_für_Serviceprotokolle Gibt das Stammverzeichnis für die Protokolle des RAS-Protokollservice an.
Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Name/Wert-Paar-Format an: [["enabled", "true"], ["size", "500"]]

Syntax

AdminServerManagement.configureRASLoggingService(Knotenname, Servername,
 Stammverzeichnis_für_Serverprotokolle, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureRASLoggingService(myNode, myServer, /temp/myRASLog, 
   [["enabled", "true"], ["size", "500"]])

configureServerLogs

Dieses Script konfiguriert Serverprotokolle für den gewünschten Anwendungsserver.
Tabelle 28. Beschreibungen der Argumente für "configureServerLogs". Führen Sie das Script mit dem Knotennamen, dem Servernamen und dem Stammverzeichnis für die Serverprotokolle aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Stammverzeichnis_für_Serverprotokolle Gibt das Stammverzeichnis für die Serverprotokolle an.
Liste_weiterer_Attribute Gibt optional weitere Attribute im folgenden Name/Wert-Paar-Format an: [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]]

Syntax

AdminServerManagement.configureServerLogs(Knotenname,
Servername,
Stammverzeichnis_für_Serverprotokolle, Liste_weiterer_Attribute)

Verwendungsbeispiel

[Windows]
AdminServerManagement.configureServerLogs(myNode, myServer, C:\temp\mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])
[AIX][HP-UX][Solaris][Linux][IBM i][z/OS]
AdminServerManagement.configureServerLogs(myNode, myServer, /temp/mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])

configureTraceService

Diese Script konfiguriert Traceeinstellungen für den Anwendungsserver. Konfigurieren Sie den Trace, um detaillierte Informationen zur Ausführung des Anwendungsservers zu erhalten.
Tabelle 29. Beschreibungen der Argumente für "configureTraceService". Führen Sie das Script mit dem Knotennamen, dem Servernamen, der Tracespezifikation und dem Ausgabetyp als Argumente aus.
Argument Beschreibung
Knotenname Gibt den Namen des gewünschten Knotens an.
Servername Gibt den Namen des gewünschten Servers an.
Anfangstracespezifikation Gibt die Tracespezifikation an, die für die gewünschte Komponente aktiviert werden soll. Die Tracespezifikation com.ibm.ws.webservices.trace.MessageTrace=all bewirkt beispielsweise, dass der Inhalt einer SOAP-Nachricht, einschließlich der binären Anhangsdaten, aufgezeichnet werden.
Traceausgabetyp Gibt an, in welche Datei die Traceausgabe geschrieben werden soll. Die Traceausgabe kann direkt in eine Ausgabedatei geschrieben oder im Hauptspeicher gespeichert werden.
Liste_weiterer_Attribute Gibt optional weitere Attribute für den Trace-Service im folgenden Name/Wert-Paar-Format an: [["enable", "true"], ["traceFormat", "LOG_ANALYZER"]]

Syntax

AdminServerManagement.configureTraceService(Knotenname, Servername,
Tracezeichenfolge, Ausgabetyp, Liste_weiterer_Attribute)

Verwendungsbeispiel

AdminServerManagement.configureTraceService(myNode, myServer, "com.ibm.ws.management.*=all=enabled", 
   SPECIFIED_FILE, [["enable", "true"], ["traceFormat", "LOG_ANALYZER"]])

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libserver
Dateiname:rxml_7libserver.html