P8RM-3.7.0-008 is a mandatory fix pack for Version 3.7.0 of IBM FileNet Records Manager. The minimum level fix pack of IBM FileNet Records Manager that you must have installed on your system is P8RM-3.7.0-008.
This document provides information about the IBM® FileNet®P8RM-3.7.0-008 fix pack, which updates an existing Records Manager (RM) 3.7.0 system. Fix packs are cumulative; each fix pack contains content from all previously released fix packs.
Documentation
To access documentation for IBM InfoSphere Enterprise Records:
Compatibility documentation and matrices
To access compatibility documentation and matrices for InfoSphere Enterprise Records:
Fix packs
To access fix packs for InfoSphere Enterprise Records:
This fix pack introduces improvements and enhancements to the following:
For details about the resolved defects in this fix pack, see Product fix history.
For information about RM new features and known issues, see the IBM FileNet Records Manager Release Notes.
The following Records Manager components are enhanced:
The following Records Manager components are enhanced:
The following Records Manager components are enhanced to enable SSL support:
These components require configuration to support SSL. For details, see Configure RM components for SSL support.
The Connector Registration Tool updates the DocURI (Document Location) property for records that have invalid connectors. To install this tool, see Install this fix pack.
In report mode, the tool generates a report, ConnectorRegistrationLogging.log, that identifies records that have invalid connectors. In repair mode, the tool uses information from the log file to replace the invalid connectors with active connectors.
After you install this fix pack, run the tool as follows:
RMConnectorRegistrationRepair -report
The tool generates the ConnectorRegistrationLogging.log file that displays all records, with their current connectors, as well as all available connectors.
NOTE To repair each invalid connector, one at a time, skip to Step 8.
NOTE Whenever the tool executes, the ConnectorRegistrationLogging.log is overwritten. Therefore, save ConnectorRegistrationLogging.log with a different filename after each execution of the tool for tracking purposes.
RMConnectorRegistrationRepair -repair
NOTE You can also launch the tool in simulated repair mode by entering the -simulatedrepair parameter. In simulated repair mode, the tool does not modify any record data, but displays the likely results of a repair in the ConnectorRegistrationLogging.log file.
NOTE Whenever the tool executes, the ConnectorRegistrationLogging.log is overwritten. Therefore, save ConnectorRegistrationLogging.log with a different filename after each execution of the tool for tracking purposes.
RMConnectorRegistrationRepair -repair
NOTE You can also execute the tool in simulated repair mode by entering the -simulatedrepair parameter. In simulated repair mode, the tool does not modify any record data, but displays the likely results of a repair in the ConnectorRegistrationLogging.log file.
The following components must be installed before installing this fix pack:
If you are using the Records Manager Reports component:
Use the following instructions to install the RM-3.7.0-008 fix pack.
UNIX®: /opt/FileNet/RecordsManager/
Windows®: C:\Program Files\FileNet\RecordsManager\
Before installing the RM 3.7.0-008 fix pack, copy the folders shown below from the RM 3.7.0-008 fix pack to a location that will not be deleted. For example, copy the folders to a new folder inside the FileNet P8 directory where the FileNet P8 software is installed. These folders are required for the RM upgrade and for administrative purposes after the upgrade.
The fix pack installer can be run in two modes: Typical or Custom. Typical mode updates the components shown below.
Custom mode enables you to install or update a subset of the components shown below.
NOTES
NOTE The RM setup program copies RM-related jar files to this location.
Examples of default WEB-INF deployment locations:
WebSphere® 5.x
<WAS_HOME>/installedApps/<node_name>/app_engine_war.ear/app_engine.war/WEB-INF/libWebSphere 6.x
<WAS_HOME>/profiles/default/installedApps/<node_name>/app_engine_war.ear/app_engine.war/WEB-INF/libWebLogic
<WL_install>/domains/AEdomain/AEserver/.wlnotdelete/extract/AEserver_RecordsManager_RecordsManager/jarfiles/WEB-INF/libJBoss
<JBoss_HOME>/server/default/deploy/Workplace.war/WEB-INF/lib(JBoss, version 4.01 and lower)
<JBoss_HOME>/server/default/deploy/<Web Application Name>.ear/Workplace.war.war/WEB-INF/libTomcat
<Tomcat_HOME>/webapps/Workplace/WEB-INF/lib
If any javaw.exe processes are running, do the following:
NOTE This method requires you to install software available as part of the Windows 2000 installation set.
NOTE The RM installer adds /FileNet/RecordsManager to the location that you specify in the Directory Name field.
CAUTION You must enter the deployed WEB-INF directory, not the installed directory.
<RM_install_path>/FileNet/rm_install_log_3_7_0.txt file.
For more information about redeploying the Records Manager application, see the "Redeploy the RM web application" task in the "Upgrade tasks" section of the IBM FileNet Records Manager 3.7.0 Installation and Upgrade Guide.
NOTE After you redeploy the Records Manager application, you must delete the RM cache folder for each application server. The RM cache folders are:
JBoss
<JBOSS_install>\server\default\tmp\deploy\
WAS 6.x
<WAS_Install>\AppServer\profiles\AppServer_name\temp\Node_name\server1
WebLogic 8.1
<WL_install>\domains\domain_name\server_name\.wlnotdelete\extract
WebLogic 9.2 and 10
<WL_install>\domains\domain_name\servers\server_name\tmp\_WL_user
Before you continue configuring RM, you must:
NOTE Complete Step 1 only if the records object store is Oracle-based. Complete Step 2 for all databases, including Oracle, SQL, DB2 and others.
If your records object store is Oracle-based, do the following on the server where RM Hold Sweep is installed:
Windows: RecordsManagerSweep.bat -HoldSweep -configure
UNIX: ./RecordsManagerSweep.sh -HoldSweep -configure
HKEY_LOCAL_MACHINE\SOFTWARE\FileNET\ECM\Content Engine\Tracing\Content Search\Verity Max Docs
where Verity Max Docs is a DWORD and the value is set to 0.
C:\Program Files\FileNet\Content Engine\WSIConfig.exe
If you are running Records Manager in a SSL environment, complete the procedures in this section.
server_name The Content Engine server name or IP address.
process-router The URL of the router that points to the process region that is configured for RM. The format for the router name is:
<AE_web_application_server>:<port>/<router_name>
For example:
myserver:32771/vwrouter:
object-store-name The FPOS name.
Connection A valid entry is http or https.
Port The SOAP protocol port number. For http, the default port number is 8008. For https, the default port number is 4434.
Windows: RecordsManagerSweep.bat -HoldSweep -configure
UNIX: ./RecordsManagerSweep.sh -HoldSweep -configure
Connection A valid entry is http or https.
WSI Protocol Port Number The WSI Data Service port number. For http, the default port number is 6070. For https, the default port number is 6075.
SOAP Protocol Port Number For http, the default port number is 8008. For https, the default port number is 4434.Windows: RecordsManagerSweep.bat -DispositionSweep -configure
UNIX: ./RecordsManagerSweep.sh -DispositionSweep -configure
Connection A valid entry is http or https.
Port Number The WSI Data Service port number. For http, the default port number is 6070. For https, the default port number is 6075.
Windows: FilePlanTool.bat -mode configure
UNIX: ./FilePlanToo.sh -mode -configure
Connection A valid entry is http or https.
Port Number The SOAP protocol port number. For http, the default port number is 8008. For https, the default port number is 4434.
If you are using a previous version of JBoss, refer to Configure JBoss (4.0.1 or lower) for RM deployment.
NOTE: You only need to complete Steps 5 - 7 if you are running JBoss as a service. If you are not, you will not find the jboss-service.xml file and you can skip to Step 8.
To deploy RM on JBoss version 4.01 and lower, you must configure isolated classloading for deployed web applications by deploying the web application within an enterprise application (.ear).
Example: In the case of Records Manager, name the folder RecordsManager.ear.
<?xml version="1.0"?>
<application
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/application_1_4.xsd"
version="1.4">
<display-name><Web Application Name> EAR</display-name>
<description><Web Application Name> EAR</description>
<module>
<web>
<web-uri><Web Application Name>.war</web-uri>
<context-root><Web Application Name></context-root>
</web>
</module>
</application>
NOTE Replace all occurrences of <Web Application Name> with the name of the web application.
Example: For this example, use RecordsManager.
<jboss-app>
<loader-repository>
<<webapp name>>:loader=<Web Application Name>.ear
<loader-repository-config>
java2ParentDelegaton=true
</loader-repository-config>
</loader-repository>
</jboss-app>
NOTE Replace all occurrences of <Web Application Name> with the name of the web application.
Example: For this example, use RecordsManager.
<RM_install_path>/FileNet/
to:
<JBoss_HOME>/server/default/deploy/<Web Application Name>.ear
<JBoss_HOME>/server/default/deploy/<Web Application Name>.ear/RecordsManager.war
<JBoss_HOME>/server/default/work/jboss.web/localhost/RecordsManager
NOTE This directory exists only if you have previously run the RM application on this JBoss application server.
Use the following updated procedure to configure Crystal Reports. This procedure replaces the corresponding procedure found in the FileNet Records Manager 3.7.0 Installation and Upgrade Guide.
<install_drive>:\Program Files\Business Objects\BusinessObjects Enterprise 11\Samples\En\Reports
The following reports require different configuration steps:
The configuration steps for these reports are as follows:
The Records Viewed by User Report requires the following additional configuration steps:
To remove this fix pack, you must complete a full uninstall of RM. Removal of the fix pack alone is not supported. For more information, see the IBM FileNet Records Manager Installation and Upgrade Guide.
The table below lists the fixes and features in this fix pack. The following abbreviations are used:
APAR Name | Defect # | Type |
Description |
---|---|---|---|
PJ38057 |
914479
|
Fix |
A potential issue with retention of multi-filed records during disposition processing occurs in IBM FileNet Records Manager when more than 10,000 multi-filed records exist within a file plan. This fix provides a mandatory update. See the Tech Note titled "Potential issue with retention of multi-filed records during disposition when using IBM (InfoSphere) Enterprise Records 4.5.1, IBM FileNet Records Manager 4.5.0, 4.0.0 and 3.7.0." at: http://www.ibm.com/support/docview.wss?rs=3286&uid=swg21443425 |
APAR Name | Defect # | Type |
Description |
---|---|---|---|
PJ37032 |
832167 |
Fix |
File Plan contents is not refreshing in the Category Tree View. |
PJ36741 |
837455 |
Fix |
Getting 3 different errors on 3 different AE servers in a cluster when moving a record to a different volume. |
PJ36824 |
844649 |
Fix |
Logically deleted record shows up in filter operation. |
APAR Name | Defect # | Type |
Description |
---|---|---|---|
PJ34461 |
774564 |
Fix |
The search results are slow when an RM Search Template is used. |
PJ34467 |
774600 |
Fix |
Records Manager does not retain search results in the choice list after running a search. |
PJ36527 |
791136 |
Fix |
The event script that ships with Records Manager does not update custom properties after a user removes a value. |
PJ35690 |
794451 |
Fix |
The Hold Condition screen does not function properly. |
PJ36045 |
799629 |
Fix |
Applying holds to records is slow. |
APAR Name | Defect # | Type | Description |
---|---|---|---|
PJ34204 |
768932 |
Fix |
The Records Manager Web application cannot open old records. |
PJ34436 |
772333 |
Fix |
Performance of Records Manager Content search is unacceptable. |
PJ34053 |
767426 |
Fix |
After applying P8RM-3.7.0-003.001, Hold Sweep returns a StopOnErrorsException. |
PJ34098 |
768282 |
Fix |
Records Manager search produces a different ranking, count and order in the results than those produced in Workplace. |
PJ34135 |
762053 |
Fix |
Disposition sweep is hard-coded for use with only HTTP. |
PJ34348 |
772203 |
Fix |
After installing P8RM-3.7.0-1003 and P8RM-3.7.0-1004, users cannot see the path of the search template. |
APAR Name | Defect # | Type |
Description |
---|---|---|---|
PJ32694 |
740584 |
Fix |
Executing -DispositionSweep -Configure produces this error: "An exception is raised while creating CESession." NOTE This fix requires executing the Connector Registration Repair tool. For details about how to use this tool, see New in this test fix. |
PJ32844 |
660752 |
Fix |
RM Hold Sweep applies only partial holds on declared records. |
PJ32848 |
660753 |
Fix |
RM Hold Sweep fails to run in a production environment. |
PJ32854 |
745054 |
Fix |
The Destroy workflow fails for e-mails and attachments. |
PJ32858 |
556298 |
Fix |
The Hold Condition preview displays a selected property multiple times. |
PJ32861 |
556312 |
Fix |
The Hold Condition preview fails to filter records. |
PJ32864 |
557179 |
Fix |
RM fails to apply holds through a content search that uses VQL statements. |
PJ33216 |
752668 |
Fix |
A runtime exception error occurs while a user navigates the record categories tree. |
PJ33414 |
754015 |
Fix |
Holds Sweep is unable to process large content based retrieval (CBR) results. |
PJ33858 |
381019 |
Fix |
The Detailed report, "Review Decisions Taken within a Specific Period," displays incorrect data. |
PJ33859 |
556152 |
Enh |
Disposition sweep performance has been enhanced for multiple containers and a large quantity of records. |
DTS # | Type | Description |
---|---|---|
203371 |
Fix |
A "Cannot access object" error occurs in Workplace when selecting Printable View of Record Properties. |
203560 |
Fix |
Unable to create a record category when utilizing choice lists. |
205280 |
Fix |
Hold Sweep is not running with a non-default Apache port number configured. |
205329 |
Fix |
Customized CE Apache port causes RM 3.7.0 installation issues. |
205407 |
Fix |
Cannot place a hold on a record based upon a CBR value. |
206756 |
Fix |
Hold does not work when using the "From" property in the Email class. |
207782 |
Fix |
Cannot populate the "content contains" field in the Conditions page of a hold with the VQL value. |
209517 |
Fix |
File Plan Tool fails to export file plan. The following error occurs: "Exception: Reached end of stream while reading HTTP response status". |
211257 |
Fix |
File Plan Import Export Tool fails to import with '&' character in choice list properties. |
DTS # | Type | Description |
---|---|---|
198017 |
Fix |
Labels for string fields are not read by JAWS. |
198023 |
Fix |
RM screen paths are read incorrectly by JAWS. RM displays paths using the ">" character to separate folders, which is interpreted by JAWS as "greater than". |
DTS # | Type | Description |
---|---|---|
186442 |
Fix |
The Date column values of all the reports are displayed in GMT format (including the Start and End dates). |
190608 |
Fix |
An object store is not dynamically switched from the user interface for RM crystal reports. |
195453 |
Fix |
If you run a report that includes a disposition schedule parameter and the object store name includes a unicode character, you will get an error when you select the link to enter the disposition schedule name. |
196387 |
Fix |
When a user creates a phase but does not provide a value for a required field, RM displays an error message and subsequently does not display the required field. |
For information about contacting customer support:
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
1623-14 Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation J46A/G4 555 Bailey Avenue San Jose, CA 95141-1003 U.S.A.
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.