CA Records ManagerRelease Notesr12.5 SP1
This documentation and any related computer software help programs (hereinafter referred to as the"Documentation") are for your informational purposes only and are subject to change or withdrawal by CA at any time.This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part,without the prior written consent of CA. This Documentation is confidential and proprietary information of CA and maynot be used or disclosed by you except as may be permitted in a separate confidentiality agreement between you andCA.Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation,you may print a reasonable number of copies of the Documentation for internal use by you and your employees inconnection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy.The right to print copies of the Documentation is limited to the period during which the applicable license for suchsoftware remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certifyin writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION "AS IS" WITHOUTWARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USEROR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION,INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, ORLOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.The use of any software product referenced in the Documentation is governed by the applicable license agreement andis not modified in any way by the terms of this notice.The manufacturer of this Documentation is CA.Provided with "Restricted Rights." Use, duplication or disclosure by the United States Government is subject to therestrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section252.227-7014(b)(3), as applicable, or their successors.Copyright 2009 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced hereinbelong to their respective companies.
CA Product ReferencesThis document references the following CA products: CA Records Manager (formerly MDY FileSurf )Contact CAContact Technical SupportFor your convenience, CA provides one site where you can access the informationyou need for your Home Office, Small Business, and Enterprise CA products. Athttp://ca.com/support, you can access the following: Online and telephone contact information for technical assistance andcustomer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your productProvide FeedbackIf you have comments or questions about CA product documentation, you cansend a message to [email protected] you would like to provide feedback about CA product documentation, completeour short customer survey, which is also available on the CA Support website,found at http://ca.com/docs.Certifications and RequirementsRefer to the CA Records Manager Certified Device List (CDL), accessed from theCA Records Manager product home page on CA Support Online, athttp://ca.com/support to obtain information on currently supported CA RecordsManager operating systems, products and guides, software versions, interfacingthird party products, archive storage devices, and languages.
ContentsChapter 1: Welcome11System Requirements . 11Application Server . 11Database Server . 12Web Server . 13Workstations . 14Chapter 2: New Features in r12.5 SP117Browser-Independent Support . 17Upgrade from r12.5 to r12.5 SP1 . 17Known Issues for r12.5 SP1 . 17CA Records Manager Known Issues for r12.5 SP1 . 17Discovery and Retention Manager Known Issues for CA Records Manager r12.5 SP1 . 18Known Issues for Documentation for r12.5 SP1 . 18CA RM Server Configuration Utility . 19Service Accounts and Log On Permissions . 19eDocs DM Integration Guide . 19FSI.INI File Considerations . 19FSI.INI File Parameters . 20Store Client Configuration Information in the RMS.INI File . 23About Silent Installation . 23Web Interface Configuration Guide . 24Chapter 3: Changes to Existing Features in r12.5 SP131Web Interface Enhancements . 31Changes to the Web Interface . 31Other Functional Enhancements to the Web Interface . 32Known Issues Corrected for the Web Interface . 33Update Your Web Configuration . 33Enterprise Rules Service Enhancements . 34Incremental Security Synchronization for Document Management Systems . 34Events that can Trigger Security Synchronization. 34Select and Generate Synchronization Triggers . 35Synchronization Tasks . 36Contents 5
Chapter 4: New Features in r12.537Integration with Discovery and Retention Manager . 37Repository Integrity Checking for Document Management Systems . 37Install the Repository Management Service . 38Repository Management Service Logs . 40DoD Certification for Document Management Systems Integration . 41Records Management Application Transfer Interoperability . 42Integrated Email Record Declaration Buttons Added . 42How You Configure Email Buttons . 42New Documentation . 43Known Issues . 43Exchange and Outlook Integration Known Issues . 43Documentum Integration Known Issues . 44eDOCS DM5 Integration Known Issues . 44Discovery and Retention Manager Known Issues . 44Known Issues for Documentation . 45Chapter 5: Changes to Existing Features in r12.549Synchronization with Document Management Systems . 49Security Synchronization . 49How You Use AD Import for Synchronization . 49Synchronization Jobs . 50Configure a Synchronization Job for CA Records Manager r12.5 . 51Synchronization Job Log File . 53Email Integration . 54Auto Declaration Folder Indicator Enhancement . 54Auto Declaration Folder Web View . 54Expanded Place Control Capability . 55Run the Document Import Utility from the Command Prompt . 57Wildcard Considerations . 57Release Numbers on Documentation . 58Chapter 6: Transferring Records to Records Management Applications59About Transferring Records from CA Records Manager . 59Hierarchy and Transfer Considerations . 59How You Configure RMA Transfer . 60How Mappings Work for RMA Transfer . 60Export Structure for XML Files . 62RMA Transfer Configuration Dialog . 62Specify Media Type Alerts for Export Jobs . 65Customize Retention Type Labels . 666 Release Notes
RMA Export Dialog . 66Export Records . 67RMA Import Dialog . 68Import Records . 69How You Edit Schema to Configure Mapping . 70Syntax for Attribute Mapping . 71Export or Import the Binary File of a Record . 72About Collecting Binaries from SharePoint Records . 72Export or Import Supplemental Markings . 72How You Capture Email Attachment Information . 73How You Capture Disposition Information . 73Chapter 7: New Features in r1275Disposition . 75Retention Module . 75Retention Module Services . 77Permanent Record Handling . 80Define Disposition States as Final . 81Email Integration . 81Outlook and Exchange Integration . 81GroupWise Integration . 83Notes and Domino Integration . 84Full-text Indexing of GroupWise and Notes Email Attachments . 85Display Favorites Folder in a Flat File Structure . 85Internet Header Parsing . 85Keep Attachments with Email when Filing Attachments Separately . 86Enhanced Profile Visibility Control . 86Additional Integrations . 86SharePoint 2007 Integration . 86Multiple Database Support for eDOCS DM 5.2 . 87Expanded Integration Behavior Controls . 87Flexible Document Management System Field Mapping . 87Configurable Menu Labels and Folder Structure . 87Direct Access to Web Interface from Interwoven Client . 87Integration with Documentum WebTop 5.2 . 87Support for Remote Microsoft Search Servers through Redirect . 87Additions to COM-based API . 88Active Directory Room Number Support . 88BarTender Integration . 88Usability Enhancements . 88Electronic Records Filing Interface . 88Dynamic Pick Lists (Free Form Lookups) . 89Contents 7
Relational Integrity Constraints on Boxes . 89Privilege Group Duplication . 89Copy All Parties from One Matter to Another . 89Apply Legal Holds Recursively . 90Ability to File to Folders on Legal Hold . 90Access Search Result Tree from Email Link. 90Ability to Link to All Object Types from the Web Interface . 91Redesigned Cover Sheet Generation . 91Scalability and Performance . 91DBMS Full-text Search Integration . 91Web Redirection for Geographically Distributed Repositories . 92Security . 93Custom Security Filters . 93Access Security Details from Record Detail Page . 94Explicit Login Capability for COM Integrations . 94Customizable Authentication Failure Page for Web Interface . 95Searching . 95Quick Lookups . 95Add Sub-categories to Client-Matter Hierarchy Search Templates . 95Full-text Search Available During Index Rebuild . 96Category Full Code Advanced Searching Syntax . 96Enable, Disable and Limit Exploring in Web Search Results . 96Group Client-Matter Search Results by Category . 96Internationalization Capabilities for Web Interface . 96Custom Labels . 97Locales . 102General Enhancements . 103US DoD 5015.2 Version 3 Standard Certification . 103Vital and Non-vital Record Review and Update Cycle Period . 104Custom Media Types . 104Scripted Notifications and Actions . 105Multi-value Custom Field Type . 105RMA-to-RMA Transfer Capability (Corporate Hierarchy) . 105Repository Integrity Checking Service . 106Server Autodeclaration Rules Configuration Utility . 106Configurable Declaration Menu in Federated Search . 106Chapter 8: Changes to Existing Features in r12107Archive Available as Disposition Type and Session Status . 107Option to Encrypt Database Connection Removed . 107Manual Assignment of Folder Volume Numbers Removed . 107Services Moved to Retention Module . 1078 Release Notes
Removed Download Option from Document Actions . 107Contents 9
Chapter 1: WelcomeSystem RequirementsThe following sections describe the hardware and software requirements for CARecords Manager.Application ServerThe following are the hardware and software requirements for the CA RecordsManager Application Server.HardwareThe following are the hardware requirements for the system running the CARecords Manager Application Server:ComponentMinimumRecommendedProcessorThe minimum requiredfor your operatingsystem.One Intel Core 2 Duoprocessor or comparable.RAMThe minimum requiredfor your operatingsystem.2 GBStorageThe minimum requiredfor your operatingsystem.Sufficient storage to meetyour expectedrequirements.Note: The application server can also be installed on a virtualized applicationserver, such as VMware ESX or VMware Server.Chapter 1: Welcome 11
System RequirementsSoftwareThe following are the software requirements for the CA Records ManagerApplication Server:Operating SystemThe CA Records Manager Application Server is supported on the followingoperating systems: Windows Server 2003Additional Required Software Microsoft XML Core Services 4.0 Microsoft .NET Framework 3.5Note: If you do not install the Retention Module on the same machine asthe Application Server, you can use .NET Framework 2.0. MDAC 2.8 or higher If connecting to an Oracle database, the Oracle Client. Refer to the DBMSvendor's documentation for the appropriate version of the Oracle Clientto install. To support Exchange services, Outlook email rules, Symantec EnterpriseVault integration, and Zantaz EAS integration: Microsoft ExchangeServer MAPI Client and Collaboration Data Objects 1.2.1. (For MicrosoftExchange 2000 and Exchange 2003 only, as an alternative, you caninstall the Exchange Administrator Console on the Application Server.)Note: Do not install Outlook on the application server. However, if youwant to run a CA Records Manager Exchange PST Crawler service toprocess PST files exported from Outlook 2007, see Exchange andOutlook Integration Known Issues (see page 43).Database ServerThe following are the hardware and software requirements for the CA RecordsManager Database Server.HardwareThe following are the hardware requirements for the system running the CARecords Manager database.12 Release NotesComponentMinimumRecommendedProcessorRefer to the DBMSvendor's documentationOne Intel Core 2 Duoprocessor or comparable.
System RequirementsComponentMinimumRecommendedRAMRefer to the DBMSvendor's documentation2 GBStorageRefer to the DBMSvendor's documentationSufficientDBMS-optimized storageto meet your expectedrequirementsNote: While the database can be installed on a virtualized application server, wedo not recommend doing so.SoftwareCA Records Manager supports the following databases:DatabaseEditionVersionMicrosoft SQL ServerEnterprise and Standard2005Oracle Server9i and 10gThe CA Records Manager database can be hosted on any platform supported bythe underlying DBMS. Refer to the DBMS vendor's documentation for the list ofsupported platforms.Web ServerThe following are the hardware and software requirements for the CA RecordsManager Web Server.HardwareThe following are the hardware requirements for the CA Records Manager WebServer:ComponentMinimumRecommendedProcessorThe minimum required foryour operating system.One Intel Core 2 Duoprocessor or comparable.RAMThe minimum required foryour operating system.2 GBStorageThe minimum required foryour operating system.Sufficient storage to meetyour expectedrequirements.Chapter 1: Welcome 13
System RequirementsSoftwareThe following are the software requirements for the CA Records Manager WebServer:Operating SystemThe CA Records Manager Web Server is supported on the following operatingsystems: Windows Server 2000 Windows Server 2003Additional Required Software For Windows Server 2000, IIS 5.0 For Windows Server 2003, IIS 6.0 Internet Explorer 6, 7, or 8 If connecting to an Oracle database, the Oracle Client. Refer to the DBMSvendor's documentation for the appropriate version of the Oracle Clientto install.WorkstationsThe following are the hardware and software requirements for CA RecordsManager workstations.HardwareThe following are the hardware requirements for CA Records Managerworkstations:14 Release NotesComponentMinimumRecommendedProcessorThe minimum required foryour operating system.One Intel Core 2 Duoprocessor or comparable.RAMThe minimum required foryour operating system.2 GBStorageThe minimum required foryour operating system.Sufficient storage to meetyour expected requirements.
System RequirementsSoftwareThe following are the software requirements for the CA Records Managerworkstations:Operating SystemCA Records Manager workstations are supported on the following operatingsystems: Windows XP Professional SP1 or SP2Additional Required Software Internet Explorer 6, 7, or 8 Microsoft XML Core Services 4.0 MDAC 2.8 or higher If installing the Retention Module, Microsoft .NET Framework 3.5 If connecting to an Oracle database, the Oracle Client. Refer to the DBMSvendor's documentation for the appropriate version of the Oracle Clientto install.Additional Optional Software Microsoft Office XP, 2003 or 2007 For Outlook and Exchange support, Microsoft Exchange Server MAPIClient and Collaboration Data Objects 1.2.1. For Outlook email rules using Outlook 2007, if the desktop is allowed toconfigure rules, Microsoft Collaboration Data Objects 1.2.1. For Outlook email rules using earlier versions of Outlook, the version ofCollaboration Data Objects available from the Microsoft OfficeInstall/Remove Programs setup. Firefox 3 Safari 3Chapter 1: Welcome 15
Chapter 2: New Features in r12.5 SP1Browser-Independent SupportIn addition to the existing browser support, the following browsers are nowsupported: Internet Explorer 8 Firefox 3 Safari 3Context-sensitive functions for the CA Records Manager web interface areavailable in the browsers when you click a selected object.Note: For more information about changes to the Web Interface, see WebInterface Enhancements (see page 31).Upgrade from r12.5 to r12.5 SP1Information and components for upgrading from CA Records Manager r12.5 toCA Records Manager r12.5 SP1 are available on the distribution CD in theInstallation CD\Upgrade\SP1UpdateOnly folder.Known Issues for r12.5 SP1This section contains information about known issues related to CA RecordsManager r12.5 SP1.CA Records Manager Known Issues for r12.5 SP1The following known issue applies to CA Records Manager:Error Retrieving Documents with Multiple Holds from Oracle-based CARecords Manager RepositoryDue to an issue in CA Records Manager r12.5, you may receive an error whenretrieving a document under the following conditions: The document was declared as a record via Discovery and RetentionManager The document is subject to multiple holdsChapter 2: New Features in r12.5 SP1 17
Known Issues for Documentation for r12.5 SP1 The repository is an Oracle-based CA Records Manager r12.5 repositoryIf you are affected by this issue, you will receive the following error:ORA-20001: No category for ParentORA-06512: at "FN CONT ON HOLD", line 47To resolve this issue, upgrade the CA Records Manager repository to CARecords Manager r12.5 SP1.Discovery and Retention Manager Known Issues for CA Records Manager r12.5SP1The following known issues apply to Discovery and Retention Manager:Slow Document Retrieval on CA Records Manager r12.5Due to an issue in CA Records Manager r12.5, you might notice a slight delaywhen previewing and opening documents managed by CA Records Managerr12.5 repositories. This issue causes the following error to appear in the CARecords Manager connector log file:System.Runtime.InteropServices.COMException (0x800706BE): The remote procedurecall failed. (Exception from HRESULT: 0x800706BE)To resolve this issue, upgrade the CA Records Manager repository to CARecords Manager r12.5 SP1.Some Emails Are Cut Off in Document PreviewDue to an issue with a third-party component of Discovery and RetentionManager, the text of certain emails may get cut off when they are viewed inthe document preview. If an email is a response to or a forward of anotheremail, and the text written by the forwarder or sender does not include acarriage return, the responder's or forwarder's text is not included in thedocument preview.For example, if a person forwards an email and includes the text "FYI" in themessage body, but does not enter a carriage return, the text "FYI" would notappear in the document preview. The forwarded message itself would bedisplayed intact.Known Issues for Documentation for r12.5 SP1The following topics contain information to correct or modify known issues for thepublished documentation or to highlight information that is not in the publisheddocumentation.18 Release Notes
Known Issues for Documentation for r12.5 SP1CA RM Server Configuration UtilityAny mention in the documentation of the CARM Server Management utilityshould be read as referring to the CA RM Server Configuration utility. In the r12and r12.5 documentation, the CARM Server Configuration utility is referred to asthe CARM Server Management utility.Service Accounts and Log On PermissionsAll service accounts for CA Records Manager must have security privileges to logon as a service.eDocs DM Integration GuideThe instruction in the eDocs DM Integration Guide for specifying the view locationfor eDocs DM integration is incorrect. You cannot leave the view location fieldblank or view an eDocs document by using the eDocs web URL. The followinginformation describes the value required for this field:View LocationSpecifies a UNC path to a network share where CA Records Manager createstemporary files. The CA Records Manager administrator account must havefull access to this network share. This network share must be located on theCA Records Manager server where the CA Records Manager ElectronicRecords services COM component is installed.FSI.INI File ConsiderationsThe fsi.ini file configures CA Records Managerclient components licenses (LICsection), parameters controlling the installation process (CONTROL section), anddefault values for the installation process settings (SERVER section).The fsi.ini file provides controls for the following important installation options:AutoCompletePopulates the fsi.ini file with predefined values for configuration settings.This eliminates the user prompts and manual entry during the installationprocess.Chapter 2: New Features in r12.5 SP1 19
Known Issues for Documentation for r12.5 SP1Installation on Windows VistaWindows Vista has security restrictions that prevent using theHKEY LOCAL MACHINE registry hive for storing configuration settings. CARecords Manager has an alternative method to store configuration settings inthe rms.ini file. The fsi.ini file provides a switch for configuring the rms.ini tobe used by all client-side components to write and read settings. ThisVista-compatible installation mode works for any operating system and it isthe preferable method for the Vista-only or mixed operating systemenvironment. To use this option set the following parameter in the rms.inifile:UseRmsIni YFSI.INI File ParametersThe following list provides detailed information about the parameters in the fsi.inifile.The [CONTROL] section contains parameters that control the installationprocess. The following options are available:AutoCompleteSpecifies how the parameter values are populated. The following options areavailable:NUse values from fsi.ini file to pre-populate the installation dialogs, butthe user can change them during the installation.YUse values from the fsi.ini file and do not display installation dialogsduring the installation process.Default: NFSInstallPathSpecifies the default value for the CA Records Manager installation path. Ifthis value is blank, the default is hard-cod
To support Exchange services, Outlook email rules, Symantec Enterprise Vault integration, and Zantaz EAS integration: Microsoft Exchange Server MAPI Client and Collaboration Data Objects 1.2.1. (For Microsoft Exchange 2000 and Exchange 2003 only, as an alternative, you can install the Exchange Administrator Console on the Application Server.)