Summary
This document details how to use properly Apache Ranger.
These instructions are for using Ranger on CentOS/RHEL (release 6).
This page is currently being written. Please help us by sending your remarks.
Prerequisites
Apache Ranger must have been installed on your cluster
- Ranger plugins need to be configured for the services you want to securize
- If you think you may have missed one or several steps, you can check this Ranger Installation Guide
Opening the console
First things first, in order to access to the Ranger Administrating Console, you have to log in to the Ranger Interface. By default, this interface is available on the Ambari server on the port 6080.
Once you logged in, you can see your username on the top right-hand corner of Ranger Console home page. Clicking on it allows you to log out, by a simple click on Logout at the drop-down menu.
The console allows five types of functions :
- The Repository Manager (visible upon user login) : add and manage service repositories
- The Policy Manager tab : create and manage repository policies
- The Users/Groups tab : assign policy permissions to users and groups
- The Analytics tab : perform analytics on one or more HDFS, Hive, HBase, Knox or Storm policies
- The Audit tab : monitor user activity at the resource level, and conditional auditing based on users, group or time
Repository Manager
The Repository Manager is opened by defaul after you log into the Ranger Console. Therefore to access to it from any tab in the Ranger Console, simply click on Ranger at the top left corner.
- To add a new repository to the Policy Manager : click the + button in the corresponding box on Ranger Policiy Manager, then complete the required information. When the screen have been fulfilled, click the green Add button.
- To edit an existing repository : in the Policy Manager, click the Edit icon to the right of the entry for that repository. The Policy Manager then displays an expanded view of that repository, including a list of the policies it contains, their current status, and the groups designated to administer those policies.
- To delete a repositoy from the Policy Manager : click the Delete icon to the right of the entry for that repository.