必要條件步驟 1：建立和載入 Amazon S3 儲存貯體步驟 2：建立和設定資料庫步驟 3：建立和設定 AWS KMS key 步驟 4：建立和設定 AWS Secrets Manager 資料庫秘密步驟 5：建立執行期環境步驟 6：建立應用程式步驟 7：部署應用程式步驟 8：匯入資料集步驟 9：啟動應用程式步驟 10：連線至 CardDemo CICS應用程式清除資源後續步驟

教學課程：設定 Micro Focus 的受管執行期

您可以使用 Micro Focus 執行期引擎，在 AWS 大型主機現代化受管執行期環境中部署和執行應用程式。本教學課程說明如何使用 Micro Focus 執行期引擎，在 AWS 大型主機現代化受管執行期環境中部署和執行 CardDemo 範例應用程式。 CardDemo 範例應用程式是一種簡化的信用卡應用程式，旨在測試和展示大型主機現代化使用案例 AWS 並合作技術。

在教學課程中，您可以在其他中建立資源 AWS 服務。其中包括 Amazon Simple Storage Service、Amazon Relational Database Service AWS Key Management Service、和 AWS Secrets Manager。

必要條件

請確定您能夠存取 3270 模擬器以使用CICS連線。免費和試用版 3270 模擬器可從第三方網站取得。或者，您可以啟動 AWS 大型主機 Modernization AppStream 2.0 Micro Focus 執行個體，並使用 Rumba 3270 模擬器（不免費提供）。

如需 AppStream 2.0 的相關資訊，請參閱教學課程：設定 AppStream 2.0 以搭配 Micro Focus 企業分析儀和微焦點企業開發人員使用。

注意
建立堆疊時，請選擇 Enterprise Developer （ED）選項，而非 Enterprise Analyzer （EA）。
下載CardDemo 範例應用程式，並將下載的檔案解壓縮至任何本機目錄。此目錄將包含名為的子目錄CardDemo。
識別VPC您帳戶中的，您可以在其中定義在本教學課程中建立的資源。至少VPC需要兩個可用區域中的子網路。如需 Amazon 的詳細資訊VPC，請參閱 Amazon 如何VPC運作。

步驟 1：建立和載入 Amazon S3 儲存貯體

在此步驟中，您可以建立 Amazon S3 儲存貯體，並將 CardDemo 檔案上傳至此儲存貯體。在本教學課程的稍後部分，您會使用這些檔案在 AWS Mainframe Modernization Micro Focus Managed Runtime 環境中部署和執行 CardDemo 範例應用程式。

注意

您不需要建立新的 S3 儲存貯體，但您選擇的儲存貯體必須與本教學課程中使用的其他資源位於相同的區域中。

建立 Amazon S3 儲存貯體

開啟 Amazon S3 主控台，然後選擇建立儲存貯體 。
在一般組態 中，選擇您要建置 AWS Mainframe Modernization Micro Focus Managed Runtime AWS的區域。
輸入儲存貯體名稱 ，例如 yourname-aws-region-carddemo。保留預設設定，然後選擇建立儲存貯體 。或者，您也可以從現有的 Amazon S3 儲存貯體複製設定，然後選擇建立儲存貯體 。
選擇您剛建立的儲存貯體，然後選擇上傳。
在上傳區段中，選擇新增資料夾 ，然後從本機電腦瀏覽至CardDemo目錄。
選擇上傳以開始上傳程序。上傳時間會根據連線速度而有所不同。
上傳完成時，請確認所有檔案都已成功上傳，然後選擇關閉。

您的 Amazon S3 儲存貯體現在包含 CardDemo 資料夾。

如需 S3 儲存貯體的相關資訊，請參閱建立、設定和使用 Amazon S3 儲存貯體。

步驟 2：建立和設定資料庫

在此步驟中，您可以在 Amazon Relational Database Service （Amazon ）中建立 PostgreSQL 資料庫RDS。 Amazon Relational Database Service 在教學課程中，此資料庫包含 CardDemo 範例應用程式用於客戶有關信用卡交易任務的資料集。

在 Amazon 中建立資料庫 RDS

開啟 Amazon RDS主控台。
選擇AWS您要建立資料庫執行個體的區域。
在導覽窗格中，選擇 Databases (資料庫)。
選擇建立資料庫 ，然後選擇標準建立 。
針對引擎類型 ，選擇 Postgre SQL。
選擇 15 或更高版本的引擎。

注意
儲存引擎版本，因為您稍後在本教學課程中需要它。
在範本區段中，選擇 免費方案。
將資料庫執行個體識別碼變更為有意義的項目，例如 MicroFocus-Tutorial。
避免在中管理主要憑證 AWS Secrets Manager。請改為輸入主要密碼並確認。

注意
儲存您用於資料庫的使用者名稱和密碼。您將在本教學課程的後續步驟中安全地存放它們。
在連線下，選擇您要建立 AWS 大型主機現代化受管執行期環境VPC的。
選擇建立資料庫。

在 Amazon 中建立自訂參數群組 RDS

在 Amazon RDS主控台導覽窗格中，選擇參數群組 ，然後選擇建立參數群組 。
在建立參數群組視窗中，針對參數群組系列 ，選取符合您資料庫版本的 Postgres 選項。

注意
有些 Postgres 版本需要類型。視需要選取資料庫參數群組。輸入參數群組的群組名稱和描述。
選擇 Create (建立)。

若要設定自訂參數群組

選擇新建立的參數群組。
選擇動作，然後選擇編輯。
篩選 max_prepared_transactions 並將參數值變更為 100。
選擇 Save Changes (儲存變更)。

將自訂參數群組與資料庫建立關聯

在 Amazon RDS主控台導覽窗格中，選擇資料庫 ，然後選擇您要修改的資料庫執行個體。
選擇 Modify (修改)。Modify DB instance (修改資料庫執行個體) 頁面隨即出現。

注意
在資料庫完成建立和備份之前，修改選項無法使用，這可能需要幾分鐘的時間。
在修改資料庫執行個體頁面上，導覽至其他組態 ，並將資料庫參數群組變更為參數群組。如果您的參數群組在清單中無法使用，請檢查是否使用正確的資料庫版本建立。
選擇繼續，然後檢查修改摘要。
選擇立即套用以立即套用變更。
選擇修改資料庫執行個體以儲存您的變更。

如需參數群組的詳細資訊，請參閱使用參數群組。

注意

您也可以將 Amazon Aurora PostgreSQL 資料庫與 AWS 大型主機現代化搭配使用，但沒有免費層選項。如需詳細資訊，請參閱使用 Amazon Aurora Postgre。SQL

步驟 3：建立和設定 AWS KMS key

若要安全地存放 Amazon RDS執行個體的憑證，請先建立 AWS KMS key。

若要建立 AWS KMS key

開啟 Key Management Service 主控台。
選擇 Create Key (建立金鑰)。
保留金鑰類型的 Symmetric 預設值，以及金鑰用量的加密和解密。
選擇 Next (下一步)。
為金鑰提供別名，例如 MicroFocus-Tutorial-RDS-Key和選用描述。
選擇 Next (下一步)。
勾選使用者或角色旁的方塊，以指派金鑰管理員。
選擇下一個 ，然後再次選擇下一個 。

在檢閱畫面上，編輯金鑰政策 ，然後在現有的「陳述式」陣列中輸入下列項目：


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

此政策會授予使用此特定金鑰政策 AWS 的 Mainframe Modernization 解密許可。

選擇完成以建立金鑰。

如需詳細資訊，請參閱 AWS Key Management Service 開發人員指南中的建立金鑰。

步驟 4：建立和設定 AWS Secrets Manager 資料庫秘密

現在使用 AWS Secrets Manager 和安全地存放資料庫憑證 AWS KMS key。

建立和設定 AWS Secrets Manager 資料庫秘密

開啟 Secrets Manager 主控台。
在導覽窗格中，選擇 Secrets (祕密)。
在秘密中，選擇儲存新的秘密 。
將秘密類型設定為 Amazon RDS 資料庫的憑證。
輸入您在建立資料庫時指定的憑證。
在加密金鑰 下，選取您在步驟 3 中建立的金鑰。
在資料庫區段中，選取您為本教學課程建立的資料庫，然後選擇下一個 。
在秘密名稱 下，輸入名稱，例如 MicroFocus-Tutorial-RDS-Secret和選用描述。

在資源許可區段中，選擇編輯許可 ，並以下列政策取代內容：


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

選擇 Save (儲存)。
針對後續畫面選擇下一步，然後選擇儲存。重新整理秘密清單以查看新秘密。
選擇新建立的秘密，並記下，Secret ARN因為稍後在教學課程中需要它。
在秘密的概觀索引標籤中，選擇擷取秘密值 。
選擇編輯，然後選擇新增列 。
新增值sslMode為的金鑰verify-full：
選擇 Save (儲存)。

步驟 5：建立執行期環境

建立執行期環境

開啟 AWS Mainframe Modernization 主控台。
在導覽窗格中，選擇 Environments (環境)。然後選擇建立環境。
在指定基本資訊 下，
1. 環境名稱MicroFocus-Environment的。
2. 在引擎選項下，確定已選取 Micro Focus。
3. 選擇最新的 Micro Focus 版本 。
4. 選擇 Next (下一步)。
設定環境
1. 在可用性 下，選擇高可用性叢集 。
2. 在資源下，選擇執行個體類型的 M2.c5.large 或 M2.m5.large，以及您想要的執行個體數量。最多指定兩個執行個體。
3. 在安全和網路 下，選擇允許部署到此環境的應用程式公開存取，並選擇至少兩個公有子網路。
4. 選擇 Next (下一步)。
在連接儲存頁面上，選擇下一個 。
在排程維護頁面上，選擇無偏好設定，然後選擇下一步。
在檢閱和建立頁面上，檢閱您為執行期環境提供的所有組態，然後選擇建立環境 。

當您建立環境時，會出現一個橫幅，其中顯示 Environment name was created successfully，狀態欄位會變更為可用。環境建立程序需要幾分鐘的時間，但您可以在執行時繼續後續步驟。

步驟 6：建立應用程式

建立應用程式

在導覽窗格中，選擇 Applications (應用程式)。然後選擇建立應用程式 。
在建立應用程式頁面的指定基本資訊 下，MicroFocus-CardDemo輸入應用程式名稱，並在引擎類型下輸入，確保已選取 Micro Focus。然後選擇下一步。

在 指定資源和組態 下，選擇選項，使用內嵌編輯器以其資源和組態指定應用程式定義。

在編輯器中輸入下列應用程式定義：


{
  "template-version": "2.0",
  "source-locations": [
    {
      "source-id": "s3-source",
      "source-type": "s3",
      "properties": {
        "s3-bucket": "yourname-aws-region-carddemo",
        "s3-key-prefix": "CardDemo"
      }
    }
  ],
  "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"
      }
    ]
  }
}

注意

此檔案可能會有所變更。

在來源位置的屬性物件JSON中編輯應用程式，如下所示：
1. 將的值取代s3_bucket為您在步驟 1 中建立的 Amazon S3 儲存貯體名稱。
2. 將的值取代s3-key-prefix為您上傳 CardDemo 範例檔案的資料夾（金鑰字首）。如果您直接將CardDemo目錄上傳到 Amazon S3 儲存貯體，則s3-key-prefix不需要變更。
3. 使用您在步驟 4 中建立ARN的資料庫秘密的取代這兩個secret-manager-arn值。
如需應用程式定義的詳細資訊，請參閱 Micro Focus 應用程式定義。
選擇 Next (下一步) 繼續。
在檢閱和建立頁面上，檢閱您提供的資訊，然後選擇建立應用程式 。

建立應用程式後，會出現一個橫幅，顯示 Application name was created successfully。狀態欄位會變更為可用。

步驟 7：部署應用程式

部署應用程式

在導覽窗格中，選擇應用程式 ，然後選擇 MicroFocus-CardDemo。
在部署應用程式 下，選擇部署。
選擇應用程式和您先前建立的環境的最新版本，然後選擇部署。

當 CardDemo 應用程式成功部署時，狀態會變更為就緒。

步驟 8：匯入資料集

匯入資料集

在導覽窗格中，選擇應用程式 ，然後選擇應用程式。
選擇資料集索引標籤。然後選擇 Import (匯入)。
選擇匯入和編輯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/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/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/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/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/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/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/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/catalog/data/AWS.M2.CARDDEMO.USRSEC.VSAM.KSDS.DAT"
            }
        }
    ]
}

將 <s3-bucket-name>（有八個）的每次發生，取代為包含 CardDemo 資料夾的 Amazon S3 儲存貯體名稱，例如 your-name-aws-region-carddemo。

注意
若要為 Amazon S3 中的URI資料夾複製 Amazon S3，請選取資料夾，然後選擇複製 Amazon S3。 URI
選擇提交。

匯入完成時，會出現包含下列訊息的橫幅：會顯示匯入資料集的Import task with resource identifier name was completed successfully.清單。

您也可以在資料集標籤上選擇匯入歷史記錄，以檢視所有資料集匯入的狀態。

步驟 9：啟動應用程式

啟動應用程式

在導覽窗格中，選擇應用程式 ，然後選擇應用程式。
選擇開始應用程式 。

當 CardDemo 應用程式開始成功執行時，會出現一個橫幅，其中包含下列訊息：Application name was started successfully。狀態欄位會變更為執行。

步驟 10：連線至 CardDemo CICS應用程式

連線之前，請確定您為應用程式指定的 VPC和安全群組與您套用的網路介面相同的群組。

若要設定 TN3270 連線，您也需要DNS應用程式的主機名稱和連接埠。

使用終端機模擬器設定應用程式並將其連接至大型主機

開啟 AWS 大型主機現代化主控台，然後選擇應用程式 ，然後選擇 MicroFocus-CardDemo。
選擇複製圖示以複製DNS主機名稱 。也請務必記下連接埠號碼。
啟動終端機模擬器。本教學課程使用 Micro Focus Rumba+。

注意
組態步驟因模擬器而異。
選擇大型主機顯示 。
選擇連線，然後選擇設定。
在已安裝的介面 下，選擇 TN3270，然後在連線選單下TN3270再次選擇。
選擇插入，然後貼上DNS Hostname應用程式的。6000 指定 Telnet 連接埠 。

注意
如果您在瀏覽器中使用 AWS AppStream 2.0，且貼上值發生問題，請參閱疑難排解 AppStream 2.0 使用者問題。
在連線下，選擇進階，然後選擇傳送保持運作狀態和傳送 NOP，然後輸入 180 作為間隔。

注意
將 TN3270 終端機上的保持運作設定設定為至少 180 秒，有助於確保 Network Load Balancer 不會中斷您的連線。
選擇連線。
注意
如果連線失敗：
- 如果您使用的是 AppStream 2.0，請確認為應用程式環境指定的 VPC和安全群組與 AppStream 2.0 機群相同。
- 使用可VPC連線性分析工具分析連線。您可以透過主控台存取連線能力分析工具。
- 作為診斷步驟，請嘗試新增或變更應用程式的安全群組傳入規則，以允許來自任何地方的連接埠 6000 流量（即CIDR封鎖 0.0.0.0/0）。如果您成功連線，就知道安全群組正在封鎖流量。將安全群組來源變更為更具體的內容。如需安全群組的詳細資訊，請參閱安全群組基本概念。
輸入 USER0001 作為使用者名稱，輸入 password 作為密碼。

注意
在 Rumba 中，Clear 的預設值為 ctrl-shift-z，重設的預設值為 ctrl-r。
成功登入後，您可以瀏覽應用程式 CardDemo。
輸入 01 以取得帳戶檢視。
輸入 00000000010 以取得帳號，然後按鍵盤上的 Enter。

注意
其他有效帳戶為 0000000011和 00000000020。
按 F3 退出選單，然後按 F3 退出交易。