This document explains how to quickly install openQRM in a "Centos 4.x" environment.

1. Download and untar/unzip the binary openQRM installation package.
2. Install a mysqld server (you can use an existing one in your network). openQRM is certified to work with MySQL 4.1.9 using InnoDB.
   yum install mysql mysql-server mysql-clients
   ln -sf /usr/qrm/etc/my.cnf /etc/my.cnf
   chkconfig mysqld on
   service mysqld start
3. Determine one network interface to use for the openQRM-network
4. Edit the "etc/qrm.ini" file within the openQRM installation directory to fit your needs.
   It is important to change the "Server_Interface" parameter to the interface name chosen above and ensure that the database-related parameters fit your mysqld-server.
   (Find more information about both required and optional parameters in the installation how to.)
      sed -i -e "s#/tmp/mysql.sock#/var/lib/mysql/mysql.sock#" /usr/qrm/etc/qrm.ini
      cat >> /etc/sysconfig/network-scripts/ifcfg-eth0:qrm < an example for qrm ip
      NETMASK=255.255.0.0
      BROADCAST=10.102.255.255
      NETWORK=10.102.0.0
      DEVICE=eth0:qrm
      EOF
      ifup eth0:qrm
      ifconfig eth0:qrm
5. Run the openQRM installation by "./qrm-install".
   When the installation is finished, the openQRM-server is running and ready to use.
6. Optional Post-configuration
• In the case that an external dhcpd-server is used instead of the dhcpd-plugin, it must be configured according to the openQRM user-guide.
• In the case that an external tftp-server is used instead of the tftp-plugin, it must be configured according to the open

Related tasks in the openQRM documentation:

• Simple dhcpd configuration
• Booting up a PXE-enabled system in the openQRM-network
• Creating a custom boot-image
• Creating a custom filesystem-image
• Configuring and managing a virtual-environment

Simple dhcpd configuration

In the case that the dhcpd is not used but instead an already existing dhcpd-server is used,
we have listed configuration examples for static and dynamic ip-configuration:

#########################################################
# static ip configuration per host

default-lease-time 21600;
max-lease-time 21600;
ddns-update-style ad-hoc;

option subnet-mask [subnet-mask];
option broadcast-address [broadcast-address];
option routers [default-gw];
option domain-name-servers [dns-server-ip];
option domain-name "[domain-name]";

subnet [network-address] netmask [subnet-mask] {
 
 host node1 {
  hardware ethernet [mac-address-of-node1];
  fixed-address [ip-address-for-node1];
  next-server [tftp-server-ip/qrm-sever-ip];
  filename "/pxelinux.0";
 }

}
#########################################################

To use dynamic ip configuration by ranges, simply replace the host part of the above example with:

   range [first-ip-in-range] [last-ip-in-range];
   next-server [tftp-server-ip/qrm-sever-ip];
   filename "/pxelinux.0";

Booting up a PXE-enabled system in the openQRM-network

To boot up the first node in the openQRM-network, simply power it on and make sure the bios is set to do "PXE-boot".

The flow is the following:

1. Power on the node
2. The node sends a dhcpd/pxe request
3. The node receives an ip address and boot-file from the dhcpd-server
4. The node downloads the boot-file (pxelinux) and, according to its pxe-configuration, downloads its kernel + initrd
5. The node starts the kerenl + initrd and becomes idle (available) in the openQRM GUI

Creating a custom boot-image

To create a custom boot-image from a remote (running) server simply
use the qrm-boot-image script as follows:

SHELL> /[server-base-dir]/qrm/bin/qrm-boot-image create \
-k [kernel-version] \
-b myboot-image \
-y my-boot-image \
-i [ip-of-the-remote-server]

For example:

SHELL> /usr/qrm/bin/qrm-boot-image create \
-k 2.6.12 \
-b myboot-image \
-y my-boot-image \
-i 10.20.30.40

Creating a custom filesystem-image

To create a custom filestem-image from a remote (running) server, create a storage-server on the management configuration page in the openQRM GUI. Then use the
qrm-filesystem-image script as follows:

SHELL> /[server-base-dir]/qrm/bin/qrm-filesystem-image create \
-s myserver -i [ip-of-the-remote-server] \
-n [ip-address-of-the-nfs-storage-server]:[path-to-image-directory] \
--storage-server [name-of-the-storage-server]

For example:

SHELL> /usr/qrm/bin/qrm-filesystem-image create \
-s myserver \
-i 10.20.30.40 \
-n 10.20.30.200:/diskimages/ \
--storage-server mynfs-server

Configuring and managing a virtual-environment

To configure and start a new virtual-environment, access the openQRM-server GUI. Choose "virtual environments" -> "tools" -> "new virtual environment". Fill out and save the configuration form; choose the previous created boot- and file system-image.

You can now start the just created new virtual environment by "actions" -> "start".

Comments (0)

Subscribe to this comment's feed