Resource Management API Framework
Go to file
Tin Lam 765a22d817 Update document building tox target
This patch set updates the tox targets for doc and reno building so it is
in line with other OpenStack projects' structure.

Change-Id: I7f2ce87f7eb04429ace11070ce4ac07bfe2eed1a
Signed-off-by: Tin Lam <tinlam@gmail.com>
2018-08-10 22:46:55 -05:00
doc Update document building tox target 2018-08-10 22:46:55 -05:00
etc Add oslo_config and oslo_log to Ranger 2017-11-07 08:10:49 -06:00
orm [US429508] Adding customer_creator flavor_creator admin image roles 2018-07-30 16:11:20 +00:00
public initial commit 2017-07-27 09:14:42 -05:00
ranger_tempest_tests Update orm service port in ranger tempest config 2018-06-14 19:47:27 -05:00
releasenotes Add releasenotes 2018-05-08 02:07:01 -05:00
tools Fix ranger database scripts 2018-05-24 20:24:49 -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 Uncomment requirement and install dependency 2018-07-10 14:08:25 -05:00
MANIFEST.in initial commit 2017-07-27 09:14:42 -05:00
Makefile Add conditional proxy values to Makefile 2018-07-23 11:22:27 -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 Update pecan to >= 1.3.2 2018-07-12 15:31:17 -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 Update document building tox target 2018-08-10 22:46:55 -05: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.