Technical Blog Post
Abstract
五分钟学会使用IBM Application Runtime Expert for i——使用ARE Console验证系统
Body
背景
重要提示：ARE console 已经通过最新的 PTF 获得重大地提升。为了能够确保本文中所提到的功能在您的 ARE 上运转正常，请您务必确保您的 IBM i 系统上已经安装有 IBM Application Runtime Expert for i PTF 5733ARE SI40302 或者其后续 PTF 。安装 PTF SI40302 后 IBM Application Runtime Expert for i 将升级至 v1.4.0 .
IBM Application Runtime Expert for i （以下简称 ARE），允许用户创建用于验证 IBM i 系统应用程序和系统属性的模板（template）。一般有两种方法可实现系统验证：
1. 使用 ARE Console 的 Web 用户界面。
2. 在 QShell 环境下调用脚本。
本文旨在向您介绍 ARE Console 的使用，它提供简便而实用的用户界面，用户可以通过选中的模板验证远程系统。无论待验证的系统是本地的还是远程的，一律称为目标系统。使用 Console 的优势之一是您无需事先将选定的模板逐个发送至目标系统，这将由 Console 来完成。也就是说你只需要选择某个模板，并提供目标系统的 hostname，IP 地址，用户名和密码，接着就可以由 Console 使用模板验证目标系统了。验证的结果将从目标系统回流到 ARE Console，只需通过浏览器便可直接查看 ARE 产生的验证报告。Console 可同时验证多个分区或者系统，这使得您无需任何繁杂的配置就能够验证您的整个生产环境。
重要提示：要使用 ARE Console 验证某个 IBM i 系统，作为前提条件，有几个极为常见的产品必须提前在目标系统上安装好，比如，最新的HTTP 和 Java Group PTF。欲了解完整的软件要求列表和补丁级别要求，请访问：http://www.ibm.com/systems/power/software/i/are/ptfs.html
如果目标系统不能满足最低的软件及补丁要求，当用户使用 ARE Console 验证目标系统时将得到“Remote system does not meet requirement” 错误信息。未达标安装的软件及补丁的详细信息会在 console runtime log 文件中找到。
Console Overview
要访问 Console 的 Web 用户界面，您要首先通过浏览器访问并登陆 ARE Web 用户界面。
当您登陆 ARE 用户界面，首先看到的是部署模板编辑器（Deployment Template Editor）的主页。要进入 ARE Console，您需要单击在“Manage templates” 表下方的“Launch console”按钮（如 Figure 1 所示）。
Figure 1 – Launch console button on the Deployment Template Editor home page
单击“Launch console”按钮之后，将显示用于验证远程系统的页面。 如果你需要返回部署模板编辑器（Deployment Template Editor），只需单击在页面底部的“Launch deployment template editor”按钮（见 Figure 2）。
Figure 2 – Launch deployment template editor button on the console main page
管理系统和组
在 Console 中可以为你要验证的若干个目标系统创建分组，我们称之为系统组。系统组（system group）提供一个简便的方式将目标系统及用于系统验证的模板的组合保存下来。这样，您只需要一次性设置好系统组，确定其中的目标系统并选择验证时使用的模板，而无需重复提供以上信息。
默认的系统组名为“Default”。 ARE console 允许您在系统组中管理目标系统的信息，包括指定用于验证系统的模板（见 Figure 3）。
Figure 3 – System groups in the console
为了便于管理系统组，Console 提供如下操作选项。选项可通过“Operation”菜单访问。它位于页面左侧，“Default”系统组标签下方。如 Figure 4 所示：
Figure 4 – Operation menu for managing system groups
系统组的操作选项有：
- Add – 添加新的空白系统组。您需要为新的系统组命名，其长度限制在40个字符，并且不允许出现空格和特殊字符。
- Delete – 删除当前选中的系统组。该组中包含的所有目标系统信息将被全部清除。
- Rename –为当前选中的系统组重命名。
- Copy – 为当前选中的系统组创建一个副本。新建的副本将包含源系统组中的所有配置信息。
如下图 Figure 5 所示，每个系统组都是一个待验证的系统及相关模板的列表：
Figure 5 – Specify information about a system to verify
其中每一行表示一个待验证的目标系统，其中包括如下信息：
- System name –称为“目标系统”，通常是待验证系统的主机名或者IP地址。
- User ID – 目标系统上的 IBM i User ID。这个 User ID 用于在目标系统上运行验证任务。它必须是有效，并且在系统上处于可用状态的（STATUS (*ENABLED)）。
- Password – 所提供的 User ID 的密码。
- Template – 用于验证目标系统的模板。
重要：指定的 User ID 用于在目标机上运行验证任务。为了确保验证能够成功完成，User ID 必须对所有被验证的系统资源有足够的访问权限。
在每个系统组中都可以添加和删除目标系统。需要注意的是，如果要从系统组中移除目标系统，只有被选中的（单击系统名左侧的复选框）都会被移除。最近一次的验证结果可以通过单击“View previous results”按钮查看。只要浏览器的当前会话（session）有效，便可查看最近一次验证结果。
对于某些模板来说，可能需要将运行时信息传递给 ARE Core 以便验证能够顺利执行（作为 ARE 的组件之一ARE Core 利用部署模板编辑器创建的模板对目标系统执行验证）。举例来说，如果模板中采用了可替换变量（replacement variable），则需要为可替换变量赋值，它将作为 ARE 的一项输入信息。 Console 中也为配置验证的运行时属性提供了途径。通过“Runtime properties”按钮，可指定一次验证的目标系统数量，还可设置执行验证时的日志级别，此外，就是为可替换变量（replacement variable）赋值的文本输入框。
特别需要注意的是，Runtime Properties settings 只作用于当前系统组中的目标系统。如果你希望为不同目标系统设置不同的运行时参数，那么你不妨创建多个系统组，让每个系统组都有各自的运行时参数。
Figure 6- Console Runtime Properties dialog box
验证系统
当您从某个系统组中选好需要验证的目标系统后，通过单击“Verify systems” 按钮，您便可启动系统验证过程。
重要：ARE 只验证被选中的目标系统（即选中目标系统名左侧的复选框）。
Figure 7 - Starting the verification for the selected systems
在单击“Verify systems”按钮后，将显示目前的系统验证状态页面。系统验证状态会按一定时间间隔刷新。您也可以通过点击位于验证状态表右上角的“Refresh”链接对验证状态进行手动刷新状态。（见 Figure 8）
Figure 8 – System verification status
当系统验证完毕， 在验证状态表中验证状态列（status column）会出现一个 “完成”图标，并且有关验证结果的汇总信息会出现在结果列（result column）中。如由于某种原因 ARE console 对目标系统的验证未能执行成功，在“Status”列中会指出问题摘要，和一个红色图标。此外，执行失败的详细内容可以通过点击在结果列中的“View log”链接查看。（见 Figure 9）
Figure 9 – Faile to verify target systems
对于刚刚被检验过的目标系统，下表中的结果列（Result column）包含有验证结果的汇总摘要。而摘要文字本身同时也是方便用户访问 ARE core所生成的目标系统验证报告的入口。（见 Figure 10）
Figure 10 – Links to the verification reports
用户可通过结果列中的链接对这三种 ARE 报告类别（汇总报告，详细报告以及 XML 报告）进行访问。 欲了解更过关于ARE报告的信息，请参考产品官方网站上的文章《Under standing ARE reports》：
http://www.ibm.com/systems/power/software/i/are/documentation.html
除此之外，另有一个指向运行时日志（runtime log）的链接。运行时日志包含在验证目标系统期间写入控制台的事件。
就这三种 ARE 报告来说，用 console 对其进行查看，展示效果最为突出的是汇总报告—— Console 对其展示效果进行了渲染，使查看起来更为直观、易读。
汇总报告包含在所验证目标系统上发现的全部问题。在汇总表中的每一行列出特定插件（plugin）的验证结果，像“Authority Verifier”或是 “System Value Verifier”插件。在插件名前面出现的图标的状态表示由这个 plugin 中检出并且严重级别最高的问题类型。此外，其他各列分别列出所检验属性的总数量，通过这个插件发现的问题数目，以及各严重程度（error, warning, info）发现问题的总数量。每行的最后一列是“Fix actions”，它代表有多少问题可以通过当前的 console 界面直接予以修复。关于如何借助 console 修复问题的细节，我们将在下面一节进行介绍。
想要查看详细信息，单击任意插件名（或者插件名前面的 twister 图标）即可。这将展开插件的汇总视图并分行显示在当前插件上所发现问题的详细信息。如果插件没有检测到任何问题，就不会有详细信息列出。（见 Figure 11）
Figure 11 - Summary report
修复检出的问题
前面一节提到位于汇总报告最后一行的“Fix Actions”列。这一列的目的就在于允许用户通过 Console 的 Web 界面直接修复检出的特定问题。这是个非常实用的功能。它将免去用户登录远程目标系统，手动修复特定问题的麻烦。不过，需要引起注意的是这一功能只提供部分特定类型问题的直接修复。
在下图 Figure 12中，有两个插件分别检出的问题可通过 console 直接修复：Authority Verifier 和 Profile Verifier。
Figure 12 - Summary report with fix actions
点击“Fix actions”链接，console 能够直接修复的问题会被汇总显示在接下来的页面中（见 Figure 13）。您可以通过选中每个问题描述前的复选框来选择想要解决的问题。
Figure 13 - Select problems to fix directly from the console
选好之后只需单击“Fix”按钮， console 即刻开始在目标系统上针对刚才选中的问题展开修复。修复完成后，处理结果会在下方“Processed problems”表中列出（见 Figure 14）。注意，该表中的第一列（Result ）指出 console 尝试修复后的结果，第二列（Description）则是问题的原始描述（并不是这次修复结果的详细描述）。
Figure 14 - Result of fixing problems on the target system
单击“Back”按钮可以从修复问题页面返回汇总报告页面。
重要：这个汇总报告是验证结果的静态视图。也就是说，即便问题刚刚已经通过“Fix actions”修复好了，修复后的系统状态也不会在当前汇总报告中体现出来。如需更新汇总报告内容，需要重新对目标系统运行一遍验证。
欢迎访问 IBM Application Runtime Expert for i 的官方站点了解更多信息:
http://www.ibm.com/systems/power/software/i/are/index.html
如您对本产品有任何问题或者希望和开发者及现有用户进行讨论,敬请访问我们的中文群组:
关于作者
焦焕文，jiaohw@cn.ibm.com，IBM 中国系统与技术中心，负责 IBM Application Runtime Expert for i 的产品研发工作。
张煜晗，zhyhzhyh@cn.ibm.com，IBM 中国系统与技术中心，负责 IBM Application Runtime Expert for i 的产品研发工作。
王南，wangnan@cn.ibm.com，IBM 中国系统与技术中心，负责 IBM Application Runtime Expert for i 的产品研发工作。
了解更多关于 IBM i 的信息，请关注 IBM i 新浪官方微博@IBMiChina。
UID
ibm11144888