AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 为大型机运行时设置 AWS 转换 本节介绍在 AWS 基础架构上设置 Trans AWS form for 大型机运行时的步骤。在为应用程序设置 Tr AWS ansform for Mainframe Runtime 之前，请了解配置和管理运行时环境的先决条件、区域和存储分区以及 CloudWatch警报设置。 **Topics** + [AWS 针对大型机运行时先决条件进行转型](ba-runtime-setup-prereq.md) + [大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md) + [大型机运行时 AWS 转换的基础架构设置要求](ba-infrastructure-setup.md) + [AWS 针对大型机运行时工件进行转换](ba-runtime-artifacts.md) + [在 Amazon EC2 上为大型机运行时部署 AWS 转换](ba-deploy-ec2.md) + [在 Amazon ECS 和 Amazon EKS 上的容器上为大型机运行时部署 Tr AWS ansform](ba-deploy-container.md) + [测试 PlanetsDemo 应用程序](ba-runtime-test-planetsdemo.md) # AWS 针对大型机运行时先决条件进行转型 AWS 大型机运行时转换有多个[AWS 针对大型机发行说明进行转型](ba-release-notes.md)发行版本可用。如果您正在进行现代化项目，可能需要运行时的增量版本用于实现和测试目的。要确定您的需求，请联系您的大型机 AWS 转型交付经理。 在开始使用大型机运行时 AWS 转换之前，请执行以下操作： + 请确保您有一个 AWS 帐户。 + 确保使用适用于大型机的 Transform 重构了现代化的应用程序。 AWS + 选择一个 AWS 区域和一个支持大型机运行时 AWS 转换的计算选项。 + 选择要使用的大型机 AWS 转换运行时版本。 + 审查[大型机运行时 AWS 转换的基础架构设置要求](ba-infrastructure-setup.md)并验证运行大型机运行时 AWS 转换所需的其他组件。 **注意** 如果你想测试适用于大型机运行时的 Tr AWS ansform 的功能，你可以使用演示应用程序`Planets Demo`，你可以从 [PlanetsDemo-v1.zip](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) 下载该应用程序。 # 大型机运行时的入门 AWS 转换 **注意** 大型机运行时访问权限的 AWS 转换已从基于票证的请求转变为通过 AW [S Tran](https://bluinsights.aws/) sform 直接下载进行大型机重构。我们引入了一种新的简化方法，可通过 AWS Transform 中的[AWS Transform for mainframe工具箱](https://bluinsights.aws/docs/bluage-toolbox-introduction)功能访问AWS Transform for mainframe产品，用于大型机重构。 首先，请创建一个[AWS 支持](https://support.console.aws.amazon.com/support/home)案例以请求入门以访问适用于大型机运行时的 Tr AWS ansform。在您的请求中包括您的 AWS 账户 ID、您要使用的 AWS 区域和计算选项，以及针对大型机运行时版本的 AWS 转换。如果您不确定需要哪个版本，请联系您的大型机Trans AWS form交付经理。如果您已经有了由 AWS 大型机现代化重构工具生成的应用程序的代码源，请将`gapwalk.version`标签值记入现代化代码`pom.xml`库中的文件中。 **注意** 大型机运行时的 Tr AWS ansform 有两种主要版本：Alpha 预发行版和发行版。要确定要使用哪个版本，请查看[AWS 为大型机版本控制进行转换](ba-versioning.md)或联系您的 Trans AWS form 大型机交付经理。 ## 大型机运行时 AWS 转换的区域和分区 我们按地区和计算选择将大型机运行时 AWS 转换项目存储在不同的 Amazon S3 存储桶中。要访问适用于大型机运行时的 AWS 区域 Tr AWS ansform 的存储桶，请使用下表中列出的名称。 | AWS 区域 | 发行版存储桶 | Alpha 预发行版存储桶 | | --- | --- | --- | | 美国东部（俄亥俄州） | aws-bluage-runtime-artifacts-055777665268-us-east-2 | aws-bluage-runtime-artifacts-dev-055777665268-us-east-2 | | 美国东部（弗吉尼亚州北部） | aws-bluage-runtime-artifacts-139023371234-us-east-1 | aws-bluage-runtime-artifacts-dev-139023371234-us-east-1 | | 美国西部（北加利福尼亚） | aws-bluage-runtime-artifacts-788454048782-us-west-1 | aws-bluage-runtime-artifacts-dev-788454048782-us-west-1 | | 美国西部（俄勒冈州） | aws-bluage-runtime-artifacts-836771190483-us-west-2 | aws-bluage-runtime-artifacts-dev-836771190483-us-west-2 | | 加拿大（中部） | aws-bluage-runtime-artifacts-637423580979-ca-central-1 | aws-bluage-runtime-artifacts-dev-637423580979-ca-central-1 | | 欧洲地区（爱尔兰） | aws-bluage-runtime-artifacts-925278190477-eu-west-1 | aws-bluage-runtime-artifacts-dev-925278190477-eu-west-1 | | 欧洲地区（伦敦） | aws-bluage-runtime-artifacts-767397831990-eu-west-1 | aws-bluage-runtime-artifacts-dev-767397831990-eu-west-1 | | 欧洲地区（巴黎） | aws-bluage-runtime-artifacts-673009995881-eu-west-3 | aws-bluage-runtime-artifacts-dev-673009995881-eu-west-3 | | 欧洲地区（法兰克福） | aws-bluage-runtime-artifacts-485196800481-eu-central-1 | aws-bluage-runtime-artifacts-dev-485196800481-eu-central-1 | | 欧洲地区（斯德哥尔摩） | aws-bluage-runtime-artifacts-654654484534-eu-north-1 | aws-bluage-runtime-artifacts-dev-654654484534-eu-north-1 | | 欧洲地区（米兰） | aws-bluage-runtime-artifacts-654654328338-eu-south-1 | aws-bluage-runtime-artifacts-dev-654654328338-eu-south-1 | | 欧洲（西班牙） | aws-bluage-runtime-artifacts-905417994954-eu-south-2 | aws-bluage-runtime-artifacts-dev-905417994954-eu-south-2 | | 南美洲（圣保罗） | aws-bluage-runtime-artifacts-737536804457-sa-east-1 | aws-bluage-runtime-artifacts-dev-737536804457-sa-east-1 | | 亚太地区（东京） | aws-bluage-runtime-artifacts-445578176276-ap-northeast-1 | aws-bluage-runtime-artifacts-dev-445578176276-ap-northeast-1 | | 亚太地区（首尔） | aws-bluage-runtime-artifacts-381492221498-ap-northeast-2 | aws-bluage-runtime-artifacts-dev-381492221498-ap-northeast-2 | | 亚太地区（大阪） | aws-bluage-runtime-artifacts-905418229615-ap-northeast-3 | aws-bluage-runtime-artifacts-dev-905418229615-ap-northeast-3 | | 亚太地区（新加坡） | aws-bluage-runtime-artifacts-767397774613-ap-southeast-1 | aws-bluage-runtime-artifacts-dev-767397774613-ap-southeast-1 | | 亚太地区（悉尼） | aws-bluage-runtime-artifacts-726160321909-ap-southeast-2 | aws-bluage-runtime-artifacts-dev-726160321909-ap-southeast-2 | | 亚太地区（孟买） | aws-bluage-runtime-artifacts-905418353577-ap-south-1 | aws-bluage-runtime-artifacts-dev-905418353577-ap-south-1 | | 非洲（开普敦） | aws-bluage-runtime-artifacts-992382777663-af-south-1 | aws-bluage-runtime-artifacts-dev-992382777663-af-south-1 | | 以色列（特拉维夫） | aws-bluage-runtime-artifacts-471112516508-il-central-1 | aws-bluage-runtime-artifacts-dev-471112516508-il-central-1 | ## 使用列 AWS CLI 出存储桶中的内容 登录后，您可以在终端中运行以下 AWS CLI 命令来列出存储桶的内容。 `aws s3 ls bucket-name ` `bucket-name`替换为上表 AWS 区域 中您的存储桶的名称。 此命令返回与不同版本的大型机 Trans AWS form Runtime 运行时相对应的文件夹列表，例如 Release 存储桶的以下文件夹： ``` PRE 4.0.0/ PRE 4.10.0/ ``` 或者以下列表对应于构建存储桶： ``` PRE 4.11.0/ PRE 4.13.0/ ``` 建议您使用最新可用版本。如果不能，请使用在应用程序重构阶段验证过的运行时版本。要列出特定版本的可用框架，请运行以下命令： `aws s3 ls s3://bucket-name/version/Framework/` `bucket-name`替换为你的存储桶`version`名称 AWS 区域 和你想要的版本。下面是两个示例： 对于发行版存储桶： `aws s3 ls s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.10.0/Framework/` 该命令返回 zip 文件列表，例如： ``` 2025-04-08 16:11:19 152040176 aws-bluage-runtime-4.10.0.zip 2025-04-08 16:11:52 176518889 aws-bluage-webapps-4.10.0.zip ``` 对于 Alpha 预发行版存储桶： `aws s3 ls s3://aws-bluage-runtime-artifacts-dev-139023371234-us-east-1/4.11.0/Framework/` 该命令返回 zip 文件列表，例如： ``` 2025-04-09 20:23:34 152304534 aws-bluage-runtime-4.11.0.zip 2025-04-09 20:24:07 176262381 aws-bluage-webapps-4.11.0.zip ``` ## 下载框架 例如，您可以下载该框架来升级现有 Amazon EC2 实例上的大型机 AWS 转换运行时版本。 `aws s3 cp s3://bucket-name/version/Framework/ folder-of-your-choice --recursive ` 其中： folder-of-your-choice 要下载框架的文件夹路径。 例如：`aws s3 cp s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/ . --recursive` 此命令将生成以下输出： ``` download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-webapps-4.0.0.zip to ./aws-bluage-webapps-4.0.0.zip download: s3://aws-bluage-runtime-artifacts-139023371234-us-east-1/4.0.0/Framework/aws-bluage-runtime-4.0.0.zip to ./aws-bluage-runtime-4.0.0.zip ``` 您可以使用如下命令列出框架文件： `ls -l` 此命令将生成以下输出： ``` total 230928 -rw-rw-r-- 1 cloudshell-user cloudshell-user 152040176 Apr 8 16:11 aws-bluage-runtime-4.0.0.zip -rw-rw-r-- 1 cloudshell-user cloudshell-user 176518889 Apr 8 16:11 aws-bluage-webapps-4.0.0.zip ``` **注意** 出于安全考虑，对工件的访问可能会暂时中断，版本可能会被删除。我们强烈建议您将使用的工件存储在自己的账户中。在您的内部架构中应使用本地版本作为参考。 # 大型机运行时 AWS 转换的基础架构设置要求 本主题介绍运行 Transform for 大型机运行 AWS 时所需的最低基础架构配置。以下过程描述了如何在您选择的计算机上设置 Tr AWS ansform for 大型机运行时，以便在大型机运行时的 Tr AWS ansform 上部署现代化的应用程序。您创建的资源必须位于具有专用于您的应用程序域的子网的 Amazon VPC 中。 **Topics** + [基础设施要求](#infrastructure-requirements) + [在 Amazon EC2 上运行大型机运行时 AWS 转换](#ba-running-on-ec2) + [在 Amazon EC2 上的 Amazon ECS 上运行大型机运行时 AWS 转换](#ba-running-on-ecs-on-ec2) + [在亚马逊 EKS、亚马逊 EC2 上运行大型机运行时 AWS 转换](#ba-running-on-eks-on-ec2) + [在 Amazon ECS 上运行适用于大型机运行时的 Tr AWS ansform 由 AWS Fargate](#ba-running-on-fargate) ## 基础设施要求 **创建安全组** 如果您计划在 Amazon EKS 上使用 Amazon EC2 实例，请跳过此过程，因为 Amazon EKS 集群创建过程会代表您创建一个安全组。请在以下过程中使用该安全组，而不是创建新的安全组。 1. 打开位于 [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) 的 Amazon VPC 控制台。 1. 在左侧导航窗格中的**安全**下，选择**安全组**。 1. 在中央窗格中，选择**创建安全组**。 1. 在**安全组名称**字段中，输入 **M2BluagePrivateLink-SG**。 1. 在**入站规则**部分中，选择**添加规则**。 1. 对于**类型**，选择 HTTPS。 1. 对于**源**，请输入您的 VPC CIDR。 1. 在**出站规则**部分，选择**添加规则**。 1. 对于**类型**，选择 HTTPS。 1. 在**目标位置**字段，输入 **0.0.0.0/0**。 1. 选择**创建安全组**。 **创建一个 IAM 角色** 1. 使用 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 打开 IAM 控制台。 1. 在左侧导航窗格中的**访问权限管理**下，选择**角色**。 1. 在中央窗格中，选择**创建角色**。 1. 在**用例**部分，根据您的计算方案，选择以下选项之一： + **EC2**（适用于 Amazon EC2 和 Amazon EC2 上的 Amazon EKS） + **Elastic Container Service**，然后是**适用于 Elastic Container Service 的 EC2 角色**（适用于 Amazon EC2 上的 Amazon ECS） + **Elastic Container Service**，然后是 **Elastic Container Service 任务**（适用于由 Fargate 管理的 Amazon ECS） 1. 选择**下一步**。 1. 输入角色的名称，然后选择**创建角色**。 ## 在 Amazon EC2 上运行大型机运行时 AWS 转换 请按照以下步骤创建 Amazon EC2 实例。 **创建 Amazon EC2 实例** 1. 打开位于 [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 的 Amazon EC2 控制台。 1. 选择**启动实例**。 1. 对于**实例类型**，选择 EC2 可用实例类型。 1. 在**密钥对**部分中，选择现有密钥对或创建新密钥对。 1. 在**网络设置**部分，选择**选择现有安全组**。 1. 对于**通用安全组**，请选择 **M2-BluagePrivateLink SG**。 1. 展开**高级详细信息**部分。 1. 对于 **IAM 实例配置文件**，选择您前面创建的 IAM 角色。 1. 选择**启动实例**。 **在 Amazon EC2 实例上安装应用程序** 1. 当 Amazon EC2 实例的状态变为**正在运行**时，请连接到该实例。 1. 在实例上安装以下软件组件（请参阅中提及的版本[AWS 针对大型机发行说明进行转型](ba-release-notes.md)）： + Java 运行时环境 (JRE)。 + Apache Tomcat。 + AWS 针对大型机运行时进行转换（在 Amazon EC2 上）。在 Apache Tomcat 安装文件夹的根目录下安装适用于大型机运行时的 AWS 转换（有些文件将被添加，而其他文件将被覆盖）。 要安装与 Tr AWS ansform for 大型机运行时存档一起提供的其他 Web 应用程序，请设置 Apache Tomcat 服务器的辅助实例，然后在该位置解压缩 webapps 存档。有关详细说明，请参阅[AWS 针对大型机运行时工件进行转换](ba-runtime-artifacts.md)。 ## 在 Amazon EC2 上的 Amazon ECS 上运行大型机运行时 AWS 转换 1. 创建 Amazon ECS 集群，并将 **Amazon EC2 实例**作为底层基础设施。请参阅《Amazon Elastic Container Service 开发人员指南》中的 [Amazon EC2 上的 Windows 入门](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-ecs-ec2-v2.html#getting-started-ec2-cluster-v2)。 1. 指定在前面的步骤中创建的 IAM 角色。 1. 选择 EC2 实例类型。 1. 在 **Amazon EC2 实例的网络设置**中，选择在前面的步骤中创建的安全组。 ## 在亚马逊 EKS、亚马逊 EC2 上运行大型机运行时 AWS 转换 1. 创建一个 Amazon EKS 集群。请参阅《Amazon EKS 用户指南》**中的[创建 Amazon EKS 集群](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html)。 1. 如前所述，系统会代表您创建一个安全组。 1. 创建节点组。指定在前面的步骤中创建的 IAM 角色。 1. 选择 EC2 实例类型。 1. Amazon EKS 会自动将该安全组分配给生成的 Amazon EC2 实例。 ## 在 Amazon ECS 上运行适用于大型机运行时的 Tr AWS ansform 由 AWS Fargate 创建以 **AWS Fargate（无服务器）**作为底层基础设施的 Amazon ECS 集群。请参阅《Amazon Elastic Container Service 开发人员指南》**中的 [Fargate 入门](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html)。 # AWS 针对大型机运行时工件进行转换 AWS 大型机转型运行时工件是用于部署和运行现代化应用程序的组件。本文档概述了不同类型的可用对象、它们的存储位置以及如何访问它们。 ## AWS 针对大型机运行时工件进行转换 ### 文物内容 在发行版和预发行版中，你会发现： **gapwalk-x.y.z.z.zip** 此存档中 x.y.z 表示版本号（有关大型机版本[控制，请参阅AWS 转换），其中包含对大型](https://docs.aws.amazon.com/m2/latest/userguide/ba-versioning.html)机应用程序执行 AWS AWS 转换所必需的核心转换运行时组件，包括： | Artifact | 说明 | Type | 分发文件夹 | | --- | --- | --- | --- | | gapwalk-application-x.y.z.war | AWS Transform for mainframe主网络应用程序 Gap walk | 战争 | webapps | | \$1.jar | AWS Transform for mainframe运行时框架共享库 (Gapwalk) | 罐子 | 共享 | | gapwalk-\$1-x.y.z.war | AWS Transform for mainframe其他 Web 应用程序（Utility-pgm、分层支持...） | 战争 | 网络应用程序额外版 | | bac-x.y.z.war /jac-x.y.z.war | AWS Transform for mainframe管理控制台（非独立控制台） | 战争 | 网络应用程序控制台 | **aws-bluage-webapps-x.y.z.zip** 此存档中 x.y.z 遵循与上述相同的版本控制方案，包括AWS Transform for mainframe管理控制台（独立版） + **BAC**（Blusam控制台）WAR 文件，用于监控Blusam数据库。 + **JAC**（JICS 控制台）WAR 文件，用于监视 JICS 数据库。 + 必要的支持库。 ### Package 签名验证 已发布的 zip 文件以数字签名的 ZIP 存档形式提供，以确保安全性和真实性。数字签名有助于验证您下载的文件是真实的、未经修改的，并且是由我们的组织正式发布的。这样可以防止篡改，并防范可能被恶意分发的恶意软件或受损文件。 要在使用 ZIP 文件之前验证其签名，可以使用以下命令： `jarsigner -verify -certs -verbose aws-bluage-runtime-x.y.z.zip` 以下是认证文件的结果示例： ``` ... jar verified. ``` 有关如何解决安全漏洞的详细信息，请参阅[带有AWS Transform for mainframe版本概述的 AWS 大型机现代化重构](https://docs.aws.amazon.com/m2/latest/userguide/lifecycle-m2.html#lifecycle-ba-overview)。 **注意** 虽然我们努力发布不带新产品的产品 CVEs，但以后 CVEs 可能会出现新的产品。 # 在 Amazon EC2 上为大型机运行时部署 AWS 转换 您可以通过本节中的主题学习如何在 Amazon EC2 上为大型机运行时设置 AWS 转换、如何更新运行时版本、如何使用 Amazon CloudWatch 警报监控您的部署，以及如何添加许可依赖项。这些说明适用于创建 Amazon EC2 实例，以及在 Amazon EC2 上使用 Amazon ECS 或在 Amazon EC2 上使用 Amazon EKS 的情况。 从 alpha 版本 5.60.0 开始，大型机运行时 AWS 转换发行版包括一个包含全面的 README.md 文件的部署文件夹。本指南提供了 step-by-step Amazon EC2 部署说明、配置选项和故障排除技巧。 **Topics** + [在 Amazon EC2 上为大型机运行时设置 AWS 转换](ba-runtime-deploy-ec2.md) + [在 Amazon EC2 上升级大型机运行时的 AWS 转换](ba-runtime-maint-ec2.md) + [为大型机运行时设置 AWS Transform（在 Amazon EC2 上）Amaz CloudWatch on 警报](ba-cw-alarms-ec2.md) + [在 Amazon EC2 上的 “大型机运行时 AWS 转换” 中设置许可依赖关系](ba-runtime-dependencies-ec2.md) # 在 Amazon EC2 上为大型机运行时设置 AWS 转换 本主题介绍如何在 Amazon EC2 上使用大型机运行时 AWS 转换来设置和部署 PlanetsDemo 示例应用程序。 **Topics** + [先决条件](#ba-runtime-deploy-prereq) + [设置](#ba-runtime-deploy-setup) + [测试部署的应用程序](#ba-runtime-deploy-test) ## 先决条件 在开始之前，请确保满足以下先决条件： + AWS CLI 按照配置 [AWS CLI 中的步骤进行配置](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。 + 完成 [AWS 针对大型机运行时先决条件进行转型](ba-runtime-setup-prereq.md)和[大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。 + 使用某个受支持的实例类型创建 Amazon EC2 实例。有关更多信息，请参阅 [Amazon EC2 Linux 实例入门](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)。 + 确保您可以成功连接到 Amazon EC2 实例，例如使用 SSM。 **注意** 在本指南中，假设 Tomcat 的安装路径为。`/m2-anywhere/tomcat-gapwalk/velocity`在按照以下说明进行操作时，请确保使用此路径，或者根据您选择的路径调整以下指令。 + 直接下载大型机运行时 AWS 变换（在 Amazon EC2 上）并将其提取到 velocity 目录`/m2-anywhere/tomcat-gapwalk/velocity`（Tomcat 安装文件夹）。有关如何检索适用于大型机的 Tr AWS ansform Runtime 工件（包括有关存储、访问和内容的信息）的说明，请参阅[AWS 针对大型机运行时工件进行转换](ba-runtime-artifacts.md)。 + 下载[PlanetsDemo应用程序档案](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip)。 + 解压缩存档文件，并将应用程序上传到您选择的 Amazon S3 存储桶。 + 为 JICS 创建亚马逊 Aurora PostgreSQL 数据库。大型机运行时 AWS 转换将在首次启动时自动执行`PlanetsDemo-v1/jics/sql/initJics.sql`脚本。有关如何创建 Amazon Aurora PostgreSQL 数据库的信息，请参阅[创建并连接到 Aurora PostgreSQL 数据库集群](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster)。 ## 设置 要设置 PlanetsDemo 示例应用程序，请完成以下步骤。 1. 连接到您的亚马逊 EC2 实例，然后转到 Apache Tomcat 安装`conf`文件夹下的文件夹。打开 `catalina.properties` 文件进行编辑，将以 `common.loader` 开头的行替换为以下行。 ``` common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar" ``` 1. 导航到 `/m2-anywhere/tomcat-gapwalk/velocity/webapps`文件夹。 1. 使用以下命令从 Amazon S3 存储桶中复制`PlanetsDemo-v1/webapps/`文件夹中可用的 PlanetsDemo 二进制文件。 ``` aws s3 cp s3://path-to-demo-app-webapps/ . --recursive ``` **注意** `path-to-demo-app-webapps`替换为之前解压缩存档的存储桶的正确 Amazon S3 URI。 PlanetsDemo 1. 将 `PlanetsDemo-v1/config/` 文件夹的内容复制到 `/m2-anywhere/tomcat-gapwalk/velocity/config/`。 1. 在 `/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml` 文件的以下代码段中，提供作为先决条件一部分而创建的数据库的连接信息。有关更多信息，请参阅[创建并连接到 Aurora PostgreSQL 数据库集群](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster)。 ``` datasource: jicsDs: driver-class-name : url: username: password: type : ``` 1. 启动您的 Apache Tomcat 服务器并验证日志。 ``` /m2-anywhere/tomcat-gapwalk/velocity/startup.sh tail -f /m2-anywhere/tomcat-gapwalk/velocity/logs/catalina.log ``` 如果您发现以 C 后跟数字开头的错误代码（例如 CXXXX），请记下错误消息。例如，错误代码 C5102 是一个常见错误，表示基础设施配置不正确。 ## 测试部署的应用程序 有关如何测试 PlanetsDemo 应用程序的示例，请参阅[测试 PlanetsDemo 应用程序](ba-runtime-test-planetsdemo.md)。 # 在 Amazon EC2 上升级大型机运行时的 AWS 转换 本指南介绍如何在 Amazon EC2 上升级大型机运行时的 AWS 转换。 **Topics** + [先决条件](#ba-runtime-maint-prereq) + [升级 Amazon EC2 实例中的大型机运行时 AWS 转换](#ba-runtime-maint-copy-files) + [升级容器中大型机运行时的 AWS 转换](#ba-runtime-maint-copy-files) ## 先决条件 在开始之前，确保满足以下先决条件： + 要查看是否有针对您的版本的特定说明，请参阅 [适用于大型机的 Trans AWS form 的升级说明](ba-migration-notes.md)。 + 完成 [AWS 针对大型机运行时先决条件进行转型](ba-runtime-setup-prereq.md)和[大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。 + 确保您的 Amazon EC2 实例已安装大型机运行时 AWS 转换。有关更多信息，请参阅 [Amazon EC2 Linux 实例入门](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)。 + 确保您可以成功连接到 Amazon EC2 实例，例如使用 SSM。 + 下载要升级到的大型机 AWS 转换运行时版本。该框架由两个存档文件组成：`gapwalk-x.y.z.zip`和`aws-bluage-webapps-x.y.z.zip`。有关更多信息，请参阅 [AWS 针对大型机运行时工件进行转换](ba-runtime-artifacts.md)。 ## 升级 Amazon EC2 实例中的大型机运行时 AWS 转换 完成以下步骤以升级大型机运行时的 AWS 转换。 1. 通过运行以下命令连接到您的 Amazon EC2 实例并将用户更改为 **su**。 ``` sudo su ``` 您需要超级用户权限才能运行本教程中的命令。 1. 使用以下命令提取二进制文件。运行每个文件夹中的命令。 ``` unzip gapwalk-x.y.z.zip unzip aws-bluage-webapps-x.y.z.zip ``` 1. 使用以下命令以停止 Apache Tomcat 服务。 ``` systemctl stop tomcat.service systemctl stop tomcat-webapps.service ``` 1. 将 `/shared/` 的内容替换为 `gapwalk-x.y.z/shared/` 的内容。 1. 将 `/webapps/gapwalk-application.war`替换为 `gapwalk-x.y.z/webapps/gapwalk-application.war`。 1. 将 `/webapps/` 中的 war 文件（即 `bac.war` 和 `jac.war`）替换为 `aws-bluage-webapps-x.y.z/velocity/webapps/` 中的相同文件。 1. 运行以下命令来启动 Apache Tomcat 服务。 ``` systemctl start tomcat.service systemctl start tomcat-webapps.service ``` 1. 检查日志。 运行以下命令来查看部署的应用程序的状态。 ``` curl http://localhost:8080/gapwalk-application/ ``` 将会出现以下消息。 ``` Jics application is running ``` ``` curl http://localhost:8181/jac/api/services/rest/jicsservice/ ``` 将会出现以下消息。 ``` Jics application is running ``` ``` curl http://localhost:8181/bac/api/services/rest/bluesamserver/serverIsUp ``` 响应应为空。 大型机 AWS 转换运行时已成功升级。 ## 升级容器中大型机运行时的 AWS 转换 完成以下步骤以升级大型机运行时的 AWS 转换。 1. 使用所需的大型机 AWS 转换运行时版本重建 Docker 镜像。有关说明，请参阅[在 Amazon EC2 上为大型机运行时设置 AWS 转换](ba-runtime-deploy-ec2.md)。 1. 将 Docker 映像推送到 Amazon ECR 存储库。 1. 停止并重启 Amazon ECS 或 Amazon EKS 服务。 1. 检查日志。 大型机运行时 AWS 转换已成功升级。 # 为大型机运行时设置 AWS Transform（在 Amazon EC2 上）Amaz CloudWatch on 警报 您可以设置 CloudWatch 为接收应用程序日志，并添加警报以警告您可能出现的错误。这样，在部署的应用程序遇到异常时，您就可以收到更多可见的通知。以下各节可帮助您了解和了解 CloudWatch 日志和警报设置的配置。 ## 启用 CloudWatch 日志记录 要启用 CloudWatch 日志记录，请使用下一节中提供的配置模板在 config 文件夹中创建一个`logback-cloudwatch.xml`文件。然后，通过取消注释以下几行来引用`application-main.yml`文件中的此文件： ``` # logging: # config: classpath:logback-cloudwatch.xml ``` 取消注释这些行后，将激活 CloudWatch 日志记录，并且可以按照以下各节中的说明进行进一步配置。 ## CloudWatch 日志配置 使用以下模板创建`logback-cloudwatch.xml`文件： ``` %date{yyyy-MM-dd HH:mm:ss.SSS,UTC} %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable BluAgeRuntimeOnEC2-Logs %date{yyyy-MM-dd,UTC}.%instanceId.%uuid %date{yyyy-MM-dd HH:mm:ss.SSS,UTC} %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable ``` 元素之外的所有内容均为标准 logback 配置。此文件中有两个附加程序：用于向控制台发送日志的控制台附加程序和用于向其发送日志的 CloudWatch 附加程序。 CloudWatch `root` 元素中的 `level` 属性指定了整个应用程序的日志记录级别。 标签 中的必需值包括： + :在中设置日志组的 CloudWatch名称。如果未指定，则默认值为 `BluAgeRuntimeOnEC2-Logs`。如果日志组不存在，系统将自动创建。可以通过配置来更改此行为，具体内容将在下文中介绍。 + ：在中设置日志流（在日志组内）的名称。 CloudWatch 可选值： + ：覆盖将写入日志流的区域。默认情况下，日志会被写入 EC2 实例所在区域。 + ：日志消息将使用的模式。 + ：每个操作要发送到的最大日志消息 CloudWatch 数。 + ：允许写入 CloudWatch 日志的时间（以毫秒为单位）。 + ：尝试在内部日志队列中插入请求的时间（以毫秒为单位）。 + ：内部队列的最大大小。 + ：创建日志组和日志流（如果不存在）。 + : 您希望线程在启动时处于睡眠状态的时间。该初始等待时间允许日志的初始累积。 + ：日志事件的最大大小。超过此大小的日志将不会被发送。 + ：截断过长的消息。 + ：启用紧急 Appender。 ## CloudWatch 设置 为了使上述配置能够正确推送日志 CloudWatch，请更新您的 Amazon EC2 IAM 实例配置文件角色，以授予其对 `BluAgeRuntimeOnEC2-Logs` 日志组及其日志流的额外权限： + `logs:CreateLogStream` + `logs:DescribeLogStreams` + `logs:CreateLogGroup` + `logs:PutLogEvents` + `logs:DescribeLogGroups` ## 警报设置 借助 CloudWatch 日志，您可以根据应用程序和需求配置不同的指标和警报。具体而言，您可以为使用情况设置主动警报，以便在出现可能使您的应用程序处于宽限期（最终使其完全无法运行）的错误时收到警告。为此，您可以在日志中添加一个有关 “错误 C5001” 字符串的指标，该指标突出显示了与大型机 AWS 转换控制系统连接中的错误。然后，您可以定义一个对此指标做出反应的警报。 # 在 Amazon EC2 上的 “大型机运行时 AWS 转换” 中设置许可依赖关系 本指南介绍如何在 Amazon EC2 上设置可与 Transform fo AWS r 大型机运行时一起使用的其他许可依赖项。 **Topics** + [先决条件](#ba-runtime-dependencies-prereq) + [安装步骤](#ba-runtime-dependencies-overview) ## 先决条件 在开始之前，请确保满足以下先决条件： + 完成 [AWS 针对大型机运行时先决条件进行转型](ba-runtime-setup-prereq.md)和[大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。 + 确保您有一个安装了大型机运行时 AWS 转换的 Amazon EC2 实例（在 Amazon EC2 上）。有关更多信息，请参阅 [Amazon EC2 Linux 实例入门](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)。 + 确保您可以成功连接到 Amazon EC2 实例，例如使用 SSM。 + 从相应源中获取以下依赖项。 ### Oracle 数据库 提供 [Oracle 数据库驱动程序](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html)。我们使用版本 **ojdbc11-23.3.0.23.09.j** ar 测试了大型机运行时 AWS 转换（在 Amazon EC2 上）功能，但可能兼容更新的版本。 ### IBM MQ 连接 提供一个 [IBM MQ 客户端](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients)。我们使用 **com.ibm.mq.jakarta.client-9.3.4.1.jakarta.client-9.3.4.1.jar 版本测试了大型机运行时 AWS 转换（在 Amazon EC2 上）功能，但最新版本可能兼容**。 使用此依赖项版本时，还要提供以下传递依赖项： + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15to18-1.76.jar + bcutil-jdk15to18-1.76.jar ### DDS 打印机文件 提供 Jasper 报告库（m https://com unity.jaspersoft。 com/download-jaspersoft/community-版）。我们使用 j **asperreports-6.16.0.jar** 测试了大型机运行时 AWS 转换（在 Amazon EC2 上）功能，但可能兼容更新的版本。 使用此依赖项版本时，还要提供以下传递依赖项： + castor-core-1.4.1.jar + castor-xml-1.4.1.jar + commons-digester-2.1.jar + ecj-3.21.0.jar + itext-2.1.7.js8.jar + javax.inject-1.jar + jcommon-1.0.23.jar + jfreechart-1.0.19.jar + commons-beanutils-1.9.4.jar + commons-collections-3.2.2.jar ## 安装步骤 要安装依赖项，请完成以下步骤。 1. 通过运行以下命令连接到您的 Amazon EC2 实例并将用户更改为 **su**。 ``` sudo su ``` 您需要超级用户权限才能运行本教程中的命令。 1. 导航到 `/extra/`文件夹。 ``` cd /extra/ ``` 1. 根据需要将上述任何依赖项复制到此文件夹。 **注意** 对于具有 Oracle 托管数据库的 JAC 和 BAC Web 应用程序，请确保在此文件夹中包含 Oracle 数据库驱动程序 (ojdbc)。 1. 通过运行以下命令停止和启动 tomcat.service。 ``` systemctl stop tomcat.service ``` ``` systemctl start tomcat.service ``` 1. 检查该服务的状态，确保其正在运行。 ``` systemctl status tomcat.service ``` 1. 验证日志。 # 在 Amazon ECS 和 Amazon EKS 上的容器上为大型机运行时部署 Tr AWS ansform 您可以使用本节中的主题来学习如何在容器上设置大型机运行时 AWS 转换以将其部署在 Amazon ECS（由 Amazon EC2 管理或 AWS Fargate）和由 Amazon EC2 管理的 Amazon EKS 上，如何更新运行时版本，如何使用亚马逊 CloudWatch 警报监控您的部署，以及如何添加许可依赖项。 **注意** 这与由管理的 Amazon EKS 不兼容 AWS Fargate。 **Topics** + [在容器上为大型机运行时设置 AWS 转换](ba-runtime-deploy-container.md) + [在容器上升级大型机运行时的 AWS 转换](ba-runtime-maint-container.md) + [为容器上的大型机运行时 AWS 转换设置 Amazon CloudWatch 警报](ba-cw-alarms-container.md) + [在容器上的 Trans AWS form for 大型机运行时中设置许可的依赖关系](ba-runtime-dependencies-container.md) # 在容器上为大型机运行时设置 AWS 转换 本主题介绍如何在 docker 容器上使用 Tr AWS ansform for 大型机运行时设置和部署 PlanetsDemo 示例应用程序。 AWS 容器上的大型机运行时转换适用于由亚马逊 EC2 管理的 Amazon ECS、由管理的 Amazon ECS 和由 AWS Fargate亚马逊 EC2 管理的 Amazon EKS。它与由管理的 Amazon EKS 不兼容 AWS Fargate。 **Topics** + [先决条件](#ba-runtime-deploy-prereq) + [设置](#ba-runtime-deploy-setup) + [测试部署的应用程序](#ba-runtime-deploy-test) ## 先决条件 在开始之前，请确保满足以下先决条件： + AWS CLI 按照配置 [AWS CLI 中的步骤进行配置](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。 + 完成 [AWS 针对大型机运行时先决条件进行转型](ba-runtime-setup-prereq.md)和[大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。 + 下载适用于大型机的 AWS 转换运行时二进制文件。有关说明，请参阅[大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。 + 下载 Apache Tomcat 二进制文件。 + 下载[PlanetsDemo应用程序档案](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip)。 + 为 JICS 创建一个 Amazon Aurora PostgreSQL 数据库，然后对其运行 `PlanetsDemo-v1/jics/sql/initJics.sql` 查询。有关如何创建 Amazon Aurora PostgreSQL 数据库的信息，请参阅[创建并连接到 Aurora PostgreSQL 数据库集群](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster)。 ## 设置 要设置 PlanetsDemo 示例应用程序，请完成以下步骤。 1. 下载 Apache Tomcat 二进制文件后，解压缩内容并转到 `conf` 文件夹。打开 `catalina.properties` 文件进行编辑，将以 `common.loader` 开头的行替换为以下行。 ``` common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar" ``` 1. 使用 tar 命令压缩 Apache Tomcat 文件夹以构建 “tar.gz”归档。 1. 准备一个 [Dockerfile](https://docs.docker.com/engine/reference/builder/)，用于根据提供的运行时二进制文件和 Apache Tomcat 服务器二进制文件构建您的自定义映像。请见以下示例 Dockerfile。目标是安装 Apache Tomcat，然后安装在 Apache Tomcat 安装目录根目录中提取的 AWS Transform for mainframe 运行时（适用于由管理的 Amazon ECS AWS Fargate），然后安装名为的示例现代化应用程序。 PlanetsDemo **注意** 在本示例 Dockerfile 中使用的 install-gapwalk.sh 和 install-app.sh 脚本的内容列在 Dockerfile 之后。 ``` FROM --platform=linux/x86_64 amazonlinux:2 RUN mkdir -p /workdir/apps WORKDIR /workdir COPY install-gapwalk.sh . COPY install-app.sh . RUN chmod +x install-gapwalk.sh RUN chmod +x install-app.sh # Install Java and AWS CLI v2-y RUN yum install sudo java-17-amazon-corretto unzip tar -y RUN sudo yum remove awscli -y RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" RUN sudo unzip awscliv2.zip RUN sudo ./aws/install # Installation dir RUN mkdir -p /usr/local/velocity/installation/gapwalk # Copy PlanetsDemo archive to a dedicated apps dir COPY PlanetsDemo-v1.zip /workdir/apps/ # Copy resources (tomcat, blu age runtime) to installation dir COPY tomcat.tar.gz /usr/local/velocity/installation/tomcat.tar.gz COPY aws-bluage-runtime-4.x.x.zip /usr/local/velocity/installation/gapwalk/gapwalk.zip # run relevant installation scripts RUN ./install-gapwalk.sh RUN ./install-app.sh EXPOSE 8080 EXPOSE 8081 # ... WORKDIR /bluage/tomcat.gapwalk/velocity # Run Command to start Tomcat server CMD ["sh", "-c", "sudo bin/catalina.sh run"] ``` 以下是 `install-gapwalk.sh.` 的内容 ``` # Vars TEMP_DIR=/bluage-on-fargate/tomcat.gapwalk/temp # Install echo "Installing Gapwalk and Tomcat" sudo rm -rf /bluage-on-fargate mkdir -p ${TEMP_DIR} # Copy AWS Transform for mainframe runtime and tomcat archives to temporary extraction dir sudo cp /usr/local/velocity/installation/gapwalk/gapwalk.zip ${TEMP_DIR} sudo cp /usr/local/velocity/installation/tomcat.tar.gz ${TEMP_DIR} # Create velocity dir mkdir -p /bluage/tomcat.gapwalk/velocity # Extract tomcat files tar -xvf ${TEMP_DIR}/tomcat.tar.gz -C ${TEMP_DIR} # Copy all tomcat files to velocity dir cp -fr ${TEMP_DIR}/apache-tomcat-10.x.x/* /bluage/tomcat.gapwalk/velocity # Remove default webapps of Tomcat rm -f /bluage-on-fargate/tomcat.gapwalk/velocity/webapps/* # Extract AWS Transform for mainframe runtime at velocity dir unzip ${TEMP_DIR}/gapwalk.zip -d /bluage/tomcat.gapwalk # Remove temporary extraction dir sudo rm -rf ${TEMP_DIR} ``` 以下是 `install-app.sh` 的内容。 ``` #!/bin/sh APP_DIR=/workdir/apps TOMCAT_GAPWALK_DIR=/bluage-on-fargate/tomcat.gapwalk unzip ${APP_DIR}/PlanetsDemo-v1.zip -d ${APP_DIR} cp -r ${APP_DIR}/webapps/* ${TOMCAT_GAPWALK_DIR}/velocity/webapps/ cp -r ${APP_DIR}/config/* ${TOMCAT_GAPWALK_DIR}/velocity/config/ ``` 1. 在 `application-main.yml` 文件（位于 `{TOMCAT_GAPWALK_DIR}/config` 文件夹中）的以下代码段中，提供作为先决条件一部分而创建的数据库的连接信息。有关更多信息，请参阅[创建并连接到 Aurora PostgreSQL 数据库集群](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster)。 ``` datasource: jicsDs: driver-class-name : url: username: password: type : ``` 1. 构建映像推送到您的 Amazon ECR 存储库。有关说明，请参阅《Amazon Elastic Container Registry 用户指南》中的[推送 Docker 映像](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html)。然后，根据您的情况，使用您的 Amazon ECR 映像创建一个 Amazon EKS 容器组或 Amazon ECS 任务定义，然后将其部署到您的集群中。有关创建这些项目的示例，请参阅《Amazon Elastic Container Service（Amazon ECS）开发人员指南》中的[使用控制台创建任务定义](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html)和《Amazon EKS 用户指南》中的[部署示例应用程序](https://docs.aws.amazon.com/eks/latest/userguide/sample-deployment.html)。**** 1. 具体而言，对于**由 AWS Fargate管理的 Amazon ECS**，创建任务定义时，请使用您在初始基础设施设置过程中创建的 IAM 角色。然后，在创建服务时，请展开**网络**部分，配置您在初始基础设施设置过程中创建的 VPC、子网和安全组。请参阅 A [WS Transform for mainframe 运行时的基础设施设置要求](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html)。 ## 测试部署的应用程序 有关如何测试 PlanetsDemo 应用程序的示例，请参阅[测试 PlanetsDemo 应用程序](ba-runtime-test-planetsdemo.md)。 # 在容器上升级大型机运行时的 AWS 转换 本指南介绍如何在容器上升级大型机运行时的 AWS 转换。为此，你需要先完成一些先决条件，然后使用 Docker 镜像来升级大型机运行时的 Tr AWS ansform。 **Topics** + [先决条件](#ba-runtime-maint-prereq) + [升级大型机 AWS 运行时的转换](#ba-runtime-maint-copy-files) ## 先决条件 在开始之前，确保满足以下先决条件： + 完成 [AWS 针对大型机运行时先决条件进行转型](ba-runtime-setup-prereq.md)和[大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。 + 下载要升级到的大型机 AWS 转换运行时版本。有关更多信息，请参阅 [大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。该框架由两个二进制文件组成：`aws-bluage-runtime-x.y.z.zip` 和 `aws-bluage-webapps-x.y.z.zip`。 ## 升级大型机 AWS 运行时的转换 完成以下步骤以升级大型机运行时的 AWS 转换。 1. 使用所需的大型机 AWS 转换运行时版本重建 Docker 镜像。有关说明，请参阅[在容器上为大型机运行时设置 AWS 转换](ba-runtime-deploy-container.md)。 1. 将 Docker 映像推送到 Amazon ECR 存储库。 1. 停止并重启 Amazon ECS 或 Amazon EKS 服务。 1. 验证日志。 大型机运行时 AWS 转换已成功升级。 # 为容器上的大型机运行时 AWS 转换设置 Amazon CloudWatch 警报 您可以设置 CloudWatch 为在部署的应用程序遇到异常时收到更多可见的通知。这可以帮助您监控重定向到的应用程序日志 CloudWatch，并添加警报以警告您可能出现的错误。 ## 警报设置 借助 CloudWatch 日志，您可以根据您的应用程序和需求配置任意数量的指标和警报。 具体而言，您可以在创建集群期间直接为使用情况警报设置主动警报，以便在发生错误时收到通知。要突出显示与大型机 AWS 转换控制系统连接中的错误，请在日志中添加与字符串 “Error C” 相关的指标。然后，您可以定义一个对此指标做出反应的警报。 # 在容器上的 Trans AWS form for 大型机运行时中设置许可的依赖关系 本主题介绍如何设置其他许可依赖项，以便在容器上与大型机运行时的 Transf AWS orm 一起使用。 **Topics** + [先决条件](#ba-runtime-dependencies-prereq) + [概述](#ba-runtime-dependencies-overview) ## 先决条件 在开始之前，请确保满足以下先决条件： + 完成 [AWS 针对大型机运行时先决条件进行转型](ba-runtime-setup-prereq.md)和[大型机运行时的入门 AWS 转换](ba-runtime-setup-onboard.md)。 + 从相应源中获取以下依赖项。 ### Oracle 数据库 提供 [Oracle 数据库驱动程序]( https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html)。例如，**ojdbc11-23.3.0.23.09.jar**。 ### IBM MQ 连接 提供一个 [IBM MQ 客户端](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients)。例如，**com.ibm.mq.jakarta.client-9.3.4.1.jar**。 使用此依赖项版本时，还要提供以下传递依赖项： + bcprov-jdk15to18-1.76.jar + bcpkix-jdk15to18-1.76.jar + bcutil-jdk15to18-1.76.jar ### DDS 打印机文件 提供 Jasper 报告库（m https://com unity.jaspersoft。 com/download-jaspersoft/community-版）。例如 **jasperreports-6.16.0.jar**，不过可以兼容更新的版本。 使用此依赖项版本时，还要提供以下传递依赖项： + castor-core-1.4.1.jar + castor-xml-1.4.1.jar + commons-digester-2.1.jar + ecj-3.21.0.jar + itext-2.1.7.js8.jar + javax.inject-1.jar + jcommon-1.0.23.jar + jfreechart-1.0.19.jar + commons-beanutils-1.9.4.jar + commons-collections-3.2.2.jar ## 概述 要安装依赖项，请完成以下步骤。 1. 根据需要将上述任意依赖项复制到 Docker 映像构建文件夹中。 1. 如果您的 JICS 数据库托管在 Oracle 上，请在中提供 Oracle 数据库驱动程序。`your-tomcat-path/extra` 1. 在您的 Dockerfile 上，将这些依赖项复制到 `your-tomcat-path/extra` 中。 1. 构建您的 Docker 映像并将其推送至 Amazon ECR。 1. 停止并重启 Amazon ECS 或 Amazon EKS 服务。 1. 检查日志。 # 测试 PlanetsDemo 应用程序 要检查已部署 PlanetsDemo 应用程序的状态，请在替换`load-balancer-DNS-name``listener-port`、和之后`web-binary-name`使用正确的设置值运行以下命令。 ``` curl http://load-balancer-DNS-name:listener-port/gapwalk-application/ ``` 如果应用程序正在运行，将显示以下输出消息：`Jics application is running`。 接下来，运行以下命令： ``` curl http://load-balancer-DNS-name:listener-port/jac/api/services/rest/jicsservice/ ``` 如果应用程序正在运行，将显示以下输出消息：`Jics application is running`。 ``` Jics application is running ``` 如果您已配置Blusam，则在运行以下命令时可能会出现空响应。 ``` curl http://load-balancer-DNS-name:listener-port/bac/api/services/rest/bluesamserver/serverIsUp ``` 注意 Web 二进制文件的名称（PlanetsDemo-web-1.0.0，如果未更改）。要访问 PlanetsDemo 应用程序，请使用以下格式的 URL。 ``` https://load-balancer-DNS-name:listener-port/web-binary-name ``` PlanetsDemo 应用程序启动后，将显示主页。 ![\[主页\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/PlanetsDemo-homepage.png) 在文本框中，输入 PINQ，然后按 Enter。随后显示数据查询页面。 ![\[数据查询页面\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/PlanetsDemo-app.png) 例如，在 PlanetsDemo 名称字段中输入 EARTH，然后按 Enter。随后将显示您输入的行星对应的页面。 ![\[EARTH 页面\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/PlanetsDemo-EARTH.png)