The scratchDir specified is unusable
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Problem
The following appears in the atlassian-confluence.log
:
1
2
2015-02-11 18:18:17,298 ERROR [localhost-startStop-1] [org.apache.jasper.EmbeddedServletOptions] log The scratchDir you specified: C:\Program Files\Atlassian\Confluence\work\Standalone\localhost\_ is unusable.
The following appears in the catalina.out
:
1
2
Feb 11, 2015 6:15:26 PM org.apache.catalina.core.StandardContext postWorkDirectoryWARNING: Failed to create work directory [C:\Program Files\Atlassian\Confluence\work\Standalone\localhost\_] for context []
Cause
The Tomcat process is not able to access the scratchDir or deployment directory, most likely due to file permissions. The scratchDir is used by Tomcat when compiling JSPs which is the technology used to render the dynamically created web pages in Confluence. If Tomcat cannot access that directory it can result in failures to properly operate.
Resolution
Stop Confluence.
Fix the permissions for the below directories and all of their subdirectories:
1 2
$CONFLUENCE_HOME/ $CONFLUENCE_INSTALL/
Expand for Linux instructions...
These instructions refer to the default user, group & installation paths for Confluence, as if it were installed using the bundled installer. If you're unsure of what these permissions should be, please consult with your System Administrator and the user who installed Confluence.
1 2
sudo chown -R confluence:confluence /var/atlassian/application-data/ sudo chown -R confluence:confluence /opt/atlassian/Confluence/
Expand for Windows instructions...
Please refer to this Microsoft documentation for further information. More detailed documentation from technet.
Remove the following directory:
1
$CONFLUENCE_INSTALL/work/Standalone
ℹ️ This will be rebuilt when Confluence is restarted.
Start Confluence.
Was this helpful?