The scratchDir specified is unusable

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

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:

 
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:

 
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

  1. Stop Confluence.

  2. Fix the permissions for the below directories and all of their subdirectories:

    $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.

    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.

  3. Remove the following directory:

    $CONFLUENCE_INSTALL/work/Standalone

    (info) This will be rebuilt when Confluence is restarted.

  4. Start Confluence.

Last modified on Apr 21, 2016

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.