Red Hat Enterprise 5.2 / CentOS 5.2 and Fedora 9 Pre-Install

All Platforms

  • Download enomalism.public and install it via: rpm --import enomalism.public
  • Download enomalism001.pubkey.asc and install it via rpm --import enomalism001.pubkey.asc
  • Install the 0.4.1 libvirt packages for your platform from http://sourceforge.net/project/showfiles.php?group_id=164855&package_id=272094
    • NOTE: CentOS 5.x packages will work with RHEL 5.x. Fedora 9 must follow the compile instructions below.
  • If the libvirt packages do not match your RPM platform or will not install properly libvirt can be compiled manually (This includes Fedora 9!):
       yum install libxml2-devel openssl-devel cyrus-sasl-devel xen-devel gnutls-devel gcc
       wget http://libvirt.org/sources/libvirt-0.4.1.tar.gz
       tar -xvzf libvirt-0.4.1.tar.gz
       cd libvirt-0.4.1
       ./configure --prefix=/usr && make && make install
    

RHEL 5.2 / CentOS 5.2

  • After downloading the RPM for your platform from SourceForge, run the following from the command line:
       yum install Enomalism2-2.1.1-3595-noarch-py24.rpm
    

Fedora 9

  • After downloading the RPM for your platform from SourceForge, run the following from the command line:
       yum install Enomalism2-2.1.1-3595-noarch-py25.rpm
    

Hypervisor Selection

XEN

For most RPM based distros the following command will install the Xen Hypervisor support:

  yum install kernel-xen xen

KVM/QEMU

For CentOS the following command will install KVM/Qemu support:

   yum install kvm kmod-kvm qemu
   ln -s /usr/bin/qemu-kvm /usr/bin/kvm

For Fedora 9:

   yum install kvm qemu
   ln -s /usr/bin/qemu-kvm /usr/bin/kvm

RHEL 5.2 does not ship with yum'able KVM or Qemu packages, these can be downloaded and installed manually:

  • Install CentOS 5.x Public Key: rpm --import http://mirror.centos.org/centos/RPM-GPG-KEY-CentOS-5
  • 32 Bit (x86)
      wget http://mirrors.kernel.org/centos/5.2/extras/i386/RPMS/qemu-0.9.0-4.i386.rpm
      wget http://mirrors.kernel.org/centos/5.2/extras/i386/RPMS/kvm-36-1.i386.rpm
      wget http://mirrors.kernel.org/centos/5.2/extras/i386/RPMS/kmod-kvm-36-2.2.6.18_92.1.10.el5.i686.rpm
      wget http://mirrors.kernel.org/centos/5.2/updates/i386/RPMS/kernel-2.6.18-92.1.10.el5.i686.rpm
      yum install qemu-0.9.0-4.i386.rpm kvm-36-1.i386.rpm kmod-kvm-36-2.2.6.18_92.1.10.el5.i686.rpm kernel-2.6.18-92.1.10.el5.i686.rpm
      ln -s /usr/bin/qemu-kvm /usr/bin/kvm
    
  • 64 bit (x86_64)
      wget http://mirrors.kernel.org/centos/5.2/extras/x86_64/RPMS/qemu-0.9.0-4.x86_64.rpm
      wget http://mirrors.kernel.org/centos/5.2/extras/x86_64/RPMS/kvm-36-1.x86_64.rpm
      wget http://mirrors.kernel.org/centos/5.2/extras/x86_64/RPMS/kmod-kvm-36-2.2.6.18_92.1.10.el5.x86_64.rpm
      wget http://mirrors.kernel.org/centos/5.2/updates/x86_64/RPMS/kernel-2.6.18-92.1.10.el5.x86_64.rpm
      yum install qemu-0.9.0-4.x86_64.rpm kvm-36-1.x86_64.rpm kmod-kvm-36-2.2.6.18_92.1.10.el5.x86_64.rpm kernel-2.6.18-92.1.10.el5.x86_64.rpm
      ln -s /usr/bin/qemu-kvm /usr/bin/kvm
    

This will install a new RH kernel, please reboot after this step.

All RPM Systems

  • Start MySQL from the command line by typing:
       /etc/init.d/mysqld start
    
  • Set a root password on MySQL (used in later steps)
       mysqladmin password <password>
    
  • Allow MySQL to start on bootup
       chkconfig mysqld on
    

Xen Issues

If you plan on using the Xen hypervisor, and you currently do not have a working Xen setup you may need to do the following:

Enomalism Install

Configuring Enomalism

  • If MySQL is running (it should be after following the install steps above) type the following at the command line:
       cd /opt/enomalism2
       scripts/init-db.sh <mysql root password> <new enomalism user> <new enomalism password>
    
  • Replace <user> and <password> with usernames and passwords of your choice (without the triangle brackets).
  • Copy the default.cfg to config/$HOSTNAME.cfg by doing this
       cp default.cfg config/$HOSTNAME.cfg
    
  • Edit config/$HOSTNAME.cfg
    • Change sqlobject.dburi="mysql://enomalism2:zx45qw12@localhost/enomalism2" to reflect your proper MySQL username and password.
    • Change enomalism2.self="5fe6f05e-7ee0-11dc-ba7c-0011d88b8e81" to reflect a unique identifier for your cluster environment (each instance needs to be unique)
      • Most distros have a utility such as uuid or uuidgen that can generate a number for you. The only valid value in this field is a uuid.
    • Change enomalism2.baseurl="http://127.0.0.1:8080/rest/" to the IP/hostname you use to access the Enomalism web interface.
    • Change enomalism2.ip_addr="1.2.3.4" to the IP/hostname you use to access the Enomalism web interface, this will be used later for clustering.

Configuring VNC Access for VM's

To access your machines through the built-in VNC client, you need to change the following chunks in the following files:

  • /etc/libvirt/qemu.conf (NOTE: If this file is missing or is a directory, you probably did not install the 0.4.1 version of libvirt!)
    # VNC is configured to listen on 127.0.0.1 by default.
    # To make it listen on all public interfaces, uncomment
    # this next option.
    #
    # NB, strong recommendation to enable TLS + x509 certificate
    # verification when allowing public access
    #
    vnc_listen = "0.0.0.0"
    
  • /etc/xen/xend-config.sxp
    # The interface for VNC servers to listen on. Defaults
    # to 127.0.0.1  To restore old 'listen everywhere' behaviour
    # set this to 0.0.0.0
    (vnc-listen '0.0.0.0')
    
  • NOTE: Some installations (KVM only) may not have the second file to edit, don't panic. If you're not using Xen, you will not need it.

Running Enomalim

  • Run the following from the prompt
       /etc/init.d/enomalism2.sh start
    
  • If no errors occur point your browser to: http://server:8080 , where "server" is the IP or the hostname of the enomalism server.
  • After the install completes, click on the bottom link and log in using
    • username: admin
    • password: password
  • You can stop Enomalism by typing
       /etc/init.d/enomalism2.sh stop
    

Done! Welcome to the Enomalism Cloud Computing Platform!