launchClient 工具

您可以使用Java™ Platform, Enterprise Edition（ Java EE ）命令行语法launchClient工具WebSphere® Application Server。

您可以使用launchClient来自节点内的命令WebSphere Application Server Network Deployment环境。 但是，不要尝试从 Deployment Manager 使用 launchClient 命令。

重要的：从特定配置文件运行命令的所有用户都必须具有修改使用相同配置文件的其他用户创建的文件的权限。 否则，日志文件中会出现许可权拒绝错误。 为避免此问题，请考虑使用下列其中一个策略：
  • [AIX Solaris HP-UX Linux Windows][IBM i]使用特定配置文件来区分不同的用户权限
  • [z/OS]使用另一安装版本，以获取不同用户权限
  • 始终对通过给定概要文件运行的所有命令使用同一用户
  • 确保特定概要文件的所有用户都属于同一组。 此外，请确保组的每个用户都对同一概要文件中由其他成员创建的文件具有读写权限。

以下示例描述了 launchClient 工具的命令行调用语法：

launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
其中
  • userapp 是包含应用程序客户机的 EAR 文件的路径和名称。
  • -CCname=value 是客户机容器的“名称/值”对参数。 请参阅客户机容器参数部分，以获取支持的“名称/值”对参数的信息。
  • app args 是传递给应用程序客户机的参数。
  • -profileName 定义在多概要文件安装中的 Application Server 进程的概要文件。 对于在单个概要文件环境或应用程序客户机安装中运行，-profileName 选项不是必需的。

    [AIX Solaris HP-UX Linux Windows][z/OS]默认值为default_profile。

  • -JVM选项是有效的 Java 标准或非标准选项字符串，但以下情况除外-cp或者-classpath。 用引号将字符串引起来。
  • -帮助， -？打印使用信息。

第一个参数必须是 -help、-? 或根本不包含参数。 -profileName pName 和 -JVMOptions 选项是可选参数。 如果使用，它们必须出现在<用户应用>范围。 其他所有参数是可选参数，可以任意顺序出现在 userapp 参数后面。 这Java EE应用程序客户端运行时忽略任何不以-CC前缀并将这些参数传递给应用程序客户端。

客户机容器参数

支持的参数包括：

-CCadminConnectorHost
指定从其检索配置信息的服务器的主机名。

[AIX Solaris HP-UX Linux Windows][z/OS]默认值是-CCBootstrapHost参数或值，本地主机，如果-CCBootstrapHost未指定参数。

[IBM i]默认值是-CCBootstrapHost参数或值，your.server.name，如果-CCBootstrapHost未指定参数。

-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默认值是用过的。
-CCclassLoaderMode
指定类装入器 方式。 如果指定了 PARENT_LAST，那么类装入器在将类装入委托给其父类之前，首先从本地类路径装入类。 下列装入的类会受到影响：
  • 为以下类别定义Java EE应用程序客户端
  • 资源定义在Java EE应用
  • 清单上指定的类别Java EE客户端 JAR 文件
  • 使用 -CCclasspath 选项指定的类
如果没有指定 PARENT_LAST，那么使用缺省方式 PARENT_FIRST，这会导致类装入器在尝试从类的本地类路径装入此类之前，首先将类装入委托给其父类装入器。
-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 或 Internet Inter-ORB 协议 (IIOP) URL。 CORBA 对象 URL 比 IIOP URL 更灵活，并且是建议要使用的 URL 格式。 该值可以获得多个引导服务器地址。 当尝试从服务器集群中获取初始上下文时，可以使用该功能部件。 您可以用 URL 指定集群中所有服务器的引导服务器地址。 如果至少有一个服务器在运行，那么消除单点故障，此操作将会成功。 地址列表不是以特定顺序处理的。 对于命名操作，此值将覆盖-CCBootstrapHost和-CCBootstrapPort参数。 以下示例描述了一个指定多个系统的 CORBA 对象 URL：
-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
该值映射到java.naming.provider.url系统属性。
-CCsecurityManager
启用并运行WebSphere Application Server与安全经理一起。 缺省设置为“disable.
-CCsecurityMgrClass
表明实现安全管理器的类的标准名称。 仅当-CCsecurityManager参数设置为enable。默认值为java.lang.SecurityManager.
-CCsecurityMgrPolicy
表明安全管理器策略文件名。 仅当 -CCsecurityManager 参数设置为 enable 时才使用该参数。 启用此参数后，java.security.policy系统属性已设置。 默认值为应用程序服务器根目录/properties/client.policy。
-CCsoapConnectorPort
简单对象访问协议 (SOAP) 连接器端口。 如果不指定此参数， WebSphere Application Server使用默认值。
-CCtrace
使用此选项以获取调试跟踪信息。 您可能需要此信息来向以下机构报告问题IBM®客户支持。 缺省设置为“false。有关更多信息，请阅读启用跟踪主题。
-CCtracefile
表明写跟踪信息的文件名。 缺省值为将输出写到控制台。
-CCtraceMode
指定用于跟踪的跟踪格式。 如果没有指定有效值 basic，那么优先使用缺省值。 基本跟踪格式是跟踪更压缩的格式。

[AIX Solaris HP-UX Linux Windows][IBM i]有关基本和高级跟踪格式的更多信息，请参阅解释跟踪输出主题。

-CCverbose
此选项显示其他参考消息。 缺省值为 false。

如果要在启用安全性的情况下使用 EJB 客户机应用程序，那么编辑 sas.client.props 文件（它位于 profile_root/properties 目录中）。 在该文件中，将 com.ibm.CORBA.loginSource 值更改为 none。

更多关于 sas.client.props 实用程序的信息，请参阅“在属性文件和 PropFilePasswordEncoder 命令参考中手动编写密码”主题。

具有安全性的 RMI 连接。 与 EJB 和管理客户机应用程序配合使用。
使用 Jacl：
[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -conntype RMI -port  rmiportnumber -user userid 
-password password
[z/OS]
wsadmin.sh -conntype RMI -port  rmiportnumber -user userid 
-password password

使用 Jython：

[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -lang jython -conntype RMI -port  rmiportnumber -user userid 
-password password
[z/OS]
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]
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
[AIX HP-UX Solaris][z/OS]
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
[IBM i]
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
   -profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2