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.
- Créez et utilisez un seul client d'administration avant d'en créer et d'en utiliser un autre.
- Créez et utilisez un client d'administration sur la même unité d'exécution.
- 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
- Développez un programme client
d'administration.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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.
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.)
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).
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.)
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.)