Red Hat AMQ on Azure

Microsoft Azure Installation and Support guide

1. Overview

This guide will provide step by step instructions how to start using the installed products on your Microsoft Azure instance.

This Azure Virtual Machine  contains a ready-to-run Red Hat AMQ image at the selected version. In order to use this image, you need to launch it with your selected type, and log in via SSH to activate it.

Visit the Red Hat AMQ page on the Microsoft Azure Marketplace

2. Launching an instance

In order to launch Red Hat AMQ instance, a few settings need to be configured on the Azure console as follows:

  1. Open new Azure Virtual Machine wizard;
  2. Select the Red Hat AMQ Azure image based on your requirements from gallery;
  3. Choose VM name, size, Authentication user and credentials. The Standard DS2V2/General Purpose type or larger is recommended when running Red Hat AMQ.  Basic DS1V2 is the minimal requirement, which will be sufficient to run Red Hat AMQ. Larger instances may be required based on the number of Red Hat AMQ required and the expected resource use of each;
  4. Define cloud service DNS name, Regions and open endpoint ports.
Port 22 to connect via SSH (enabled by default)

 3. Initial login and setup

The Red Hat AMQ product is shipped with a base binary installation. On the first login to the instance, you will be placed into a console wizard. The following is an overview of the steps you will be guided through to create the required profiles on the instance:

  1. Log onto the instance via SSH with your Azure user and credentials.
  2. Once the admin user is logged in, please log in as the  ‘amq-broker’ user via the command ‘sudo su – amq-broker’.
  3. You are ready to use Red Hat AMQ.

Once the VM instance has started up:

  1. Log onto the instance via SSH as the ‘azureuser’ user, using the key you selected above.  For example:
    • Via SSH from your desktop, for example
      ssh -i ./MidVisionUSMC.pem azureuser@[public-ip-address]
  2. Type sudo su - amq-broker
  3. You should see the MidVision banner and then you are placed in a setup wizard.
    Welcome to                                                                                                                                             
    
     __  __ _     ___     ___     _                    ____ _                 _
    |  \/  (_) __| \ \   / (_)___(_) ___  _ __        / ___| | ___  _   _  __| |
    | |\/| | |/ _` |\ \ / /| / __| |/ _ \| '_ \ _____| |   | |/ _ \| | | |/ _` |
    | |  | | | (_| | \ V / | \__ \ | (_) | | | |_____| |___| | (_) | |_| | (_| |
    |_|  |_|_|\__,_|  \_/  |_|___/_|\___/|_| |_|      \____|_|\___/ \__,_|\__,_|
    
                                                           A MidVision Service
    
            * WebSite: https://www.midvisioncloud.com/product-category/microsoft-azure-marketplace
            * Support: http://support.midvision.com/redmine/projects/devtestcloud
            * Forum:   https://www.midvisioncloud.com/community      
    
    Welcome, this is MidVisionCloud Red Hat AMQ image.
    
    You can find your Red Hat AMQ installation under /opt/redhat/amq-broker/amq-broker-7.7.0 Please run 'sudo su - amq-broker' to start using provided services.

4. Accessing the Red Hat AMQ installation

4.1 Access the Red Hat AMQ installation

Confirm installation. The Red Hat AMQ installation is available under:

/opt/redhat/amq-broker/amq-broker-7.7.0

The owner of this installation is the ‘amq-broker’ OS user, which password is set to your [instanceId]

5. Maintaining the installation

The following sections cover some of the activities you might want to perform after the instance has been started.
  • amq-broker: This is the default user, which you can log in as. It is permitted to use all SUDO rights. To switch to the root user, type “sudo su“.
  • root: This is the superuser in linux systems. You can log in as any other user without using passwords. E.g: “su azureuser“, “su amq-broker
  • azureuser: The Azure default user.

6. Troubleshooting

6.1 Session loss during setup

If you lose your SSH connection to the target instance during the first run setup script execution (e.g. as a result of a network problem), we advise you to delete and recreate the Azure instance and run the script again.

6.2 Contacting MidVision support

Please visit our support website.