I. Configure Your Novell GroupWise Environment

Step 1 - Create a Trusted Application on the Primary Domain

GroupWise uses a Trusted Application to allow an IMAP collector to access each GroupWise mailbox, in order to archive the messages.

Follow the steps below to create the trusted application, on the primary domain, of the GroupWise system.

    1. To download the Trusted Application Generation utility, tappgen.zip:
            * Login to the archive web UI, using a login which has the account owner (AO) or account administrator (AA) role.
            * From the Admin section of the web UI, click the Collectors tab.
            * Click the Configure GroupWise Post Offices button, on the right-hand side of the screen. 


       
            * Click Add New Trusted Application button, on the right-hand side of the screen.


            * Click the Download Trusted App Creation Utility link.
            * Download the file.



    2. Unzip tappgen.zip onto a Windows machine where to Novell client is installed. The zip contains three files - TappGen.exe, IRTAppGen.ini, and GWTapp.dll.

    3. From the Windows machine, login to Novell as an admin or admin equivalent.

    4. From the Windows machine, map a drive to the GroupWise primary domain directory, where wpdomain.db is located.

    5. Locate IRTAppGen.ini, one of the files extracted from tappgen.zip.

    6. Use a text editor, such as notepad, to modify IRTAppGenn.ini.
            * Edit the second line of the file, the "DomainPath=" line, to reflect the mapped or unc path to the primary domain directory, the directory which contains wpdomain.db.
            * For example, if the primary domain is g:\domain, the "DomainPath=" line should read: DomainPath=g:\primary.
            * A trailing backlash should not be used.


Optionally, the name of the trusted application can be changed, from the default name, by changing the value on the "TappName=" line of the file.

Caution: Editing lines in IRTAppGen.ini, other than the "DomainPath=" line and the "TappName=" line, may cause the trusted application not to work correctly. It is not necessary or beneficial to edit the TCPAddress, TCPPort, SSL or any other options in IRTAppGen.ini.

    7. While logged into Novell as admin or equivalent, run TappGen.exe (one of the files extracted from tappgen.zip). A message that the trusted application has been successfully created should appear after a few seconds. If there is a failure message, the most common reasons are an incorrect to the domain database in IRTAppGen.ini or not being logged into Novell with admin rights, from the Windows machine where TappGen.exe is run.

    8. After running TappGen.exe and receiving the message that the trusted application has been created successfully, open IRTAppGen.ini and check the last line. If the trusted application creation was successful, this line should read "KEY=[long string of characters]".

    9. Save IRTAppGen.ini. Later in the configuration process, when adding the trusted application to the archive web UI, it will be necessary to paste the values which IRTAppGen.ini contains, for "TappName=" and "key=", into the web UI.


Step 2 - Enable Message Retention

If a goal for archiving is compliance, to ensure that all email is archived and that messages cannot be deleted from mailboxes until those messages have been archived, it is necessary to enable message retention.

To enable message retention from ConsoleOne:

    1. Click the Tools menu | GroupWise System Operations | Trusted Applications.


    2. Select the archiving trusted application (SA2Archive or other name specified in IRTAppGen.ini when creating the trusted application) and click the Edit button.

    3. Check the box labelled "Provides Message Retention Service".

Caution: It is not necessary or beneficial to select any other options, to check the "Requires SSL" box or to enter a TCP/IP Address. Selecting these options may prevent the trusted application from working properly.

    4. Click OK to save the change.


    5. To enable retention at the GroupWise domain level, right-click the domain icon and select GroupWise Utilities | Client Options | Environment.


    6. On the retention tab, select the option to "Enable Message Retention Service". Click the Lock Icon at the right to lock this setting for all post offices and mailboxes on the domain. Click OK to save the change.
Repeat these steps for each GroupWise domain where retention should be enabled, so that mail cannot be deleted from mailboxes until it has been archived.

Note that it is also possible to enable retention on the post office level or the mailbox level, instead of on top of the domain level, if there are cases where some mailboxes should be able to delete mail which has not been archived.



Step 3 - Enable IMAP on One POA for Each Post Office

Post Office agent IMAP services need to be enabled, to support the archiving process, on each post office from which mail will be archived.

If there are multiple POA's loading for a single post office (one dedicated to indexing for example), it is only necessary to enable IMAP for one of those POA instances, for archiving purposes.

To enable IMAP for ConsoleOne:

    1. Go into the properties of each POA (Note that the properties of the post office do not have the option to enbale IMAP, but properties of the POA do).


    2. From the GroupWise tab, select network addresses.

    3. Enter a port number into the field beside the "IMAP:" label.


    4. Save the change.

Note: if there is more than one POA loaded per server make sure that the IMAP port number assigned to each POA is unique. If two or more POAs load with the same IMAP port, one or both of them will not function correctly.


II. Configure The Web UI For Collection From GroupWise


Before configuring the Archive Web UI for Collection from GroupWise

    * Open the firewall to allow an inbound IMAP connection from the archive service.
    * Prepare the Novell GroupWise environment for archiving by creating a trusted application, enabling IMAP on one POA from each post office, and enabling message retention if it is needed. (See the section I. above for information about these tasks).
    * Have available the trusted application name and key values. These values appear in the IRTAppGen.ini file which was used to create the trusted application.

Configuring the archive web UI from GroupWise consists of:

    1. Adding trusted applications.
    2. Adding post offices.
    3. Adding collectors.
    4. Customizing collection options.

How to add the trusted application to the Web UI

    1. Login to the archive web UI, using a login which has the role of the Account Owner (AO) or Account Administrator (AA).

    2. Click the Collectors tab.

    3. Click the Configure GroupWise Post Offices button, at the right of the screen.


    4. Click the Add New Trusted Application button, at the right of the screen


    5. Paste the name of the trusted application into the Name field.

    6. Paste the key value of the trusted application in the Key field. 

    7. The name and key values appear in the IRTAppGen.ini file which was used to create the trusted application.

    

    8. Click the Create button.


How to add Post Office to the web UI

    1. Login the web UI, using a login which has the role of AO or AA.

    2. Click the Collectors tab.

    3. Click the Configure GroupWise Post Offices button, at the right of the screen.

    4. Click the Add Post Office button, at the right of the screen.


    5. Enter the name of the Post Office into the Name field.

    6. Select the trusted application name in the Trusted app. Name drop-down.

    7. Enter the external IP address or DNS name of the post office into the IP/DNS field. Note that the IMAP connection will be made from outside the system, so an externally recognized IP or name is needed here.

    8. Enter the externally recognized IMAP port for the POA into the Port field.

    9. Check the Use SSL box if SSL is enabled for this IMAP port.

    10. Click the Test Config button to verify that an IMAP connection can be made from the archive service to this IP/DNS name and port. In order for this test to succeed:
            - the external IP/DNS and port information must be correct,
            - the firewall needs to allow the inbound IMAP connection from the archive system to this IP/DNS and port,
            - IMAP must be enabled on the POA,
            - and the trusted application must be valid.

    11. After the configuration test is successful, click the Create button to add the post office to the archive web UI.


    12. Repeat these steps for each additional post office from which email will be archived.


Two methods of adding collectors for GroupWise Mailboxes.

A separate collector is needed for each mailbox which will have its mail archived.

When all mailboxes on a post office will have mail archived, the Mailbox Synchronization option can be used to easily add all of the mailboxes at one time.

When only a few selected mailboxes on the post office will have email archived, a collector can be added for each of those mailboxes separately instead of using the Mailbox Synchronization option.


Ho to use Mailbox Synchronization to create collectors for all mailboxes on a Post Office

    1. Login to the archive web UI, using a login which has the role of AO or AA.

    2. Click the Collectors tab.

    3. Click the Configure GroupWise Post Offices button, at the right of the screen.

    4. Click the Manage Mailboxes button, to the right of the post office.


    5. Into the Domain name field at the top of the screen, enter your default internet domain without the "@". For example, if the typical email address for this system is user@company.com, enter company.com.


    6. Scroll down to the Mailbox Management section of the page.

    7. Check the boxes for Resources and/or Users to determine which types of mailboxes will have collectors added.

    8. At this time, the option to Run Synchronization Process Nightly should be unchecked.

    9. Click the button to Start Mailbox Collector Synchronization Process.


    10. The process will complete in seconds or minutes. When the process is complete, the number of mailboxes for which collectors have been added will be displayed at the top of the page.

Note that the option to Run Synchronization Process Nightly can be selected and saved in order to automatically check, each night, for mailboxes added to or removed from the GroupWise system, and to add and remove or inactivate collectors as needed.

The Mailbox Synchronization process can also be run manually from the Manage Mailboxes page, at any time, to check for mailboxes added or removed from the GroupWise system, and to add and remove or inactivate collectors as needed.


How to use the Manage Mailboxes screen to customize collection for a Post Office

    1. Login to the archive web UI, using a login which has the role of AO or AA.

    2. Click the Collectors tab.

    3. Click the Configure GroupWise Post Offices button, at the right of the screen.

    4. Click the Manage Mailboxes button, to the right of the post office.


    5. The value in the Max Message Size field specifies the largest sized message which will be archived.

    6. In the Options section, in most cases, Test Mode should not be selected. When collection is done based on mailbox retention date, using Test Mode will prevent the collector from updating the retention date of a mailbox at the end of a successful collection. This may result in the same messages being archived multiple times.

    7. The Inactive box should remain unchecked as long as mail should be collected from this post office. Check the Inactive box to prevent mail from being collected from the post office until the check is removed from the Inactive box.

    8. For most installations, where all mail from the mailbox should be archived, select the Use Current Mailbox Retention Date in the Collection Criteria section. Optionally, it is not necessary to archive all messages in each mailbox, which have not been archived previously, the option Collect data older than x days may be selected.


    9. In the Folders section, if all mail in the mailbox should be archived, select the option the Exclude and do not check the boxes to select any specific folders. This will result in mail being collected from all folders except the Work In Progress folder. If it is not necessary to archive all messages, which have not been archived previously, the folders options can be used to include or exclude specific folders from collection.


    10. After making the selections, scroll down to the Bulk Actions section of the page. Click the button to Update all collectors with the settings above. This will update the settings for all collectors, for the mailboxes in this post office, with the selections made in this page.



How to customize collection for individual GroupWise Mailboxes

Settings for maximum message size, Test Mode, Inactive, Collection Criteria and Folders can also be customized on a mailbox basis. This can be useful when some mailboxes need to be processed differently from others in the post office.

    1. To edit settings for an individual mailbox, go to Collectors tab and click the Edit button for an individual mailbox.


    2. Select the required settings.

    3. When finished, click the Save Changes button at the bottom of the page.



How to add a collector for a single GroupWise Mailbox

In cases where collectors should exist only for a minority of mailboxes on the post office, it may be easier to add each collector separately instead of using the Mailbox Synchronization option.

    1. Login to the archive web UI, using a login which has the role of AO or AA.

    2. Click the Collectors tab.

    3. Click the Add GroupWise Collector button, at the right of the screen.


    4. Select the post office which owns the mailbox from the Post Office drop-down.

    5. Enter the mailbox name into the Mailbox field.

    6. Into the Domain name field, enter your default internet domain without the "@". For example if the typical email address for this system is user@company.com, enter company.com.

    7. Configure Message Size, Options, Collection Criteria, and Folders as needed.

    8. Message Size defines the largest sized message which will be archived.

    9. In the Options section, in most cases, Test Mode should not be selected. When collection is done, based on mailbox retention date, using Test Mode will prevent the collector from updating the retention date of a mailbox at the end of a successful collection. This may result in the same messages being archived multiple times.

    10. The Inactive box should remain unchecked as long as mail should be collected from this mailbox. Check the Inactive box to prevent mail from being collected from the mailbox until the check is removed from the Inactive box.

    11. For most installations, where all mail from the mailbox should be archived, select the Use Current Mailbox Retention Date in the Collection Criteria section. It is not necessary to archive all messages in the mailbox, which have not been archived previously, the option Collect data older than x days may be selected instead.

    12. In the Folders section, if all mail in the mailbox should be archived, select the option the Exclude and do not check the boxes to select any specific folders. This will result in mail being collected from all folders except the Work In Progress folder. If it is not necessary to archive all messages in the mailbox, which have not been archived previously, the folders options can be used to include or exclude specific folders from collection.


    13. When finished making selections, click the Add Collector button at the bottom of the page.


Video - GroupWise Collectors