rcowham / ravello-training

Training portal web application which uses Ravello as the backend

Ravello Training

This is a sample project for working with Ravello APIs, in order to create virtual training labs in the cloud

Additional information on this sample project can be found here.

Architecture

The application is composed of three parts:

1. Client side (in AngularJS).
2. Static server, which serves the static client files.
3. REST API server, which is accessed by the client.

The two servers are separated. The client sends requests only to the static Web server, which serves its static files. The REST calls are also sent to that server, which is responsible for redirecting the requests to the REST server.

There are two projects in this codebase - 'training-webapp' for the client, and 'training-sever' for the REST server. The 'training-webapp' project also holds Grunt configuration for running the static server in development mode.

Installing and running

Prerequisites

You need to have the following components installed:

• nodejs
• bower
• grunt
• mongoDB

How to install?

General

1. Set the RAVELLO_TRAINING_HOME environment variable to the root directory of the project, for example :

export RAVELLO_TRAINING_HOME=/home/myUser/ravello-training

Static server (for client files)

1. cd training-webapp

2. npm install

3. bower install

4. By default, the application is launched on port 8080. If you would like to change it, you can do so in the Gruntfile.js file, under the 'connect.options' property.

5. grunt

REST server

1. cd training-server

2. npm install

How to run?

Development mode

In the root directory, run:

config/start_static_server.sh
config/start_rest_server.sh

Now you can access the application locally at:
http://localhost:8080

Production mode

How to run the application in production is up to you.
The project provides a basic nginx configuration example, to illustrate how the static server can be launched with nginx: config/nginx.conf.

Notice! The $RAVELLO_TRAINING_HOME variable should be replaced with the actual path of the project's root directory, inside the nfinx.conf file itself, if it's to be actually used.

The REST server should be run the same way as in development mode:

config/start_rest_server.sh

Additional configuration

To configure the application to its initial state, run from the root directory:

mongo training config/init_db.js

This creates the basic 'admin' user, with which you could create the other application users, and then start using its full functionality.

Troubleshooting

• Make sure grunt-cli is installed globally, so that the grunt command is found and executed successfully.