launchClient 工具
您可以对 WebSphere® Application Server 的 launchClient 工具使用 Java™ Platform, Enterprise Edition (Java EE) 命令行语法。
您可以从 WebSphere Application Server Network Deployment 环境中的节点使用 launchClient 命令。但是,不要尝试从 Deployment Manager 使用 launchClient 命令。
使用特定概要文件,以获取不同用户权限
使用另一安装版本,以获取不同用户权限
- 始终对通过给定概要文件运行的所有命令使用同一用户
- 确保特定概要文件的所有用户都属于同一组。此外,请确保组的每个用户都对同一概要文件中由其他成员创建的文件具有读写权限。
以下示例描述了 launchClient 工具的命令行调用语法:
launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
- userapp 是包含应用程序客户机的 EAR 文件的路径和名称。
- -CCname=value 是客户机容器的“名称/值”对参数。请参阅客户机容器参数部分,以获取支持的“名称/值”对参数的信息。
- app args 是传递给应用程序客户机的参数。
- -profileName 定义在多概要文件安装中的 Application Server 进程的概要文件。对于在单个概要文件环境或应用程序客户机安装中运行,-profileName 选项不是必需的。
缺省值为 default_profile。
- -JVMOptions 是有效的 Java 标准或非标准选件字符串(除 -cp和 -classpath 外)。用引号将字符串引起来。
- -help, -? 打印用法信息。
第一个参数必须是 -help、-? 或根本不包含参数。-profileName pName 和 -JVMOptions 选项是可选参数。如果使用它们,那么它们必须出现在 <userapp> 参数前面。其他所有参数是可选参数,可以任意顺序出现在 userapp 参数后面。 Java EE 应用程序客户机运行时忽略所有不是以 -CC 前缀开头的可选参数,并将那些参数传递到应用程序客户机。
客户机容器参数
支持的参数包括:
- -CCadminConnectorHost
- 指定从其检索配置信息的服务器的主机名。
缺省值为 -CCBootstrapHost 参数的值,或者如果没有指定 -CCBootstrapHost 参数,那么缺省值为值 localhost。
缺省值为 -CCBootstrapHost 参数的值,或者如果没有指定 -CCBootstrapHost 参数,那么缺省值为值 your.server.name。
- -CCadminConnectorPort
- 表明管理客户机功能要使用的端口号。对于 SOAP 连接,缺省值为 8880,而对于远程方法调用 (RMI) 连接,缺省值为 2809。
- -CCadminConnectorType
- 指定管理客户机如何连接到服务器。指定 RMI 以使用 RMI 连接类型,或者指定 SOAP 以使用 SOAP 连接类型。缺省值为 SOAP。
- -CCadminConnectorUser
- 当服务器需要认证时,管理客户机使用此用户名。如果连接类型是 SOAP,而且在服务器上已启用安全性,那么此参数是必需参数。
- -CCadminConnectorPassword
- -CCadminConnectorUser 参数指定的用户名的密码。
- -CCaltDD
- 备用部署描述符文件的名称。此参数与 -CCjar 参数一起使用可指定要使用的部署描述符。当客户机 JAR 文件配置有多个部署描述符时,使用此参数。将该值设置为 null,以使用客户机 JAR 文件的标准部署描述符。
- -CCBootstrapHost
- 您希望初始连接到主机服务器的名称。格式是:your_server_of_choice.com
- -CCBootstrapPort
- 服务器端口号。如果未指定此自变量,那么 WebSphere Application Server 缺省值为 used。
- -CCclassLoaderMode
- 指定类装入器 方式。如果指定了 PARENT_LAST,那么类装入器在将类装入委派给其父类之前,首先从本地类路径装入类。下列装入的类会受到影响:
- 为 Java EE 应用程序客户机定义的类
- 在 Java EE 应用程序中定义的资源
- 在 Java EE 客户机 JAR 文件的清单中指定的类
- 使用 -CCclasspath 选项指定的类
- -CCclasspath
- 类路径值。当您启动应用程序时,使用系统类路径。如果您要访问不在 EAR 文件中的类或系统类路径的一部分,那么在此指定相应的类路径。可连接多个路径。
- -CCD
- 使用此选项可以使 WebSphere Application Server 在安装期间设置指定的系统属性。不要在 -CCD 之后使用等号 (=)。 例如:-CCDcom.ibm.test.property=testvalue。您可指定多个 -CCD 参数。此参数的常规格式为 -CCD<property key>=<property value>。例如,-CCDI18NService.enable=true。
- -CCdumpJavaNameSpace
- 控制已启动应用程序的 java: 名称空间转储的生产,可用于调试目的。值 true 生成短格式的转储,并包含每个绑定的名称和对象类型。值 long 生成长格式转储,并包含每个短格式绑定的附加信息,例如本地对象类型和本地对象的字符串表示。缺省值为 false,不生成转储。
- -CCexitVM
- 使用此选项可以使 WebSphere Application Server 在客户机应用程序完成后调用 System.exit() 方法。 缺省值为 false。
- -CCinitonly
- 使用此选项以初始化 ActiveX 应用程序客户机的应用程序客户机运行时,而无需启动客户机应用程序。缺省值为 false。
- -CCjar
- 驻留在要启动的应用程序的 EAR 文件内的客户机 Java 归档 (JAR) 文件名称。当在 EAR 文件中有多个客户机 JAR 文件时,才使用此参数。
- -CCpropfile
- 表明包含 launchClient 属性的属性文件名。在文件中指定不带 -CC 前缀的属性,属性 securityManager、securityMgrClass 和 securityMgrPolicy 除外。请参阅以下示例:verbose=true。
- -CCproviderURL
- 提供引导服务器信息,初始上下文工厂可以使用它获得初始上下文。WebSphere Application Server 初始上下文工厂可以使用公共对象请求代理体系结构 (CORBA) 对象 URL,或者因特网 ORB 间协议 (IIOP) URL。CORBA 对象 URL 比 IIOP URL 更灵活,并且是建议要使用的 URL 格式。该值可以获得多个引导服务器地址。当尝试从服务器集群中获取初始上下文时,可以使用该功能部件。
您可以用 URL 指定集群中所有服务器的引导服务器地址。如果至少有一个服务器在运行,那么消除单点故障,此操作将会成功。
地址列表不是以特定顺序处理的。对于命名操作,该值将重设 -CCBootstrapHost 和 -CCBootstrapPort 参数。以下示例描述了一个指定多个系统的 CORBA 对象 URL:
该值将被映射至 java.naming.provider.url 系统属性。-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
- -CCsecurityManager
- 通过安全管理器启用并运行 WebSphere Application Server。缺省为禁用。
- -CCsecurityMgrClass
- 表明实现安全管理器的类的标准名称。只有当 -CCsecurityManager 参数设置为启用时才使用此参数。缺省为 java.lang.SecurityManager。
- -CCsecurityMgrPolicy
- 表明安全管理器策略文件名。仅当 -CCsecurityManager 参数设置为 enable 时才使用该参数。 当启用此参数时,设置 java.security.policy 系统属性。缺省值为 app_server_root/properties/client.policy。
- -CCsoapConnectorPort
- 简单对象访问协议 (SOAP) 连接器端口。如果未指定此自变量,那么 WebSphere Application Server 缺省值为 used。
- -CCtrace
- 使用此选项以获取调试跟踪信息。向 IBM® 客户支持报告问题时,可能会需要此信息。缺省值为 false。有关更多信息,请参阅“启用跟踪”主题。
- -CCtracefile
- 表明写跟踪信息的文件名。缺省值为将输出写到控制台。
- -CCtraceMode
- 指定用于跟踪的跟踪格式。如果没有指定有效值 basic,那么优先使用缺省值。基本跟踪格式是跟踪更压缩的格式。
更多关于基本和高级跟踪格式化的信息,请参阅“解释跟踪输出”主题。
- -CCverbose
- 此选项显示其他参考消息。缺省值为 false。
如果要在启用安全性的情况下使用 EJB 客户机应用程序,那么编辑 sas.client.props 文件(它位于 profile_root/properties 目录中)。在该文件中,将 com.ibm.CORBA.loginSource 值更改为 none。
更多关于 sas.client.props 实用程序的信息,请参阅“在属性文件和 PropFilePasswordEncoder命令引用中手动编写密码”主题。
- 具有安全性的 RMI 连接。与 EJB 和管理客户机应用程序配合使用。
- 使用 Jacl:
wsadmin -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -conntype RMI -port rmiportnumber -user userid -password password
使用 Jython:
wsadmin -lang jython -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -lang jython -conntype RMI -port rmiportnumber -user userid -password password
您的连接的 rmiportnumber 在管理控制台中显示为 BOOTSTRAP_ADDRESS。
注意: 在 AIX®、HP-UX、Linux、IBM i、Solaris 和 z/OS® 操作系统上,使用 -password 选项可能会造成安全性暴露,因为密码信息对系统状态程序(例如 ps 命令)可见,而其他用户可以调用此状态程序,显示所有正在运行的进程。如果考虑到安全隐患问题,请不要使用此选项。反之,在 soap.client.props 文件中为 SOAP 连接器或 sas.client.props 文件中为 RMI 连接器指定用户和密码信息。soap.client.props 和 sas.client.props 文件位于 WebSphere Application Server 概要文件的属性目录中。如果启用 Kerberos (KRB5) 用于管理认证,那么认证目标支持 BasicAuth 和 KRB5。要使用 KRB5,请根据连接器类型更新 sas.client.props、soap.client.props 和 ipc.client.props 文件。
注意: 使用 Kerberos 认证时,用户密码不会流向连线。使用单向散列密码来识别客户机。
下列示例说明了正确的语法。
![[Windows]](../images/windows.gif)
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
![[AIX HP-UX Solaris]](../images/unix.gif)
![[z/OS]](../images/ngzos.gif)
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
![[IBM i]](../images/iseries.gif)
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
-profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2