Ubuntu 7.10/8.04 Desktop/Server/Alternate Pre-Install

• Run the following from the command line for XEN/KVM install

     sudo apt-get install ssh build-essential python-dev libxen3.1-dev kvm mysql-server \
       libmysqlclient15-dev python-libvirt python-mysqldb libvirt-bin python-setuptools \
       xen-utils-3.1 linux-xen qemu bridge-utils python-profiler
     sudo mkdir -p /opt
     cd /opt
  

• Run the following from the command line for KVM only install (recommended for systems that cannot boot XEN kernels)

     sudo apt-get install ssh build-essential python-dev libxen3.1-dev kvm mysql-server \
       libmysqlclient15-dev python-libvirt python-mysqldb libvirt-bin python-setuptools \
       qemu bridge-utils 
     sudo mkdir -p /opt
     cd /opt
  

NOTE: At one point it will ask you to provide a root password for MySQL, please remember this password as it will be used in a later step!

Building LibVirt? for better functionality

• You may experience problems with Libvirt under some circumstances. If you've been directed, please install the current snapshot of LibVirt?:
  • Run the following from the command line:

       apt-get install libxml2-dev libgnutls-dev libsasl2-dev libgsasl7-dev libxen3.1-dev
    

• Manually compiling LibVirt? (only required for Redhat 5):

     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
  

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

Installing Enomalism

• Download the Enomalism DEB package from SourceForge
• Run the following from the command line:

     dpkg -i enomalism2-2.1b1.deb
  

Configuring Enomalism

• If MySQL is running (it should be after following the install steps above) type the following at the command line:

     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

     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

Done! Welcome to the Enomalism Cloud Computing Platform!