/fiware-cloud-portal

Self Services Interfaces - Cloud Portal

Primary LanguageJavaScript

Self Services Interfaces - Cloud Portal

License badge Documentation badge Docker badge Support badge



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:
  2. 		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

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.