Starting a Policy Run

What is a Policy Run

The Policy Run is the process when the Attachment Housekeeper scans issues to mark attachments which matches the specified criteria for deletion.
After this process is completed,

• those marked attachment are soft deleted (i.e. they cannot be downloaded, but still can be unmarked)

• a report is available to see the details of the policy run

There is a separate housekeeping job to delete the attachments permanently after their retention period.

How to run a Policy

You should have a policy ready before proceeding. You can read our guide on Managing Attachment Housekeeper Policies first before continuing

There are 2 ways to run a policy:

• Via the project setting page (Recommended)

• Via the Attachment Housekeeper main page (Jira admin only)

Project Setting Page

1. Login as a Jira administrator or project admin.

2. Navigate to the project settings page for the project you want to run a policy on.

3. Locate the Attachment Housekeeper at the bottom of the project settings sidebar.

   

4. Click on Housekeeping Policy to view the policy currently linked to the project.

5. If there is an already linked policy, you can click on the Run Current Policy button to run the displayed policy.

If the current policy is not suitable, refer to Attachment Housekeeper for Project Admins for selecting another policy for your project.

Attachment Housekeeper Main Page

1. Login as a Jira administrator.

2. Go to Administrator > Issue Archiver

3. Click on Housekeeping Policies to view all available policies

4. Find the policy you want to run and click on the ▶️ button to run the policy.

If you trigger a run via the admin pages, this will run the policy on ALL linked projects at once. This will create one policy run result for each project, and may take some time.
If you want to run housekeeping for a single project, you can trigger the run from the project.

Viewing the Run

1. Navigate to the Housekeeping Report page (If you are a Jira admin, you can go to Issue Archiver > Policy Runs)

2. You will be able to see the status of all previous runs on the current project. (If viewing from the admin page, you will see all policy runs on all projects)

3. Each row describes the policy that was run, the run status, the project it ran on, and other useful information.

Run Statuses