pdf_icon Download contentACCESS Manual as PDF

  1. Introduction to contentACCESS
    1. Services provided by contentACCESS
    2. Software requirements
  2. Installation of contentACCESS
  3. contentACCESS Tools
    1. Installing Virtual drive
    2. Installing the Proxy server (contentACCESSWS)
    3. Installing the Proxy web services
    4. Installing Outlook forms
    5. Legacy email archive connectors
    6. Legacy archive connector for Metalogix Archive Manager Exchange Edition (MAM EE)
    7. Legacy archive connector for Email Lifecycle Manager (ELM)
    8. Installing TECH-ARROW’s WinShortcutter
  4. contentACCESS Central Administration
    1. Central administration login
    2. contentACCESS Central Administration user interface
  5. Tenants in contentACCESS
    1. How to create a new tenant
    2. Tenant limitations
    3. How to provide access to a tenant (adding new tenant administrators)
    4. Tenant administrator invitation types
  6. General system configurations
    1. Connection
    2. User interface
    3. Users — role types, creating new users, adding user logins
    4. How to activate your license key
    5. How to create user logins to an already existing user?
    6. System administrators
    7. Login providers
    8. System
    9. Licensing
    10. Notifications
    11. Monitoring — how to find out possible misconfigurations / reasons of potential system/job failures
    12. Distributed environment in contentACCESS — Clusters
    13. Statistics
    14. How to create/configure databases — All databases
  7. Common features
    1. Databases
    2. Schedules
    3. Retentions
    4. Storages
    5. Exchange connections
    6. Importing contentACCESS configurations from files
  8. Creating new jobs in contentACCESS
  9. Jobs’ page, jobs’ context menu
  10. File Archive
    1. Introduction to File system archive
    2. File Archive settings
    3. File archive Databases
    4. File archive System settings
    5. File archive Retentions
    6. File archive Storages
    7. Root folders
    8. Aliases
    9. File archive Schedules
    10. Provisioning settings and managing access to contentWEB
    11. Configuring aliases
    12. Configuration of jobs available in contentACCESS File Archive
    13. Configuration of File system archive job
    14. Configuration of a File system restore job
    15. Configuration of File system recovery job
    16. Configuration of Remote shortcutting job
    17. Active/inactive documents in File system archive
  11. Email Archive
    1. Important settings before creating an Email Archive job
    2. Database settings
    3. Email archive System settings
    4. Provisioning settings
    5. Retention settings
    6. Shortcuts in email archiving
    7. Storing of archived emails
    8. Creating email archive schedulers
    9. User experience
    10. Exchange 2013: Mail app in OWA 2013 or on MS Outlook 2013 desktop version
    11. Exchange 2010: OWA 2010 integration
    12. Address book objects
    13. Granting access rights for mailbox users and explicit users to view the mailbox archive?
    14. Creating contentWEB users (option 1)
    15. Manage access to a mailbox archive (option 2)
    16. How the end user should log in to contentWEB (archive) over Internet?
    17. Database and store assignment in email archiving
    18. How to assign database and storage to an Exchange group?
    19. How to assign database and storage to a mailbox?
    20. How to move data from source database/storage into a second (target) database/storage?
    21. Creating Email archive jobs: archive, restore, recovery, mailbox move
    22. Email archive job
    23. Email restore job
    24. Email recovery job
    25. Mailbox move job
  12. Custom plugins
  13. Email management job configuration
  14. SharePoint archive plugin
  15. Storage replication plugin
  16. Sharing plugin
  17. Datengut plugin
  18. Email synchronizer plugin
  19. contentWEB
  20. officeGATE
  21. accessGATE Mobile
  22. Virtual drive
  23. Terms of use
  24. FAQ

11.22.Email archive job

This job type archives the configured mailbox items into the selected archive storage. The items which are archived with shortcuts or with the “Keep original” method will be accessible both from the mailbox folder and from the archive; items archived with the journal shortcut will be accessible in the archive only. Automatic email archive jobs are usually running out of working hours.

Note: The HTML shortcut which replaces the archived email also contains a link in .eml format, which is compatible with MAC OS, too.

cACCESS 2.9 doc 3



In this use case we will configure an email archive job, which will archive the mailbox items of mailbox “edit.balazsy@tech-arrow.com” that are older than 1 year but younger than 2 years. The archived items will be replaced with HTML shortcuts. The archive process will run each working day from 5 PM CET till midnight. By this processing type it is a must to configure the following sections on the job’s configuration page:

✓ Processing settings:
The administrator may select here, if he would like to use MAPI protocol to communicate with the Exchange server. EWS (Exchange Web Services) connection is selected by default, if MAPI is not selected here. It is important to know, that O365 Exchange server does not support MAPI connection. Another requirement to use MAPI is to have Exchange server 2013 or earlier version.
Since some other functions might still use EWS, the EWS connection must be configured in any cases.
With checking Split attachments option the attachment will be stored separately from the email body. By default this (recommended) option is always turned on.
On this use case we will use EWS and we will split the attachments, too.

cACCESS 2.9 doc 209

✓ Database settings:
For database settings select an already configured connection from the dropdown list, where the metadata will be stored. We have configured for our archived emails database “Email Archive DB”, so we set it here. (For further information how to set database connections please refer to section Databases.)

Documentation408

✓ Scheduling settings:
In this step the running time(s) of the Email archive job must be selected. It is possible either to select a scheduler from the list or to create a new scheduler via create new… option from the dropdown list. For an email archive job it is recommended to set a Week schedule with repeat, which will start the job running at the same time on every day. In our use case we set a scheduler which starts the archive job each day after the business hours (starts at 5 PM CET and ends at midnight). (For more information about how to set schedulers refer to the section Schedules above.)

Documentation410

✓ Storage settings:
For storage settings choose an already configured storage from the dropdown list. The processed binaries will be stored here. On the screenshot below we selected our already configured disk type store: “Email Archive store”). (For more information how to set storages check section Storages above.)

Documentation411

✓ Shortcut settings:
In the mailbox the archived emails will be replaced with the shortcuts that is set here. You will be able to select from the shortcuts that you have previously configured in section Shortcut configuration above. If the mailbox items have not been archived yet (are archived for the 1st time), check the “Apply to NOT ARCHIVED items” checkbox. It is recommended to use HTML shortcut for emails/attachments that are 1 to 2 years old, so we select the “HTML_emails in age 1-2 years” shortcut here.

Documentation Email archive change 1

Note: If the items are already archived (e.g. with the “Keep original” method), but they need to be replaced with shortcuts, check the second checkbox and specify a shortcut that should be used. It should be mentioned, that these 2 processes will always run in 2 stages (even if both processes are configured within one job). By the 1st job running the  items will be archived, by the 2nd job running the (archived) items wil be replaced with the selected shortcuts.



You can also set the age and size of the emails to be archived. For Age filter and Size filter settings click on the corresponding “Change” button and set the age of the emails that should be archived and the size of the items to be archived. It is important to keep in mind that the sent date of the emails is the determinative date in case of the age filtering. In this use case we will process all emails regardless of the file size, so we set the value to “0”.

Documentation Email archive change 2 Documentation Email archive change 3

Note: Shortcutting methods can be also combined when configuring an Email Archive job. For more information refer to section “Combining the shortcutting methods”.



✓ Retention settings:
Under Retention settings choose an already configured retention time from the dropdown list. The archived emails will be stored during this time in the storage, and it will be impossible to delete them from there. It is highly recommended to select a retention time which is required by the law of your country. (For more information how to set retentions check section Retentions above.)

Documentation413

✓ Address book objects to process:
Here the administrator may select the mailboxes, groups or the entire Exchange server which will be processed by the archive job. Click on the Documentation340.1select option and check the desired groups or servers in the Mailbox selection window, then click on OK. In this use case we will archive mailbox “edit.balazsy@tech-arrow.com”, so we select it from the list:

Documentation414 Documentation415

✓ Include folders:
Email archive job is crawling the entire mailbox or recursive folder structures from the mailbox for further processing. Before you enter the folder name(s) to be crawled, it is necessary to select the folder filtering type.

cACCESS 2.9 doc 210

If you set Entire mailbox, then the whole mailbox including all folders will be processed. If you set One single folder type, then only one pre-selected folder will be processed (e.g. if you set %INBOX%\Subfolder1, then only Subfolder1 will be processed). If you set Recursive, starting from a single folder filtering type, then all folders starting from the defined folder will be processed (e.g. if you set %INBOX%\Subfolder1, then starting from Subfolder1 every subfolder will be processed in the structure). The same rule applies to the Multiple folders, and to the Multiple recursive, starting from a single folder, too, but in this case we can work with more folders simultaneously (e.g.: %INBOX%, %OUTBOX%\Folder name 5…or…%TASKS%, %CALENDARS%\Folder name 6).

Important: It is highly recommended to specify the root mailbox folders using wildcards (%). Wildcards ensure, that the given mailbox folder (e.g. the “INBOX” folder) will be processed regardless of the language settings of the mailbox. This is important mainly for companies who archive mailboxes using different languages. Subfolders must be added to a root folder with a backslash (\).


It is important to bear in mind, that with selecting “Recursive, starting from a single folder” filtering type under “Include folders” section, and leaving the folder path textbox empty the whole selected mailbox will be archived:
cACCESS 2.9 doc 211



In our use case we select the whole “INBOX” to archive:

Documentation418

✓ Exclude folders:
With this function you may set, which folders/subfolders should not be archived. If you would not like to exclude any folder from the archive process, you can skip these settings.

The folders may be excluded using one of the available methods: a) They may be added manually via the + new option; b) they may be imported in one of the available file formats via the import option.

Important: Due to different language settings in the user mailboxes, it is highly recommended to specify the root folders using wildcards (%). Subfolders must be added to a root folder with a backslash ().

cACCESS 2.9 doc 212

  1. Add exclude folders manually:
    Click on + new option. In the Exclude folder dialog’s textbox specify the folder(s) to be excluded. Use the hints that are featured in the same dialog. %INBOX%\TECH-ARROW pattern on the picture below means that “TECH-ARROW” folder on the “INBOX” root folder will be excluded.

    cACCESS 2.9 doc 213

    Test pattern button
    This button was developed to check, if the entered pattern will be suitable for the path that the user would like to exclude from the archiving process. With clicking on the Test pattern button, open the Test pattern matching window. Enter the folder path into the Folder path field (this time without the % sign), and click on Test button.

    The test will be successful, if the Pattern was entered correctly into the Exclude folder window.

    cACCESS 2.9 doc 214
  2. Import the list of exclude folders:
    Exclude folders may be imported from files in one of the available formats: CSV, XML, Tab delimited files or Space delimited file. The file to be imported must contain the list of exclude folders.
    Important: Root folders must be specified in wildcards (%) in the import files. Subfolders must be added to a root folder with a backslash (\). To import such a file with the list of folders refer to chapter Importing contentACCESS configurations from files
    Edit
    of this guide.

✓ Item filtering
This configuration enables filtering among your items by their message class. Using this filter the user will be allowed to select different document types, such as mails, documents, contacts etc. to archive.

Note: The message classes excluded in the Email archive System settings take always priority over the Item filtering settings defined in the archive job.


Important: In case of custom Exchange solution(s) used for emails the custom email properties will not be archived! The recommended solution: do not archive these emails and/or use the exclude feature (in Email archive System settings) for these custom message classes.



To set message class filters in the archive job activate the Message class filter button by checking the checkbox next to it, then click on the active button.

Documentation Email archive change 4

In the Message class filter dialog it is possible to choose if the filter will be applied for all message classes (choose radio button Apply for all message classes) or only for many selected classes (Apply for selected message classes). It is also allowed to add Custom message classes to the already existing ones. In this use case we will archive emails and documents only:

Documentation Email archive change 5

✓ Exclude addresses
With the “Exclude addresses” feature you may exclude certain

  • user mailboxes (e.g. john.arrow@tech-arrow.com) or
  • domains (e.g. @microsoft.com) from the list of archivable messages.
  • The filtering option is configurable and it filters emails based on

  • recipient(s),
  • sender(s) or
  • both (recipients and sender).

The list of ojects to be excluded may be

  1. Added to contentACCESS manually using the +new option;

    cACCESS 2.9 doc 215

    Click on +new to open the Exclude address dialog. Enter the object to be excluded, and select the Exclude type (Sender, Recipient, All) to be applied.

    cACCESS 2.9 doc 216
  2. Imported into contentACCESS from a file using the import option.

    cACCESS 2.9 doc 217

    The file to import usually contains 2 columns: first column with the email addresses (or domains), 2nd column with the information if the object is sender, recipient or can be both. A sample import file may be viewed using the “Download sample” button. (For more information refer to chapter Importing contentACCESS configurations from files.)

    cACCESS 2.9 doc 218

✓ Notification settings.
Select here, when you will need to get notification emails from the Email archive job. It is possible to set here, if you need such a notification email always/never, or, you need it only in case when an error/warning occurred during the archiving process − for example, if the archive of one or more items failed, then you may get a notification email about this error. Into the Recipient list textbox insert the email address(es) of the person(s), who will get such notifications. Notifications should be used if the administrator does not use the monitoring feature.

Documentation432

✓ Resource settings.
Set the value, which will determine how many items will be processed simultaneously by the email archive job. The recommended value is “2”.

Documentation433

✓ Save your changes!

Combining the shortcutting methods in an Email archive job
What are the advantages of combining the shortcutting methods for the user?
Companies use the “Keep original” archiving method on a daily base. This archive method ensures, that the emails and its attachments are ready at hand during the time when they are still in use. After certain time period (usually after 6 months) it is redundant to keep these emails in the mailbox(es), as they take up too much space. However, these emails must be still easily accessible at any time. From this reason, it is recommended to replace them with shortcuts, which save space in the mailboxes but guarantee easy access to the older mailbox items. With combining the shortcut methods the end user will easily achieve the demanded result.

This use case will demonstrate how to configure an Email Archiving job, which will archive the items older than 10 days, while keeping them in the original file location. The job will also replace these items with shortcuts after 6 months. The job combines the “Keep original” archiving method with the shortcutting after the item reaches a certain age (6 months in this use case). The size of the items to be archived and shortcutted can be set as well.

Note: If two archive processes are combined (as in this use case), then the archive process will run in two stages, too. By the first job running the emails will be archived while keeping the original, by the 2nd job running these items will be replaced with shortcuts.

The following steps should be executed to set up an email archive job using the advantages of this method:

✓ Set up a new Email Archiving job and open its configuration page.
✓ Set all required sections on the job’s configuration page.
On the configuration page of the Email Archiving job navigate to the “Shortcutting” section, and check the “Apply to NOT ARCHIVED items” checkbox.

cACCESS 2.9 doc 219

✓ Set the “Keep original” archive method for items which are older than 10 days. Choose the “Keep original” option from the dropdown menu and set that all items older than 10 days will be archived.

cACCESS 2.9 doc 220

✓ Apply the shortcutting to the items archived with the “Keep original” method, which are older than 6 months and larger than 100 kB. Choose HTML shortcut type, which will be used by the job.
Check the “Apply to ALREADY ARCHIVED items with keep original shortcutting method” checkbox. Choose the already configured “HTML” shortcut from the dropdown list. Set the sent date to 6 months and the size to “larger than 100 kB”.

cACCESS 2.9 doc 221

Note: Please keep in mind that the sent date of the email is the determinative date. The age and size of the emails to be archived/shortcutted can be modified anytime by using the “Change” buttons.

cACCESS 2.9 doc 222


USE CASE: How to set up the shortcutting if all items should be archived and items under 100 kB should be kept in the original location, while items over 100 kB should be replaced with shortcuts? In this use case set the size filter in the 2nd!!!! row only (refer to screenshot above) to >100 kB and do not set a size filter in the 1st row.

cACCESS 2.9 doc 223


✓ Save your settings and wait until the job starts to run according to the configured scheduler.

Yes No Suggest edit
Help Guide Powered by Documentor
Suggest Edit