Install Eucalyptus from Release Packages

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 CentOS 6 or RHEL 6:

Configure the Eucalyptus package repository on each host that will run a Eucalyptus component:
```
yum install http://downloads.eucalyptus.com/software/eucalyptus/3.2/centos/6/x86_64/eucalyptus-release-3.2.noarch.rpm
```
Enter y when prompted to install this package.
Configure the Euca2ools package repository on each host that will run a Eucalyptus component or Euca2ools:
```
yum install http://downloads.eucalyptus.com/software/euca2ools/2.1/centos/6/x86_64/euca2ools-release-2.1.noarch.rpm
```
Enter y when prompted to install this package.
Configure the EPEL package repository on each host that will run a Eucalyptus component or Euca2ools:
```
yum install http://downloads.eucalyptus.com/software/eucalyptus/3.2/centos/6/x86_64/epel-release-6.noarch.rpm
```
Enter y when prompted to install this package.
Configure the ELRepo repository on each host that will run Walrus:
```
yum install http://downloads.eucalyptus.com/software/eucalyptus/3.2/centos/6/x86_64/elrepo-release-6.noarch.rpm
```
Enter y when prompted to install this package.
For RHEL 6 systems only, it is necessary to enable the Optional repository in Red Hat Network for each NC, as follows:
1. Go to http://rhn.redhat.com and navigate to the system that will run the NC.
2. Click Alter Channel Subscriptions.
3. Make sure the RHEL Server Optional checkbox is checked.
4. Click Change Subscriptions.
If you are not a Eucalyptus subscriber, skip this step. If you are a Eucalyptus subscriber, you should have received an rpm package file containing subscription-only components. Install the Eucalyptus subscription package on each host that will run a Eucalyptus component, as follows:
```
yum install eucalyptus-enterprise-release-3.2*.noarch.rpm
```
Enter y when prompted to install this package.
If you are not a Eucalyptus subscriber, or do not wish to use VMware Broker, skip this step. A Eucalyptus subscription is required to use VMware Broker. Install the VMware Broker package on the host that will run your Cluster Controller (CC), as follows:
```
yum install eucalyptus-enterprise-vmware-broker
```
Enter y when prompted to install this package.

Note

Clouds that use the VMware hypervisor do not have NCs; if you plan to use VMware then skip this step.

Install the Eucalyptus node controller software on each planned NC host:
```
yum install eucalyptus-nc
```
Check that the KVM device node has proper permissions.
Run the following command:
```
ls -l /dev/kvm
```
Verify the output shows that the device node is owned by user root and group kvm.
```
crw-rw-rw- 1 root kvm 10, 232 Nov 30 10:27 /dev/kvm
```
If your kvm device node does not have proper permissions, you need to reboot your NC host.

Install the Eucalyptus cloud controller software on each planned CLC host:
```
yum groupinstall eucalyptus-cloud-controller
```
Install the software for the remaining Eucalyptus components. The following example shows most components being installed on the same host. We recommend that you use different hosts for each component:
```
yum install eucalyptus-cc eucalyptus-sc eucalyptus-walrus
```
If you are a subscriber and use SAN, run the appropriate command for your device on each machine hosting a CLC:
For EMC SAN:
```
yum install eucalyptus-enterprise-storage-san-emc eucalyptus-enterprise-storage-san-emc-libs
```
For EqualLogic SAN: no action needed

For NetApp SAN:
```
yum install eucalyptus-enterprise-storage-san-netapp eucalyptus-enterprise-storage-san-netapp-libs
```

If you are a subscriber and use SAN, run the appropriate command for your device on each machine hosting a SC:

For EMC SAN:

yum install eucalyptus-enterprise-storage-san-emc

Important

To use Eucalyptus with EMC SAN support, you must have the NaviCLI-Linux-64-latest.rpm package installed on each SC. This package is not supplied with Eucalyptus, please see your SAN vendor if it is not already installed.

For EqualLogic SAN:

yum install eucalyptus-enterprise-storage-san-equallogic

For NetApp SAN:

yum install eucalyptus-enterprise-storage-san-netapp

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 secondary controllers.

Your installation is complete.

You are now ready to Configure Eucalyptus.