Skip to content

Commit

Permalink
Update readme description
Browse files Browse the repository at this point in the history
Add installation manual for CentOS and fix
steps for application deploying and running under Ubuntu.

Changed default port for webui from 8000 to 8008 to run it near other
web applications.

Removed old Procfile for production.

Change-Id: I1472bf2e726078b3d12a7b978cb10ebe8cb8cc09
Closes-Bug: #1256920
  • Loading branch information
plomakin committed Dec 2, 2013
1 parent 5d9a7d3 commit a9b8de3
Show file tree
Hide file tree
Showing 4 changed files with 25 additions and 10 deletions.
2 changes: 0 additions & 2 deletions Procfile.production

This file was deleted.

29 changes: 23 additions & 6 deletions README.md
Expand Up @@ -11,24 +11,40 @@ Installation
### Completely environment in VirtualBox via Vagrant
1. Install vagrant(MacOS, Windows, Ubuntu) - http://downloads.vagrantup.com/tags/v1.3.3 and latest version of Virtualbox
2. ```$ vagrant up && vagrant provision```
3. After that you can access application on http://host_machine_ip:8000/
3. After that you can access application on http://host_machine_ip:8008/
4. For testing purposes of your application you can install latest-devstack installation via vagrant. We strongly recommend you to use this repo: https://github.com/lorin/devstack-vm. There are a lot of choices for devstack installation for Rubick to validate: with or without neutron\swift\security_groups\tempest etc.
5. After that you’ll get full worked environment with Rubick and OpenStack.

### Manual installation and running

For Ubuntu:

```shell
$ git clone https://github.com/stackforge/rubick && cd rubick
$ sudo apt-get install build-essential mongodb-server redis-server python-pip
$ sudo pip install -r requirements.txt
$ python webui.py &
$ celery worker --app=rubick.celery:app &
$ honcho start
```
All steps for manual deployment and running the app you can find here: /vagrant/cookbooks/openstack-validator/recipes/default.rb

For CentOS:

Follow the official documentation to take enable EPEL repo in your system: http://fedoraproject.org/wiki/EPEL/FAQ#How_can_I_install_the_packages_from_the_EPEL_software_repository
After that install dependencies and run an application.

```shell
$ git clone https://github.com/stackforge/rubick && cd rubick
$ sudo yum install build-essential mongodb-server redis-server python-pip
$ sudo pip install -r requirements.txt
$ honcho start
```
Note: If you use fuel-pm node as a rubicks destination node, you'll need to return CentOS base repositaries in the yum settings.

Note2: All steps for manual deployment and running the app you can find here: /vagrant/cookbooks/openstack-validator/recipes/default.rb

Rubick usage
-------------

Open http://host_machine_ip:8000/ with web-browser, host_machine_ip - address your application is installed.
Open http://host_machine_ip:8008/ with web-browser, host_machine_ip - address your application is installed.
Add new cluster by pushing the button “Add cluster” and fill the fields:

1. “Cluster name” - with name of your cluster (e.g. local_devstack )
Expand All @@ -44,7 +60,7 @@ Rubick Command Line usage examples

```
$ python rubick/cli.py -h
$ python rubick/cli.py -l -v http://<host>:8000
$ python rubick/cli.py -l -v http://<host>:8008
$ python rubick/cli.py -a -n 'New_cluster_name' -d 'New description' -H 'root@10.10.3.1:2022' -k ~/.ssh/id_rsa http://<host>:8008
```

Expand All @@ -54,3 +70,4 @@ Hacking
-------

To check project on compliance to PEP8 run command use: tox -v.

2 changes: 1 addition & 1 deletion Vagrantfile
Expand Up @@ -6,7 +6,7 @@ Vagrant.configure("2") do |config|
config.vm.define "web" do |web|
web.vm.box = "ubuntu12.04-server-amd64"
web.vm.box_url = "http://goo.gl/8kWkm"
web.vm.network "forwarded_port", guest: 8000, host: 8000, host_ip: '0.0.0.0'
web.vm.network "forwarded_port", guest: 8008, host: 8008, host_ip: '0.0.0.0'
web.vm.provider "virtualbox" do |vb|
vb.customize ["modifyvm", :id, "--memory", "1024"]
vb.customize ["modifyvm", :id, "--cpus", "1"]
Expand Down
2 changes: 1 addition & 1 deletion webui.py
Expand Up @@ -204,4 +204,4 @@ def job(id):
return json.dumps({'state': str(job.state).lower()})

if __name__ == '__main__':
app.run(host='0.0.0.0', port=8000, debug=True)
app.run(host='0.0.0.0', port=8008, debug=True)

0 comments on commit a9b8de3

Please sign in to comment.