JIRA

Install

Admin

Use

	JIRA Administrator's Guide Introduction Getting Help Look and Feel Logo, Colours and Timezone Configuring the default Language Configuring the default Issue Navigator Configuring the default Dashboard Overview of Dashboard Portlets Enabling Portlets and Other Plugins Editing the Announcement Banner Enabling Logout Confirmation Email Email Overview Creating a Notification Scheme Customising Email Content Creating Issues & Comments from Email SMTP configuration User Management Managing Users Managing Groups Managing Project Roles Migrating from Groups to Project Roles Enabling public signup and CAPTCHA Integrating JIRA with LDAP Integrating JIRA with Crowd Configuring Trusted Applications Security Overview Global permissions Project permissions Issue security Project Management Defining a Project Assigning members to Project Roles Defining Project Components Defining Project Versions Creating Release Notes for a Version Configuring Project Keys Configuring Fields and Screens Overview Defining 'Resolution' field values Defining 'Priority' field values Defining 'Status' field values Defining 'Issue Type' field values Associating Issue Types with Projects Translating Resolution/Priority/Status/Type Configuring field behaviour Configuring rich-text renderers Associating behaviour with Issue Types Placing fields on screens Associating screens with Issue Operations Associating screens with Issue Types Creating & configuring Custom Fields Custom Field Overview Adding Custom Fields Configuring Custom Fields Configuring Workflow Workflow Activating Workflow Events Importing from Other Systems Importing from Bugzilla Importing from Mantis Importing from FogBugz Importing from Excel/CSV Moving or Archiving Individual Projects Overview Archiving a project Merging JIRA instances Splitting JIRA instances Integrating with Source Control Integrating with CVS and ViewCVS Integrating with Subversion Integrating with Perforce Integrating with ClearCase Integrating with FishEye Configuration Options & Settings Global Settings Enabling Issue Linking Enabling Sub-tasks Enabling Trackback linking Enabling Time Tracking Enabling File Attachments Step 1: Enabling attachme.. Step 2: Granting the 'Cre.. Changing the attachment s.. Specifying the maximum at.. Enabling Thumbnails for Attachments Server Administration Indexing & Search Backing up Data Automated Backups Restoring Data Database Integrity Checker Increasing memory Performance Tips Database Indexing Precompile JSP pages Logging and Profiling Thread Dump Downgrading (Ent to Pro) Downgrading (Ent to Std) Downgrading (Pro to Std) Using robots.txt with Search Engines Appendix A - Extending JIRA Extension Overview Listeners Services Jelly tags JIRA Toolkit Customising Text Developer Guides JIRA Plugins JIRA RPC Overview Creating a SOAP Client Creating an XML-RPC Client Creating Custom Field Types Custom Workflow Elements Creating new Portlets Creating new Reports More.. JIRA Source Building JIRA from source API Documentation

Configuring File Attachments

PDF

When you enable file attachments, you allow users to attach files and screenshots to JIRA issues. This requires space on the server to save the attachments into. Note that attachments are not stored in JIRA's database and so will need to be backed up separately.

Configuring file attachments takes two steps:

Enabling attachments.
Granting the 'Create Attachments' permission to appropriate users.

Additionally, if you wish to allow users to attach a file when creating a new issue, you need to ensure that the 'Attachment' field is not hidden within the field configuration(s) associated with the specific issue type(s).

Step 1: Enabling attachments

Log in as a user with the 'JIRA System Administrators' global permission.
Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard:
Under the 'Global Settings' sub-menu in the left-hand navigation column, click the 'Attachments' link. This will display the 'Attachment Settings' page, which states whether attachments are on or off:
Click the 'Edit Configuration' link.
In the 'Allow Attachments' field, select 'ON'.
In the 'Attachment Path' field, type the absolute or relative path to the directory where attachments will be stored. Note that this directory should be given appropriate security as described in Security Overview.
(Optional) In the 'Enable Thumbnails' field, select 'ON' if you wish to enable image attachments to be displayed as thumbnails. For details please see 'Image attachment thumbnails'.
Click the 'Update' button.

Step 2: Granting the 'Create Attachments' permission to users

You now need to grant the 'Create Attachments' permission to appropriate users in the permission scheme(s) of project(s) for which you wish to allow attachments.

Log in as a user with the 'JIRA Administrators' global permission.
Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard:
Under the 'Schemes' sub-menu in the left-hand navigation column, click the 'Permission Schemes' link. This will display a list of all permision schemes in your JIRA system, and the projects which use each scheme.
For each relevant permission scheme,
1. Click the 'Permissions' link to edit the scheme.
2. In the 'Permissions' drop-down list, find 'Create Attachments', and click the 'Add' link.
3. In the 'User-Group' drop-down list, select the relevant group. Then click the 'Add' button.

Changing the attachment size limit

The default maximum attachment size is 10Mb. This can be changed, but not yet through the web interface (see JRA-2994).

To change the maximum attachment size, edit the atlassian-jira/WEB-INF/classes/webwork.properties file and change the webwork.multipart.maxSize parameter.

Specifying the maximum attachments per issue

JIRA allows multiple files to be attached to an issue in one operation. From the 'Attach File' page, the user can toggle between multiple and single attachment screens by selecting the 'Attach multiple' files link. The attachment form will retain the multiple/single attachment preference for that specific user for the duration of the user's session or until manually changed.

The number of attachment 'boxes' to be displayed on the multiple attachment screen is set to 3 by default. To change this, edit jira.attachment.number in the jira-application.properties file, then restart JIRA.