Page History

...

1. Start by extracting out binaries at the appropriate place. 

       cd /usr/local

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

       sudo ln -s ranger-0.4.0-usersync ranger-usersync

       sudo mkdir -p /var/log/ranger-usersync

       sudo chown ranger /var/log/ranger-usersync; sudo chgrp ranger /var/log/ranger-usersync

       cd ranger-usersync

2. Now let’s edit the install.properties file. Here are the relevant lines that you should edit:

        POLICY_MGR_URL=http://localhost:6080 (This should point to the server where Ranger Admin has been installed)

        SYNC_SOURCE=unix (This assumes that the user from the linux/unix system will be synchronized)  [TBD - Link to configure LDAP]. If you want to use LDAP users, you can find here how to Configure Ranger UserSync for LDAP 

        logdir=/var/log/ranger/usersync

3. Now install the usersync by running the setup command

        export JAVA_HOME=/usr/lib/jvm/java-1.7.0-openjdk-amd64 (Change this to your Java install folder)

        ./setup.sh

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

5. update ranger-usersync service file to link to the start and stop scripts 

        vim /etc/init.d/ranger-usersync ( Update the Start and Stop commands to point to the created symlinks )

6. Start the Ranger Usersync
         service ranger-usersync start

7. You can verify by looking at the users tab in Ranger Admin. Unix host users should be sync'ed to ranger.

8. Logs are in logs folder. It is relative to the location where ranger-usersync was installed. Look for usersync.log file for User Sync related errors and auth.log for remote login errors.

...