This page is part of my webdevster.com tutorial, see index to OpenQRM and XEN LVM based HVM VM.
[1.5] Step 5. Install OpenQRM Server
Three choices: Automatic, Dpkg, or SVN. I cover the manual installation of Dpkg.
Automatic Installation
Automatic installation installs 4.6 version. (at the time of this writing)
Add OpenQRM server to your sources.list
Follow instructions and use [OpenQRM configuration] for reference.
Manual Installation (I recommend)
Manual installation installs 4.7 version (at the time of this writing), either from svn or downloaded package. I will install by downloading latest build; deb package.
Install build tool:
prompt>apt-get install makeCreate directory and change dir where you will build the package
prompt>mkdir -p /dl/qrm && cd /dl/qrmDownload the source package (check for latest package, also note the following sourceforge download url might have changed since this article):
prompt>wget http://downloads.sourceforge.net/project/openqrm/openQRM-4.7/source/openqrm-4.7.tgzDecompress the package and change directory:
prompt>tar -zxvf openqrm-4.7.tgz && cd openqrm-4.7/srcCompile (takes a while, so go get some coffee)
prompt>makeAnd Finally install it:
prompt>make installStart the CLI wizard
prompt>make start
[1.6] Step 6. OpenQRM Installer Configuration
Prompt 1. Libphp-adodb
+-----------------------------------------¦ Configuring libphp-adodb +-----------------------------------------+ ¦ ¦ ¦ WARNING: include path for php has changed! ¦ ¦ ¦ ¦ libphp-adodb is no longer installed in /usr/share/adodb. New installation path is now /usr/share/php/adodb. ¦ ¦ ¦ ¦ Please update your php.ini file. Maybe you must also change your web-server configuraton. ¦ ¦ ¦ ¦ <Ok> ¦ ¦ ¦ +--------------------------------------------------------------------------------------------------------------+
Normal response; just select ok, and say thanks for the warning and incorrect spelling of configuration.
Prompt 2: MYSQL
+-----------------------------------------¦ Configuring mysql-server-5.0 +-----------------------------------------+ ¦ While not mandatory, it is highly recommended that you set a password for the MySQL administrative "root" user. ¦ ¦ ¦ ¦ If that field is left blank, the password will not be changed. ¦ ¦ ¦ ¦ New password for the MySQL "root" user: ¦ ¦ ¦ ¦ ________________________________________________________________________________________________________________ ¦ ¦ ¦ ¦ <Ok> ¦ ¦ ¦ +------------------------------------------------------------------------------------------------------------------+
Enter a ROOTMYSQLPASSWORD for root (mysql root password); different than the one you will assign to OpenQRM mysql user password (OpenQRMmysqlpassword), different than your present root system login (Debian root password), and different then the one you will assign to OpenQRM web user interface Administrator password (web interface password). This MySQL root account has super cow powers over all mysql dbs on this server, i.e. OpenQRM db. Therefore we will give OpenQRM a different mysql user password later. This has zero effect on present or future OpenQRM usability, and is recommended for security and best practices.
Prompt 3: DHCP
+------------------------------------------------------------¦ DHCP Server +------------------------------------------------------------+ ¦ ¦ ¦ Non-authoritative version of DHCP server ¦ ¦ ¦ ¦ The version 3 DHCP server is non-authoritative by default. ¦ ¦ ¦ ¦ This means that if a client requests an address that the server knows nothing about and the address is incorrect for that network ¦ ¦ segment, the server will _not_ send a DHCPNAK (which tells the client it should stop using the address). If you want to change this ¦ ¦ behavior, you must explicitly state in dhcpd.conf what network segments your server is authoritative for using the 'authoritative' ¦ ¦ statement. ¦ ¦ ¦ ¦ <Ok> ¦ ¦ ¦ +---------------------------------------------------------------------------------------------------------------------------------------+
Normal response and OpenQRM automates this for us with their dhcp plugin, just hit ok, and say Thanks for the information.
Debian will try to automatically start the dhcp3 service; it will say starting dhcpp server failed.
You can safely ignore the message.
Prompt 4: Samba Server
+------------------------------------------------------------¦ Samba Server +------------------------------------------------------------+ ¦ Please specify the workgroup you want this server to appear to be in when queried by clients. Note that this parameter also controls ¦ ¦ the domain name used with the security=domain setting. ¦ ¦ ¦ ¦ Workgroup/Domain Name: ¦ ¦ ¦ ¦ WORKGROUP_____________________________________________________________________________________________________________________________ ¦ ¦ ¦ ¦ <Ok> ¦ ¦ ¦ +----------------------------------------------------------------------------------------------------------------------------------------+
Enter domain, you can leave it WORKGROUP. In my example I entered, lc1.cloud1; you can easily change this later, if you changed your mind.
Prompt 5: Samba Server
+-------------------------------------------------------------¦ Samba Server +-------------------------------------------------------------+ ¦ ¦ ¦ If your computer gets IP address information from a DHCP server on the network, the DHCP server may also provide information about WINS ¦ ¦ servers ("NetBIOS name servers") present on the network. This requires a change to your smb.conf file so that DHCP-provided WINS ¦ ¦ settings will automatically be read from /etc/samba/dhcp.conf. ¦ ¦ ¦ ¦ The dhcp3-client package must be installed to take advantage of this feature. ¦ ¦ ¦ ¦ Modify smb.conf to use WINS settings from DHCP? ¦ ¦ ¦ ¦ <Yes> <No> ¦ ¦ ¦ +------------------------------------------------------------------------------------------------------------------------------------------+
Select, No.
Prompt 6: Postfix Configuration
+---------------------------¦ Postfix Configuration +---------------------------+ ¦ Please select the mail server configuration type that best meets your needs. ¦ ¦ ¦ ¦ No configuration: ¦ ¦ Should be chosen to leave the current configuration unchanged. ¦ ¦ Internet site: ¦ ¦ Mail is sent and received directly using SMTP. ¦ ¦ Internet with smarthost: ¦ ¦ Mail is received directly using SMTP or by running a utility such ¦ ¦ as fetchmail. Outgoing mail is sent using a smarthost. ¦ ¦ Satellite system: ¦ ¦ All mail is sent to another machine, called a 'smarthost', for delivery. ¦ ¦ Local only: ¦ ¦ The only delivered mail is the mail for local users. There is no network. ¦ ¦ ¦ ¦ General type of mail configuration: ¦ ¦ ¦ ¦ No configuration ¦ ¦ Internet Site ¦ ¦ Internet with smarthost ¦ ¦ Satellite system ¦ ¦ Local only ¦ ¦ ¦ ¦ ¦ ¦ <Ok> <Cancel> ¦ ¦ ¦ +-------------------------------------------------------------------------------+
Select No configuration, and hit ok, you’ll optionally configure this later, via prompt>dpkg-reconfigure postfix. You can Google search term, postfix gmail, for more information on setting up postfix with google smtp relay, gmail servers. What it is used for? OpenQRM server sends emails to subscribers regarding changes to OpenQRM, i.e. new VM request, passwords, VM changes, etc.. . This is extremely useful if are using OpenQRM as a business model (OpenQRM Resourcing). I am using OpenQRM solely to manage and deploy vms (OpenQRM Mngmt), so it is not vital, for us to set up initially.
OpenQRM will start automatically start.
Starting the OpenQRM-server ver. 4.7.
Initialization complete. Please configure your OpenQRM Server at: http://[server-ip-address]/OpenQRM/
-> User: OpenQRM -> Password: OpenQRM
[1.7] Step 7. Database Configuration
Setup OpenQRM mysql db, user, and password
Login to mysql as root
prompt>mysql -u root -pCreate Database:
mysql_prompt>create database openqrm; Create Username, Password, and Privileges. You can use whatever username you like, I happened to use openqrmusr: (Note: the double quotes are single quotes)
mysql_prompt>GRANT ALL PRIVILEGES ON openqrm.* TO openqrmusr@localhost IDENTIFIED BY “OpenQRMmysqlpassword”; mysql_prompt>flush privileges; mysql_prompt>exit
[1.8] Step 8. OpenQRM Web Interface Manager Configuration
Login
Login from your laptop or if you installed GUI, i.e. Gnome, on Debian than you can access from it’s web browser.
http://10.1.11.10/openqrm
http://localhost/openqrm
OpenQRM Web Interface Wizard is done in three easy steps.
Login to OpenQRM with your web browser.
If you have NoScript add-on on Firefox, allow 10.1.11.10, before you start.
1st step. NIC selection
OpenQRM Configuration Manager
This Wizard will help you to configure your OpenQRM Server in 3 simple steps.
Please select a network card.
The selected network card will be used to setup OpenQRM Server and create the OpenQRM Management Network. All available and configured network interfaces on this system are listed on the right.
- Select br0, and select next. (should only be one selection, based on this tutorial)
2nd step. DB type selection
OpenQRM Configuration Manager
Please select a Database type.
Select the Database type to use for storing the OpenQRM data.
- Select mysql, and select next. (should only be one selection, based on this tutorial)
3rd step. DB Authentication
OpenQRM Configuration Manager
Configure the Database connection.
Fill in the Database name, the Database Server and a username plus password to setup the Database connection.
- Database Server: localhost
- Database Name: openqrm
- Database User: openqrmusr
- Database Password: OpenQRMmysqlpassword
Click initialize.
It will take a while, because it’s populating the tables in the db. Also, notice how you can have your db on another server instead of localhost. If it fails to initialize, and you double checked your installation, than reboot the machine and try again.
Success Message:
OpenQRM Configuration Manager
Successfully initialized the OpenQRM Server
Access the OpenQRM Admin UI
(automatic forwarding in 10 seconds)
Your open-source Cloud computing platform
Your OpenQRM WebUI will look like this:
Very pretty, simple, but ever so powerful, webUI. You can login to OpenQRM WebUI and look around, just don’t configure anything. Also, there is really nothing to do here, until we activate and start plugins; that will be done in Chapter 3 - Integrating OpenQRM with Xen.
Check if everything is successful; good idea to reboot.
prompt>rebootDon’t worry about the dhcpd3check, Failed, as this will be configured automatically with OpenQRM dhcp plugin.
You are done with OpenQRM Server Installation. On to the next page 4, Chapter 2 - Install Xen and VM.
" OpenQRM and XEN LVM based HVM VM. "
I loved this example of how to OpenQRM and XEN servers. It is a truly a complete installation guide. Incredible artcile.
" OpenQRM and XEN LVM based HVM VM. "
Thanks for the effort you took in writing this article. It really helped me with my first OpenQRM setup!
Loved it!
" OpenQRM and XEN LVM based HVM VM. "
Hi,
A really cool how to about Openqrm, especially when it is pretty hard to find a similar article related Openqrm on the Internet.
We are testing this product at the moment. Just want to know if you have the experience of integrating Openqrm with a iSCSI storage application, like Openfiler or similar applications.
Thanks for this excellent contribution.
" OpenQRM and XEN LVM based HVM VM. "
Thanks a ton for This post! Very Informative. Got Exactly what i was looking for. keep it up.
" OpenQRM and XEN LVM based HVM VM. "
@Colin
Thanks for your kind words, and great sentence structure; you must be an English major.
You asked about, “Openqrm with a iSCSI storage application, like Openfiler”, well it’s like netapp filer (cha-ching) and openQRM, but you and the whole world already new that. OpenQRM targets iSCSI model apps, after all it’s a cloud right, and you need a lot of space. I am by no means an expert on Openfiler, netapp, or other iSCSI storage apps. But I hope soon I’ll own some, because that means I’m doing pretty good, ay.
I can tell you, openQRM is pluggable into almost every environment. So you can merry along with any virtual environment backed by almost any storage app, and openQRM will plug right in and manage it. And if you rather use their proprietary applications to manage, you can also do that as well without interference. Well I hope this all made sense, because it made no sense to me, JK.
Also here is good read on iSCSI.
" OpenQRM and XEN LVM based HVM VM. "
I don’t see “Vol” on this Step “Verify Logical Volume Storage on XEN Host (x01-lc1-cloud1-lvm)”
Error during selecting volume group ! Please check the Event-Log
" OpenQRM and XEN LVM based HVM VM. "
Thank you for this great howto, this made it so much easier to setup a POC for a project I was hoping to do. I have run into one annoying glitch. OpenQRM rewrites the vm config files in /etc/xen. So any xen config file options that I enter, like usbdevice=’tablet’, just gets erased. I was told to enter them in the xen_generate_vm_config function in /usr/share/openqrm/plugins/xen/bin/openqrm-xen, but I have tried, and this does not work. This seems like such a small thing, but until I can add options to the xen config file when the vm is generated, this program just misses the mark. Have any of you solved this. Your suggestions would be appreciated.