Eucalyptus - Installation Manual

Hannes Gamper and Tomi Pievil¨ainen

December 3, 2009, Espoo

Contents

1 Introduction 1

2 Requirements 1

3 Installation procedure 2 3.1 Install Ubuntu 9.10 Server edition and Ubuntu Enterprise Cloud . . . . . 2 3.2 Step 1 - Prerequisites ...... 2 3.3 Step 2 - System Installation and Conﬁguration ...... 2 3.4 Step 3 - Registering UEC Components ...... 3 3.5 Step 4 - Initial Login ...... 3

1 Introduction

Cloud computing systems provide users with access to large amounts of computational resources and data [4]. Virtualisation is used to hide information like physical location and architectural details of the resources from the user. Eucalyptus is an open-source software framework for cloud computing implementing Infrastructure as a Service (IaaS). It is tailored for the use in the research community. Users can run and control virtual machine instances on a variety of physical resources found within academic settings.

2 Requirements

Eucalyptus can be installed via the Ubuntu Enterprise Cloud, introduced in Ubuntu 9.04 [3]. The following installation instructions are based on Ubuntu 9.10 Server edition. In terms of hardware requirements recommended minimum speciﬁcation is a a dual-core 2.2 GHz processor with virtualization extension (Intel-VT or AMD-V), 4GB RAM and 100 GB hard drive.

1 3 Installation procedure

• Ubuntu 9.10, server edition

• dual-core 2.2 GHz processor with virtualization extension (Intel-VT or AMD-V), 4GB RAM and 100 GB hard drive.

• port 22 needs to be open for admins (for maintenance)

• port 8443 needs to be open for users for controlling and sending requests to the cloud via a web interface

3 Installation procedure

The installation instructions in this manual closely follow those given on the “Ubuntu Enterprise Cloud” homepage [2], with some remarks regarding installation from scratch via the Ubuntu 9.10 server edition. Execute the following steps to install Eucalyptus:

3.1 Install Ubuntu 9.10 Server edition and Ubuntu Enterprise Cloud • download the Ubuntu 9.10 Server edition and install it

• during the Ubuntu installation procedure, select “installing UEC” (Ubuntu Enter- prise Cloud) to install Eucalyptus

• after successful installation, update the software and restart your computer:

$ sudo apt-get update $ sudo apt-get upgrade

3.2 Step 1 - Prerequisites • set up mailhost

• ensure eucalyptus-cloud and eucalyptus-cc are installed and updated

3.3 Step 2 - System Installation and Conﬁguration • install the eucalyptus node controller:

$ sudo apt-get install eucalyptus-nc

• set up a bridge as the node’s primary interface: – edit /etc/network/interfaces to look as follows: $ sudo /etc/init.d/networking stop $ sudo vi /etc/network/interfaces

2 3 Installation procedure

auto lo iface lo inet loopback

auto br0 iface br0 inet dhcp bridge_ports eth0 bridge_fd 9 bridge_hello 2 bridge_maxage 12 bridge_stp off

– Restart the network: $ sudo /etc/init.d/networking start

Now conﬁgure Eucalyptus:

• Edit /etc/sysctl.conf according to the UEC tutorial [2]

$ sudo vi /etc/sysctl.conf

3.4 Step 3 - Registering UEC Components • register a cluster and register your node with the cluster $ sudo euca_conf -addcluster localhost $ sudo euca_conf -addnode

3.5 Step 4 - Initial Login • Initial login: cannot be done remotely, has to be done locally: establish an SSH tunnel into cloud controller and access the cloud controller using a web browser $ ssh @ -L localport:localhost:8443

• open a web browser window and type https://:/

• on the login page, download the X.509 certiﬁcate, to allow the command line tools to authenticate themselves against the cloud controller • set up EC2 API and AMI (see howto [1]) • now the users can access the cloud’s http-page to register (necessary!) and use the EC2 tools

3 References

References

[1] Amazon. Amazon Elastic Compute Cloud - command line tools reference. http: //docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference/, 2009.

[2] UEC Community. UEC - Community Ubuntu documentation. https://help. ubuntu.com/community/UEC, October 2009.

[3] Ubuntu Enterprise Cloud. Ubuntu Enterprise Cloud. http://www.ubuntu.com/ products/whatisubuntu/serveredition/cloud/uec, 2009.

[4] D. Nurmi, R. Wolski, C. Grzegorczyk, G. Obertelli, S. Soman, L. Youseﬀ, and D. Zagorodnov. The eucalyptus open-source cloud-computing system. In Cluster Computing and the Grid, 2009. CCGRID ’09. 9th IEEE/ACM International Sym- posium on, pages 124–131, May 2009.