Project Acronym: Project Title: Project Number: Instrument: Thematic Priority:

OPTIMIS Optimized Infrastructure Services 257115 Integrated Project ICT-2009.1.2 Internet of Services, Software and Virtualisation

DRP4OST VMM plugin for OpenStack Installation Guide

Activity 6: WP 6.5:
Due Date: Submission Date: Start Date of Project: Duration of Project: Organisation Responsible for the Deliverable: Version: Status Author(s): Sergio Mendoza Jordi Guitart Wolfgang Ziegler George Kousiouris

Integration and Experimentation Interoperability

M36 31/05/2013 01/06/2010 36 months BSC 1.0
Final

BSC BSC SCAI NTUA

Reviewer(s)

DRP4OST Installation Guide

Project co-funded by the European Commission within the Seventh Framework Programme Dissemination Level PU PP RE CO Public Restricted to other programme participants (including the Commission) Restricted to a group specified by the consortium (including the Commission) Confidential, only for members of the consortium (including the Commission) X

OPTIMIS Consortium

Page 2 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

Version History
Version 0.1 0.2 0.3 1 Date 01-5-2013 10-05-2013 30-05-2013 31-05-2013 Comments, Changes, Status Table of contents and first input Beta version for review Reviewed final version Overall format revisin Authors, contributors, reviewers Sergio Mendoza (BSC) Sergio Mendoza (BSC) Sergio Mendoza, Guitart (BSC) Malena Donato (ATOS) Jordi

OPTIMIS Consortium

Page 3 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

Table of Contents
TABLE OF CONTENTS .............................................................................................................................. 4 INDEX OF TABLES ................................................................................................................................... 5 1 INTRODUCTION ............................................................................................................................. 6 1.1 2 GLOSSARY OF ACRONYMS .................................................................................................................. 6

DRP4OST INSTALLATION GUIDE..................................................................................................... 7 2.1 RELEASE INFORMATION ..................................................................................................................... 7 2.2 PLATFORMS SUPPORTED ................................................................................................................... 7 2.3 SOFTWARE PRE-REQUISITES AND DEPENDENCIES.................................................................................... 7 2.4 INSTALLATION INSTRUCTIONS ............................................................................................................. 7 2.5 GETTING STARTED ............................................................................................................................ 8 2.5.1 Using the Software ................................................................................................................. 8 2.5.2 Testing the Software ............................................................................................................... 8 2.5.3 Configuration .......................................................................................................................... 8 2.6 FAQ ............................................................................................................................................. 9

REFERENCES ................................................................................................................................ 10

OPTIMIS Consortium

Page 4 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

Index of Tables
Table 1. Acronyms table ................................................................................................................ 6 Table 2 DRP4OST release information .......................................................................................... 7 Table 3 Software dependencies .................................................................................................... 7

OPTIMIS Consortium

Page 5 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

Introduction

This document provides the installation guide for the software component DRP4OST. This component supports the use of OpenStack as IaaS. OPTIMIS aims towards Optimized Service Construction, Deployment, and Execution for Cloud Infrastructures by offering tools to efficiently manage the full life cycle of services. These tools will provide simplified construction of services, help make informed deployment and runtime management decisions for the evaluation of providers, and support Quality of Service provision. This document assumes the reader is familiar with the OPTIMIS project vision and architecture. The following documents are recommended sources of information: Deliverable D1.2.1.2 OPTIMIS Architecture deliverable, October 2011

OPTIMIS: a Holistic Approach to Cloud Service Provisioning. A. Juan Ferrer, F. Hernandez, J. Tordsson, E. Elmroth, C. Zsigri, R. Sirvent, J. Guitart, R.M. Badia, K. Djemame, W. Ziegler, T. Dimitrakos, S.K. Nair, G. Kousiouris, K. Konstanteli, T. Varvarigou, B. Hudzia, A. Kipp, S. Wesner, M. Corrales, N. Forgo, T. Sharif, and C. Sheridan. Future Generation Computer Systems, Elsevier, Vol. 28, No. 1, pp. 66-77, 2012. Details on the OPTIMIS project are found on http://optimis-project.eu Details on OpenStack are found on http://www.openstack.org/

1.1

Glossary of Acronyms
Definition Elastic Management Of Tasks In Virtualized Environments General Public License Java Archive Representational State Transfer Virtual Machine Web Application Archive
Table 1. Acronyms table

Acronym EMOTIVE GPL JAR REST VM WAR

OPTIMIS Consortium

Page 6 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

2
2.1

DRP4OST Installation Guide

Release information
Component Name DRP4OST Release Number 1.0 Release Date 2013-05-31

Table 2 DRP4OST release information

2.2

Platforms Supported

The component has been tested over Debian GNU/Linux 7.0 (wheezy), Linux 3.0.0-1-amd64 x86_64 kernel.

2.3

Software Pre-requisites and Dependencies

Product Java Apache Tomcat Jersey (JAX-RS) JAXB API Apache HttpComponents OpenStack Json-simple Version 1.6 6.0.36 1.8 1.8 4.2.3 Essex (2012.1) 1.1.1 2.0 2.2.8
Table 3 Software dependencies

Licence GPL Apache License Version 2 GPL GPL Apache License Version 2 Apache License Version 2 Apache License Version 2 Apache License Version 2 GNU Lesser General Public License 2.1

VENUS-C.Interoperable Toolkit EMOTIVE OVFWrapper

These pre-requisites can be solved by using the libraries provided to use those components. The maven configuration of this component automatically downloads all those libraries (including components from both OPTIMIS and EMOTIVE)

2.4 Installation Instructions

This component is a web application (WAR file) and its source code can be obtained from the svn project repository: http://pandora.atosorigin.es/svn/optimis/branches/OptimisY3/Interoperability/DRP4OST. The war file can be generated building the project following these steps: 1. Download the code with svn 2. Move to the directory where the source code has been download (the directory must contain a pom.xml file)

OPTIMIS Consortium

Page 7 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

3. Execute the command mvn clean install (Maven 2 has to be used) After these steps, the DRP.war web application will be just generated inside the target directory. The server where this web application is deployed requires to have installed the OpenStack clients below: glance nova

The OpenStack clients installation can be done executing the following command [1]:
sudo apt-get install python-novaclient glance-client swift

Once the web application is deployed and the clients installed, it is necessary to configure the config.properties file according to the OpenStack testbed before doing any request over the OpenStack DRP plugin. It is necessary to configure the $DRP4OST environment variable, because the config.properties file will be searched at one of these two places: 1. $DRP4OST/etc/drp4ost/config.properties (if $DRP4OST is set) 2. /opt/drp4ost/etc/drp4ost/config.properties (otherwise) The parameters that have to be provided in the config.properties file are OpenStack credentials, OpenStack API server and Image default configuration: OpenStack credentials o os.url.auth: host where the authentication is requested o os.tenant.id: project id o os.tenant.name: project name o os.username: username o os.password: password OpenStack API server: o host ip: host where the API requests have to be done Image default configuration: o img.default.path: default path that hosts the images o img.default.disk.format: default path that hosts the images format o img.default.disk.size: default max image size o img.default.container.format: default container format o img.default.public: default image visibility

More information about obtaining OpenStack credentials can be found at OpenStack web [2].

2.5

Getting started

2.5.1 Using the Software See user manual. 2.5.2 Testing the Software See user manual. 2.5.3 Configuration See user manual.

OPTIMIS Consortium

Page 8 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

2.6 FAQ
N/A

OPTIMIS Consortium

Page 9 of 10

DRP4OST VMM plugin for OpenStack Installation Guide

References

[1] OpenStack Compute Starter Guide - Essex. http://docs.openstack.org/essex/openstackcompute/starter/content/Client_Tools-d1e1206.html [2] OpenStack Compute Administration Manual - Essex (2012.1). http://docs.openstack.org/essex/openstack-compute/admin/content/configuringopenstack-compute-basics.html

OPTIMIS Consortium

Page 10 of 10