Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Lay down the binaries into appropriate places.  

    • cd /usr/local

    • sudo tar zxf ~/dev/ranger/target/ranger-0.4.0-admin.tar.gz

    • sudo ln -s ranger-0.4.0-admin ranger-admin
  2. cd ranger-admin and open install.properties using your text editor (e.g. vi install.properties)
  3. Verify the root password that you had picked while installing mysql.  I had chosen root so the relevant section in my install.properties file looks as follows 
    • db_root_user=root
    • db_root_password=root
    • db_host=localhost

  4. The install process would create a couple of users in the database for storing administration and audit information, pick passwords for those too.  With my choices here’s how the relevant sections in the install.properties file look now.
    • # DB information Ranger Policy Store schema
      #
    • db_name=ranger
    • db_user=rangeradmin
    • db_password=rangeradmin
    • # DB UserId for storing auditlog infromation
    • #
    • audit_db_name=ranger
    • audit_db_user=rangerlogger
    • audit_db_password=rangerlogger
  5. Ranger allows you to get different authentication modes but for now let’s just leave rest of the things in install.properties file as they are. 
  6. Once all the required properties are updated, execute the below scripts to install ranger admin service.

        Execute : ./setup.sh
        Execute : ./set_globals.sh

  7. Create a valid symlink in /usr/bin/ for start/stop of ranger admin
        cd /usr/bin
        ln -sf /usr/local/ranger-admin/ews/start-ranger-admin.sh ranger-admin-start
        ln -sf /usr/local/ranger-admin/ews/stop-ranger-admin.sh ranger-admin-stop

  8. Update ranger-admin service file to link to the start and stop scripts
        vim /etc/init.d/ranger-admin ( Update the Start and Stop commands to point to the created symlinks )

  9. Start the Ranger Admin
         service ranger-admin start

  10. You can verify by visiting the external URL of the server using browser, for example :
        http://<Host Address>:6080/

  11. Logs are in ews/logs folder. The path is relative to where you have installed ranger-admin. Check xa_portal.log and catalina.out files for ERROR and WARN log messages

Next Steps

  • Ranger Admin authentication can be configured to use LDAP or Linux system. Consider configuring one of them in production environment
  • Review database capacity for Audit database. It can grow dramatically in HBase or high volume environment. 

Install/Configure Ranger User Sync

...