Resolve JEMH Folder is not writable Banner

Owned by Ryan Clifton
Last updated: Oct 23, 2023
4 min read

since 4.1.25

Summary

When you see the below banner it means that the User that is running the Jira Instance does not have the correct permissions/access to write to the JEMH folder within JIRA_HOME/data/jemh. Without Write, Read and Execute permissions on this folder it means that JEMH will not be able to process any emails as JEMH is not able to save an audit copy of the email within the folder.

Due to this, we have changed the behaviour so that JEMH does not process any incoming emails when the environment user (User that runs Jira on the system) does not have permission/access to write to the folder (this is to prevent lose of data). When this occurs a banner will be displayed within the JEMH configuration to help make you aware of this issue.

Resolution

To resolve this issue, you will need to go to JIRA_HOME/data and either change the Ownership of this folder and its sub-folders to the Environment user that runs Jira or add the Read (r),Write (w) and Execute (x) permission to the JEMH folder.

Example Linux Terminal commands to change owner/permissions:

Change Ownership:

Below will change the ownership of the jemh folder and its sub-folders to “jiraUser”.

sudo chown -R jiraUser:jiraUser jemh

Add missing Permissions:

Below will add the Read, Write and Execute permission to the jemh folder and its sub-folders.

sudo chmod -R +rwx jemh

Below is a screenshot that show the correct permissions that the jemh Folder would have:

Change owner/permissions within Windows

In order for a user to be have the Read, Write and Execute permissions then you will need to grant the user Full Control of that folder and it’s sub-folders.

In order to change the Owner and Permissions,

  1. Go to <Jira_home>/data and then Right Click on jemh and then select Properties.

  2. This will show the Properties for that folder, once here go to the Security tab

  3. Then to change the Permissions and Owner Press Advanced.

    This will then show the current owner and the current Permissions, here you can now modify the Owner and any Permissions. See the following to change the relevant sections.

Change Ownership:

In order to change the Owner of the Folder and any sub-folders you will require the windows Administrator permission to make the change.

  1. If you have the Permission to change this then you will need to press Change (next to the current owner)

  2. Here you are then able to set the new owner

  3. Once this is set you will then able to set this change to affect the sub-folders.

     

  4. To save this you will then need to Press Apply.

Change/Add permissions:

To change the Permissions for a User/Group,

  1. You will need to select the relevant Permission entry and then Press Edit

  2. Then select the relevant Permissions that should be granted (Read, Write and Execute) or Press Full Control to grant all Permissions. Example below shows Full control.

  3. To apply for all sub-folders you will need to select “This folder, subfolders and files” for Applies to:

  4. Once all is configured select, Ok and then press Apply, and this will then set all of the new permissions for this folder and its sub-folders.