ADF 部署指南:如何安装和配置 WebLogic Server 以便在生产环境中运行 ADF 11g 应用程序

Oracle JDeveloper 方法文档
作者:Dana Singleterry,Oracle Corporation
2011 年 3 月

简介

本方法文档详细介绍了为 Application Development Framework (ADF) 应用程序创建部署环境的分步过程。其中包括如下各项操作中应遵循的步骤:创建托管服务器、将 Java 运行时文件 (JRF) 应用于 ADF、创建 Web 层(HTTP Server 和 WebCache),以及随后为获得更优性能而调优 ADF 应用程序元素。请注意,本方法文档假设使用 Windows Server,因此若非另行说明,我们将通过 Windows“开始”菜单启动和停止 WebLogic,虽然这些操作也可通过命令提示符调用 startWebLogic.cmd 来实现。本文所述内容同样适用于 Linux Server,仅有一些细微差异。

此外,尽管本方法文档的大多数图像展示的都是 WebLogic Server 10.3.3、Application Development Runtime (ADR) 11.1.1.3.0、JDeveloper 11.1.1.3.0 等的内容,但我们将适时指出最新版本及其在流程中存在的差异。附录中还介绍了针对 Application Development Runtime (ADR) 11g (11.1.1.4.0) 和 11g (11.1.1.3.0) 的分步方法。

注意: 下面目录中的“可选”部分是独立的文件,因此如果您需要打印文档以便参考,请务必同时打印“可选”部分。

要求

下载并安装 WebLogic Server

本部分将介绍 Oracle WebLogic Server 的下载和安装。请访问 Fusion Middleware 11g 下载页面

注意:如果为 ADR 11.1.1.4.0 安装创建托管服务器,请选择特定于 11gR1 产品的下载页面(上述页面)|在“中间件”部分下找到 WebLogic Server 下载,然后下载“Oracle WebLogic Server 11gR1 (10.3.4) + Coherence — 打包安装程序”。

参见上述的主“部署”页面,选择“查看全部 | 接受许可协议”,并选择“WebLogic Server 10.3.3 所有可用平台”。

下载第二个选项“Oracle WebLogic Server 11gR1 (10.3.3) + Coherence — 打包安装程序”。

双击下载的程序包 wls1033_win32.exe 运行安装程序。选择 Next 继续。


新建一个中间件主目录,按照需要进行命名。 选择 Next 继续。


建议(但非必要)您注册安全性更新。输入您的 Oracle Support 帐户凭证。选择 Next 继续。


选择 Custom 安装。 选择 Next 继续。


这是可以安装的默认产品和组件列表。就本方法文档而言,并非所有产品和组件都是必要的。选择 Next 继续。


取消选择以下产品和组件。
  • Server Examples
  • Evaluation Database
  • Oracle Coherence
选择 Next 继续。


默认情况下可以安装两种 JDK,举例来说,创建 WebLogic 域时,可以在开发模式下使用推荐的 Sun JDK 进行配置,也可以在生产模式下使用推荐的 JRockit JDK 进行配置。选择 Next 继续。


使用默认产品安装目录或根据需要更改目录。选择 Next 继续。


根据需要安装 Node Manager 服务,以便支持远程管理和监视。如有必要,也可手动启动此服务。选择 Next 继续。


按需选择快捷方式位置。选择 Next 继续。


显示 Installation Summary。选择 Next 继续。


安装程序将运行。 


安装完成。此时无需运行快速启动,因为 WebLogic 域将在后续步骤中创建。完成后选择 Done。

下载并安装 Application Development Runtime (ADR)

Application Development Runtime (ADR) 用于使用 ADF 运行时库来扩展 Java EE 服务器(WebLogic 或 WebSphere)。这将使服务器准备好接受基于 ADF 的应用程序的部署,从而运行这些应用程序。

本部分将介绍 ADR 11g 的下载和安装。访问 Oracle ADF 下载页面。第一步是下载和安装 ADF 11.1.1.2.0,随后将安装升级到 ADF 11.1.1.3.0。

注意:如果为 ADR 11.1.1.4.0 安装创建托管服务器,请下载 ADR 11.1.1.4.0。此为独立安装,不能通过早期版本安装。

接受许可协议并下载 ADR 11.1.1.2.0。此为独立安装,不能通过早期版本安装。

下载 ADR (11.1.1.2.0) 之后,再下载 ADR (11.1.1.3.0),这是一个补丁集,需要在 11.1.1.2.0 的基础上安装,并且可在下载后立即安装。

安装 ADR (11.1.1.2.0)。使用所选的解压缩工具解压缩 ADR (11.1.1.2.0) 安装。


解压缩存档之后,运行安装实用程序 setup.exe。


安装实用程序将启动,提示读者指定 JRE/JDK 的位置。JDK 6 是本安装的必备条件,我们假设它已经安装。


按照向导说明进行操作。在 Welcome 屏幕中选择 Next 继续。


此时将执行一系列前提条件检查,确保满足要求。验证完成后,选择 NEXT 继续。


指定 ADR 的安装位置,该目录为先前安装 WebLogic Server 时使用的 WebLogic 安装主目录,选择 Next 继续。


查看 Installation Summary,单击 Save 保存响应文件以备参考。如有必要,可选择 Back 来进行修改,或选择要更改的主题跳转到要修改的位置。准备就绪后,选择 Install 继续。


在上个步骤中选择 Install 后,即开始安装,进度条将显示安装状态。选择 Next 完成安装。


此时将显示 Installation Complete 摘要屏幕,在此可选择 Save 保存安装详细信息以备参考。选择 Finish 退出。


在 ADR 11.1.1.2.0 的基础上安装 ADR (11.1.1.3.0)。 使用所选的解压缩工具解压缩 ADR (11.1.1.3.0) 安装。


解压缩存档之后,运行安装实用程序 setup.exe。


安装实用程序将启动,提示读者指定 JRE/JDK 的位置。JDK 6 是本安装的必备条件。与前面一样,我们假设 JDK 6 已经安装。


按照向导说明进行操作。在 Welcome 屏幕中选择 Next 按钮。


指定 ADR 的安装位置(这里指定的位置也是前面完成的 ADR 11.1.1.2.0 安装中指定的 Oracle 中间件主目录),选择 Next 继续。


查看 Installation Summary,单击 Save 保存响应文件以备参考。如有必要,可选择 Back 来进行修改,或选择要更改的主题跳转到要修改的位置。准备就绪后,选择 Install 继续。


在上个步骤中选择 Install 后,即开始安装,进度条将显示安装状态。


此时将显示 Installation Complete 摘要屏幕,在此可选择 Save 保存安装摘要以备参考。选择 Finish 退出。

创建一个包含托管服务器的 WebLogic 域

分别安装 ADR 11.1.1.2.0 和 11.1.1.3.0(或最新版本的 11.1.1.4.0)之后,就可以在“开始”菜单中看到 Configure Application Server 选项。选择该选项。
 

在 Oracle Fusion Middleware Configuration Wizard 启动之后,选择 Create a new WebLogic domain,随后选择 Next 继续。


在这个步骤中,选择 Generate a domain configured automatically to support the following products: 并选择以下选项:
  • Oracle Enterprise Manager - 11.1.1.0 [oracle_common]
  • Oracle JRF - 11.1.1.0 [oracle_common]

选择 Next 继续。


指定一个 Domain name(如 adf_domain),Domain Location 应该是此前执行的 WebLogic Server 中间件安装主目录的位置。具体来说,此位置默认为基于本方法文档先前步骤的正确位置。选择 Next 继续。


提供管理员用户名和口令。注意:随后,这些凭证将用于管理员控制台和 Enterprise Manager 等,因此请保证其安全。


本方法文档演示了一种可行的生产配置,因此务必在 Configure Server Start Mode and JDK 中确保选择 Production Mode,并从 Available JDKs 窗口选择 JRockit SDK。选择 Next 继续。


在 Select Optional Configuration 屏幕中,选择 Administration Server 和 Managed Servers, Clusters and Machines。选择 Next 继续。


在 Configure the Administration Server 屏幕中,为选项保留默认值。请注意,这些选项可根据需要进行更改。选择 Next 继续。


在 Configure Managed Servers 屏幕中,选择 Add 选项,输入凭证,如下所示。请注意,这些输入内容是建议的内容,可根据需要进行更改。选择 Next 继续。


本方法文档不演示集群,因此选择 Next 继续。


在 Configure Machines 屏幕中,选择 Add 创建一台使用以下具体信息的计算机。注意,可根据需要更改这些信息。选择 Next 继续。


在 Assign Servers to Machines 屏幕中,在右侧窗格中选择一台计算机,本例中仅有 ADFMachine,之后在左侧窗格中选择 ADFServer,并将其移到右侧。这会将 ADFServer 指派给 ADFMachine,以便进行管理。选择 Next 继续。


接下来的几个屏幕显示了所创建的 WebLogic 域和托管服务器的配置摘要。在下拉菜单中,选择 Deployment 可在 Details 窗格中检查其属性。


在下拉菜单中,选择 Application 可在 Details 窗格中检查其属性。


在下拉菜单中,选择 Service 可在 Details 窗格中检查其属性。


在下拉菜单中,选择 Machine 可在 Details 窗格中检查其属性。选择 Create 创建域和托管服务器。


adf_domain 将随托管服务器一起创建。管理服务器将在后续步骤中启动,因此请取消选择 Start Admin Server 选项,并选择 Done 来完成配置。


验证 Windows 服务 NodeManger 正在运行。


这样就创建了一个新域,还提供了摘要。此时可以启动管理服务器。可以通过 Windows 或 Linux 的命令行(即 ...\Oracle\WlsStandalone\user_projects\domains\adf_domain\bin\startWeblogic.cmd)启动。为 adf_domain 启动管理服务器。


将打开一个终端窗口,提示输入 WebLogic Server 的用户名和口令。这就是此前创建 adf_domain 时使用的用户名和口令。


在 WebLogic Server 运行后,登录 WebLogic Server Administration Console (http://localhost:7001/console) 访问服务器状态,并根据需要执行进一步的配置。此处所需的 Username 和 Password 就是此前创建 adf_domain 时使用的用户名和口令。


正如本视图所示,AdminServer 已经运行,但 ADFServer 尚未运行。可根据需要自动运行 ADFServer。但在本例中,必须手动启动 ADFServer。


选择 Control 选项卡,随后选中 ADFServer 复选框,再选择 Start。


在 Server Life Cycle Assistant 屏幕中选择 Yes,启动 ADFServer。


启动任务完成后,Summary of Servers 屏幕将显示 ADFServer 的状态为 RUNNING。


选择 Deployments 查看已经安装到 adf_domain 的应用程序和模块。

将 Java 运行时文件 (JRF) 模板应用到托管服务器

现在 ADFServer 已经启动,接下来需要将 JRF 模板应用到托管服务器,以便在该服务器上部署和运行 ADF 应用程序。在之前的一个步骤中,已经安装了 ADR 库(在 WebLogic 或 WebSphere 上运行 ADF 应用程序所必需的库),也创建了托管服务器。JRF 模板应用到托管服务器后,ADR 库将添加到该服务器,以便运行基于 ADF 的应用程序。可以通过命令行调用应用 JRF 模板,也可以像本文所演示的使用 Oracle Enterprise Manager 完成该操作。

启动一个 Web 浏览器,输入 Enterprise Manager 的 url:http://localhost:7001/em。如果 AdminServer 使用了不同的端口,则只需使用所用端口替换此处给出的端口即可。这同样适用于主机名。这里使用与此前创建 adf_domain 时使用的相同凭证(用户名/口令)。这些凭证也与登录管理服务器所用的凭证相同。


成功通过身份验证登录 Oracle Enterprise Manager 之后,展开 adf_domain 域的节点,选择之前创建的 ADFServer。您会看到一个 Apply JRF Template 选项。选择 Apply JRF Template 选项。


成功完成后,将显示 Confirmation 响应,表明 JRF 模板已经成功应用于 ADFServer。在此还可查看服务器状态汇总以及默认的 Application Deployments。


在 Oracle Enterprise Manager Summary 屏幕底部,还可查看服务器内可用的默认 Servlet 和 JSP 列表。

JDeveloper 11g:用于开发、配置和部署示例应用程序

这部分将介绍如何利用 JDeveloper 优化一个 ADF 应用程序的部署。读者还将配置 WebLogic Server 数据源、创建到 WebLogic Server 的连接并将示例应用程序部署到托管服务器。本方法文档使用的是 JDeveloper 11g 11.1.1.3.0,但也可使用最新版本的 Oracle JDeveloper 11g(即 11.1.1.4.0),二者不存在明显的区别。如果尚未安装 JDeveloper,请通过下载页面下载并安装 Oracle JDeveloper 11g。转到下载页面底部的存档,获得 JDeveloper 11g (11.1.1.3.0)。参见后面的附录,了解使用 ADR 11g 11.1.1.4.0 时的流程和所需软件。下载 JDeveloper 后,启动安装程序,按照向导内的说明进行操作。有关 JDeveloper 安装的具体说明,可参考 Oracle JDeveloper 安装指南

在 JDeveloper 内创建到托管服务器的连接

部署应用程序的方法之一就是利用 JDeveloper,即创建到所选服务器的连接并直接进行部署。另外一种方法是创建一个企业存档,随后通过 WebLogic Server Administration Console 部署该存档。在本方法文档中,部署将直接在 JDeveloper 内执行。无论使用 JDeveloper 11g 11.1.1.3.0 还是 11.1.1.4.0,流程都是相同的。

在 JDeveloper 的 View 菜单中,选择 Application Server Navigator。


右键单击 Application Server,从上下文菜单中选择 New Application Server...。


选择 Standalone Server 创建一个到独立服务器的连接。选择 Next 继续。


为连接提供恰当的名称。为 Connection Type 选择 WebLogic 10.3。选择 Next 继续。


提供本方法文档中之前配置托管服务器时创建的凭证(用户名/口令)。选择 Next 继续。


提供此配置所需的 Weblogic Hostname、Port 和域。选择 Next 继续。


测试连接。如果所有测试均成功,选择 Next 继续。


选择 Finish 完成到托管服务器连接的创建。


下钻到 Application Server 连接以查看详细信息。


配置 JDBC 数据源

对所用应用服务器的数据源功能进行充分利用称得上是一种最佳实践。本例中的应用服务器是 WebLogic Server。为了在 ADF 应用程序中进行这一实践,可以对 ADF 业务组件 (BC) 应用程序模块配置进行简单编辑,修改其中的连接,使之使用 JDBC 数据源,而不使用直接 JDBC 连接。

对于利用业务组件实现持久性的项目,右键单击应用程序模块。


针对 AppModuleLocal 和 AppModuleShared 选择 Edit 图标,对两者的配置分别作出适当的更改,将连接类型更改为 JDBC 数据源。


为 Connection Type 选择 JDBC DataSource。


接受所提供的数据源名称,按照相同的流程,为名为 AppModuleShared 的业务组件的配置更改数据源,以保证一致性。


注意:经过这些修改后,如果没有成功,请在数据库中创建 mls 用户,并加载所提供的数据库模式。此处通过在 Windows 命令行中运行 imp 来创建 mls 用户和加载 mls dmp 文件。使用 Oracle 数据库导入实用程序提供的默认值。针对其他操作系统也应该完成类似的流程。

转到 WebLogic Server Adminstration Console (http://localhost:7001/console) 并定义一个数据源。使用创建托管服务器时提供的凭证(用户名/口令)。在本例中,jndi 的名称必须是 jdbc/mlsDS

在 Administration Console 的主页上,转到 Domain 选择部分,再依次选择 JDBC | Data Sources。


选择 Lock & Edit 锁定服务器,以便进行配置。


选择 New 创建新数据源,并提供以下参数。选择 Next 继续。


根据需要选择 Database Driver。本方法文档中使用的是 *Oracle's Driver (Thin) for Instance connections。选择 Next 继续。


数据源创建的这个部分使用了 Support of Global Transaction 和 One-Phase Commit 这两个默认选项。可以根据需要进行配置。选择 Next 继续。


提供特定于应用程序的数据库连接凭证。在本方法文档中,使用此处提供的凭证。务必使用加载 mls 模式时使用的数据库用户名/口令。选择 Next 继续。


选择 Test Configuration,确保此处提供的数据源凭证有效。消息“Connection test succeeded”是有效的响应。选择 Next 继续。


为这个新的 JDBC 数据源选择目标服务器。本例中选择 ADFServer。选择 Finish 完成 JDBC 数据源的创建,并将该数据源指定给服务器目标。


显示 Summary of the JDBC Data Sources 页面。


务必为新建的 JDBC 数据源选择 Activate Changes。


将 ADF 应用程序部署到托管服务器

在部署示例 ADF 应用程序之前,有必要查看一下部署配置文件。在 Application Navigator 中右键单击 ViewController 并选择 Project Properties。


选择 Deployment 并选择所提供的部署配置文件,随后选择 Edit 查看部署配置文件。


提供唯一的 Java EE Web Copntext Root 名称。在本例和示例应用程序中使用的是 housesdemo。选择 OK,随后再次选择 OK,保存该配置。


右键单击 HousesDemo 工作区,从上下文菜单中选择 Deploy,随后选择 HousesDemo 应用程序。


选择 Deploy to Application Server。选择 Next 继续。


选择之前创建的应用服务器连接。选择 Next 继续。


选择 Deploy to selected instances in the domain,随后选择要部署到 ADFServer。选择 Next 继续。


查看 Deployment Summary,满意后选择 Finish 开始部署。


Message - log 将提供编译详细信息。


Deployment - log 将提供成功部署的说明。


返回 Application Server Navigator,展开 Deployments,查看 HousesDemo 是否已真正部署到服务器。


登录 Administration Console (http://localhost:7001/console),展开 Environments,选择 Servers,随后选择 ADF Server,再选择 Deployments,此时可看到,HousesDemo 应用程序已部署到 ADFServer 实例,并处于 Active 状态。

测试 ADF 应用程序并分析日志以改进性能

为了测试应用程序,如果执行了 Web Tier 的可选安装和配置,请转到 http://localhost:7777/housesdemo/faces/houses.jspx,其中端口 7777 表示 HTTP 服务器。如果尚未执行 Web Tier 的可选安装和配置,请转到 http://localhost:7002/housesdemo/faces/houses.jspx,其中端口 7002 嗲表托管服务器 ADFServer 设置的端口。尽可能按需要处理演示应用程序,但应执行此处提供的简单测试。使用所选浏览器访问主页。随后通过 Oracle Enterprise Manager 或文件系统 (...\Oracle\WlsStandalone\Oracle_WT1\instances\instance_adf\diagnostics\logs\OHS\ohs_adf) 打开 HTTP Server access.log。
.

大致看一眼 Oracle HTTP Server access.log,将注意到 8 幅可点击的 jpg 图像。可以同时查看这两个会话的完整文件 (access.log),以便对比。这些图像是在初次访问时缓存的。


查看日志的第二部分,注意到新的会话 id,其中创建了第二个浏览器实例,并访问了同一个页面。这一次,由于 .jpg 图像已经缓存,因此没有再次获取它们。这是一处明显的性能改进。


附录

此处包含的具体内容概要列举了利用 ADR 11.1.1.4.0 以及 ADR 11.1.1.3.0 配置托管服务器的基本步骤。每个表都提供了合适的下载链接和支持文档链接。最后一个表中提供了一些其他文档,供读者进一步阅读来了解本方法文档中用到的各种实用程序。

概要介绍针对 ADR 11.1.1.4.0 的流程和下载

下表提供了为 ADR 11.1.1.4.0 配置托管服务器所需的大致步骤。
下载并安装 WebLogic Server 10.3.4
下载并安装 ADR 11.1.1.4.0
创建一个包含托管服务器的 WebLogic 域
将 JRF 模板应用到托管服务器
下载并安装 Web Tier Utilities 11.1.1.4.0
配置 HTTP Server 并在 WebCache 内设置性能参数

概要介绍针对 ADR 11.1.1.3.0 的流程和下载

下表提供了为 ADR 11.1.1.3.0 配置托管服务器所需的大致步骤。
下载并安装 WebLogic Server 10.3.3
下载并安装 ADR 11.1.1.2.0
下载并安装 ADR 11.1.1.3.0
创建一个包含托管服务器的 WebLogic 域
将 JRF 模板应用到托管服务器
下载并安装 Web Tier Utilities 11.1.1.2.0
下载并安装 Web Tier Utilities 11.1.1.3.0 补丁集
配置 HTTP Server 并在 WebCache 内设置性能参数

文档

下表提供了本方法文档中所用文档的链接。
Oracle WebLogic Server
Oracle ADR
Oracle Web Tier Utilities
Oracle JDeveloper