怎样通过 IBM Rational Asset Analyzer 来分析分布式资源，第 1 部分---收集应用程序中的分布式资源的清单

Soumita Ghosh, IT 软件工程师, IBM 2010 年 1 月 18 日 您可以使用 IBM® Rational® Asset Analyzer 来分析由一些语言组成的分布式应用，这些语言例如 Java™ ，HTML，JavaServer™ Pages（JSP），以及在有限程度上，C++ 以及 XML。您还可以获取描述 Web 应用使用资源的 IBM® WebSphere® Application Server 配置信息。这个由两部分文章组成的系列的第一部分，本文描述了怎样使用 Rational Asset Analyzer 的组件 Distributed Scanner，来收集 Rational Asset Analyzer 储存库目录中的 Java 应用程序的清单，这样您就可以随后查看并管理这些应用的分布式资产。

启动 Rational Asset Analyzer

IBM® Rational® Asset Analyzer 是一个在 WebSphere 应用服务器上运行的 Web 应用。当资源存储在以下容器中时，可以得到直接的分析：

• Microsoft® Windows® 文件系统以及 IBM® AIX® 文件系统，它们通过 SAMBA 以及 FastConnect 来映射到 Windows
• IBM® Rational® ClearCase® 2003 版本的对象基底（VOB）
• PVCS® 6.8.0.0
• IBM® Configuration Management Version Control （CMVC）3.1.1 以及 CMVC 95
• CVS 客户端 1.11.1.2（构建 41）
• IBM® WebSphere Application Server 4.0 AE，5.1 版本以及 6 版本

按照以下方法来启动软件：

1. 打开浏览器并为 Rational Asset Analyzer 输入 URL。
2. 选择 Start > All Programs > IBM > Rational Asset Analyzer。
3. 如果安全性设置激活了，您必须提供一个用户名及密码。在您输入用户名以及密码之后，Rational Asset Analyzer 的浏览器界面会打开（见于图 1）。

您可以在 Web 浏览器中输入 http://<ipaddress-machine>/dmh，来从网络中的其他系统中访问 Rational Asset Analyzer。当您按这种方式访问应用时，Rational Asset Analyzer 中的中央储存库可以位于一个服务器上，其他的成员可以从他们的工作站上访问储存库，就算 Rational Asset Analyzer 储存库位于私人系统中时，也是这样。

图 1. Rational Asset Analyzer 主页

（图 1 的大图）

收集 Java 程序的清单

为了找到 Windows 系统上 Java™ 程序的清单，您创建了 Distributed Scanner，扫描资源到储存库中，并运行过程以分析资源。

创建 Distributed Scanner 程序

在您可以收集程序的清单之前，您必须为每一个 AIX 系统创建 Distributed Scanner ，扫描器可以在这些系统上运行，以识别分布式站点的主机名。您只需要创建程序一次。

Rational Asset Analyzer 必须能够访问储存源的库。Rational Asset Analyzer 的分布式功能必须安装到 Windows 或者 AIX 系统上，这些系统可以访问分布式的源代码。这可能需要 Distributed Scanner 的多个安装版本。Rational Asset Analyzer 分布式功能的每一个安装版本与 Rational Asset Analyzer 会一起注册，并提供主机名以识别位置或者对 Rational Asset Analyzer 的战点。在扫描到每一个资源后，该资源都会与站点名联系了。

1. 为了启动扫描器，选择 Start >All Programs >IBM >Rational Asset Analyzer >Distributed Scanner（见于图 2）。一个 DOS 窗口会打开，该窗口包含了来自 Distributed Scanner 的启动信息。

图 2. 启动 Rational Asset Analyzer 中的 Distributed Scanner

1. 忽略以下的出错信息，“使用方法 [DATASOURCE] 访问数据库失败”。接下来的信息（图 3）通过使用替换的名字来报告访问的数据库。在大概一分钟之后，就会显示出 GUI 界面了。

图 3. Rational Asset Analyzer 中启动的 Distributed Scanner

1. 在 Rational Asset Analyzer Administrator GUI 中，通过点击如图 4 所示的播放按钮（前向箭头），来启动分布式扫描过程。

分布式扫描器信息 当扫描器运行时，播放按钮不能使用。过程信息会显示在 Event Log （左边的窗格中），错误信息会显示在 Error Log （右边的窗格中）。这些扫描器信息同样会写进日志文件中。日志文件中的目录路径会在 Common.cfg 配置文件中得到定义。

图 4. 分布式 Scanner GUI

1. 在您继续之前，等待直到“扫描器管理器完成”信息出现为止。

图 5. Distributed Scanner 信息

分布式扫描器信息 如果信息“DMH5146W – 警告：Servlet 可能向下或者不能使用”出现在错误日志中，那么您必须手动启动分布式处理过程。

1. 确认分布式站点通过检查站点总结页面来注册。您需要注册到 Rational Asset Analyzer。
2. 选择 Start >All Programs > IBM >Rational Asset Analyzer。
   • 当您需要注册时，如果值是预填充的，如图 6 所示，点击 OK；否则，输入您的用户名以及密码，然后点击 OK。

图 6. 输入的具体密码

1. 在 Rational Asset Analyzer 主页上 Common 资源区域内，Site 旁边，选择 2。 Site Summary 页面会打开并包含两个站点。

图 7. Common Assets 视图



图 8. 站点总结具体细节

（图 8 的大图）

站点名的源 站点名是在安装 Rational Asset Analyzer 时定义的。MVS 站点名是通过 IBM® System z® （z/OS®）机器系统名处获得的。分布式站点的名字是在 Rational Asset Analyzer 安装及创建向导中输入的，并存储在 Common.cfg 文件中。

选择，扫描并处理程序

在您创建 Distributed Scanner 之后，您可以收集 Java 程序的清单：

1. 定义分析哪一个分布式应用的清单。您通过定义扫描的根目录来指定分析哪一个程序的清单。扫描根目录识别了目录的路径、档案名以及 SCM 路径（例如，一个 Rational ClearCase 视图），或者一个存储部署程序或者源文件的 WebSphere Application Server 节点。使用 Distributed Scan Root 向导来创建一个新的扫描根目录，或者编辑一个已存在的扫描根目录。为了定义或者编辑扫描根目录，您的用户 ID 必须拥有 Rational Asset Analyzer 管理员权限。
2. 扫描并载入分布式资源到 Rational Asset Analyzer 储存库中。Distributed Scanner 程序扫描根目录中所识别的源文件。在 Distributed Scanner 的每一次运行期间，都只会扫描一个新的或者更改过的文件。
3. 在扫描的分布式资源上运行处理。Rational Asset Analyzer 分布式应用会分析收集到的信息，并创建关于资源的其他关系性信息。

定义一个 Java 程序扫描根目录

1. 从 Rational Asset Analyzer 菜单栏中，点击 Database > Distributed scan roots。会打开如图 9 所示的 “分布式扫描根目录”页面。

图 9. 数据库菜单

1. 从 Actions 列表中，选择 Create new distributed scan root。Distributed Scan Root 向导会打开。一直等到您运行 Distributed Scanner 并在 Site Summary 页面上点击分布式站点，才会创建扫描根目录

图 10. 从 Actions 列表中选择创建一个新的分布式扫描根目录

1. 在“创建新的分布式扫描根目录”窗口中，输入以下的信息：
   1. 在 Scan root name 区域中，输入 Wellpoint Code。
   2. 在 Description 区域中，识别程序。
   3. 接受 User 和 Site 区域中的默认值。
   4. 点击 Next。

图 11. “创建一个新的分布式扫描根目录”窗口"

1. 从 Resource 管理器列表中，选择 File System。（提示：页面会随着该区域中的鼠标一起打开。为了快速选择一个资源管理器，输入想要选择的第一个字符；在本例中，输入 F）。
2. 接着点击 Next。

图 12. “资源管理器”列表

1. 在 Path 区域中，输入 C:/Documents and Settings/atguser/Desktop/soumita/wellpoint ，然后点击 Next。

分布式扫描器根目录路径值 路径可以指向一个特定的文件或者文件夹，例如 C:/Documents and Settings/atguser/Desktop/soumita/wellpoint/，在这种情况下，Rational Asset Analyzer 可以扫描文件夹中的所有内容。

1. 从 Distributed 扫描根目录向导的第 4 步和第 5 步中，选择 Next。运行时环境会识别所需的 Java 库，以解决资源引用。如果您想要使用 Java 模式检测时，这才会需要。
2. 在向导的 Review 页面中（图 13），选择 Add to analysis queue now 并点击 Finish。这一步会创建扫描根目录定义，并向 Rational Asset Analyzer 分布式请求查询添加一行，Distributed 扫描器会阅读该查询以检测需要做什么工作。

图 13. Distributed Scan Root 向导的步骤 6

1. 从 Rational Asset Analyzer 菜单栏中，点击 Database > Analysis queue。会显示出 Analysis 查询页面。在页面顶部的 Details 组中，注意“Outstanding distributed queue requests”显示的是值 1。

扫描并处理资源

在您定义分析的清单之后，您可以启动 Distributed Scanner，它是阅读了分布式源文件的 Java 程序，并涉及到基于源文件的分析器。分析器会从程序源文件中提取元数据，它存储在 Rational Asset Analyzer 储存库中。

在所有的资源扫描及分析之后，后处理器会自动启动。后处理器会找到资源以及链接之间的关系。关系的示例包含了类到父类之间的资源；HTML 到 JSP，它基于 HTML 中的 HREFs；以及 WAR 到 EJB 之间的关系（Web 档案到 Enterprise JavaBeans™），它基于 WAR 开发描述器中的 EJB-refs。

设置扫描器以自动运行 在生产环境中，您可以在 Admin.cfg 文件中将 ShouldUseTimer 设置为 True，来设置扫描器在日程表上运行。在这种情况下，不需要接下来的步骤。

按照以下方法来运行 Distributed Scanner：

1. 在 Rational Asset Analyzer Administrator GUI 中，点击播放按钮，它是一个绿色的箭头（图 14），以启动分布式的扫描过程。

图 14. 扫描以 GUI 中的“完成”信息为止

1. 在您继续之前，等待直到“扫描管理器完成操作 ”信息出现在事件日志中为止。这个过程大概需要 10 到 20 分钟左右的时间。
2. 登录到 Rational Asset Analyzer。
3. 从 Rational Asset Analyzer 菜单栏中，点击 Database > Analysis queue 以打开 Analysis 查询页面。
4. 如果 Analysis 查询页面显示了信息 DMH5452W，等待直到处理完成为止。点击 Refresh 以更新页面。
5. 从 Rational Asset Analyzer 菜单栏中，点击 Explore > Distributed assets 以切换至“查看分布式资源”页面（图 15）。

图 15. “查看分布式的资源”页面

（图 15 的大图）

 

您还可以通过选择如图 16 中所示的 Containers 或者 Application 选项，来查看分布式的资源。

图 16. 查看菜单选项

在选择 Database > Errors 扫描资源之后，您可以评审这些错误。

图 17. Database 菜单上的错误选项