教程:在 AppStream 2.0 上设置企业分析器 - AWS 大型机现代化

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

教程:在 AppStream 2.0 上设置企业分析器

本教程介绍如何设置 Micro Focus Enterprise Analyzer 来分析一个或多个大型机应用程序。Enterprise Analyzer 工具可根据其对应用程序源代码和系统定义的分析提供多个报告。

此设置旨在促进团队协作。安装使用 Amazon S3 存储桶与虚拟磁盘共享源代码。这样做会在 Windows 计算机上使用 Rclone。通过运行 Postgre 的常用 Amazon RDS 实例SQL,团队中的任何成员都可以访问所有请求的报告。

团队成员还可以将 Amazon S3 支持的虚拟磁盘挂载到个人机器上,并从其工作站更新源存储桶。如果他们连接到其他本地内部系统,还可以在其机器上使用脚本或任何其他形式的自动化。

该设置基于 AWS 大型机现代化与客户共享的 AppStream 2.0 Windows 映像。设置还基于创建 AppStream 2.0 舰队和堆栈,如中所述。教程:设置 AppStream 2.0 以与 Micro Focus 企业分析器和 Micro Focus 企业版开发人员配合使用

重要

本教程中的步骤假设您使用可下载的 AWS CloudFormation 模板 cfn-m2-.ym l 设置 AppStream 2.0。appstream-fleet-ea-ed有关更多信息,请参阅 教程:设置 AppStream 2.0 以与 Micro Focus 企业分析器和 Micro Focus 企业版开发人员配合使用

要执行本教程中的步骤,您必须设置 Enterprise Analyzer 实例集和堆栈,并且它们必须正在运行。

有关 Enterprise Analyzer 特征和交付项的完整描述,请参阅 Micro Focus 网站上的 Enterprise Analyzer 文档

映像内容

除了 Enterprise Analyzer 应用程序本身之外,该映像还包含以下工具和库。

第三方工具

C:\Users\Public 中的库

  • BankDemo 企业开发者的源代码和项目定义:m2-bankdemo-template.zip.

  • MFA为大型机安装软件包:mfa.zip。有关更多信息,请参阅《Micro Focus Enterprise Developer》文档中的大型机访问权限概述

  • Rclone 的命令和配置文件(教程中的使用说明):m2-rclone.cmdm2-rclone.conf

先决条件

  • 将您要分析的客户应用程序的源代码和系统定义上传到 S3 存储桶。系统定义CICSCSD包括DB2对象定义等。您可以在存储桶中创建一个文件夹结构,该结构表示您要如何组织应用程序构件。例如,解压缩 BankDemo 示例时,其结构如下:

    demo |--> jcl |--> RDEF |--> transaction |--> xa
  • 创建并启动一个运行 Postgre SQL 的亚马逊RDS实例。此实例将存储 Enterprise Analyzer 生成的数据和结果。您可以与应用程序团队的所有成员共享此实例。此外,在数据库中创建一个名为 m2_ea(或任何其他合适的名称)的空架构。为授权用户定义凭证,允许其创建、插入、更新和删除此架构中的项目。您可以从 Amazon RDS 控制台或账户管理员处获取数据库名称URL、其服务器终端节点和端TCP口。

  • 确保您已设置了对您的的编程访问权限 AWS 账户。有关更多信息,请参阅《Amazon Web Services 一般参考》中的编程访问

步骤 1:设置

  1. 使用 AppStream 2.0 开始会话URL,使用你在 2. AppStream 0 的欢迎电子邮件中收到的。

  2. 使用您的电子邮件作为用户 ID,并定义您的永久密码。

  3. 选择 Enterprise Analyzer 堆栈。

  4. 在 AppStream 2.0 菜单页面上,选择 “桌面” 以访问队列正在进行流式传输的 Windows 桌面。

步骤 2:在 Windows 上创建基于 Amazon S3 的虚拟文件夹

注意

如果您在 AWS 大型机现代化预览版中已经使用过 Rclone,则必须更新m2-rclone.cmd到位于中的较新版本。C:\Users\Public

  1. 使用文件资源管理器将 C:\Users\Public 中提供的 m2-rclone.confm2-rclone.cmd 文件复制到您的主文件夹 C:\Users\PhotonUser\My Files\Home Folder

  2. 使用您的 AWS 访问密钥和相应的密钥以及您的密钥更新m2-rclone.conf配置参数 AWS 区域。

    [m2-s3] type = s3 provider = AWS access_key_id = YOUR-ACCESS-KEY secret_access_key = YOUR-SECRET-KEY region = YOUR-REGION acl = private server_side_encryption = AES256
  3. m2-rclone.cmd 中,进行以下更改:

    • your-s3-bucket 更改为您的 Amazon S3 存储桶名称。例如,m2-s3-mybucket

    • your-s3-folder-key 更改为您的 Amazon S3 存储桶密钥。例如,myProject

    • your-local-folder-path 更改为要从包含应用程序文件的 Amazon S3 存储桶同步应用程序文件的目录路径。例如,D:\PhotonUser\My Files\Home Folder\m2-new。此同步目录必须是主文件夹的子目录,才能让 AppStream 2.0 在会话开始和结束时正确备份和恢复它。

    :loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:your-s3-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf" goto :loop
  4. 打开 Windows 命令提示符,使用 cd 命令切换到 C:\Users\PhotonUser\My Files\Home Folder(如果需要),然后运行 m2-rclone.cmd。此命令脚本连续循环运行,每 10 秒将您的 Amazon S3 存储桶和密钥同步到本地文件夹。您可以根据需要调整超时。您应该在 Windows 文件资源管理器的 Amazon S3 存储桶中看到该应用程序的源代码。

要将新文件添加到您正在处理的文件集中或更新现有文件,请将文件上传到 Amazon S3 存储桶,这些文件将在 m2-rclone.cmd 中定义的下一次迭代中同步到您的目录。同样,如果要删除某些文件,请将其从 Amazon S3 存储桶中删除。下次同步操作会将其从您的本地目录中删除。

步骤 3:为 Amazon RDS 实例创建ODBC来源

  1. 要启动 EA_Admin 工具,请导航到浏览器窗口左上角的应用程序选择器菜单,然后选择 MF EA_Admin

  2. 从 “管理” 菜单中选择 “ODBC数据源”,然后从 “用户 DSN” 选项卡中选择 “添加”。

  3. 在 “创建新数据源” 对话框中,选择 Po stgr SQL e Unicode 驱动程序,然后选择 “完成”。

  4. 在 P ostgr SQL e Unicode ODBC 驱动程序 (psqlODBC) 安装对话框中,定义并记下所需的数据源名称。使用您之前创建的RDS实例中的值填写以下参数:

    描述

    可选描述,可帮助您快速识别此数据库连接。

    数据库

    您之前创建的亚马逊RDS数据库。

    Server

    亚马逊终RDS端节点。

    端口

    Amazon RDS 端口。

    用户名称

    如 Amazon RDS 实例中所定义的那样。

    密码

    如 Amazon RDS 实例中所定义的那样。

  5. 选择 “测试” 以验证与 Amazon 的连接RDS是否成功,然后选择 “保存” 以保存您的新用户DSN。

  6. 等到看到确认已创建正确工作空间的消息,然后选择确定以完成ODBC数据源操作并关闭 ea_Admin 工具。

  7. 再次导航到应用程序选择器菜单,然后选择“Enterprise Analyzer”以启动该工具。选择新建

  8. 在工作区配置窗口中,输入您的工作区名称并定义其位置。如果您在此配置下工作,该工作区可以是基于 Amazon S3 的磁盘,也可以是您的主文件夹(如果需要)。

  9. 选择选择其他数据库以连接到您的 Amazon RDS 实例。

  10. 从选项中选择 Postgre 图标,然后选择确定

  11. 选项 – 定义连接参数下的 Windows 设置中,输入您创建的数据来源的名称。此外,输入数据库名称、架构名称、用户名和密码。选择确定

  12. 等待 Enterprise Analyzer 创建用于存储结果所需的所有表、索引等。此过程可能需要几分钟时间。Enterprise Analyzer 会确认数据库和工作区何时准备就绪可供使用。

  13. 再次导航到应用程序选择器菜单,然后选择“Enterprise Analyzer”以启动该工具。

  14. Enterprise Analyzer 启动窗口出现在新的所选工作区位置中。选择确定

  15. 在左侧窗格中,导航到存储库,选择存储库名称,然后选择向工作区添加文件/文件夹。选择存储应用程序代码的文件夹,将其添加到工作区。如果你愿意,你可以使用前面的 BankDemo示例代码。Enterprise Analyzer 提示您验证这些文件时,请选择验证以启动初始 Enterprise Analyzer 验证报告。该过程可能需要几分钟才能完成,具体取决于您的应用程序的大小。

  16. 展开工作区,以便查看已添加到工作区的文件和文件夹。对象类型和圈复杂度报告也显示在图表查看器窗格的上象限中。

现在,您可以使用 Enterprise Analyzer 来完成所有需要的任务。

后续会话

  1. 使用 AppStream 2.0 开始会话URL,使用你在 2. AppStream 0 的欢迎电子邮件中收到的。

  2. 使用您的电子邮件和永久密码登录。

  3. 选择 Enterprise Analyzer 堆栈。

  4. 启动 Rclone 以连接到 Amazon S3 支持的磁盘(如果您使用此选项共享工作区文件)。

  5. 启动 Enterprise Analyzer 来完成任务。

对工作区连接进行故障排除

当您尝试重新连接到 Enterprise Analyzer 工作区时,可能会看到类似如下错误:

Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location?

要解决此问题,请选择确定来清除消息,然后完成以下步骤。

  1. 在 AppStream 2.0 中,选择工具栏上的 “启动应用程序” 图标,然后选择 ea_admin 启动 Micro Focus En terprise Analyzer 管理工具。

    AppStream 2.0 启动选择器菜单,已选择 Micro Focus 企业分析器管理工具。
  2. 管理菜单中,选择刷新工作区路径...

    Micro Focus Enterprise Analyzer Administration 工具的“管理”菜单(已选择“刷新工作区路径...”)
  3. 选择工作区下,选择所需的工作区,然后选择确定

    Micro Focus Enterprise Analyzer Administration 工具的“选择工作区”对话框(已选择一个项目)。
  4. 选择确定,确认错误消息。

    选择 “确定” 后,Enterprise Analyzer 错误消息 “无法访问工作区目录”。
  5. 工作区目录网络路径下,输入工作区的正确路径,例如 D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3

    Enterprise Analyzer 对话框工作区目录网络路径以及示例路径。
  6. 关闭 Micro Focus Enterprise Analyzer Administration 工具。

    Micro Focus Enterprise Analyzer Administration 工具(已选择“关闭”按钮)。
  7. 在 AppStream 2.0 中,选择工具栏上的 “启动应用程序” 图标,然后选择 EA 启动 Micro Focus E nterprise Analyzer。

    选择 EA 时的 AppStream 2.0 启动应用程序图标。
  8. 重复步骤 3 – 5。

Micro Focus Enterprise Analyzer 此时应可使用现有工作区打开。

清理资源

如果您不再需要为本教程创建的资源,请将其删除,以免继续产生费用。完成以下步骤:

  • 使用 EA_Admin 工具删除工作区。

  • 删除您为本教程创建的 S3 存储桶。有关更多信息,请参阅《Amazon S3 用户指南》中的删除存储桶

  • 选择您为本教程创建的数据库。有关更多信息,请参阅删除数据库实例