AWS Mainframe Modernization referensi definisi aplikasi

Di AWS Mainframe Modernization, Anda mengonfigurasi aplikasi mainframe yang dimigrasi dalam JSON file definisi aplikasi, yang khusus untuk mesin runtime yang Anda pilih. Definisi aplikasi berisi informasi umum dan informasi khusus mesin. Topik ini menjelaskan definisi aplikasi AWS Blu Age dan Micro Focus dan mengidentifikasi semua elemen yang diperlukan dan opsional.

Bagian header umum

Setiap definisi aplikasi dimulai dengan informasi umum tentang versi template dan lokasi sumber. Versi definisi aplikasi saat ini adalah 2.0.

Gunakan struktur berikut untuk menentukan versi template dan lokasi sumber.

"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"
          }
      }
  ]

Ikhtisar bagian definisi

Menentukan definisi sumber daya dari layanan, pengaturan, data, dan sumber daya khas lainnya yang perlu dijalankan aplikasi. Saat Anda memperbarui definisi aplikasi, AWS Mainframe Modernization mendeteksi perubahan dengan membandingkan source-locations dan definition daftar dari versi sebelumnya dan saat ini dari JSON file definisi aplikasi.

Bagian definisi khusus mesin dan dapat berubah. Bagian berikut menunjukkan contoh definisi aplikasi khusus mesin untuk kedua mesin.

AWS Contoh definisi aplikasi 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 Detail definisi Blu Age

Pendengar - wajib

Tentukan port yang akan Anda gunakan untuk mengakses aplikasi melalui Elastic Load Balancing yang AWS Mainframe Modernization dibuat. Gunakan struktur berikut:

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

AWS Aplikasi Blu Age - diperlukan

Tentukan lokasi di mana mesin mengambil file gambar aplikasi menggunakan struktur berikut.

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

Blu SAM - opsional

Tentukan SAM database Blu dan Redis cache menggunakan struktur berikut.

"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 Antrian pesan Blu Age - opsional

Tentukan detail koneksi JMS -MQ untuk aplikasi AWS Blu Age.

"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 EFSKonfigurasi penyimpanan Aplikasi Usia Blu - opsional

Tentukan penyimpanan aplikasi Detail titik EFS akses menggunakan struktur berikut.

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

Definisi aplikasi Fokus Mikro

Bagian definisi sampel berikut adalah untuk mesin runtime Micro Focus, dan berisi elemen wajib dan opsional.

{
 "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>"
          }
        }
    }
}

Detail definisi Fokus Mikro

Konten di bagian definisi file definisi aplikasi Micro Focus bervariasi, tergantung pada sumber daya yang dibutuhkan aplikasi mainframe yang dimigrasi saat runtime.

Pendengar - wajib

Tentukan pendengar menggunakan struktur berikut:

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

Lokasi kumpulan data - diperlukan

Tentukan lokasi kumpulan data menggunakan struktur berikut.

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

Otentikasi Amazon Cognito dan penangan otorisasi - opsional

AWS Mainframe Modernization menggunakan Amazon Cognito untuk otentikasi dan otorisasi untuk aplikasi yang dimigrasi. Tentukan handler otentikasi Amazon Cognito menggunakan struktur berikut.

"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"
}

LDAPdan pengendali Direktori Aktif - opsional

Anda dapat mengintegrasikan aplikasi Anda dengan Active Directory (AD) atau jenis LDAP server apa pun untuk memungkinkan pengguna aplikasi menggunakan LDAP kredensial/AD mereka untuk otorisasi dan otentikasi.

Jika aplikasi terintegrasi dengan LDAP dan telah dimulai, Anda harus memberikan kredensional untuk menjalankan setidaknya satu operasi terkait aplikasi yang disebutkan dalam daftar otorisasi yang didukung.

Handler otentikasi LDAP /AD tersedia untuk Micro Focus 8.0.11 dan versi yang lebih baru.

Berikut adalah daftar operasi aplikasi yang saat ini mendukung otorisasi:

Pengaturan Batch - diperlukan

Tentukan detail yang diperlukan oleh pekerjaan batch yang dijalankan sebagai bagian dari aplikasi menggunakan struktur berikut.

"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"}
    ]
}

CICSpengaturan - diperlukan

Tentukan detail yang diperlukan untuk CICS transaksi yang berjalan sebagai bagian dari aplikasi menggunakan struktur berikut.

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

Printer - opsional

Tentukan printer jes menggunakan struktur berikut.

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

Anda dapat melihat lebih banyak contoh mendefinisikan modul keluar di Printer bagian.

Sumber daya XA - opsional

Tentukan detail yang diperlukan untuk sumber daya XA yang dibutuhkan aplikasi menggunakan struktur berikut.

"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"
}]

Pengaturan runtime - opsional

Tentukan detail yang diperlukan untuk pengaturan runtime untuk mengelola variabel lingkungan yang diizinkan menggunakan struktur berikut.

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

Anda dapat mengakses semua variabel lingkungan Fokus Mikro di Server Perusahaan Fokus Mikro untuk UNIX panduan.