应用程序二进制文件设置

使用此页面来配置应用程序二进制文件的位置和分发。

要查看此管理控制台页面,请单击应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 应用程序二进制文件

注意: 如果应用程序正在运行,那么更改应用程序设置将导致应用程序重新启动。在独立服务器上,应用程序在您保存更改后将重新启动。在多服务器产品上,应用程序将在您保存更改后重新启动,并且在安装应用程序的节点上,文件将同步。要控制对多服务器产品进行同步的时间,请取消选择控制台首选项页面上的将更改与节点同步
位置(完整路径)

指定企业应用程序归档(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 变量来访问)中定义 WebSphere Application Server 变量。

数据类型 字符串
单位 完整路径名
使用二进制文件中的配置信息

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

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

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

数据类型 布尔值
缺省值 false
允许分发、展开以及在卸载后清除二进制文件

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

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

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

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

重要: 如果禁用了此选项,并且未将应用程序二进制文件复制到节点并将它们展开,那么,以后保存配置或手动进行同步时,就不会将那些应用程序二进制文件移至那些节点。

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

数据类型 布尔值
缺省值 true
文件许可权

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

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

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

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

表 1. 对列表选项设置的文件许可权字符串. 选择列表选项或在文本字段中指定文件许可权字符串。
多选项列表选项 设置的文件许可权字符串
允许读取所有文件,但不允许写 .*=755
允许执行可执行文件 .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755
允许任何人读取 HTML 和图像文件 .*\.htm=755#.*\.html=755#.*\.gif=755#.*\.jpg=755

除使用多选项列表来指定文件许可权以外,也可以在文本字段中指定文件许可权字符串。文件许可权使用具有以下格式的字符串:

file_name_pattern=permission#file_name_pattern=permission

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

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

最佳实践: 如果使用正则表达式作为文件匹配模式,那么会将整个字符串 URI 与指定的文件许可权模式作比较。必须按照 Java 编程 API 定义的方式使用正则表达式来提供更精确的匹配模式。例如,假定在文件许可权操作期间要处理下列目录和文件 URI:bprac
表 2. 文件许可权操作的 URI 示例. 结果在下表中显示。
1 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war
2 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp
3 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF/MANIFEST.MF
4 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/WEB-INF/classes/MyClass.class
5 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/mydir/MyClass2.class
6 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF

文件模式匹配结果如下:

  • MyWarModule.war 与任何 URI 都不匹配
  • .*MyWarModule.war.* 与所有 URI 都匹配
  • .*MyWarModule.war$ 只与 URI 1 匹配
  • .*\\.jsp=755 只与 URI 2 匹配
  • .*META-INF.* 与 URI 1 和 6 匹配
  • .*MyWarModule.war/.*/.*\.class 与 URI 4 和 5 匹配
如果对文件许可权指定了目录名称模式,那么将根据指定的值设置目录许可权。否则,对该目录设置的文件许可权值与其父目录相同。例如,假定有以下文件和目录结构:
/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp
并且,指定以下文件模式字符串:
.*MyApp.ear$=755#.*\.jsp=644
文件模式匹配结果如下:
  • 目录 MyApp.ear 设置为 755
  • 目录 MyWarModule.war 设置为 755
  • 目录 MyWarModule.war 设置为 755
最佳实践: 在文件模式中,始终使用正斜杠(/)作为文件路径分隔符,而与操作系统无关。bprac

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

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

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

数据类型 字符串
应用程序构建级别

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

数据类型 字符串



标有(在线)的链接要求访问因特网。

相关任务
相关参考
企业应用程序设置


文件名: urun_rapp_appbin.html