Stash fails to start - UnsupportedDirectoryOverrideException

Troubleshooting Installation

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

症状

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 under STASH_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.

 

最終更新日 2014 年 7 月 21 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.