Pre-Upgrade Steps for Sentry

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

About this task

IMPORTANT This component is deprecated. Hewlett Packard Enterprise recommends using an alternate product. For more information, see Discontinued Ecosystem Components.
You must stop the Sentry service before you upgrade. If you modified the configuration files in your current installation of Sentry, you can back up the configuration files to preserve the changes that you want to carry over to the next version.
To stop the Sentry service, issue one of the following commands:
  • If the warden.sentry.conf exists in the /opt/mapr/conf/conf.d/ directory: 
    maprcli node services -name sentry -action stop -nodes <list of Sentry service nodes>
  • If the warden.sentry.conf does not exist in the /opt/mapr/conf/conf.d/ directory:
    /opt/mapr/sentry/sentry-<SENTRY_VERSION>/bin/sentry-daemon.sh stop

To back up the configuration files, copy the files in /opt/mapr/sentry/sentry-<version>/conf/ to a location outside of the MapR installation directory. After upgrading, you can reapply changes to the updated Sentry installation using the backup.

Preserving Sentry Configuration

Starting from EEP 6.0.0, preserving of user configuration logic is built into Sentry.

Procedure

  • For a minor version update (for example, Sentry-1.7-1803 to Sentry-1.7-1808), user configuration from a previous version is copied to a folder with an old version timestamp and is also copied to a new version conf folder.
  • For a major version update (for example, Sentry-1.6-1707 to Sentry-1.7-1808), user configuration from a previous version is only copied to a folder with an old version timestamp.

Upgrading from EEP 6.3.1 and EEP 7.0.0

If you are upgrading from Sentry in EEP 6.3.1 or EEP 7.0.0 to Sentry in the latest EEP version, you must manually back up the /conf and /logs directories located in SENTRY_HOME. After the upgrade completes, add those directories back into the SENTRY_HOME directory.

About this task

You can locate the /conf and /logs directories in the Sentry installation directory, as shown:
ll /opt/mapr/sentry/sentry-1.7.0
total 76
drwxr-xr-x 2 mapr mapr  4096 Jan  5 13:34 bin
-rw-r--r-- 1 mapr mapr 15211 Jan  5 10:26 CHANGELOG.txt
drwxr-xr-x 2 mapr mapr  4096 Jan  5 13:34 conf
drwxr-xr-x 2 mapr mapr  4096 Jan  5 13:34 conf.d
drwxr-xr-x 2 mapr mapr  4096 Jan  5 13:34 conf.new
drwxr-xr-x 4 mapr mapr 12288 Jan  5 13:34 lib
-rw-r--r-- 1 mapr mapr 16000 Jan  5 10:26 LICENSE.txt
drwxr-xr-x 2 mapr mapr  4096 Jan  5 13:34 logs
-rw-r--r-- 1 mapr mapr   388 Jan  5 10:26 NOTICE.txt
-rw-r--r-- 1 mapr mapr  1580 Jan  5 10:26 README.md
drwxr-xr-x 3 mapr mapr  4096 Jan  5 13:34 scripts
For additional information, see Sentry.