AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# メインフレームランタイムの AWS 変換を設定する
このセクションでは、 AWS インフラストラクチャでメインフレームランタイムの AWS 変換を設定する手順について説明します。アプリケーションのメインフレームランタイムの AWS 変換を設定する前に、前提条件、リージョン、バケット、およびランタイム環境を設定して管理するための 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 のコンテナにメインフレームランタイムの AWS トランスフォームをデプロイする](ba-deploy-container.md)
+ [PlanetsDemo アプリケーションをテストする](ba-runtime-test-planetsdemo.md)
# AWS メインフレームランタイムの前提条件の変換
AWS メインフレームランタイムの変換は、いくつかの[AWS メインフレームリリースノートの変換](ba-release-notes.md)リリースバージョンで利用できます。モダナイゼーションプロジェクトが進行中の場合は、実装やテストを行うために、ランタイムを段階的にバージョニングすることが必要になる場合があります。ニーズを定義するには、メインフレーム配信マネージャーの AWS 変換にお問い合わせください。
メインフレームランタイムの AWS 変換の使用を開始する前に、次の操作を行います。
+ AWS アカウントがあることを確認します。
+ Transform AWS for Mainframe でモダナイズされたアプリケーションがリファクタリングされていることを確認します。
+ メインフレームランタイムの AWS 変換でサポートされている AWS リージョンとコンピューティングオプションの 1 つを選択します。
+ 使用するメインフレームランタイムバージョンの AWS 変換を選択します。
+ メインフレームランタイムの AWS 変換を実行するために必要な追加コンポーネントを確認して[メインフレームランタイムの AWS 変換のインフラストラクチャセットアップ要件](ba-infrastructure-setup.md)検証します。
**注記**
Transform AWS for mainframe Runtime の機能をテストする場合は、デモアプリケーション を使用できます。`Planets Demo`このアプリケーションは [PlanetsDemo-v1.zip](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip) からダウンロードできます。
# メインフレームランタイムのオンボーディング AWS 変換
**注記**
メインフレームランタイムアクセスの AWS 変換は、チケットベースのリクエストから[、メインフレームリファクタリングの AWS Transform](https://bluinsights.aws/) を介した直接ダウンロードに移行しました。AWS Transform for mainframe refactor の [AWS Transform for mainframe Toolbox](https://bluinsights.aws/docs/bluage-toolbox-introduction) 機能を使用してAWS Transform for mainframe製品にアクセスする、新しく簡素化された方法を導入しました。
開始するには、メインフレームランタイムの AWS 変換にアクセスするためのオンボーディングをリクエストする[AWS サポート](https://support.console.aws.amazon.com/support/home)ケースを作成します。 AWS アカウント ID、使用する AWS リージョン、コンピューティングの選択をリクエストに含め、メインフレームランタイムバージョンの AWS 変換を含めます。必要なバージョンがわからない場合は、メインフレーム配信マネージャーの AWS 変換にお問い合わせください。 AWS Mainframe Modernization リファクタリングツールによって生成されたアプリケーションのコードソースが既にある場合は、モダナイズされたコードベース内の`pom.xml`ファイルに`gapwalk.version`タグ値を書き留めます。
**注記**
メインフレームランタイムの AWS 変換は、Alpha プレリリースと リリースの 2 つの主要なバリエーションで利用できます。使用するリリースを確認するには、「」を参照するか[AWS メインフレームバージョニングの変換](ba-versioning.md)、メインフレーム配信マネージャーの AWS 変換にお問い合わせください。
## メインフレームランタイムの AWS 変換のリージョンとバケット
メインフレームランタイムアーティファクトの AWS 変換は、リージョン別およびコンピューティング選択別に異なる Amazon S3 バケットに保存されます。メインフレームランタイムの AWS 変換 AWS リージョン 用の のバケットにアクセスするには、次の表に示す名前を使用します。
| AWS リージョン | リリースバケット | アルファプレリリースバケット |
| --- | --- | --- |
| 米国東部 (オハイオ) | 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 `
を前のテーブル AWS リージョン の のバケットの名前`bucket-name`に置き換えます。
このコマンドは、Release バケットの次のようなメインフレームランタイムランタイムの AWS 変換のさまざまなバージョンに対応するフォルダのリストを返します。
```
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`に置き換え AWS リージョン 、 を必要なバージョン`version`に置き換えます。以下に 2 つの例を示します。
リリースバケットの場合:
`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 変換のインフラストラクチャセットアップ要件
このトピックでは、メインフレームランタイムの AWS 変換を実行するために必要な最小限のインフラストラクチャ設定について説明します。次の手順では、選択したコンピューティングでメインフレームランタイムの AWS 変換をセットアップして、メインフレームランタイムの AWS 変換にモダナイズされたアプリケーションをデプロイする方法について説明します。作成するリソースは、アプリケーションドメイン専用のサブネットを持つ Amazon VPC 内にある必要があります。
**Topics**
+ [インフラストラクチャ要件](#infrastructure-requirements)
+ [Amazon EC2 でのメインフレームランタイムの AWS 変換の実行](#ba-running-on-ec2)
+ [Amazon EC2 での Amazon ECS でのメインフレームランタイムの AWS 変換の実行](#ba-running-on-ecs-on-ec2)
+ [Amazon EC2 での Amazon EKS でのメインフレームランタイムの AWS 変換の実行](#ba-running-on-eks-on-ec2)
+ [によって管理される Amazon ECS でのメインフレームランタイムの AWS 変換の実行 AWS Fargate](#ba-running-on-fargate)
## インフラストラクチャ要件
**セキュリティグループを作成する**
Amazon EKS で Amazon EC2 インスタンスを使用する予定の場合、ユーザーの代わりに Amazon EKS クラスター作成プロセスによってセキュリティグループが作成されるため、この手順をスキップしてください。新しいセキュリティグループを作成する代わりに、以下の手順でそのセキュリティグループを使用します。
1. Amazon VPC コンソールの [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) を開いてください。
1. ナビゲーションペインの **[セキュリティ]** で、**[セキュリティグループ]** を選択します。
1. 中央のペインで、**[セキュリティグループの作成]** を選択します。
1. **[セキュリティグループ名]** フィールドに「**M2BluagePrivateLink-SG**」と入力します。
1. [**インバウンドルール**] セクションで、[**ルールの追加**] を選択します。
1. **[タイプ]** で、[HTTPS] を選択します。
1. **[ソース]** に VPC CIDR を入力します。
1. **[アウトバウンドのルール]** セクションで、**[ルールの追加]** を選択します。
1. **[タイプ]** で、[HTTPS] を選択します。
1. [**送信先**] に「**0.0.0.0/0**」と入力します。
1. **[セキュリティグループの作成]** を選択してください。
**IAM ロールを作成する**
1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/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. Amazon EC2 コンソール ([https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)) を開きます。
1. **[インスタンスを起動]** を選択します。
1. **インスタンスタイプで**、EC2 で使用可能なインスタンスタイプを選択します。
1. **[キーペア]** セクションで、既存のキーペアを選択するか、新規にキーペアを作成します。
1. **[ネットワーク設定]** セクションで、**[既存のセキュリティグループを選択する]** を選択します。
1. **[共通のセキュリティグループ]** で、**[M2BluagePrivateLink-SG]** を選択します。
1. **[高度な詳細]** セクションを展開します。
1. **[IAM インスタンスプロファイル]** で、先ほど作成した IAM ロールを選択します。
1. **[インスタンスを起動]** を選択します。
**Amazon EC2 インスタンスへのアプリケーションのインストール**
1. Amazon EC2 インスタンスの状態が **[実行中]** に変わったら、インスタンスに接続します。
1. インスタンスに次のソフトウェアコンポーネントをインストールします (「」に記載されているバージョンを参照してください[AWS メインフレームリリースノートの変換](ba-release-notes.md))。
+ Java ランタイム環境 (JRE)。
+ Apache Tomcat。
+ AWS メインフレームランタイム (Amazon EC2) の変換。Transform AWS for mainframe ランタイムを Apache Tomcat インストールフォルダのルートにインストールします (一部のファイルは追加され、他のファイルは上書きされます）。
AWS Transform for mainframe Runtime アーカイブと一緒に配信される追加のウェブアプリケーションをインストールするには、Apache Tomcat サーバーのセカンダリインスタンスを設定し、その場所でウェブアプリケーションアーカイブを解凍します。詳細な手順については、「[AWS メインフレームランタイムアーティファクトの変換](ba-runtime-artifacts.md)」を参照してください。
## Amazon EC2 での Amazon ECS でのメインフレームランタイムの AWS 変換の実行
1. **Amazon EC2 インスタンス**を基盤となるインフラストラクチャとして使用し、Amazon ECS クラスターを作成します。「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 インスタンスのネットワーク設定]** で、前のステップで作成したセキュリティグループを選択します。
## Amazon EC2 での Amazon EKS でのメインフレームランタイムの 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 でのメインフレームランタイムの AWS 変換の実行 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.zip**
x.y.z がバージョン番号を表すこのアーカイブ ([AWS メインフレームのバージョニングについては](https://docs.aws.amazon.com/m2/latest/userguide/ba-versioning.html)「変換」を参照) には、メインフレームアプリケーションの AWS 変換を実行するために不可欠なメインフレームランタイムコンポーネントのコア AWS 変換が含まれています。
| アーティファクト | 説明 | タイプ | ディストリビューションフォルダ |
| --- | --- | --- | --- |
| gapwalk-application-x.y.z.war | AWS Transform for mainframe メインウェブアプリケーション Gapwalk | ウォー | webapps |
| \$1.jar | AWS Transform for mainframe ランタイムフレームワーク共有ライブラリ (Gapwalk) | ジャー | 共有 |
| gapwalk-\$1-x.y.z.war | AWS Transform for mainframe 追加のウェブアプリケーション (utility-pgm、階層サポートなど ) | ウォー | webapps-extra |
| bac-x.y.z.war / jac-x.y.z.war | AWS Transform for mainframe 管理コンソール (非スタンドアロン) | ウォー | webapps-consoles |
**aws-bluage-webapps-x.y.z.zip**
x.y.z が上記と同じバージョニングスキームに従うこのアーカイブには、AWS Transform for mainframe管理コンソール (スタンドアロン) が含まれます。
+ **BAC** (Blusam コンソール) WAR ファイル。Blusamデータベースのモニタリングに使用されます。
+ **JICS データベースのモニタリングに使用される JAC** (JICS コンソール) WAR ファイル。
+ 必要なサポートライブラリ。
### パッケージ署名の検証
リリースされた zip ファイルは、セキュリティと信頼性を確保するために、デジタル署名された ZIP アーカイブとして提供されます。デジタル署名は、ダウンロードしたファイルが本物であり、変更されておらず、組織によって正式にリリースされていることを確認するのに役立ちます。これにより、改ざんを防ぎ、悪意のある方法で配布される可能性のあるマルウェアや侵害されたファイルから保護できます。
ZIP ファイルを使用する前に署名を確認するには、次のコマンドを使用します。
`jarsigner -verify -certs -verbose aws-bluage-runtime-x.y.z.zip`
認定ファイル の結果の例を次に示します。
```
...
jar verified.
```
セキュリティの脆弱性に対処する方法の詳細については、[「AWS Mainframe Modernization Refactor with AWS Transform for mainframe release overview](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 を使用する場合に適用されます。
アルファバージョン 5.60.0 以降、メインフレームランタイムディストリビューションの AWS 変換には、包括的な README.md ファイルを含むデプロイフォルダが含まれています。このガイドでは、Amazon EC2 のデプロイ手順、設定オプション、トラブルシューティングのヒントstep-by-step説明します。
**Topics**
+ [Amazon EC2 でメインフレームランタイムの AWS 変換を設定する](ba-runtime-deploy-ec2.md)
+ [Amazon EC2 でメインフレームランタイムの AWS 変換をアップグレードする](ba-runtime-maint-ec2.md)
+ [メインフレームランタイム (Amazon EC2) Amazon CloudWatch アラームの AWS 変換を設定する](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](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)」を参照してください。
+ SSM を使用するなどして、Amazon EC2 インスタンスに正常に接続できることを確認します。
**注記**
このガイド全体で、Tomcat のインストールパスは とみなされます`/m2-anywhere/tomcat-gapwalk/velocity`。以下の指示に従うときは、このパスを使用するか、選択したパスに次の指示を適応させます。
+ メインフレームランタイムの AWS 変換 (Amazon EC2 上) を速度ディレクトリ `/m2-anywhere/tomcat-gapwalk/velocity` (Tomcat インストールフォルダ) に直接ダウンロードして抽出します。ストレージ、アクセス、コンテンツに関する情報など、メインフレームランタイムアーティファクトの AWS 変換を取得する方法については、「」を参照してください[AWS メインフレームランタイムアーティファクトの変換](ba-runtime-artifacts.md)。
+ [PlanetsDemo アプリケーションアーカイブ](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip)をダウンロードします。
+ アーカイブを解凍し、選択した Amazon S3 バケットにアプリケーションをアップロードします。
+ JICS 用の Amazon Aurora PostgreSQL データベースを作成します。メインフレームランタイムの AWS 変換は、最初の起動時に`PlanetsDemo-v1/jics/sql/initJics.sql`スクリプトを自動的に実行します。Amazon Aurora PostgreSQL データベースの作成方法については、[「Aurora PostgreSQL DB クラスターの作成と接続」](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster)を参照してください。
## 設定
PlanetsDemo サンプルアプリケーションをセットアップするには、次のステップを完了します。
1. Amazon 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` を以前に PlanetsDemo アーカイブを解凍したバケットの正しい Amazon S3 URI に置き換えてください。
1. `PlanetsDemo-v1/config/` フォルダの内容を `/m2-anywhere/tomcat-gapwalk/velocity/config/` にコピーします。
1. 前提条件のために作成したデータベースの接続情報を、`/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml` ファイルの次のスニペットに指定します。詳細については、「[Aurora PostgreSQL DB クラスターの作成と接続](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)
## 前提条件
開始する前に、以下の前提条件を満たしていることを確認してください。
+ バージョンにアップグレード手順があるかどうかを確認するには、「[メインフレームの AWS 変換をアップグレードする手順](ba-migration-notes.md)」を参照してください。
+ 「[AWS メインフレームランタイムの前提条件の変換](ba-runtime-setup-prereq.md)」および「[メインフレームランタイムのオンボーディング AWS 変換](ba-runtime-setup-onboard.md)」を完了させます。
+ Amazon EC2 インスタンスにメインフレームランタイム用の既存の AWS Transform がインストールされていることを確認します。詳細については、「[Amazon EC2 Linux インスタンスの開始方法](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)」を参照してください。
+ SSM を使用するなどして、Amazon EC2 インスタンスに正常に接続できることを確認します。
+ アップグレードするメインフレームランタイムバージョンの AWS 変換をダウンロードします。フレームワークは、 `gapwalk-x.y.z.zip`と の 2 つのアーカイブファイルで構成されます`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. Amazon ECR リポジトリに Docker イメージをプッシュします。
1. Amazon ECS または Amazon EKS サービスを停止して再起動します。
1. ログを確認します。
メインフレームランタイムの AWS 変換が正常にアップグレードされました。
# メインフレームランタイム (Amazon EC2) Amazon CloudWatch アラームの AWS 変換を設定する
アプリケーションログを受信するよう CloudWatch を設定し、エラーの可能性を警告するアラームを追加できます。これにより、デプロイされたアプリケーションに例外が発生するたびに、より見やすい通知を表示できます。以下のセクションは、CloudWatch のログ記録とアラームの設定について理解し、学習するのに役立ちます。
## CloudWatch ログ記録を有効にする
CloudWatch ログ記録を有効にするには、次のセクションで提供されている設定テンプレートを使用して、設定フォルダに`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
```
要素の外部は、すべて標準的なログバックの設定です。このファイルには、ログをコンソールに送信するコンソールアペンダーと、CloudWatch にログを送信する CloudWatch アペンダーの 2 つのアペンダーがあります。
`root` 要素の `level` 属性は、アプリケーション全体のログ記録レベルを指定します。
タグ 内の必須の値は次のとおりです。
+ : CloudWatch のロググループ名を設定します。値が指定されない場合、デフォルトは `BluAgeRuntimeOnEC2-Logs` になります。ロググループが存在しない場合は、自動的に作成されます。この動作は、次で説明する設定によって変更できます。
+ : CloudWatch の (ロググループ内の) logStream の名前を設定します。
オプションの値:
+ : ログストリームが書き込まれるリージョンを無効にします。デフォルトでは、ログは EC2 インスタンスと同じリージョンに送られます。
+ : ログメッセージが使用するパターン。
+ : オペレーションごとに CloudWatch に送信するログメッセージの最大数。
+ : CloudWatch ログが書き込まれるまでの時間 (ミリ秒単位)。
+ : 内部ログキューにリクエストの挿入を試行する時間 (ミリ秒単位)。
+ : 内部キューの最大サイズ。
+ : 存在しない場合はロググループとログストリームを作成します。
+ : スタートアップ時にスレッドを休止させる時間。この最初の待機時間により、最初にログが蓄積されます。
+ : ログイベントの最大サイズ。このサイズを超えるログは送信されません。
+ : 長すぎるメッセージは切り捨てられます。
+ : 緊急アペンダーを有効にします。
## CloudWatch の設定
上記の設定でログを CloudWatch に正しくプッシュするため、Amazon EC2 IAM インスタンスプロファイルロールを更新して、「BluAgeRuntimeOnEC2-Logs」ロググループとそのログストリームに対する追加のアクセス許可を付与します。
+ `logs:CreateLogStream`
+ `logs:DescribeLogStreams`
+ `logs:CreateLogGroup`
+ `logs:PutLogEvents`
+ `logs:DescribeLogGroups`
## アラーム設定
CloudWatch ログにより、アプリケーションやニーズに応じてさまざまなメトリクスやアラームを設定できます。具体的には、使用状況の警告に関するプロアクティブアラームを設定して、アプリケーションが猶予期間に入る (そして最終的にはアプリケーションが動作しなくなる) ようなエラーが発生した場合に警告することができます。これを実現するには、「Error C5001」文字列に関するメトリクスをログに追加できます。これにより、メインフレーム管理システムの AWS 変換への接続のエラーが強調表示されます。その後、このメトリクスに反応するアラームを定義できます。
# Amazon EC2 のメインフレームランタイムの AWS 変換でライセンスされた依存関係を設定する
このガイドでは、Amazon EC2 のメインフレームランタイムの AWS 変換で使用できる追加のライセンス依存関係を設定する方法について説明します。
**Topics**
+ [前提条件](#ba-runtime-dependencies-prereq)
+ [インストール手順](#ba-runtime-dependencies-overview)
## 前提条件
開始する前に、以下の前提条件を満たしていることを確認してください。
+ 「[AWS メインフレームランタイムの前提条件の変換](ba-runtime-setup-prereq.md)」および「[メインフレームランタイムのオンボーディング AWS 変換](ba-runtime-setup-onboard.md)」を完了させます。
+ Transform for mainframe Runtime (Amazon EC2 上) AWS を備えた Amazon EC2 インスタンスがインストールされていることを確認します。詳細については、「[Amazon EC2 Linux インスタンスの開始方法](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)」を参照してください。
+ SSM を使用するなどして、Amazon EC2 インスタンスに正常に接続できることを確認します。
+ 以下の依存関係をソースから取得します。
### Oracle データベース
[Oracle データベースドライバー](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html)を用意してください。Transform AWS for mainframe Runtime (Amazon EC2) 機能をバージョン **ojdbc11-23.3.0.23.09.jar** でテストしましたが、より新しいバージョンには互換性がある可能性があります。
### IBM MQ の接続
[IBM MQ クライアント](https://www.ibm.com/support/pages/mqc91-ibm-mq-clients)を用意してください。Transform AWS for mainframe Runtime (Amazon EC2) 機能をバージョン **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 レポートライブラリ (https://community.jaspersoft.com/download-jaspersoft/community-edition) を指定します。**jasperreports-6.16.0.jar** を使用してメインフレームランタイム (Amazon EC2 上) の AWS 変換機能をテストしましたが、より新しいバージョンには互換性がある可能性があります。
この依存関係バージョンでは、以下の推移的な依存関係も指定してください。
+ 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 ウェブアプリケーションの場合は、このフォルダに Oracle データベースドライバー (ojdbc) を含めてください。
1. 次のコマンドを実行して、tomcat.service を停止して開始します。
```
systemctl stop tomcat.service
```
```
systemctl start tomcat.service
```
1. サービスのステータスをチェックして、それが実行中であることを確認します。
```
systemctl status tomcat.service
```
1. ログを検証します。
# Amazon ECS および Amazon EKS のコンテナにメインフレームランタイムの AWS トランスフォームをデプロイする
このセクションのトピックでは、コンテナでメインフレームランタイムの AWS 変換を設定して Amazon ECS (Amazon EC2 または によって管理 AWS Fargate) および Amazon EC2 によって管理される Amazon EKS にデプロイする方法、ランタイムバージョンを更新する方法、Amazon 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)
+ [コンテナでのメインフレームランタイムの AWS 変換でライセンスされた依存関係を設定する](ba-runtime-dependencies-container.md)
# コンテナでメインフレームランタイムの AWS 変換を設定する
このトピックでは、 AWS Transform for mainframe Runtime を使用して PlanetsDemo サンプルアプリケーションを Docker コンテナにセットアップしてデプロイする方法について説明します。
AWS コンテナでのメインフレームランタイムの変換は、Amazon EC2 によって管理される Amazon ECS、 によって管理される Amazon ECS AWS Fargate、および Amazon EC2 によってAmazon EC2 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](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)をダウンロードします。
+ Amazon Aurora PostgreSQL データベースを JICS 用に作成し、それに対して `PlanetsDemo-v1/jics/sql/initJics.sql` クエリを実行します。Amazon Aurora PostgreSQL データベースの作成方法については、[「Aurora PostgreSQL DB クラスターの作成と接続」](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. 入手したランタイムのバイナリと Apache Tomcat サーバーのバイナリを基に、カスタムイメージの作成の作成に必要な [Dockerfile](https://docs.docker.com/engine/reference/builder/) を準備します。次の 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. 前提条件に含まれるため作成したデータベースの接続情報を、`{TOMCAT_GAPWALK_DIR}/config` フォルダにある `application-main.yml` ファイル内の次のスニペットに入力します。詳細については、「[Aurora PostgreSQL DB クラスターの作成と接続](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、サブネット、およびセキュリティグループを設定します。[「AWS Transform for mainframe Runtime のインフラストラクチャセットアップ要件](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html)」を参照してください。
## デプロイしたアプリケーションのテスト
PlanetsDemo アプリケーションのテスト方法の例については、「[PlanetsDemo アプリケーションをテストする](ba-runtime-test-planetsdemo.md)」を参照してください。
# コンテナのメインフレームランタイムの AWS 変換をアップグレードする
このガイドでは、 コンテナでメインフレームランタイムの AWS 変換をアップグレードする方法について説明します。これを行うには、まずいくつかの前提条件を満たしてから、Docker イメージを使用してメインフレームランタイムの AWS 変換をアップグレードする必要があります。
**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` の 2 つのバイナリファイルで構成されます。
## メインフレームランタイムの AWS 変換をアップグレードする
メインフレームランタイムの AWS 変換をアップグレードするには、次の手順を実行します。
1. メインフレームランタイムバージョンに必要な AWS 変換を使用して Docker イメージを再構築します。手順については、「[コンテナでメインフレームランタイムの AWS 変換を設定する](ba-runtime-deploy-container.md)」を参照してください。
1. Amazon ECR リポジトリに Docker イメージをプッシュします。
1. Amazon ECS または Amazon EKS サービスを停止して再起動します。
1. ログを検証します。
メインフレームランタイムの AWS 変換が正常にアップグレードされました。
# コンテナでメインフレームランタイムの AWS 変換用に Amazon CloudWatch アラームを設定する
デプロイされたアプリケーションに例外が発生するたびに、より見やすい通知が表示されるように CloudWatch を設定できます。これにより、CloudWatch にリダイレクトされたアプリケーションログをモニタリングし、エラーの可能性を警告するアラームを追加できます。
## アラーム設定
CloudWatch ログにより、アプリケーションやニーズに応じて任意の数のメトリクスやアラームを設定できます。
具体的には、クラスターの作成中に使用状況の警告に関するプロアクティブアラームを直接設定して、エラーが発生したときに通知を受け取ることができます。Transform for mainframe control system AWS への接続エラーを強調表示するには、ログに文字列「Error C」に関するメトリクスを追加します。その後、このメトリクスに反応するアラームを定義できます。
# コンテナでのメインフレームランタイムの AWS 変換でライセンスされた依存関係を設定する
このトピックでは、 AWS Transform for mainframe Runtime on container で使用できる追加のライセンス依存関係を設定する方法について説明します。
**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 レポートライブラリ (https://community.jaspersoft.com/download-jaspersoft/community-edition) を指定します。例えば **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
```
ウェブバイナリの名前 (変更されていなければ PlanetsDemo-web-1.0.0) を書き留めておきます。PlanetsDemo アプリケーションにアクセスするには、以下の形式の URL を使用してください。
```
https://load-balancer-DNS-name:listener-port/web-binary-name
```
PlanetsDemo アプリケーションを開始すると、ホームページが表示されます。
![\[ホームページ\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/PlanetsDemo-homepage.png)
テキストボックスで、「PINQ」と入力して、Enter キーを押します。データ問い合わせページが表示されます。
![\[データ問い合わせページ\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/PlanetsDemo-app.png)
例えば、PlanetsDemo の名前フィールドに「EARTH」と入力し、Enter キーを押します。入力した惑星のページが表示されます。
![\[「EARTH」ページ\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/PlanetsDemo-EARTH.png)