应用程序二进制文件设置

指定企业应用程序归档 (EAR) 文件的安装目录。这个位置设置与应用程序安装和更新向导中的应用程序安装目录字段相同。

缺省情况下，EAR 文件安装在 profile_root/installedApps/cell_name/application_name.ear 目录中。

设置选项包括以下内容：

• 不要指定值，让字段留空。

  缺省值为 ${APP_INSTALL_ROOT}/cell_name，其中 ${APP_INSTALL_ROOT} 变量是 profile_root/installedApps。具有所安装应用程序的 EAR 文件名的目录将附加到 ${APP_INSTALL_ROOT}/cell_name。因此，如果您未指定目录，那么该 EAR 文件将安装在 profile_root/installedApps/cell_name/application_name.ear 目录中。

• 指定目录。

  如果指定目录，那么应用程序将安装在 specified_path/application_name.ear 目录中。具有所安装应用程序的 EAR 文件名的目录将附加到您在安装应用程序时为应用程序安装目录指定的路径。例如，如果您在 Windows 机器上安装了 Clock.ear 并指定 C:/myapps，那么应用程序将安装在 myapps/Clock.ear 目录中。${APP_INSTALL_ROOT} 变量被设置为所指定的路径。

• 为应用程序的初始安装指定 ${APP_INSTALL_ROOT}/${CELL}。

  如果希望将应用程序从一个单元导出并且稍后将导出的应用程序安装在另一单元上，那么请为该应用程序的初始安装指定 ${CELL} 变量。例如，为此设置指定 ${APP_INSTALL_ROOT}/${CELL}。导出该应用程序会创建包含该应用程序及其部署配置的增强 EAR 文件。除非指定了 ${CELL} 变量，否则该部署配置将初始安装的单元名称保留目标目录中。指定 ${CELL} 变量会确保目标目录具有当前单元名称但没有原始单元名称。

  要点： 如果在单服务器配置中安装应用程序时未指定安装目录，那么会将该应用程序安装在 ${APP_INSTALL_ROOT}/cell_name 中。当使用 addNode 实用程序将该服务器添加到多服务器配置时，新配置的单元名将成为 Deployment Manager 节点的单元名。如果运行 addNode 实用程序时指定了 -includeapps 选项，那么运行 addNode 操作前安装的应用程序仍使用安装目录 ${APP_INSTALL_ROOT}/cell_name。但是，在将服务器添加到网络配置后安装的应用程序将使用缺省安装目录 ${APP_INSTALL_ROOT}/network_cell_name。执行 addNode 操作后，要将该应用程序移至 ${APP_INSTALL_ROOT}/network_cell_name 位置，请在安装期间显式地指定安装目录 ${APP_INSTALL_ROOT}/${CELL}。在这种情况下，应用程序文件总是在 ${APP_INSTALL_ROOT}/current_cell_name 中。
• 如果应用程序已导出，并且您需要将导出的 EAR 文件安装在其他单元或位置中，请指定 ${APP_INSTALL_ROOT}/cell_name/application_name.ear（如果您没有为初始安装指定 ${APP_INSTALL_ROOT}/${CELL}）。

  导出的 EAR 文件是一个具有应用程序及其部署配置的已增强 EAR 文件。部署配置保留用于先前应用程序安装的应用程序安装目录值。如果未指定其他值，那么已增强的 EAR 文件将被安装到用于先前安装的目录中。

  如果在初始安装期间未指定 ${CELL} 变量，那么部署配置将使用目标目录中初始安装的单元名。如果要安装到其他单元，请指定 ${APP_INSTALL_ROOT}/cell_name/application_name.ear，其中 cell_name 是安装已增强 EAR 文件的单元的名称。如果未指定当前单元名，那么 cell_name 将是原始单元名，即使您要将已增强的 EAR 文件安装到具有不同名称的单元亦如此。

• 指定绝对路径或使用路径映射变量。

  既可以指定绝对路径也可以使用路径映射变量（例如 ${MY_APPS}）。可以在任何安装中使用路径映射变量。

  在包含不同种类节点成员的集群中安装应用程序时，路径映射变量特别有用。这是因为，在此类情况下，可能有不止一种方法来指定绝对路径。路径映射变量还可以包含指示当前单元名的 WebSphere® Application Server 变量 ${CELL}；例如，${MY_APP}/${CELL}。可以在“WebSphere 变量”页面中定义 WebSphere Application Server 变量，可以通过在管理控制台中单击环境 > WebSphere 变量来访问此页面。

  避免故障： 在分布式操作系统环境中，pathmap 变量的作用域从节点代理级别作用域开始，而不是从服务器级别作用域开始。 如果未在节点代理级别作用域找到此变量，那么会在节点级别作用域中查找该变量，最后会在单元级别作用域中查找。gotcha

指定应用程序服务器是使用与应用程序部署文档 deployment.xml 文件放在一起的绑定、扩展和部署描述符（缺省情况）还是使用 EAR 文件中的那些内容。

缺省情况 (false) 是使用 deployment.xml 文件中的绑定、扩展和部署描述符。要使用位于 EAR 文件中的绑定、扩展和部署描述符，请启用此设置（值为 true）。

这个使用二进制文件中的配置信息设置与应用程序安装和更新向导中的使用二进制文件配置字段相同。仅对安装在 V6.x 或更高版本的部署目标上的应用程序选择此设置。

指定产品在安装期间是否在安装位置中展开应用程序二进制文件并在卸载期间删除那些应用程序二进制文件。缺省情况是启用应用程序分发。已安装的应用程序的应用程序二进制文件将展开到指定的目录中。

在多服务器安装中，当您卸载并保存对配置的更改并同步更改时，这些二进制文件将被删除。

如果禁用了此选项，那么必须确保在所有运行该应用程序的节点上的目标目录中适当地展开应用程序二进制文件。

这个允许分发、展开以及在卸载后清除二进制文件设置与应用程序安装和更新向导中的分发应用程序字段相同。

指定已展开到所指定目录中的已安装应用程序的应用程序二进制文件访问许可权。

必须启用允许分发、展开以及在卸载后清除二进制文件选项才能指定文件许可权。

可以在文本字段中指定文件许可权。还可以通过从多选项列表中选择某些常用的文件许可权来设置这些许可权。列表选项将覆盖文本字段中设置的文件许可权。

可以在列表中设置下列一个或多个文件许可权字符串。如果选择多个选项，就会将文件许可权字符串组合到一起。

file_name_pattern=permission#file_name_pattern=permission

其中 file_name_pattern 是正则表达式文件名过滤器（例如，.*\\.jsp 表示所有 JSP 文件），permission 提供文件访问控制表 (ACL)，# 是多个 file_name_pattern 和 permission 条目之间的分隔符。如果 file_name_pattern 字符串包含字符 #，请改为使用 \#。

如果字符串中的多个文件名模式和文件许可权与应用程序中的统一资源标识 (URI) 匹配，那么产品会将最严格的适用文件许可权用于该文件。例如，如果文件许可权字符串是 .*\\.jsp=775#a.*\\.jsp=754，那么 abc.jsp 文件的文件许可权为 754。

最佳实践： 如果使用正则表达式作为文件匹配模式，那么会将整个字符串 URI 与指定的文件许可权模式作比较。必须按照 Java 编程 API 定义的方式使用正则表达式来提供更精确的匹配模式。例如，假定在文件许可权操作期间要处理下列目录和文件 URI：best-practices

文件模式匹配结果如下：

• MyWarModule.war 与任何 URI 都不匹配
• .*MyWarModule.war.* 与所有 URI 都匹配
• .*MyWarModule.war$ 只与 URI 1 匹配
• .*\\.jsp=755 只与 URI 2 匹配
• .*META-INF.* 与 URI 3 和 6 匹配
• .*MyWarModule.war/.*/.*\.class 与 URI 4 和 5 匹配

/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp

.*MyApp.ear$=755#.*\.jsp=644

最佳实践： 在文件模式中，始终使用正斜杠 (/) 作为文件路径分隔符，而与操作系统无关。best-practices

在 Windows 平台上，不能取消设置对文件的读许可权。对于 POSIX 样式许可权位来说，用于表示文件可读的位是 4，可写的位是 2，可执行的位是 1。因此，在 Windows 平台上，文件许可权是 5 或 7。并且，对于 POSIX 样式来说，还有用户、组和全局许可权。在 Windows 平台上，只能对文件设置用户许可权。组和全局许可权位将被忽略。

此处指定的访问许可权是应用程序级访问许可权。也可以在节点级配置中指定应用程序二进制文件的访问许可权。节点级文件许可权指定可以授予应用程序二进制文件的最大（最不严格）许可权。此处指定的应用程序级访问许可权只能与节点级别上指定的访问许可权一样严格或更为严格。

此设置与应用程序安装和更新向导中的文件许可权字段相同。

指定一个不可编辑的字符串，此字符串标识应用程序的构建版本。