此部分描述了如何使用产品管理应用程序编程接口 (API) 来开发 Java™ 程序,以访问 WebSphere® Application Server 管理系统。
开始之前
此任务假设您基本熟悉 Java 管理扩展 (JMX) API 编程。有关 Java API 的信息,请查看应用程序编程接口文档。
关于此任务
当您开发和运行使用各种 JMX 连接器并启用安全性的管理客户机时,使用下列准则。
当您遵循这些准则时,您保证 JMS 连接器不同实现之间的行为。偏离这些准则的任何编程模型不受支持。
- 在创建和使用另一个管理客户机前,创建和使用单个管理客户机。
- 在同一线程上创建和使用管理客户机。
- 使用下列某种方法指定用于创建新管理客户机的用户标识和密码:
- 在属性文件中指定缺省用户标识和密码。
- 指定不同于缺省值的用户标识和密码。一旦您使用非缺省用户标识和密码创建管理客户机后,在您创建后续管理客户机时也指定非缺省用户标识和密码。
过程
- 开发管理客户机程序。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
构建并运行管理客户机程序。 构建并运行程序的所需步骤取决于代码运行的应用程序环境类型。
请参阅『使用应用程序客户机』,以获取有关如何构建并运行管理客户机程序的详细信息。
如果管理客户机使用简单对象访问协议 (SOAP) 作为其连接器,那么您必须将
Java 安全套接字扩展 (JSSE) 配置为传输层。该产品使用安全套接字层 (SSL) 支持以及带有 Java 安全套接字扩展 (JSSE) 及系统 SSL 包的传输层安全性 (TLS) 支持。 为用于运行管理客户机的用户标识配置数字证书。如果要使用系统授权工具 (SAF) 来创建数字证书并将它们存储在 SAF 密钥环中,请参阅为客户机出站请求定义 SSL 安全性。(可保存创建的密钥环名称以便在下一步中使用。)
使用 SAF 密钥环的名称在 profile_root/properties 目录中更新管理客户机要使用的
soap.client.props 文件。有关更新 soap.client.props 文件的指示信息,请参阅“使用带有 Java 安全套接字扩展的系统授权工具密钥环”中的第二步。
构建管理客户机程序。 用 javac
命令编译它,并在类路径参数中提供必需的 JAR 文件的位置。
例如,如果您的安装目录是
/DeploymentManager,典型的命令应该如以下示例中那样:
javac -extdirs "$JAVA_HOME/lib/ext;
/DeploymentManager/classes;/DeploymentManager/lib;
/DeploymentManager/lib/ext" MyAdminClient.java
(前一条命令分割成多行以便于排版。)
运行管理客户机程序。 通过设置运行时环境运行管理客户机程序,这样该程序可以查找所有的先决条件。
安装根下的 bin 目录中的很多批处理或脚本文件执行类似的功能。以下是运行管理客户机程序
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 $@
(前一个批处理文件的内容分割成多行以便于排版。)