5.1 Modules and Job Overview

5.1.1 Overview

Archiving involves connecting Retain to your messaging system with a Module, setting up a schedule for when you want archives to happen, a profile that defines what should be archived, a worker agent needs to be installed, configured and connected to Retain, and finally a Job needs to be configured with all the previous components as well as who to archive.

To set up archiving, you need to configure:

Module: How to connect your messaging system.

Schedule: When the job runs.

Profile: What types of messages the job is to archive.

Worker: The Retain Worker can sit on the Retain server, the messaging server or another server, creating the worker bootstrap tells the Worker how to connect to Retain.

Job: Who to archive, what expiration date to create, what schedule, profile, and worker to use.

5.1.2 Modules

Modules are how Retain connects to a messaging system and jobs specify what Retain archives.

Modules are where you provide the data needed for Retain to connect to the messaging system. This includes the address of the messaging system server and credentials to enter the system, such that Retain can access all the mailboxes.

This is used by the Retain Worker to connect to the messaging system. It is the Retain Worker that does all the work of bringing the data into Retain.

Since the Worker Agent software can be installed on a server separate from the Retain server itself we need to provide it with a bootstrap so it knows how to connect tot he Retain server.

Multiple Modules

In Retain 4.2 and above, multiple modules of the same type can be enabled. This allows Retain to connect to multiple messaging systems of the same type at the same time that do not share common access. The modules can be given different names to make it easy to distinguish.

Multiple modules is enabled for GroupWise. Exchange, Google Apps (G Suite) and Mobile modules. It does not apply to the other modules.

You enter the Module name in the Module.

For example, the GroupWise4.214 module has a different domain and trusted application key compared to the GroupWise4.160 module.

5.1.3 Jobs

Jobs specify what is to be dredged or downloaded from the messaging system by specifying:

  • Schedule: When the dredge is to take place.

  • Profile: What will be dredged from the messaging system

  • Worker: Who will do the dredging.

  • Jobs: Which mailboxes will be dredged.

  • Expiration Date: When the incoming data can be removed from Retain (optional).

  • Mailboxes: Which mailboxes are to be archived.

Jobs with Multiple Modules

In Retain 4.2 and above, when you create a job with multiple modules you will have to select the module by name before creating the job.

You can select any existing jobs without having to preselect the specific module. If you do select a module, then only the associated jobs will be shown.