AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 教程：在 WorkSpaces 应用程序上设置企业分析器
本教程介绍如何设置 Rocket Enterprise Analyzer（前身为 Micro Focus Enterprise Analyzer）来分析一个或多个 Enterprise Analyzer 工具可根据其对应用程序源代码和系统定义的分析提供多个报告。
此设置旨在促进团队协作。安装使用 Amazon S3 存储桶与虚拟磁盘共享源代码。这样做会在 Windows 计算机上使用 [Rclone](https://rclone.org/)。借助运行 [PostgreSQL](https://www.postgresql.org/) 的常用 Amazon RDS 实例，团队中的任何成员都可以访问所有请求的报告。
团队成员还可以将 Amazon S3 支持的虚拟磁盘挂载到个人机器上，并从其工作站更新源存储桶。如果他们连接到其他本地内部系统，还可以在其机器上使用脚本或任何其他形式的自动化。
该设置基于 AWS 大型机现代化与客户共享的 WorkSpaces 应用程序 Windows 映像。安装还基于 WorkSpaces 应用程序队列和堆栈的创建，如中所述。[教程：设置 WorkSpaces 应用程序以用于 Rocket Enterprise Analyzer 和 Rocket](set-up-appstream-mf.md)
**重要**
本教程中的步骤假设您使用可下载的 CloudFormation 模板 [cfn-m2-.ym](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) l 来设置 WorkSpaces 应用程序。appstream-fleet-ea-ed有关更多信息，请参阅 [教程：设置 WorkSpaces 应用程序以用于 Rocket Enterprise Analyzer 和 Rocket](set-up-appstream-mf.md)。
要执行本教程中的步骤，您必须设置 Enterprise Analyzer 实例集和堆栈，并且它们必须正在运行。
有关企业分析器功能和交付内容的完整描述，请参阅 Rocket Software（前身为 Micro Focus）网站上的[企业分析器文档](https://www.microfocus.com/documentation/enterprise-analyzer/)。
## 映像内容
除了 Enterprise Analyzer 应用程序本身之外，该映像还包含以下工具和库。
第三方工具
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC 驱动程序](https://odbc.postgresql.org/)
`C:\Users\Public` 中的库
+ BankDemo 企业开发者的源代码和项目定义:`m2-bankdemo-template.zip`.
+ 大型机的 MFA 安装包：`mfa.zip`。有关更多信息，请参阅《Micro Focus Enterprise Developer》**文档中的[大型机访问权限概述](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html)。
+ Rclone 的命令和配置文件（教程中的使用说明）：`m2-rclone.cmd` 和 `m2-rclone.conf`。
**Topics**
+ [映像内容](#set-up-ea-image-contents)
+ [先决条件](#tutorial-ea-prerequisites)
+ [步骤 1：设置](#tutorial-ea-step1)
+ [步骤 2：在 Windows 上创建基于 Amazon S3 的虚拟文件夹](#tutorial-ea-step2)
+ [步骤 3：为 Amazon RDS 实例创建 ODBC 源](#tutorial-ea-step3)
+ [后续会话](#tutorial-ea-step4)
+ [对工作区连接进行故障排除](#tutorial-ea-step5)
+ [清理 资源](#tutorial-ea-clean)
## 先决条件
+ 将您要分析的客户应用程序的源代码和系统定义上传到 S3 存储桶。系统定义包括 CICS CSD、 DB2 对象定义等。您可以在存储桶中创建一个文件夹结构，该结构表示您要如何组织应用程序构件。例如，解压缩 BankDemo 示例时，其结构如下：
```
demo
|--> jcl
|--> RDEF
|--> transaction
|--> xa
```
+ 创建并启动运行 PostgreSQL 的 Amazon RDS 实例 此实例将存储 Enterprise Analyzer 生成的数据和结果。您可以与应用程序团队的所有成员共享此实例。此外，在数据库中创建一个名为 `m2_ea`（或任何其他合适的名称）的空架构。为授权用户定义凭证，允许其创建、插入、更新和删除此架构中的项目。您可以从 Amazon RDS 控制台或从账户管理员处获取数据库名称、服务器端点 URL 和 TCP 端口。
+ 确保您已设置了对您的的编程访问权限 AWS 账户。有关更多信息，请参阅《Amazon Web Services 一般参考》**中的[编程访问](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)。
## 步骤 1：设置
1. 使用您在 WorkSpaces 应用程序的欢迎电子邮件中收到的 URL 开始与 WorkSpaces 应用程序的会话。
1. 使用您的电子邮件作为用户 ID，并定义您的永久密码。
1. 选择 Enterprise Analyzer 堆栈。
1. 在 “ WorkSpaces 应用程序” 菜单页面上，选择 “**桌面**” 以访问队列正在进行流式传输的 Windows 桌面。
## 步骤 2：在 Windows 上创建基于 Amazon S3 的虚拟文件夹
**注意**
如果您在 AWS 大型机现代化预览版中已经使用过 Rclone，则必须更新`m2-rclone.cmd`到位于中的较新版本。`C:\Users\Public`
1. 使用文件资源管理器将 `C:\Users\Public` 中提供的 `m2-rclone.conf` 和 `m2-rclone.cmd` 文件复制到您的主文件夹 `C:\Users\PhotonUser\My Files\Home Folder`。
1. 使用您的 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
```
1. 在 `m2-rclone.cmd` 中，进行以下更改：
+ 将 `amzn-s3-demo-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`。此同步目录必须是主文件夹的子目录， WorkSpaces 应用程序才能在会话开始和结束时对其进行正确备份和恢复。
```
:loop
timeout /T 10
"C:\Program Files\rclone\rclone.exe" sync m2-s3:{{amzn-s3-demo-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
```
1. 打开 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**。
1. 从**管理**菜单中，选择 **ODBC 数据来源**，然后从**用户 DSN** 选项卡中选择**添加**。
1. 在“创建新数据来源”对话框中，选择 **PostgreSQL Unicode** 驱动程序，然后选择**完成**。
1. 在 **PostgreSQL Unicode ODBC 驱动程序 (psqlODBC) 设置**对话框中，定义并记下所需的数据来源名称。使用您之前创建的 RDS 实例中的值填写以下参数：
**描述**
可选描述，可帮助您快速识别此数据库连接。
**数据库**
您之前创建的 Amazon RDS 数据库。
**服务器**
Amazon RDS 端点。
**端口：**
Amazon RDS 端口。
**用户名称**
Amazon RDS 实例中所定义的用户名称。
**密码**
Amazon RDS 实例中所定义的密码。
1. 选择**测试**以验证与 Amazon RDS 的连接是否成功，然后选择**保存**以保存您的新用户 DSN。
1. 等待直到看到确认创建了正确工作区的消息，然后选择**确定**以完成 ODBC 数据来源操作并关闭 EA\_Admin 工具。
1. 再次导航到应用程序选择器菜单，然后选择“Enterprise Analyzer”以启动该工具。选择**新建**。
1. 在工作区配置窗口中，输入您的工作区名称并定义其位置。如果您在此配置下工作，该工作区可以是基于 Amazon S3 的磁盘，也可以是您的主文件夹（如果需要）。
1. 选择**选择其他数据库**以连接到您的 Amazon RDS 实例。
1. 从选项中选择 **Postgre** 图标，然后选择**确定**。
1. 在**选项 – 定义连接参数**下的 Windows 设置中，输入您创建的数据来源的名称。此外，输入数据库名称、架构名称、用户名和密码。选择**确定**。
1. 等待 Enterprise Analyzer 创建用于存储结果所需的所有表、索引等。此过程可能需要几分钟时间。Enterprise Analyzer 会确认数据库和工作区何时准备就绪可供使用。
1. 再次导航到应用程序选择器菜单，然后选择“Enterprise Analyzer”以启动该工具。
1. Enterprise Analyzer 启动窗口出现在新的所选工作区位置中。选择**确定**。
1. 在左侧窗格中，导航到存储库，选择存储库名称，然后选择**向工作区添加文件/文件夹**。选择存储应用程序代码的文件夹，将其添加到工作区。如果你愿意，你可以使用前面的 BankDemo示例代码。Enterprise Analyzer 提示您验证这些文件时，请选择**验证**以启动初始 Enterprise Analyzer 验证报告。该过程可能需要几分钟才能完成，具体取决于您的应用程序的大小。
1. 展开工作区，以便查看已添加到工作区的文件和文件夹。对象类型和圈复杂度报告也显示在**图表查看器**窗格的上象限中。
现在，您可以使用 Enterprise Analyzer 来完成所有需要的任务。
## 后续会话
1. 使用您在 WorkSpaces 应用程序的欢迎电子邮件中收到的 URL 开始与 WorkSpaces 应用程序的会话。
1. 使用您的电子邮件和永久密码登录。
1. 选择 Enterprise Analyzer 堆栈。
1. 启动 `Rclone` 以连接到 Amazon S3 支持的磁盘（如果您使用此选项共享工作区文件）。
1. 启动 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. 在 “ WorkSpaces 应用程序” 中，选择工具栏上的 “**启动应用程序**” 图标，然后选择 **ea\_admin 以启动 En** terprise Analyzer 管理工具。
1. 从**管理**菜单中，选择**刷新工作区路径...**。
1. 在**选择工作区**下，选择所需的工作区，然后选择**确定**。
1. 选择**确定**，确认错误消息。
1. 在**工作区目录网络路径**下，输入工作区的正确路径，例如 `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`。
1. 关闭 Micro Focus Enterprise Analyzer Administration 工具。
1. 在 “ WorkSpaces 应用程序” 中，选择工具栏上的 “**启动应用程序**” 图标，然后选择 **EA 启动 Micro Focus E** nterprise Analyzer。
1. 重复步骤 3 – 5。
Micro Focus Enterprise Analyzer 此时应可使用现有工作区打开。
## 清理 资源
如果您不再需要为本教程创建的资源，请将其删除，以免继续产生费用。完成以下步骤：
+ 使用 **EA\_Admin** 工具删除工作区。
+ 删除您为本教程创建的 S3 存储桶。有关更多信息，请参阅《Amazon S3 用户指南》**中的[删除存储桶](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)。
+ 选择您为本教程创建的数据库。有关更多信息，请参阅[删除数据库实例](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)。