Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南

有关部署应用程序的管理控制台任务

Procedure部署企业应用程序

企业应用程序封装在 EAR 文件中,是一种包含任何类型的 J2EE 独立模块的归档文件,如 WAR 和 EJB JAR 文件。

  1. 在树组件中,展开“应用程序”节点。

  2. 选择“企业应用程序”节点。

  3. 在“企业应用程序”页面中,单击“部署”。

  4. 在“部署”页面中,指定要部署的 EAR 文件的位置。

    服务器是运行应用程序服务器和域管理服务器的主机。客户机是可通过浏览器查看管理控制台的主机。

    • 如果文件位于客户机上或可以从客户机访问,则单击单选按钮以指定要上载到 Application Server 的软件包文件。

      单击“浏览”以找到文件,或键入文件的完整路径。

    • 如果文件位于服务器上,或者要从展开的目录部署未封装的应用程序,则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。

      键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者,但不建议在生产环境下进行此操作。

  5. 单击“下一步”将显示“部署企业应用程序”页面。

  6. 在“部署企业应用程序”页面中,请指定应用程序的设置。

    1. 在“应用程序名称”字段中,既可以保留默认名称(即文件名的前缀),也可以键入其他名称。

      如果选择上载文件,将显示默认名称。应用程序名称必须唯一。

    2. 要在部署之后禁用应用程序以使其不可用,请选中“已禁用”单选按钮。

      默认情况下,部署应用程序之后即可使用该应用程序。

    3. 如果已部署应用程序,请选中“重新部署”复选框以对其进行重新部署;否则将显示错误。

      您也可以选择其他应用程序名称,并以新名称对其进行部署。

    4. 要在部署之前检验文件的结构和内容,请选中“验证器”复选框。

      大型应用程序的检验会很耗费时间。如果怀疑文件已损坏或不可移植,请检验文件。

    5. 要预编译 JSP 页面,请选中 "JSP" 复选框。

      如果未选中此复选框,则首次访问 JSP 页面时会在运行时编译这些页面。由于编译通常很耗费时间,因此在生产环境中请选中此复选框。

    6. 选择高可用性设置。

      要启用应用程序的高可用性,请选中“可用性”复选框。如果启用了应用程序的可用性,则必须也在所有更高级别(指配置和 Web 容器或 EJB 容器)启用可用性。

    7. 选择要将应用程序部署到的目标。

      从可用目标的列表中选择目标,并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标,应用程序将部署到默认服务器实例 server

      如果要重新部署,请勿选择目标。此时您所作的任何选择都将被忽略。引用已部署的应用程序的所有目标群集或独立服务器实例都将自动引用新的、重新部署的应用程序(如果已启用群集或独立实例的动态重新配置)。有关如何在不中断服务的情况下重新部署应用程序的更多信息,请参见“升级应用程序”。

    8. 选择是否生成 RMI 存根。

      如果选择生成 RMI 存根,将生成静态 RMI-IIOP 存根并将其放置到客户机 JAR 文件中。

  7. 单击“确定”以部署应用程序。

等效的 asadmin 命令

deploy

Procedure编辑已部署的企业应用程序

  1. 在树组件中,展开“应用程序”节点。

  2. 展开“企业应用程序”节点。

  3. 选择已部署的应用程序的节点。

  4. 在“企业应用程序”页面中,更改说明。

  5. 在企业版中,启用或禁用高可用性。

    如果启用了应用程序的可用性,则必须也在所有更高级别(指配置和 Web 容器或 EJB 容器)启用可用性。

Procedure部署 Web 应用程序

Web 应用程序封装在 WAR 文件中,是一种包含组件(如 Servlet 和 JSP 文件)的归档文件。

  1. 在树组件中,展开“应用程序”节点。

  2. 选择“Web 应用程序”节点。

  3. 在“Web 应用程序”页面中,单击“部署”。

  4. 在“部署”页面中,指定要部署的 WAR 文件的位置。

    服务器是运行应用程序服务器和域管理服务器的主机。客户机是可通过浏览器查看管理控制台的主机。

    • 如果文件位于客户机上或可以从客户机访问,则单击单选按钮以指定要上载到 Application Server 的软件包文件。

      单击“浏览”以找到文件,或键入文件的完整路径。

    • 如果文件位于服务器上,或者要从展开的目录部署未封装的应用程序,则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。

      键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者,但不建议在生产环境下进行此操作。

  5. 单击“下一步”将显示“部署 Web 应用程序”页面。

  6. 在“部署 Web 应用程序”页面中,请指定应用程序的设置。

    1. 在“应用程序名称”字段中,既可以保留默认名称(即文件名的前缀),也可以键入其他名称。

      如果选择上载文件,将显示默认名称。应用程序名称必须唯一。

    2. 在“上下文根路径”字段中,输入标识 Web 应用程序的字符串。

      在 Web 应用程序的 URL 中,上下文根紧跟着端口号 (http://host:port/context-root/...)。确保上下文根路径以正斜杠开头,例如:/hello

    3. 要在部署之后禁用应用程序以使其不可用,请选中“已禁用”单选按钮。

      默认情况下,部署应用程序之后即可使用该应用程序。

    4. 如果已部署应用程序,请选中“重新部署”复选框以对其进行重新部署;否则将显示错误。

      您也可以选择其他应用程序名称,并以新名称对其进行部署。

    5. 要在部署之前检验文件的结构和内容,请选中“验证器”复选框。

      大型应用程序的检验通常会很耗费时间。如果怀疑文件已损坏或不可移植,请检验文件。

    6. 要预编译 JSP 页面,请选中 "JSP" 复选框。

      如果未选中此复选框,则首次访问 JSP 页面时会在运行时编译这些页面。由于编译通常很耗费时间,因此在生产环境中请选中此复选框。

    7. 选择高可用性设置。

      要启用应用程序的高可用性,请选中“可用性”复选框。如果启用了应用程序的可用性,则必须也在所有更高级别(指配置和 Web 容器或 EJB 容器)启用可用性。

    8. 选择要将应用程序部署到的目标。

      从可用目标的列表中选择目标,并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标,应用程序将部署到默认服务器实例 server

      如果要重新部署,请勿选择目标。此时您所作的任何选择都将被忽略。引用已部署的应用程序的所有目标群集或独立服务器实例都将自动引用新的、重新部署的应用程序(如果已启用群集或独立实例的动态重新配置)。有关如何在不中断服务的情况下重新部署应用程序的更多信息,请参见“关于滚动升级”。

    9. 选择是否生成 RMI 存根。

      如果选择生成 RMI 存根,将生成静态 RMI-IIOP 存根并将其放置到客户机 JAR 文件中。

  7. 单击“确定”以部署应用程序。

等效的 asadmin 命令

deploy

Procedure启动已部署的 Web 应用程序

部署应用程序之后,可以从管理控制台启动该应用程序。服务器和 HTTP 侦听器必须正在运行,应用程序才能启动。

  1. 在树组件中,展开“应用程序”节点。

  2. 单击“Web 应用程序”。

  3. 单击 Web 应用程序的“启动”链接。

  4. 在“Web 应用程序链接”页面中单击链接以启动应用程序。

Procedure部署 EJB 模块

EJB 模块也称为 EJB JAR 文件,包含企业 Bean。

  1. 在树组件中,展开“应用程序”节点。

  2. 选择“EJB 模块”节点。

  3. 在“EJB 模块”页面中,单击“部署”。

  4. 在“部署”页面中,指定要部署的 JAR 文件的位置。

    服务器是运行应用程序服务器和域管理服务器的主机。客户机是可通过浏览器查看管理控制台的主机。

    • 如果文件位于客户机上或可以从客户机访问,则单击单选按钮以指定要上载到 Application Server 的软件包文件。

      单击“浏览”以找到文件,或键入文件的完整路径。

    • 如果文件位于服务器上,或者要从展开的目录部署未封装的应用程序,则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。

      键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者,但不建议在生产环境下进行此操作。

  5. 单击“下一步”以显示“部署 EJB 模块”页面。

  6. 在“部署 EJB 模块”页面中,指定模块的设置。

    1. 在“应用程序名称”字段中,既可以保留默认名称(即文件名的前缀),也可以键入其他名称。

      如果选择上载文件,将显示默认名称。应用程序名称必须唯一。

    2. 要在部署之后禁用模块以使其不可用,请选中“已禁用”单选按钮。

      默认情况下,部署模块之后即可使用该模块。

    3. 如果已部署模块,请选中“重新部署”复选框以对其进行重新部署;否则将显示错误。

      您也可以选择其他应用程序名称,并以新名称对其进行部署。

    4. 要在部署之前检验文件的结构和内容,请选中“验证器”复选框。

      大型应用程序的检验会很耗费时间。如果怀疑文件已损坏或不可移植,请检验文件。

    5. 选择高可用性设置。

      要启用模块的高可用性,请选中“可用性”复选框。如果启用了模块的可用性,则必须也在所有更高级别(指配置和 Web 容器或 EJB 容器)启用可用性。

    6. 选择要将模块部署到的目标。

      从可用目标的列表中选择目标,并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标,模块将部署到默认服务器实例 server

      如果要重新部署,请勿选择目标。此时您所作的任何选择都将被忽略。引用已部署的模块的所有目标群集或独立服务器实例都将自动引用新的、重新部署的模块(如果已启用群集或独立实例的动态重新配置)。有关如何在不中断服务的情况下重新部署模块的更多信息,请参见“关于滚动升级”。

    7. 选择是否生成 RMI 存根。

      如果选择生成 RMI 存根,将生成静态 RMI-IIOP 存根并将其放置到客户机 JAR 文件中。

  7. 单击“确定”以部署该模块。

等效的 asadmin 命令

deploy

Procedure部署连接器模块

连接器也称为资源适配器,封装在一种称为 RAR 文件的归档文件中。

  1. 在树组件中,展开“应用程序”节点。

  2. 选择“连接器模块”节点。

  3. 在“连接器模块”页面中,单击“部署”。

  4. 在“部署”页面中,指定要部署的 RAR 文件的位置。

    服务器是运行应用程序服务器和域管理服务器的主机。客户机是可通过浏览器查看管理控制台的主机。

    • 如果文件位于客户机上或可以从客户机访问,则单击单选按钮以指定要上载到 Application Server 的软件包文件。

      单击“浏览”以找到文件,或键入文件的完整路径。

    • 如果文件位于服务器上,或者要从展开的目录部署未封装的模块,则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。

      键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者,但不建议在生产环境下进行此操作。

  5. 单击“下一步”以显示“部署连接器模块”页面。

  6. 在“部署连接器模块”页面中,指定模块的设置。

    1. 在“应用程序名称”字段中,既可以保留默认名称(即文件名的前缀),也可以键入其他名称。

      如果选择上载文件,将显示默认名称。应用程序名称必须唯一。

    2. 在“线程池 ID”字段中,为要部署的资源适配器指定线程池。

      默认情况下,Application Server 处理其默认线程池中所有资源适配器的工作请求。使用该字段可以关联特定用户创建的线程池以处理资源适配器的工作请求。

    3. 要在部署之后禁用模块以使其不可用,请选中“已禁用”单选按钮。

      默认情况下,部署模块之后即可使用该模块。

      启用或禁用连接器模块时,您也同时启用或禁用了指向该模块的连接器资源和连接池。

    4. 如果已部署模块,请选中“重新部署”复选框以对其进行重新部署;否则将显示错误。

      您也可以选择其他应用程序名称,并以新名称对其进行部署。

    5. 要在部署之前检验文件的结构和内容,请选中“验证器”复选框。

      大型应用程序的检验通常会很耗费时间。如果怀疑文件已损坏或不可移植,请检验文件。

    6. 如果资源适配器被指定了其他属性,将显示这些属性。

      使用此表可以修改这些属性的默认值。

    7. 选择要将模块部署到的目标。

      从可用目标的列表中选择目标,并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标,模块将部署到默认服务器实例 server

      如果要重新部署,请勿选择目标。此时您所作的任何选择都将被忽略。引用已部署的模块的所有目标群集或独立服务器实例都将自动引用新的、重新部署的模块(如果已启用群集或独立实例的动态重新配置)。有关如何在不中断服务的情况下重新部署模块的更多信息,请参见“关于滚动升级”。

  7. 单击“确定”以部署该模块。

等效的 asadmin 命令

deploy

Procedure创建生命周期模块

在被服务器生命周期中的一个或多个事件触发后,生命周期模块将执行任务。这些服务器事件包含:

生命周期模块不符合 J2EE 规范,但是该模块是 Application Server 的增强功能。

  1. 在树组件中,展开“应用程序”节点。

  2. 选择“生命周期模块”节点。

  3. 在“生命周期模块”页面中,单击“新建”。

  4. 在“创建生命周期模块”页面中,指定以下设置:

    1. 在“名称”字段中,键入表示模块功能的名称。

    2. 在“类名称”字段中,键入生命周期模块类文件的全限定名称。

    3. 如果包含生命周期的 JAR 文件位于服务器的类路径中,请将“类路径”字段保留为空。否则,键入全限定路径。

      如果不指定类路径,则必须在 domain-dir/applications/lifecycle-module/module-name 中解压缩类。如果指定类路径,则无需其他操作。

    4. 在“装入顺序”字段中,键入大于 100 且小于操作系统的 MAXINT 值的整数。

      该整数将确定服务器启动时装入生命周期模块的顺序。系统将较早装入具有较小整数的模块。

    5. 启动服务器时,服务器将装入已部署的生命周期模块。

      默认情况下,如果装入失败,服务器仍将继续进行启动操作。要在装入失败时禁止服务器启动,请选中“装入失败时”复选框。

    6. 要在部署之后禁用模块以使其不可用,请选中“已禁用”单选按钮。

      因为生命周期模块是在服务器启动时调用的,所以禁用的生命周期模块在服务器实例重新启动前仍会产生影响。

    7. 选择要将模块部署到的目标。

      从可用目标的列表中选择目标,并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标,模块将部署到默认服务器实例 server

  5. 单击“确定”。

等效的 asadmin 命令

create-lifecycle-module

Procedure部署应用程序客户机模块

应用程序客户机模块也称为 J2EE 应用程序客户机 JAR 文件,包含客户机的服务器端例程。

  1. 在树组件中,展开“应用程序”节点。

  2. 选择“应用程序客户机模块”节点。

  3. 在“应用程序客户机模块”页面中,单击“部署”。

  4. 在“部署”页面中,指定要部署的 JAR 文件的位置。

    服务器是运行应用程序服务器和域管理服务器的主机。客户机是可通过浏览器查看管理控制台的主机。

    • 如果文件位于客户机上或可以从客户机访问,则单击单选按钮以指定要上载到 Application Server 的软件包文件。

      单击“浏览”以找到文件,或键入文件的完整路径。

    • 如果文件位于服务器上,或者要从展开的目录部署未封装的模块,则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。

      键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者,但不建议在生产环境下进行此操作。

  5. 单击“下一步”以显示“部署应用程序客户机模块”页面。

  6. 在“部署应用程序客户机模块”页面中,指定模块的设置。

    1. 在“应用程序名称”字段中,既可以保留默认名称(即文件名的前缀),也可以键入其他名称。

      如果选择上载文件,将显示默认名称。应用程序名称必须唯一。

    2. 如果已部署模块,请选中“重新部署”复选框以对其进行重新部署;否则将显示错误。

      您也可以选择其他应用程序名称,并以新名称对其进行部署。

    3. 要在部署之前检验文件的结构和内容,请选中“验证器”复选框。

      大型应用程序的检验会很耗费时间。如果怀疑文件已损坏或不可移植,请检验文件。

    4. 选择要将模块部署到的目标。

      从可用目标的列表中选择目标,并单击“添加”。目标可以是群集或独立服务器实例。如果不选择目标,模块将部署到默认服务器实例 server

      如果要重新部署,请勿选择目标。此时您所作的任何选择都将被忽略。引用已部署的模块的所有目标群集或独立服务器实例都将自动引用新的、重新部署的模块(如果已启用群集或独立实例的动态重新配置)。有关如何在不中断服务的情况下重新部署模块的更多信息,请参见“关于滚动升级”。

    5. 选择是否生成 RMI 存根。

      如果选择生成 RMI 存根,将生成静态 RMI-IIOP 存根并将其放置到客户机 JAR 文件中。

      对于客户端例行程序:

      • 通常,应用程序供应商会发行包含客户端例行程序的 JAR 文件。

      • 应用程序供应商通过指定 asadmin deploy 命令的 --retrieve 选项来获取客户端存根。

  7. 单击“确定”以部署该模块。

等效的 asadmin 命令

deploy

Procedure指定要部署的归档文件

在应用程序或模块页面上单击“部署”,以访问“部署”页面。在“部署”页面中,指定封装应用程序或模块的归档文件的位置。

服务器是运行应用程序服务器和域管理服务器的主机。客户机是可通过浏览器查看管理控制台的主机。

  1. 如果文件位于客户机上或可以从客户机访问,则单击单选按钮以指定要上载到 Application Server 的软件包文件。

    单击“浏览”以找到文件,或键入文件的完整路径。

  2. 如果文件位于服务器上,或者要从展开的目录部署未封装的应用程序,则单击单选按钮以指定必须可以从服务器上访问的软件包文件或目录路径。

    键入文件或目录的完整路径名。从展开的目录部署适用于高级开发者,但不建议在生产环境下进行此操作。