Resource Management API Framework
Go to file
Tin Lam 1f4ba7fb30 Add releasenotes
This patch set adds releasenotes to openstack/ranger project.

Change-Id: Ib8f18d8e2ecdac43a80afda8a3e3aaf659cb6661
Signed-off-by: Tin Lam <tin@irrational.io>
2018-05-08 02:07:01 -05:00
doc/source initial commit 2017-07-27 09:14:42 -05:00
etc Add oslo_config and oslo_log to Ranger 2017-11-07 08:10:49 -06:00
orm start services using docker container 2018-05-01 09:18:57 -05:00
public initial commit 2017-07-27 09:14:42 -05:00
ranger_tempest_tests Updated README for ranger and added tempest and debian directories 2017-11-07 09:21:48 -05:00
releasenotes Add releasenotes 2018-05-08 02:07:01 -05:00
tools start services using docker container 2018-05-01 09:18:57 -05:00
.coveragerc Add coverage to ranger 2017-08-15 14:04:01 -07:00
.gitignore Change X-AIC-ORM to X-RANGER 2017-09-22 11:05:39 -05:00
.gitreview Added .gitreview 2017-05-29 07:18:45 +00:00
.testr.conf Set up tox to run unit tests 2017-08-09 12:44:14 -05:00
Dockerfile start services using docker container 2018-05-01 09:18:57 -05:00
MANIFEST.in initial commit 2017-07-27 09:14:42 -05:00
README.rst Updated README for ranger and added tempest and debian directories 2017-11-07 09:21:48 -05:00
babel.cfg initial commit 2017-07-27 09:14:42 -05:00
config.py initial commit 2017-07-27 09:14:42 -05:00
requirements.txt start services using docker container 2018-05-01 09:18:57 -05:00
setup.cfg Add oslo_config and oslo_log to Ranger 2017-11-07 08:10:49 -06:00
setup.py initial commit 2017-07-27 09:14:42 -05:00
test-requirements.txt Add releasenotes 2018-05-08 02:07:01 -05:00
tox.ini Add oslo_config and oslo_log to Ranger 2017-11-07 08:10:49 -06:00

README.rst

Ranger

Ranger is an OpenStack Resource Management tool capable of managing different types of clouds into one platform. Here are the following of what it provides:
  • Multi-region common resource management.
  • Light weight, stateless and interface with external self-service portals.
  • Runs on DCP.
  • Resource agents will run on LCP to orchestrate and keep resources in sync from a centralized repository.

Devstack Installation

  1. You can include ranger repository in local.conf when running devstack.

    enable_plugin ranger git://git.openstack.org/openstack/ranger

  2. Make sure MYSQL_PASSWORD is included for creating and accessing the database.

Before Setting Up

Make sure ranger-agent is running before installing and running ranger since that is required for connecting with Openstack.

Generate ranger.conf file

$tox -e genconfig

A blank configuration file will be generated at etc/ranger.conf

Installation

1. Clone the repo and go to the tools directory.

$ git clone https://git.openstack.org/openstack/ranger $ cd ranger/tools

  1. To make changes to the port numbers and other configurations, please go to base_config.py under the orm folder before continuing to the next steps.
  2. Run ./ranger_create_db.sh to create the database.
  3. Run ./setup_apache.sh to create conf files for each of the services to apache.
  4. Run stack_orm.sh to run ranger.
  5. If stack_orm.sh is not running properly, please do the following:
    1. Go to the root of ranger.
    2. sudo pip install -r requirements.txt
    3. sudo python setup.py develop 2>&1 | tee $root_dir/tools/install.log

Running Ranger Services

To run each of the services, type in these commands in order to run each of the services.
  • Audit: orm-audit
  • Uuidgen: orm-uuidgen
  • RDS (Resource Distributor Service): orm-rds
  • RMS (Resource Management Service): orm-rms
  • FMS (Flavor Management Service): orm-fms
  • CMS (Customer Management Service): orm-cms
  • IMS (Image Management Service): orm-ims

For RMS, FMS, CMS, and IMS to be running, Audit, Uuidgen, and RDS must also be running properly as well in order to use them.