Setting Up Private Cloud on Amazon EC2

From openQRM

This How-To is about how to easily run your own private IaaS Cloud on Amazon EC2

First login to your Amazon Account

Login to Amazon Account

Then point your browser to openQRM Enterprise Amazon Edition on the Amazon Marketplace and click on 'Continue'

Navigate to openQRM Enterprise Amazon Edition

Configure the region in which you want to start your openQRM Enterprise Cloud. Then click on "Launch-with-1-Click".

Select Region

Your openQRM Enterprise Amazon Edition instance is now starting.

Instance is now starting

Follow the Usage-Instructions.

Please use an SSH-Client to login into the openQRM instance with the keypair your have specified on launch.

Use an SSH-Client

Now point your browser to the public IP address of the openQRM instance and login with the "Initial Administrator" credentials shown in the step above.


Welcome to your ready-to-use openQRM Enterprise Amazon Edition!

Configuring your private Cloud on Amazon EC2

This section explains the minimal configuration requirements for the openQRM Enterprise Amazon Edition

Login to your openQRM Enterprise Server


In the plugin menu click on 'Cloud -> Amazon Cloud -> Actions" and add a new account

Navigate through 'Cloud -> Amazon Cloud -> Actions'

Add an account name and your Amazon access key and secret access key. You get both keys from the account section in Amazon EC2.

Add account name and access key

Copy the new created account ID.

Copy newly creates account ID

Now edit /usr/share/opernqrm/plugins/amazon/etc/openqrm-plugin-amazon.conf

Edit config file

Edit the parameter OPENQRM_PLUGIN_AMAZON_CLOUD_DEFAULT_ACCOUNT and insert the account ID from created account.

Edit the Parameter

Also configure OPENQRM_PLUGIN_AMAZON_CLOUD_DEFAULT_KEYPAIR parameter with your personal key-pair from your Amazon EC2 account.

Configure other parameter

Follow this URL in your browser: and find an AMI for the region you want to deploy it in.

Navigate to this page

Here we use the official Debian Jessie AMI in the "eu-central1" region. Please notice that the "eu-central1" region is the configured as default in your openQRM Enterprise Amazon Edition!

Use the Debian Jessie AMI

Go to "Cloud -> Amazon Cloud -> Actions -> AMIs"

Select Account screen

Set the filter to 'd' and search for the AMI name of the official Debian Jessie AMI.

Filter to the letter 'a'

Add the Debian Jessie AMI to openQRM.

Add AMI to openQRM

Go to "Cloud -> Configuration -> Images".

Navigate to images

Edit the added AMI image.

Click 'update'

Set the Cloud-User to "Everybody" and submit.

Set Cloud-User to 'Everybody'

Now got to "Cloud -> Configuration -> Products".

Navigate to 'Products'

Add a new "size" Cloud product. Here we use "t2.micro".

Use "t2.micro"

Now you can login to the openQRM Enterprise Cloud Portal by clicking on "Cloud -> Portal".

You can login to the openQRM Enterprise Cloud Portal with the the username "openqrm" and the same password as for the main openQRM Enterprise administration UI.

Login to Cloud Portal

Here the openQRM Enterprise Cloud User Dashboard. Please click on "New Instance".

Click on 'New Instance'

Set the disk size to 50GB.

Set disk size to 50GB

Submit your request.

Submit request

openQRM now fully automatically deploys the new instance now.

Automatic Deployment

To check you can take a look at the Amazon EC2 console

Viewing the Amazon EC2 console

The openQRM Enterprise Cloud has sent a mail to the cloud user. You can read it by running in a terminal console

cat /var/spool/mail/nobody
Check mail in terminal console

You can now SSH login to the new created instance with the credentials sent by mail.

Use SSH login

Here the active instance in the openQRM Enterprise Cloud Portal.

Active Instance


You now have your own private Cloud on Amazon EC2