Administration Manual

Debug Option

Debug options are used by HP suppor t to help diagnose prob lems that might occur during message

archiving.

• The Archive

tab enables debugging for the Archive agent.

• The Tombstone tab enables debugging for the Tombstone agent.

• The Field Remapper tab enables debugging for message headers.

• The Body Par

ser tab enables debugging for the unique message I D (hash).

Under normal operation all debug options should be disabled, as certain options write additional entries

to the Domino log database (log.nsf) for each message processed. Ensure that all options on the

Debug tabs are set to No unless you are asked by HP support to enable an option.

Preprocessing messages

Several types of messages must be preprocessed so they can be archived in a format that preserves all

message data intact:

• Lotus Notes PKI and S/MIME signed and encrypted messages

• Journaled items such as calendar notices, tasks or other messages that are not Memo, Reply

• Messages with ATT attachments

See “Message attachments na med ATTxxxxx ” on page 131 for a description of these messages.

During prep rocessing, a copy of the message is encapsulated—encased in a encapsulation database

that is attached to the original message. The message and attachment are then routed to the IAP.

“Preprocessing and reference databases” on page 35 describes what can be viewed in the preprocessing

database as the message is being processed.

When encapsulated messages are retrieved in Lotus Notes or DWA, or are exported from the IAP using

the Web Interface, they can be opened just like any other message. However, if users send copies of

encapsulated messages from the IAP Web Interface to their mailbox (Mail-To-Me messages), the message

is still inside the encapsulation database. “Op ening encapsulated messages” on page 124 explains

how to open these messages.

There is a significant storage penalty on the IAP for encapsulating messages because of the extra

processing involved. The size of an encapsulated message store d on the IA P is approximately 8 KB.

Preprocessing and reference databases

Three EAs Domino preprocessing databases are installed in the hprim folder on message processing

servers. An Encapsulate a gent in these databases performs message encapsulation.

Each preprocessing database is paire d with a corresponding reference database, which contains

temporar y pointers to the messages that have been flagged for archiving. The Archive and Tombstone

agents in each reference database create and remove these pointers as needed. After a mining job is run,

you can open a reference database to view a log of the message references that are being processed. The

reference database also contains tools to troubles hoot encapsulation pro b lem s; these tools should only be

ed under the direction of HP s uppor t. See “Viewing references” on page 40 for more information.

You can view the encapsulated messages as they are being processed in the preprocessing databases:

• For signed messages, ATT file attachments, and calendar notices you can view the messages,

including header, body and all a t tachments, in their original format (RTF or HTML/MIME).

• F

or encrypted messages, you can view the headers but cannot view the message body.

• Encapsulated messages are 84 KB when they are routed to the IA P. That size is reduced to 8

KB when they are stored on the IAP.

HP Email Archiving software for IBM Lotus Domino Version 2.0