Mirror of Apache Ranger
zhangqiang2 and pengjianhua RANGER-2212: Add multiple urls tips for the ‘Kylin URL’ configuration…
… item when creating the kylin-plugin service

Signed-off-by: peng.jianhua <peng.jianhua@zte.com.cn>
Latest commit 065c03d Sep 10, 2018
Permalink
Failed to load latest commit information.
agents-audit RANGER-2196:Ensure that any explicit threads used by Ranger are marke… Aug 23, 2018
agents-common RANGER-2212: Add multiple urls tips for the ‘Kylin URL’ configuration… Sep 22, 2018
agents-cred RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
agents-installer RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
credentialbuilder RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
dev-support RANGER-2167 - Upgrade to Apache parent pom version 20 Aug 15, 2018
docs Updated organization details for few PMC members Aug 19, 2018
embeddedwebserver RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
hbase-agent RANGER-2198 - Remove deprecated client API from HBase plugin Sep 11, 2018
hdfs-agent RANGER-2167 - Upgrade to Apache parent pom version 20 Aug 15, 2018
hive-agent RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
jisql RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
kms RANGER-2167 - Upgrade to Apache parent pom version 20 Aug 15, 2018
knox-agent RANGER-2226 - Define explicit (test) dependency on json-smart in the … Sep 17, 2018
migration-util RANGER-1044: Removed Keystore/Truststore SSL password Oct 24, 2016
plugin-atlas RANGER-2201:Fix to log no ranger audits when entityId value is not nu… Aug 27, 2018
plugin-kafka RANGER-2167 - Upgrade to Apache parent pom version 20 Aug 15, 2018
plugin-kms RANGER-2167 - Upgrade to Apache parent pom version 20 Aug 15, 2018
plugin-kylin RANGER-2214: Do some code improvement for the error message for Kylin… Sep 21, 2018
plugin-nifi-registry RANGER-2157: Added NiFi Registry service Sep 18, 2018
plugin-nifi RANGER-2167 - Upgrade to Apache parent pom version 20 Aug 15, 2018
plugin-solr RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
plugin-sqoop RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
plugin-yarn RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-atlas-plugin-shim RANGER-2184 - Update RangerAtlas authorization to authorize add/updat… Aug 10, 2018
ranger-examples RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-hbase-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-hdfs-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-hive-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-kafka-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-kms-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-knox-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-kylin-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-plugin-classloader RANGER-2152: Incorrect debugging information in RangerPluginClassLoad… Jul 26, 2018
ranger-solr-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-sqoop-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-storm-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ranger-tools RANGER-2191: Update ranger-tool with new options to control Trie Aug 17, 2018
ranger-util RANGER-1951: fix the script, so it works even outside a git repository Jul 27, 2018
ranger-yarn-plugin-shim RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
security-admin RANGER-2215: Can't copy and paste multiple paths into Ranger Admin UI… Sep 19, 2018
src/main/assembly RANGER-2157: Added NiFi Registry service Sep 18, 2018
storm-agent RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
tagsync RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
ugsync RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
unixauthclient RANGER-2147: Updated version to 2.0.0-SNAPSHOT in master branch Jul 3, 2018
unixauthnative RANGER-2172: Fixing minor issue with the no. of characters read using… Aug 2, 2018
unixauthpam RANGER-2172: Fixing minor issue with the no. of characters read using… Aug 2, 2018
unixauthservice RANGER-2196:Ensure that any explicit threads used by Ranger are marke… Aug 23, 2018
.gitignore Add the correct .gitignore file to projects Nov 10, 2015
.project Changed project name from argus to ranger Dec 31, 2014
.travis.yml RANGER-1706: Add travis.yml for validating Ranger, with skipping one … Jul 27, 2017
DISCLAIMER.txt RANGER-1332: updated docs and scripts for removal of incubation Jan 25, 2017
LICENSE.txt RANGER-1109: changes to LICENSE,NOTICE,pom.xml file contents based on… Aug 12, 2016
NOTICE.txt RANGER-2147: Updated year in NOTICE.txt Jul 19, 2018
README.txt RANGER-1874 ranger README.txt should be add tar and sqoop-plugin info… Nov 7, 2017
build_ranger_using_docker.sh RANGER-2121: Ranger build using Docker is broken Jun 5, 2018
enunciate.xml RANGER-1651 : Improve Ranger and Ranger KMS REST Api documentation Sep 15, 2017
pom.xml RANGER-2157: Added NiFi Registry service Sep 18, 2018
release-build.xml RANGER-2028: Removed md5 checksum file generation Mar 22, 2018

README.txt

# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

Check Apache Ranger Wiki for up to date instruction: 
https://cwiki.apache.org/confluence/display/RANGER/Index

NOTE about using sending pull request on github:
================================================
Apache Ranger is currently NOT setup to use pull requests to take in the changes for commit.
Please use the apache review board to submit your code changes for review and commit. https://reviews.apache.org
Also create a jira to go along with the review and mention it in the review board review. https://issues.apache.org/jira/browse/RANGER

Build Process
=============

1. Check out the code from GIT repository

2. On the root folder, please execute the following Maven command:

   $ mvn clean compile package install assembly:assembly
   $ mvn eclipse:eclipse

3. After the above build command execution, you should see the following TAR files in the target folder:


   ranger-<version>-admin.tar.gz
   ranger-<version>-atlas-plugin.tar.gz
   ranger-<version>-hbase-plugin.tar.gz
   ranger-<version>-hdfs-plugin.tar.gz
   ranger-<version>-hive-plugin.tar.gz
   ranger-<version>-kafka-plugin.tar.gz
   ranger-<version>-kms.tar.gz
   ranger-<version>-knox-plugin.tar.gz
   ranger-<version>-migration-util.tar.gz
   ranger-<version>-ranger-tools.tar.gz
   ranger-<version>-solr-plugin.tar.gz
   ranger-<version>-sqoop-plugin.tar.gz
   ranger-<version>-src.tar.gz
   ranger-<version>-storm-plugin.tar.gz
   ranger-<version>-tagsync.tar.gz
   ranger-<version>-usersync.tar.gz
   ranger-<version>-yarn-plugin.tar.gz

Importing Apache Ranger Project into Eclipse
============================================

1. Create a Eclipse workspace called 'ranger'

2. Import maven project from the root directory where ranger source code is downloaded (and build)


Deployment Process
==================

Installation Host Information
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1.  Ranger Admin Tool Component  (ranger-<version-number>-admin.tar.gz) should be installed on a host where Policy Admin Tool web application runs on port 6080 (default).
2.  Ranger User Synchronization Component (ranger-<version-number>-usersync.tar.gz) should be installed on a host to synchronize the external user/group information into Ranger database via Ranger Admin Tool.
3.  Ranger Component plugin should be installed on the component boxes:
    (a)  HDFS Plugin needs to be installed on Name Node hosts
    (b)  Hive Plugin needs to be installed on HiveServer2 hosts
    (c)  HBase Plugin needs to be installed on both Master and Regional Server nodes.
    (d)  Knox Plugin needs to be installed on Knox gateway host.
    (e)  Storm Plugin needs to be installed on Storm hosts.
    (f)  Kafka/Solr Plugin needs to be installed on their respective component hosts.
    (g)  YARN plugin needs to be installed on YARN Resource Manager hosts
    (h)  Sqoop plugin needs to be installed on Sqoop2 hosts

Installation Process
~~~~~~~~~~~~~~~~~~~~

1. Download the tar.gz file into a temporary folder in the box where it needs to be installed.

2. Expand the tar.gz file into /usr/lib/ranger/ folder

3. Go to the component name under the expanded folder (e.g. /usr/lib/ranger/ranger-<version-number>-admin/)

4. Modify the install.properties file with appropriate variables

5. If the module has setup.sh, 
       Execute ./setup.sh

   If the install.sh file does not exists, 
       Execute ./enable-<component>-plugin.sh