Pre-Upgrade Steps for Ranger

Complete the following steps before you upgrade Ranger with or without the Installer.

About this task

Use these steps:

Procedure

  1. Stop the Ranger Admin and Ranger UserSync services if they are installed:
    maprcli node services -name ranger-admin -action stop -nodes <node list> 
    maprcli node services -name ranger-usersync -action stop -nodes <node list>
  2. If necessary, back up the Ranger configuration file. If you made configuration changes that you want to carry over to the next version, you need to back up the file. Typically, the following configuration files contain changes:
    • For services:
      • <ranger_home>/ranger-admin/ews/webapp/WEB-INF/classes/conf/ranger-admin-site.xml
      • <ranger_home>/ranger-usersync/conf/ranger-ugsync-site.xml
    • For plug-ins:
      • <ranger_home>/ranger-<component_name>-plugin/install.properties
    To back up a configuration file, copy the file to a location outside the installation directory. After upgrading, you can use the backup to reapply changes to the updated Ranger installation.