Netmail Archive 5.x
Situations may arise where archived messages or attachments written to Netmail Store needs to be reviewed or located while troubleshooting. Netmail Store uses hash values to identify the location of stored content and messages are accessed via HTTP using hash values rather than traditional file system locations. This article will explain how to retrieve and view content from a Netmail Store repository.
As part of the Netmail platform, Netmail Store can be deployed in conjunction with Netmail Archive as a primary or secondary storage repository for static archived data, such as email messages and attachments (but not for dynamic content such as audit files). Netmail Archive communicates with Netmail Store via HTTP. The Netmail Archive server establishes an HTTP connection with the Netmail Store cluster and sends files to the cluster to be stored. In response to receiving these files, Netmail Store sends a hashed Content Address (CA) to Netmail Archive. The CA is an identifier that will allow Netmail Store to later retrieve the file. The Netmail Archive server stores the CA in the archive audit files, and the Index Server indexes this information.
To access messages and attachments in Netmail Store for troubleshooting purposes, there are two ways to obtain the CA hash value:
1) From an attachment’s attributes: if the archived message contains a problem attachment, e.g., an attachment that appears blank when accessed through Netmail Search, you may wish to open the attachment directly from the Netmail Store repository to confirm whether it is accessible. The hash value can be obtained from the Netmail Search message properties as follows:
• Open the archived message in Netmail Search and click the ‘Properties’ tab to find the message path or ID
• Scroll down to the Attachments folder icon and expand it
• Locate the attachment of interest and expand its folder. The CA and hash values will be listed:
• Once the hash value is obtained, the attachment can be accessed and viewed directly from its Netmail Store storage location. To do this, copy the hash value into a browser, preceded by the IP address of the Netmail Store Cluster. For example:
The attachment will be returned (if it is accessible) and in this way, it can be directly opened from the Netmail Store Repository using the CA value.
2) From the Audit files: if the problem is not related to viewing an attachment but with finding or viewing a message itself in Netmail Search, you can view the message directly from Netmail Store once you find its hash value. The hash value, in turn, can be obtained from the audit folder once you obtain the messageID: message ID for these messages can be obtained from a job’s error report that may be downloaded by accessing the job’s Report tab in the Netmail Archive WebAdmin console:
Once you download the error report, the messageID can be obtained from the file and subsequently used to obtain the message’s hash value from the corresponding accounts audit folder. For example, if the message ID of interest is 6fd9839d.netmail.montreal.100.18a337a.1.31f02.1 (listed in the ‘messageID’ column of an error report), this string can be used to get the hash value from the audit folder. Once the message’s CA hash value is obtained from the audit folder, it is possible to determine if the message can be opened directly from the Netmail Store repository. The CA hash value is obtained from the audit files as follows:
• Navigate to the data repository > audit folder > accounts > user account name >adt folder
• Once in the account's adt folder, select the mail folder of interest and use the messageID to search for and open the XML message file.
• Once the XML file is open, find the hash between the ca tags, i.e., <ca> hash value /<ca> and copy the string into a browser, preceded by the IP address of the Netmail Store Cluster IP. For example:
Once this information is entered in the browser, you should be able to access and view the archived message, and so determine if there are any issues accessing the message itself and/or any associated attachments.