Quest® Archive Manager

Maintenance Release Version 4.1.2

Build 4.1.2.434

Release Notes

March 2010

Doc ID 075

Welcome to Archive Manager
New in this Release
New Configuration Settings
Resolved Issues and Enhancements
Known Issues
Third Party Known Issues
System Requirements
Additional Notes
Global Operations
Getting Started
• Contents of the Distribution Zip File
• Installing Archive Manager
• Upgrading from an Earlier Version of Archive Manager
For More Information

Welcome to Archive Manager

Quest® Archive Manager is an archiving and management solution that enables email and file data to become a true asset for the organization by capturing, indexing, and storing it for mailbox management, compliance, and knowledge sharing.

New in this Release

These Release Notes document the Archive Manager 4.1.2 Maintenance Release, and are intended as an addendum to the Archive Manager 4.1 Release Notes and product documentation, and the 4.1.1 Maintenance Release Notes. The Archive Manager 4.1.2 Maintenance Release includes the following:

Exchange Store Manager (ESM)

This release provides the following enhancements to the Exchange Store Manager (ESM):

The ESM has been enhanced so that it no longer checks for journal attributes unless it is processing a Journal mailbox.
Date filters applied by the ESM have been adjusted to enable Stub and Delete policies to identify messages that were not processed on previous runs.
The ESM can now export messages with an embedded message attachment that legitimately has null content.

XML files that were moved to the Error folder due to this issue must be moved back to the Export folder to be reprocessed.

The ESM has been modified to handle an Exchange limitation that made it unable to fetch the properties of certain "soft-deleted" items. The ESM recognizes that the message cannot be exported, reports the error once and does not continue to retry the message. These soft-deleted messages cannot be archived or retained by Archive Manager for future processing. Note that they may have been successfully archived before being soft-deleted.
The ESM has been modified so it can now detect and repair message stubs created in Archive Manager version 4.1.1.436. It repairs broken stubs in each folder once. The ESM keeps track of which folders it has processed for broken stubs using a new column labeled State in the Folder table. A value of NULL or 0 means that broken stubs in that folder have not been repaired yet. A value of 1 means that broken stubs in that folder have been repaired.

Full Text Index Service

This release provides the following enhancements to the Full Text Index Service (FTI):

Upgrades the Lucene.Net.dll to 2.3.2.1.
Adds new functionality to repair the Full Text Index if it becomes corrupted. See the Additional Notes section for an explanation of the repairindex command line option.
Updates the backup and optimize commands to stop and restart the Search Service and Index Service when those commands are run. See the Additional Notes section for additional information on the backup command line option.
Adds the new configuration setting: Full Text Index Max Field Length. See the New Configuration Settings section below for a description.

GroupWise Store Manager (GSM)

This release provides the following enchancements to the GroupWise Store Manager (GSM):

The GSM has improved support for delayed exporting of message data.
The GSM has been modified to track and retry messages that were not successfully processed using the FailedMessage table in the Archive Manager database.
Some configuration settings have new default values. See the New Configuration Settings section below for a description.

PST Import Wizard

The PST Import Wizard now supports a mode that allows .pst files to be processed without an Exchange server and Active Directory.

New Configuration Settings

Full Text Index Service

Full Text Index Max Field Length: This setting can be used to increase or decrease the field length from the default of 100,000 for indexed terms in a single document.

GroupWise Store Manager (GSM)

The following configuration settings have new default values:

GroupWise Store Manager No Folders Prescan: This setting is always treated as False because a prescan is now required.
GroupWise Store Manager No Message Stamping: This setting now defaults to True.

Resolved Issues and Enhancements

The following is a list of issues addressed and enhancements implemented in this release of Archive Manager.

Bridgehead

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST73106	The FTIAttachment worker gets a NullReferenceException with Bridgehead.

BlackBerry Enterprise Server (BES)

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST72506	Attachments were not retrieved from the BlackBerry server when Exchange returned the MessageClass string as ANSI rather than Unicode. As a result, Archive Retrieve could not restore the original attachment data when these messages were stubbed.

Database

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST70727	Two SQL jobs — Assign Security to New Messages and Assign Security to All Messages — run slowly and generate errors, and these jobs also generate duplicate-key errors, for example: Server: Msg 2627, Level 14, State 1, Procedure PopulateMailBoxMessage, Line 91 Violation of PRIMARY KEY constraint 'PK_MailBoxMessage'. Cannot insert duplicate key in object 'MailBoxMessage'. The statement has been terminated.
Archive Manager	4.1	ST70769	The SQL jobs Assign Security to New Messages and Assign Security to All Messages fail to start on SQL 2000, because their stored procedures PopulateMailBoxMessageNew and PopulateMailBoxMessageAll are incompatible with SQL 2000. (The procedures call a table, sys.dm_db_file_space_usage, that does not exist in SQL 2000.)

Data Loader

Product Name

Product Version

Defect ID

Problem Description

Archive Manager

4.1

ST71357

The Data Loader is unable to load XML files exported by Archive Manager 4.1.0 and earlier versions that contain embedded Contact items.

Archive Manager

4.1

ST70486

Code enhancements to application checksumming inadvertently introduce errors in processing .xml attachment files:

An application exception that occurs when an attachment has a type of message/rfc822, but is not an embedded message.
An application exception that occurs when a recipient has no DisplayName.
A checksum validation error.

Exchange Store Manager (ESM)

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST72340	The ESM is unable to process mail message in user mailboxes if they were tagged with a property that is normally used by the Exchange 2007 Server to identify envelope journal reports.
Archive Manager	4.1	ST70586	The ESM is sometimes unable to identify messages that were eligible for exporting, stubbing, and/or deletion.
Archive Manager	4.1	ST69372	The ESM is unable to export calendar items that have attached messages with null content.
Archive Manager	4.1	ST55884	A known issue in Exchange makes the ESM unable to fetch the properties of certain "soft-deleted" items.
Archive Manager	4.1	ST69428	The ESM is unable to process messages with large numbers of attachments that have been stubbed and reconstructed and exceed the Archive Manager @Attachments property limit of 8k.
Archive Manager	4.1	ST71216	The Journal Dataloader's ESM worker crashes when it encounters a MIME journal report that is malformed instead of logging an error, bypassing the malformed report, and completing the process run.
Archive Manager	4.1	ST72525	The ESM may calculate incorrect checksums for messages if they had internet headers with no distinguishing fields, (i.e, From, To, CC, Subject and Date), and a message with no distinguishing fields already exists in the database with an earlier checksum algorithm (pre 4.1.1).
Archive Manager	4.1	ST71163	The Journal Data Loader mistakes valid TNEF for invalid in some envelope journal reports with MIME (.eml) attachments that contained TNEF (winmail.dat), causing it to crash.
Archive Manager	4.1	ST74433	When a message is stubbed, and the message has an embedded message that was archived with a pre-4.1.1 checksum, the ESM sets the @CheckSum property of the embedded message to the 4.1.1 checksum instead of the correct, pre-4.1.1 checksum. The 4.1.1 checksum is not in the database, so the Outlook form cannot reconstruct the embedded message and the stubs are broken.
Archive Manager	4.1	ST74527	When messages that were archived with a pre-4.1.1 checksum are stubbed using Archive Manager version 4.1.1.436, they are incorrectly stamped and need to be reprocessed via the ESM to be automatically repaired.
Archive Manager	4.1	ST70405	A Tnefreadser.dll bug was discovered involving .eml processing errors.

Exchange Utility

Several of the Exchange Utility issues listed below were resolved by improvements to Exchange Store Manager processing. For all of the issues listed to be completely resolved, you will need to let the Exchange Store Manager complete one full pass through all user mailboxes in Exchange.

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST73110	Enhancement Request: Give the Exchange Utility new functionality that will crawl Exchange mailboxes looking for all stubs and then verify that there is a corresponding record in the Archive Manager database.
Archive Manager	4.1	ST71354	The Restamp Stub operation of the Exchange Utility is too slow.
Archive Manager	4.1	ST67427	The Exchange Utility doesn't find and reconstruct all stubbed messages in a mailbox.
Archive Manager	4.1	ST66650	There are exceptions in the Archive Manager Event Log at reconstruction of messages with several attachments by Exchange Utility.
Archive Manager	4.1	ST74692	The Exchange Utility can't restamp stubs with large internet headers.
Archive Manager	4.1	ST66847	Sometimes after the Exchange Utility reconstructs messages, a message may remain stubbed.

Full Text Index Service (FTI)

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST80878	When the Archive Full Text Index Service process memory usage reaches the threshold value set by the Full Text Index Service Max Memory configuration file parameter, the service process is terminated abnormally. The indexing threads that are running when the process is terminated do not close the Lucene index properly, which can lead to a corrupted index.
Archive Manager	4.1	ST80847	Using the -optimize command to optimize the Full Text Index can cause index loss or corruption if the optimize operation fails.
Archive Manager	4.1	ST75048	The Full Text Index Service fails to index some.docx files due to a problem with the IFilter that caused a timeout to occur.
Archive Manager	4.1	ST73926	AttachmentFileIDs that have been retention deleted are not being removed from the AttachmentToIndex table.
Archive Manager	4.1	ST74992	Attachments with more than 10,000 search terms are not being loaded into the index.
Archive Manager	4.1	ST70931	Insufficient memory error when optimizing the full text index (-optimize).
Archive Manager	4.1	ST76229	When a write.lock file is present in the Index message folder, restarting the FTI does not remove the lock and the write.lock file is left behind. This results in FTI errors.
Archive Manager	4.1	ST75747	The Full Text Index Service process that monitors FTIAttachmentWorker threads receives an exception that causes the FTIAttachmentworker to end abruptly.
Archive Manager	4.1	ST75539	A write.lock file is abandoned by the FTIAttachmentWorker and generates an unexpected failure.

GroupWise Store Manager (GSM)

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST71461	The GSM filters by the Modified Time date field when scanning mailboxes with a message policy that specifies an export delay. This could cause some messages that were eligible for archiving not to be archived.
Archive Manager	4.1		The GSM sets the LastRetentionDate property on the GroupWise account, even if some messages were not successfully processed.
Archive Manager	4.1		The GSM does not retry processing messages that were not sucessfully processed the first time.

PST Import Wizard

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST64939	The PST Import Wizard no longer works without Exchange.
Archive Manager	4.1	ST72560	The PST Import Wizard does not accommodate a hierarchical domain structure in Groupwise environments.

Search Exporter

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST70063	The Search Exporter fails to export a message with an HTML message body that contains unblocked externally referenced images. The Search Exporter application log reports a "Failed to retrieve message" error.
Archive Manager	4.1	ST73893	When exporting searches with multiple instances of the Search Exporter against the same web server/web services, some attachments are mismatched. (The actual files are different than the filename/message indicates.) Archive Manager does require that concurrent exports are done from separate workstations.

Website

Product Name	Product Version	Defect ID	Problem Description
Archive Manager	4.1	ST67863	When a user is not given the Add/Edit Custom Mailbox security role on the Archive Manager Website and then performs a search that returns multiple pages of results, errors occur with the Context menu when navigating through pages of search results.
Archive Manager	4.1	ST64877	When a user is not given the Add/Edit Custom Mailbox security role on the Archive Manager Website and then performs a search that returns multiple pages of results, an error may be generated when you navigate through the search results pages multiple times. This typically occurs after navigating through 5 pages.
Archive Manager	4.1	ST70765	Messages containing the <?xml> tag appeared with blank bodies in the Archive Manager Website.

Known Issues

The following issues are known to exist in this release of Archive Manager:

Upgrade Process

The upgrade process does not recognize prior installations of the PST Import Wizard and Search Exporter components of Archive Manager. You must manually uninstall these components before performing an upgrade..

PST Import Wizard

The PST Import Wizard does not support importing .pst files into Archive Manager mailboxes in a GroupWise environment where the owner’s username is not unique because another user exists in the same domain, with the same username, but in a different context. For example, in the following domain structure, Archive Manager will not be able to determine the correct mailbox:

Company/Department/Europe/JSmith
Company/Department/US/JSmith
Company/ExternalUsers/US/JSmith

Third Party Known Issues

The following is a list of third party issues known to exist at the time of this release.

Adobe IFilters

Feature	Issue	Defect ID
Adobe iFilters versions 6-8	Some PDF files cannot be indexed due to an issue with the Adobe iFilters, versions 6-8.	ST76473

The Full Text Index (FTI) reports IFilter errors because some PDF and/or XPS files cannot be indexed.

Errors associated with XPS files: These errors are typically caused by a missing XPS file viewer. Microsoft offers this one as a free download (link was current as of release date).

Errors associated with PDF files: PDF indexing errors sometimes occur when using Adobe IFilters versions 6-8 with recently enhanced FTI/FTS versions. These errors can usually be eliminated by either of these two remedies (cited download links are current as of the release date):

Replace an earlier version of Adobe's IFilter with version 9:
1. Stop the Archive Manager Full Text Index Service.
2. Uninstall any Adobe iFilter version 6-8.
3. Download and install Adobe's Acrobat Reader 9.0.
4. Restart the Full Text Index Service.
Replace the Adobe IFilter with a PDF IFilter from FoxIT:
1. Stop the Archive Manager Full Text Index Service.
2. Remove any instances of Adobe Acrobat Reader and any Adobe iFilters versions 6-8.
3. Download and install the FoxIT PDF iFilter.
4. Restart the Full Text Index Service.

Quest recommends that you make sure that Windows 2003 Service Pack 2 is running. This process will install newer versions of the native Office IFilters. It is also recommended that you download and install the 2007 Office System Converter: Microsoft Filter Pack.

BlackBerry

Feature	Issue	Defect ID
Archive Retrieve	Due to an issue with BlackBerry, BlackBerry users cannot view embedded items using Archive Retrieve.	ST69749

The workaround to this problem is to send attachments rather than embedded objects.

Additional Notes

The repairindex Command

To run the repairindex command to repair the Full Text Index if it becomes corrupted, complete the following steps.

At a command prompt, go to the directory where the Archive Manager executables are installed. This is typically ...\Program Files\Quest Software\ArchiveManager for a clean installation, or ....\Program Files\ArchiveManager for an upgrade.
Run the following command: "Archive Full Text Index Service.exe" -repairindex
To skip repairing the attachment index and repair only the message index, run the following command: "Archive Full Text Index Service.exe" -repairindex -skipatt
To skip repairing the message index and repair only the attachment index, run the following command: "Archive Full Text Index Service.exe" -repairindex -skipmsg

The backup Command

To create a backup of the Full Text Index, complete the following steps.

At a command prompt, go to the directory where the Archive Manager executables are installed. This is typically ...\Program Files\Quest Software\ArchiveManager for a clean installation, or ....\Program Files\ArchiveManager for an upgrade.
Run the following command: "Archive Full Text Index Service.exe" -backup c:\backup_location

System Requirements

In addition to the System Requirements specified in the Archive Manager manuals for version 4.1, the Release Notes for version 4.1, and the Release Notes for version 4.1.1, this 4.1.2 maintenance release requires:

Software Requirements

Prerequisites for servers running Archive Manager Services	Microsoft Visual C++ 2008 SP1 Runtime (VCRedist 2008 SP1): vcredist_x86.exe. (The SP1 patch is now required for the 4.1.2 maintenance release.)
Archive Retrieve (Archive Manager Download Tool)	Microsoft Visual C++ 2008 SP1 Runtime (VCRedist 2008 SP1): vcredist_x86.exe must be installed on the BlackBerry Enterprise Server.
PST Import Wizard Installation	.Net framework 3.5 (not SP1) and vcredist 2008 SP1 are required to be installed on the client machine at time of PST Import Wizard installation.

Hardware Requirements

The following table lists the minimum hardware requirements. These requirements take the place of the hardware requirements listed in the 4.1 documentation. Based upon your specific system configuration, additional resources may be needed.

500 Users	Single AM & SQL server 4 CPU, 8GB RAM 3xRAID 1 Local Disk 1xNetwork Based NAS
500-2000 Users	1xAM server 4 CPU, 4GB RAM 3xRAID 1 Local Disk 1xNetwork Based NAS 1xSQL SERVER 32/64bit 4xCPU, 8GB RAM 3xRAID 1 Local Disk
2000-5000 Users	1xAM server 4 CPU, 4GB RAM 3xRAID 1 Local Disk 1xNetwork Based NAS 1xSQL SERVER 64bit 4-8xCPU, 16GB RAM 3xRAID 1 Local Disk
5000 or More Users	This number of users requires a custom specification. Please contact your account executive for further information.

Global Operations

This section contains information about installing and operating this product outside of North America. This section does not replace the materials about supported platforms and configurations found elsewhere in the product documentation.

This release is Unicode-enabled and supports any character set. In this release, all product components should be configured to use the same or compatible character encodings and should be installed to use the same locale and regional options. This release is targeted to support operations in the following regions: North America, Western Europe and Latin America, Central and Eastern Europe.

This release has the following known capabilities or limitations: Tested against French OS, SQL and Exchange.

Getting Started

Contents of the Distribution Zip File

The Archive Manager 4.1.2 distribution zip file contains the following:

Top-level Folder:

ArchiveSetup.exe

Documentation Folder:

Quest_ArchiveManager_4.1.2_ReleaseNotesAddendum.html
Quest_ArchiveManager_4.1.1_ReleaseNotesAddendum.html
Quest_ArchiveManager_4.1.1_ADCConfig.pdf
Quest_ArchiveManager_4.1._ReleaseNotes.html
Quest_ArchiveManager_4.1._AdminGuide.pdf
Quest_ArchiveManager_4.1._InstallGuideExchange.pdf
Quest_ArchiveManager_4.1._InstallGuideGroupWise.pdf
Quest_ArchiveManager_4.1._Overview.pdf
Quest_ArchiveManager_4.1._Q-StartGuide_Exchange.pdf
Quest_ArchiveManager_4.1._RetentionPolicy.pdf
Quest_ArchiveManager_4.1._UserGuide.pdf

PreReqs Folder:

dotNetFx35setup.exe
msvcp71.dll
msvcr71.dll
sqlncli.msi
vcredist_x86exe

Installing Archive Manager

Please see the Planning and Installation Guide (for either Exchange or GroupWise) for full instructions and application notes to install the current version of Archive Manager. The Planning and Installation Guide also provides valuable pre-installation planning information, process checklists, and pre- and post-installation process instructions that are necessary for a successful Archive Manager installation.

Upgrading from an Earlier Version of Archive Manager

To upgrade from Archive Manager Version 4.1.0.366 or 4.1.1.436, run ArchiveSetup.exe.

The Upgrading chapter of the Planning and Installation Guide (for either Exchange or GroupWise) provides full instructions and application notes for upgrading to the current version of Archive Manager from an earlier version. The current version of Archive Manager supports upgrades only from versions 4.1.0.366 or 4.1.1.436, and HotFixes which specify in their release notes that they are applicable to that specific build.

Important Upgrade Considerations:

The upgrade process does not recognize prior installations of the PST Import Wizard, Search Exporter, and Retention Policy Editor components of Archive Manager. You must manually uninstall these components before performing an upgrade.
Be sure to review your ADC configuration files after updating to this release, as some configuration items have changed. For more information and instructions, see the Quest_ArchiveManager_4.1.1_ADCConfig.pdf. The user must manually create this file in the Archive Manager installation directory, according to the instructions in that PDF document. Any existing configuration files (sometimes referred to as ADC.xml or Domains.xml) must conform to the format specified in the PDF . The filename is not critical, but the placement of the file and the .xml extension are. The file name and location are set in the Archive Manager Configuration Editor.

For More Information

Contacting Quest Software:

Email	info@quest.com
Mail	Quest Software, Inc. World Headquarters 5 Polaris Way Aliso Viejo, CA 92656 USA
Web	http://www.quest.com

Please refer to our web site for regional and international office information.

Contacting Customer Support:

Quest Support is available to customers who have a trial version of a Quest product or who have purchased a commercial version and have a valid maintenance contract.
Quest Support provides around the clock coverage with SupportLink, our web self-service. Visit SupportLink at http://support.quest.com/.

From SupportLink, you can do the following:

Quickly find thousands of solutions (Knowledgebase articles/documents).
Download patches and upgrades.
Seek help from a Support engineer.
Log and update your case, and check its status.

View the Global Support Guide for a detailed explanation of support programs, online services, contact information, and policy and procedures.
The guide is available at: http://support.quest.com/pdfs/Global Support Guide.pdf. This guide is available in English only.

This document contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchase or personal use without the written permission of Quest Software, Inc.

If you have any questions regarding your potential use of this material, contact:

Quest Software World Headquarters
LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
Email: legal@quest.com

Refer to our web site for regional and international office information.

Trademarks

Quest, Quest Software, and the Quest Software logo are trademarks and registered trademarks of Quest Software, Inc. Other trademarks and registered trademarks that may appear in this document are the property of their respective owners.

Third Party Contributions

This product includes the copyrighted software of the following third-party suppliers:

Infragistics NetAdvantage 2005© Copyright 2004 Infragistics, Inc.
HTTP Compress© Copyright 2002-Present Ben Lowery (compress@blowery.org).
MAPI33.NET Library© Copyright AdEx Solutions, Inc. 2004.
EasyMail .Net Edition© 2002 Quiksoft Corporation
EasyByte RTF-2-HTML© 2007 EasyByte Software Limited
BalloonWindow© 2002-2003 Peter Rilling
Janus Controls© 2006 Janus Systems SA
Portions© 2004 Apache Software Foundation, under Apache License 2.0.

Disclaimer

The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.