手动创建 Liberty 应用程序客户机

可从命令行创建 Liberty 应用程序客户机。

关于此任务

仅在 client.xml 文件中启用 Java™ EE 应用程序客户机 7.0 功能部件。

过程

  1. 打开命令行,然后将目录切换至 wlp/bin 目录。 在以下示例中,path_to_liberty 指定您在操作系统上安装 Liberty 的位置。
  2. 运行以下命令以创建客户机,其中 client_name 是您要给予客户机的名称。如果未指定客户机名称,那么会使用 defaultClient
    client create client_name
    如果已成功创建客户机,那么会收到以下消息:
    已创建客户机 client_name

    可在 wlp/usr/clients/client_name 目录中找到 client.xml 文件。此文件包含 javaeeClient-7.0 功能部件。

    注意: 如果缺省客户机存在,那么您将收到错误。如果缺省客户机不存在,那么系统会创建 defaultClient
  3. 通过准备其中带有客户机模块 (.jar) 的应用程序 (.ear) 文件来运行客户机应用程序。 在客户机模块的 MANIFEST.MF 中指定 main 类,例如:
    Manifest-Version: 1.0
    Main-Class: com.ibm.ws.addressbook.ContactServiceClient_XMLInject 
  4. 将该 EAR 文件放置到 wlp/usr/clients/client_name/apps 目录下。
  5. 更新 client.xml 文件以配置应用程序,例如:
    <client>
    	<featureManager>
    		<feature>javaeeClient-7.0</feature>
    	<featureManager>
    	<application id="CLIENT_APP" name="CLIENT_APP" type="ear" location="clientApp.ear"/>
    </client>
    如果所指定客户机已存在,那么不会创建客户机,并且您会接收到异常消息:
    CWWKE0005E: 未能启动运行时环境。
    CWWKE0904E: 无法创建名为 client_name 的客户机,因为
    客户机目录 C:\wlp\usr\clients\client_name 已存在。

下一步做什么

可通过将 appSecurityClient-1.0 功能部件添加至 client.xml 文件来对应用程序客户机启用安全性(SSL、CSIv2 和 JAAS):
<featureManager>
	<feature>javaeeClient-7.0</feature>
	<feature>appSecurityClient-1.0</feature>
</featureManager>

有关在应用程序客户机上配置安全性的更多信息,请参阅为 Liberty 应用程序客户机容器及其应用程序配置安全性


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

文件名:twlp_setup_new_client.html