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!
