Evaluation Guide

HP Helion Eucalyptus
Deploying a basic cloud with FastStart

Table of contents
Introduction

About HP Helion Eucalyptus

Purpose

Intended Audience

Additional Information

Support

Eucalyptus Architecture

Core Eucalyptus services

User Facing Services

Management Console

Object Storage Gateway (OSG)

Cloud Controller

Object Storage Provider (OSP) / Walrus

Cluster Controller

Storage Controller

Node Controller

Installing With FastStart.

Prerequisites

Installation

Using Your Cloud

AWS API Compatibility

For more information

Sign up for updates

hp.com/go/getupdated

Share with colleagues

Rate this document

Copyright 2015 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Trademark acknowledgments, if needed.

Version 1.0 (20141201)

4AA4-xxxxENN,
Mon503061225X

FastStart Installation for HP Helion Eucalyptus

HP Helion Eucalyptus
The open source AWS-compatible private cloud platform for the Enterprise.
Introduction
About HP Helion Eucalyptus
Eucalyptus is an open source platform which allows you to build an AWS-compatible on-premise cloud. It is
designed to run on commodity hardware and provide an implementation of popular AWS-compatible services, such
as EC2 (Elastic Compute Cloud) and Auto Scaling. The platform is highly integrated which results in a robust
architecture and a user-friendly installation and configuration experience.
Eucalyptus can dynamically scale up or down depending on application workloads and is uniquely suited for
enterprise clouds, delivering production-ready software that supports the industry-standard AWS APIs, including
EC2, S3, EBS, IAM, Auto Scaling, Elastic Load Balancing, and Cloud Watch. The benefits of using Eucalyptus for a
private cloud are highly efficient scalability, organizational agility, and increased trust and control for IT.

Purpose
The purpose of this document is to provide guidance on how to deploy a basic Eucalyptus 4 private cloud on physical
hardware. Using the instructions below the reader will successfully install a cloud environment onto a single
machine. The cloud capabiltiies should be sufficient for use cases covering demonstrations and light evaluation.
This document also describes the Eucalyptus software components and their role in the platform, together with
further information on capacity planning and scaling considerations.

Intended Audience
This document is intended for solution architects or technical implementers who are evaluating Eucalyptus as their
own private cloud platform. You should:

Be familiar with infrastructure configuration and management

Have an understanding of network configuration in such an environment

Be familiar with the key concepts and the basic Eucalyptus architecture, as discussed in this document.

Additional Information
This guide does not describe implementatrion strategies for high availability or full redundancy of Eucalyptus
software components. For advanced installation planning and deployment options refer to the official product
documentation, found at www.eucalyptus.com/docs.

Support
The Eucalyptus community maintains a mailing list and IRC channel to provide free assistance with installation,
configuration and use of your Eucalyptus cloud. To connect with the Eucalyptus community now, simply send an
email to euca-users+subscribe@eucalyptus.com.

Commercial support and professional service options are available if desired. More information can be found at
www.eucalyptus.com/subscriptions.

Sign up for updates

hp.com/go/getupdated

Share with colleagues

Rate this document

Copyright 2015 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Trademark acknowledgments, if needed.
201503061225, March 2015

Eucalyptus Architecture
Eucalyptus is a scalable and distributed cloud platform which is made up of a number of core software components
which provide the functionality for the cloud services.

Figure 1 - Eucalyptus Conceptual Architecture

Core Eucalyptus services

This section briefly describes the core Eucalyptus services and provides an overview of the role of each one in turn.
These services will be immediately recognizable and familiar to those who have already explored or implemented a
Eucalyptus environment.

User Facing Services

The majority of the AWS APIs are handled by a component referred to as the User Facing Services (UFS). This
component implements web services for the AWS-compatible service implementations and APIs. This component
serves endpoints for clients and users interacting with the cloud platform. This component has been placed on the
same host together with the Management Console and should be accessible from the client-facing "public"
network.

Management Console
The Eucalyptus Management Console is an easy-to-use web-based interface that allows cloud users to provision
and manage resources; it also gives cloud account administrators powerful tools to manage users, groups and
policies.
In this reference architecture the Management Console resides on the same host as the API services. It is possible to
load balance multiple consoles (perhaps running as instances) to provide redundancy but this is optional.

Object Storage Gateway (OSG)

The User Facing Services also include the Object Storage Gateway (OSG). The OSG is the Eucalyptus service
equivalent to AWS Simple Storage Service (S3). The OSG is a pluggable service that allows infrastructure
administrators the flexibility to implement scale-out storage on top of commodity resources using open source and

Sign up for updates

hp.com/go/getupdated

Share with colleagues

Rate this document

Copyright 2015 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Trademark acknowledgments, if needed.
4AA4-xxxxENN, Mon503061225X

FastStart Installation for HP Helion Eucalyptus

commercial solutions that implement the S3 interface. Eucalyptus provides a basic storage implementation, known
as Walrus, which may suit evaluation and smaller cloud deployments. For large-scale and increased performance,
users are encouraged to connect the OSG to dedicated storage solutions such as RiakCS. In this reference
architecture the Object Storage Provider (OSP) is Walrus, which provides simplicity since it does not require an
additional storage platform.

Cloud Controller
The Cloud Controller (CLC) is a Java program that hosts the database for resource tracking in the cloud. Only one CLC
can exist per cloud. In Eucalyptus 4 the Cloud Controller also handles DNS for services and resources within the
cloud, along with the Cloud Formation compatible service implementation.

Object Storage Provider (OSP) / Walrus

The Object Storage Provider (OSP) is the term used to describe the storage platform which works in conjunction with
the OSG to provide the S3-compatible object storage service. Walrus is one such provider and is a basic single-host
storage provider for the OSG. It uses any POSIX-compliant filesystem for object storage. In this reference
architecture it resides on a single host and uses its local disk.

Cluster Controller
A cluster is equivalent to an AWS availability zone, and a single Eucalyptus cloud can have multiple clusters. The
Cluster Controller (CC) is written in C and acts as the network ingress for a cluster within a Eucalyptus cloud and
communicates with the Storage Controller (SC) and Node Controller (NC). The CC manages instance (i.e., virtual
machine) execution. In this reference architecture there is only a single availability zone or Eucalyptus cluster
defined. Further clusters could be added through the addition of another Cluster Controller, Storage Controller and
Node Controllers. Refer to the official Eucalyptus documentation for further information.

Storage Controller
The Storage Controller (SC) is written in Java and provides the equivalent of AWS Elastic Block Store (EBS)
functionality. The SC communicates with the Cluster Controller (CC) and Node Controller (NC) within the distributed
cloud architecture and manages Eucalyptus block volumes and snapshots. If an instance needs to write persistent
data to disk, it would need to use an EBS volume served by the Storage Controller. The SC interfaces with storage
systems, including local, NFS, iSCSI, and SAN. In this reference architecture the Storage Controller resides on the
same host as the Cluster Controller and is intended to use a local LVM volume group to host EBS volumes. For usecases which require extensive use of EBS-storage a supported SAN is recommended, refer to the official
documentation for more information on the supported vendors and models.

Node Controller
The Node Controller (NC) is a service component written in C and hosts the virtual machine instances and manages
the virtual network endpoints. The NC downloads and caches images from the OSG as well as creates and caches
instances on its local disk. In our reference architecture the Node Controllers each reside on physical hosts.

Installing With FastStart.

FastStart is an interactive installer that automatically deploys and configures a Eucalyptus private cloud on your server.
It will also pre-populate your cloud with everything you need to get started right way, including an account, a user, one
or more machine images, keypairs and more. Finally, FastStart installs Euca2ools, the open source collection of
command-line tools for provisioning AWS, Eucalyptus and OpenStack cloud resources

Prerequisites
Eucalyptus supports a wide variety of deployment options, ranging from single-server demo environments to largerscale production installations. Here, we describe the minimum system requirements for installing a small but useful
Eucalyptus deployment suited for AWS compatible, on-premise evaluation use cases.

Sign up for updates

hp.com/go/getupdated

Share with colleagues

Rate this document

Copyright 2015 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Trademark acknowledgments, if needed.
201503061225, March 2015

Operating System: Centos 6.6 minimal server. We recommend installing using the following image
CentOS-6.6-x86_64-minimal.iso

CPU: 2 core minimum, 4 or greater recommended.

Storage: 100GB recommended minimum free space.

RAM: 8GB minimum.

Network: Target system must have a cabled Ethernet port and a static IP. Your cloud will also need a range of
unused IP addresses to dynamically assign to instances youll launch.

BIOS: Virtualization support must be enabled in BIOS settings. See your device manufacturer for details.

Note: Although installing within a virtual machine is possible, it is not recommended due to the significant experience
required to properly configure virtualized networking. This document does not address the unique requirements of a
virtualized deployment.

Installation
To install Eucalyptus simply log into your CentOS machine and launch the FastStart installer:

$>

bash <(curl -Ls eucalyptus.com/install)

The installer will execute a series of test to verify the target system meets the minimum requirements. If a pre-check
test fails, the user is provided clear messaging about the failure and the installation is halted. The user may resolve the
issue and restart the install using the command above.
After install completes (usually in less than 30 minutes) the screen will display the default user name, password and
cloud status. Take note of the file named eucarc, it includes information you will need for the code samples below.
Meanwhile, run this command to view a list of machine images installed.

Using Your Cloud

FastStart performed most of the setup, but to illustrate how similar Eucalyptus is to AWS we will run some basic
operations. The steps below create a new keypair and a simple security group that will enable you to ssh into the
instance you will launch:

$> euca-create-keypair demokeypair -f demokeypair.pk.pem

$> euca-create-group demogroup
$> euca-authorize demogroup P TCP p 22 s 0.0.0.0/0
$> euca-run-instances emi-SAMPLE g demogroup k demokeypair.pk.pem

Use this command to check the instances status and discover its public IP:

$> euca-describe-instances

It is important to understand that, in the context of a private cloud, the public IP is the network address assigned to
your instance that will be accessible from your network. Instances will not be visible outside your network unless
deployed your cloud outside the firewall.

Sign up for updates

hp.com/go/getupdated

Share with colleagues

Rate this document

Copyright 2015 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Trademark acknowledgments, if needed.
4AA4-xxxxENN, Mon503061225X

FastStart Installation for HP Helion Eucalyptus

When the instance status displays running you can log into the instance like this:

$> ssh i demokeypair.pk.pem root@instance.public.ip

AWS API Compatibility

By changing AWS related environment variables you could run the sequence above and get similar results on the public
cloud. However this would primarily illustrate how Eucalyptus operations behave like AWS. What about API
compatibility? To demonstrate this, well use examples in two popular languages Java and Python.
Java
Using the AWS Java SDK you can invoke EC2 commands on your private cloud by simply using the keys generated
above and your clouds endpoint URL. (Hint: Endpoint URLS for your cloud are available on your server in the eucarc file
mentioned earlier.)
AmazonEC2 ec2Client = new AmazonEC2Client( new BasicAWSCredentials(
// Provide your Eucalyptus access and secret keys.
"YOUR-EUCA-ACCESSKEY",
"YOUR-SECRET-KEY"
) );
// change to the IP and port of your Eucalyptus cloud
ec2Client.setEndpoint( "http://your.host.ip:8773/services/Eucalyptus/" );

You can now invoke EC2 commands on your own cloud as if it were an AWS region. For example a security group would
be created like this:
CreateSecurityGroupRequest csgr = new CreateSecurityGroupRequest();
csgr.withGroupName("JavaDemoSecurityGroup").withDescription("Built with Java");
CreateSecurityGroupResult createSecurityGroupResult =
ec2Client.createSecurityGroup(createSecurityGroupRequest);

Python
The example above can easily be implemented in Python using Boto, the AWS Python SDK. You will notice that we only
need to set the endpoint URL and assign the keys.
import boto
from boto.ec2.regioninfo
import RegionInfo euca_region = RegionInfo(name="eucalyptus",
endpoint=http://your.host.ip)
ec2conn = boto.connect_ec2(
aws_access_key_id=YOUR-EUCA-ACCESSKEY,
aws_secret_access_key=YOUR-SECRET-KEY,
is_secure=False,
port=8773,
path="/services/Eucalyptus",
region=euca_region)
ec2conn.create_security_group('BotoDemoSecurityGroup', Made with Python')

Sign up for updates

hp.com/go/getupdated

Share with colleagues

Rate this document

Copyright 2015 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Trademark acknowledgments, if needed.
201503061225, March 2015

For more information

Eucalyptus Homepage
www.eucalyptus.com
Eucalyptus Product Documentation
www.eucalyptus.com/docs
Eucalyptus Reference Architectures
www.eucalyptus.com/eucalyptus-cloud/reference-architectures
Eucalyptus Compatibility Matrix
https://www.eucalyptus.com/eucalyptus-cloud/iaas/compatibility/4.1

Learn more at
www.eucalyptus.com

Sign up for updates

hp.com/go/getupdated

Share with colleagues

Rate this document

Copyright 2015 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Trademark acknowledgments, if needed.
4AA4-xxxxENN, Mon503061225X