使用 Administration Thin Client
借助 Administration Thin Client,您可以运行 wsadmin 工具或独立管理 Java™ 程序以及仅仅几个 Java 归档 (JAR) 文件。这可以减少 wsadmin 工具启动所用的时间并提高性能。此信息用于设置 JMX 客户机程序。
开始之前
- 客户机管理应用程序仅使用 SOAP 连接器。
- 管理客户机应用程序使用 com.ibm.websphere.management.AdminClientFactory API 来获取 JMX 客户机。
关于此任务
不能使用 Administration Thin Client 来管理功能部件包,也不能使用它来部署特定于功能部件包的应用程序工件。
Administration Thin Client 不支持安装 SIP 应用程序归档 (SAR) 文件,也不支持编辑那些使用外部 Java Authorization Contract for Containers (JACC) 提供程序(例如,Tivoli® Access Manager)的应用程序。
Administration Thin Client 不支持将 Kerberos 令牌传递给服务器。它仅支持基本认证,基本认证将传递用户标识和密码。
Administration Thin Client 不支持与其他瘦客户机共存。
z/OS® 平台上的 Administration Thin Client 不使用 localcomm。
有关 Administration Thin Client 的跟踪和记录信息,请参阅 中的『对客户机和独立应用程序启用跟踪』。
过程
- 通过将 com.ibm.ws.admin.clientXXX.jar 从 WebSphere® Application Server 环境复制到位于 WebSphere Application Server 外部的环境(例如 c:\MyThinClient),提供 Administration Thin Client JAR 文件。 com.ibm.ws.admin.client_9.0.jar 和 com.ibm.ws.admin.client.forJython21_9.0.jar Administration Thin Client JAR 文件位于以下其中一个位置:
- AppServer/runtimes 目录。
- AppClient/runtimes 目录(如果在安装应用程序客户机时根据情况选择了 Administration Thin Client)。
对于jython27,需要使用 com.ibm.ws.admin.client_9.0.jar,而对于 jython21,需要使用 com.ibm.ws.admin.client.forJython21_9.0.jar。
注: 在 V9 中,缺省情况下 wsadmin 将使用 jython27。Jython21 仍然受支持;要使用 jython21,需要使用 wsadmin 自变量 -usejython21 true,或者在 wsadmin.properties 文件中更新 com.ibm.ws.scripting.usejython21=true。避免故障: 如果您看到错误并且 jython 无法装入,那么表示存在配置错误,例如,您在使用 jython21 的情况下却将类路径设置为 com.ibm.ws.admin.client_9.0.jar,或在使用 jython27 的情况下却将 Java 类路径设置为 com.ibm.ws.admin.client.forJython21_9.0.jar。确保您将 Java 类路径设置为正确的 JAR。Jython27 不支持 Java 7 或更低版本。必须与尝试连接至的 WebSphere 服务器使用相同的 Java 级别。gotcha
- 使用 Administration Thin Client JAR 文件来编译和测试管理客户机程序。对于 Java 应用程序,可以在标准 Java 2 Platform, Standard Edition 环境中编译并运行这些 JAR 文件。有关更多信息,请参阅使用瘦管理客户机来编译管理应用程序主题。
- 将消息目录从 app_server_root/properties 目录复制到 C:\MyThinClient\properties 目录。
- 如果已启用安全性,那么还需要以下文件:
- 从 AppServer/plugins 目录或 AppClient/plugins 目录复制 com.ibm.ws.security.crypto.jar 文件,并将其放入 C:\MyThinClient 目录。
- 如果正在使用 IPC 连接器,(可选)请从 AppServer\profiles\profileName/properties 或 AppClient\properties 目录复制 ipc.client.props 文件并将其放入 \MyThinClient\properties 目录。或者,可以在 Java 代码中以编程方式设置 ipc.client.props 文件中的属性。
- 如果正在使用 SOAP 连接器,(可选)请从 AppServer\profiles\profileName\properties 目录复制 soap.client.props 文件并将其放入 C:\MyThinClient\properties 目录。然后,启用客户机安全性,方式是将 com.ibm.CORBA.securityEnabled 属性设置为 true。或者,可以在 Java 代码中以编程方式设置 soap.client.props 文件中的属性。
- 如果正在使用 RMI 或 JSR160RMI 连接器,请从 AppServer/profiles/profileName/properties
目录复制 sac.client.props 文件并将其放入 C:\MyThinClient\properties 目录。
如果您的安装版本中存在防火墙并且应用程序客户机使用 RMI 来接收通知,那么在尝试部署应用程序之后可能会发生 RemoteException 错误。存在防火墙时,带有 RMI 的通知侦听器不起作用,这是因为它要求侦听通知的客户机具有侦听器端口。当服务器尝试将通知发送回客户机端口时,无法直接访问此侦听器端口。请使用 SOAP 连接器来代替 RMI,该连接器会轮询通知。
- 从 AppServer\profiles\profileName/properties 目录或 AppClient/properties 目录复制 wsjaas_client.conf 文件,并将其放入 C:\MyThinClient\properties 目录。
- 从 AppServer\profiles\profileName/properties 目录或 AppClient/properties 目录复制或生成 ssl.client.props 文件,并将其放入 C:\MyThinClient\properties 目录。注意: 此文件包含 user.root 属性。必须将该值修改为瘦客户机目录,例如,C:\MyThinClient。
- 如果正在使用 IBM SDK,请从 AppServer\profiles\profileName\etc 目录复制 key.p12 和 trust.p12 文件,并将其放入 C:\MyThinClient\etc 目录。要完成此任务,请将该文件复制到瘦客户机目录,或者运行脚本来生成该文件。有关更多信息,请参阅以下主题:
- ssl.client.props 客户机配置文件
- 与先前的产品版本互操作
- retrieveSigners 命令
- 在 SSL 中进行安全安装以检索客户机签署者
- 如果正在使用 Sun JDK ,请更改 ssl.client.props
文件中的以下属性,以便它在密钥和信任库管理器中使用
JKS 密钥和信任库以及 Sun Microsystems 实现:
com.ibm.ssl.alias=DefaultSSLSettings com.ibm.ssl.protocol=SSL com.ibm.ssl.securityLevel=HIGH com.ibm.ssl.trustManager=SunX509 com.ibm.ssl.keyManager=SunX509 com.ibm.ssl.contextProvider=SunJSSE com.ibm.ssl.enableSignerExchangePrompt=gui # Keystore information com.ibm.ssl.keyStoreName=ClientDefaultKeyStore com.ibm.ssl.keyStore=${user.root}/etc/keystore.jks com.ibm.ssl.keyStorePassword=keystore_password com.ibm.ssl.keyStoreType=JKS com.ibm.ssl.keyStoreProvider=SUN com.ibm.ssl.keyStoreFileBased=true # Truststore information com.ibm.ssl.trustStoreName=ClientDefaultTrustStore com.ibm.ssl.trustStore=${user.root}/etc/truststore.jks com.ibm.ssl.trustStorePassword=truststore_password com.ibm.ssl.trustStoreType=JKS com.ibm.ssl.trustStoreProvider=SUN com.ibm.ssl.trustStoreFileBased=true
- 启动 Administration Thin Client 或在 Java 2 Platform, Standard Edition 环境中以远程方式运行 wsadmin 工具。 要启动管理应用程序,使用以下样本启动脚本:注: 如果使用 Oracle JDK,请将 com.ibm.websphere.thinclient JVM 属性设置为 true。
set WAS_HOME=c:\MyThinClient set USER_INSTALL_ROOT=%WAS_HOME% set JAVA_HOME=location_of_the_JRE_file REM C_PATH is the class path. Add to it as needed. REM Classpath to use for jython27 (comment this out if using jython21) set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar REM Classpath to use for jython21 (uncomment this to use jython21) REM set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client.forJython21_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar set SOAPURL=-Dcom.ibm.SOAP.ConfigURL=%WAS_HOME%\properties\soap.client.props set TC=-Dcom.ibm.websphere.thinclient=true if exist %JAVA_HOME%\bin\java.exe ( set JAVA_EXE=%JAVA_HOME%\bin\java ) else ( set JAVA_EXE=%JAVA_HOME%\jre\bin\java ) %JAVA_EXE% -classpath "%C_PATH%" %TC% -Duser.install.root=%USER_INSTALL_ROOT% -Dcom.ibm.SSL.ConfigURL=file %WAS_HOME%/properties/ssl.client.props %SOAPURL% your_class_file#
!/bin/bash WAS_HOME=/MyThinClient USER_INSTALL_ROOT=${WAS_HOME} JAVA_HOME=location_of_the_JRE_file # C_PATH is the class path. Add to it as needed. # Classpath to use for jython27 (comment this out if using jython21) C_PATH=${WAS_HOME}/com.ibm.ws.admin.client_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar # Classpath to use for jython27 (comment this out if using jython27) C_PATH=${WAS_HOME}/com.ibm.ws.admin.client.forJython21_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar SOAPURL=-Dcom.ibm.SOAP.ConfigURL=${WAS_HOME}/properties/soap.client.props TC=-Dcom.ibm.websphere.thinclient=true if [[ -f ${JAVA_HOME}/bin/java ]]; then JAVA_EXE="${JAVA_HOME}/bin/java" else JAVA_EXE="${JAVA_HOME}/jre/bin/java" fi ${JAVA_EXE} -classpath "${C_PATH}" $TC -Duser.install.root=${USER_INSTALL_ROOT} -Dcom.ibm.SSL.ConfigURL=file:${WAS_HOME}/properties/ssl.client.props ${SOAPURL} your_class_file
子主题
使用瘦管理客户机来编译管理应用程序
使用 wsadmin 工具和瘦管理客户机来编译应用程序。在 Java 2 Platform, Standard Edition 环境中以远程方式运行 wsadmin 工具
瘦管理客户机增加了支持管理客户机功能的 Java 归档 (JAR) 文件,可以将这些文件与 IBM Developer Kit For the Java Platform 配合使用。使用 wsadmin 脚本编制来审计 wsadmin 工具的调用
运行作为环境设置的一部分的下列 wsadmin 脚本任务:创建集群定义、创建数据源和 JMS 对象配置或安装组成应用程序服务器上的受管软件的一个或多个 EAR 文件。每个 wsadmin 和非 wsadmin 脚本都需要支持以下功能:捕获在运行脚本时所执行的活动的日志。目录约定
产品信息中对 app_server_root、profile_root 及其他目录的引用暗示特定缺省目录位置。请熟悉用于 WebSphere Application Server 的约定。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_adminclient
文件名:txml_adminclient.html