Propriétés du connecteur JMX (Java Management Extensions)

Vous pouvez spécifier ou définir une propriété dans la console d'administration, l'outil wsadmin, les commandes du serveur d'applications, les scripts exécutés à partir d'une interface de ligne de commande ou un programme client d'administration Java™ personnalisé que vous écrivez. Vous pouvez également définir les propriétés de connecteur dans le fichier soap.client.props et les propriétés de connecteur IPC dans le fichier ipc.client.props.

Un connecteur Java Management Extensions (JMX) peut être un connecteur Remote Method Invocation (RMI), un connecteur Simple Object Access Protocol (SOAP), un connecteur JMX Remote application programming interface (JSR 160) Remote Method Invocation ( JSR160RMI ) ou un connecteur Inter-Process Communications (IPC).

Fonctionnalité obsolète : convertissez vos connecteurs RMI en connecteurs JSR160RMI, car la prise en charge du connecteur RMI est obsolète.

Pour des informations spécifiques sur la façon de coder les propriétés du connecteur JMX pour l'outil wsadmin, sur les commandes du serveur d'applications ou sur les scripts, reportez-vous à la commande ou à l'outil voulu. Pour obtenir des informations sur la façon de coder les propriétés du connecteur JMX pour le programme client administratif Java personnalisé, consultez la documentation des interfaces de programmation d'application.

Les connecteurs JMX créés par les serveurs utilisent les propriétés de connecteur JMX accessibles dans la console d'administration. L'outil wsadmin et le client administratif Java utilisent les propriétés du connecteur JMX dans les fichiers soap.client.props, ipc.client.propssas.client.prop , et.

Pour la console d'administration, cette rubrique spécifie le codage de la propriété ou du paramètre particuliers. Le codage des propriétés des fichiers soap.client.props et ipc.client.props spécifiques aux connecteurs JMX est défini. Ces propriétés SOAP commencent par com.ibm.SOAP et les propriétés IPC par com.ibm.IPC. Les autres propriétés des fichiers soap.client.props et ipc.client.props qui contiennent des informations pouvant être définies à un autre emplacement dans le serveur d'applications ne sont pas décrites ici. Le codage de la propriété com.ibm.ssl.contextProvider, qui peut être défini uniquement dans les fichiers soap.client.props et ipc.client.props, est spécifié.

[AIX Solaris HP-UX Linux Windows]Chaque profil comporte des fichiers de propriétés aux emplacements suivants :
  • Pour le connecteur SOAP :
    • [Linux][AIX][HP-UX][IBM i][Solaris]profile_root/properties/soap.client.props
    • [Windows]profile_root\properties\soap.client.props
  • Pour le connecteur IPC :
    • [Linux][AIX][HP-UX][IBM i][Solaris]profile_root/properties/ipc.client.props
    • [Windows]profile_root\properties\ipc.client.props
Ces fichiers de propriété vous permettent de définir différentes propriétés, y compris des propriétés de sécurité et de délais. Ces propriétés correspondent aux propriétés par défaut de toutes les connexions administratives qui utilisent le connecteur SOAP JMX ou IPC JMX entre les processus s'exécutant sur un profil particulier. Par exemple, le programme wsadmin s'exécutant sous un profil particulier utilise les valeurs de propriété de ces fichiers pour le comportement des connecteurs SOAP et IPC sauf si les propriétés sont remplacées par d'autres moyens de programmation.

Pour afficher la page de la console d'administration des propriétés personnalisées du connecteur JMX correspondant à cette rubrique, cliquez sur Serveurs > Types de serveurs > Serveurs d'application WebSphere > nom_du_serveur > Administration > Services d'administration > Connecteurs JMX > type_de_connecteur > Propriétés personnalisées.

Propriétés du connecteur SOAP

Cette section présente les propriétés de connecteur JMX relatives aux connecteurs SOAP :

URL de configuration :

Spécifiez la propriété d'URL (Universal Resource Locator) de configuration si vous voulez qu'un programme lise les propriétés SOAP à partir de ce fichier. Vous pouvez définir la propriété en utilisant une des options suivantes :
  • Scripts exécutés à partir d'une interface de ligne de commande. Les scripts peuvent transmettre la propriété d'adresse URL de configuration au serveur d'applications et écraser la propriété système com.ibm.SOAP.ConfigURL.
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété ConfigURL
    Type de données Chaîne
    Valeur valide http://Chemin/soap.client.props
    Par défaut Aucune
  • Client d'administration Java. Utilisez la propriété AdminClient.CONNECTOR_SOAP_CONFIG.

Protocole de sécurité Secure Sockets Layer (SSL):

Utilisez cette propriété pour activer la sécurité SSL entre le serveur d'applications et le client SOAP. Définissez la propriété en utilisant une des options suivantes :
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • Le soap.client.props fichier.
    Informations Valeur
    Propriété com.ibm.SOAP.securityEnabled
    Type de données Boolean
    Par défaut Faux
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété securityEnabled
    Type de données Boolean
    Par défaut Faux
  • Client d'administration Java. Utilisez la propriété AdminClient.CONNECTOR_SECURITY_ENABLED.

Fournisseur de contexte de sécurité :

Cette propriété indique l'implémentation du protocole SSL entre le serveur d'applications et le client SOAP.

Définissez la propriété en utilisant le fichier soap.client.props.
Informations Valeur
Propriété com.ibm.ssl.contextProvider
Type de données Chaîne
Valeurs admises 
IBMJSSE2
Par défaut IBMJSSE2

Délai d'expiration de la demande SOAP :

La valeur à choisir dépend de plusieurs facteurs, tels que la taille et le nombre d'applications installés sur le serveur, la vitesse de votre machine et son taux d'utilisation.

La valeur par défaut du programme pour le délai d'expiration de la requête est 600 seconds. Toutefois, les valeurs par défaut peuvent être remplacées par celles d'autres composants se connectant au client SOAP. Les composants qui utilisent le soap.client.props fichier ont une valeur par défaut de 180 seconds.

Définissez la propriété en utilisant une des options suivantes :
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • Le soap.client.props fichier.
    Informations Valeur
    Propriété com.ibm.SOAP.requestTimeout
    Type de données Entier
    Intervalle en secondes 0 à n

    Si la propriété est zéro (0), la demande n'expire jamais.
    Par défaut 180
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété requestTimeout
    Type de données Entier
    Intervalle en secondes 0 à n

    Si la propriété est zéro (0), la demande n'expire jamais.
    Par défaut 600
  • Client d'administration Java. La propriété est AdminClient.CONNECTOR_SOAP_REQUEST_TIMEOUT.

Alias SSL :

Cette propriété indique l'alias à utiliser pour une configuration SSL des connexions client. Vous pouvez affecter n'importe quelle valeur à cette alias.

Définissez la propriété dans le fichier soap.client.props.
Informations Valeur
Propriété com.ibm.ssl.alias
Type de données Chaîne
Par défaut DefaultSSLSettings

Propriétés du connecteur IPC

Cette section présente les propriétés de connecteur JMX relatives aux connecteurs IPC :

URL de configuration :

Indiquez la propriété d'adresse URL de configuration pour qu'un programme lise les propriétés IPC à partir de ce fichier. Vous pouvez définir la propriété en utilisant une des options suivantes :
  • Scripts exécutés à partir d'une interface de ligne de commande. Les scripts peuvent transmettre la propriété d'URL de configuration au serveur d'applications sur la propriété système com.ibm.IPC.ConfigURL.
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété ConfigURL
    Type de données Chaîne
    Valeur valide http:// Chemin d'accès /ipc.client.props
    Par défaut Aucune
  • Client d'administration Java. Utilisez la propriété AdminClient.CONNECTOR_IPC_CONFIG.

Délai d'expiration de la demande IPC :

La valeur à choisir dépend de plusieurs facteurs, tels que la taille et le nombre d'applications installés sur le serveur, la vitesse de votre machine et son taux d'utilisation.

La valeur par défaut du programme pour le délai d'expiration de la requête est 600 seconds. Toutefois, les valeurs par défaut peuvent être remplacées par celles d'autres composants se connectant au client IPC. Les composants qui utilisent le ipc.client.props fichier ont une valeur par défaut de 180 seconds.

Définissez la propriété en utilisant une des options suivantes :
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • Le ipc.client.props fichier.
    Informations Valeur
    Propriété com.ibm.IPC.requestTimeout
    Type de données Entier
    Intervalle en secondes 0 à n

    Si la propriété est zéro (0), la demande n'expire jamais.
    Par défaut 180
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété requestTimeout
    Type de données Entier
    Intervalle en secondes 0 à n

    Si la propriété est zéro (0), la demande n'expire jamais.
    Par défaut 600
  • Client d'administration Java. La propriété est AdminClient.CONNECTOR_IPC_REQUEST_TIMEOUT.

Protocole de sécurité Secure Sockets Layer (SSL):

Utilisez cette propriété pour activer la sécurité SSL entre le serveur d'applications et le client IPC. Définissez la propriété en utilisant une des options suivantes :
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • Le ipc.client.props fichier.
    Informations Valeur
    Propriété com.ibm.IPC.securityEnabled
    Type de données Boolean
    Par défaut Faux
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété securityEnabled
    Type de données Boolean
    Par défaut Faux
  • Client d'administration Java. Utilisez la propriété AdminClient.CONNECTOR_SECURITY_ENABLED.

Fournisseur de contexte de sécurité :

Cette propriété indique l'implémentation du protocole SSL entre le serveur d'applications et le client IPC.

Définissez la propriété en utilisant le fichier ipc.client.props.
Informations Valeur
Propriété com.ibm.ssl.contextProvider
Type de données Chaîne
Valeurs admises 
IBMJSSE2
Par défaut IBMJSSE2

Alias SSL :

Cette propriété indique l'alias à utiliser pour une configuration SSL des connexions client. Vous pouvez affecter n'importe quelle valeur à cette alias.

Définissez la propriété dans le fichier ipc.client.props.
Informations Valeur
Propriété com.ibm.ssl.alias
Type de données Chaîne
Par défaut DefaultSSLSettings

Propriétés des connecteurs SOAP, RMI, JSR160RMI et IPC

Cette section présente les propriétés de connecteur JMX relatives aux connecteurs SOAP, RMI, JSR160RMI et IPC :

Type de connecteur :

Un connecteur de type SOAP, RMI, JSR160RMI ou IPC selon que le serveur d'applications se connecte à un serveur SOAP, RMI, JSR160RMI ou IPC. Vous pouvez définir la propriété en utilisant une des options suivantes :
  • Outil wsadmin.
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété Type
    Type de données Chaîne
    Valeurs admises 
    SOAPConnector
RMIConnector
JSR160RMIConnector
IPCConnector
    Par défaut 
    SOAPConnector
JSR160RMI
IPC
  • Client d'administration Java. Utilisez la propriété AdminClient.CONNECTOR_TYPE. Indiquez le type de connecteur en utilisant les constantes AdminClient.CONNECTOR_TYPE_RMI, AdminClient.CONNECTOR_TYPE_SOAP, AdminClient.CONNECTOR_TYPE_JSR160RMI ou AdminClient.CONNECTOR_TYPE_IPC.

Désactivation d'un connecteur :

Vous pouvez activer ou désactiver un des connecteurs JMX à partir de la console d'administration.

  • Outil wsadmin.
  • La console d'administration. Cochez la case en regard du connecteur pour activer le connecteur. Désélectionnez cette case à cocher pour désactiver le connecteur.
    Informations Valeur
    Propriété enabled
    Type de données Boolean
    Valeur true|false

Hôte :

Nom d'hôte ou adresse IP du serveur sur lequel le serveur d'applications se connecte. Le serveur peut être un serveur SOAP, RMI, JSR160RMI ou IPC. Vous pouvez définir la propriété en utilisant une des options suivantes :
  • Outil wsadmin.
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété host
    Type de données Chaîne
    Valeurs admises Nom d'hôte ou adresse IP
    Par défaut Aucune
  • Client d'administration Java. Utilisez la propriété AdminClient.CONNECTOR_HOST.

Mot de passe :

Mot de passe utilisé par le serveur d'applications pour accéder au serveur SOAP, RMI, JSR160RMI ou IPC. Vous pouvez définir la propriété en utilisant une des options suivantes :
  • Outil wsadmin.
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • Fichier soap.client.props pour le serveur SOAP, RMI ou JSR160RMI.
    Informations Valeur
    Propriété com.ibm.SOAP.loginPassword
    Type de données Chaîne
    Valeurs admises La valeur doit correspondre aux paramètres SSL globaux pour SOAP, RMI ou JSR160RMI.
    Par défaut Aucune
  • Fichier ipc.client.props pour le serveur IPC.
    Informations Valeur
    Propriété com.ibm.IPC.loginPassword
    Type de données Chaîne
    Valeurs admises La valeur doit correspondre aux paramètres SSL globaux pour IPC.
    Par défaut Aucune
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété Mot de passe
    Type de données Chaîne
    Valeurs admises La valeur doit correspondre aux paramètres SSL globaux pour SOAP, RMI, JSR160RMI ou IPC.
    Par défaut Aucune
  • Client d'administration Java. Utilisez la propriété AdminClient.PASSWORD.

Port :

Numéro de port du serveur sur lequel le serveur d'applications se connecte. Le serveur peut être un serveur SOAP, RMI, JSR160RMI ou IPC. Vous pouvez définir la propriété en utilisant une des options suivantes :
  • Outil wsadmin.
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété port
    Type de données Entier
    Valeur admise Numéro du port
    Par défaut Aucune
  • Client d'administration Java. Utilisez la propriété AdminClient.CONNECTOR_PORT.

Nom d'utilisateur :

Nom utilisé par le serveur d'applications pour accéder au serveur SOAP, RMI, JSR160RMI ou IPC. Vous pouvez définir la propriété en utilisant une des options suivantes :
  • Outil wsadmin.
  • Scripts exécutés à partir d'une interface de ligne de commande.
  • Fichier soap.client.props pour le serveur SOAP, RMI ou JSR160RMI.
    Informations Valeur
    Propriété com.ibm.SOAP.loginUserid
    Type de données Chaîne
    Valeur admise La valeur doit correspondre aux paramètres SSL globaux pour SOAP, RMI ou JSR160RMI.
    Par défaut Aucune
  • Fichier ipc.client.props pour le serveur IPC.
    Informations Valeur
    Propriété com.ibm.IPC.loginUserid
    Type de données Chaîne
    Valeur admise La valeur doit correspondre aux paramètres SSL globaux pour IPC.
    Par défaut Aucune
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété username
    Type de données Chaîne
    Valeur admise La valeur doit correspondre aux paramètres SSL globaux pour SOAP, RMI, JSR160RMI ou IPC.
    Par défaut Aucune
  • Client d'administration Java. Utilisez la propriété AdminClient.USERNAME.

Propriétés du connecteur RMI

Cette section présente les propriétés de connecteur JMX relatives aux connecteurs RMI :

Désactivation du connecteur JSR 160 RMI :

La prise en charge de l'interface de programmation d'application distante JMX (JSR 160) est activée par défaut pour que vous puissiez recevoir automatiquement une fonction JMX compatible avec les spécifications. Pour désactiver la fonction pour un serveur donné, définissez la propriété à l'aide de l'une des options suivantes :

  • Outil wsadmin.
  • La console d'administration. Spécifiez la propriété et la valeur sous la forme d'une paire nom-valeur dans le panneau des propriétés personnalisées du connecteur JMX de la console d'administration.
    Informations Valeur
    Propriété disableJDKJMXConnector
    Type de données chaîne
    Valeur Oui