Pre-Upgrade Steps for Sentry

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

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 installation directory. After upgrading, you can reapply changes to the updated Sentry installation using the backup.

Preserving Sentry Configuration

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

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 MEP 6.3.1 and MEP 7.0.0

If you are upgrading from Sentry in MEP 6.3.1 or MEP 7.0.0 to Sentry in the latest MEP 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.

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.