使用 Administration Thin Client

借助 Administration Thin Client,您可以运行 wsadmin 工具或独立管理 Java™ 程序以及仅仅几个 Java 归档 (JAR) 文件。这可以减少 wsadmin 工具启动所用的时间并提高性能。此信息用于设置 JMX 客户机程序。

开始之前

验证是否已将 IBM® Software Development Kit (SDK) 安装在 Administration Thin Client 上。建议与管理瘦客户机环境中将连接至的服务器使用相同的 IBM SDK。
要点: IBM SDK 支持 Administration Thin Client。具有相同主版本的相应 Oracle Java Development Kit (JDK) 也支持 Administration Thin Client,前提是:
  • 客户机管理应用程序仅使用 SOAP 连接器。
  • 管理客户机应用程序使用 com.ibm.websphere.management.AdminClientFactory API 来获取 JMX 客户机。
注意: 不能使用 -conntype NONE 选项来运行管理瘦客户机。

关于此任务

不能使用 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 的跟踪和记录信息,请参阅 中的『对客户机和独立应用程序启用跟踪』。

过程

  1. 通过将 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.jarcom.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
  2. 使用 Administration Thin Client JAR 文件来编译和测试管理客户机程序。对于 Java 应用程序,可以在标准 Java 2 Platform, Standard Edition 环境中编译并运行这些 JAR 文件。有关更多信息,请参阅使用瘦管理客户机来编译管理应用程序主题。
  3. 将消息目录从 app_server_root/properties 目录复制到 C:\MyThinClient\properties 目录。
  4. 如果已启用安全性,那么还需要以下文件:
    • AppServer/plugins 目录或 AppClient/plugins 目录复制 com.ibm.ws.security.crypto.jar 文件,并将其放入 C:\MyThinClient 目录。
    • 如果正在使用 IPC 连接器,(可选)请从 AppServer\profiles\profileName/propertiesAppClient\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.p12trust.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
  5. 启动 Administration Thin Client 或在 Java 2 Platform, Standard Edition 环境中以远程方式运行 wsadmin 工具 要启动管理应用程序,使用以下样本启动脚本:
    注: 如果使用 Oracle JDK,请将 com.ibm.websphere.thinclient JVM 属性设置为 true。
    [Windows]
    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#
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    !/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

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_adminclient
文件名:txml_adminclient.html