Install on RHEL 5

If you plan to install Eucalyptus HA, we recommend that you install each Eucalyptus component on a separate host. For example, if you are installing CLC, Walrus, CC, and SC, you will install each of these components on a separate host. You will also install each secondary component (the secondary CLC, Walrus, CC, and SC) on a separate host. In this case, you will need eight machines. Each additional cluster needs four more machines for its CCs and SCs. This does not account for NCs, which are not redundant.

To install Eucalyptus on servers running RHEL 5:

Enable the Cluster-Storage repository in Red Hat Network for each planned SC:
1. Go to https://rhn.redhat.com/rhn/systems/SystemList.do
2. Navigate to the system that will run the SC.
3. Click the Alter Channel Subscriptions link.
4. Ensure that the RHEL Cluster-Storage checkbox is checked.
5. Click Change Subscriptions.
Enable the Virtualization repository in Red Hat Network for each planned NC:
1. Go to https://rhn.redhat.com/rhn/systems/SystemList.do
2. Navigate to the system that will run the NC.
3. Click the Alter Channel Subscriptions link.
4. Ensure that the RHEL Virtualization checkbox is checked.
5. Click Change Subscriptions.

On each planned Walrus server, create a file in /etc/yum.repos.d called centos-extras.repo with the following content:

[centos-extras]
name=CentOS 5 - Extras
mirrorlist=http://mirrorlist.centos.org/?release=5&arch=
$basearch&repo=extras
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5
gpgcheck=1

Download the key that CentOS uses to sign their packages:

curl http://mirror.centos.org/centos/RPM-GPG-KEY-CentOS-5 > /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5

Configure the Euca2ools package repository on each host that will run a Eucalyptus component or Euca2ools:
```
rpm -Uvh http://downloads.eucalyptus.com/software/euca2ools/2.1/rhel/5/x86_64/euca2ools-release-2.1.noarch.rpm
```
Configure the Eucalyptus package repository on each host that will run a Eucalyptus component:
```
rpm -Uvh http://downloads.eucalyptus.com/software/eucalyptus/3.1/rhel/5/x86_64/eucalyptus-release-3.1.noarch.rpm
```
Configure the EPEL package repository on each host that will run a Eucalyptus component or Euca2ools:
```
rpm -Uvh http://downloads.eucalyptus.com/software/eucalyptus/3.1/rhel/5/x86_64/epel-release-5.noarch.rpm
```
If you have a Eucalyptus subscription, you will have received a package that grants you access to VMware and SAN components. If you wish to use either of these components, install this package on each host that will run a Eucalyptus component using the following command. Otherwise, skip this step.
```
rpm -Uvh yum install eucalyptus-enterprise-release-3.1*.noarch.rpm
```
If your planned Walrus host runs a Xen kernel, install the kmod-drbd83-xen package on that host. Otherwise, skip this step.
```
yum install kmod-drbd83-xen
```
Install the Eucalyptus cloud controller software on each planned CLC host:
```
yum groupinstall eucalyptus-cloud-controller
```
Install the Eucalyptus node controller software on each planned NC host. Clouds that use the VMware hypervisor do not have NCs; if you plan to use VMware then skip this step.
```
yum install eucalyptus-nc
```
Install the software for the remaining Eucalyptus components. The following example shows most components being installed on the same host. We recommend using different hosts for each component.
```
yum install eucalyptus-cc eucalyptus-sc eucalyptus-walrus
```
If you have a Eucalyptus subscription and plan to use the VMware hypervisor, install the Eucalyptus VMware broker software on each CC host:
```
yum install eucalyptus-enterprise-vmware-broker
```
If you have a Eucalyptus subscription and plan to use Eucalyptus's SAN capabilities, install the Eucalyptus SAN adapter software on each SC host:
```
yum install eucalyptus-enterprise-storage-san
```
After you have installed Eucalyptus, test multicast connectivity between each CLC and Walrus, SC, and VMware broker host.
1. Run the following receiver command on the CLC:
```
java -classpath /usr/share/eucalyptus/jgroups-2.11.1.Final.jar org.jgroups.tests.McastReceiverTest -mcast_addr 224.10.10.10 -port 5555
```
2. Once the receiver command blocks, simultaneously run the following sender command on each Walrus host:
```
java -classpath /usr/share/eucalyptus/jgroups-2.11.1.Final.jar org.jgroups.tests.McastSenderTest -mcast_addr 224.10.10.10 -port 5555
```
  The two applications should be able to connect and arbitrary lines entered on the sender should appear on the receiver.
3. Repeat the previous step on each SC host and VMware broker host.
4. If you are installing an HA environment, repeat these tasks with the second CLC.

Your installation is complete.

You are now ready to Configure Eucalyptus.