View source for Cloud Zones - Manage Different Data Centre locations

[[Category:Tutorial]]
[[Category:Cloud]]
[[Category:Management]]
[[Category:Data Centre]]
This How-To is about how to create and manage multiple openQRM Clouds in multiple datacentre locations on Debian with openQRM.

openQRM-Enterprise Cloud Zones is a logical layer on top of openQRM Cloud. It is the central point for the openQRM private Cloud self-service (IAAS) and interfaces with all integrated openQRM Clouds via the well defined openQRM Cloud SOAP API. Cloud Zones supports to split one or more openQRM Cloud into multiple logical zones. For each Cloud Zone the Administrator can define fine grained permissions, dedicated hardware- and network-pools which can be assigned to Cloud User groups. Also Cloud Zones is the central point of billing for all IT-Services including a generic billing-system for external cost allocation which can be easily integrated to existing billing-system such as QuickBooks or SAP.

Those features of openQRM Enterprise Cloud Zones allowing to map an existing business topology 1:1 to a global accessible private Cloud infrastructure.

Please notice that openQRM Enterprise Cloud Zones is an openQRM Enterprise feature which is only available in the openQRM Enterprise Edition. For more info please check the Edition Comparison at <nowiki>http://www.openqrm-enterprise.com/products/edition-comparison.html</nowiki>

=== Requirements ===

* One (or more) physical Server
* at least 1 GB of Memory
* at least 100 GB of Diskspace
* VT (Virtualization Technology) enabled in the Systems BIOS so that the openQRM Server can run Virtual Machines later

=== Install openQRM on Debian ===
Install a minimal Debian on a physical Server.

Install and initialize openQRM

'''NOTE'''

If you have not already installed openQRM in Debian, a detailed How=To  is available at [[Install openQRM on Debian]]

For this How-To we assume you have successfully completed the [[Cloud Computing with openQRM|Cloud Computing with openQRM on Debian]] How-To

=== Decide where to install Cloud Zones ===
openQRM Enterprise Cloud Zones 'talks' to all integrated openQRM Clouds via the openQRM Cloud SOAP API. That means Cloud Zones is completely independent from an existing openQRM Cloud installation and can be run on a dedicated system. For this How-To we are going to use the openQRM Cloud setup in the [[Cloud Computing with openQRM|Cloud Computing with openQRM on Debian]] How-To to also run openQRM Enterprise Cloud Zones.

=== 1. Enabling Plugins ===
'''Hint:''' You can use the filter in the plugin list to find plugins by their type easily!

In the openQRM Plugin Manager please make sure to enable and start the following plugins in the sequence below:

* dns plugin - type ''Networking''
* dhcpd plugin - type ''Networking''
* tftpd plugin - type ''Networking''
* network-manager plugin - type ''Networking''
* local-server plugin - type ''Misc''
* device-manager plugin - type ''Management''
* novnc plugin - type ''Management''
* sshterm plugin - type ''Management''
* linuxcoe plugin - type ''Deployment''
* puppet plugin - type ''Deployment''
* kvm plugin - type ''Virtualization''
* cloud plugin - type ''Cloud''
* ip-mgmt plugin - type ''Enterprise''
* cloud-zones plugin - type ''Enterprise''
[[File:01-openqrm-cloud-zones.png|none|thumb|390x390px|Plugin Manager]]
Assuming you started with the How-To [[Cloud Computing with openQRM|Cloud Computing with openQRM on Debian]], just the cloud-zones and ip-mgmt plugin needs to be enabled and started. The other plugins should be already setup from the previous How-To.

=== 2. Network Pool configuration ===
Go to Plugins -> Enterprise -> IP Management -> Networks and click on 'Add a new network'
[[File:02-openqrm-cloud-zones.png|none|thumb|390x390px|IP Address Manager]]
Fill in the network pool details. Here we create a part of the class C network 192.168.88.0 (from 192.168.88.180 to 192.168.88.190) as a logical IP address pool with the name 'default'.
[[File:03-openqrm-cloud-zones.png|none|thumb|390x390px|Enter Network details]]
Later we are going to assign this network pool to the 'default' Cloud User group.
[[File:04-openqrm-cloud-zones.png|none|thumb|390x390px|IP Address Manager]]
Feel free to create more network pools according to the Cloud User groups you plan. Here we are adding two more network pools to assign them for the QA and Development Cloud User group later.

=== 3. Cloud Zones configuration ===
Go to Plugins -> Enterprise -> Cloud Zones -> Config -> Setup and click on update
[[File:06-openqrm-cloud-zones.png|none|thumb|390x390px|Main cloud zones configuration]]
Configure the following items

* ''cloud_zones_admin_email'' -> your mail address (default root@localhost on the openQRM server)
* ''cloud_zones_external_url'' -> the external accessible URL for the Cloud Zones Portal. We are using the IP of the openQRM Server here
* ''cloud_zones_user_hostnames'' -> If true Cloud Users are able to set their own hostnames, set to false
* ''cloud_zones_show_portal'' -> disables/enables the Cloud Zones Portal, set to true
* ''cloud_zones_show_login'' -> disables/enables the Cloud Zones Portal login, set to true
* ''cloud_zones_google_maps'' -> openQRM Enterprise Cloud Zones shows where your system are located via Google Maps, set to true
* ''cloud_zones_show_apps'' -> if to show the Puppet applications for Cloud Zones deployment, set to true
* ''cloud_zones_show_ips'' -> if to show the network-pools, set to true
* ''cloud_zones_auto_ccu'' -> if to give new Cloud Users automatically some CCUs (Cloud currency), keep the 0
* ''cloud_zones_max_network'' -> how many network interfaces to allow for Cloud Zones deployment, keep the 4
[[File:07-openqrm-cloud-zones.png|none|thumb|390x390px|Click confirm]]

=== 4. Create Cloud Zones User Groups ===
Go to Plugins -> Enterprise -> Cloud Zones -> Config -> Groups and click on new
[[File:08-openqrm-cloud-zones.png|none|thumb|390x390px|New Cloud Zone User Group]]
A 'default' Cloud User group is automatically created during initialization of the Cloud Zones plugin. Please add two more Cloud Zones User groups, 'qa' and 'development'
[[File:09-openqrm-cloud-zones.png|none|thumb|390x390px|Add 'QA' and 'Development']]

=== 5. Create Cloud Zones Users ===
Go to Plugins -> Enterprise -> Cloud Zones -> Config -> Users and click on new
[[File:10-openqrm-cloud-zones.png|none|thumb|390x390px|Cloud Zones User Manager]]
Add a new Cloud Zones User.

'''NOTE''' Make sure to use a valid email address for the Cloud Users! root@localhost will not work!
[[File:11-openqrm-cloud-zones.png|none|thumb|390x390px|Enter User credentials]]
The new Cloud Zones User got added successfully.
[[File:12-openqrm-cloud-zones.png|none|thumb|390x390px|New User]]
Please add two more Cloud Zones Users, 'qauser' and 'devuser'. Put each of the Cloud Zones User in a different Cloud Zones User Group.
[[File:13-openqrm-cloud-zones.png|none|thumb|390x390px|Add 'qauser' and 'devuser']]

=== 6. Create the Cloud Zones ===
Go to Plugins -> Enterprise -> Cloud Zones -> Zones and click on new
[[File:14-openqrm-cloud-zones.png|none|thumb|390x390px|Click 'New']]
Create a new 'default' Cloud Zone as shown in the following screenshot
[[File:15-openqrm-cloud-zones.png|none|thumb|390x390px|New Cloud Zone]]
Please also scroll down the form to configure the short-cuts. The short-cuts are used to e.g. automatically create hostnames according to your configured naming convention.
[[File:16-openqrm-cloud-zones.png|none|thumb|390x390px|Configure Short Cuts]]
Here the new 'default' Cloud Zone got added successfully.
[[File:17-openqrm-cloud-zones.png|none|thumb|390x390px|Default Cloud Zone]]
Please add two more Cloud Zones for 'qa' and 'development'.
[[File:18-openqrm-cloud-zones.png|none|thumb|390x390px|Add two more]]

=== 7. Assign the Cloud Zones to Cloud Zones User Groups ===
Go to Plugins -> Enterprise -> Cloud Zones -> Config -> Groups and click on 'Edit' of the 'default' Cloud Zones User Group.
[[File:19-openqrm-cloud-zones.png|none|thumb|390x390px|Click edit on default Cloud Zone User Group]]
For the 'default' Cloud Zones User group select all 3 available Cloud Zones.
[[File:20-openqrm-cloud-zones.png|none|thumb|390x390px|Select all 3]]
For the 'qa' and 'dev' Cloud Zones User group select only the specific 'qa' and 'dev' Cloud Zones.
[[File:21-openqrm-cloud-zones.png|none|thumb|390x390px|Only select respective Cloud Zones]]

=== 8. Setup the openQRM Cloud as a Cloud Zones Client ===
Go to Plugins -> Cloud -> Configuration -> Main Config and click on update
[[File:22-openqrm-cloud-zones.png|none|thumb|390x390px|Click Update]]
Update the following items

* ''cloud_zones_client'' -> set to true
* ''cloud_zones_master_ip'' -> use the openQRM Server IP address
* ''cloud_external_ip'' -> use the openQRM Server IP address
[[File:23-openqrm-cloud-zones.png|none|thumb|390x390px|Update items]]

=== 9. Enable SSL/HTTPS ===
Since openQRM Cloud Zones 'talks' to the integrated openQRM Clouds via SOAP it requires to have the openQRM webserver configured with SSL/https. To do this please open a terminal on the openQRM Server as 'root' and run the following commands:<blockquote><code>cat /usr/share/openqrm/plugins/cloud/etc/httpd/openqrm-https.conf | sed -e "s#@@OPENQRM_SERVER_BASE_DIR@@#/usr/share#g" | sed -e "s#@@OPENQRM_WEBSERVER_DOCUMENT_ROOT@@#/var/www#g" | sed -e "s#server.crt#openqrm.crt#g" | sed -e "s#server.key#private.key#g" > /etc/apache2/conf.d/openqrm-https.conf</code>

<code>cd /usr/share/openqrm/plugins/cloud/bin</code>

<code>./openqrm-cloud-manager enable-ssl</code>

<code>mv /usr/share/openqrm/plugins/cloud/etc/ssl/cerst /usr/share/openqrm/plugins/cloud/etc/ssl/certs</code>

<code>/etc/init.d/apache2 restart</code></blockquote>
[[File:24-openqrm-cloud-zones.png|none|thumb|390x390px|Terminal]]
In the moment SSL/https is setup openQRM Cloud Zones starts to sync Cloud Users, Permission, CCUs and other items into the integrated openQRM Cloud. Please notice that there are now 3 error events in the integrated openQRM Cloud Server to notify about the sync process and user creation. Those event are not critical but just notifier and can be removed.
[[File:25-openqrm-cloud-zones.png|none|thumb|390x390px|3 error events should occur]]
Looking at Plugins -> Cloud -> Users we can see that the Cloud Zones Users got created correctly.
[[File:26-openqrm-cloud-zones.png|none|thumb|390x390px|Cloud Zone Users that got created correctly]]

=== 10. Assign Network pools to Cloud Zones User Groups ===
Go to Plugins -> Cloud -> Configuration -> Ip-Mgmt and click on 'Update' of the 'default' network pool.
[[File:27-openqrm-cloud-zones.png|none|thumb|390x390px|Update the default network pool]]
For the 'default' network pool select the 'default' Cloud User group.
[[File:28-openqrm-cloud-zones.png|none|thumb|390x390px|Select default Cloud User group]]
Also assign 'qa' and 'dev' network pools to the specific 'qa' and 'dev' Cloud Zones User group.
[[File:29-openqrm-cloud-zones.png|none|thumb|390x390px|Assign respective network pools to Cloud Zones]]

=== 11. Create a VM in Cloud Zones ===
Go to Plugins -> Enterprise -> Cloud Zones -> Portal to login to openQRM Enterprise Cloud Zone as a Cloud Zone User
[[File:30-openqrm-cloud-zones.png|none|thumb|390x390px|Login as Cloud Zone User]]
openQRM Enterprise Cloud Zones automatically logs into the first available Cloud Zones the Cloud Zones User has permissions on. Here's the 'qa' Cloud Zone. 

To switch to the 'default' Cloud Zone simply click on the small Cloud icon with the 'default' name.
[[File:31-openqrm-cloud-zones.png|none|thumb|390x390px|Cloud Zone Overview]]
Here we are in the 'default' Cloud Zone now. A map shows you where your Cloud Zone is located.
[[File:32-openqrm-cloud-zones.png|none|thumb|390x390px|Default Cloud Zone]]
Please click on 'create' in the 'default' Cloud Zone
[[File:33-openqrm-cloud-zones.png|none|thumb|390x390px|Click on 'Create']]
Set up your Cloud Zones request by configuring the VM requirements. To create the new VM in the 'default' Cloud Zone click on 'submit'
[[File:34-openqrm-cloud-zones.png|none|thumb|390x390px|Configure VM requirements]]
Short time later Cloud Zones sends out a mail to the user with the IP address, hostname and login credentials. Here we login to the new created Cloud VM through a regular terminal.
[[File:35-openqrm-cloud-zones.png|none|thumb|390x390px|Login through Terminal]]
An embedded SSH Terminal is also available directly in the Cloud Zones Portal System overview. Please select a system and click on 'login'
[[File:36-openqrm-cloud-zones.png|none|thumb|390x390px|Select a system and click on 'login']]
Here's screenshot of the Web SSH-Login to the new created Cloud VM.
[[File:37-openqrm-cloud-zones.png|none|thumb|390x390px|Web SSH-Login to the new created Cloud VM]]
The selected Webserver application also got automatically deployed and the webserver on the new created system is up + running
[[File:38-openqrm-cloud-zones.png|none|thumb|390x390px|Webserver is up and running]]
Here's a screenshot of Cloud Zone Users Account details.
[[File:39-openqrm-cloud-zones.png|none|thumb|390x390px|Cloud Zone User Account details]]
A list overview about the available Cloud Zones is available too.
[[File:40-openqrm-cloud-zones.png|none|thumb|390x390px|Overview of available Cloud Zones]]
Here's a screenshot of the transaction list for the Cloud Zone User with detailed information about the billing.
[[File:41-openqrm-cloud-zones.png|none|thumb|390x390px|Transaction List]]
Congratulations!!! You have successfully setup openQRM Enterprise Cloud Zones!

=== Add more functionalities to your openQRM Setup ===
To continue and further enhance your openQRM KVM Virtualization Setup there are several things to do:

* Enable the high availability plugin to automatically gain HA for your server
* Enable the hybrid-cloud plugin to automate your Amazon EC2 and Eucalyptus deployments
* Enable further Virtualization plugins and integrate remote Virtualisation hosts for a fully distributed Cloud environment
* Enable further Storage and Deployment plugins to automatically provision your Virtualization Hosts and other physical systems
* … and more.