AWS Mainframe Modernization 应用程序定义参考

在 AWS Mainframe Modernization 中，您可以在应用程序定义 JSON 文件中配置迁移的大型机应用程序，该文件特定于您选择的运行时引擎。应用程序定义既包含一般信息，也包含特定于引擎的信息。本主题介绍了 AWS Blu Age 和 Micro Focus 应用程序定义，并明确了所有必需元素和可选元素。

一般头部区段

每个应用程序定义都首先指定有关模板版本和源位置的一般信息。应用程序定义的当前版本为 2.0。

使用以下结构来指定模板版本和源位置。

"template-version": "2.0",
    "source-locations": [
        {
            "source-id": "s3-source",
            "source-type": "s3",
            "properties": {
                "s3-bucket": "mainframe-deployment-bucket",
                "s3-key-prefix": "v1"
            }
        }
    ]

"template-version": "2.0",
  "source-locations": [
      {
          "source-id": "s3-source",
          "source-type": "s3",
          "properties": {
              "s3-bucket": "arn:aws:s3:::mainframe-deployment-bucket",
              "s3-key-prefix": "v1"
          }
      }
  ]

定义区段概述

指定应用程序运行所需的服务、设置、数据和其他典型资源的资源定义。更新应用程序定义时，AWS Mainframe Modernization 会通过比较应用程序定义 JSON 文件的先前版本和当前版本中的 source-locations 和 definition 列表来检测是否发生更改。

定义区段是特定于引擎的，可能会发生变化。以下各节针对两个引擎显示了特定于引擎的应用程序定义示例。

AWS Blu Age 应用程序定义示例

{
 "template-version": "2.0",
 "source-locations": [
        {
            "source-id": "s3-source",
            "source-type": "s3",
            "properties": {
                "s3-bucket": "mainframe-deployment-bucket-aaa",
                "s3-key-prefix": "v1"
            }
        }
    ],
    "definition" : {
        "listeners": [{
            "port": 8194,
            "type": "http"
        }],
        "ba-application": {
            "app-location": "${s3-source}/murachs-v6/"
        },
        "blusam": {
            "db": {
                "nb-threads": 8,
                "batch-size": 10000,
                "name": "blusam",
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG"
            },
            "redis": {
                "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com",
                "port": 6379,
                "useSsl": true,
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm"
            }
        }
    }
}

AWS Blu Age 定义详细信息

侦听器 – 必需

指定要用于通过 AWS Mainframe Modernization 创建的 Elastic Load Balancing 访问应用程序的端口。请使用以下结构：

"listeners": [{
            "port": 8194,
            "type": "http"
}],

AWS Blu Age 应用程序 - 必需

使用以下结构指定引擎获取应用程序映像文件的位置。

"ba-application": {
            "app-location": "${s3-source}/murachs-v6/",
            "files-directory": "/m2/mount/myfolder", 
            "enable-jics": <true|false>,
            "shared-app-location": "${s3-source}/shared/"
},

BluSAM – 可选

使用以下结构指定 BluSAM 数据库和 Redis 缓存。

"blusam": {
            "db": {
                "nb-threads": 8,
                "batch-size": 10000,
                "name": "blusam",
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG"
            },
            "redis": {
                "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com",
                "port": 6379,
                "useSsl": true,
                "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm"
            }
}

AWS Blu Age 消息队列 – 可选

指定 AWS Blu Age 应用程序的 JMS-MQ 连接详细信息。

"message-queues": [ 
  {
      "product-type": "JMS-MQ",
      "queue-manager": "QMgr1",
      "channel": "mqChannel1",
      "hostname": "mqserver-host1",
      "port": 1414,
      "user-id": "app-user1",
      "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:sample/mq/test-279PTa"
  },
  {
      "product-type": "JMS-MQ",
      "queue-manager": "QMgr2",
      "channel": "mqChannel2",
      "hostname": "mqserver-host2",
      "port": 1412,
      "user-id": "app-user2",
      "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:sample/mq/test-279PTa"
  }
]

AWS Blu Age 应用程序存储 EFS 配置 - 可选

使用以下结构指定应用程序存储 EFS 接入点详细信息。

"ba-application": {
            "file-permission-mask": "UMASK002"
},
"efs-configs": [
           {
            "file-system-id": "fs-01376dfsvfvrsvsr",
            "mount-point": "/m2/mount/efs-ap2", 
            "access-point-id": fsap-0eaesefvrefrewgv8"
           }
]

Micro Focus 应用程序定义

以下示例定义区段适用于 Micro Focus 运行时引擎，包含必需元素和可选元素。

{
 "template-version": "2.0",
 "source-locations": [
        {
            "source-id": "s3-source",
            "source-type": "s3",
            "properties": {
                "s3-bucket": "mainframe-deployment-bucket-aaa",
                "s3-key-prefix": "v1"
            }
        }
    ],
    "definition" : {
        "listeners": [{
            "port": 5101,
            "type": "tn3270"
        }],
        "dataset-location": {
            "db-locations": [{
                "name": "Database1",
                "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456"
            }]
        },
        "cognito-auth-handler": {
            "user-pool-id": "cognito-idp.us-west-2.amazonaws.com/us-west-2_rvYFnQIxL",
            "client-id": "58k05jb8grukjjsudm5hhn1v87",
            "identity-pool-id": "us-west-2:64464b12-0bfb-4dea-ab35-5c22c6c245f6"
        },
        "ldap-ad-auth-handler": {
            "ldap-ad-connection-secrets": [LIST OF AD-SECRETS]
        },
        "batch-settings": {
            "initiators": [{
                "classes": ["A", "B"],
                "description": "initiator...."
            }],
            "jcl-file-location": "${s3-source}/batch/jcl",
            "program-path": "/m2/mount/libs/loadlib:$EFS_MOUNT/emergency/loadlib",
            "system-procedure-libraries":"SYS1.PROCLIB;SYS2.PROCLIB",
            "aliases": [
               {"alias": "FDSSORT", "program": "SORT"},
               {"alias": "MFADRDSU", "program": "ADRDSSU"}
            ]
        },
        "cics-settings": {
            "binary-file-location": "${s3-source}/cics/binaries",
            "csd-file-location": "${s3-source}/cics/def",
            "system-initialization-table": "BNKCICV"
        },
        "jes-printers": [
           {
             "name": "printerName",
              "classes": [
                 "A",
                 "B"
             ],
             "description": "printer desc....",
             "exit-module": {
                 "name": "lrsprte6"
                }
             } 
         ],
        "xa-resources" : [{
            "name": "XASQL",
            "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456",
            "xa-connection-type": "postgres",
            "module": "${s3-source}/xa/ESPGSQLXA64.so"
        }],
        "runtime-settings": {
          "environment-variables": {
            "ES_JES_RESTART": "N",
            "EFS_MOUNT": "/m2/mount/efs",
            "LRSQ_ADDRESS": "<lrsq-address>"
          }
        }
    }
}

Micro Focus 定义详细信息

Micro Focus 应用程序定义文件中定义区段的内容会有所不同，具体取决于迁移的大型机应用程序在运行时所需的资源。

侦听器 – 必需

使用以下结构指定侦听器：

"listeners": [{
    "port": 5101,
    "type": "tn3270"
}],

数据集位置 – 必需

使用以下结构指定数据集的位置。

"dataset-location": {
            "db-locations": [{
                "name": "Database1",
                "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456"
            }],
 }

Amazon Cognito 身份验证和授权处理程序 – 可选

AWS Mainframe Modernization 使用 Amazon Cognito 对迁移的应用程序进行身份验证和授权。使用以下结构指定 Amazon Cognito 身份验证处理程序。

"cognito-auth-handler": {
            "user-pool-id": "cognito-idp.Region.amazonaws.com/Region_rvYFnQIxL",
            "client-id": "58k05jb8grukjjsudm5hhn1v87",
            "identity-pool-id": "Region:64464b12-0bfb-4dea-ab35-5c22c6c245f6"
}

LDAP 和 Active Directory 处理程序 - 可选

您可以将您的应用程序与 Active Directory（AD）或任何类型的 LDAP 服务器集证进行授权和身份验证。

如果应用程序已与 LDAP 集成并已启动，则必须提供凭证才能执行支持的授权列表中提到的至少一项与应用程序相关的操作。

LDAP/AD 身份验证处理程序适用于 Micro Focus 8.0.11 及更高版本。

以下是当前支持授权的应用程序操作列表：

批处理设置 – 必需

使用以下结构指定作为应用程序一部分运行的批处理作业所需的详细信息。

"batch-settings": {
            "initiators": [{
                "classes": ["A", "B"],
                "description": "initiator...."
            }],
            "jcl-file-location": "${s3-source}/batch/jcl",
            "program-path": "/m2/mount/libs/loadlib:$EFS_MOUNT/emergency/loadlib",
            "system-procedure-libraries":"SYS1.PROCLIB;SYS2.PROCLIB",
            "aliases": [
               {"alias": "FDSSORT", "program": "SORT"},
               {"alias": "MFADRDSU", "program": "ADRDSSU"}
    ]
}

CICS 设置 – 必需

使用以下结构指定作为应用程序一部分运行的 CICS 事务所需的详细信息。

"cics-settings": {
            "binary-file-location": "${s3-source}/cics/binaries",
            "csd-file-location": "${s3-source}/cics/def",
            "system-initialization-table": "BNKCICV"
}

打印机 - 可选

可使用以下结构指定 jes 打印机。

"jes-printers": [
    {
        "name": "printerName",
        "classes": [
            "A", 
            "B"
        ],
        "description": "printer desc....",
        "exit-module": {
            "name": "lrsprte6",
            "module" : "program"
        }
    }
],

打印机一节中提供了更多定义退出模块的示例。

XA 资源 - 可选

使用以下结构指定应用程序所需的 XA 资源所需的详细信息。

"xa-resources" : [{
            "name": "XASQL",
            "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456",
            "xa-connection-type": "postgres",
            "module": "${s3-source}/xa/ESPGSQLXA64.so"
}]

运行时设置 - 可选

使用以下结构为运行时设置指定所需的详细信息，以管理支持的环境变量。

"runtime-settings": {
          "environment-variables": {
            "ES_JES_RESTART": "N",
            "EFS_MOUNT": "/m2/mount/efs"
    }
} 

您可以在《适用于 UNIX 的 Micro Focus Enterprise Server 指南》中查看所有 Micro Focus 环境变量。