Stash fails to start - UnsupportedDirectoryOverrideException
症状
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
...
原因
Before Stash 3.2 it was possible to use undocumented features to override the location of the following subfolders in stash home:
export
bin
caches
config
data
lib
lib/native
log
plugins
tmp
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.
ソリューション
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,
bin
must be put back underSTASH_HOME/bin
and - Secondly, the corresponding environment variable (
STASH_HOME_BIN)
must be undefined
The same applies if system properties have been used instead of environment variables.