3.12 Deleting Data

3.12.1 Deleting Mailboxes

Mailbox Deletion will delete one or more entire mailboxes from Retain.

If you are trying to clean up mailboxes for your license report, run mailbox deletion on the target users. All messages are deleted, except those flagged with a litigation hold.

Deleting Users

The primary action is to press the Add User button to select users to be deleted from Retain.

Core Settings—Data Deletion

Core Settings allows you to choose between Generate a report but don't delete message and Delete messages as they are processed when processing the job.

Data Deletion Notifications

To be notify about errors and/or when the job is complete, fill out this tab. By default it is filled in with the notification data from Server configuration.

Press the Run Job Now button to begin the process.

3.12.2 Deleting Items

When items pass out of their retention period it is time to remove them from the system.

An item deletion job is set up much like an archive job with a schedule, profile and job, but there is no need for a worker because Retain can connect to itself just fine.

Scheduling Item Deletion

There are three types of schedules:

  • Single, the job will run only once at the assigned date and time

  • Recurring Weekly, the job will run each week on the assigned day and time

  • Recurring Monthly, the job will run each month on the assigned day and time

Creating an Item Deletion Profile

The profile sets the type and age of the items to be deleted.

Basic Options Tab

Sets the limits on the Type, Source and Status of the items to be deleted

Item Types include: Mail, Appointment, Note, Task, Voice Message, Message, Phone call, BB PIN, and BBM Messages.

Item Sources include: Received, sent, draft and personal.

Message Status can include Read, private or personal, depending on Doesn't matter, True or False.

Date Scope Tab

Items can be deleted based on the following:

  • Date Stored in Retain: This date is set by Retain. This is when your Retain server copied the message to the Retain archive. This is a good time to use if Retain has archiving for at least as long as your organization’s retention period and is a trusted source.

  • Delivered Date: This date is set by the recipient mail server. This is when your organization’s mail server received the message. This is considered the most accurate date as your email server sets this time and is a trusted source.

  • Expiration Date:This date is set by your Retain server and is based on when the message is stored in Retain. Configure this in the Job | Core Settings tab. This date will be set in the future.

  • Created Date:This date is set by the sending mail client. This date is set by an untrusted source. This is considered the least desirable date to use as spammers often set the date to the far future to keep their messages at the top of the list of the recipient’s mail client.

And if the items are older than a specified number of Days, Months or Years or between two specific dates.

Creating Item Deletion Jobs

Creating a deletion job is just like creating an archive job select a schedule and profile to prepare the job.

Core Settings Tab

A job can be enabled or disabled.

Core Settings allows you to choose between Generate a report but don't delete message or Delete messages as they are processed when processing the job.

A Schedule and a Profile must be chosen.

Selecting Mailboxes for Data Deletion

Select the objects to be included for the deletion job.

  • Journaling Mailboxes may be excluded.

  • An entire mail server or post office can be included.

  • Individual users may be included or excluded.

Notification Tab

To be notify about errors and/or when the job is complete, fill out this tab. By default it is filled in with the notification data from Server configuration.

If tomcat crashes during a deletion job, then the job will continue when the tomcat is restarted.

If there is an issue and the server goes down during a job, then the job will need to be rerun.

3.12.3 Deleting Individual Messages

Individual Messages can be deleted by the admin or a user given sufficient rights. Deletion actions will be logged in the RetainServer log.

Within the users mailbox one or more messages can be deleted by selecting with the checkbox and pressing the Delete button.

3.12.4 Deletion Report and Logging

The resulting report CSV file will be placed in the archive directory. For large deletion jobs, the report file will be split into CSV files of up to 500,000 line each. The mailbox will be labeled by the user's first, last and display names with a list of items removed.

The job will be logged in the RetainServer log.