An alternative OpenStack Dashboard to Horizon for the MOC.

####1. Setup Devstack (OpenStack deployment)

• git clone https://github.com/openstack-dev/devstack.git
• cd devstack
• ./stack.sh - initial setup
• ./rejoin-stack.sh - to rejoin environment (after start up, if terminal closed)
• ctrl-a 0 - select shell window
• For VM to desktop copy/pasting, screen resizing, install virtualbox guest-utils (http://askubuntu.com/questions/22743/how-do-i-install-guest-additions-in-a-virtualbox-vm)

• Linux VM with atleast 4GB RAM and 10GB Storage

####2. Setup Django Projet

• inside of ~/devstack, git clone https://github.com/CCI-MOC/UI.git
• install django (https://docs.djangoproject.com/en/1.5/topics/install/)
• inside of ~/devstack/UI, run python manage.py runserver 9000
• port 9000 to avoid conflicts with Horizon

####3. Interface Usage

• point browser to localhost:9000

#####Login Page

• login as an existing keystone user, or register with keystone
  • a project admin must add user to project for that user to gain access;
  • or a new user can create a project, and will join that project as an admin

#####Projects Page

• enter a project or create a new project
  • attempts to create keystone, nova, glance clients for user in project (username, password, project)

#####Project Management

• create/edit/delete VMs
  • selection of a VM allows for control (start, stop) and resizing (incomplete functionality; needs resize confirmation/revert)
  • create VM with available flavors, images
  • access/use active VMs via VNC

#####Project Settings

• add/edit current project's users; ADMIN ONLY
  • add users to project
  • edit users' roles
  • delete current project

#####Marketplace

• faked data; example for future implementation

#####TODO

• State DB - checking users, endpoints, session info
• With a State DB:
  • Improvement of Keystone client sessions
  • Currently inefficient
  • Some privilege workarounds may be solved using private keystone endpoint, port 353572 (instead of public 5000)
• Add error checking
• Implement OCX Library

#####Known Issues

• Refer to outstanding issues

#####FAQ

• Why does the UI not work anymore?

  • Run ./rejoin**stack.sh

• Why does OpenStack send connection errors?

  • You might need to rejoin or restack

• Why does Django say port already in use when running server?

  • OpenStack may be using the port, either runserver first, or specify port (ie. python manage.py runserver 9999)

• How can I test the OpenStack python API effeciently??

  • Look at UI/marketUI/auth.py. Use the defined keystone, glance and nova clients via python command line (first run 'source ~/devstack/openrc')