Stash fails to start - UnsupportedDirectoryOverrideException
Symptoms
The following (or similar) appears in atlassian-stash.log:
Caused by: com.atlassian.stash.internal.home.UnsupportedDirectoryOverrideException: Overriding log directory location using stash.home.log system property is no longer supported
...
Cause
Before Stash 3.2 it was possible to use undocumented features to override the location of the following subfolders in stash home:
exportbincachesconfigdataliblib/nativelogpluginstmp
To achieve this users had two options:
- Introduce an environment variable in the form
STASH_HOME_[OVERRIDE], e.g. for overriding log -STASH_HOME_LOG - Or introduce a system property in the form
stash.home.[override], e.g. for overriding log -stash.home.log
In Stash 3.2 and above the option to override the location of the subfolders in stash home is greatly reduced and will only work on the following folder:
tmp
For all other folders Stash will refuse to start with the symptoms described in the previous section.
Resolution
To resolve the issue stash admins need to move the changed folders back under stash home. For instance if the location of bin folder was overridden using the environment variable STASH_HOME_BIN then:
- Firstly,
binmust be put back underSTASH_HOME/binand - Secondly, the corresponding environment variable (
STASH_HOME_BIN)must be undefined
The same applies if system properties have been used instead of environment variables.