Deploy on AWS into a new VPC

For step-by-step instructions to deploy and get started with IBM MQ on AWS, see the Quick Start deployment guide.

This Quick Start was created by IBM in partnership with AWS. For more information about IBM MQ, see the IBM website.

IBM_Logo_156x67


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 VPC, from trusted addresses on the Internet, and via a VPN from your on-premises environment.

This Quick Start deploys IBM MQ into a virtual private cloud (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.

  • 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.
    • Your choice to create a new VPC or deploy into your existing VPC on AWS. The template that deploys the Quick Start into an existing VPC skips the components marked by asterisks above.


    For details, see the Quick Start deployment guide.

  • Deployment details

    Deploy IBM MQ on AWS in about 30 minutes, by following a few simple steps:

    1. Sign up for an AWS account.
    2. 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.)
    3. Launch the Quick Start into a new VPC, if you want to build a new AWS infrastructure for your deployment.
      -or-
      Launch the Quick Start into an existing VPC, if you already have your AWS environment set up.
    4. Connect to IBM MQ through a web console to verify the deployment.
    5. 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. For detailed deployment and configuration instructions, see the Quick Start deployment guide.

  • 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.