调用 mfpadm Ant 任务

可以使用 mfpadm Ant 任务及其相关命令来管理 MobileFirst 应用程序。

语法

调用 mfpadm Ant 任务，如下所示：
<mfpadm url=... user=... password=...|passwordfile=... [secure=...]>
    some commands
</mfpadm>

属性

mfpadm Ant 任务具有以下属性：

表 1. <mfpadm> 属性列表
属性 描述 必需 缺省值
url Administration Services 的 MobileFirst web 应用程序的基本 URL 是  
secure 是否避免存在安全风险的操作 否 true
user 用于访问 MobileFirst Administration Services 的用户名 是  
password 用户的密码 需要其中任一项  
passwordfile 包含用户密码的文件  
timeout 整个 REST 服务访问超时，以秒为单位 否  
connectTimeout 建立网络连接超时，以秒为单位 否  
socketTimeout 检测网络连接断开超时，以秒为单位 否  
connectionRequestTimeout 从连接请求池获取条目超时，以秒为单位 否  
lockTimeout 获取锁定时超时 否  
url
基本 URL 最好使用 HTTPS 协议。例如，如果使用缺省端口和上下文根，请使用以下 URL。
  • 对于 WebSphere® Application Server：https://server:9443/worklightadmin
  • 对于 Tomcat：https://server:8443/worklightadmin
安全
缺省值为 true。设置 secure="false" 可能会有以下影响：
  • 用户和密码可能以一种不安全的方式（甚至可能通过未加密的 HTTP）传送。
  • 接受服务器的 SSL 证书，即使是自签名证书或为不同于指定服务器主机名的其他主机名创建的证书也是如此。
密码
在 Ant 脚本（通过 password 属性）或独立文件（通过 passwordfile 属性传递）中指定密码。 密码是敏感信息，因此需要保护。 必须防止相同计算机上的其他用户知道此密码。为保护密码，在将密码输入文件之前，必须除去除您之外的其他用户对此文件的读许可权。例如，可以使用以下某个命令：
  • 在 UNIX 上：chmod 600 adminpassword.txt
  • 在 Windows 上：cacls adminpassword.txt /P Administrators:F %USERDOMAIN%\%USERNAME%:F

另外，您可能希望对密码进行模糊处理，以防窥视。 要执行此操作，请使用 mfpadm config password 命令将模糊处理的密码存储在配置文件中。之后，可以将已模糊处理的密码复制并粘贴到 Ant 脚本或密码文件。

mfpadm 调用包含通过内部元素编码的命令。这些命令将按照列出的顺序执行。如果某个命令失败，那么将不会执行剩余命令，并且 mfpadm 调用将失败。

元素

可以在 mfpadm 调用中使用以下元素：
表 2. 可用于 <mfpadm> 的元素
元素 描述 计数
show-info 显示用户和配置信息 0..∞
show-global-config 显示全局配置信息 0..∞
show-diagnostics 显示诊断信息 0..∞
show-versions 显示版本信息 0..∞
unlock 释放通用锁定 0..∞
list-runtimes 列出运行时 0..∞
show-runtime 显示有关运行时的信息 0..∞
delete-runtime 删除运行时 0..∞
show-user-config 显示运行时的用户配置 0..∞
set-user-config 指定运行时的用户配置 0..∞
show-confidential-clients 显示运行时的保密客户机配置 0..∞
set-confidential-clients 指定运行时的保密客户机配置 0..∞
set-confidential-clients-rule 指定运行时的保密客户机配置规则 0..∞
list-adapters 列出适配器 0..∞
deploy-adapter 部署适配器 0..∞
show-adapter 显示有关适配器的信息 0..∞
delete-adapter 删除适配器 0..∞
adapter 针对适配器的其他操作 0..∞
list-apps 列出应用程序 0..∞
deploy-app 部署应用程序 0..∞
show-app 显示有关应用程序的信息 0..∞
delete-app 删除应用程序 0..∞
show-app-version 显示有关应用程序版本的信息 0..∞
delete-app-version 删除应用程序的版本 0..∞
app 针对应用程序的其他操作 0..∞
app-version 针对应用程序版本的其他操作 0..∞
list-devices 列出设备 0..∞
remove-device 除去设备 0..∞
device 针对设备的其他操作 0..∞
list-farm-members 列出服务器场的成员 0..∞
remove-farm-member 除去服务器场成员 0..∞

XML 格式

大部分命令的输出都是 XML 格式，特定命令（如 <set-accessrule>）的输入也是 XML 格式。可以在 product_install_dir/MobileFirstServer/mfpadm-schemas/ 目录中找到这些 XML 格式的 XML 模式。从服务器接收 XML 响应的命令将验证此响应是否符合特定的模式。 通过指定属性 xmlvalidation="none"，可以禁用此检查。

输出字符集

mfpadm Ant 任务的正常输出采用当前语言环境的编码格式进行编码。在 Windows 上，此编码格式即所谓的“ANSI 代码页”。影响如下所示：
  • 此字符集外的字符将在输出时转换为问号。
  • 输出发送至 Windows 命令提示符窗口 (cmd.exe) 时，非 ASCII 字符将无法正确显示，因为此类窗口假定字符采用所谓的“OEM 代码页”编码。
要解决此限制：
  • 在除 Windows 之外的操作系统上，使用其编码为 UTF-8 的语言环境。这是 Red Hat Linux 和 OS X 上的缺省语言环境。 其他多个操作系统采用 en_US.UTF-8 语言环境。
  • 或者，使用属性 output="some file name" 来将 mfpadm 命令的输出重定向到某个文件。
父主题： 通过 Ant 管理 MobileFirst 应用程序