将 MobileFirst Server 安装到应用程序服务器中

您必须为 Apache Tomcat 应用程序服务器配置安全的 JMX 连接。

Server Configuration Tool 和 Ant 任务可以配置缺省安全 JMX 连接，其包括 JMX 远程端口的定义以及认证属性的定义。 它们将修改 tomcat_install_dir/bin/setenv.bat 和 tomcat_install_dir/bin/setenv.sh，从而将这些选项添加到 CATALINA_OPTS：

-Djava.rmi.server.hostname=localhost
-Dcom.sun.management.jmxremote.port=8686
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false

注： 8686 是缺省值。 如果计算机上该端口不可用，可以更改此端口的值。

• 如果使用 tomcat_install_dir/bin/startup.bat 或 tomcat_install_dir/bin/catalina.bat 启动 Apache Tomcat，那么将使用 setenv.bat 文件。
• 如果使用 tomcatInstallDir/bin/startup.sh 或 tomcat_install_dir/bin/catalina.sh 启动 Apache Tomcat，那么将使用 setenv.sh 文件。

如果您通过其他命令启动 Apache Tomcat，那么可能不会使用此文件。 如果安装了 Apache Tomcat Windows Service Installer，那么服务启动程序不会使用 setenv.bat。

要点：缺省情况下，此配置不安全。 要保护配置，您必须手动完成以下过程的步骤 2 和 3。

手动配置 Apache Tomcat：

1. 对于简单配置，请将以下选项添加到 CATALINA_OPTS：

   -Djava.rmi.server.hostname=localhost
   -Dcom.sun.management.jmxremote.port=8686
   -Dcom.sun.management.jmxremote.authenticate=false
   -Dcom.sun.management.jmxremote.ssl=false

2. 要激活认证，请参阅 Apache Tomcat 用户文档 SSL 支持 - BIO 和 NIO 以及 SSL 配置方法。
3. 对于启用 SSL 的 JMX 配置，添加以下选项：

   -Dcom.sun.management.jmxremote=true
   -Dcom.sun.management.jmxremote.port=8686
   -Dcom.sun.management.jmxremote.ssl=true
   -Dcom.sun.management.jmxremote.authenticate=false
   -Djava.rmi.server.hostname=localhost  
   -Djavax.net.ssl.trustStore=<key store location>
   -Djavax.net.ssl.trustStorePassword=<key store password>
   -Djavax.net.ssl.trustStoreType=<key store type>
   -Djavax.net.ssl.keyStore=<key store location>
   -Djavax.net.ssl.keyStorePassword=<key store password>
   -Djavax.net.ssl.keyStoreType=<key store type>

   注：可以更改端口 8686。

4. 如果 Tomcat 实例在防火墙背后运行，那么必须配置 JMX 远程生命周期侦听器。 请参阅 JMX 远程生命周期侦听器的 Apache Tomcat 文档。

   还必须将以下环境属性添加到 server.xml 文件中的管理服务应用程序的 Context 节，如以下示例所示：

   <Context docBase="mfpadmin" path="/mfpadmin ">
       <Environment name="mfp.admin.rmi.registryPort" value="registryPort" type="java.lang.String" override="false"/>
       <Environment name="mfp.admin.rmi.serverPort" value="serverPort" type="java.lang.String" override="false"/>
   </Context>

   在上一个示例中：
   • registryPort 必须具有与 JMX 远程生命周期侦听器的 rmiRegistryPortPlatform 属性相同的值。
   • serverPort 必须具有与 JMX 远程生命周期侦听器的 rmiServerPortPlatform 属性相同的值。
5. 如果您通过 Apache Tomcat Windows Service Installer（而不是向 CATALINA_OPTS 添加选项）安装了 Apache Tomcat，那么请运行 tomcat_install_dir/bin/Tomcat7w.exe，并在“属性”窗口的 Java 选项卡中添加选项。

MobileFirst Server 需要配置安全的 JMX 连接。

• Server Configuration Tool 和 Ant 任务可以配置安全的缺省 JMX 连接，该连接包括生成有效期 365 天的自签名 SSL 证书。 此配置不适用于生产用途。
• 要为生产用途配置安全的 JMX 连接，请遵循配置到 Liberty Profile 的安全 JMX 连接中所述的指示信息。
• 其余的接口可用于 WebSphere Application Server、Liberty Core 以及 Liberty 的其他版本，但是可以将 Liberty 服务器与一部分可用功能部件打包在一起。 要验证其余接口功能部件在您的 Liberty 安装中是否可用，请输入以下命令：

                      
  liberty_install_dir/bin/productInfo featureInfo

  注：验证此命令的输出是否包含 restConnector-1.0。

MobileFirst Server 需要配置安全的 JMX 连接。

• MobileFirst Server 需要访问 SOAP 端口或 RMI 端口以执行 JMX 操作。 缺省情况下，SOAP 端口在 WebSphere Application Server 上处于活动状态。 缺省情况下，MobileFirst Server 使用 SOAP 端口。 如果同时取消激活 SOAP 和 RMI 端口，那么 MobileFirst Server 将无法运行。
• RMI 仅受 WebSphere Application Server Network Deployment 支持。 独立概要文件或 WebSphere Application Server 服务器场不支持 RMI。
• 必须激活 Administrative 和 Application Security。

1. 启动 Server Configuration Tool。
   • 在 Linux，通过应用程序快捷方式应用程序 → IBM MobileFirst Platform Server → Server Configuration Tool。
   • 在 Windows 上，单击开始 → 程序 → IBM MobileFirst Platform Server → Server Configuration Tool。
   • 在 macOS 上，打开 shell 控制台。 转至 mfp_server_install_dir/shortcuts，然后输入 ./configuration-tool.sh。
   • mfp_server_install_dir 是 MobileFirst Server 的安装目录。
2. 选择文件 → 新建配置以创建 MobileFirst Server 配置。
   • 在配置详细信息面板中，输入管理服务和运行时组件的上下文根。 您可能要输入环境标识。 高级用例中将使用环境标识，例如，当在同一应用程序服务器上或同一 WebSphere Application Server 单元上安装 MobileFirst Server 时。
   • 在控制台设置面板中，选择是否安装 MobileFirst Operations Console。 如果未安装控制台，需使用命令行工具（mfpdev 或 mfpadm）或 REST API 与 MobileFirst Server 管理服务交互。
   • 在数据库选择面板中，选择您计划使用的数据库管理系统。 所有组件均使用相同的数据库类型和相同的数据库实例。 有关数据库窗格的更多信息，请参阅使用 Server Configuration Tool 创建数据库表。
   • 在应用程序服务器选择面板中，选择要部署 MobileFirst Server 的应用程序服务器的类型。
3. 在应用程序服务器设置面板中，选择应用程序服务器并完成以下步骤：
   • 要在 WebSphere Application Server Liberty 上进行安装：
     • 输入 Liberty 的安装目录以及要安装 MobileFirst Server 的服务器的名称。
     • 您可以创建登录到控制台的缺省用户。 将在 Liberty Basic 注册表中创建该用户。 对于生产安装，您可能要清除创建缺省用户选项，并在安装后配置用户访问权。 有关更多信息，请参阅配置 MobileFirst Server 管理的用户认证。
     • 设置部署类型：独立部署（缺省值）、服务器场部署或 Liberty 集合体部署。
     如果选择 Liberty 集合体部署选项，请执行以下步骤：
     • 指定 Liberty 集合体服务器：
       • 安装管理服务、MobileFirst Operations Console 和实时更新服务的集群。 服务器必须是 Liberty 集合体控制器。
       • 安装运行时的集群。 服务器必须是 Liberty 集合体成员。
       • 安装推送服务的集群。 服务器必须是 Liberty 集合体成员。
     • 输入成员的服务器标识。 对于集合体中的每个成员，该标识必须不同。
     • 输入集合体成员的集群名称。
     • 输入控制器主机名和 HTTPS 端口号。 这些值必须与 Liberty 集合体控制器的 server.xml 文件的 variable 元素中定义的值相同。
     • 输入控制器管理员用户名和密码。
   • 要在 WebSphere Application Server 或 WebSphere Application Server Network Deployment 上进行安装：
     • 输入 WebSphere Application Server 的安装目录。
     • 选择要安装 MobileFirst Server 的 WebSphere Application Server 概要文件。 如果要在 WebSphere Application Server Network Deployment 上进行安装，请选择 Deployment Manager 的概要文件。 在 Deployment Manager 概要文件上，可选择某一范围（服务器或集群）。 如选择集群，那么必须指定：
       • 安装运行时的集群。
       • 安装管理服务、MobileFirst Operations Console 和实时更新服务的集群。
       • 安装推送服务的集群。
     • 输入管理员登录标识和密码。 管理员用户必须具有管理员角色。
     • 如果选择将 WebSphere 管理员声明为 MobileFirst Operations Console 中的管理员用户选项，那么用于安装 MobileFirst Server 的用户将映射到控制台的管理安全角色，并可以使用管理员权限登录到控制台。 该用户还将映射到实时更新服务的安全角色。 用户名和密码设置为管理服务的 JNDI 属性（mfp.config.service.user 和 mfp.config.service.password）。
     • 如果未选择将 WebSphere 管理员声明为 MobileFirst Operations Console 中的管理员用户选项，那么必须完成以下任务才能使用 MobileFirst Server：
       • 通过以下方式启用管理服务与实时更新服务间的通信：
         • 将用户映射到实时更新服务的安全角色 configadmin。
         • 在管理服务的 JNDI 属性（mfp.config.service.user 和 mfp.config.service.password）中添加该用户的登录标识和密码。
         • 将一个或多个用户映射到管理服务和 MobileFirst Operations Console 的安全角色。 请参阅为 MobileFirst Server 管理配置用户认证。
   • 要在 Apache Tomcat 上进行安装：
     • 输入 Apache Tomcat 的安装目录。
     • 输入用于 JMX 与 RMI 通信的端口。 缺省情况下，该值为 8686。 Server Configuration Tool 修改 tomcat_install_dir/bin/setenv.bat 或 tomcat_install_dir/bin/setenv.sh 文件来打开此端口。 如果要手动打开此端口，或使用在 setenv.bat 或 setenv.sh 中打开此端口的一些代码，请不要使用此工具。 请改为使用 Ant 任务进行安装。 提供了一个手动打开 RMI 端口的选项，以使用 Ant 任务进行安装。
     • 创建登录到控制台的缺省用户。 还将在 tomcat-users.xml 配置文件中创建该用户。 对于生产安装，您可能要清除创建缺省用户选项，并在安装后配置用户访问权。 有关更多信息，请参阅配置 MobileFirst Server 管理的用户认证。
4. 在推送服务设置面板中，如果要在应用程序服务器中安装推送服务，请选中安装推送服务选项。 上下文根为 imfpush。 要启用推送服务与管理服务间的通信，需定义以下参数：
   • 输入推送服务的 URL 和运行时的 URL。 如果在 Liberty、Apache Tomcat 或独立 WebSphere Application Server 上进行安装，可自动计算此 URL。 它使用本地服务器上的组件（运行时或推送服务）的 URL。 如果在 WebSphere Application Server Network Deployment 上进行安装，或通过 Web 代理或负载均衡器进行通信，那么必须手动输入 URL。
   • 输入用于服务之间 OAuth 通信的保密客户机标识和密码。 否则，该工具会生成缺省值和随机密码。
5. 在分析设置面板中，如果已安装 MobileFirst Analytics，请选中连接到分析服务器。 输入以下连接设置：
   • 分析控制台的 URL。
   • 分析服务器（分析数据服务）的 URL。
   • 允许向分析服务器发布数据的用户登录标识和密码。
   该工具可配置运行时和推送服务以向分析服务器发送数据。
6. 单击部署以继续进行安装。

管理服务打包为 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。 管理服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-service.war。 您可以根据需要定义上下文根。 但是，它通常为 /mfpadmin。

必需的 JNDI 属性

定义 JNDI 属性时，JNDI 名称必须使用管理服务的上下文根作为前缀。 以下示例说明声明 mfp.admin.push.url 的情况，此时使用 /mfpadmin 作为上下文根来安装管理服务：

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

如果已安装推送服务，那么必须配置以下 JNDI 属性：

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

用于与配置服务通信的 JNDI 属性如下：

• mfp.config.service.user
• mfp.config.service.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst Server 管理服务的 JNDI 属性列表。

数据源

管理服务的数据源的 JNDI 名称必须定义为 jndiName=the-contextRoot/jdbc/mfpAdminDS。 以下示例说明使用上下文根 /mfpadmin 安装管理服务，且该服务使用关系数据库的情况：

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

在应用程序的 application-bnd 元素中声明以下角色：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

实时更新服务打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server Liberty 上进行手动安装，以了解对所有服务通用的配置详细信息。

实时更新服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-live-update.war 中。 必须按以下方式定义实时更新服务的上下文根：/the-adminContextRootconfig。 例如，如果管理服务的上下文根为 /mfpadmin，那么实时更新服务的上下文根必须为 /mfpadminconfig。

数据源

实时更新服务的数据源的 JNDI 名称必须定义为 the-contextRoot/jdbc/ConfigDS。 以下示例说明使用上下文根 /mfpadminconfig 安装实时更新服务，且该服务使用关系数据库的情况：

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

在应用程序的 application-bnd 元素中声明 configadmin 角色。 必须将至少一个用户映射至此角色。 必须为管理服务的以下 JNDI 属性提供用户及其密码：

• mfp.config.service.user
• mfp.config.service.password

控制台打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server Liberty 上进行手动安装，以了解对所有服务通用的配置详细信息。

控制台 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war。 您可以根据需要定义上下文根。 但通常上下文根为 /mfpconsole。

必需的 JNDI 属性

定义 JNDI 属性时，必须使用控制台的上下文根作为 JNDI 名称的前缀。 以下示例显示了声明 mfp.admin.endpoint 而安装的控制台使用 /mfpconsole 作为上下文根的情况。

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

mfp.admin.endpoint 属性的典型值是 *://*:*/the-adminContextRoot。
有关 JNDI 属性的更多信息，请参阅 MobileFirst Operations Console 的 JNDI 属性。

安全角色

在应用程序的 application-bnd 元素中声明以下角色：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

运行时打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server Liberty 上进行手动安装，以了解对所有服务通用的配置详细信息。

运行时 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-server.war 中。 您可以根据需要定义上下文根。 但是，缺省情况下为 /mfp。

必需的 JNDI 属性

定义 JNDI 属性时，JNDI 名称必须使用运行时的上下文根作为前缀。 以下示例说明声明 mfp.analytics.url 的情况，此时使用 /mobilefirst 作为上下文根来安装运行时：

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

必须定义 mobilefirst/mfp.authorization.server 属性。 例如：

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

如果已安装 MobileFirst Analytics，那么需要定义以下 JNDI 属性：

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst 运行时的 JNDI 属性列表。

数据源

必须将运行时的数据源的 JNDI 名称定义为 jndiName=the-contextRoot/jdbc/mfpDS。 以下示例说明使用上下文根 /mobilefirst 安装运行时，且运行时使用关系数据库的情况：

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

推送服务打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server Liberty 上进行手动安装，以了解对所有服务通用的配置详细信息。

推送服务 WAR 文件位于 mfp_install_dir/PushService/mfp-push-service.war。 您必须将上下文根定义为 /imfpush。 否则，由于在 SDK 中对上下文根进行硬编码，因此客户机设备无法连接到此上下文根。

必需的 JNDI 属性

定义 JNDI 属性时，必须使用推送服务的上下文根作为 JNDI 名称的前缀。 以下示例显示了声明 mfp.push.analytics.user 而安装的推送服务使用 /imfpush 作为上下文根的情况。

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - 该值必须为 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin。
• mfp.push.db.type - 对于关系数据库，该值必须是 DB。

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - 该值必须为 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin。

工件组件打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server Liberty 上进行手动安装，以了解对所有服务通用的配置详细信息。

该组件的 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war。 您必须将上下文根定义为 /mfp-dev-artifacts。

管理服务打包为一个 WAR 应用程序，供您部署到 Liberty 集合体控制器。 您需要在 Liberty 集合体控制器的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server Liberty 集合体上进行手动安装，以了解对所有服务通用的配置详细信息。

管理服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-service-collective.war 中。 您可以根据需要定义上下文根。 但是，它通常为 /mfpadmin。

必需的 JNDI 属性

定义 JNDI 属性时，JNDI 名称必须使用管理服务的上下文根作为前缀。 以下示例说明声明 mfp.admin.push.url 的情况，此时使用 /mfpadmin 作为上下文根来安装管理服务：

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

如果已安装推送服务，那么必须配置以下 JNDI 属性：

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

用于与配置服务通信的 JNDI 属性如下：

• mfp.config.service.user
• mfp.config.service.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst Server 管理服务的 JNDI 属性列表。

数据源

管理服务的数据源的 JNDI 名称必须定义为 jndiName=the-contextRoot/jdbc/mfpAdminDS。 以下示例说明使用上下文根 /mfpadmin 安装管理服务，且该服务使用关系数据库的情况：

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

安全角色

在应用程序的 application-bnd 元素中声明以下角色：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

实时更新服务打包为一个 WAR 应用程序，供您部署到 Liberty 集合体控制器。 您需要在 Liberty 集合体控制器的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server Liberty 集合体上进行手动安装，以了解对所有服务通用的配置详细信息。

实时更新服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-live-update.war 中。 必须按以下方式定义实时更新服务的上下文根：/the-adminContextRootconfig。 例如，如果管理服务的上下文根为 /mfpadmin，那么实时更新服务的上下文根必须为 /mfpadminconfig。

数据源

实时更新服务的数据源的 JNDI 名称必须定义为 the-contextRoot/jdbc/ConfigDS。 以下示例说明使用上下文根 /mfpadminconfig 安装实时更新服务，且该服务使用关系数据库的情况：

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

安全角色

在应用程序的 application-bnd 元素中声明 configadmin 角色。 必须将至少一个用户映射至此角色。 必须为管理服务的以下 JNDI 属性提供用户及其密码：

• mfp.config.service.user
• mfp.config.service.password

控制台打包为一个 WAR 应用程序，供您部署到 Liberty 集合体控制器。 您需要在 Liberty 集合体控制器的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server Liberty 上进行手动安装，以了解对所有服务通用的配置详细信息。

控制台 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war。 您可以根据需要定义上下文根。 但通常上下文根为 /mfpconsole。

必需的 JNDI 属性

定义 JNDI 属性时，必须使用控制台的上下文根作为 JNDI 名称的前缀。 以下示例显示了声明 mfp.admin.endpoint 而安装的控制台使用 /mfpconsole 作为上下文根的情况。

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

mfp.admin.endpoint 属性的典型值是 *://*:*/the-adminContextRoot。
有关 JNDI 属性的更多信息，请参阅 MobileFirst Operations Console 的 JNDI 属性。

安全角色

在应用程序的 application-bnd 元素中声明以下角色：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

运行时打包为一个 WAR 应用程序，供您部署到 Liberty 集合体集群成员。 您需要在每个 Liberty 集合体集群成员的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server Liberty 集合体上进行手动安装，以了解对所有服务通用的配置详细信息。

运行时 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-server.war 中。 您可以根据需要定义上下文根。 但是，缺省情况下为 /mfp。

必需的 JNDI 属性

定义 JNDI 属性时，JNDI 名称必须使用运行时的上下文根作为前缀。 以下示例说明声明 mfp.analytics.url 的情况，此时使用 /mobilefirst 作为上下文根来安装运行时：

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

必须定义 mobilefirst/mfp.authorization.server 属性。 例如：

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

如果已安装 MobileFirst Analytics，那么需要定义以下 JNDI 属性：

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst 运行时的 JNDI 属性列表。

数据源

必须将运行时的数据源的 JNDI 名称定义为 jndiName=the-contextRoot/jdbc/mfpDS。 以下示例说明使用上下文根 /mobilefirst 安装运行时，且运行时使用关系数据库的情况：

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

推送服务打包为一个 WAR 应用程序，供您部署到 Liberty 集合体集群成员或 Liberty 服务器。 如果在 Liberty 服务器中安装推送服务，请参阅 WebSphere Application Server Liberty 上的手动安装下面的MobileFirst Server推送服务配置详细信息。

当 MobileFirst Server 推送服务安装在 Liberty 集合体中时，可以将其安装在与运行时相同的集群中，也可以将其安装在其他集群中。

您需要在每个 Liberty 集合体集群成员的 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server Liberty 集合体上进行手动安装，以了解对所有服务通用的配置详细信息。

推送服务 WAR 文件位于 mfp_install_dir/PushService/mfp-push-service.war。 您必须将上下文根定义为 /imfpush。 否则，由于在 SDK 中对上下文根进行硬编码，因此客户机设备无法连接到此上下文根。

必需的 JNDI 属性

定义 JNDI 属性时，必须使用推送服务的上下文根作为 JNDI 名称的前缀。 以下示例显示了声明 mfp.push.analytics.user 而安装的推送服务使用 /imfpush 作为上下文根的情况。

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - 该值必须为 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin。
• mfp.push.db.type - 对于关系数据库，该值必须是 DB。

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - 该值必须为 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin。

工件组件打包为一个 WAR 应用程序，供您部署到 Liberty 集合体控制器。 您需要在 Liberty 集合体控制器的 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server Liberty 上进行手动安装，以了解对所有服务通用的配置详细信息。

该组件的 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war。 您必须将上下文根定义为 /mfp-dev-artifacts。

管理服务打包为 WAR 应用程序，供您部署到应用程序服务器。 您需要在应用程序服务器的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 Apache Tomcat 上进行手动安装，以了解对所有服务通用的配置详细信息。

管理服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-service.war。 您可以根据需要定义上下文根。 但是，它通常为 /mfpadmin。

必需的 JNDI 属性

应用程序上下文中的 Environment 元素中定义了 JNDI 属性。 例如：

<Environment name="mfp.admin.push.url" value="http://localhost:8080/imfpush" type="java.lang.String" override="false"/>

要启用 JMX 与运行时通信，请定义以下 JNDI 属性：

• mfp.topology.platform
• mfp.topology.clustermode

如果已安装推送服务，那么必须配置以下 JNDI 属性：

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

用于与配置服务通信的 JNDI 属性如下：

• mfp.config.service.user
• mfp.config.service.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst Server 管理服务的 JNDI 属性列表。

数据源

将数据源 (jdbc/mfpAdminDS) 声明为 **Context** 元素中的一项资源。 例如：

<Resource name="jdbc/mfpAdminDS" type="javax.sql.DataSource" .../>

安全角色

可供管理服务应用程序使用的安全角色有：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

实时更新服务打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 Apache Tomcat 上进行手动安装，以了解对所有服务通用的配置详细信息。

实时更新服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-live-update.war 中。 必须按以下方式定义实时更新服务的上下文根：/the-adminContextRoot/config。 例如，如果管理服务的上下文根为 /mfpadmin，那么实时更新服务的上下文根必须为 /mfpadminconfig。

数据源

实时更新服务的数据源的 JNDI 名称必须定义为 jdbc/ConfigDS。 在 Context 元素中将其声明为资源。

安全角色

实时更新服务应用程序可用的安全角色为 configadmin。

必须将至少一个用户映射至此角色。 必须为管理服务的以下 JNDI 属性提供用户及其密码：

• mfp.config.service.user
• mfp.config.service.password

控制台打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在应用程序服务器的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 Apache Tomcat 上进行手动安装，以了解对所有服务通用的配置详细信息。

控制台 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war。 您可以根据需要定义上下文根。 但通常上下文根为 /mfpconsole。

必需的 JNDI 属性

您需要定义 mfp.admin.endpoint 属性。 该属性的典型值是 *://*:*/the-adminContextRoot。

有关 JNDI 属性的更多信息，请参阅 MobileFirst Operations Console 的 JNDI 属性。

安全角色

可用于此应用程序的安全角色为：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

运行时打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 Apache Tomcat 上进行手动安装，以了解对所有服务通用的配置详细信息。

运行时 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-server.war 中。 您可以根据需要定义上下文根。 但是，缺省情况下为 /mfp。

必需的 JNDI 属性

您必须定义 mfp.authorization.server 属性。 例如：

<Environment name="mfp.authorization.server" value="embedded" type="java.lang.String" override="false"/>

要启用 JMX 与管理服务通信，请定义以下 JNDI 属性：

• mfp.topology.platform
• mfp.topology.clustermode

如果已安装 MobileFirst Analytics，那么需要定义以下 JNDI 属性：

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst 运行时的 JNDI 属性列表。

数据源

运行时的数据源的 JNDI 名称必须定义为 jdbc/mfpDS。 在 Context 元素中将其声明为资源。

推送服务打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要对此应用程序进行一些具体配置。 在继续操作之前，请查看在 Apache Tomcat 上进行手动安装，以了解对所有服务通用的配置详细信息。

推送服务 WAR 文件位于 mfp_install_dir/PushService/mfp-push-service.war。 您必须将上下文根定义为 /imfpush。 否则，由于在 SDK 中对上下文根进行硬编码，因此客户机设备无法连接到此上下文根。

必需的 JNDI 属性

您需要定义以下属性：

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - 该值必须为 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin。
• mfp.push.db.type - 对于关系数据库，该值必须是 DB。

如果已配置 MobileFirst Analytics，请定义以下 JNDI 属性：

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - 该值必须为 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin。

工件组件打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在应用程序服务器的 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 Apache Tomcat 上进行手动安装，以了解对所有服务通用的配置详细信息。

该组件的 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war。 您必须将上下文根定义为 /mfp-dev-artifacts。

管理服务打包为 WAR 应用程序，供您部署到应用程序服务器。 您需要在应用程序服务器的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server 和 WebSphere Application Server Network Deployment 上手动安装，以了解对所有服务通用的配置详细信息。

管理服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-service.war。 您可以根据需要定义上下文根。 但是，它通常为 /mfpadmin。

必需的 JNDI 属性

您可以使用 WebSphere Application Server 管理控制台设置 JNDI 属性。 转至应用程序 → 应用程序类型 → WebSphere 企业应用程序 → application_name → Web 模块的环境条目，并设置这些条目。

要启用 JMX 与运行时通信，请定义以下 JNDI 属性：

• mfp.admin.jmx.dmgr.host
• mfp.admin.jmx.dmgr.port - Deployment Manager 上的 SOAP 端口。
• mfp.topology.platform - 将该值设置为 WAS。
• mfp.topology.clustermode - 将该值设置为 Cluster。
• mfp.admin.jmx.connector - 将该值设置为 SOAP。

• mfp.topology.platform - 将该值设置为 WAS。
• mfp.topology.clustermode - 将该值设置为 Standalone。
• mfp.admin.jmx.connector - 将该值设置为 SOAP。

如果已安装推送服务，那么必须配置以下 JNDI 属性：

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

用于与配置服务通信的 JNDI 属性如下：

• mfp.config.service.user
• mfp.config.service.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst Server 管理服务的 JNDI 属性列表。

数据源

为管理服务创建数据源，并将其映射到 jdbc/mfpAdminDS。

启动顺序

管理服务应用程序必须在启动运行时应用程序之前启动。 您可以在启动行为部分设置此顺序。 例如，针对管理服务将 Startup Order 设置为 1，针对运行时设置为 2。

安全角色

可供管理服务应用程序使用的安全角色有：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

实时更新服务打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server 和 WebSphere Application Server Network Deployment 上手动安装，以了解对所有服务通用的配置详细信息。

实时更新服务 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-live-update.war 中。 必须按以下方式定义实时更新服务的上下文根：/the-adminContextRoot/config。 例如，如果管理服务的上下文根为 /mfpadmin，那么实时更新服务的上下文根必须为 /mfpadminconfig。

数据源

为实时更新服务创建数据源，并将其映射到 jdbc/ConfigDS。

安全角色

为此应用程序定义了 configadmin 角色。

必须将至少一个用户映射至此角色。 必须为管理服务的以下 JNDI 属性提供用户及其密码：

• mfp.config.service.user
• mfp.config.service.password

控制台打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在应用程序服务器的 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server 和 WebSphere Application Server Network Deployment 上手动安装，以了解对所有服务通用的配置详细信息。

控制台 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war。 您可以根据需要定义上下文根。 但通常上下文根为 /mfpconsole。

必需的 JNDI 属性

您可以使用 WebSphere Application Server 管理控制台设置 JNDI 属性。 转至应用程序 → 应用程序类型 → WebSphere 企业应用程序 → application_name → Web 模块的环境条目，并设置这些条目。

您需要定义 mfp.admin.endpoint 属性。 该属性的典型值是 *://*:*/the-adminContextRoot。

有关 JNDI 属性的更多信息，请参阅 MobileFirst Operations Console 的 JNDI 属性。

安全角色

可用于此应用程序的安全角色为：

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

运行时打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在 server.xml 文件中对此应用程序进行一些具体配置。

在继续操作之前，请查看在 WebSphere Application Server 和 WebSphere Application Server Network Deployment 上手动安装，以了解对所有服务通用的配置详细信息。

运行时 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-server.war 中。 您可以根据需要定义上下文根。 但是，缺省情况下为 /mfp。

必需的 JNDI 属性

您可以使用 WebSphere Application Server 管理控制台设置 JNDI 属性。 转至应用程序 → 应用程序类型 → WebSphere 企业应用程序 → application_name → Web 模块的环境条目，并设置这些条目。

您必须定义 mfp.authorization.server 属性，其值为嵌入式。
同时，请定义以下 JNDI 属性以启用 JMX 与管理服务通信：

• mfp.admin.jmx.dmgr.host - Deployment Manager 的主机名。
• mfp.admin.jmx.dmgr.port - Deployment Manager 的 SOAP 端口。
• mfp.topology.platform - 将该值设置为 WAS。
• mfp.topology.clustermode - 将该值设置为 Cluster。
• mfp.admin.jmx.connector - 将该值设置为 SOAP。

• mfp.topology.platform - 将该值设置为 WAS。
• mfp.topology.clustermode - 将该值设置为 Standalone。
• mfp.admin.jmx.connector - 将该值设置为 SOAP。

如果已安装 MobileFirst Analytics，那么需要定义以下 JNDI 属性：

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

有关 JNDI 属性的更多信息，请参阅 MobileFirst 运行时的 JNDI 属性列表。

启动顺序

运行时应用程序必须在管理服务应用程序启动之后才能启动。 您可以在启动行为部分设置此顺序。 例如，针对管理服务将 Startup Order 设置为 1，针对运行时设置为 2。

数据源

为运行时创建数据源，并将其映射到 jdbc/mfpDS。

推送服务打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server 和 WebSphere Application Server Network Deployment 上手动安装，以了解对所有服务通用的配置详细信息。

推送服务 WAR 文件位于 mfp_install_dir/PushService/mfp-push-service.war。 您必须将上下文根定义为 /imfpush。 否则，由于在 SDK 中对上下文根进行硬编码，因此客户机设备无法连接到此上下文根。

必需的 JNDI 属性

您可以使用 WebSphere Application Server 管理控制台设置 JNDI 属性。 转至应用程序 > 应用程序类型 → WebSphere 企业应用程序 → application_name → Web 模块的环境条目，并设置这些条目。

您需要定义以下属性：

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - 该值必须为 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin。
• mfp.push.db.type - 对于关系数据库，该值必须是 DB。

如果已配置 MobileFirst Analytics，请定义以下 JNDI 属性：

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - 该值必须为 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin。

有关 JNDI 属性的更多信息，请参阅 MobileFirst Server 推送服务的 JNDI 属性列表。

数据源

为推送服务创建数据源，并将其映射到 jdbc/imfPushDS。

工件组件打包为一个 WAR 应用程序，供您部署到应用程序服务器。 您需要在应用程序服务器的 server.xml 文件中对此应用程序进行一些具体配置。 在继续操作之前，请查看在 WebSphere Application Server 和 WebSphere Application Server Network Deployment 上手动安装，以了解对所有服务通用的配置详细信息。

该组件的 WAR 文件位于 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war。 您必须将上下文根定义为 /mfp-dev-artifacts。

MobileFirst Server 需要配置安全的 JMX 连接。

1. 准备必须配置为服务器场成员的应用程序服务器。
   • 选择要用于配置服务器场成员的应用程序服务器的类型。 Mobile Foundation 支持服务器场中的以下应用程序服务器：
     • WebSphere Application Server Full Profile
       注：在场拓扑中，不能使用 RMI JMX 接口。 在此拓扑中，Mobile Foundation 仅支持 SOAP 接口。
     • WebSphere Application Server Liberty Profile
     • Apache Tomcat
     要了解哪些版本的应用程序服务器受支持，请参阅系统需求。

     要点： Mobile Foundation 只支持同类服务器场。 在连接相同类型的应用程序服务器时，服务器场为同类。 尝试关联不同类型的应用程序服务器可能会导致运行时出现不可预测的行为。 例如，混用 Apache Tomcat 服务器和 WebSphere Application Server Full Profile 服务器的场是无效的配置。

   • 设置与希望包含在场中的成员数一样多的独立服务器。
     • 其中的每个独立服务器都必须与同一个数据库通信。 您必须确保其中的任意服务器使用的任何端口均没有被同一主机上配置的另一个服务器使用。 此约束适用于 HTTP、HTTPS、REST、SOAP 和 RMI 协议所使用的端口。
     • 其中每台服务器必须部署 MobileFirst Server 管理服务、MobileFirst Server 实时更新服务以及一个或多个 MobileFirst 运行时。
     • 有关设置服务器的更多信息，请参阅MobileFirst Server 管理服务、MobileFirst Server 实时更新服务和 MobileFirst 运行时的约束。
   • 在各自信任库的所有服务器之间交换签署者证书。
     
     因为必须启用安全性，所以此步骤是使用 WebSphere Application Server Full Profile 或 Liberty 的场所必需的。 此外，对于 Liberty 场，必须在每台服务器上复制相同的 LTPA 配置以确保单点登录功能。 要执行此配置，请遵循手动配置服务器场 的步骤 6 中的准则。
2. 针对场的每台服务器运行 Server Configuration Tool。 所有服务器必须共享相同数据库。 确保在应用程序服务器设置面板中选择部署类型：服务器场部署。 有关该工具的更多信息，请参阅运行 Server Configuration Tool。

MobileFirst Server 需要配置安全的 JMX 连接。

1. 准备必须配置为服务器场成员的应用程序服务器。
   • 选择要用于配置服务器场成员的应用程序服务器的类型。 Mobile Foundation 支持服务器场中的以下应用程序服务器：
     • WebSphere Application Server Full Profile。 注：在场拓扑中，不能使用 RMI JMX 接口。 在此拓扑中，Mobile Foundation 仅支持 SOAP 接口。
     • WebSphere Application Server Liberty Profile
     • Apache Tomcat
     要了解哪些版本的应用程序服务器受支持，请参阅系统需求。

     要点： Mobile Foundation 只支持同类服务器场。 在连接相同类型的应用程序服务器时，服务器场为同类。 尝试关联不同类型的应用程序服务器可能会导致运行时出现不可预测的行为。 例如，混用 Apache Tomcat 服务器和 WebSphere Application Server Full Profile 服务器的场是无效的配置。

   • 设置与希望包含在场中的成员数一样多的独立服务器。
     
     其中的每个独立服务器都必须与同一个数据库通信。 您必须确保其中的任意服务器使用的任何端口均没有被同一主机上配置的另一个服务器使用。 此约束适用于 HTTP、HTTPS、REST、SOAP 和 RMI 协议所使用的端口。
     
     其中每台服务器必须部署 MobileFirst Server 管理服务、MobileFirst Server 实时更新服务以及一个或多个 MobileFirst 运行时。
     
     有关设置服务器的更多信息，请参阅MobileFirst Server 管理服务、MobileFirst Server 实时更新服务和 MobileFirst 运行时的约束。
   • 在各自信任库的所有服务器之间交换签署者证书。
     
     因为必须启用安全性，所以此步骤是使用 WebSphere Application Server Full Profile 或 Liberty 的场所必需的。 此外，对于 Liberty 场，必须在每台服务器上复制相同的 LTPA 配置以确保单点登录功能。 要执行此配置，请遵循手动配置服务器场 的步骤 6 中的准则。
2. 针对管理服务、实时更新服务和运行时配置数据库。
   • 决定想要使用的数据库，并选择 Ant 文件以在 mfp_install_dir/MobileFirstServer/configuration-samples 目录中创建和配置数据库：
     • 对于 DB2，使用 create-database-db2.xml。
     • 对于 MySQL，使用 create-database-mysql.xml。
     • 对于 Oracle，使用 create-database-oracle.xml。

     注：请勿在场拓扑中使用 Derby 数据库，因为 Derby 数据库一次只允许一个连接。

   • 编辑 Ant 文件并输入数据库的所有必需属性。
     
     要启用 MobileFirst Server 组件使用的数据库的配置，请设置以下属性的值：
     • 将 mfp.process.admin 设置为 true。 针对管理服务和实时更新服务配置数据库。
     • 将 mfp.process.runtime 设置为 true。 针对运行时配置数据库。
   • 从 mfp_install_dir/MobileFirstServer/configuration-samples 目录运行以下命令，其中必须将 create-database-ant-file.xml 替换为您选择的实际 Ant 文件名：mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml admdatabases 和 mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml rtmdatabases。
     
     因为在场中的应用程序服务器之间共享 MobileFirst Server 数据库，因此必须仅运行这两个命令一次，而无论场中服务器的数量。
   • （可选）如果想要安装其他运行时，那么必须使用其他数据库名称或模式配置其他数据库。 要执行此操作，请编辑 Ant 文件，修改属性，然后运行以下命令一次，而无论场中服务器的数量：mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml rtmdatabases。
3. 在服务器上部署管理服务、实时更新服务和运行时，并将这些服务器配置为服务器场的成员。
   • 在 mfp\_install\_dir/MobileFirstServer/configuration-samples 目录中选择与您的应用程序服务器和数据库相对应的 Ant 文件，以在服务器上部署管理服务、实时更新服务和运行时。
     
     例如，选择 configure-liberty-db2.xml 文件以在包含 DB2 数据库的 Liberty 服务器上部署。 生成此文件的副本，数量与场中想要的成员数量相同。
     
     注：在配置后保留这些文件，因为可复用于升级已部署的 MobileFirst Server 组件，或者复用于从场的每个成员中卸载这些组件。
   • 编辑每个 Ant 文件副本，输入在步骤 2 中使用的数据库的相同属性，并输入应用程序服务器的其他必需属性。
     
     要将服务器配置为服务器场成员，请设置以下属性的值：
     • 将 mfp.farm.configure 设置为 true。
     • mfp.farm.server.id：为此服务器场成员定义的标识。 确保场中的每个服务器都具有自己的唯一标识。 如果场中的两个服务器具有相同标识，那么该场可能会以不可预测的方式运行。
     • mfp.config.service.user：用于访问实时更新服务的用户名。 对于场的所有成员，该用户名必须相同。
     • mfp.config.service.password：用于访问实时更新服务的密码。 对于场的所有成员，该密码必须相同。
     要支持在服务器上部署 MobileFirst Server 组件的 WAR 文件，请设置以下属性的值：
     • 将 mfp.process.admin 设置为 true。 部署管理服务和实时更新服务的 WAR 文件。
     • 将 mfp.process.runtime 设置为 true。 部署运行时的 WAR 文件。
     
     注：如果计划在场的服务器上安装多个运行时，那么指定属性 id 并设置对于 installmobilefirstruntime、updatemobilefirstruntime 和 uninstallmobilefirstruntime Ant 任务上的每个运行时必须唯一的值。
     例如，

     <target name="rtminstall">
         <installmobilefirstruntime execute="true" contextroot="/runtime1" id="rtm1">

   • 对于每个服务器，运行以下命令，其中必须将 configure-appserver-database-ant-file.xml 替换为您选择的实际 Ant 文件名：mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file.xml adminstall 和 mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file.xml rtminstall。
     
     这些命令运行 installmobilefirstadmin 和 installmobilefirstruntime Ant 任务。 有关这些任务的更多信息，请参阅用于安装 MobileFirst Operations Console、MobileFirst Server 工件、MobileFirst Server 管理和实时更新服务的 Ant 任务以及用于安装 MobileFirst 运行时环境的 Ant 任务。
   • （可选）如果想要安装其他运行时，请执行以下步骤：
     • 生成在步骤 3.b 中配置的 Ant 文件的副本。
     • 编辑副本，设置不同的上下文根，并针对 installmobilefirstruntime、updatemobilefirstruntime 和 uninstallmobilefirstruntime 的 id 属性设置与其他运行时配置不同的值。
     • 在场的每台服务器上运行以下命令，其中 configure-appserver-database-ant-file2.xml 必须替换为编辑的 Ant 文件的实际名称：mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file2.xml rtminstall。
     • 针对场的每台服务器重复此步骤。
4. 重新启动所有服务器。

1. 选择要用于配置服务器场成员的应用程序服务器的类型。 Mobile Foundation 支持服务器场中的以下应用程序服务器：
   • WebSphere Application Server Full Profile
     注：在场拓扑中，不能使用 RMI JMX 接口。 在此拓扑中，Mobile Foundation 仅支持 SOAP 接口。
   • WebSphere Application Server Liberty Profile
   • Apache Tomcat
   要了解哪些版本的应用程序服务器受支持，请参阅系统需求。

   要点： Mobile Foundation 只支持同类服务器场。 在连接相同类型的应用程序服务器时，服务器场为同类。 尝试关联不同类型的应用程序服务器可能会导致运行时出现不可预测的行为。 例如，混用 Apache Tomcat 服务器和 WebSphere Application Server Full Profile 服务器的场是无效的配置。

2. 决定要使用的数据库。 您可以从下列各项中进行选择：
   • DB2
   • MySQL
   • Oracle
   在场中的应用程序服务器之间共享 MobileFirst Server 数据库，这表示：
   • 仅创建一次数据库，而不管场中的服务器数量如何。
   • 不能在场拓扑中使用 Derby 数据库，因为 Derby 数据库一次只允许一个连接。
   有关数据库的更多信息，请参阅设置数据库。
3. 设置与希望包含在场中的成员数一样多的独立服务器。
   • 其中的每个独立服务器都必须与同一个数据库通信。 您必须确保其中的任意服务器使用的任何端口均没有被同一主机上配置的另一个服务器使用。 此约束适用于 HTTP、HTTPS、REST、SOAP 和 RMI 协议所使用的端口。
   • 其中每台服务器必须部署 MobileFirst Server 管理服务、MobileFirst Server 实时更新服务以及一个或多个 MobileFirst 运行时。
   • 当其中每个服务器都在独立拓扑中正常工作时，可以将其转变到服务器场的成员中。
4. 停止所有旨在成为场成员的服务器。
5. 为应用程序服务器类型适当地配置每个服务器。
   您必须正确设置某些 JNDI 属性。 在服务器场拓扑中，对于场的所有成员，mfp.config.service.user 和mfp.config.service.password JNDI 属性必须具有相同的值。 对于 Apache Tomcat，您还必须检查 JVM 参数是否已正确定义。
   • WebSphere Application Server Liberty Profile
     在 server.xml 文件中，设置显示在以下样本代码中的 JNDI 属性。

     <jndiEntry jndiName="mfp.topology.clustermode" value="Farm"/>
     <jndiEntry jndiName="mfp.admin.serverid" value="farm_member_1"/>
     <jndiEntry jndiName="mfp.admin.jmx.user" value="myRESTConnectorUser"/>
     <jndiEntry jndiName="mfp.admin.jmx.pwd" value="password-of-rest-connector-user"/>
     <jndiEntry jndiName="mfp.admin.jmx.host" value="93.12.0.12"/>
     <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>

     必须使用相应的值设置这些属性：
     • mfp.admin.serverid：您为该场成员定义的标识。 该标识在所有场成员中必须唯一。
     • mfp.admin.jmx.user 和 mfp.admin.jmx.pwd：这些值必须与 administrator-role 元素中声明的用户的凭证匹配。
     • mfp.admin.jmx.host：将此参数设置为远程成员用于访问此服务器的 IP 或主机名。 因此，请勿将其设置为 localhost。 该主机名将由场的其他成员使用，并且必须可供所有场成员访问。
     • mfp.admin.jmx.port：将此参数设置为用于 JMX REST 连接的服务器 HTTPS 端口。 您可以在 server.xml 文件的 httpEndpoint 元素中查找值。
   • Apache Tomcat
     修改 conf/server.xml 文件以在管理服务上下文和每个运行时上下文中设置以下 JNDI 属性。

     <Environment name="mfp.topology.clustermode" value="Farm" type="java.lang.String" override="false"/>
     <Environment name="mfp.admin.serverid" value="farm_member_1" type="java.lang.String" override="false"/>

     必须将 mfp.admin.serverid 属性设置为对该场成员定义的标识。 该标识在所有场成员中必须唯一。
     您必须确保将 -Djava.rmi.server.hostname JVM 参数设置为远程成员用于访问此服务器的 IP 或主机名。 因此，请勿将其设置为 localhost。 此外，必须确保用于设置 -Dcom.sun.management.jmxremote.port JVM 参数的端口尚未被使用，才能启用 JMX RMI 连接。 在 CATALINA_OPTS 环境变量中设置这两个参数。
   • WebSphere Application Server Full Profile
     您必须在服务器上部署的管理服务和每个运行时应用程序中声明以下 JNDI 属性。
     • mfp.topology.clustermode
     • mfp.admin.serverid
     在 WebSphere Application Server 控制台中，
     • 选择 应用程序 → 应用程序类型 → WebSphere 企业应用程序。
     • 选择管理服务应用程序。
     • 在 Web 模块属性中，单击 Web 模块的环境条目以显示 JNDI 属性。
     • 设定以下属性的值。
       • 将 mfp.topology.clustermode 设置为 Farm。
       • 将 mfp.admin.serverid 设置为对该场成员选择的标识。 该标识在所有场成员中必须唯一。
       • 将 mfp.admin.jmx.user 设置为有权访问 SOAP 连接器的用户名。
       • 将 mfp.admin.jmx.pwd 设置为在 mfp.admin.jmx.user 中声明的用户的密码。
       • 将 mfp.admin.jmx.port 设置为 SOAP 端口值。
     • 验证 mfp.admin.jmx.connector 是否设置为 SOAP。
     • 单击确定并保存配置。
     • 对部署在服务器上的每个 MobileFirst 运行时应用程序进行类似更改。
6. 在场的所有成员之间交换信任库中的服务器证书。 使用 WebSphere Application Server Full Profile 和 WebSphere Application Server Liberty Profile 的场必须交换信任库中的服务器证书，因为这些场中服务器之间的通信由 SSL 提供保护。
   • WebSphere Application Server Liberty Profile
     您可以使用 IBM 实用程序（如 Keytool 或 iKeyman）配置信任库。
     • 有关 Keytool 的更多信息，请参阅 IBM SDK Java Technology Edition 中的 Keytool。
     • 有关 iKeyman 的更多信息，请参阅 IBM SDK Java Technology Edition 中的 iKeyman。
     在 server.xml 文件中定义了密钥库和信任库的位置。 请参阅 SSL 配置属性中的 keyStoreRef 和 trustStoreRef 属性。 缺省情况下，Liberty Profile 的密钥库位于 ${server.config.dir}/resources/security/key.jks 中。 如果信任库引用缺失或者未在 server.xml 文件中进行定义，那么将使用 keyStoreRef 所指定的密钥库。 服务器将使用缺省密钥库，并且会在服务器首次运行时创建该文件。 在这种情况下，将创建缺省证书，其有效期为 365 天。 对于生产环境，您可能要考虑使用自己的证书（如果需要，包括中间证书）或者更改已生成证书的到期日期。

     注：如果您要确认信任库的位置，那么可以将以下声明添加到 server.xml 文件来实现这一点：

     <logging traceSpecification="SSL=all:SSLChannel=all"/>

     最后，启动服务器，并在 ${wlp.install.dir}/usr/servers/server_name/logs/trace.log 文件中查找包含 com.ibm.ssl.trustStore 的行。
     • 将场中其他服务器的公用证书导入到服务器的 server.xml 配置文件所引用的信任库中。 教程以图形方式安装 MobileFirst Server 为您提供指示信息以在场中的两个 Liberty 服务器之间交换证书。 有关更多信息，请参阅创建由两台运行 MobileFirst Server 的 Liberty 服务器组成的场部分的步骤 5。
     • 重新启动 WebSphere Application Server Liberty Profile 的每个实例，以使安全配置生效。 需要执行以下步骤来使单点登录 (SSO) 生效。
     • 启动场的一个成员。 在缺省 LTPA 配置中，在 Liberty 服务器成功启动之后，将生成 LTPA 密钥库 ${wlp.user.dir}/servers/server_name/resources/security/ltpa.keys。
     • 将 ltpa.keys 文件复制到每个场成员 ${wlp.user.dir}/servers/server_name/resources/security 目录，以在场成员中复制 LTPA 密钥库。 有关 LTPA 配置的更多信息，请参阅 在 Liberty Profile 上配置 LTPA。
   • WebSphere Application Server Full Profile
     在 WebSphere Application Server 管理控制台中配置信任库。
     • 登录到 WebSphere Application Server 管理控制台。
     • 选择安全性 → SSL 证书和密钥管理。
     • 在“相关项”中，选择密钥库和证书。
     • 在密钥库使用情况字段中，确保选择 SSL 密钥库。 您现在可以从场中的所有其他服务器导入证书。
     • 单击 NodeDefaultTrustStore。
     • 在“其他属性”中，选择签署者证书。
     • 单击从端口检索。 您现在可以输入场中其他每个服务器的通信和安全详细信息。 对每个其他场成员执行接下来的步骤。
     • 在主机字段中，输入服务器主机名或 IP 地址。
     • 在端口字段中，输入 HTTPS 传输 (SSL) 端口。
     • 在针对出站连接的 SSL 配置中选择 NodeDefaultSSLSettings。
     • 在别名字段中，输入该签署者证书的别名。
     • 单击检索签署者信息。
     • 查看从远程服务器检索的信息，然后单击确定。
     • 单击保存。
     • 重新启动服务器。