Eucalyptus Installation Quick Start (1.0)

Assuming you have

• a cluster with Rocks V (including xen and java rolls),
• a few machines that you are willing to dedicate to Eucalyptus, and
• familiarity with Rocks commands,

installation of Eucalyptus, proceeds roughly as follows:

1. Add Eucalyptus to Rocks ¶

Download Eucalyptus rolls here: we have both 32-bit and 64-bit versions. Then:

# rocks add roll clean=1 /path/to/eucalyptus-5.0-0.*.disk1.iso
# rocks enable roll eucalyptus
# cd /home/install && rocks-dist dist

_{For more information try section 2.2 of Administrator's Guide}

2. Install Eucalyptus on nodes ¶

• OPTION A: Add new nodes (choose 'VM Container' and wait for nodes to pop up):

  # insert-ethers

• OPTION B: Re-target existing nodes:

  # rocks set host pxeboot vm-container-0-0 action=install
  # rocks set host pxeboot vm-container-0-1 action=install
  ...
  # ssh vc0-0 reboot
  # ssh vc0-1 reboot
  ...

_{For more information try section 2.3 of Administrator's Guide}

3. Install Eucalyptus on the front-end ¶

Once the nodes have rebooted, do:

# kroll eucalyptus | sh

_{For more information try section 2.4 of Administrator's Guide}

4. Configure Eucalyptus ¶

Install at least one runnable VM image (you can download the following test image here) that users can select:

$ tar zxvf euca-ttylinux.tgz
$ cd ttylinux
# /opt/eucalyptus-1.0/usr/sbin/euca add_image \
  --disk-image ttylinux.img \
  --kernel-image vmlinuz-2.6.16.33-xen \
  --image-name ttylinux

Last, but not least, log in to the Eucalyptus Web-site (login: admin, password: admin) to set the administrator's email:

https://your.front.end.hostname:8443/

That is it!

_{For more information try section 2.5 of Administrator's Guide}

What next? ¶

At this point you'd probably want to see if it works. As an administrator, you can use the system exactly as all other users would. So, go ahead and download your certificates and use them with EC2 command-line tools as described in the User's Guide.

If it works for you, tell others to sign up for an account using the "Apply" link on the front page of the Web site. When they do so, you will receive email messages asking you to either accept or reject the request. More about this in section 4 of Administrator's Guide.