Eigenschaften für JMX-Connector (Java Management Extensions)

Sie können eine Eigenschaft wie folgt angeben oder setzen: in der Administrationskonsole, mit dem Tool "wsadmin", mit Application-Server-Befehlen, mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden, oder mit einem selbst geschriebenen angepassten Java-Verwaltungsclientprogramm. Sie können auch SOAP-Connector-Eigenschaften in der Datei "soap.client.props" und die IPC-Connector-Eigenschaften in der Datei "ipc.client.props" setzen.

Ein JMX-Connector (Java Management Extensions) kann ein RMI-Connector (Remote Method Invocation), ein SOAP-Connector (Simple Object Access Protocol), ein JMX-JSR160RMI-Connector (JMX Remote Application Programming Interface Remote Method Invocation) oder ein IPC-Connector (Inter-Process Communications) sein.

Veraltetes Feature Veraltetes Feature: Sie sollten alle RMI-Connector in JSR160RMI-Connector konvertieren, da RMI-Connector nicht mehr unterstützt werden. depfeat

Spezifische Informationen zum Codieren der JMX-Connector-Eigenschaften mit dem Tool "wsadmin", den Application-Server-Befehlen oder den Scripts finden Sie in der Beschreibung zum jeweiligen Tool bzw. Befehl. Spezifische Informationen zur Codierung der JMX-Connectoreigenschaften für ein angepasstes Java-Verwaltungsclientprogramm finden Sie in der Dokumentation zu den APIs.

Die von Servern erstellten JMX-Connector verwenden JMX-Connector-Eigenschaften, die über die Administrationskonsole zugänglich sind. Das Tool "wsadmin" und der Java™-Verwaltungsclient verwenden JMX-Connector-Eigenschaften in den Dateien "soap.client.props", "ipc.client.props" und "sas.client.prop".

Für die Administrationskonsole gibt dieser Artikel die Codierung der entsprechenden Einstellung bzw. der entsprechenden Eigenschaft an. Die Codierung der Eigenschaften in der Datei soap.client.props und der Datei ipc.client.props, die für JMX-Connector spezifisch sind, wird angegeben. Diese SOAP-Eigenschaften beginnen mit com.ibm.SOAP und die IPC-Eigenschaften mit com.ibm.IPC. Andere Eigenschaften in der Datei soap.client.props und in der Datei ipc.client.props, die Informationen enthalten, die an anderer Stelle im Anwendungsserver gesetzt werden können, werden hier nicht erläutert. Die Codierung für die Eigenschaft com.ibm.ssl.contextProvider, die nur in der Datei soap.client.props und in der Datei ipc.client.props gesetzt werden kann, wird angegeben.

[AIX Solaris HP-UX Linux Windows][z/OS]Jedes Profil hat Eigenschaftendateien an den folgenden Positionen:
  • Für den SOAP-Connector:
    • [Linux][HP-UX][Solaris][AIX][z/OS][IBM i]Profilstammverzeichnis/properties/soap.client.props
    • [Windows]Profilstammverzeichnis\properties\soap.client.props
  • Für den IPC-Connector:
    • [Linux][HP-UX][Solaris][AIX][z/OS][IBM i]Profilstammverzeichnis/properties/ipc.client.props
    • [Windows]Profilstammverzeichnis\properties\ipc.client.props
In diesen Eigenschaftendateien können Sie verschiedene Eigenschaften einschließlich Sicherheits- und Zeitlimiteigenschaften definieren. Diese Eigenschaften werden standardmäßig für alle Verwaltungsverbindungen verwendet, die den SOAP-JMX-Connector oder IPC-JMX-Connector für Prozesse verwenden, die in einem bestimmten Profil ausgeführt werden. Wenn das Programm wsadmin beispielsweise unter einem bestimmten Profil ausgeführt wird, verwendet es die Eigenschaftswerte aus diesen Dateien, um das Verhalten des SOAP-Connector und des IPC-Connector zu steuern, sofern die Eigenschaften nicht durch andere Programmiertechniken überschrieben werden.

Klicken Sie zum Anzeigen der Administrationskonsolseite mit den angepassten Eigenschaften für JMX-Connector auf Server > Servertypen > WebSphere-Anwendungsserver > Servername > Verwaltung > Verwaltungsservices > JMX-Connector > Connectortyp > Angepasste Eigenschaften.

SOAP-Connector-Eigenschaften

In diesem Abschnitt werden die folgenden JMX-Connector-Eigenschaften erläutert, die für SOAP-Connector gültig sind:

Konfigurations-URL:

Geben Sie die Eigenschaft "Konfigurations-URL" an, wenn ein Programm SOAP-Eigenschaften in dieser Datei lesen soll. Sie können die Eigenschaft wie folgt festlegen:
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden. Scripts können die Eigenschaft "Konfigurations-URL" in der Systemeigenschaft com.ibm.SOAP.ConfigURL an den Anwendungsserver weitergeben.
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft ConfigURL
    Datentyp String
    Gültiger Wert http://Pfad/soap.client.props
    Standardeinstellung Ohne
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.CONNECTOR_SOAP_CONFIG".

SSL-Sicherheit (Secure Sockets Layer):

Verwenden Sie diese Eigenschaft, um die SSL-Sicherheit zwischen dem Anwendungsserver und dem SOAP-Client zu aktivieren. Sie können die Eigenschaft wie folgt festlegen:
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Mit der Datei soap.client.props.
    Information Wert
    Eigenschaft com.ibm.SOAP.securityEnabled
    Datentyp Boolean
    Standardeinstellung False
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft securityEnabled
    Datentyp Boolean
    Standardeinstellung False
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.CONNECTOR_SECURITY_ENABLED".

Sicherheitskontextprovider:

Diese Eigenschaft gibt die SSL-Implementierung (Secure Sockets Layer) an, die zwischen dem Anwendungsserver und dem SOAP-Client verwendet werden soll.

Sie können die Eigenschaft mit der Datei soap.client.props setzen.
Information Wert
Eigenschaft com.ibm.ssl.contextProvider
Datentyp String
Gültige Werte
IBMJSSE2
Standardeinstellung IBMJSSE2

Zeitlimit für SOAP-Anforderung:

Der Wert, den Sie auswählen, ist von einer Reihe von Faktoren, z. B. der Größe und der Anzahl der im Server installierten Anwendungen, der Geschwindigkeit der Maschine und der Verwendungsebene der Maschine abhängig.

Der Standardwert des Programms für das Anforderungszeitlimit beträgt 600 Sekunden. Andere Komponenten, die eine Verbindung zum SOAP-Client herstellen, können den Standardwert überschreiben. Komponenten, die die Datei soap.client.props verwenden, haben einen Standardwert von 180 Sekunden.

Sie können die Eigenschaft wie folgt festlegen:
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Mit der Datei soap.client.props.
    Information Wert
    Eigenschaft com.ibm.SOAP.requestTimeout
    Datentyp Integer
    Einstellmöglichkeiten (Sekunden) 0 bis n

    Wenn die Eigenschaft den Wert null (0) hat, hat die Anforderung kein Zeitlimit.

    Standardeinstellung 180
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft requestTimeout
    Datentyp Integer
    Einstellmöglichkeiten (Sekunden) 0 bis n

    Wenn die Eigenschaft den Wert null (0) hat, hat die Anforderung kein Zeitlimit.

    Standardeinstellung 600
  • Über einen Java-Verwaltungsclient. Die Eigenschaft ist "AdminClient.CONNECTOR_SOAP_REQUEST_TIMEOUT".

SSL-Alias:

Diese Eigenschaft gibt den Alias an, der für eine SSL-Konfiguration für Clientverbindungen verwendet werden soll. Sie können einen beliebigen Wert für den Alias angeben.

Setzen Sie die Eigenschaft in der Datei soap.client.props.
Information Wert
Eigenschaft com.ibm.ssl.alias
Datentyp String
Standardeinstellung DefaultSSLSettings

IPC-Connector-Eigenschaften

In diesem Abschnitt werden die folgenden JMX-Connector-Eigenschaften erläutert, die für IPC-Connector gültig sind:

Konfigurations-URL:

Geben Sie die Eigenschaft "Konfigurations-URL" an, wenn ein Programm IPC-Eigenschaften in dieser Datei lesen soll. Sie können die Eigenschaft wie folgt festlegen:
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden. Scripts können die Eigenschaft "Konfigurations-URL" in der Systemeigenschaft com.ibm.IPC.ConfigURL an den Application Server weitergeben.
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft ConfigURL
    Datentyp String
    Gültiger Wert http://Pfad/ipc.client.props
    Standardeinstellung Ohne
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.CONNECTOR_IPC_CONFIG".

Zeitlimit für IPC-Anforderung:

Der Wert, den Sie auswählen, ist von einer Reihe von Faktoren, z. B. der Größe und der Anzahl der im Server installierten Anwendungen, der Geschwindigkeit der Maschine und der Verwendungsebene der Maschine abhängig.

Der Standardwert des Programms für das Anforderungszeitlimit beträgt 600 Sekunden. Andere Komponenten, die eine Verbindung zum IPC-Client herstellen, können den Standardwert überschreiben. Komponenten, die die Datei ipc.client.props verwenden, haben einen Standardwert von 180 Sekunden.

Sie können die Eigenschaft wie folgt festlegen:
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Mit der Datei ipc.client.props.
    Information Wert
    Eigenschaft com.ibm.IPC.requestTimeout
    Datentyp Integer
    Einstellmöglichkeiten (Sekunden) 0 bis n

    Wenn die Eigenschaft den Wert null (0) hat, hat die Anforderung kein Zeitlimit.

    Standardeinstellung 180
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft requestTimeout
    Datentyp Integer
    Einstellmöglichkeiten (Sekunden) 0 bis n

    Wenn die Eigenschaft den Wert null (0) hat, hat die Anforderung kein Zeitlimit.

    Standardeinstellung 600
  • Über einen Java-Verwaltungsclient. Die Eigenschaft ist AdminClient.CONNECTOR_IPC_REQUEST_TIMEOUT.

SSL-Sicherheit (Secure Sockets Layer):

Verwenden Sie diese Eigenschaft, um die SSL-Sicherheit zwischen dem Application Server und dem IPC-Client zu aktivieren. Sie können die Eigenschaft wie folgt festlegen:
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Mit der Datei ipc.client.props.
    Information Wert
    Eigenschaft com.ibm.IPC.securityEnabled
    Datentyp Boolean
    Standardeinstellung False
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft securityEnabled
    Datentyp Boolean
    Standardeinstellung False
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.CONNECTOR_SECURITY_ENABLED".

Sicherheitskontextprovider:

Diese Eigenschaft gibt die SSL-Implementierung (Secure Sockets Layer) an, die zwischen dem Anwendungsserver und dem IPC-Client verwendet werden soll.

Sie können die Eigenschaft mit der Datei ipc.client.props setzen.
Information Wert
Eigenschaft com.ibm.ssl.contextProvider
Datentyp String
Gültige Werte
IBMJSSE2
Standardeinstellung IBMJSSE2

SSL-Alias:

Diese Eigenschaft gibt den Alias an, der für eine SSL-Konfiguration für Clientverbindungen verwendet werden soll. Sie können einen beliebigen Wert für den Alias angeben.

Setzen Sie die Eigenschaft in der Datei ipc.client.props.
Information Wert
Eigenschaft com.ibm.ssl.alias
Datentyp String
Standardeinstellung DefaultSSLSettings

SOAP-, RMI-, JSR160RMI- und IPC-Connector-Eigenschaften

In diesem Abschnitt werden JMX-Connector-Eigenschaften erläutert, die für die folgenden SOAP-, RMI-, JSR160RMI- und IPC-Connector gültig sind:

Connectortyp:

Geben Sie den Connectortyp SOAP, RMI, JSR160RMI oder IPC an, je nachdem, ob der Anwendungsserver eine Verbindung zu einem SOAP-, RMI-, JSR160RMI- oder IPC-Server herstellt. Sie können die Eigenschaft wie folgt festlegen:
  • Mit dem Tool "wsadmin".
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft Typ
    Datentyp String
    Gültige Werte
    SOAPConnector
    RMIConnector
    JSR160RMIConnector
    IPCConnector
    Standardeinstellung
    SOAPConnector
    JSR160RMIIPC
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.CONNECTOR_TYPE". Geben Sie den Connectortyp mit den Konstanten AdminClient.CONNECTOR_TYPE_RMI, AdminClient.CONNECTOR_TYPE_SOAP, AdminClient.CONNECTOR_TYPE_JSR160RMI oder AdminClient.CONNECTOR_TYPE_IPC an.

Connector inaktivieren:

Sie können alle JMX-Connector in der Administrationskonsole aktivieren und inaktivieren.

  • Mit dem Tool "wsadmin".
  • Über die Administrationskonsole. Wählen Sie das Kästchen neben dem Connector aus, um den Connector zu aktivieren. Wählen Sie das Kästchen neben dem Connector ab, um den Connector zu inaktivieren.
    Information Wert
    Eigenschaft Aktiviert
    Datentyp Boolean
    Wert true|false

Host:

Der Hostname oder die IP-Adresse des Servers, zu dem der Anwendungsserver eine Verbindung herstellt. Der Server kann ein SOAP-Server, ein RMI-Server, ein JSR160RMI-Server oder ein IPC-Server sein. Sie können die Eigenschaft wie folgt festlegen:
  • Mit dem Tool "wsadmin".
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft host
    Datentyp String
    Gültige Werte Hostname oder IP-Adresse
    Standardeinstellung Ohne
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.CONNECTOR_HOST".

Kennwort:

Das Kennwort, das der Anwendungsserver für den Zugriff auf den SOAP-Server, den RMI-Server, den JSR160RMI-Server oder den IPC-Server verwendet. Sie können die Eigenschaft wie folgt festlegen:
  • Mit dem Tool "wsadmin".
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Die Datei soap.client.props für den SOAP-Server, den RMI-Server oder JSR160RMI-Server.
    Information Wert
    Eigenschaft com.ibm.SOAP.loginPassword
    Datentyp String
    Gültige Werte Der Wert muss mit den globalen SSL-Einstellungen für SOAP, RMI oder JSR160RMI übereinstimmen.
    Standardeinstellung Ohne
  • Die Datei ipc.client.props für den IPC-Server.
    Information Wert
    Eigenschaft com.ibm.IPC.loginPassword
    Datentyp String
    Gültige Werte Der Wert muss mit den globalen SSL-Einstellungen für IPC übereinstimmen.
    Standardeinstellung Ohne
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft password
    Datentyp String
    Gültige Werte Der Wert muss mit den globalen SSL-Einstellungen für SOAP, RMI, JSR160RMI oder IPC übereinstimmen.
    Standardeinstellung Ohne
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.PASSWORD".

Port:

Die Portnummer des Servers, zu dem der Anwendungsserver eine Verbindung herstellt. Der Server kann ein SOAP-Server, ein RMI-Server, ein JSR160RMI-Server oder ein IPC-Server sein. Sie können die Eigenschaft wie folgt festlegen:
  • Mit dem Tool "wsadmin".
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft port
    Datentyp Integer
    Gültiger Wert Portnummer
    Standardeinstellung Ohne
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.CONNECTOR_PORT".

Benutzername:

Der Benutzername, den der Anwendungsserver für den Zugriff auf den SOAP-Server, einen RMI-Server, einen JSR160RMI-Server oder einen IPC-Server verwendet. Sie können die Eigenschaft wie folgt festlegen:
  • Mit dem Tool "wsadmin".
  • Mit Scripts, die in einer Befehlszeilenschnittstelle ausgeführt werden.
  • Die Datei soap.client.props für den SOAP-Server, einen RMI-Server oder einen JSR160RMI-Server.
    Information Wert
    Eigenschaft com.ibm.SOAP.loginUserid
    Datentyp String
    Gültiger Wert Der Wert muss mit den globalen SSL-Einstellungen für SOAP, RMI oder JSR160RMI übereinstimmen.
    Standardeinstellung Ohne
  • Die Datei ipc.client.props für den IPC-Server.
    Information Wert
    Eigenschaft com.ibm.IPC.loginUserid
    Datentyp String
    Gültiger Wert Der Wert muss mit den globalen SSL-Einstellungen für IPC übereinstimmen.
    Standardeinstellung Ohne
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft username
    Datentyp String
    Gültiger Wert Der Wert muss mit den globalen SSL-Einstellungen für SOAP, RMI, JSR160RMI oder IPC übereinstimmen.
    Standardeinstellung Ohne
  • Über einen Java-Verwaltungsclient. Verwenden Sie die Eigenschaft "AdminClient.USERNAME".

RMI-Connector-Eigenschaften

In diesem Abschnitt werden die folgenden JMX-Connector-Eigenschaften erläutert, die für RMI-Connector gültig sind:

JSR-160-RMI-Connector inaktivieren:

Die Unterstützung für JMX Remote Application Programming Interface (JSR 160) ist standardmäßig aktiviert, so dass Sie automatisch die spezifikationskompatible JMX-Funktion erhalten. Wenn Sie die Funktion für einen bestimmten Server inaktivieren möchten, setzen Sie die Eigenschaft mit einer der folgenden Optionen:

  • Mit dem Tool "wsadmin".
  • Über die Administrationskonsole. Geben Sie die Eigenschaft und den Wert als Name/Wert-Paar in der Anzeige für angepasste Eigenschaften des JMX-Connectors in der Administrationskonsole an.
    Information Wert
    Eigenschaft disableJDKJMXConnector
    Datentyp String
    Wert true

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=ragt_rconnector_customp
Dateiname:ragt_rconnector_customp.html