Tutorial: Managed Runtime for Blu Age - Mainframe Modernization

Tutorial: Managed Runtime for Blu Age

This tutorial demonstrates how to deploy a Blu Age-modernized application into an AWS Mainframe Modernization runtime environment.

Prerequisites

This tutorial requires the following prerequisites:

Step 1: Upload the demo application

Upload the demo application to an Amazon S3 bucket. Make sure that this bucket is in the same region where you will deploy the application. The following example shows a bucket named planetsdemo, with a key prefix (folder) named v1 and an archive named planetsdemo-v1.zip:


    The planetsdemo bucket in Amazon S3 showing the v1 prefix and the planetsdemo-v1.zip
     file.

Step 2: Create the application definition

Deploying an application to the managed runtime requires a Mainframe Modernization application definition, which is a JSON file describing the application location and settings. The following example is such an application definition for the demo application:

{ "resources": [ { "resource-type": "listener", "resource-id": "tomcat", "properties": { "port": 8196, "type": "http" } }, { "resource-type": "ba-application", "resource-id": "planetsdemo", "properties": { "app-location": "${s3-source}/PlanetsDemo-v1.zip" } } ], "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "planetsdemo", "s3-key-prefix": "v1" } } ] }

Change the ba-application and s3-source entries as needed to point to the Amazon S3 bucket where you previously uploaded the sample application.

Step 3: Create a runtime environment

Create the Mainframe Modernization runtime environment by following these steps:

  1. Navigate to AWS Mainframe Modernization in the AWS Management Console.

  2. In Modernize mainframe applications, choose Refactor with Blu Age then choose Get started.

    
      The Mainframe Modernization get started page showing Refactor with Blu Age.
  3. In How would you like to start with AWS Mainframe Modernization, choose Deploy and Create runtime environment.

    
      The Mainframe Modernization get started page with deploy and create runtime environment
       selected.
  4. Choose Environments, then choose Create environment. In Specify basic information, enter a name and description for your environment, then make sure AWS Blu Age engine is selected. You may optionally add tags to the created resource. Then choose Next.

    
      The Mainframe Modernization specify basic information with the AWS Blu Age engine selected.
  5. In Specify configurations, choose Standalone runtime environment:

    
      The Mainframe Modernization Availability section with standalone runtime environment selected.
  6. In Security and network, choose Allow applications deployed to this environment to be publicly accessible, and choose a VPC (you can use the Default one) and two subnets:

    
      The Mainframe Modernization Security and Network section with the default VPC and two subnets
       selected.
  7. In Attach storage - Optional, leave the defaults and choose Next:

    
      The Mainframe Modernization Attach storage page with the default values applied.
  8. In Review and create, review the information, then choose Create environment.

Step 4: Create an application

  1. Navigate to AWS Mainframe Modernization in the AWS Management Console.

  2. Choose Applications, then choose Create application. In Specify basic information, enter a name and description for the application, and make sure AWS Blu Age engine is selected. Then choose Next.

    
      The Mainframe Modernization application specify basic information section, with the AWS Blu Age engine
       selected.
  3. In Specify resources and configurations, copy and paste the previously updated application definition JSON:

    
      The Mainframe Modernization resources and configurations section with the updated application definition
       JSON pasted in.
  4. In Review and create, review your choices, then choose Create application.

Step 5: Deploy an application

After you successfully create both the Mainframe Modernization runtime environment and application (both must be in the Available state), you can deploy the application into the runtime environment. To do this, complete the following steps:

  1. Navigate to AWS Mainframe Modernization in the AWS Management Console and choose Environments.

    
      The Mainframe Modernization runtime environments list with the previously created runtime environment
       displayed.
  2. Choose the previously created runtime environment:

    
      The Mainframe Modernization environment details page for the planets-demo-env environment.
  3. Choose Deploy application:

    
      The Mainframe Modernization deploy application page with the planets demo app displayed.
  4. Choose the previously created application, then choose Deploy.

  5. Wait until the application finishes deploying. You'll see a banner with the message Application was deployed successfully.

Step 6: Start an application

  1. Navigate to AWS Mainframe Modernization in the AWS Management Console and choose Applications.

  2. Choose your application, then scroll down to Deployments: it should be in the Succeeded state:

    
      The Mainframe Modernization deployments page showing the deployment status of succeeded.
  3. Choose Actions, then choose Start application.

Step 7: Access the application

  1. Wait until the application is in the Running state. You'll see a banner with the message Application was started successfully.

  2. Copy the application DNS hostname, which you can find in the Application information section of the application.

  3. In a browser, navigate to http://{hostname}:{portname}/PlanetsDemo-web-1.0.0/, where:

    • hostname is the DNS name copied above.

    • portname is the tomcat port defined in the application definition earlier.

Clean up resources

If you no longer need the resources you created for this tutorial, delete them so that you won't continue to be charged for them. Complete the following steps:

Next steps

If you would like to continue learning, you can explore the following tutorials: