Unable to Index JIRA due to The specified network name is no longer available

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

Summary

Symptoms

Attempting to index JIRA fails with either of the below exceptions:

The following appears in the browser:

(Auto-migrated image: description temporarily unavailable)

And the following appears in the atlassian-jira.log:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 java.lang.NullPointerException at org.apache.lucene.index.SegmentNorms.decRef(SegmentNorms.java:102) at org.apache.lucene.index.SegmentNorms.decRef(SegmentNorms.java:94) at org.apache.lucene.index.SegmentReader.doClose(SegmentReader.java:384) at org.apache.lucene.index.IndexReader.decRef(IndexReader.java:242) at org.apache.lucene.index.DirectoryReader.doClose(DirectoryReader.java:895) at org.apache.lucene.index.IndexReader.decRef(IndexReader.java:242) at org.apache.lucene.index.IndexReader.close(IndexReader.java:1208) at com.atlassian.jira.index.DefaultIndexEngine$SearcherFactoryImpl.release(DefaultIndexEngine.java:392) at com.atlassian.jira.index.DefaultIndexEngine.close(DefaultIndexEngine.java:166) at com.atlassian.jira.index.DefaultIndexEngine.clean(DefaultIndexEngine.java:137) at com.atlassian.jira.index.DefaultManager.deleteIndexDirectory(DefaultManager.java:43) at com.atlassian.jira.issue.index.DefaultIssueIndexer.deleteIndexes(DefaultIssueIndexer.java:205) at com.atlassian.jira.issue.index.DefaultIndexManager.doStopTheWorldReindex(DefaultIndexManager.java:826) at com.atlassian.jira.issue.index.DefaultIndexManager.reIndexAll(DefaultIndexManager.java:337) at com.atlassian.jira.issue.index.DefaultIndexManager.reIndexAll(DefaultIndexManager.java:303) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

Diagnosis

The JIRA indexes directory, $JIRA_HOME/caches/indexes, is mounted on a remote network share using NFS.

Cause

The JIRA indexes are created using Java functionality called Lucene. Lucene does not support NFS mounts as stipulated in their IndexWriter docs. This is also listed in our JIRA Supported Platforms.

Solution

Resolution

This can be resolved by moving the indexes directory, $JIRA_HOME/caches/indexes, to a local mount on the server that is running JIRA. This depends upon the OS that is being used - for Windows the Assign a mount point folder path to a drive TechNet article will be of assistance.

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.