Creación de un programa cliente administrativo Java personalizado utilizando las API Java administrativas de WebSphere Application Server

Puede desarrollar un programa Java™ para acceder al sistema administrativo WebSphere® Application Server utilizando las interfaces de programación de aplicaciones (API) administrativas del producto.

Antes de empezar

En esta tarea se da por supuesto que se tienen conocimientos básicos de la programación de API de JMX (Java Management Extensions). Para obtener información sobre las API de Java, consulte la documentación de las interfaces de programación de aplicaciones.

Acerca de esta tarea

Cuando desarrolle y ejecute clientes administrativos que utilizan distintos conectores JMX y que tienen habilitada la seguridad, utilice las directrices siguientes. Si sigue estas directrices, garantiza el comportamiento entre distintas implementaciones de conectores JMX. Todo modelo de programación que se desvíe de estas directrices no está soportado.

Cree y utilice un solo cliente administrativo antes de crear y utilizar otro cliente administrativo.
Cree y utilice clientes administrativos en la misma hebra.
Utilice uno de los procedimientos siguientes para especificar el ID de usuario y la contraseña para crear nuevos clientes administrativos:
- Especifique el ID de usuario y contraseña predeterminada en el archivo de propiedades.
- Especifique un ID de usuario y una contraseña que no sean los que se toman de forma predeterminada. Después de crear clientes administrativos con el ID de usuario y la contraseña que no son los que se toman por omisión, especifique el ID de usuario y la contraseña que no son por omisión en los clientes administrativos subsiguientes que cree.

Procedimiento

Desarrollar un programa cliente administrativo.
Si el cliente administrativo utiliza SOAP (Simple Object Access Protocol) como conector, debe configurar JSSE (Java Secure Socket Extension) como capa de transporte. El producto admite SSL (Secure Sockets Layer) y TLS (Transport Layer Security) con paquetes JSSE (Java Secure Sockets Extension) y SSL del sistema.
Cree los certificados digitales para el ID de usuario utilizado para ejecutar el cliente administrativo. Si desea utilizar SAF (System Authorization Facility) para crear certificados digitales y almacenarlos en un conjunto de claves SAF, consulte Definición de la seguridad de SSL para las solicitudes de salida de cliente. (Puede guardar el nombre del conjunto de claves para utilizarlo en el paso siguiente.)
Actualizar elsoap.client.propsarchivo en elprofile_root/propertiesque está utilizando el cliente administrativo con el nombre del conjunto de claves SAF. Consulte el segundo paso en Utilización de conjuntos de claves de System Authorization Facility con Java Secure Sockets Extension para obtener instrucciones sobre la actualización desoap.client.props.xlsx
Cree el programa cliente administrativo.
Compílelo con el mandato javac y proporcione la ubicación de los archivos JAR necesarios en el argumento de la variable classpath.
Por ejemplo, si el directorio de instalación es/DeploymentManagerun mandato típico sería similar al ejemplo siguiente:
```
javac -extdirs "$JAVA_HOME/lib/ext;
/DeploymentManager/classes;/DeploymentManager/lib;
/DeploymentManager/lib/ext"  MyAdminClient.java
```
(El mandato anterior se ha dividido en varias líneas para una mejor visualización.)

Ejecute el programa cliente administrativo.

Para ejecutar el programa cliente administrativo, configure el entorno de ejecución de modo que este pueda encontrar todos los requisitos necesarios. Muchos de los archivos de proceso por lotes o de script en elbinbajo el directorio raíz de instalación realizan una función similar. A continuación se muestra un ejemplo de un archivo de proceso por lotes que ejecuta un programa cliente administrativo denominadoMyAdminClientlos siguientes:

@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 $@

(El contenido del archivo de proceso por lotes anterior se ha dividido en varias líneas para una mejor visualización).