Important information

This is an archive of the code repository for the previous Cloud Portal GE. Currently the GE is supported by the official Openstack Horizon project. You can customize the Horizon portal with FIWARE styles following the instructions at: https://github.com/ging/fiware-cloud-portal-theme

Self Services Interfaces - Cloud Portal

• Introduction
• How to Build & Install
  • Docker
• API Overview
• Advanced documentation
• License

---

Introduction

This project is part of FIWARE. You will find more information abour this FIWARE GE here.

• You will find the source code of this project in GitHub here
• You will find the documentation of this project in Read the Docs here

A JavaScript implementation of OpenStack Horizon component. This is a web portal developed using only in JavaScript, based on OpenStack Horizon.

How to Build & Install

1. Install necessary components:

		sudo apt-get install make g++
		sudo apt-get install python-software-properties
		sudo add-apt-repository ppa:chris-lea/node.js
		sudo apt-get update
		sudo apt-get install nodejs npm git ruby1.9.3‏
	sudo gem install sass -v 3.2.12
</pre>

<li>Clone the repository to your workspace and change to the <code>fiware-cloud-portal</code> new directory</li>
<pre>
	git clone git://github.com/ging/fiware-cloud-portal.git

	cd fiware-cloud-portal
</pre>

<li>Copy <code>config.js.template</code> to <code>config.js</code> in <code>fiware-cloud-portal</code> directory</li>
<pre>
	cp config.js.template config.js
</pre>

<li>Log in Cloud Portal (https://account.lab.fiware.org/) and head to your account details </li>

<p> </p>

<li>Register a new application and bind it to your localhost</li>
<img src= "https://github.com/ging/fiware-cloud-portal/blob/master/images/register_app.png"/>

<li>Modify <code>config.js</code> file with the correct configuration and save changes</li>
<pre>
// Mandatory. TCP port to bind the server to
config.http_port = 80;

config.useIDM = false;

// OAuth configuration. Only set this configuration if useIDM is true.
config.oauth = {
	account_server: 'https://account.lab.fiware.org',
    client_id: '',
    client_secret: '',
    callbackURL: ''
};

// Keystone configuration.
config.keystone = {
	host: 'cloud.lab.fiware.org',
	port: 4730,
	admin_host: 'cloud.lab.fiware.org',
	admin_port: 4731, 
	username: '', 
	password: '',
	tenantId: ''
};
</pre>
<blockquote>Note: You can set a different TCP port, but you will have to indicate that change in the application configuration and the <code>config.js</code> file.</blockquote> 

<li>Install dependencies using npm and grunt and finally run the server</li>
<pre>
	sudo npm install

	./node_modules/grunt-cli/bin/grunt debug

	sudo node server.js

</pre>

Docker

We also provide a Docker image to facilitate you the building of this GE.

• Here you will find the Dockerfile and the documentation explaining how to use it.
• In Docker Hub you will find the public image.

API Overview

Self Service Interfaces GE is a GUI to facilitate the access to Openstack services and other FIWARE GEs APIs. So it has not an API specification.

Advanced Documentation

• How to run tests
• User & Programmers Manual
• Installation & Administration Guide

License

The MIT License

Copyright (C) 2012 Universidad Politécnica de Madrid.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.