This Quick Start automatically deploys a highly available, production-ready IBM MQ server on the Amazon Web Services (AWS) Cloud in about 30 minutes, into a configuration of your choice.
IBM MQ is messaging middleware that simplifies and accelerates the integration of diverse applications and business data across multiple platforms. It uses message queues to facilitate the exchange of information, and offers a single messaging solution for cloud, mobile, the Internet of Things (IoT), and on-premises environments. The IBM MQ service on AWS will support client messaging applications from within your virtual private cloud (VPC), from trusted addresses on the internet, and via a VPN from your on-premises environment.
This Quick Start deploys IBM MQ into a VPC in your AWS account. You can build a new VPC for IBM MQ, or deploy the software into your existing VPC. The deployment and configuration tasks are automated by AWS CloudFormation templates that you can customize during launch.
This Quick Start was developed by IBM in collaboration with AWS. IBM is an
AWS Competency Partner.
What you'll build
How to deploy
Cost and licenses
What you'll build
Use this Quick Start to set up the following configurable environment on AWS:
- A virtual private cloud (VPC) that spans two Availability Zones and includes two public and two private subnets, for security and high availability.*
- An internet gateway to allow access to the internet.*
- In a public subnet, a bastion host to provide secure Secure Shell (SSH) access to the IBM MQ server. The bastion host is in an Auto Scaling group of 1, ensuring there will always be one host available.*
- In a private subnet, an IBM MQ server in an Auto Scaling group of 1.
- Amazon Elastic File System (Amazon EFS) automatically mounted on the IBM MQ server instance for distributed storage, to ensure high availability of the queue manager service and the message data. If the IBM MQ server fails in one Availability Zone, a new server is created in the second Availability Zone and connected to the existing data so no persistent messages are lost.
- Elastic Load Balancing to automatically distribute connections to the active IBM MQ server.
- An IAM instance role with fine-grained permissions for access to AWS services necessary for the deployment process.
- Appropriate security groups for each instance or function to restrict access to only necessary protocols and ports. For example, access to HTTP server ports on Amazon EC2 servers is limited to Elastic Load Balancing.
* The template that deploys the Quick Start into an existing VPC skips the tasks marked by asterisks and prompts you for your existing VPC configuration.
How to deploy
Deploy IBM MQ on AWS in about 30 minutes, by following a few simple steps:
- If you don't already have an AWS account, sign up at https://aws.amazon.com.
- Sign up for an IBM MQ program license, and save your license key file in an S3 bucket. (If you don't have a program license, the Quick Start will automatically sign you up for a 90-day trial period.)
- Launch the Quick Start. You can choose from two options:
- Connect to IBM MQ through a web console to verify the deployment.
- Connect to the IBM MQ server instance through the bastion host instance in your VPC.
During deployment, you can configure AWS infrastructure components, IBM MQ instance settings, and IBM MQ administration credentials.
Cost and licenses
You are responsible for the cost of the AWS services used while running this Quick Start reference deployment. There is no additional cost for using the Quick Start.
The AWS CloudFormation template for this Quick Start includes configuration parameters that you can customize. Some of these settings, such as instance type, will affect the cost of deployment. See the pricing pages for each AWS service you will be using for cost estimates.
This Quick Start requires a license for IBM MQ. To use the Quick Start in your production environment, sign up for an IBM MQ program license at IBM developerWorks. You’ll need to place the license key in an S3 bucket and specify its location when you launch the Quick Start.
If you don’t have a license file, the Quick Start will deploy an IBM MQ trial license, which allows 90 days of free usage in a non-production environment. After this time, the queue manager will expire. You can purchase support at an additional cost, or use the forums.
If the license file is in place at stack creation time, the IBM MQ server will automatically use the production license. To upgrade from a trial license to a production license after deployment, follow the instructions in the IBM Knowledge Center.
For more information about licensing terms, see the IBM MQ software license agreement.