AWS m2 documentation change
Summary
Updated AWS Blu Age FAQ with revised terminology, removed non-managed runtime references, renumbered questions, added new FAQ about 'Standalone' deployment, and updated links/resources
Security assessment
Changes are editorial updates including terminology standardization (e.g., 'Refactoring' capitalization), removal of redundant links, consolidation of runtime options, and FAQ restructuring. No security vulnerabilities, patches, or security feature enhancements are mentioned. The new 'Standalone' FAQ explains deployment architecture without security implications.
Diff
diff --git a/m2/latest/userguide/ba-faq.md b/m2/latest/userguide/ba-faq.md index 95248cf0a..145807f6a 100644 --- a//m2/latest/userguide/ba-faq.md +++ b//m2/latest/userguide/ba-faq.md @@ -13 +13 @@ AWS Mainframe Modernization Service (Managed Runtime Environment experience) is - 1. **What is the main purpose of AWS Blu Age refactoring capability?** + 1. **What is the main purpose of AWS Blu Age Refactoring capability?** @@ -19 +19 @@ The refactoring capability refactors legacy monolithic code into java using cont -AWS Blu Age currently supports the modernization of IBM z/OS mainframe applications written in COBOL, PL/I, JCL (Job Control Language) and relying on CICS (Customer Information Control System) transaction manager, BMS (Basic Mapping Support) screens, IMS MFS Screens, DB2 databases, IMS databases, Flat files, GDG (Generation data groups) and VSAM (Virtual Storage Access Method) data files. For more details, see [AWS Blu Insights](https://bluinsights.aws/). +AWS Blu Age currently supports the modernization of IBM z/OS mainframe applications written in COBOL, PL/I, JCL (Job Control Language) and relying on CICS (Customer Information Control System) transaction manager, BMS (Basic Mapping Support) screens, IMS MFS Screens, DB2 databases, IMS databases, Flat files, GDG (Generation data groups) and VSAM (Virtual Storage Access Method) data files. @@ -47 +47 @@ JAC stands for JICS Administration Console -AWS Blu Age tooling is accessible through the AWS Console via AWS Mainframe Modernization (M2) Refactor, with feature access based on your accreditation level. Start with the Transformation Center to assess automatic Java refactoring of your source code. For detailed guidance, refer to the [AWS Blu Insights](https://bluinsights.aws/) documentation. After modernization, you can deploy applications using either managed or non-managed runtime options. For more information on these deployment choices, see [AWS Mainframe Modernization documentation](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-options.html). +AWS Blu Age tooling is accessible through the AWS Console via AWS Mainframe Modernization (M2) Refactor, with feature access based on your accreditation level. Start with the Transformation Center to assess automatic Java refactoring of your source code. For detailed guidance, refer to the [AWS Blu Insights](https://bluinsights.aws/) documentation. After modernization, you can deploy applications using runtime. For more information, see [AWS Mainframe Modernization documentation](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-options.html). @@ -68 +68 @@ AWS Blu Age generated code is designed with specific technical characteristics a -Refer the [Set up AWS Blu Age Runtime (non-managed)](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-setup.html) documentation about non-managed runtime that details set-up process onboarding, retrieving artifacts, deployment, etc. +Refer the [Set up AWS Blu Age Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-setup.html) documentation runtime that details set-up process onboarding, retrieving artifacts, deployment, etc. @@ -70,5 +70 @@ Refer the [Set up AWS Blu Age Runtime (non-managed)](https://docs.aws.amazon.com - 2. **Where can I find AWS Blu Age Runtime for Developers?** - -The AWS Blu Age Runtime for Developers is available in [Blu Age Toolbox](https://bluinsights.aws/app/bluage-toolbox/tools) for L3 Certified individuals. - - 3. **Are the AWS Blu Age JAR dependencies uploaded to the client's Maven Repository for local development?** + 2. **Are the AWS Blu Age JAR dependencies uploaded to the client's Maven Repository for local development?** @@ -78 +74 @@ Libraries can be imported into EC2 using an AMI which can be used for configurin - 4. **What does the term “Gapwalk” refer to in the distributed AWS Blu Age Runtime jars?** + 3. **What does the term “Gapwalk” refer to in the distributed AWS Blu Age Runtime jars?** @@ -82 +78 @@ For information on Gapwalk, see [AWS Blu Age Runtime artifacts ](https://docs.aw - 5. **How to request access to the AWS Blu Age Runtime non-managed?** + 4. **How to request access to the AWS Blu Age Runtime ?** @@ -84 +80 @@ For information on Gapwalk, see [AWS Blu Age Runtime artifacts ](https://docs.aw -Follow instructions on [Onboarding AWS Blu Age Runtime ](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-setup-onboard.html) to request access to AWS Support center. +The Runtime is accessible through the [Blu Age Toolbox](https://bluinsights.aws/docs/bluage-toolbox-introduction) on Blu Insights. @@ -86 +82 @@ Follow instructions on [Onboarding AWS Blu Age Runtime ](https://docs.aws.amazon - 6. **What are the supported Runtimes for AWS Blu Age refactored applications?** + 5. **What are the supported Runtimes for AWS Blu Age refactored applications?** @@ -88 +84 @@ Follow instructions on [Onboarding AWS Blu Age Runtime ](https://docs.aws.amazon -To explore the full range of runtime choices for your modernized applications, we recommend reviewing the [Blu Age Runtime Options](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-options.html) guide. +AWS Blu Age offers a single Runtime to cater to different stages of your modernization journey and operational needs see [AWSBlu Age Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-options.html). @@ -90 +86 @@ To explore the full range of runtime choices for your modernized applications, w - 7. **When is the AWS Blu Age Runtime used?** + 6. **When is the AWS Blu Age Runtime used?** @@ -94 +90 @@ An AWS Blu Age Runtime is necessary to support the execution of AWS Blu Age refa - 8. **How does AWS distribute new releases for AWS Blu Age Runtime?** + 7. **How does AWS distribute new releases for AWS Blu Age Runtime?** @@ -96 +92 @@ An AWS Blu Age Runtime is necessary to support the execution of AWS Blu Age refa -For M2 Managed Runtime, updates, including patches, minor, and major versions, are made available in the AWS Console and AWS CLI. They include OS updates, engine, and dependency changes, typically within 30 days of general availability. AWS is responsible for supported components and applies updates to AWS Mainframe Modernization instances automatically. And it is the same case for other environments like Custom Runtime, Linux AMI, and on-premises. +The AWS Blu Age Runtime releases are accessible through the [Blu Age Toolbox](https://bluinsights.aws/docs/bluage-toolbox-introduction). See the [AWSBlu Age release notes](https://docs.aws.amazon.com/m2/latest/userguide/ba-release-notes.html). @@ -98 +94 @@ For M2 Managed Runtime, updates, including patches, minor, and major versions, a - 9. **How often are new major and minor versions of AWS Blu Age runtime released?** + 8. **How often are new major and minor versions of AWS Blu Age runtime released?** @@ -100 +96 @@ For M2 Managed Runtime, updates, including patches, minor, and major versions, a -New versions are released once a month or two, and customers can decide when and how to upgrade their runtime instances. For more information, see [AWS Blu Age versioning](https://docs.aws.amazon.com/m2/latest/userguide/ba-versioning.html) page. +For more information, see [AWS Mainframe Modernization components lifecycle](https://docs.aws.amazon.com/m2/latest/userguide/lifecycle-m2.html). @@ -102 +98 @@ New versions are released once a month or two, and customers can decide when and - 10. **How does AWS provide support for AWS Blu Age Runtime?** + 9. **How does AWS provide support for AWS Blu Age Runtime?** @@ -106 +102 @@ Support is provided through AWS Support, where issues are addressed by raising a - 11. **What does the AWS Mainframe Modernization AWS Blu Age Runtime entail?** + 10. **What does the AWS Mainframe Modernization AWS Blu Age Runtime entail?** @@ -110 +106 @@ The AWS Blu Age Runtime includes toolbox libraries for accelerating modernizatio - 12. **Does AWS Blu Age Runtime support non-x86 computer architectures?** + 11. **Does AWS Blu Age Runtime support non-x86 computer architectures?** @@ -114 +110 @@ Currently, AWS Blu Age Runtime only support x86-based computer architectures and - 13. **How can customers stay informed about AWS Blu Age Runtime versions, including notifications of new releases and access to version history and release notes?** + 12. **How can customers stay informed about AWS Blu Age Runtime versions, including notifications of new releases and access to version history and release notes?** @@ -118 +114 @@ New versions of AWS Blu Age Runtime are uploaded to our [official release page]( - 14. **What are the main components of AWS Blu Age Runtime high-level architecture?** + 13. **What are the main components of AWS Blu Age Runtime high-level architecture?** @@ -122 +118 @@ The AWS Blu Age Runtime architecture comprises two main component types. First a - 15. **How to configure the shared folder holding AWS Blu Age Runtime artifacts?** + 14. **How to configure the shared folder holding AWS Blu Age Runtime artifacts?** @@ -128 +124 @@ The AWS Blu Age Runtime artifacts (jars) must be gathered in a shared folder, ac - 16. **How does AWS Blu Age Runtime handle statelessness and session management?** + 15. **How does AWS Blu Age Runtime handle statelessness and session management?** @@ -132 +128 @@ AWS Blu Age Runtime implements statelessness and session management through mult - 17. **What role do web applications play in the AWS Blu Age Runtime environment?** + 16. **What role do web applications play in the AWS Blu Age Runtime environment?** @@ -136 +132 @@ AWS Blu Age Runtime implements statelessness and session management through mult - 18. **How are programs registered and managed in AWS Blu Age Runtime?** + 17. **How are programs registered and managed in AWS Blu Age Runtime?** @@ -140 +136 @@ Programs in AWS Blu Age Runtime are registered through a [ProgramRegistry system - 19. **How is configuration managed in AWS Blu Age Runtime applications?** + 18. **How is configuration managed in AWS Blu Age Runtime applications?** @@ -144 +140 @@ Configuration in AWS Blu Age Runtime is managed through YAML files using Spring - 20. **What role do secrets managers play in the AWS Blu Age Runtime configuration?** + 19. **What role do secrets managers play in the AWS Blu Age Runtime configuration?** @@ -148 +144 @@ Secrets managers in AWS Blu Age Runtime secure sensitive configuration data like - 21. **How can developers write their own programs compatible with AWS Blu Age Runtime?** + 20. **How can developers write their own programs compatible with AWS Blu Age Runtime?** @@ -152 +148 @@ Developers can create AWS Blu Age Runtime-compatible programs by implementing th - 22. **How does AWS Blu Age Runtime handle program execution errors?** + 21. **How does AWS Blu Age Runtime handle program execution errors?** @@ -156 +152 @@ AWS Blu Age Runtime handles program execution errors through multiple mechanisms - 23. **What AWS Blu Age Runtime monitoring capabilities are available for batch jobs?** + 22. **What AWS Blu Age Runtime monitoring capabilities are available for batch jobs?** @@ -160 +156 @@ AWS Blu Age Runtime provides monitoring capabilities for batch jobs through vari - 24. **How are AWS Blu Age Runtime job execution statuses tracked and managed?** + 23. **How are AWS Blu Age Runtime job execution statuses tracked and managed?** @@ -164 +160 @@ Job execution statuses are tracked through a comprehensive status system that in - 25. **How does AWS Blu Age Runtime handle external system interactions?** + 24. **How does AWS Blu Age Runtime handle external system interactions?** @@ -168 +164 @@ The runtime handles external system interactions through various mechanisms, inc - 26. **How is authentication handled in AWS Blu Age Runtime?** + 25. **How is authentication handled in AWS Blu Age Runtime?** @@ -172 +168 @@ AWS Blu Age Runtime supports multiple authentication methods, with OAuth2 being - 27. **How does AWS Blu Age Runtime ensure high availability?** + 26. **How does AWS Blu Age Runtime ensure high availability?** @@ -176 +172 @@ AWS Blu Age Runtime ensures high availability through several mechanisms. It imp - 28. **What component is used to reproduce CICS distributed transactions with AWS Blu Age applications?** + 27. **What component is used to reproduce CICS distributed transactions with AWS Blu Age applications?** @@ -180 +176 @@ The AWS Blu Age Runtime provides a dedicated endpoint to allow existing JICS tra - 29. **What is the AWS Blu Age name of the classes that are used to define specific program behavior?** + 28. **What is the AWS Blu Age name of the classes that are used to define specific program behavior?** @@ -184 +180 @@ Each program is bound to a dedicated Configuration class which allows to specify - 30. **Which encoding has the following character sequence order: space, lowercase characters, uppercase characters, numerals?** + 29. **Which encoding has the following character sequence order: space, lowercase characters, uppercase characters, numerals?** @@ -188,5 +184 @@ Charsets belonging to the EBCDIC variants family (such as CP1047, CP297, etc). - 31. **How do you operate AWS Blu Age managed Runtime?** - -With the AWS Management Console, the AWS CLI, or the AWS APIs - - 32. **What are the pricing dimensions for AWS Blu Age Runtime?** + 30. **What are the pricing dimensions for AWS Blu Age Runtime?** @@ -196 +188 @@ AWS Mainframe Modernization-core-hours (See [AWS Mainframe Modernization pricing - 33. **What is the mechanism used to pass raw data through HTTP to the program endpoints?** + 31. **What is the mechanism used to pass raw data through HTTP to the program endpoints?** @@ -200 +192 @@ Base64 encoded strings. - 34. **How does a user launch a batch job run?** + 32. **How does a user launch a batch job run?** @@ -204 +196 @@ Using an HTTP call to one of the dedicated batch endpoint (see [batch endpoints - 35. **Which AWS Blu Age Runtime endpoint is the main entry point from the main web front-end application?** + 33. **Which AWS Blu Age Runtime endpoint is the main entry point from the main web front-end application?** @@ -208 +200 @@ Using an HTTP call to one of the dedicated batch endpoint (see [batch endpoints - 36. **What does AWS Blu Age JICS stand for?** + 34. **What does AWS Blu Age JICS stand for?** @@ -212 +204 @@ The AWS Blu Age JICS is the runtime component used to support the modernization - 37. **What AWS Blu Age Runtime caching mechanisms are available?** + 35. **What AWS Blu Age Runtime caching mechanisms are available?** @@ -216 +208 @@ AWS Blu Age Runtime supports multiple caching mechanisms, including Redis and Eh - 38. **How do we estimate the price of an AWS Mainframe Modernization AWS Blu Age Runtime deployment?** + 36. **How do we estimate the price of an AWS Mainframe Modernization AWS Blu Age Runtime deployment?** @@ -220 +212 @@ AWS provides estimates to customers based on their requirements and target archi - 39. **What is the AWS Mainframe Modernization AWS Blu Age Runtime price?** + 37. **What is the AWS Mainframe Modernization AWS Blu Age Runtime price?** @@ -224 +216 @@ AWS Mainframe Modernization offers two pricing models for AWS Blu Age: a Managed - 40. **What if we need to deploy an AWS Blu Age refactored application on an infrastructure not listed in the supported runtime?** + 38. **What if we need to deploy an AWS Blu Age refactored application on an infrastructure not listed in the supported runtime?** @@ -226 +218 @@ AWS Mainframe Modernization offers two pricing models for AWS Blu Age: a Managed -If you need to deploy an AWS Blu Age refactored application on an infrastructure not listed in the supported runtime, several options are available. First, check if your infrastructure is compatible with existing deployment options like Amazon EKS Anywhere or other container orchestration platforms. If so, you may be able to use the AWS Blu Age Runtime (non-managed). For non-compatible infrastructures, we recommend consulting with an AWS mainframe specialist to explore custom solutions or potential adaptations. You can also submit a Product Feature Request (PFR) for expanded infrastructure support. Alternative billing options may be available for non-standard deployments. Contact your AWS representative to discuss your specific needs and the best approach for your environment. +If you need to deploy an AWS Blu Age refactored application on an infrastructure not listed in the supported runtime, several options are available. First, check if your infrastructure is compatible with existing deployment options like Amazon EKS Anywhere or other container orchestration platforms. If so, you may be able to use the AWS Blu Age Runtime. For non-compatible infrastructures, we recommend consulting with an AWS mainframe specialist to explore custom solutions or potential adaptations. You can also submit a Product Feature Request (PFR) for expanded infrastructure support. Contact your AWS representative to discuss your specific needs and the best approach for your environment. @@ -228 +220 @@ If you need to deploy an AWS Blu Age refactored application on an infrastructure - 41. **How is the AWS Blu Age Runtime licensed? Is it open source?** + 39. **How is the AWS Blu Age Runtime licensed? Is it open source?** @@ -236 +228 @@ AWS Blu Age Runtime is not open source. It's AWS IP distributed as a cloud-nativ - 42. **How are changes and upgrades to AWS Blu Age frameworks and libraries managed ?** + 40. **How are changes and upgrades to AWS Blu Age frameworks and libraries managed ?** @@ -240 +232 @@ AWS Blu Age frameworks and libraries are updated through regular code generation - 43. **What are the supported version of tools (Tomcat, Postgres, Oracle, MQ, etc.) and dependencies (Spring, Angular, etc.) the AWS Blu Age Runtime uses ?** + 41. **What are the supported version of tools (Tomcat, Postgres, MQ, etc.) and dependencies (Spring, Angular, etc.) the AWS Blu Age Runtime uses ?** @@ -243,0 +236,4 @@ See details in [Release Notes](https://docs.aws.amazon.com/m2/latest/userguide/b + 42. **What does 'Standalone' mean in the context of BAC and JAC ?** + +Standalone refers to a special packaging and deployment mode for BAC (Blusam Administration Console) and JAC (JICS Administration Console) that allows these web applications to run independently in their own Tomcat server, separate from your modernized application. The BAC and JAC standalone versions are available into `aws-bluage-webapps-x.y.z.zip`. BAC and JAC non-standalone versions are available into `aws-bluage-runtime-x.y.z.zip` under `webapps-consoles` folder. See [AWS Blu Age Runtime artifacts](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-artifacts.html). + @@ -337 +333 @@ Windows Server, Linux server, and Docker Linux container. -While AWS Blu Age refactored applications are not designed to run on any infrastructure, they offer significant flexibility in deployment options. These applications can be deployed on various compute platforms, including cloud managed services, serverless compute, and on-premises infrastructure. AWS Blu Age provides both managed and non-managed runtime options, allowing organizations to choose between fully-managed convenience and customized control based on their specific needs and requirements. This flexibility enables easy movement across supported infrastructures, making AWS Blu Age refactored applications highly adaptable to different deployment environments. For more details, see [AWS Blu Age Runtime options](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-options.html) documentation. +While AWS Blu Age refactored applications are not designed to run on any infrastructure, they offer significant flexibility in deployment options. These applications can be deployed on various compute platforms, including cloud managed services, serverless compute, and on-premises infrastructure. @@ -343 +339 @@ SQS, IBM WebSphere MQ. - 4. **Into which application servers can a user deploy Java business application logic with AWS Mainframe Modernization non-managed runtime?** + 4. **Into which application servers can a user deploy Java business application logic with AWS Mainframe Modernization runtime?** @@ -357 +353 @@ The solution ensures scalability by transforming applications into cloud-native -After source code refactoring, two main steps occur. First, the refactored application is built. Second, the application is deployed and monitored in [AWS Mainframe Modernization AWS Blu Age Runtime](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime-ba.html). The deployment can be done either in an AWS-managed environment (AWS Mainframe Modernization managed runtime) where infrastructure is managed with automation, or in your AWS account ([AWS Mainframe Modernization AWS Blu Age non-managed Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-setup.html)) where customers manage their own infrastructure. The non-managed option can be deployed on various platforms, including [Amazon EC2](https://docs.aws.amazon.com/m2/latest/userguide/ba-deploy-ec2.html), ECS on EC2 or on [Fargate](https://docs.aws.amazon.com/m2/latest/userguide/ba-deploy-container.html), EKS on EC2. +After source code refactoring, two main steps occur. First, the refactored application is built. Second, the application is deployed. The deployment is done in your AWS account ([AWS Mainframe Modernization AWSBlu Age Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-setup.html)) where customers manage their own infrastructure and deploy on various platforms, including Amazon EC2, ECS on EC2 or on Fargate, EKS on EC2. @@ -359 +355 @@ After source code refactoring, two main steps occur. First, the refactored appli - 8. **How can I deploy and run an application modernized with AWS Blu Age on a custom Amazon Linux AMI, without using the AWS Mainframe Modernization (M2) managed service?** + 8. **How can I deploy and run an application modernized with AWS Blu Age on a custom Amazon Linux AMI?** @@ -361 +357 @@ After source code refactoring, two main steps occur. First, the refactored appli -This can be achieved by deploying the application using AWS Blu Age Runtime (non-managed) on Amazon EC2. The process involves creating a Java/Spring application with a dependency on the AWS Blu Age Runtime library and deploying it on a custom Amazon Linux AMI. For detailed instructions on this approach, see [Set up AWS Blu Age Runtime (non-managed) on Amazon EC2](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-deploy-ec2.html). +This can be achieved by deploying the application using AWS Blu Age Runtime on Amazon EC2. The process involves creating a Java/Spring application with a dependency on the AWS Blu Age Runtime library and deploying it on a custom Amazon Linux AMI. For detailed instructions on this approach, see [Set up AWS Blu Age Runtime on Amazon EC2](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-deploy-ec2.html). @@ -371,5 +367 @@ This can be achieved by deploying the application using AWS Blu Age Runtime (non -It is not possible for M2 Managed Runtime but it is for customer defined environment based on an Amazon Linux AMI and for on-premises or other cloud providers. - - 11. **How can I know the resource ARN of the SQS policy required to run AWS Blu Age non-managed if I want to scope it down?** - -To determine the specific SQS policy resource ARN for running AWS Blu Age non-managed with a scoped-down policy, please consult the delivery team or Technical Account Manager (TAM). They can provide account-specific guidance. For general information on SQS policies, refer to the AWS [SQS Policy](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html) documentation. +Yes, refer to [Set up AWS Blu Age Runtime on container](https://docs.aws.amazon.com/m2/latest/userguide/ba-runtime-deploy-container.html). @@ -377 +369 @@ To determine the specific SQS policy resource ARN for running AWS Blu Age non-ma - 12. **How does job scheduling work with batch?** + 11. **How does job scheduling work with batch?**