チュートリアル: Rocket Software (旧 Micro Focus) のマネージドランタイムを設定する

[Amazon S3 コンソール] を開き、[バケットを作成] を選択します。

全般設定で、 AWS Mainframe Modernization Rocket Software Managed Runtime を構築する AWS リージョンを選択します。

yourname-aws-region-carddemo など、[バケット名] を入力します。デフォルト設定はそのままにして、[バケットを作成] をクリックします。または、既存の Amazon S3 バケットから設定をコピーし、[バケットを作成] を選択することもできます。

作成したバケットを選択し、[アップロード] を選択します。

[アップロード] セクションで、[フォルダを追加] を選択し、ローカルコンピュータから　CardDemo_runtime　ディレクトリを参照します。

[アップロード] を選択し、アップロードプロセスを開始します。アップロード時間は接続速度によって異なります。

アップロードが完了したら、すべてのファイルが正常にアップロードされたことを確認し、[閉じる] を選択します。

Amazon RDS コンソールを開きます。

データベースインスタンスを作成したい AWS リージョンを選択します。

ナビゲーションペインから、[Databases] (データベース) を選択します。

[データベースを作成] を選択し、[標準作成] を選択します。

[エンジンタイプ] として、[PostgreSQL] を選択します。

[エンジンバージョン] 15 以上を選択します。

[テンプレート] で、[無料利用枠] を選択します。

[DB インスタンス識別子] を、MicroFocus-Tutorial などの意味のあるものに変更します。

AWS Secrets Managerでマスター認証情報を管理しないでください。新しいマスターユーザーパスワードを入力して確認します。

接続で、 AWS Mainframe Modernization マネージドランタイム環境を作成する VPC を選択します。

[データベースの作成] を選択します。

Amazon RDS コンソールのナビゲーションペインで、[パラメータグループ]、[グループを作成] の順に選択します。

[パラメータグループを作成] ウィンドウの [パラメータグループファミリー] に、データベースのバージョンに一致する [Postgres] オプションを選択します。

[Create] (作成) を選択します。

新しく作成されたパラメータグループを選択します。

[Actions] (アクション) を選択して、[Edit] (編集) を選択します。

max_prepared_transactions でフィルタリングし、パラメータ値を [100] に変更します。

[Save Changes] を選択します。

Amazon RDS コンソールのナビゲーションペインで、[データベース] を選択し、変更する DB インスタンスを選択します。

Modify を選択します。Modify DB instance ページが表示されます。

[DB インスタンスの変更] ページで、[追加設定] に移動し、[DB パラメータグループ] をパラメータグループに変更します。パラメータグループが一覧にない場合は、正しいデータベースバージョンで作成されたかどうかを確認します。

[続行] を選択して、変更の概要を確認します。

変更をすぐに反映させるには、[すぐに適用] を選択します。

[DB インスタンスを変更] を選択して、変更を保存します。

[Key Management Service のコンソール] を開きます。

[Create Key] (キーを作成) を選択します。

キータイプは [対称] のデフォルトに、キーの使用は [暗号化および復号化] のままにします。

[Next (次へ)] を選択します。

キーに MicroFocus-Tutorial-RDS-Key などの [エイリアス]やオプションの説明を指定します。

[Next (次へ)] を選択します。

ユーザーまたはロールの横にあるチェックボックスをオンにして、キー管理者を割り当てます。

[Next (次へ)] を選択します。

ユーザーまたはロールの横にあるチェックボックスをオンにして、キー使用権限を割り当てます。

[Next (次へ)] を選択します。

レビュー画面で、[キーポリシー] を編集し、既存の「Statement」配列内に以下を入力します。

{
     "Sid" : "Allow access for Mainframe Modernization Service",
     "Effect" : "Allow",
        "Principal" : {
           "Service" : "m2.amazonaws.com"
                 },
      "Action" : "kms:Decrypt",
      "Resource" : "*"
},

このポリシーは、この特定のキーポリシーを使用して AWS Mainframe Modernization 復号化のアクセス許可を付与します。

[Finish] (完了) を選択し、KMS キーを作成します。

Secrets Manager コンソールを開きます。

ナビゲーションペインで [シークレット] を選択します。

[シークレット] で、[新しいシークレットを保存する] を選択します。

[シークレットタイプ] で、[Amazon RDS データベースの認証情報] を選択します。

データベースを作成したときに指定した認証情報を入力します。

[暗号化キー] で、ステップ 3 で作成したキーを選択します。

[データベース] セクションで、このチュートリアル用に作成したデータベースを選択し、[次へ] を選択します。

[シークレット名] に、MicroFocus-Tutorial-RDS-Secret などの名前とオプションの説明を入力します。

[リソースに対するアクセス許可] セクションで、[アクセス許可を編集] を選択し、次のポリシーのコンテンツを置き換えます。

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect" : "Allow",
            "Principal" : {
                "Service" : "m2.amazonaws.com"
            },
            "Action" : "secretsmanager:GetSecretValue",
            "Resource" : "*"
        }
    ]
}

[Save] を選択します。

後続の画面で [次へ] を選択し、[ストア] を選択します。

シークレット一覧を更新して、新しいシークレットを表示します。

ステップ 4 で新しく作成したシークレットを選択し、チュートリアルの後半で必要Secret ARNになるため、 を書き留めます。

シークレットの [概要] タブで、[シークレット値を取得] を選択します。

[編集] を選択し、[列を追加] の順に選択します。

verify-full の [値] を持つ [キー] を追加します。

[Save] を選択します。

AWS Mainframe Modernization コンソールを開きます。

ナビゲーションペインで [Environments (環境)] を選択します。次に、[環境を作成] をクリックします。

[基本情報を指定] で、

1. 環境名に MicroFocus-Environment を入力します。

2. エンジンオプションで、Micro Focus (Rocket) が選択されていることを確認します。

3. 最新の Micro Focus (Rocket) バージョンを選択します。

4. [Next (次へ)] を選択します。

環境を設定する

1. [可用性] で [高可用性クラスター] を選択します。

2. [リソース] で、インスタンスタイプと必要なインスタンス数として [M2.c5.large] または [M2.m5.large] を選択します。最大 2 つのインスタンスを指定できます。

3. [セキュリティとネットワーク] で、少なくとも 2 つのサブネットを選択し、[この環境にデプロイされたアプリケーションをパブリックにアクセスできるようにする] を選択してください。

4. [Next (次へ)] を選択します。

[ポリシーをアタッチ] ページで、[次へ] を選択します。

[メンテナンスをスケジュール] で、[指定なし] を選択し、[次へ] を選択します。

[確認と作成] ページで、ランタイム環境に設定したすべての設定を確認し、[環境を作成] を選択します。

ナビゲーションペインで、[アプリケーション] を選択します。次に [アプリケーションを作成] を選択します。

アプリケーションの作成ページの「基本情報を指定MicroFocus-CardDemo」で、アプリケーション名に「」と入力し、エンジンタイプで Micro Focus (Rocket) が選択されていることを確認します。次いで、[次へ] を選択します。

[リソースと設定を指定] で、インラインエディタを使用して、リソースと設定を使用してアプリケーション定義を指定するオプションを選択します。

エディタに次のアプリケーション定義を入力します。

{
  "template-version": "2.0",
  "source-locations": [
    {
      "source-id": "s3-source",
      "source-type": "s3",
      "properties": {
        "s3-bucket": "yourname-aws-region-carddemo",
        "s3-key-prefix": "CardDemo_runtime"
      }
    }
  ],
  "definition": {
    "listeners": [
      {
        "port": 6000,
        "type": "tn3270"
      }
    ],
    "dataset-location": {
      "db-locations": [
        {
          "name": "Database1",
          "secret-manager-arn": "arn:aws:secretsmanager:Region:123456789012:secret:MicroFocus-Tutorial-RDS-Secret-xxxxxx"
        }
      ]
    },
    "batch-settings": {
      "initiators": [
        {
          "classes": [
               "A",
               "B"
            ],
          "description": "initiator_AB...."
        },
        {
          "classes": [
                "C",
                "D"
             ],
          "description": "initiator_CD...."
        }
      ],
      "jcl-file-location": "${s3-source}/catalog/jcl"
    },
    "cics-settings": {
      "binary-file-location": "${s3-source}/loadlib",
      "csd-file-location": "${s3-source}/rdef",
      "system-initialization-table": "CARDSIT"
    },
    "xa-resources": [
      {
        "name": "XASQL",
        "secret-manager-arn": "arn:aws:secretsmanager:Region:123456789012:secret:MicroFocus-Tutorial-RDS-Secret-xxxxxx",
        "module": "${s3-source}/xa/ESPGSQLXA64.so"
      }
    ]
  }
} 

[source-locations] の [プロパティ] オブジェクトのアプリケーション JSON を次のように編集します。

1. s3_bucket の値を、ステップ 1 で作成した Amazon S3 バケット名に置き換えます。

2. s3-key-prefix の値を、CardDemo サンプルファイルをアップロードしたフォルダ (キープレフィックス) に置き換えます。CardDemo ディレクトリを Amazon S3 バケットに直接アップロードした場合、s3-key-prefix を変更する必要はありません。

3. 両方の secret-manager-arn の値を、ステップ 4 で作成したデータベースシークレットの ARN に置き換えます。

アプリケーション定義の詳細については、「Rocket Software (旧 Micro Focus) アプリケーション定義」を参照してください。

[次へ] を選択して続行します。

[レビューおよび作成] ページで入力した情報を確認してから、[アプリケーションを作成] を選択します。

ナビゲーションペインで [デプロイ] を展開し、MicroFocus-CardDemo を選択します。

[アプリケーションをデプロイ] で、[デプロイ] を選択します。

以前に作成したアプリケーションの最新バージョンと環境を選択し、[デプロイ] を選択します。

ナビゲーションペインで、[アプリケーション] を選択し、[アプリケーションを作成] を選択します。

[データセット] タブを選択します。次に、[インポート] を選択します。

[JSON 設定のインポートと編集] を選択し、[独自の JSON をコピーして貼り付ける] オプションを選択します。

次の JSON をコピーして貼り付けますが、まだ「送信」を選択しないでください。この JSON には、デモアプリケーションに必要なすべてのデータセットが含まれていますが、Amazon S3 バケットの詳細が必要です。

{
    "dataSets": [
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 11,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 300,
                    "max": 300
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDDATA.VSAM.AIX.PATH",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 11,
                            "offset": 16
                        }
                    }
                },
                "recordLength": {
                    "min": 150,
                    "max": 150
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 16,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 150,
                    "max": 150
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 16,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 50,
                    "max": 50
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CUSTDATA.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 9,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 500,
                    "max": 500
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CUSTDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDXREF.VSAM.AIX.PATH",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 11,
                            "offset": 25
                        }
                    }
                },
                "recordLength": {
                    "min": 50,
                    "max": 50
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 16,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 350,
                    "max": 350
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.USRSEC.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 8,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 80,
                    "max": 80
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo_runtime/catalog/data/AWS.M2.CARDDEMO.USRSEC.VSAM.KSDS.DAT"
            }
        }
    ]
}

<s3-bucket-name> の各出現 (8 個) を、CardDemo フォルダを含む Amazon S3 バケットの名前に置き換えます。例えば、your-name-aws-region-carddemo です。

[送信] を選択します。

インポートが完了すると、バナーにメッセージ「Import task with resource identifier name was completed successfully.」が表示されます。インポートされたデータセットの一覧が表示されます。

ナビゲーションペインで、[アプリケーション] を選択し、[アプリケーションを作成] を選択します。

[アプリケーションを開始] を選択します。

AWS Mainframe Modernization コンソールを開き、アプリケーションを選択し、 を選択しますMicroFocus-CardDemo。

[DNS ホスト名] をコピーするには、コピーアイコンを選択します。また、ポート番号も必ず書き留めてください。

ターミナルエミュレータを起動します。このチュートリアルでは、Micro Focus Rumba+ を使用しています。

[Mainframe Display] を選択します。

[接続] を選択し、[設定] を選択します。

[インストール済みインターフェイス] で、TN3270 を選択し、[接続] メニューで TN3270 をもう一度選択します。

[挿入] を選択し、アプリケーションの DNS Hostname を貼り付けます。[Telnet ポート] に 6000 を指定します。

[接続] で、[高度な設定] を選択し、[キープアライブを送信] と [NOP を送信] を選択し、[間隔] に [180] を入力します。

[接続]を選択してください。

ユーザー名に USER0001 をパスワードに password を入力します。

ログインに成功すると、CardDemo アプリケーション内を移動できます。

アカウントビューに 01 を入力します。

アカウント番号に 00000000010 を入力し、キーボードで Enter キーを押します。

F3 を押してメニューを終了し、F3 トランザクションを終了します。