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

• For all RPM based installs, download enomalism.public and install it via: rpm --import enomalism.public

RHEL 5.1 / CentOS 5.1

• After downloading all the RPMS for your platform from SourceForge, run the following from the command line:

     ln -s /usr/bin/qemu-kvm /usr/bin/kvm
     yum install libvirt-python-0.4.1-1.CentOS5.i386.rpm \
     libvirt-devel-0.4.1-1.CentOS5.i386.rpm enomalism2-2.1b1-noarch.rpm \
     libvirt-0.4.1-1.CentOS5.i386.rpm
  

Fedora 8

• After downloading all the RPMS for your platform from SourceForge, run the following from the command line:

     yum install libvirt-python-0.4.1-1.fc8.i386.rpm \
     libvirt-devel-0.4.1-1.fc8.i386.rpm enomalism2-2.1b1-noarch.rpm \
     libvirt-0.4.1-1.fc8.i386.rpm
  

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:

• http://trac.enomalism.com/enomalism/wiki/enomalism-trouble#ErrorsConnectingtoXen

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)
  • 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

  # 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

     cd /opt/enomalism2
     scripts/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

     cd /opt/enomalism2
     scripts/enomalism2.sh stop
  

Done! Welcome to the Enomalism Cloud Computing Platform!