Création d'un programme client d'administration Java personnalisé à l'aide des API Java d'administration de WebSphere Application Server

Cette section explique comment développer un programme Java™ pour accéder au système d'administration de WebSphere Application Server à l'aide des API (Application Programming Interfaces) d'administration du produit.

Avant de commencer

Cette tâche suppose une connaissance de base de la programmation d'API JMX (Java Management Extensions). Pour des informations sur les API Java, voir la documentation des interfaces de programme d'application.

Pourquoi et quand exécuter cette tâche

Lorsque vous développez et exécutez des clients d'administration qui utilisent différents connecteurs JMX et pour lesquels la sécurité est activée, respectez les recommandations suivantes. En suivant ces recommandations, vous assurez une cohérence de comportement parmi les différentes implémentations des connecteurs JMX. Tout modèle de programmation qui s'écarte de ces recommandations n'est pas pris en charge.
  1. Créez et utilisez un seul client d'administration avant d'en créer et d'en utiliser un autre.
  2. Créez et utilisez un client d'administration sur la même unité d'exécution.
  3. Utilisez l'une des méthodes suivantes pour spécifier un ID utilisateur et un mot de passe en vue de créer un client d'administration :
    • Spécifiez un ID utilisateur et un mot de passe par défaut dans le fichier de propriétés.
    • Spécifiez un ID utilisateur et un mot de passe personnalisés. Une fois que vous avez créé un client d'administration en utilisant un ID utilisateur et un mot de passe personnalisés, spécifiez un ID utilisateur et un mot de passe personnalisés lors de la création de clients d'administration ultérieurs.

Procédure

  1. Développez un programme client d'administration.
  2. [AIX Solaris HP-UX Linux Windows][IBM i]Générez et exécutez le programme client d'administration.

    La procédure requise pour ce faire dépend du type d'environnement dans lequel le code s'exécute.

    Pour obtenir plus d'informations sur la génération et l'exécution d'un programme client d'administration, reportez-vous à la rubrique Utilisation de clients d'application.

  3. [z/OS]Si le client d'administration utilise un connecteur SOAP (Simple Object Access Protocol), vous devez configurer la couche de transport JSSE (Java Secure Socket Extension). Le produit utilise SSL (Secure Sockets Layer) et TLS (Transport Layer Security) avec les composants JSSE (Java Secure Sockets Extension) et SSSL (System SSL). Créez des certificats numériques pour l'ID utilisateur avec lequel le client d'administration s'exécute. Si vous souhaitez utiliser SAF (System Authorization Facility) pour créer des certificats numériques et les stocker dans un fichier de clés SAF, reportez-vous à la rubrique Définition de la sécurité SSL pour les requêtes sortantes client. (Vous pouvez sauvegarder le nom du fichier de clés que vous créez pour l'utiliser à l'étape suivante.)
  4. [z/OS]Mettez à jour le fichier soap.client.props dans le répertoire profile_root/properties utilisé par le client d'administration en incluant le fichier de clés SAF. Pour plus d'instructions sur la mise à jour du fichier soap.client.props, reportez-vous à la deuxième étape de la rubrique Utilisation de fichiers de clés SAF (System Authorization Facility) avec JSSE (Java Secure Sockets Extension).
  5. [z/OS]Générez le programme client d'administration.

    Compilez-le avec la commande javac et indiquez l'emplacement des fichiers JAR requis dans l'argument de chemin de classes.

    Par exemple, si votre répertoire d'installation est /DeploymentManager, une commande typique ressemblera à ce qui suit :
    javac -extdirs "$JAVA_HOME/lib/ext;
    /DeploymentManager/classes;/DeploymentManager/lib;
    /DeploymentManager/lib/ext"  MyAdminClient.java

    (La commande précédente est répartie sur plusieurs lignes à des fins de publication.)

  6. [z/OS]Exécutez le programme client d'administration.

    Exécutez le programme client d'administration en configurant l'environnement d'exécution de façon à ce que le programme puisse trouver tous les éléments requis. La plupart des fichiers de commandes ou de fichiers script du répertoire bin situé sous la racine d'installation ont une fonction similaire. Voici un exemple de fichier de commandes qui exécute un programme client d'administration nommé MyAdminClient :

    @echo off
    
    call "%~dp0setupCmdLine.bat"
    
    "%JAVA_HOME%\bin\java" "%CLIENTSAS%" "-Dwas.install.root=%WAS_HOME%" 
    "-Dwas.repository.root=%CONFIG_ROOT%" 
    -Dcom.ibm.CORBA.BootstrapHost=%COMPUTERNAME% 
     "-Djava.ext.dirs=%JAVA_HOME%\jre\lib\ext;%WAS_HOME%\classes;
    %WAS_HOME%\lib;%WAS_HOME%\lib\ext" MyAdminClient %*</pre>--><!--(The contents of the previous batch file is split on multiple lines for publication.)--><pre>@echo off
    
    binDir=`dirname "$0"`       
    . "$binDir/setupCmdLine.sh"
    
    
    "$JAVA_HOME/bin/java" "$CLIENTSOAP" "-Dwas.install.root=$WAS_HOME"
    "-Dwas.repository.root=$CONFIG_ROOT" 
    -Dcom.ibm.CORBA.BootstrapHost=$COMPUTERNAME 
     "-Djava.ext.dirs=$JAVA_HOME/lib/ext;$WAS_HOME/classes;
    $WAS_HOME/lib;$WAS_HOME/lib/ext" MyAdminClient $@

    (Le contenu du précédent fichier de commandes est réparti sur plusieurs lignes à des fins de publication.)


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjmx_customjava
Nom du fichier : tjmx_customjava.html