Install on Ubuntu 10.04 LTS

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 Ubuntu 10.04 LTS:

Tip

If you are a Eucalyptus subscriber, you should have received a deb package file that you will need to install. If you are not a Eucalyptus subscriber, skip this step.

On all servers, copy over your deb package file and run the following command:

dpkg -i eucalyptus-enterprise-release_3.1-*lucid_all.deb

Download the Eucalyptus release key from http://www.eucalyptus.com/eucalyptus-cloud/security/keys

Add the public key to the list of trusted keys.

apt-key add c1240596-eucalyptus-release-key.pub

Create a file in /etc/apt/sources.list.d called eucalyptus.list with the following content:
```
deb http://downloads.eucalyptus.com/software/eucalyptus/3.1/ubuntu lucid main
```
On all machines that will run either Eucalyptus or Euca2ools, create a file in /etc/apt/sources.list.d called euca2ools.list with the following content:
```
deb http://downloads.eucalyptus.com/software/euca2ools/2.1/ubuntu lucid main
```
Enter the following command on all machines:
```
apt-get update
```

Install Eucalyptus packages and dependencies. The following example shows a package install all on the same server. You can install each component on a different server.

apt-get install eucalyptus-cloud eucalyptus-cc eucalyptus-sc eucalyptus-walrus

High Availability

If you are deploying HA, you must install these packages on pairs of systems. For instance, “eucalyptus-cloud” is installed on the primary CLC and the secondary CLC.

On each planned NC server, install the NC package:

apt-get install eucalyptus-nc

Important

If you are using VMware, you can skip this step. Eucalyptus software is not installed on these machines. They are running VMware.

Important

This step is only required the first time libvirt is installed on a system.

The first time libvirt is installed on a system, you must initialize libvirt before it will function properly. To initialize libvirt, run the following command:

virsh capabilities

If you are a Eucalyptus subscriber and plan to use VMware, install the subscription-only VMware Broker package on each CC server:
```
apt-get install eucalyptus-enterprise-vmware-broker
```
If you are a Eucalyptus subscriber and plan to use SAN support, install the subscription-only SAN package on each SC. Otherwise, skip this step.
```
apt-get install eucalyptus-enterprise-storage-san
```

After you have installed Eucalyptus, test multicast connectivity between the CLC and Walrus, SC, and the VMware Broker.

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

Once the receiver command blocks, simultaneously run the following sender command on Walrus:
```
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.

Repeat the previous step on the SC and then on the VMware Broker.

High Availability

If you are installing an HA environment, repeat these tasks on secondary CLC, Walrus, SC, and VMware Broker.

Your installation is complete.

You are now ready to Configure Eucalyptus.