EucaLobo

EucaLobo is an application for managing Eucalyptus resources with a simple and easy to use client-side UI.

This project is a fork of EucaLobo with URLs replaced to point at a Eucalyptus install.

In addition, it integrates well with the AWS command line tools such that the user can easily configure both EucaLobo and the CLI to work together.

Setting up for Eucalyptus

To download the EucaLobo project from the GitHub repository:
```
git clone https://github.com/viglesiasce/EucaLobo
```
Setup an endpoint in the UI with the following URL:
```
http://<ip_of_clc>:8773
```

Testing On Mac OS X

To download the EucaLobo project from the GitHub repository:

git clone https://github.com/viglesiasce/EucaLobo
Primary development is done on Mac so there is a special dev mode to run it as an OS X application with symlinks to the actual source code:
```
make run
```
To get updates, execute the following in the source directory:
```
git pull
```

Testing On Windows

Download a Git client for Windows. A number of Git clients are available:
- http://git-scm.com/downloads/guis
- http://windows.github.com/
- http://code.google.com/p/msysgit/downloads/list
- http://code.google.com/p/gitextensions/ (Explorer integration)
- https://code.google.com/p/tortoisegit/ (Explorer integration)
To download the EucaLobo project from the GitHub repository:
- Use your Git UI, or
- Launch cmd.exe, cd to the directory where you want to keep the source code, and run git clone git clone https://github.com/viglesiasce/EucaLobo
To run the EucaLobo application:
- ElasticWolf/EucaLobo.exe -jsconsole (runs with a javascript debug console)
- Simply execute EucaLobo.exe from Windows Explorer
To get EucaLobo updates:
- Use your Git UI and pull from the repository, or
- Run git pull in the source directory

Testing on Linux

To retrieve source code from the repository:

git clone https://github.com/viglesiasce/EucaLobo
To install xulrunner (for example on Ubuntu):

apt-get install xulrunner
Execute EucaLobo/EucaLobo
If xulrunner is not available as a package, use the commands below to install it:
- cd /opt
- sudo wget -O- https://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/13.0/runtimes/xulrunner-13.0.en-US.linux-`uname -p`.tar.bz2 | tar -xj
- sudo ln -s /opt/xulrunner/xulrunner /usr/bin/xulrunner

Building Releases

Releases must be built on a Mac and cannot be built on Windows. To create binary packages for both Mac and Windows, just type: make build. This will produce .zip files for each platform.

Passing credentials on the command line

The parameters are:

-key: AWS access key
-secret: AWS secret access key
-endpoint: URL for the endpoint
-token: security token
-name: name for the passed credentials
-lock: lock the credentials and do not allow user to change them
-jsconsole: load the javascript debug console

Developers:

Victor Iglesias Vlad Seryakov

QA and Support:

Mark Ryland
Ben Butler
Tim Wilson
Chris Gorski
Nathan McCourtney

viglesiasce/EucaLobo