STASH_USER .profile is not evaluated when starting Stash through start-stash.sh

When STASH_USER is set, start-stash.sh starts Tomcat through a call to runuser or su. However, it does so without passing the -l flag and as a result, the standard Linux login hooks that set up the environment variables are not evaluated.

This means that you cannot set JAVA_HOME in the STASH_USER's ~/.profile file.

To fix:

• Add the -l flag to the command
• Add a comment to setenv.sh listing places where the STASH_HOME and JAVA_HOME variables can be defined.
• Review the public installation documentation and ensure that the same suggestions are made there.

Workaround
Define JAVA_HOME and/or STASH_HOME in /etc/environment. Note that these variables will then apply system-wide.