Lucene health check

[Katrin Walter]

Hello,

the Lucene index files location health check verifies that our JIRA application is using a Network File System (NFS) mount for the Lucene index files.

Could you give me the path where i can find indexes at the moment to move them?

Where can I configure the directory to a local directory in the JIRA Application?

Thank you very much.

Katrin

[Nic Brough -Adaptavist- · Accepted solution]

Have a look in the system information page to find out what the "home directory" for Jira is.  The indices are kept in there under "caches/indexes"

You cannot change this in the UI, you need to do it at an operating system level.

Although it is only the index which will go horribly wrong if left on NFS, we recommend that you do not place most of the Jira home directory on NFS at all.  For a server Jira, only the attachments should be on NFS.  For Data Centre, there's a few more directories to be shared.  But never the index.

Most of us will either mount a partition at the root of the attachments, or symbolically link the directory.

[Katrin Walter]

Thank you, I found the home directory where it is stored.

How can I do this:

Change the mounting location of the index dir such that it is not mounted over NFS. Only the index directory needs to be mounted locally, it's completely possible to have the application home mounted on NFS except for the lucene dir and this will be acceptable. This can be done with folder mount points.

We can change the directory but I have to communicate the new directory to jira. How can I do this?

Thank you for that.

[Nic Brough -Adaptavist-]

You don't.  The mount and symbolic link options both make the directory appear as part of the home directory.

Here's a rough example:

Let's say you've got two partitions to work with.  P1 is the main local disk, so it's got the OS, and (say) /opt/jira-install and /opt/jira-home to keep Jira in.

P2 is an NFS partition.  For the sake of this example, let's assume it's currently empty, and you just want to use it for attachments.

Option 1 is to use a simple mount. 

• Temporarily mount P2 somewhere like /mnt/tempnfs
• Move everything from /opt/jira-home/attachments to /mnt/tempnfs
• Unmount P2, then make a permanent mount for P2 at /opt/jira-home/attachments

Option 2 is to use links

• Mount P2 somewhere convenient like /mnt/nfs
• Replace the directory /opt/jira-home/attachments with a symbolic link that points to /mnt/nfs

Note that option 2 can be more flexible, because you locate the target files lower in the tree, so you could have /mnt/nfs/jira-shared-data/attachments and point the link there.

[Katrin Walter]

Thank you very much for the detailed information. We configured the directory successfully.