Structure Plugin uses embedded Apache Derby database to store its data. The database files are located in JIRA home directory and are crucial for the plugin operation.
If you suspect that Structure's database may have failed, please go through the following check list before calling in support. Usually it's one of those problems.
For brevity, we'll use Unix-like path names with "/" as the separator. On Windows, the path names are delimited with "\". We'll also write $JIRA_HOME
to refer to the JIRA home directory.
$JIRA_HOME
and $JIRA_HOME/structure/db
?$JIRA_HOME/structure
?
$JIRA_HOME/structure
mounted read-write?
$JIRA_HOME/structure
.$JIRA_HOME/structure
and lock it?
Observation: You start JIRA or enable Structure Plugin, but it immediately gets disabled.
Explanation: Structure shuts down and disables itself if it cannot properly start the database. Check the server logs for the following message:
Structure Plugin failed to start its database and will be DISABLED in a few seconds. ... ==================================================================================== Structure Plugin failed to start and was automatically DISABLED. Error message: .... Please fix the problem and enable the plugin again through the Plugin Manager. If the problem persists, please contact support. ====================================================================================
Observation: The structure is displayed correctly in the browser, but any attempt to change the hierarchy results in red error messages at the bottom of the screen, saying there was a problem on the server.
Explanation: It is possible that the database has shut down or become read-only due to one of the reasons mentioned above. Since Structure has some information in the server-side cache, it still can serve certain requests.
Check the logs for the following message:
================================================== Structure Plugin storage problem: .... ==================================================