IBM FileNet P8 Version 4.0. Release Notes GC

Transcription

1 IBM FileNet P8 Versin 4.0 Release Ntes GC

2

3 IBM FileNet P8 Versin 4.0 Release Ntes GC

4 Nte Befre using this infrmatin and the prduct it supprts, read the infrmatin in Ntices n page 183. Cpyright IBM Crpratin 2002, US Gvernment Users Restricted Rights Use, duplicatin r disclsure restricted by GSA ADP Schedule Cntract with IBM Crp.

5 Cntents IBM FileNet P Release Ntes Cntents Revisin Lg... 9 Intrductin Access IBM FileNet dcumentatin, cmpatibility matrices, and fix packs Custmer supprt Feedback Dcumentatin Updates What s New in Applicatin Engine Imprved installatin and cnfiguratin prcess...21 New access rle Remved rt user restrictin Expanded single sign-n supprt Imprved language supprt FileNet Services fr Ltus Quickr Available languages What s New in Fix Pack P8CE Cntent Engine Java and.net APIs What s New in BPM Prcess Engine Available languages What s New in Wrkplace XT New Features Dcumentatin What's New fr IBM FileNet Cnnectrs fr SharePint IBM FileNet Cnnectr fr SharePint Web Parts IBM FileNet Cnnectr fr SharePint Dcument Libraries IBM FileNet Cnnectrs fr SharePint Dcumentatin What s New in IBM FileNet Cnnectr fr SharePint Web Parts New Features Installatin Imprvements Usability and Accessibility Available languages What s New in P and Prcess Engine Cntent Engine Security Cntent-based Retrieval (CBR) indexing enhancements WebSphere Applicatin Server Versin 6.1.x supprt Platfrm supprt Installatin and Upgrade Enterprise Manager Develpment Tls Wrkplace Applicatin Integratin Tlkit Prcess Engine Java API Prcess Engine Web Services Cntent Engine Java and.net APIs Dcumentatin Prcess Engine WebSphere Business Mnitr Integratin WebSphere Business Mdeler Integratin...38 WebSphere Services Registry and Repsitry (WSRR) Integratin Platfrm Supprt Prcess Designer Applicatin Engine Platfrm supprt Installatin and Upgrade Wrkplace enhancements Cpyright IBM Crp. 2002,

6 IBM FileNet P Release Ntes Cntents IBM FileNet Wrkplace XT New features Platfrm supprt efrms efrms Java and JavaScript APIs Renditin Engine Dcumentatin What s New in Cntent Engine Prcess Analyzer Prcess Engine Prcess Engine architecture changes Prcess Orchestratin Miscellaneus The ntifymsg cmmand has been added t vwtl Rules supprt in prcesses Prcess Simulatr Prcess Task Manager Applicatin Engine Wrkplace Cntent Federatin Services fr Cntent Services (CFS-CS) and Cntent Federatin Services fr IICE (CFS-IICE) Versin mirrring Full-text indexing (CBR) supprt Multi-valued prperty supprt Cntent lckdwn supprt High availability supprt Perfrmance enhancements Dashbard P8 efrms Desktp efrms Renditin Engine Renditin Engine installer/prcedure Develpment Tls FileNet System Manager Listener Java API...51 Web Applicatin Tlkit Wrkplace Custmizatin Wrkplace Applicatin Integratin Tlkit Cntent Engine Java and.net APIs Cntent Engine COM API and Cntent Java API Cmpatibility Layers Prcess Engine API Cmpnent Integratr-Based Wrk Perfrmers efrms Java and JavaScript APIs Dcumentatin Cntent Engine Applicatin Engine UI Service (frmerly, Integratin Servlet) Develper Help Renaming and TOC Restructuring Knwn limitatins Applicatin Engine Cntent Engine Dcumentatin Search Designer Prcess Engine Knwn Issues FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades Cntent Engine Renditin Engine Cpyright IBM Crp. 2002,

7 IBM FileNet P Release Ntes Cntents Prcess Engine Applicatin Engine Wrkplace XT Cntent Federatin Services-Image Services efrms Cntent Engine Cntent Search Engine FileNet Services fr Ltus Quickr Renditin Engine and Publishing Enterprise Manager Prcess Task Manager Prcess Engine eprcess t BPM Transitin eprcess t P8 Migratin Business Activity Mnitr Applicatin Engine Wrkplace Wrkplace XT Cntent Federatin Services (CFS-CS and CFS-IICE) P8 Prtlets WebDAV Internatinalizatin P8 efrms Desktp efrms IBM FileNet Cnnectr fr SharePint Dcument Libraries IBM FileNet Cnnectr fr SharePint Web Parts ISRA Integratin Cntent Engine Java and.net APIs Cntent Engine Web Service Cntent Java API Cmpatibility Layer Cntent Engine COM API (Cmpatibility Layer) Prcess Engine API FileNet P8 Dcumentatin Help system and Search functinality FileNet P8 Platfrm Startup and Shutdwn Guide FileNet P8 Platfrm Installatin and Upgrade Guide Cntent Engine Java and.net API Develper's Guide SharePint Dcument Libraries installatin guide SharePint Web Parts installatin guide Cntent Engine Cntent Search Engine FileNet Services Ltus Quikr Prcess Analyzer Prcess Designer Prcess Engine Prcess Task Manager Business Activity Mnitr Applicatin Engine efrms Designer P8 efrms IBM FileNet Cnnectr fr SharePint Dcument Libraries IBM FileNet Cnnectr fr SharePint Web Parts Cntent Engine Java and.net API Develper s Guide Cntent Engine COM API (Cmpatibility Layer) Prcess Engine Develper s Guide Prcess Engine API efrms Java API Cpyright IBM Crp. 2002,

8 IBM FileNet P Release Ntes Cntents Reslved Knwn Issues Miscellaneus Reslved by dcumentatin update Reslved in P8AE-FP Reslved in Fix Pack P8AE-FP Reslved in Service Pack P8AE Reslved in Service Pack P8AE Reslved in Fix Pack P8PA Reslved in BPM (Prcess Engine) P8PE Service Pack Reslved in BPM (Prcess Engine) Reslved in BPM (Prcess Engine) Reslved in Fix Pack P8CE Reslved in Fix Pack P8CE Reslved in Service Pack P8CE Reslved in Service Pack P8CE Reslved in Service Pack P8CE Reslved in Service Pack P8CE Reslved in Interim Fix Pack P8PE Reslved in Fix Pack efrms Reslved in Fix Pack SPDL-FP Reslved in Fix Pack SPDL-FP Reslved in Fix Pack SPWP-FP Reslved in Fix Pack SPWP-FP Reslved in Fix Pack WPXT-FP Reslved in Fix Pack WPXT-FP Reslved in Fix Pack WPXT-FP Reslved in Fix Pack WPXT-FP Reslved in Fix Pack WPXT-FP Reslved in Fix Pack WPXT-FP Reslved in Fix Pack WPXT-FP Ntices Trademarks U.S. Patents Disclsure Cpyright IBM Crp. 2002,

9 IBM FileNet P Release Ntes Revisin Lg Revisin Lg Date Revisin 03/23/10 Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Cntent Engine: Cntent Search Engine: , Cntent Federatin Services- Image Services: Applicatin Engine: Cntent Engine: , , , , Renditin Engine and Publishing: NA, regarding prt numbers Prcess Engine: (update), (reslved), , , Applicatin Engine: Wrkplace: Wrkplace XT: (update), , Cntent Federatin Services- Image Services: FileNet P8 Dcumentatin: Help system and Search functinality: FileNet P8 Platfrm Installatin and Upgrade Guide: , , Cntent Engine: Cntent Engine Java and.net API Develper's Guide: /29/09 Adds a What s New in Cntent Engine Java and.net API s entry regarding the PStre Tl. Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Cntent Engine: Prcess Engine: Cntent Engine: Applicatin Engine: Wrkplace:836178, , Wrkplace XT: , , , , Cntent Engine Web Service: FileNet P8 Dcumentatin: FileNet P8 Platfrm Installatin and Upgrade Guide: Prcess Engine Develper s Guide: Cpyright IBM Crp. 2002,

10 IBM FileNet P Release Ntes Revisin Lg Cntent Search Engine: /30/09 Adds a What s New in Cntent Engine Java and.net API s entry regarding the PStre Tl. Adds What s New sectin fr IBM FileNet Cnnectr fr SharePint Web Parts Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Cntent Engine: FileNet Services fr Ltus Quickr: Applicatin Engine: Wrkplace XT: CFS: (update), IBM FileNet Cnnectr fr SharePint Dcument Libraries: , IBM FileNet Cnnectr fr SharePint Web Parts: , , , P8 efrms: Cntent Engine Java and.net APIs: , (updates) FileNet P8 Dcumentatin: FileNet P8 Platfrm Installatin and Upgrade Guide: SharePint Dcument Libraries installatin guide: Cntent Engine: , , , , Prcess Engine: efrms Designer: P8 efrms: Cntent Engine Java and.net APIs: , , , Add s updates t Reslved Knwn Issues sectins per P8 Cmpnent fix pack 12/19/08 Adds What s New in Applicatin Engine Adds What s New in FileNet Services fr Ltus Quickr 1.0 Adds What s New in BPM entry fr Prcess Engine available languages Adds r updates Knwn Issue Defects fr the fllwing: FileNet Services fr Ltus Quickr: , , , , , , , , , Wrkplace XT: CFS: , (updates) IBM FileNet Cnnectr fr SharePint Web Parts: Cntent Engine Java and.net API: Cpyright IBM Crp. 2002,

11 IBM FileNet P Release Ntes Revisin Lg FileNet P8 Dcumentatin: FileNet Services fr Ltus Quickr: , , , /12/08 Adds What s New in Fix Pack P8CE Replaces the term 3 rd Party with ISV (Integrated Sftware Vendr) thrughut dcument Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Cntent Engine: Applicatin Engine: Prcess Engine: (update), Prcess Engine: Wrkplace: Wrkplace XT: , CFS: , , , , , , , , Cntent Java API Cmpatibility Layer: FileNet P8 Dcumentatin: Help system and Search functinality: Cntent Engine Java and.net API Develper s Guide: , Prcess Analyzer: Prcess Designer: /20/08 Adds What's New fr IBM FileNet BPM Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Prcess Engine: Applicatin Engine: , Prcess Engine: IBM FileNet Cnnectr fr SharePint Dcument Libraries: , , Prcess Engine API: (update) FileNet P8 Dcumentatin: IBM FileNet Cnnectr fr SharePint Dcument Libraries: /06/08 Adds What s New in Wrkplace XT Adds What's New fr IBM FileNet Cnnectrs fr SharePint 2.2 Adds What s New in and PE Develpment Tls and dcumentatin entries Cpyright IBM Crp. 2002,

12 IBM FileNet P Release Ntes Revisin Lg Adds Knwn Limitatin fr Cntent Engine Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Cntent Engine: , Prcess Engine: Cntent Engine: Enterprise Manager: Prcess Engine eprcess t BPM Transitin: Applicatin Engine: Wrkplace XT: , , CFS-CS and CFS-IICE: , WEBDAV: Internatinalizatin: IBM FileNet Cnnectr fr SharePint Dcument Libraries: , IBM FileNet Cnnectr fr SharePint Web Parts: P8 efrms: IBM FileNet Cnnectr fr SharePint Dcument Libraries: , , , , , , , , IBM FileNet Cnnectr fr SharePint Web Parts: , , , , Cntent Java API Cmpatibility Layer FileNet P8 Dcumentatin: Help system and Search functinality: , , BAM: Wrkplace XT: , Prcess Designer: Prcess Engine: IBM FileNet Cnnectr fr SharePint Dcument Libraries: /31/08 Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Cntent Engine: , efrms: , Cntent Engine: , Prcess Engine: , eprcess t BPM Transitin: Cpyright IBM Crp. 2002,

13 IBM FileNet P Release Ntes Revisin Lg BAM: Wrkplace XT: P8 efrms: FileNet P8 Dcumentatin: Help system and Search functinality: Wrkplace XT Installatin and Upgrade Guide: SharePint Web Parts installatin guide: efrms: , P8 efrms: /27/08 Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Applicatin Engine: , Prcess Engine: Prcess Engine: eprcess t P8 Migratin: CFS-CS and CFS-IICE: Cntent Engine Web Service: Cntent Java API (Cmpatibility Layer): FileNet P8 Dcumentatin: Help system and Search functinality: P8 Platfrm Installatin and Upgrade Guide: , Cntent Engine/CFS: /17/08 Adds r updates Knwn Issue Defects fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades: Cntent Engine: , Applicatin Engine: Wrkplace: Wrkplace XT: , , CFS-CS and CFS-IICE: , , , IBM FileNet Cnnectr fr SharePint Dcument Libraries: IBM FileNet Cnnectr fr SharePint Web Parts: ISRA Integratin: FileNet P8 Dcumentatin: P8 Help System and Search Functinality: FileNet P8 Platfrm Installatin and Upgrade Guide: , Cpyright IBM Crp. 2002,

14 IBM FileNet P Release Ntes Revisin Lg A number f Knwn Issues have been fixed and mved t the Reslved sectin f their respective IBM FileNet P8 cmpnent 12/14/07 Adds new WebSphere 6.1 supprt items t the What s New in sectin under Cntent Engine > WebSphere Applicatin Server Versin 6.1.x Supprt and under Prcess Engine > WebSphere Business Mdeler. Adds a What's New in IBM FileNet Wrkplace XT sectin Adds What s New sectin fr Cntent Federatin Services fr Cntent Services (CFS- CS) and Cntent Federatin Services fr IICE (CFS-IICE) 4.0 Adds r updates Knwn Issue Defects fr the fllwing: Applicatin Engine: Wrkplace: Wrkplace XT: , , , , CFS-CS and CFS-IICE: , , , , , , , , , , , , , , ,741355, , , , Prcess Engine: , IBM FileNet Cnnectr fr SharePint Dcument Libraries: , , , IBM FileNet Cnnectr fr SharePint Web Parts: FileNet P8 Dcumentatin: FileNet P8 Platfrm Installatin and Upgrade Guide: Cntent Engine: /26/07 Adds new sectins fr: Accessing IBM FileNet Dcumentatin and Cmpatibility matrices and fix packs. Adds Knwn Limitatin fr Applicatin Engine Adds Knwn Limitatin fr Dcumentatin Adds r updates Knwn Issue Defects fr the fllwing: Applicatin Engine: Wrkplace XT: , Wrkplace: , , Prcess Engine: Cntent Java and.net APIs: , Cntent Engine COM API (Cmpatibility Layer): FileNet P8 Dcumentatin: FileNet P8 Platfrm Installatin and Upgrade Guide: , /12/07 Adds What s New in sectin Adds r updates Knwn Issue DTS fr the fllwing: Cpyright IBM Crp. 2002,

15 IBM FileNet P Release Ntes Revisin Lg FileNet P8 Platfrm Installatin, Uninstallatin and Upgrades: Cntent Engine: , , , , , , , Applicatin Engine: , , , , , efrms: Cntent Engine: , , , , , , Renditin Engine and Publishing: , , Enterprise Manager: , Prcess Engine: , , , , , , , , , , , , Applicatin Engine: Wrkplace: , , , , , , WebDAV: Internatinalizatin: P8 efrms: , , , , Cntent Java and.net APIs: , , Cntent Java API Cmpatibility Layer (update) Prcess Engine API: FileNet P8 Dcumentatin: P8 Help System and Search Functinality: , , , , , , , , FileNet P8 Platfrm Installatin and Upgrade Guide: , Cntent Engine: , , efrms: efrms fr Desktp: , , , , , , Prcess Engine API: /29/07 Adds entries fr the Cntent Engine (Java API Cmpatibility Layer) t the What s New in Fix Pack-001 sectin Adds a Knwn Limitatins sectin Adds r updates Knwn Issue DTS fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin and Upgrades: Cntent Engine: , , , , , , , , , , , , , Renditin Engine: Prcess Engine: , Miscellaneus: Cpyright IBM Crp. 2002,

16 IBM FileNet P Release Ntes Revisin Lg Cntent Engine: Cntent Search Engine: , Prcess Engine: Applicatin Engine: Wrkplace XT:, , , , , , , , , , , , , , , , , , WebDAV: Internatinalizatin: Cntent Java and.net APIs: Cntent Java API Cmpatibility Layer: FileNet P8 Dcumentatin: P8 Help System and Search Functinality: , FileNet P8 Platfrm Installatin and Upgrade Guide: , Cntent Engine: Applicatin Engine: Wrkplace XT: , , , Cntent Java and.net API: , /2907 Adds a What s New in sectin Adds entries fr the Cntent Engine t the What s New in Fix Pack-001 sectin Adds r updates Knwn Issue DTS fr the fllwing: FileNet P8 Platfrm Installatin, Uninstallatin and Upgrades: Cntent Engine: , , , , , , Renditin Engine: Prcess Engine: , Cntent Engine: , Renditin Engine: , Enterprise Manager: Applicatin Engine: Wrkplace: , , WebDAV: , Internatinalizatin new sectin P8 efrms: , , Desktp efrms: Cntent Engine Java and.net API: (expansin), , FileNet P8 Dcumentatin: FileNet P8 Platfrm Installatin and Upgrade Guide: , , Cpyright IBM Crp. 2002,

17 IBM FileNet P Release Ntes Revisin Lg , , , Cntent Engine: , , , , Prcess Engine: /29/06 Initial release f prduct. Cpyright IBM Crp. 2002,

18 IBM FileNet P Release Ntes Revisin Lg Cpyright IBM Crp. 2002,

19 Intrductin IBM FileNet P Release Ntes Intrductin This dcument cntains release ntes fr IBM FileNet P and cntains the fllwing majr tpics: What s New in IBM FileNet Cnnectr fr SharePint Web Parts Describes the new features in this release. What s New in Applicatin Engine Describes the new features in this release. What s New in FileNet Services fr Ltus Quickr Describes the new features in this release. What s New in Fix Pack P8CE Describes the new features in this release. What s New in BPM Describes the new features in this release. What s New in Wrkplace XT Describes the new features in this release. What's New fr IBM FileNet Cnnectrs fr SharePint 2.2 Describes the new features in this release. What s New in and Prcess Engine Describes the new features in this release. What s New in Describes the new features in this release. Knwn Issues Describes knwn prduct and dcumentatin issues. Reslved Knwn Issues The Knwn Issues table describes defects that have been fixed. Access IBM FileNet dcumentatin, cmpatibility matrices, and fix packs T access dcumentatin, cmpatibility matrices, and fix packs fr IBM FileNet prducts: 1. Navigate t the Prduct Dcumentatin fr FileNet P8 Platfrm supprt page. ( 2. Select a PDF r a Dc Link, whichever is apprpriate. Custmer supprt Fr infrmatin abut cntacting custmer supprt: 1. Navigate t the FileNet Prduct Family supprt page: ( 2. Click IBM FileNet Supprt Cmmunicatins, r search fr a particular supprt tpic under Enter search terms. Feedback Yur feedback helps us t prvide quality infrmatin. Send yur cmments abut this publicatin r any ther IBM FileNet dcumentatin by t [email protected]. Be sure t include the name f the prduct, the versin number f the prduct, and the name and part number f the bk (if applicable). If yu are cmmenting n specific text, include the lcatin f the text (fr example, a chapter and sectin title, a table number, a page number, r a help tpic title). Cpyright IBM Crp. 2002,

20 Dcumentatin Updates IBM FileNet P Release Ntes Intrductin Release f FileNet Cntent Manager 4.0.1, FileNet Business Prcess Manager 4.0.2, and FileNet P8 efrms Service Packs required updates f the assciated dcumentatin. These updates included imprtant changes t the installatin and upgrade instructins fr FileNet P8 Platfrm. T dwnlad and install this updated dcumentatin, see the fllwing lcatins: FileNet P8 Platfrm Dcumentatin r FileNet P8 Platfrm Dcumentatin.war fr WebSphere at > FileNet Business Prcess Manager r FileNet Cntent Manager > Prduct dcumentatin > FileNet P8 Platfrm. FileNet P8 efrms Dcumentatin at > Supprt & dwnlads > Dcumentatin > Infrmatin Management > FileNet Business Prcess Manager r FileNet Cntent Manager > Prduct dcumentatin > FileNet efrms. Cpyright IBM Crp. 2002,

21 IBM FileNet P Release Ntes Intrductin What s New in Applicatin Engine Imprved installatin and cnfiguratin prcess Starting with fix pack AE , all Applicatin Engine fix packs cntain all f the sftware necessary t install Applicatin Engine. Yu n lnger need t install a base Applicatin Engine release prir t installing a fix pack. Installatin prgram panels have been updated t make chices clearer and t simplify the installatin prcess. The Install and Upgrade Wrksheet, new in the FileNet P8 Platfrm dcumentatin release fr 4.5, includes rws fr Applicatin Engine installatin prgram values. Yu can use the wrksheet when planning and preparing fr yur Applicatin Engine installatin as part f a FileNet P8 envirnment. The Applicatin Engine installatin prgram and the client installatin prgrams fr Prcess Engine and Cntent Engine allw yu t defer creating a deplyment file. By deferring this step, yu can bypass creating the deplyment file fr each installatin prgram. Instead, the last installatin prgram can create the file, r yu can create the file manually befre yu deply. New access rle The new PWDiagram access rle cntrls access t Diagram mde in Prcess Designer. Diagram mde prvides an easy-t-use tl fr business users t create layuts f wrkflw definitins, including dcumentatin t describe business prcesses. Remved rt user restrictin Previus releases required that the user installing Applicatin Engine have rt permissin. This requirement n lnger exists. Expanded single sign-n supprt Applicatin Engine supprts Kerbers/SPNEGO Single Sign On (SSO) using BEA WebLgic Server 10 and IBM WebSphere V 7. Imprved language supprt Applicatin Engine n lnger requires language packs t prvide a translated Wrkplace user interface. In additin t English, this release prvides the Wrkplace user interface in the fllwing languages: Language Lcale Language Lcale Arabic AR Japanese JA Bulgarian BG Krean KO Catalan CA Plish PL Chinese (Simplified) Chinese (Traditinal) zh-cn Prtuguese (Iberian) PT zh-tw Prtuguese (Brazilian) Cratian HR Rmanian RO Czech CS Russian RU Dutch NL Swedish SV Finnish FI Slvak SK pt-br Cpyright IBM Crp. 2002,

22 IBM FileNet P Release Ntes FileNet Services fr Ltus Quickr 1.0 French FR Spanish ES German DE Thai TH Italian IT Nte Separate media are available fr each language s Applicatin Integratin and File Tracker installatin prgrams. FileNet Services fr Ltus Quickr 1.0 IBM FileNet Services fr Ltus Quickr 1.0 prvides supprt fr integratin with Ltus Quickr prducts. By installing and cnfiguring this service, yu can allw end users t view and manage cntent in a FileNet P8 bject stre using Ltus Quickr applicatins. Available languages IBM FileNet Services fr Ltus Quickr can be installed n an perating system in the fllwing nn- English languages: Language Lcale Language Lcale Chinese (Simplified) zh-cn Japanese JA Chinese (Traditinal) zh-tw Krean KO French FR Prtuguese (Brazilian) pt-br German DE Spanish ES Italian IT Ltus Quickr supprts a different set f languages. Sme messages prduced by IBM FileNet Services fr Ltus Quickr are displayed by Ltus Quickr. These messages are available, by default, in the fllwing nn-english languages: Language Lcale Language Lcale Arabic AR Krean KO Catalan CA Nrwegian NO Chinese (Simplified) zh-cn Plish PO Chinese (Traditinal) zh-tw Prtuguese PT Czech CS Prtuguese (Brazilian) pt-br Danish DA Rmanian RO Dutch NL Russian RU Finnish FI Slvak SK French FR Slvenian SL German DE Spanish ES Greek EL Swedish SV Hungarian HU Thai TH Italian IT Turkish TR Japanese JA Ukrainian UK Cpyright IBM Crp. 2002,

23 IBM FileNet P Release Ntes What s New in Fix Pack P8CE See Ltus Quickr at: fr mre infrmatin. What s New in Fix Pack P8CE Cntent Engine Java and.net APIs Security and authenticatin When using the Micrsft Windws Active Directry service, either the Cntent Engine Directry Service User accunt r the #AUTHENTICATED-USERS grup must be added as a member f the Pre-Windws 2000 Cmpatible Access grup in each dmain cnfigured in FileNet Enterprise Manager. Failure t d s can result in functinal errrs in security. Nte In releases prir t fix pack P8CE , adding the Cntent Engine Directry Service User accunt t the grup was technically ptinal, althugh it is stated as required in the dcumentatin. It is imperative t perfrm this task prir t upgrading t fix pack level P8CE Failure t d s befre an upgrade can lead t missing security functinality, such as users lss f security permissins that were cnfigured prir t the upgrade. Cpyright IBM Crp. 2002,

24 IBM FileNet P Release Ntes What s New in BPM What s New in BPM Enable Regin fr Recvery T enable recvery f all the data fr ne islated regin independent f ther islated regins in the system, yu can use the Enable Regin fr Recvery feature in Prcess Task Manager. The feature separates the glbal Prcess Engine data fr the regin int the regin-specific database tablespaces, making it pssible t back up all the data fr ne islated regin, t rll back nly this regin, and t rll frward withut stpping Prcess Engine r rlling back all f the islated regins time/date feature The dcumentatin fr Prcess Cnfiguratin Cnsle includes instructins fr using dates beynd January Imprved language supprt BPM nw installs translated resurce files t prvide a lcalized UI withut the need fr installatin f Language Packs. Prcess Engine Client Updater The Prcess Engine Client Updater nw runs n the Prcess Analyzer and Prcess Engine and is the mechanism fr installing updated Prcess Engine client files n thse cmpnents. Prcess Engine Available languages Releases prir t P8 Prcess Engine required language packs t prvide a translated user interface. IBM FileNet Prcess Engine des nt require language packs and in additin t English, prvides the Wrkplace user interface in the fllwing languages: Language Lcale Language Lcale Arabic AR Japanese JA Bulgarian BG Krean KO Catalan CA Plish PL Chinese (Simplified) zh-cn Prtuguese (Iberian) PT Chinese (Traditinal) zh-tw Prtuguese (Brazilian) pt-br Cratian HR Rmanian RO Czech CS Russian RU Dutch NL Swedish SV Finnish FI Slvak SK French FR Spanish ES German DE Thai TH Italian IT Nte The Prcess Engine Client files als prvides translated user interface fr the abve list f languages. Cpyright IBM Crp. 2002,

25 What s New in Wrkplace XT New Features Custmizable user interface IBM FileNet P Release Ntes What s New in Wrkplace XT Yu can nw custmize the appearance f Wrkplace XT, by changing the images and clrs f the applicatin's banner and menu bar. Wrkplace XT prvides a prperties file where yu can mdify the appearance prperties and a script file that generates a new style sheet with yur changes. Micrsft Outlk mapping Yu can nw map Outlk message prperties t crrespnding class prperties using the OutlkPrpertyMappings.xml file. Once Outlk prperties are mapped t the class prperties, yu can assign thse prperties t each Outlk message that is added t an bject stre. Ltus Frms Supprt Yu can nw use Ltus Frms 3.0.1, in additin t FileNet P8 efrms, fr wrkflws. Exprt list Yu can nw exprt items frm a list view t a cmma-separated delimited file, which can be imprted int anther applicatin, such as Micrsft Excel. Imprved Wrkflw Plicy wizard page settings Yu can cntrl the visibility, accessibility, and printability f frm template pages by using settings available in the Wrkflw Plicy Wizard. A selected page can als be designated as the frm's start page. Imprved user interfaces The Add Dcument and Check In wizards are nw redesigned t make the prcesses easier and faster. The prperties page and flder and class selectin have been imprved. Site preferences cntrl whether the lder wizards and pages remain accessible fr sites that require specialized prcessing. Imprved language supprt Wrkplace XT nw installs translated resurce files t prvide lcalized UI withut the need fr Language Packs t be installed. Chinese (Simplified) Chinese (Traditinal) Dutch French German Italian Japanese Krean Prtuguese (Brazilian) Spanish zh-cn zh-tw nl fr de it ja k pt-br es Saved advanced searches Users can nw save frequently used search criteria as saved searches in the new 'My searches' flder n the search page. Cpyright IBM Crp. 2002,

26 Default starting class fr an bject stre IBM FileNet P Release Ntes What s New in Wrkplace XT The administratr can nw set the default class fr an bject stre. With this default set, users can add new dcuments withut having t navigate the full tree t find the class they need. Cntinued accessibility imprvements All new user interfaces and installers pass the accessibility checklist requirements. Increased perfrmance and scalability Applicatin perfrmance and scalability have imprved. Dcumentatin Installatin and Upgrade Guide The IBM FileNet P8 Platfrm Installatin and Upgrade Guide includes the fllwing new infrmatin: A tpic fr installing Prcess Engine Client files n the Wrkplace XT server Upgrade infrmatin fr Wrkplace XT installatins n JBss An "Accessibility Cnsideratins" tpic fr the install prcess An "Available Languages" tpic Wrkplace XT administrative help Wrkplace XT administrative help is nw lcated in the FileNet P8 Administratin sectin f the nline dcumentatin. Tpics unique t Wrkplace XT have been cnslidated in a Wrkplace XT administratin sectin. Cpyright IBM Crp. 2002,

27 IBM FileNet P Release Ntes What's New fr IBM FileNet Cnnectrs fr SharePint 2.2 What's New fr IBM FileNet Cnnectrs fr SharePint 2.2 ITLM enablement IBM FileNet SharePint Cnnectrs supprt IBM Tivli License Management (ITLM). FDCC cmpliance IBM FileNet SharePint Cnnectrs meet the requirements set frth in the Federal Desktp Cre Cnfiguratin mandate. IBM FileNet Cnnectr fr SharePint Web Parts Stred searches Users can nw display the results f a stred search using the Brwse web part. Public inbxes Users can prcess wrk in public wrk queues using the Public Inbx web part. Clumn srting and filtering Users can srt and filter clumns in the IBM FileNet web parts in the same way they can srt and filter with ut-f-the-bx SharePint web parts. Wrkflw launching Users can launch a wrkflw frm the list f subscriptins assciated with a dcument r flder class. Single sign-n supprt Using Kerbers, users can lg n t the SharePint server using their Windws username and have access t the FileNet P8 system withut lgging n again. Imprved language supprt Releases prir t IBM FileNet Cnnectr fr SharePint Web Parts 2.2 required Language Packs t prvide translated user interface. The IBM FileNet Cnnectr fr SharePint Web Parts 2.2 release des nt require Language Packs and, in additin t English, prvides the user interface in the fllwing languages: Chinese (Simplified) Chinese (Traditinal) Dutch French German Italian Japanese Krean Prtuguese (Brazilian) Spanish zh-cn zh-tw nl fr de it ja k pt-br es Cpyright IBM Crp. 2002,

28 IBM FileNet P Release Ntes What's New fr IBM FileNet Cnnectrs fr SharePint 2.2 IBM FileNet Cnnectr fr SharePint Dcument Libraries Remte deplyments Yu can install and run the Dcument Library applicatin and prcessing n a server separate frm the SharePint server. Server cnfiguratin migratin Yu can exprt the Cnfiguratin Manager Data Stre cnfiguratins frm a staging envirnment int a prductin envirnment. This eliminates the need t manually re-create data stre cnfiguratins during an exprt. Centralized management fr multiple SharePint servers Yu can use a single r remte Dcument Library server t prcess multiple SharePint server implementatins. Oracle and DB2 supprt fr cnfiguratin database The Cnfiguratin Manager data stre database can reside n Oracle and DB2 in additin t the existing supprt fr Micrsft SQL. Dcument versin supprt Users can nw specify SharePint dcument versins that need t be prcessed using the Get Versins task in a task rute. Pst-Prcessing task ptin The new mve and link Pst-Prcessing ptin in a task rute mves SharePint dcuments t an IBM FileNet P8 bject stre, and then deletes them frm the SharePint server. Dcuments can still be accessed frm a SharePint site thrugh links t each dcument. Cnfiguratin file custmizatin t fine-tune perfrmance settings The Cnnectr Services allws custmizatin f yur cnfiguratin using the web.cnfig file. This file is used fr ptimizing the tasks that need t be perfrmed. It is als used t create the links that appear n a SharePint server after selecting the new mve and link Pst-Prcessing ptin in a task rute. Recrds Management supprt SharePint dcuments mved t an IBM FileNet P8 bject stre can nw be prcessed by Recrds Manager. IBM FileNet Cnnectrs fr SharePint Dcumentatin Imprved dcumentatin The dcumentatin fr the IBM FileNet Cnnectrs fr SharePint has been rewritten using a task-based apprach. Cpyright IBM Crp. 2002,

29 IBM FileNet P Release Ntes What s New in IBM FileNet Cnnectr fr SharePint Web Parts What s New in IBM FileNet Cnnectr fr SharePint Web Parts IBM FileNet Cnnectr fr SharePint Web Parts integrates with the Micrsft SharePint basic cntent services ffering, prviding custmers with an alternative user interface fr enterprise managed cntent. SharePint Web Parts increases the capabilities and familiarity f the user interface fr the SharePint user. New Features IBM FileNet Cnnectr fr SharePint Web Parts supprts IPv6. Search templates, created in Wrkplace XT, are nw pened within the SharePint Web Parts envirnment. This allws users t leverage existing templates. Users can cnfigure and save custm views in the Brwse Web Part. Full-page display is available fr the Brwse Web Part (MOSS nly). Users can view and manage their checked-ut dcuments in a new Web Part. Users can perfrm additinal actins n dcuments and flders, including deleting dcument versins, shwing dcument hyperlinks, and shwing the flders in which a dcument is filed. Users can cnfigure and save custm and filtered views in the Inbx web parts. Dcument and flder security can be mdified within SharePint Web Parts. Installatin Imprvements Installer panels prvide simplified installatin steps and imprved embedded assistance. Upgrades nw allw the authenticatin methd t be changed. Fr example, a FileNet credential stre deplyment can be changed t Windws Integrated Authenticatin (SSO). Installatin and deplyment acrss a SharePint farm have been imprved. Usability and Accessibility The user interface and nline help are certified t meet IBM accessibility standards. Errr messages have been entirely rewritten t prvide users with additinal infrmatin. Available languages The SharePint Web Parts user interface and nline help are nw available in the nine nn-english languages listed in the table. All translated dcumentatin is included n the same media as the English dcumentatin. Language Lcale Language Lcale Chinese (Simplified) zh-cn Japanese JA Chinese (Traditinal) zh-tw Krean KO French FR Prtuguese (Brazilian) pt-br German DE Spanish ES Italian IT Cpyright IBM Crp. 2002,

30 IBM FileNet P Release Ntes What s New in P and Prcess Engine What s New in P and Prcess Engine This sectin describes the new features f the cmpnents f the release: Cntent Engine 4.0.1, Prcess Engine 4.0.2, Applicatin Engine 4.0.1, efrms 4.0.1, Renditin Engine 4.0.1, IBM FileNet Wrkplace XT , and Dcumentatin. Cntent Engine Security Imprved security inheritance mdel The security inheritance implementatin has been significantly imprved. Previusly, inheritable security settings (access cntrl entries r ACEs) were physically prpagated frm security parent t child. With this release, the security mdel has been changed t ne in which these settings are dynamically cmputed. This dynamic cmputatin ccurs whenever an access check is perfrmed n the security child bject r when the Permissins cllectin (Access Cntrl List r ACL) assciated with the security child bject is retrieved. Instead f persisting inherited ACEs in the child bject s ACL (as was dne by the previus security inheritance mdel), the ACEs t be inherited are nw calculated dynamically frm the inheritable ACEs n the security parent. Additinally, yu can extend the security inheritance mdel (using custm bject-valued prperties) t inherit frm multiple security parents: access rights are nw inheritable frm dcuments, custm bjects, and flders in different, custmizable cmbinatins. Cnsequently, and perhaps mst imprtantly, all f this nw enables yu t assign security relatinships that reflect the relatinships inherent in yur applicatin bject mdel. It is imprtant t nte that this change t the security inheritance mdel affects the rdering f entries within Permissins cllectins, and hw an Update Security Event is handled. Bth f these impacts are described belw. Permissins Ordering The rder f a permissins list (Access Cntrl List, r ACL) is changed. ACEs are nw listed in Enterprise Manager in rder f precedence: 1. Default/Direct allw 2. Default/Direct deny 3. Template allw 4. Template deny 5. Parent allw 6. Parent deny ACE's are applied frm the bttm up, s that that the mst imprtant entries, which are at the tp f the list, are prcessed last. This means that entries lwer in the list wuld be changed by entries higher in the list. Remember that within each type, Default/Direct, Template, and Parent (als called Inherited), deny always trumps allw. Fr mre infrmatin abut permissins rdering, see the fllwing nline help tpic: FileNet P8 Administratin > Enterprise-wide Administratin > FileNet P8 Security > Authrizatin > Access Rights > Allw/Deny and rder f evaluatin. Events If an bject is subscribed t the Update Security Event and the security fr an bject changes, the system generates an UpdateSecurityEvent. Prir t dynamic inheritance, mdifying the security f a flder culd als mdify the security f the dcuments cntained in that flder. The applicable Access Cpyright IBM Crp. 2002,

31 IBM FileNet P Release Ntes What s New in P and Prcess Engine Cntrl Entry (ACE) wuld be physically cpied frm the flder t the dcument. Because this actually mdified the dcument security, an UpdateSecurityEvent was generated fr each dcument. With dynamic inheritance, physical cpying f ACEs n lnger ccurs. Thus, the system n lnger generates the UpdateSecurityEvent fr each impacted bject. Given the example, nly a single UpdateSecurityEvent is generated fr the security mdificatin perfrmed n the flder. Fr infrmatin abut the changes t the security mdel, see the fllwing nline help tpic: FileNet P8 Administratin > Enterprise-wide Administratin > FileNet P8 Security > Authrizatin > Understanding inheritance. This tpic includes a link t infrmatin n cnfiguring security inheritance. Supprt fr ADAM directry service prvider Cntent Engine nw supprts Micrsft Windws Active Directry Applicatin Mde (ADAM) fr prviding directry services. Yu can find mre infrmatin abut ADAM (and ther supprted directry service prviders) in the fllwing nline help tpic: FileNet P8 Administratin > Enterprisewide Administratin > FileNet P8 Security > Directry service prviders > Windws Active Directry Applicatin Mde (ADAM). Fr cnfiguratin infrmatin, see the fllwing IBM FileNet P8 Platfrm Installatin and Upgrade Guide tpic: Cnfigure Active Directry Applicatin Mde (ADAM). A new ADAM Directry Cnfiguratin Type has been added t the Enterprise Manager s Directry Cnfiguratin Wizard. The Cntent Engine.NET and Java APIs have been updated t include the classes, interfaces, and prperties related t ADAM supprt. Fr details, see CE Java and.net APIs. Cntent-based Retrieval (CBR) indexing enhancements A new TempDirectryPath prperty has been added t the VerityIndexArea bject. In previus releases, the Autnmy indexes culd be stred remtely frm the Verity server. This was fund t reduce indexing perfrmance. Therefre, Autnmy indexes must be stred lcally t the Verity server. The previusly existing RtDirectryPath prperty shuld always be a lcal path n the Autnmy server (the path shuld nt be a UNC path). The new TempDirectryPath prperty specifies a shared directry used by bth Verity and Cntent Engine The shared directry is where data is shared between the tw engines. This path can be remte t either server applicatin. WebSphere Applicatin Server Versin 6.1.x supprt IBM FileNet P8 Cntent Engine nw supprts IBM WebSphere Applicatin Server Versin 6.1. This supprt requires the installatin f the Cntent Engine Interim Fix P8CE , as well as the WebSphere APAR PK54565 ( ibm.cm/supprt/dcview.wss?rs=0&q1=pk54565&uid=swg1pk54565&lc=en_us&cs=utf- 8&cc=us&lang=all). Fr installatin and cnfiguratin infrmatin, see the IBM FileNet P8 Installatin and Upgrade Guide n the IBM supprt site. Refer t the fllwing tpics: Cnfigure an Applicatin Server fr Cntent Engine (WebSphere) and Cnfigure Cntent Engine Applicatin Server Database Cnnectivity (WebSphere 6.1.x). Cntent Engine als supprts the federated user repsitry feature f WebSphere 6.1.x, which prvides multiple authenticatin realms. Fr infrmatin, see the IBM FileNet P8 Installatin and Upgrade Guide tpic Cnfigure an Applicatin Server fr Cntent Engine (WebSphere) > T use WebSphere 6.1 federated user repsitry. Platfrm supprt Supprt fr JBss applicatin server Installatin and cnfiguratin f JBss fr Cntent Engine is dcumented in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide. Cpyright IBM Crp. 2002,

32 IBM FileNet P Release Ntes What s New in P and Prcess Engine Backward Cmpatibility Nte: If yu want t run a Cntent Java API applicatin in the JBss envirnment, and if that applicatin executes batch peratins in a transactin, then yu must set JBss JNP-related prperties in the Java Virtual Machine. Fr details, see the descriptin f the startbatch methd n the Sessin interface in the Javadc cmments f the Cntent Java API Cmpatibility Layer nline help. (Nte that this nline help is available using the FileNet P8 4.0.x Cmpatibility Layers fr Cntent Engine APIs Help zip file.) The infrmatin is als included belw. T execute a batch as a transactin in the JBss envirnment, yu must set the fllwing Java VM arguments: -Djava.naming.factry.initial=rg.jnp.interfaces.NamingCntextFactry -Djava.naming.factry.url.pkgs=rg.jbss.naming:rg.jnp.interfaces -Djava.naming.prvider.url=jnp://<hst name>:<prt> D nt set the abve prperties using the TxJndiPrperties ptin in the WcmApiCnfig.prperties cnfiguratin file. Ding s can result in Culd nt begin transactin r Culd nt instantiate class exceptins. Supprt fr DB2 9.x database platfrm. Supprt fr multiple instances f Cntent Engine deplyed n the same applicatin server. Installatin and cnfiguratin infrmatin is dcumented in the fllwing tpic in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide: Deply Multiple Cntent Engine Instances. Installatin and Upgrade Additinal Cntent Engine cmpnents can be installed frm the baseline installatin sftware package after Cntent Engine fix packs and interim fixes have been applied. Fr mre infrmatin, see the fllwing tpics in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide: Install Enterprise Manager Install and Deply Cntent Engine Upgrades f Cntent Engine t versin are supprted directly frm as well as frm Fr mre infrmatin, see the fllwing tpic in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide: Upgrade Cntent Engine Data. When using the Micrsft Windws Active Directry service, either the Cntent Engine Directry Service User accunt r the #AUTHENTICATED-USERS grup must be added as a member f the Pre-Windws 2000 Cmpatible Access grup in each dmain cnfigured in FileNet Enterprise Manager. Failure t d s can result in functinal errrs in security. Nte In releases prir t fix pack P8CE , adding the Cntent Engine Directry Service User accunt t the grup was technically ptinal, althugh it is stated as required in the dcumentatin. It is imperative t perfrm this task prir t upgrading t fix pack level P8CE Failure t d s befre an upgrade can lead t missing security functinality, such as users lss f security permissins that were cnfigured prir t the upgrade Enterprise Manager In additin t the Enterprise Manager enhancements mentined earlier in this dcument, Enterprise Manager includes the fllwing imprvements: The Test Cnnectin buttn has been remved frm the Fixed Cntent Device Prperties General tab. The functinality prvided by this buttn is available thrugh the Apply buttn. Cpyright IBM Crp. 2002,

33 IBM FileNet P Release Ntes What s New in P and Prcess Engine Enterprise Manager s list f cnfigurable fixed cntent devices nw includes Federated Device (IBM WebSphere IICE). This new device ptin has been added t supprt Cntent Federatin Services fr IICE (CFS-IICE). The cntext menu fr the Virtual Server and Server Instance ndes nw cntains a Delete cmmand. Frm the Sites nde, right-click the Virtual Server r Server Instance nde and then select Delete frm the cntext menu. Yu can als delete a nde by using the Actins menu r by selecting the nde and clicking n the Delete icn in the tl bar. When mapping Image Services (IS) dates in the prperty mapping dialg, Enterprise Manager nw displays bth Cntent Engine DateTime and String prperties when an IS date is selected, allwing the user t map an IS date t either a Cntent Engine DateTime r String value. Fr a String value, the CFS-IS Imprt Agent frmats the date t yyyy-mm-dd, which cnfrms t the Internet date standard and ISO8601. Fr mapping infrmatin, see the fllwing nline help tpic: FileNet P8 Administratin > Cntent Engine Administratin > Cntent Strage > Fixed strage areas > Hw T > Map IS prperties > Add/Edit Image Services Prperty Mapping dialg bx. Develpment Tls Wrkplace Applicatin Integratin Tlkit Deprecatins The Java transprt and uplad servlets in the Applicatin Integratin Tlkit have been deprecated. Fr new develpment, use the Cntent Engine Java API, the Cntent Engine.NET API, r the Cntent Engine Web Service (CEWS) instead. Prcess Engine Java API VWSchema class A new getfilename() methd has been added t the VWSchema class. This methd returns the name f the file used in the design-time schema. Fr run-time schemas, the return value is nn-null nly if the design-time schema cntained the name f a schema file instead f a schema. At run-time, the Prcess Engine server expands the schema t the cntents f the file; hwever, sme run-time applicatins will need t knw the name f the file. Fr mre infrmatin, see the Prcess Java API reference help fr the VWSchema class (Develper Help > Prcess Engine Develpment > Prcess Java API Reference). VWSystemCnfiguratin.cmmit Depending n yur applicatin and the calls yu are making, yu might need t adjust the client timeut value in yur Java initiatin statement befre calling this methd. Fr example, under Sun Slaris r using the Sun JVM, yu might need t adjust the timeut value in the Java initiatin statement as fllws: -Dcm.sun.CORBA.transprt.ORBTCPReadTimeuts=100:15000:300:5 Fr mre infrmatin, refer t the descriptin f VWSystemCnfiguratin.cmmit in the Prcess Java API reference help (IBM FileNet P8 Dcumentatin > Develper Help > Prcess Engine Develpment > Prcess Java API Reference). Date/Time Supprt A new VWFieldType attribute, FIELD_TYPEDEF_TIME64, has been created t supprt date/time values beynd the year This attribute is based n a 64-bit representatin, and shuld be used fr the creatin f all date/time values. The VWFieldType date/time attribute, FIELD_TYPE_TIME, cntinues t be supprted, but des nt allw fr the creatin f date/time values beynd the year Cpyright IBM Crp. 2002,

34 IBM FileNet P Release Ntes What s New in P and Prcess Engine The VWFieldType date/time attribute, FIELD_TYPEDEF_TIME32, has been deprecated. This attribute des nt allw date/time values beynd the year Pay particular attentin t the date/time supprt changes when using the fllwing methds: VWQueue.createQuery, VWRster.createQuery, and VWLg.startQuery The date/time clumns in the database can be expsed as either 32-bit (can nly supprt dates earlier than 2038) r 64-bit (can supprt dates beynd 2038). If a user has a filter n a 32-bit time field, the value bund t the bind variable in the query using that filter must be a value that can fit in 32 bits: therwise the query will nt return the expected result. VWDataField.getStringValue Returned date/time values are frmatted as defined in VWFieldType.TIME_MASK. Prir releases used a lng frmat (fr example, Sun Apr 17 04:00:00 PST 1977 ). If yu want t cntinue returning date/time values in a lng frmat, yu can use cde similar t the fllwing: if (vwdatafield.gettype == VWFieldType.FIELD_TYPEDEF_TIME32 vwdatafield.gettype == VWFieldType.FIELD_TYPEDEF_TIME64) { Object fieldvalue = vwdatafield.getvalue(); //java.util.date if (fieldvalue!= null) { if (vwdatafield.isarray()) stringvalue = fieldvalue.tstring(); //lng frmat else { stringvalue = "{"; fr (int nindex = 0; nindex < vwdatafield.length; nindex++) { stringvalue += "\"" + fieldvalue.tstring() + "\""; } stringvalue += "}"; } } } Fr mre infrmatin, refer t the relevant class members in the Prcess Java API reference help (IBM FileNet P8 Dcumentatin > Develper Help > Prcess Engine Develpment > Prcess Java API Reference). Deprecatins The fllwing class and methds have been deprecated as f this release: VWStatistics VWQueue.fetchStatistics VWRster.fetchStatistics Prcess Engine Web Services New peratins have been added t Prcess Engine Web Services. The fllwing peratins were added t prvide WSI cmpliancy: getqueueswrapped Cpyright IBM Crp. 2002,

35 IBM FileNet P Release Ntes What s New in P and Prcess Engine getrsternameswrapped getwrkclassnameswrapped The fllwing peratins were added t supprt hetergeneus bjects (an array f Values) fr substitutin variables: getqueueelementsex getrsterelementex getstepelementsfrmrsterex getstepelementsfrmqueueex Fr mre infrmatin, refer t the Prcess Engine Web Services Reference dcumentatin (IBM FileNet P8 Dcumentatin > Develper Help > Prcess Engine Develpment > Develper s Guide > Web Services > Reference). Cntent Engine Java and.net APIs The PStre Tl has been added t this versin f the Cntent Engine. Fr a client applicatin using the Cntent Engine Web Service transprt t pen a TSL r SSL cnnectin (HTTPS) with a server, the client must psses the server's public key, which is distributed in the frm f a PKI certificate. PKI certificates are nrmally stred in a key stre, frm which a client applicatin can retrieve them fr use in establishing an SSL cnnectin. Hwever, because the Cntent Engine Java API uses Systinet libraries t pen HTTPS cnnectins, its PKI certificates must be lcated in a Systinet prtected key stre. Therefre, t cnfigure a remte Cntent Engine Java API client t run ver SSL, yu must add the server's certificate t a Systinet prtected key stre by using the PStre Tl. The PStre Tl allws yu t manipulate data in a Systinet prtected stre, which cntains the user stre and the key stre. Using the PStre Tl, yu can add, edit, and remve any user prperties in the user stre; r add, edit, and remve certificates and identities in the key stre. The fllwing steps describe hw t use the PStre Tl t add the server's SSL cnnectin PKI certificate t a Systinet prtected key stre: 1. Verify that the JAVA_HOME envirnment variable is set in yur perating system. 2. In Windws, pen a Cmmand Prmpt windw r, in Unix, pen a Terminal windw. 3. In the Cmmand Prmpt r Terminal windw, change the directry t %WASP_HOME%\bin (fr example, C:\Prgram Files\FileNet\CntentEngine\wsi). 4. Enter the fllwing cmmand: PStreTl --gui. 5. Frm the PStre menu, select Open Frm File, navigate t %WASP_HOME%\cnf, then select the key stre file: clientcnf.xml. 6. Frm the Key Stre menu, select Imprt Alias. Frm the dialg, select Type and specify TRUSTED_CERTIFICATE_ENTRY. 7. Click Lad Certificate Chain, then select the certificate file. Click OK. 8. Clse the PStre Tl. References t the PermissinSurce.MARKING and PermissinSurce.MARKING_AS_INT cnstants, which were deprecated in the release, are nw remved frm the PermissinSurce prperty descriptin in the nline reference help. A new cnstant, CnfiguratinParameter.EJB_CONTEXT_PROPERTIES is added t the Java API. This new cnstant prvides the ability t cnfigure the Java Naming and Directry Interface (JNDI) service envirnment fr InitialCntext. The new cnstant is used fr EJB-related lkups Cpyright IBM Crp. 2002,

36 IBM FileNet P Release Ntes What s New in P and Prcess Engine and applicatin server type detectin in a multi-jndi directry envirnment. Yu can use the cnstant t verride the default envirnment fr the java.naming.initialcntext that is used t lcate the internal EJB used by the Java API EJB transprt. Yu can supply different prperties fr every InitialCntext instance. Fr usage infrmatin, see the descriptin f api.cnstants.cnfiguratinparameter.ejb_context_properties in the Java reference help (IBM FileNet P8 Dcumentatin > Develper Help > Cntent Engine Develpment > Java API Reference). New cde samples illustrating the use f the Cntent Engine Java and.net APIs are psted t the Prduct Dcumentatin fr FileNet P8 Platfrm web page ( 1.ibm.cm/supprt/dcview.wss?rs=3273&uid=swg ). Yu can dwnlad the samples frm the FileNet P8 Platfrm Develper Samples table. Bth Java and C# versins are available fr each f the fllwing samples: Dem demnstrates the fllwing peratins: Cnfiguring the server Creating a dcument Getting a dcument Creating a flder Creating a custm bject Getting a custm bject Creating a cmpund dcument Getting a cmpund dcument Creating an ad-hc query Flder Brwser demnstrates the fllwing peratins: Cnfiguring the server Retrieving the cntents f a flder Bulk Lader demnstrates the fllwing peratins: Cnfiguring the server Bulk dcument ingestin Dcumentatin Cntent Engine API Dcumentatin The IBM FileNet P8 Cntent Engine Java and.net API Develper s Guide nw cntains the fllwing new sectins: Object Stres Chice Lists Dcuments Versining Custm Objects These new sectins prvide bth cnceptual infrmatin and cde examples. Fr mre infrmatin, see the guide (IBM FileNet P8 Dcumentatin > Develper Help > Cntent Engine Develpment > Java and.net Develper's Guide). Cpyright IBM Crp. 2002,

37 IBM FileNet P Release Ntes What s New in P and Prcess Engine New interfaces New classes, interfaces, and prperties have been added t supprt Cntent Federatin Services fr IICE (CFS-IICE) as a fixed cntent device. See the reference help fr the IICEFixedCntentDevice interface (Java) and IIICEFixedCntentDevice interface (C#). Nte Althugh this versin f Cntent Engine prvides this supprt, yu cannt use these APIs until the next release f Cntent Federatin Services fr IICE (CFS-IICE) becmes available. New interfaces and prperties have been added t supprt the versin series federatin mdel. See the reference help fr the CFSImprtAgentCnfiguratin interface (Java) and ICFSImprtAgentCnfiguratin interface (C#). Security and authenticatin The Versinable interface has a new SecurityFlder prperty t identify a flder frm which the bject inherits security. (Bth the Dcument and CustmObject classes implement Versinable.) This prperty supprts the new dynamic security inheritance mdel intrduced in this release, and is used in cnjunctin with the new SecurityPrxyType.INHERITANCE setting and the Permissin.InheritableDepth prperty. The effective permissins f a given bject will be cmputed dynamically, based n a cmbinatin f the bject s access cntrl entries, the inheritable access cntrl entries f the parent bject, and the inheritable depth specified fr the parent bject. Backward Cmpatibility Nte: The SecurityParent prperty n the Dcument and CustmObject classes has been deprecated. If the SecurityParent prperty is set (by an existing applicatin, fr example), the SecurityFlder prperty is assigned the value f the SecurityParent prperty. When upgrading t this release, nte the fllwing: Objects with the SecurityParent prperty set use the tail (Flder) f the SecurityParent ReferentialCntainmentRelatinship bject t set the SecurityFlder prperty t the SecurityParent value. Any access cntrl entries in the bject that were persisted in the bject s ACL with a surce type f PARENT are remved. Objects having superseded versins that d nt have a SecurityParent prperty set will have a SecurityFlder prperty set t the SecurityParent prperty value fr the versin that had a security parent. The SecurityPrxyType cnstant class has a new INHERITANCE setting t indicate that the security is inherited frm a parent bject. By assigning SecurityPrxyType.INHERITANCE values t mre than ne bject-valued prperty n a given bject, yu can specify multiple security parents fr an bject. The resulting security descriptr fr the bject is calculated dynamically by merging the inheritable access cntrl entries f the different security parents with the child bject s persisted access cntrl entries. Fr mre infrmatin, see Develper Help > Cntent Engine Develpment > Java and.net Develper s Guide > Security Cncepts > Security Inheritance. In supprt f the new Micrsft Active Directry Applicatin Mde (ADAM) directry service prvider, tw new classes are available: DirectryCnfiguratinAdam and DirectinCnfiguratinAdamList. In additin, the fllwing prperties have been updated fr this supprt: GrupMembershipSearchFilter, GrupSearchFilter, UserSearchFilter. Fr mre infrmatin, see class and prperty descriptins in the Java API reference help and the.net API reference help. Prperties A new attribute, pagesize, has been added t prperty filters and filter elements. This new attribute allws yu t specify the iteratr page size fr independent bject sets returned by PrpertyIndependentObjectSet prperties. In cnnectin with this change, the fllwing changes have been made t the PrpertyFilter class: Cpyright IBM Crp. 2002,

38 IBM FileNet P Release Ntes What s New in P and Prcess Engine A new addincludeprperty methd has been added that requires an additinal parameter, pagesize. The existing addincludeprperty methd that it replaces has been deprecated. The existing addincludeprperty methd that requires a FilterElement bject remains unchanged. A new addincludetype methd has been added that requires an additinal parameter, pagesize. The existing addincludetype methd that it replaces has been deprecated. The existing addincludetype methd that requires a FilterElement bject remains unchanged. The fllwing changes have been made t the FilterElement class: Tw new FilterElement cnstructrs have been added that require an additinal parameter, pagesize. The tw existing FilterElement cnstructrs that they replace have been deprecated. A new methd, getpagesize, as been added. A new prperty, TempDirectryPath, has been added t the AutnmyIndexArea interface in supprt f cntent-based-retrieval (CBR) indexing enhancements. This new prperty specifies a remte path t the directry t be used fr string temprary indexing files. Fr mre infrmatin, see the prperty descriptin in the Java API reference help and the.net API reference help. Prcess Engine WebSphere Business Mnitr Integratin Yu can use the IBM WebSphere Business Mnitr t mnitr active IBM FileNet Business Prcess Manager (BPM) prcesses and mnitr the prcesses n a WebSphere Prcess Server. BPM sftware includes a CBE Adaptr, a basic BPM Mnitr Mdel, and sme basic dashbard views that yu can cnfigure and deply t the WebSphere Applicatin server and WebSphere Business Mnitr server. Fr mre infrmatin, see the fllwing nline help tpic: FileNet P8 Administratin > Prcess Engine Administratin > Wrkflw Administratin tasks > Analyze wrkflws > WebSphere Business Mnitr integratin. WebSphere Business Mdeler Integratin Custmers can mdel a business prcess using WebSphere Business Mdeler (WBI Mdeler), exprt the mdel t an XPDL 2.0 file, and pen the mdel in Prcess Designer. IBM FileNet P8 BPM supprts pening XPDL files exprted frm WBI Mdeler: Schema files can cntain external references imprt, include, and redefine. The external references must be relative t the schema file lcatin n the Prcess Engine server. There is n change in the interface in Prcess Designer. Fr details, see the nline help in the Wrkplace > Advanced Authr Tls > Prcess Designer > Wrkflw Prperties > Web Services > XML Schema tpic. XML data fields can be arrays. In Prcess Designer, the Wrkflw Prperties > Web Services > XML Data Fields dialg bx has a new Array ptin fr each field, and yu can specify values fr each element in the new Edit Array Fields dialg bx. Fr infrmatin, see the nline help in the Wrkplace > Advanced Authr Tls > Prcess Designer > Wrkflw Prperties > Web Services > XML Data fields tpic. Imprted mdels can reference an Interface-nly WSDL definitin. Althugh Prcess Designer can pen mdels that reference a WSDL file that des nt define a SOAP binding, the binding infrmatin must be cmplete befre the wrkflw definitin can be transferred. WebSphere Services Registry and Repsitry (WSRR) Integratin T imprve integratin between FileNet P8 BPM and WebSphere Prcess Server technlgy, Prcess Cnfiguratin Cnsle and Prcess Designer supprt interfaces with WSRR. Cpyright IBM Crp. 2002,

39 IBM FileNet P Release Ntes What s New in P and Prcess Engine Prcess Cnfiguratin Cnsle supprts publishing prcesses in WSRR and discvering Web Services frm these registries. Fr details, see the fllwing nline help tpic: Wrkplace > Admin Tls > Prcess Cnfiguratin Cnsle > Islated regins > View r mdify islated regin prperties > Web Services WSRR registries. Prcess Designer supprts brwsing WSRR, creating a partner link, and invking steps based n bth design-time WSDL and runtime WSDL. See the fllwing nline help tpic: Wrkplace > Advanced Authr Tls > Prcess Designer > Wrkflw Prperties > Web Services > Partner Link. Platfrm Supprt Supprt fr JBss applicatin server. Installatin and cnfiguratin f JBss fr Prcess Engine is dcumented in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide. Supprt fr DB2 9.x database platfrm. Prcess Designer Wrkflw validatin nw checks Web Services Partner Links fr invke steps t ensure a valid SOAP binding in the WSDL. Previus versins allwed a wrkflw t be transferred with an incmplete partner link fr an invke step, even thugh that wrkflw culd nt run successfully. Sme wrkflw authrs used this behavir as a shrtcut in creating wrkflws that invke each ther. T cntinue t use the previus behavir, yu can set User Preferences t nt validate n Transfer f the wrkflw. Fr a prcedure that creates wrkflws that invke each ther, see the fllwing nline help tpic: Wrkplace > Advanced Authr Tls > Prcess Designer > Steps > System Steps > Web Services system functins > Using Web Services in FileNet wrkflws > Crrelatin set example. Yu can nw mdel a business prcess using WebSphere Business Mdeler, exprt the mdel t an XPDL 2.0 file, and pen the mdel in Prcess Designer. Schema files can cntain external references imprt, include, and redefine. The external references must be relative t the schema file lcatin n the Prcess Engine server. There is n change in the interface in Prcess Designer. Fr details, see the fllwing nline help tpic: Wrkplace > Advanced Authr Tls > Prcess Designer > Wrkflw Prperties > Web Services > XML Schema. XML data fields can be arrays. In Prcess Designer, the Wrkflw Prperties > Web Services > XML Data Fields dialg bx has a new Array ptin fr each field, and yu can specify values fr each element in the new Edit Array Fields dialg bx. Fr infrmatin, see the fllwing nline help tpic: Wrkplace > Advanced Authr Tls > Prcess Designer > Wrkflw Prperties > Web Services > XML Data fields. Imprted mdels can reference an Interface-nly WSDL definitin. Althugh Prcess Designer can pen mdels that reference a WSDL file that des nt define a SOAP binding, the binding infrmatin must be cmplete befre the wrkflw definitin can be transferred. Applicatin Engine Platfrm supprt Supprt fr JBss applicatin server Installatin and cnfiguratin f JBss fr Applicatin Engine is dcumented in the IBM FileNet P8 Installatin and Upgrade Guide. Supprt fr JRE 1.6. Cpyright IBM Crp. 2002,

40 IBM FileNet P Release Ntes What s New in P and Prcess Engine Applicatin Engine/Wrkplace supprts JRE 1.6 fr running Java applets such as Prcess Designer, Search Designer, and Image Viewer. See the Release Ntes -> Knwn Issues dcument regarding Image Viewer and JRE 1.6. Installatin and Upgrade In additin t being able t run n a clean machine fr a full installatin, Applicatin Engine installatin prgram enhancements nw allw upgrading f bth 3.5.x and 4.0.x Applicatin Engine installatins. Wrkplace enhancements Lgging is enhanced. Errr lgging has been added t Applicatin Engine Wrkplace in The lg4j prduct is used as the central lgger. Lgging is enabled by default. All Wrkplace errrs and exceptins are nw written t a human-readable lg. In additin, they are written in Cmmn Base Event (CBE) frmat t a secnd lg, which is cnsumable by IBM diagnstic tls fr ff-line analysis. Currently, there is n FileNet P8 dcumentatin available fr this feature. Supprt fr Wrkplace Timezne detectin applet. Thrugh a new parameter, useenhancedtimeznedetectin, in the btstrap.prperties file, yu nw have the ptin t use a Java Applet t reliably retrieve time zne infrmatin frm the brwser. Fr mre infrmatin, see the fllwing nline help tpic: FileNet P8 Administratin > Applicatin Engine Administratin > Key cnfiguratin files and lgs > Btstrap.prperties. IBM FileNet Wrkplace XT New features Drag and drp dcuments Drag dcuments frm yur lcal wrkstatin and add them t Wrkplace XT by drpping them directly in an bject stre r flder. Drag and drp dcuments frm within Wrkplace XT t mve and file flders and dcuments. Search templates and stred searches The imprved visual layut f a search template prvides quick identificatin f the search lgic. Search templates are nw accessible frm the tree view. Summaries frm cntent-based searches are displayed as a secnd rw in the list view fr bth stred searches and search templates. Dcumentatin The Wrkplace and Wrkplace XT help systems are nw cmbined and rerganized. Bi-directinal languages Lgin, Brwse and Search cntain user interface mirrring fr bi-directinal language supprt. Cpyright IBM Crp. 2002,

41 File Tracker IBM FileNet P Release Ntes What s New in P and Prcess Engine File Tracker is supprted and tracks a dcument n yur lcal machine after yu check it ut frm an bject stre. Additinal site preference ptins fr File Tracker are nw available fr New, Save and Open. Recrds Management Wrkplace XT is nw certified with Recrds Management. See the Cmpatibility and Dependency Matrix fr specific versin requirements. Wrkplace XT is enhanced t visually distinguish dcuments declared as recrds. efrms The new Date Time feature in efrms extends the current Date frmat t als supprt time. This allws efrms t present a mment in time and map the value t bth the standard XML date-time data frmat as well as t the cmbined date-time P8 data type. The bi-directinal mapping f clumn values prvides the ability fr tw-way mapping between the frm table clumn values and wrkflw multi-value arrays. Platfrm supprt Wrkplace XT nw supprts the JBss applicatin server. efrms New DateTime data type. In earlier releases, efrms and FileNet P8 used different data types fr representing dates and time. efrms nw prvides a cmbined date-time data type that represents a lcaleindependent mment in time. It includes date and time prperties (year, mnth, day, hur, minute, secnd), and adjusts autmatically fr the time zne f the user. Previus date and time data types are still fully supprted. The fllwing are brief descriptins f the supprted date/time data types: Date: A calendar date; user s time zne is nt relevant; always shws a cnstant value. Time: The time f day; the user s time zne is nt relevant; always shws a cnstant value. DateTime: A mment in time, independent f time zne; adjusts t shw the same mment in any user s time zne (fr example, 2 PM CST / 3 PM EST). The DateTime data type maps seamlessly with ther FileNet P8 cntent, such as DateTime values in a wrkflw r prperties f a dcument. A cmmn DateTime data type is useful fr direct reprting f infrmatin and t knw when smething happened (such as when a custmer requested service). Sharing a cmmn DateTime data type als facilitates timebased calculatins (fr example, Tday and Nw). Bidirectinal mapping f multi-value cells (table clumns). Yu can nw map multi-value FileNet P8 prperties int frm cells as well as frm cells f a frm int FileNet P8 bject prperties. When wrking with wrkflws, bidirectinal mapping f multivalue cells means that yu can use frms t ppulate a list f values generated by a wrkflw int a frm. It als means that wrkflw data fields can be ppulated frm a frm. This ability prvides enhanced supprt fr the tw main uses fr mapping: The frm is just the frnt end t the wrkflw data fields and the frm data is never saved at all (that is, n entry template is assigned). Cpyright IBM Crp. 2002,

42 IBM FileNet P Release Ntes What s New in P and Prcess Engine The data frm the frm is used in wrkflw lgic (fr example, if amunt is greater than x then take this rute ). Direct mapping f template cells t wrkflw participants. This new feature allws yu t directly map user IDs captured by a frm t FileNet P8 wrkgrup participants. Infrmatin cllected by frms that use this mapping capability is useful in ruting wrkflw tasks t wrkflw participants. efrms Java and JavaScript APIs The DateTimeDetail class has been added t the efrms Java and JavaScript APIs. This class enables yu t stre and retrieve a date-and-time value that cnsists f the year, mnth, day, hur, minute, and secnd. The fllwing changes have been made in bth APIs t supprt DateTimeDetail bjects: The Value class cnstructr has been verladed t supprt a DateTimeDetail input argument. The DateTime cnstant has been added t the FrmatTime enum t indicate that a cell cntains a date and time. The DateTime cnstant has been added t the ValueType enum t indicate that a Value bject cntains a date and time. The parsedatetime, parsecannicaldatetime, isdatetime, tdatetime, asdatetime methds, which are used t manipulate date and time values, have been added t the Value class. In additin t supprt fr the new DateTimeDetail class, the fllwing methds have been added in this release: The validate methd has been added t the Frm class in the Java and JavaScript APIs. This methd checks a frm fr invalid r missing data. The cmmit methd has been added t the Frm class in the JavaScript API. This methd cmmits the value f the current cell. Fr mre infrmatin, refer t the efrms Java API reference help and the efrms JavaScript API reference help (lcated under Develper Help > efrms Develpment). Renditin Engine Supprt fr highly available Renditin Engines. Fr mre infrmatin, refer t the IBM FileNet P8 Platfrm High Availability Technical Ntice n the IBM supprt web site. Supprt fr MS SQL 2005 database platfrm. Dcumentatin Frm the IBM FileNet Installatin and User s Guide: Sme items in the "Planning Cnsideratins" tpic have been cnverted int prerequisite tasks, in rder t clarify which tasks an administratr needs t perfrm befre beginning a P8 install. A new task has been added fr redeplying Cntent Engine. This is a necessary step t perfrm after applying Prcess Engine client file updates t the Cntent Engine server. This infrmatin was previusly released in a readme file. The prcedure fr installing r updating Prcess Engine Client files is nw included in separate tasks fr Cntent Engine and Applicatin Engine. Cpyright IBM Crp. 2002,

43 IBM FileNet P Release Ntes What s New in P and Prcess Engine A new appendix has been added t prvide infrmatin abut installing Prcess Engine in a Slaris 10 znes envirnment. This infrmatin was previusly released as a technical ntice. The Hw T sectin f the Security help nw prvides instructins fr cnfiguring multiple lgin types. Fr details, see the fllwing nline help tpic: FileNet P8 Administratin > Enterprise-wide Administratin > FileNet P8 Security > Hw T > Cnfigure multiple authenticating attributes. The IBM FileNet P8 Cntent Engine Java and.net API Develper s Guide nw cntains the fllwing new sectins: Object Stres Chice Lists Dcuments Versining Custm Objects These new sectins, in additin t the Feature Add-ns and Publishing sectins added in Nvember 2007, prvide bth cnceptual infrmatin and cde examples. Fr mre infrmatin, see the guide (IBM FileNet P8 Dcumentatin > Develper Help > Cntent Engine Develpment > Java and.net Develper's Guide). Cpyright IBM Crp. 2002,

44 IBM FileNet P Release Ntes What s New in What s New in Cntent Engine As f the P8CE fix pack, the fllwing are new: DB2 is nw supprted as a database platfrm fr Cntent Engine n WebSphere Cntent Engine nw has a standalne Java client files setup prgram fr installatin n Applicatin Engine servers, Prcess Engine servers, and custm client machines. Cntent Engine is nw certified t scale beynd fur applicatin server instances, even when ingesting dcument bjects under heavy lad. Cntent Engine runs within a cntainer n a J2EE applicatin server residing n Windws r n supprted UNIX perating systems. Cntent Engine is installed/deplyed nce, n an applicatin server, and is deplyable t ther applicatin servers by using an enterprise archive (EAR) file. Cntent Engine uses a Java Database Cnnectivity (JDBC ) interface as its data prvider. The Glbal Cnfiguratin Data (GCD), stred in the lcal file system in previus FileNet P8 releases, is frmatted as an XML schema and stred in the database used by Cntent Engine. The Cntent Engine cntent cache, previusly cllcated with an bject stre service and using lcal disk space, can nw be shared amng several Cntent Engine servers by using a netwrked file share (accessible by using a LAN). The database t be used fr a Cntent bject stre must be predefined. It is n lnger an ptin t let the bject stre creatin wizard create the database, as was true in prir releases. The Java Authenticatin and Authrizatin (JAAS) framewrk, used fr authenticatin and single sign-n, is integrated int FileNet P8. The cntent-based retrieval tl used with FileNet P8, Autnmy IDOL K2 (frmerly named Verity K2), can be installed with FileNet P8 cmpnents r by itself. The WebDAV prvider in Cntent Engine, previusly based n Micrsft Infrmatin Internet Services (IIS), is nw Java-based and resides n the Applicatin Engine hst. T minimize system dwn time, it is pssible t upgrade selected (rather than all) FileNet P8 cmpnents t versins newer than (that is, a rlling upgrade). FileNet P8 sftware upgrades can skip versins. Fr example, yu can upgrade frm versin 3.5.x t 4.1.0, skipping versin FileNet P8 cmpnents can be silently uninstalled. T facilitate trubleshting, all FileNet P8 cmpnents maintain their install/upgrade lgs in a cmmn (cnfigurable) lcatin. All lgins are dne thrugh Java Authenticatin and Authrizatin Service (JAAS). FileNet P8 leverages JAAS fr authenticatin, which is a prcess that ccurs between a J2EE client applicatin, a J2EE applicatin server, and ne r mre JAAS Lgin Mdules. Cntent Engine's ability t leverage JAAS-based authenticatin means that if a single sign-n (SSO) prvider writes a JAAS LginMdule fr a supprted applicatin server, then clients f FileNet P8 applicatins hsted in that applicatin server can leverage that SSO slutin. Cmpund dcuments are nw supprted. A cmpund dcument is similar t a cntainer that hlds dcument bjects tgether, and enables them t be referenced using links. These dcuments enable Cpyright IBM Crp. 2002,

45 IBM FileNet P Release Ntes What s New in rganizatins t perfrm independent mdificatins t varius cmpnents, reuse cmpnents in ther dcuments, save time, and enhance dcument quality and integrity. GUI functinality within Enterprise Manager has been cnslidated t the Trace Cntrl tab. A new cmmand line exprt/imprt tl is available t exprt and imprt data independently f the Enterprise Manager applicatin. Windws scripting has been replaced with Java classes fr event and lifecycle actins. Using Enterprise Manager, yu can nw d the fllwing: Create, mnitr, cnfigure, and display the status f Renditin Engine cnnectins. Cnfigure publishing data that is stred in the GCD. Create and manage cnnectin pints and islated regins Yu can use Kerbers fr SSO authenticatin (als knwn as integrated lgn ) between Enterprise Manager and Cntent Engine, prvided yu use Windws Active Directry as yur directry server. Authrizatin in FileNet P8 Platfrm is prvided by the fllwing supprted directry servers: Micrsft Windws Active Directry - nw supprting multi frest authenticatin Nvell edirectry Sun Java System Directry Server IBM Tivli Directry Server In FileNet P8, authenticatin (lgn security) is separate frm authrizatin (bject and prcess security). Thus, yu must cnfigure yur JAAS lgin n the Cntent Engine applicatin server s that any user r grup that can successfully authenticate t access (lg nt) FileNet P8 resurces can als be authrized t wrk within FileNet P8 interfaces, using a Cntent Engine directry service prvider's cnnectin. Prcess Engine delegates its authenticatin t JAAS and the J2EE applicatin server that hsts the Cntent Engine. As f the FileNet P8 Platfrm release, Prcess Engine n lnger has a direct cnnectin t a directry server fr authenticatin purpses, as it did in earlier releases. Instead, it delegates authenticatin tasks t JAAS. As part f Prcess Engine authenticatin, the Prcess Engine then calls int the Cntent Engine, at which pint the J2EE applicatin server hsting the Cntent Engine validates the Prcess Engine applicatin's JAAS credentials. The Prcess Engine calls int the Cntent Engine (rather than directly int the directry server) t get user and grup infrmatin as necessary. Yu can nw administer multiple FileNet P8 dmains frm a single instance f Enterprise Manager. In additin t being able t switch t anther dmain withut lgging ff Enterprise Manager, yu can create and lcally stre a list f frequently-used dmains by adding them t a list f precnfigured dmains that are presented at lgn when Enterprise Manager is first launched. Cntent cache areas have been enhanced, ffering the fllwing features: Shared cache: Cntent Engine cntent cache can be shared by multiple servers. All clients indirectly share the same cache. Security settings: Cntent caching uses the same security as that f the dmain. Disk space management: Least recently accessed dcuments are remved frm cache n a scheduled basis. Prelad cntent when created: Yu can cnfigure the cntent cache t autmatically lad cntent when it is checked in. Cpyright IBM Crp. 2002,

46 IBM FileNet P Release Ntes What s New in Prcess Analyzer New dimensin, cube, and reprts: A new User dimensin in the Wrk In Prgress cube allws the end user t view the activities that are currently assigned t each user. A new Ruting cube with tw Out f the Bx (OOTB) measures, Rute Cunt and Rute Percentage, is available. The Ruting cube cntains three OOTB dimensins: Time, User, and Rute. New analytical reprts allw a user t identify the number f wrk items taking a given rute between tw cnnected steps in a wrkflw. Yu can imprve perfrmance by increasing the number f Publisher threads, and by specifying maximum caching ptins in Prcess Task Manager. Prcess Engine Prcess Engine architecture changes Authenticatin Directry service functinality is accessed by using Cntent Engine. Cntent Engine supprts several LDAP prviders and single-sign-n (SSO) functinality. This pass-thrugh apprach simplifies directry services cnfiguratin by centralizing it fr bth Cntent Engine and Prcess Engine. Yu cnfigure the directry service indirectly by cnfiguring the cnnectin t Cntent Engine using Prcess Task Manager. Perfrmance Prcess Engine (PE) has been re-architected using CORBA ORB fr cmmunicatins between the Prcess Engine API and the Prcess Engine server, and between the Prcess Engine server and the Cntent Engine (CE) server. ORB prvides tw-way cmmunicatin between the Prcess Engine server and the Prcess Engine API. Cnnectin pints replace Prcess Ruters. Cnnectin pints are cnfigured using Enterprise Manager, and are stred in the Cntent Engine GCD. Unlike Prcess Ruters, cnnectin pints are nt a prcess running n a FileNet P8 cmpnent. Cnnectin pints require that yu define matching passwrds in Prcess Task Manager and Enterprise Manager. The Prcess Engine Brker replaces the PPM. The Prcess Engine Brker is stpped and started autmatically with the Prcess Engine server prcess; it is nt administered separately. The VWKs prcess replaces VWJs. Scalability Prcess Engine servers can run with a lad balancer in a farmed envirnment t increase prcessing capacity and achieve high availability perfrmance. Yu use Prcess Task Manager t cnfigure and manage Prcess Engine servers and the assciated lad balancers. Servers can be added t the farm r remved frm the farm while the servers in the Prcess Engine farm are running. Servers can be started and stpped frm any server in the farm. Mst f the vwserver.ini cnfiguratin prperties are nw stred in the Prcess Engine database, where they can be accessed by all servers in the farm. Cpyright IBM Crp. 2002,

47 IBM FileNet P Release Ntes What s New in Statistics functinality is nt supprted fr farmed Prcess Engine systems. Yu can view statistics using the ptinal Prcess Analyzer. Prcess Orchestratin UDDI registries Supprt is added in Prcess Cnfiguratin Cnsle fr publishing and managing business infrmatin and web services in UDDI registries. A new ptin has been added t enable a UDDI-style repsitry in an islated regin t manage web services. Web Services Reliable Messaging New functinality is added t supprt the WS-ReliableMessaging specificatin fr web services. The WS-ReliableMessaging prtcl guarantees the successful transmissin f messages frm a surce t a destinatin, and ensures that errr cnditins are detectable. Web services in FileNet P8 4.0 wrkflws supprt bth standard messaging and WS-Reliable Messaging. XPDL supprt New functinality in Prcess Designer t pen, mdify and save prcess mdeling dcuments in XPDL 2.0 frmat. This enables a business analyst t create a prcess diagram in a diagramming applicatin that supprts Business Prcess Mdeling Ntatin (BPMN), and a wrkflw authr t pen and enhance the diagram t create an executable wrkflw. Prcess Designer has new wrkflw cllectin ptins t supprt multiple prcesses that culd be present in an XPDL file, including ptins fr specifying which wrkflws t transfer t the Prcess Engine database, and which wrkflws t launch. Prcess Simulatr is enhanced t pen prcess mdels in XPDL 2.0 frmat. New Text Anntatin and Assciatin bjects in Prcess Designer Text Anntatin bjects can be added t the wrkflw map and can be assciated with any step r rute using an Assciatin bject. The text bx is a predefined size that displays text entered in the prperty pane. The user can shw r hide the anntatins using the map cntrls. Miscellaneus Multilingual ptins fr Prcess applicatins Language packs ( ntificatin templates) prvide language-specific ntificatin fr Prcess steps and Tracker bjects. Templates include language, date/time mask, and number frmat. ntificatin messages fr Prcess steps and Tracker bjects use the user's default lcale brwser preference. User-authred names and text display in the language f the current lcale. FileNet P8 applicatins, such as task pages, step prcessrs, Prcess Tracker, and Prcess Administratr display user-authred names and text in the language f the user's current lcale. Lcalized items include step and rute names, step instructins, respnse chices, field names, queue names, rster names, and map names. Prcess Cnfiguratin Cnsle prvides an ptin t exprt the user-authred text fr translatin using standard XLIFF tls. In the 3.5.x versin f Prcess Engine, it was necessary t install SQL Server client sftware n the Prcess Engine server t cmmunicate with a remte SQL Server database. In 4.0.0, a similar setup Cpyright IBM Crp. 2002,

48 IBM FileNet P Release Ntes What s New in (using a remte SQL Server database) requires installatin f the SQL Server client nly if yu plan t let the Prcess Engine setup prgram run the SQL scripts. If yu plan t run the scripts manually befre running Prcess Engine setup, yu d nt need t install SQL Server client sftware n the Prcess Engine server. Prcess Engine n UNIX platfrms nw requires a minimum f 64MB f disk space fr fn_sec_db0 (raw) was 12MB nw 64MB fn_sec_rl0 (raw) was 4MB nw 64MB Prcess Engine nw supprts silent installatins. Prcess Engine nw cnnects t a SQL Server database using an ODBC data surce. That data surce must be created befre installing Prcess Engine sftware. Prcess Engine installer creates several default users and grups. Yu can identify alternative names and passwrds as aliases fr thse users and grups when running Prcess Engine setup. Pre-installatin SQL scripts are nw needed fr SQL Server databases. These are in additin t the SQL pre-installatin scripts fr Oracle databases that existed in earlier releases. SQL scripts that have always been needed fr Oracle databases nw run nly during pre-installatin, nt pst-installatin. The ntifymsg cmmand has been added t vwtl This cmmand lists each language lcale supprted fr ntificatin, alng with its assciated applicatins and ntificatin templates. Rules supprt in prcesses Supprt is enhanced fr third-party rules sftware. Rules Cnnectivity Framewrk is enhanced fr third-party Rules sftware t prvide rules functinality in FileNet wrkflws. Prcess Engine installer n lnger installs ILg rules cnnectr. Installatin instructins and nline help fr specific Rules vendr (ILg) have been remved. The Rules Listener is cnfigured using Prcess Task Manager n the server where the rules sftware is installed. Prcess Simulatr Prcess Simulatr is enhanced t pen prcess mdels in XPDL 2.0 frmat. Prcess Simulatr nw supprts silent installatins. Prcess Task Manager Advanced Prcess Engine prperties are n lnger explicitly listed in Prcess Task Manager s Advanced tabs. The prperties can be added in a tabular frmat, and are dcumented in FileNet P8 Platfrm Prcess Task Manager Advanced Usage Technical Ntice. See Accessing IBM FileNet Dcumentatin. Cmpnent Manager Many previusly hidden startup and custmizatin parameters are nw available thrugh Prcess Task Manager, simplifying custmizatin and trubleshting. Yu can limit the queues prcessed by Cmpnent Manager by specifying ne r mre queues. Cpyright IBM Crp. 2002,

49 IBM FileNet P Release Ntes What s New in Applicatin Engine Wrkplace User Interface (UI) The fllwing list prvides a high-level summary f new features and functinality added t Wrkplace. Cmpund dcuments prvide the ability t link a cllectin f parent and child dcuments tgether t create a grup f linked dcuments. File Tracker tracks a dcument n the Wrkplace user s lcal machine after checking it ut frm an bject stre. Preferred lcale user preference is nw available fr tasks. This preference allws Wrkplace users t define the language in which ntificatins are displayed. Flder cntent caching might r might nt be enabled, depending n settings specified by the site administratr. Image Viewer features have been updated and added. Anntatin security has been updated fr Image Viewer. The QuickStart feature allws yu t start Image Viewer prir t actually using it. The site administratr can nw determine the maximum number f flders that can be displayed in Wrkplace. Wrkplace users can nw use ther dcument classes beside the dcument class r subclasses when adding using an entry template by way f Wrkplace Applicatin Integratin. Cntent Federatin Services fr Cntent Services (CFS-CS) and Cntent Federatin Services fr IICE (CFS-IICE) 4.0 Nte the fllwing infrmatin is available in cnjunctin with the P8CE fix pack. Cntent Federatin Services fr Cntent Services (CFS-CS) and Cntent Federatin Services fr IICE (CFS-IICE) are ptinal cmpnents f FileNet P8. Fr purpses f this help system, the generic term CFS will refer t bth f these versins f Cntent Federatin Services. Versin mirrring CFS supprts versin mirrring fr dcuments that are versined in the external repsitry. That is, if the external repsitry supprts dcument versining, then the federated dcument in the Cntent Engine (CE) bject stre cntains a reference t each f the versins in the external repsitry. When a scheduled federatin run detects a change t the versin series r t any mapped prperty f an external dcument, the versin series and prperties in Cntent Engine are updated. Fr external repsitries that d nt supprt versining, the federated dcument will always have nly ne versin. Full-text indexing (CBR) supprt Cntent Engine (CE) supprts full-text indexing f dcument cntent and prperty values fr use in searching, als knwn as cntent based retrieval (CBR). If the bject stre is cnfigured fr full-text indexing, federated dcument cntent can be searched in the same way as native Cntent Engine dcument cntent. Multi-valued prperty supprt Multi-valued prperties are supprted fr metadata mapping. A multi-valued prperty cntains mre than ne value. An update t a multi-valued prperty can be a change t a specific value in the prperty r t Cpyright IBM Crp. 2002,

50 IBM FileNet P Release Ntes What s New in the number f values. Fr example, a prperty with the entries Seattle and Ls Angeles culd be updated t Seattle, Ls Angeles, and Paris. Prperty updates in the external repsitry are prpagated t the federated dcument prperties. Cntent lckdwn supprt During federatin, any delete requests and lck dwn actins frm FileNet P8 applicatins are transferred t the external repsitry t prevent the external dcument frm being changed. Fr example, Recrds Manager (RM) retentin schedules can require that a federated dcument nt be deleted befre its dispsitin date. When a federated dcument is declared as a recrd, the lck dwn request frm RM is detected at the next federatin run. High availability supprt CFS is supprted fr high availability envirnments. See the IBM FileNet P8 High Availability Technical Ntice fr mre infrmatin. T dwnlad the IBM FileNet P8 High Availability Technical Ntice frm the IBM supprt page, see Accessing IBM FileNet Dcumentatin. Perfrmance enhancements CFS supprts tw methds fr imprved perfrmance when federating a large number f dcuments: chunking and sweeping. Chunking allws the queries defined in the Rule Builder t be brken dwn t smaller pieces fr prcessing. Sweeping allws nly the mdified dcuments t be federated after the initial federatin has ccurred. Dashbard System Manager Dashbard is renamed FileNet Dashbard. New archiving flags were added t the Archiving Manager. The Inf, Warning, Critical and Fatal messages are nw displayed in the Alerts view. P8 efrms Yu can dwnlad a frm plicy (take it ffline) if yu need t wrk with a new frm utside f Wrkplace. Yu can pen the frm plicy in Desktp efrms, fill in the frm, and save yur data. Later, yu can uplad the frm t Wrkplace. Frm authrs can nw add new buttns t the frm's tlbar. Fr example, the authr might add a buttn that a user clicks t pen a web page with instructins and infrmatin abut the rganizatin's plicies. Frm authrs can nw add new buttns in the bdy f the frm. Fr example, the authr might add a buttn that, when clicked, displays a different page n the frm and places the cursr in a specific cell. A JavaScript script can be included in a frm. This type f script can be used t custmize yur rganizatin's frms and imprve interactins between yu and the frms. Fr example, when yu click a cell, the script culd lk at sme f the data yu've entered n the frm and then make a different cell available fr yu t enter ther data. Chice lists are mre versatile. If the chice list desn't include the ptin yu want and if the frm allws it, yu can type yur value in the text field at the tp f the chice list bx. Yu can type the first few letters f the chice and the rest f the text is entered fr yu. The frm authr can add descriptive text t a list f chices. Cpyright IBM Crp. 2002,

51 Desktp efrms IBM FileNet P Release Ntes What s New in Yu can dwnlad a frm plicy if yu need t fill ut a new frm utside f Wrkplace. Yu can pen the frm plicy in Desktp efrms, fill in the frm, and save yur data t uplad the next time yu are cnnected t Wrkplace. Renditin Engine Renditin Engine installer/prcedure The Publishing Plug-in n the Cntent Engine servers has been remved. Yu must install database drivers fr the Renditin Engine database n each machine where Cntent Engine is deplyed. Yu can cnfigure Renditin Engine t use a different database vendr than the ne used by Cntent Engine bject stres (fr example, SQL Server fr Renditin Engine and Oracle fr Cntent Engine). Event actins must be written in Java. Prir t upgrading t and using Renditin Engine 4.0.0, yu must rewrite in Java any VBScript Event Actins that are used by publishing templates. Fr mre infrmatin, see the IBM FileNet Renditin Engine Installatin and Upgrade Guide. In Renditin Engine 4.0.0, publishing is cnfigured per site rather than per bject stre. Object stres that will be used fr publishing must be cnfigured with the Publishing add-ns. By default, these are added when yu create an bject stre. Custm stres that aren't cnfigured with these add-ns might exist. If necessary, yu can manually install the add-ns using Enterprise Manager. Develpment Tls FileNet System Manager Listener Java API Duratin Accumulatrs can be named using the DURATION cnstant f the Listener bject. This cnstant prvides a pre-defined String value f "duratin", which is the nly Accumulatr name f any special significance t FileNet Dashbard. Fr mre infrmatin, see Measuring Elapsed Time with Duratins, Naming in the IBM FileNet System Manager Listener Java API Develper s Guide. A pre-defined cnstant value can be passed t the recrdcustmmessage methd t indicate whether the cntent f the message is infrmatinal nly, a warning, r f a mre critical nature. Althugh a critical level can be specified, the System Manager des nt attempt t assign meaning t the Custm Message; it is cnsidered t be applicatin-specific. Fr mre infrmatin, see Recrding Custm Messages in the IBM FileNet System Manager Listener Java API Develper s Guide. A new facility is intrduced t aid in mnitring backgrund threads. The ThreadMnitr bject is created at the tp level f the Listener and is assciated with a backgrund thread. The bject enables a thread t autmatically check in with the System Manager accrding t a specified time interval. In additin, if the thread fails t check in, a mechanism is prvided fr bradcasting a custm message abut the thread. The new facility als prvides methds fr btaining the current interval value fr the thread, mdifying the interval, manually (versus autmatically) checking in with the System Manager, and disabling the thread mnitring. Fr mre infrmatin, see Tracking Backgrund Threads in the IBM FileNet System Manager Listener Java API Develper s Guide. Web Applicatin Tlkit Cmpund dcuments are nw supprted, including the ability t add a new cmpund dcument, cnvert an existing dcument, and establish a cmpnent link relatinship between a parent and child. This new feature yields changes in several areas, including new general site, bject stre site, and btstrap preference settings. Cpyright IBM Crp. 2002,

52 IBM FileNet P Release Ntes What s New in The new IBM FileNet P8 efrms Java API prvides develpers with the ability t access a Frm Data instance assciated with a given running Wrkflw. The API is built specifically fr scenaris in which custmers wuld like t repurpse the Frm Data generated frm a running Wrkflw and assciated Wrkflw Plicy. The API is packaged as cm.filenet.efrms.api in the <app_rt>/web- INF/lib/p8efrms.jar file and has n dependencies n any ther Wrkplace jar file. Cnfiguratin f Flder Cntent Caching has been implemented t prvide administratrs with the ability t define flder caching behavir, including turning caching cmpletely ff, r creating the cache, using it fr a perid f time, and then updating the cache by retrieving the flder cntent infrmatin frm Cntent Engine. The flder cntent cache is updated when the user repens the flder after the timeut interval expires, nt at the mment when the cache timeut interval expires. Therefre, if the user pens the flder and the sessin remains inactive fr a lng time, the timeut interval expires, but the flder cntent will remain unchanged. The cache is updated if the user exits frm the flder and then pens it again. The feature adds tw site preference settings: Use Flder Caching and Flder Cache Timeut Interval. JAAS (Java Authenticatin and Authrizatin Service) is nw ffered t prvide supprt fr cntainermanaged authenticatin, and represents enhancements t the existing applicatin-managed authenticatin features. JAAS facilitates integratin with third-party SSO prducts that integrate with J2EE/JAAS systems, such as Netegrity. Supprt fr JAAS cntainer-managed authenticatin includes mdificatins t the Web Applicatin Tlkit classes. Develpers shuld nte that Wrkplace des nt generate user tkens when using cntainer-managed authenticatin. Fr mre infrmatin, see Upgrading Custm Applicatins in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide. The new Wrkplace/WEB-INF/SitePreferencesPrimaryViews.xml descriptr file prvides the ability t cnfigure the primary views fr site preference settings displayed in the Wrkplace Site Preferences Tl. Administratrs are prvided with the ability t specify primary views fr site preference settings, rganize views int labeled grups, and prvide labels fr different lcales. In additin, develpers may create custm primary views fr site preference settings using the Web Applicatin Tlkit, which may als be further cnfigured thrugh the descriptr file. Fr mre infrmatin, see Custmizing Primary Views fr Site Preferences in the Wrkplace Custmizatin Guide. The intrductin f XLIFF files augments existing resurce bundle files t supprt the display f lcalized user-authred names in Wrkplace and ther Tlkit-based applicatins. Wrkplace expses the Preferred Lcale user preference and passes the brwser lcale t the web applicatin t ensure that the crrect language-specific XLIFF file is laded. The lcalized user-defined name strings are retrieved frm the XLIFF file and are emplyed by rsters, queues, milestnes, steps, wrkflws, and varius ther fields. Fr mre infrmatin, see Wrking with Lcale Resurces: XLIFF Files in the Web Applicatin Tlkit Develper s Guide. The fllwing are new r mdified classes fr Web Applicatin Tlkit 4.0.0, rganized by package. (Fr a list f deprecated Tlkit API members, refer t the FileNet P8 Platfrm Installatin and Upgrade Guide. cm.filenet.wcm.tlkit.server.base WcmCntrller - Several methds t supprt JAAS cntainer-managed authenticatin are prvided: isssofiltercnfigured indicates that an authenticatin/sso filter is cnfigured and in use, and isssoserverpluginmde indicates whether the cnfigured SSO filter requires a crrespnding authenticatin/sso plugin n the Cntent Engine / Prcess Engine server. Als, getrequestedclientlcale has been added t return the primary lcale f the current request. cm.filenet.wcm.tlkit.server.dp CmpundDcumentDataPrvider A new data prvider fr cmpund dcuments is intrduced that supplies methds fr querying cmpund dcument cmpnent relatinship bjects, retrieving class descriptins, and cnverting a dcument t a cmpund dcument r vice versa. Cpyright IBM Crp. 2002,

53 IBM FileNet P Release Ntes What s New in WcmEPrcessDataPrvider New accessr methds have been added. Fr example, the setvwsessinlcale and getvwsessinserverlcale methds set and get the client lcale setting within the VWSessin. There s als getparameterndebyauthredname, getparametervaluesbyauthredname, setparametervaluesusingauthredname, setstepelementparameterbyauthredname, getqueueauthredname, getqueuelcalizedname, and getvwqueue. WcmAuthringDataPrvider.html The islink methd has been added that indicates whether a class descriptin is derived frm a link class. Als added are createpermissins and createprperties that create permissins and prperties frm an XML nde list. cm.filenet.wcm.tlkit.server.servlet KeepAliveServlet A new ping/ech back keep alive servlet that the keep alive thread in the designer tl Java Applets will hit t keep the user sessin frm timing ut. SessinTunnelServlet A new servlet that prvides Cntent Engine Java API (javaapi.jar) lw-level prtcl supprt fr designer applets such as Search, Designer and Publish Designer. WcmCredentialsServlet A new setting "mde=encde" is intrduced t supprt JAAS cntainer-managed authenticatin. When emplyed, the servlet calls the getusertken methd t generate the user tken, which is returned in URL-encded frm s it can be passed directly as a request parameter. cm.filenet.wcm.tlkit.server.util CnfiguratinUtil A new class that is used by bth the upgrade scripts and by the web applicatin. It returns values frm web.xml t the scripts and lcates cnfiguratin files fr the web applicatin. WcmApiCnfig A new class that cntains enhanced lgic required t supprt JAAS cntainer-managed authenticatin. The class features an updated lkup prcedure by using the initializewcmapicnfig and getwcmapicnfigprperties methds which are used t lcate which WcmApiCnfig.prperties file t use: in the Wrkplace/WEB-INF flder f the web applicatin, in the web applicatin class path, r in the system classpath. WcmServerCredentials A new cnstructr verlad is prvided fr JAAS cntainermanaged authenticatin t allw fr specifying the cntainerjaasmde flag. Lgic pertaining t the identificatin and caching f the WcmApiCnfig.prperties file has been mved t the new WcmApiCnfig class. A new getsubject accessr methd prvides the JAAS cntext (the JAAS bject / interface that represents an authenticated user), btained n first access and cached fr the duratin f the user sessin. A new getusercntext methd gets the cm.filenet.api.util.usercntext bject based n the credentials in this bject. The setisssocnfigured methd has been deprecated and replaced by the setisssoserverpluginmde methd, which indicates whether r nt the credentials are dependent n a cmpatible CE/PE server plugin. cm.filenet.wcm.tlkit.server.util.prefs WcmBtstrapPrefs Tw cnstructrs that take as a parameter the btstrap prperties file have been replaced with tw cnstructrs that take the ServletCntext f the applicatin. A new getcmpnentsrtorderoffset methd returns the cmpnent srt rder ffset that is used t add new Cmpnent Relatinship bject. The getcnfigfilepath methd has been deprecated. Cpyright IBM Crp. 2002,

54 IBM FileNet P Release Ntes What s New in A new getsetcntainmentnameonadd methd determines cntainment name setting behavir when a dcument is added by using Wrkplace r WebDAV. WcmCnfiguratin The getbasepath and setbasepath methds have been deprecated. The ladbtstrap methds that take the file path f the preference cnfiguratin files have been replaced with ladbtstrap methds that take the ServletCntext f the applicatin. XMLUpdateUtil A new temprary class that will be remved frm Applicatin Engine Tlkit in a future release. It is fr internal use nly during Applicatin Engine upgrades. cm.filenet.wcm.tlkit.server.util.ui WcmPanel A new gruplabel field has been added. cm.filenet.wcm.tlkit.server.util.xml WcmXMLPrperties New createcmpnentrelatinshipelement and getcmpnentrelatinship methds have been added t create and get a Cmpnent Relatinship Element, respectively. WcmXMLSubscriptin the getxmlsubscriptins methd has been deprecated and replaced with the new getxmlsubscriptinsrelative methd. WcmXMLTagsCntentEngine New ELEM_COMPONENT_RELATIONSHIP, ELEM_ISHIERARCHICAL, and ELEM_SUBJECT fields have been added. WcmXMLTagsPrcessEngine New ATTR_AUTHORED_STEP_NAME and ATTR_AUTHORED_STEP_NAME fields have been added. WcmXSLUtil A new setxslrelative methd has been added t specify the XSL file fr transfrmatin, relative t the applicatin rt. WcmXSLUtil.NdeSet A new inner class implementatin f the rg.w3c.dm.ndelist interface, representing a cllectin f XML DOM Ndes. Wrkplace Custmizatin Cmpund dcuments are nw supprted, including the ability t add a new cmpund dcument, cnvert an existing dcument, and establish a cmpnent link relatinship between a parent and child. This new feature yields changes in several areas: New "Change Cmpund" and "Add Child" actins have been added t Actins.xml. The list f excluded classes fr a cmpund dcument has been added t ClassFilter.xml. A new inf page view with a cmpund dcument tree structure is available. The ability t search fr cmpund dcuments is prvided. File Tracking and File Management is supprted frm within Wrkplace fr lcal dcuments that are checked ut and dwnladed nt the user s lcal machine. This feature includes file tracking, autmatic detectin and lcatin f lcal files that are assciated with checked-ut dcuments n a user s machine, and using tracked files in Save, Cancel Checkut and Checkin peratins. In additin, a file management capability prvides autmatic deletin f the lcal file fllwing a Save, Cancel Checkut, Checkin r Add peratin. JAAS (Java Authenticatin and Authrizatin Service) is nw ffered t prvide supprt fr cntainermanaged authenticatin, and represents enhancements t the existing applicatin-managed authenticatin features. Develpers shuld nte that Wrkplace des nt generate user tkens when using cntainer-managed authenticatin. The new Wrkplace/WEB-INF/SitePreferencesPrimaryViews.xml descriptr file prvides the ability t cnfigure the primary views fr site preference settings displayed in the Wrkplace Site Cpyright IBM Crp. 2002,

55 IBM FileNet P Release Ntes What s New in Preferences Tl. Prir t FileNet P8 4.0, all primary views fr site preference settings were hardcded. With this release f Wrkplace, all existing site preference primary views are described in the SitePreferencesPrimaryViews.xml descriptr file. Administratrs can specify primary views fr site preference settings, rganize views int labeled grups, and prvide labels fr different lcales. Fr mre infrmatin, see Custmizing Primary Views fr Site Preferences in the Wrkplace Custmizatin Guide. The intrductin f XLIFF files augments existing resurce bundle files t supprt the display f lcalized user-authred names in Wrkplace and ther Tlkit-based applicatins. Fr mre infrmatin, see Wrking with Lcale Resurces: XLIFF Files in the Web Applicatin Tlkit Develper s Guide. Wrkplace Applicatin Integratin Tlkit Cmpund dcuments are nw supprted, including the ability t add a new cmpund dcument, cnvert an existing dcument, and establish a cmpnent link relatinship between a parent and child. Micrsft Office Applicatin Integratin supprts the cmpund dcument feature. File Tracking and File Management is supprted frm within Wrkplace fr lcal dcuments that are checked ut and dwnladed nt the user s lcal machine. This feature includes file tracking, autmatic detectin and lcatin f lcal files that are assciated with checked-ut dcuments n a user s machine, and using tracked files in Save, Cancel Checkut and Checkin peratins. In additin, a file management capability prvides autmatic deletin f the lcal file fllwing a Save, Cancel Checkut, Checkin r Add peratin. The feature is interperable with Micrsft Office Applicatin Integratin, IBM FileNet P8 efrms and the Wrkplace Applicatin Integratin ExpressAddIn. Cntent Engine Java and.net APIs New Pstre Tl The PStre Tl has been added t this versin f the Cntent Engine. Fr a client applicatin using the Cntent Engine Web Service transprt t pen a TSL r SSL cnnectin (HTTPS) with a server, the client must psses the server's public key, which is distributed in the frm f a PKI certificate. PKI certificates are nrmally stred in a key stre, frm which a client applicatin can retrieve them fr use in establishing an SSL cnnectin. Hwever, because the Cntent Engine Java API uses Systinet libraries t pen HTTPS cnnectins, its PKI certificates must be lcated in a Systinet prtected key stre. Therefre, t cnfigure a remte Cntent Engine Java API client t run ver SSL, yu must add the server's certificate t a Systinet prtected key stre by using the PStre Tl. The PStre Tl allws yu t manipulate data in a Systinet prtected stre, which cntains the user stre and the key stre. Using the PStre Tl, yu can add, edit, and remve any user prperties in the user stre; r add, edit, and remve certificates and identities in the key stre. The fllwing steps describe hw t use the PStre Tl t add the server's SSL cnnectin PKI certificate t a Systinet prtected key stre: 1. Verify that the JAVA_HOME envirnment variable is set in yur perating system. 2. In Windws, pen a Cmmand Prmpt windw r, in Unix, pen a Terminal windw. 3. In the Cmmand Prmpt r Terminal windw, change the directry t %WASP_HOME%\bin (fr example, C:\Prgram Files\FileNet\CntentEngine\wsi). 4. Enter the fllwing cmmand: PStreTl --gui. 5. Frm the PStre menu, select Open Frm File, navigate t %WASP_HOME%\cnf, then select the key stre file: clientcnf.xml. Cpyright IBM Crp. 2002,

56 IBM FileNet P Release Ntes What s New in Frm the Key Stre menu, select Imprt Alias. Frm the dialg, select Type and specify TRUSTED_CERTIFICATE_ENTRY. 7. Click Lad Certificate Chain, then select the certificate file. Click OK. 8. Clse the PStre Tl. New functinality fr develpers is available in the IBM FileNet P8 4.0 Platfrm in the frm f the Cntent Engine Applicatin Prgramming Interfaces (APIs) fr Java and fr.net. These APIs expse the Cntent Engine repsitry bjects, their behavirs, their prperties, and the bject mdel assumptins that relate them t ne anther. The Cntent Engine Java API has been enhanced in this release t prvide additinal capabilities and increased perfrmance. Its main classes fllw the metadata class hierarchy in the Cntent Engine s data mdel. In additin, this release includes a new Cntent Engine.NET API fr Micrsft.NET client applicatin develpers. The.NET API is designed t be similar in frm and functin t the Java API, s that prgrammers already familiar with the Java API can quickly becme familiar with its.net cunterpart, and vice versa. Use f the.net API requires installatin f the Micrsft.NET Framewrk 2.0 and the Micrsft Web Services Enhancements (WSE) 3.0 in the develpment envirnment. API dcumentatin cnsists f nline reference help and a develper s guide. Access the API dcumentatin by selecting Develper Help > Cntent Engine Develpment frm the IBM FileNet P8 Help Directry. Fr infrmatin n hw t mdify yur cde t use existing 3.5.x Cntent Engine COM API, Cntent Java API, and Cntent Engine Web Service applicatins in a 4.0 envirnment, see "Upgrade Custm Applicatins" in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide. Cntent Engine COM API and Cntent Java API Cmpatibility Layers This release includes cmpatibility layers fr the 3.5.x Cntent Engine COM and Cntent Java APIs. These client-side APIs allw yu t maintain applicatins written using the 3.5.x APIs. If yu have existing 3.5.x Cntent Java API r Cntent Engine COM API applicatins that yu want t upgrade t wrk in a 4.0 envirnment, yu will need t use the API's cmpatibility layer that is supplied with this release. Reference dcumentatin fr the cmpatibility layers is nly available n the Prduct Dcumentatin fr FileNet P8 Platfrm Web page < Fr infrmatin n upgrading a 3.5.x Cntent Java API r COM API applicatin t run in a 4.0.x envirnment, see "Upgrade Custm Applicatins" in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide. Prcess Engine API Cnnectin Pints Cnnectin pints replace the ruter prcess used in previus Prcess Engine releases, cnnecting the Prcess Engine API t an assciated islated regin. Cnnectin pints are defined in the Cntent Engine API (the PECnnectinPint and IslatedRegin classes) and persisted in the Glbal Cnfiguratin Data (GCD) n the Cntent Engine. Multiple cnnectin pints can reference the same islated regin. The set f cnnectin pints defined is reflected in the Cntent Engine's Dmain.PECnnectinPints prperty. The Cntent Engine's Enterprise Manager UI is used t create and manage cnnectin pints. T establish r lg n t a Prcess Engine sessin a cnnectin pint must be specified and the Cntent Engine hst must be accessible. The Cntent Engine hst URI must be set prir t creating r lgging n t a sessin (calling the VWSessin cnstructrs r lgn methds). Fr mre infrmatin, see Cnnectin Pints in the Prcess Engine Develper s Guide, r see the reference help fr VWSessin. Cpyright IBM Crp. 2002,

57 Lcalizatin IBM FileNet P Release Ntes What s New in Yur applicatins can display user-authred names (such as step respnses, queue, rster, and field names) accrding t the user's current lcale. At runtime, the applicatin retrieves the brwser lcale and calls VWSessin.setLcale. This lads the crrespnding translatin file (XLIFF file) lcated in the PEAuthredNames.jar file. As the applicatin retrieves infrmatin frm Prcess Engine API bjects, the translated strings are retrieved frm the XLIFF file using the authred names f the bjects as the key. If a translated string is nt available, authred names are returned by the calling methds. If the lcale is nt set, the Prcess Engine API des nt perfrm a lkup f translated strings. Methds accept the translated strings and lks up the authred strings befre perfrming an RPC t the Prcess Engine server. Fr example, when the user wants t display the cntents f a queue, VWSessin.getQueue accepts the translated queue name and makes the crrespnding RPC using the authred queue name. Fr mre infrmatin, see Lcalizatin in the Prcess Engine Develper's Guide. Business Prcess Mdeling Ntatin (BPMN) The Prcess Engine API prvides methds t read and write XPDL (XML fr Prcess Definitin Language) n all applicable classes t supprt the interchange f prcess mdels between tls. Additinally, the fllwing new classes have been added t the Prcess Engine API: VWWrkflwCllectinDefinitin, VWAssciatinTargetType, VWAssciatinDefinitin, and VWTextAnntatinDefinitin. Refer t the reference help fr the applicable classes..net API.NET develpment is supprted using wrapper classes generated frm the WSDL fr Prcess Engine Web Service. This prvides.net develpers with the same set f interfaces supplied fr Web services develpment. Either C# r VB.NET wrapper classes can be generated. Fr mre infrmatin, see Generating the.net API in the Prcess Engine Develper s Guide. Prcess Engine Web Services Cnnectin Pints The Prcess Engine Web Service must access a Prcess Engine cnnectin pint t create and maintain a sessin. The default cnnectin pint fr the Prcess Engine Web Service is "PEWSCnnectinPint". Refer t Using Multiple Regins in the Prcess Engine Develpers Guide fr instructins abut specifying a Prcess Engine cnnectin pint in the SOAP header. Lcalizatin If yu want t use a lcale ther than the default lcale set n the Prcess Engine server, yu can specify lcale-specific infrmatin in the SOAP header t the Prcess Engine Web Service. Fr mre infrmatin, see Specifying a Lcalizatin Header in the Prcess Engine Develper s Guide. WSDL and URL The Prcess Engine Web Service WSDL is lcated in the PrcessEngineWS JAR file installed in the Cntent Engine EAR file. The WSDL lcatin in the JAR file is as fllws: PrcessEngineWS.jar\WASP-INF\wsdl\Definitins_filenet_vw_ws_server.wsdl The URL fr the Prcess Engine Web Service returns the WSDL, and is as fllws: where cntent_engine_hst is the machine name f the Cntent Engine hst, and prt is the prt assigned t the Cntent Engine. Fr mre infrmatin, refer t the Prcess Engine Web Service reference dcumentatin in the Prcess Engine Develper s Guide. Cpyright IBM Crp. 2002,

58 IBM FileNet P Release Ntes What s New in Cmpnent Integratr-Based Wrk Perfrmers JAAS Lgin Cnfiguratin Because the Prcess Engine uses the Cntent Engine Java API during authenticatin (by using the Web Services transprt), the FileNetP8 stanza must appear in the JAAS lgin cnfiguratin file that specifies yur LginMdule class implementatin and the assciated lgin cnfiguratin cntext. Fr mre infrmatin, see Cmpnent Authenticatin Example in the Prcess Engine Develper s Guide. Cmpnent Manager Instances Yu can create multiple Cmpnent Manager instances (using the same r different RMI prts), and cnfigure the instances fr specific queues (such as JAAS r JNDI). Fr mre infrmatin, see Starting and Stpping a Cmpnent Manager Instance in the Prcess Engine Develper s Guide. JiGlue Because the Prcess Engine uses the Cntent Engine API fr authenticatin prcesses and cnnectin pints, applicatins using JiGlue must nw cnfigure JiGlue t access the Cntent Engine API. Fr mre infrmatin, see Cnfiguring JiGlue in the Prcess Engine Develper s Guide. efrms Java and JavaScript APIs A new efrms Java API is included in this release, as well as enhancements t the efrms JavaScript API. Yu can use the efrms APIs in either the FileNet P8 envirnment r in a stand-alne envirnment. In the FileNet P8 envirnment, the efrms APIs enable yu t prvide custm slutins within the P8 cntext. Fr example, yu can add custm servlets r JSP pages that use the efrms APIs t the P8 Wrkplace. In the standalne envirnment, the efrms APIs enable yu t integrate efrms functinality int yur custm Web applicatins. The efrms Java API enables yu t render interactive, editable electrnic frms t the Web brwser and t handle the autmatic and custm requests these frms send t the Web server. Yu can create static PDF r TIFF images f the cmpleted frms, thus enabling yu t archive imprtant infrmatin easily. In additin, yu can print the frms t netwrk printers. The efrms JavaScript API enables yu t define custmized client-side prcessing fr yur electrnic frms. This API enables yu t prvide custmized slutins fr yur frms and t imprve the interactins between the frms and their users. The efrms JavaScript API has been significantly enhanced in this release with the additin f the fllwing classes: ButtnCllectin Prvides access t the buttns that appear n a frm. CellCllectin Prvides access t the cells assciated with a frm r a page. ChiceList Enables yu t get and set chices fr a chice list. ChiceListCllectin Prvides access t the chice lists assciated with a frm. CmmandCllectin Prvides access t the cmmands that can be invked fr a frm. Data Enables yu t create and manipulate a cllectin f cell values. Yu can use this cllectin t ppulate frm cells r t retrieve the values frm frm cells. EventArgs Prvides a mechanism fr supplying envirnmental infrmatin t an event handler. Events Enables yu t manage the event handlers defined fr a frm, page, buttn, cell, r tlbar buttn. Yu can use this class t add multiple event handlers t r delete event handlers frm a given bject. Cpyright IBM Crp. 2002,

59 IBM FileNet P Release Ntes What s New in FrmExceptin Enables yu t handle an exceptin that was thrwn in respnse t an errr encuntered by the efrms API. HttpMethd Prvides enumerated values that indicate whether the GET r POST methd is t be used t submit an HTTP request. HttpRequest Enables yu t create custm cmmands t submit an HTTP request and t handle the respnse t that request. PageCllectin Prvides access t the pages cntained in a frm. PictureDetail Enables yu t btain infrmatin abut an image displayed n a frm. QueryRespnse Enables yu t access the data returned in respnse t an aut-increment, a lkup, r a submit actin. SignatureDetail Enables yu t btain infrmatin abut a digital signature that was entered n a frm. Target Enables yu t assciate a target windw with an HTTP request. TargetFeatures Enables yu t define the appearance f a new target windw. TlbarButtn Enables yu t enable r disable a tlbar buttn and t btain infrmatin abut a tlbar buttn. TlbarButtnCllectin Prvides access t the tlbar buttns assciated with a frm. In additin, the fllwing enumeratin classes have been added t the efrms JavaScript API: EntryType, FrmatStyle, FrmatType, FrmExceptinType, NtificatinLevel, QueryRespnseType, SignatureState. The fllwing efrms JavaScript classes have been enhanced: Buttn The OnClick prperty has been added fr managing nclick event handlers. The addonclick methd has been deprecated. Cell The OnBefreChange, OnBlur, OnChange, and OnFcus prperties have been added fr managing nbefrechange, nblur, nchange, and nfcus event handlers, respectively. The addonblur, addonchange, and addonfcus methds have been deprecated. Fr cnsistency with the prir release, the addonbefrechange methd was added and immediately deprecated. The fllwing methds have been added: dautincrement, dlkup, getchicelist getcurrentrw, getdisplayname, getentrytype, getfrmattype, getvalues, getvaluesasstrings, getvisiblerwcunt, hastemplatecell, isallwothervalues, isdisplayaslabel, issigned, setallwothervalues, setchicelist, setentrytype, setvalues, setvaluesfrmstrings, shwsigningdialg, shwverificatindialg, verifysignature. Frm The OnBefreChange, OnChange, and OnLad prperties have been added fr managing nbefrechange, nchange, and nlad event handlers, respectively. Cpyright IBM Crp. 2002,

60 IBM FileNet P Release Ntes What s New in The addonlad methd has been deprecated. Fr cnsistency with the prir release, the addonbefrechange and addonchange methds were added and immediately deprecated. The fllwing methds have been added: createcell, createchicelist, dsubmit, findchicelist, findtlbarbuttn, getauthr, getbuttn, getbuttns, getcell, getcells, getchicelist, getchicelists, getcmmand, getcmmands, getdata, getdataxml, get, gethelpurl, getntificatinlevel, getntificatinmessage, getorganizatin, getpage, getpages, getrevisin, gettemplatename, gettlbarbuttn, gettlbarbuttns, isdirty, merge, setdirty, setntificatin, shwmessage, shwqueryrespnsedialg. Page The OnLad and OnUnlad prperties have been added fr managing nlad and nunlad event handlers, respectively. Fr cnsistency with the prir release, the addonlad and addonunlad methds were added and immediately deprecated. The fllwing methds have been added: getcell, getcells, get, isaccessible, isprintable, istabvisible. Value The fllwing methds have been added: asblean, asdate, asnumber, aspicture, assignature, asstring, astime, ispicture, issignature, tcannicalstring, tpicture, tsignature, parseblean, parsecannicalblean, parsecannicaldate, parsecannicalnumber, parsecannicalpicture, parsecannicalsignature, parsecannicalstring, parsecannicaltime, parsedate, parsenumber, parsepicture, parsesignature, parsestring, parsetime. Fr mre infrmatin abut the efrms Java and JavaScript APIs, select Develper Help > efrms Develpment frm the IBM FileNet P8 Help Directry. Dcumentatin Cntent Engine The IBM FileNet P8 Help includes a new tpic, under Enterprise-wide Administratin help, called Lg File Reference. This tpic prvides a cmprehensive view f IBM FileNet P8 Platfrm lgging infrmatin thrughut the help. The IBM FileNet P8 Platfrm Installatin and Upgrade Guide cntains new installatin and upgrade checklist sectins that describe the install and upgrade tasks in terms f the administrative rles that will participate in the prcess. The IBM FileNet P8 Platfrm Installatin and Upgrade Guide nw includes a silent install sectin in "Install and Deply Cntent Engine" task. Applicatin Engine UI Service (frmerly, Integratin Servlet) Cntent related t the Applicatin Engine UI Service (frmerly knwn as the Integratin Servlet) has been remved frm the Wrkplace Custmizatin Guide and is nw lcated in a separate dcument, the Applicatin Engine UI Service Guide. The Applicatin Engine UI Service cmmands fr wrking with IBM FileNet P8 efrms are nw dcumented in the guide, including Open Frm, Render Frm, Add Frm Data, Launch Frm Data, Cpyright IBM Crp. 2002,

61 IBM FileNet P Release Ntes What s New in Take Frm Offline, and Bring Frm Online. In additin, the new sub-tpic Prefill Optins fr the IBM FileNet P8 efrms Cmmands has been added t describe the ptins fr prefilling a frm with specified data. Develper Help Renaming and TOC Restructuring The presentatin f develper-level help dcuments in the Table f Cntents fr the IBM FileNet P8 Platfrm Dcumentatin has been rerganized. Develper-level material is nw labeled and rganized accrding t three categries: Dcuments that describe hw t perfrm general custmizatin r prvide high-level prgramming tpics are labeled as Guides. Help cntent that includes detailed API descriptins and lwer-level prgramming tpics that require mre in-depth prgramming knwledge r experience are referred t as Develper s Guides. All language-specific API prgramming references, such as generated Javadcs, have been renamed as <language> API References. As a result, the fllwing table identifies the new dcument names fr IBM FileNet P : Old Dcument Name Applicatin Integratin Tlkit Guide Web Applicatin Tlkit Guide Wrkplace Integratin and Custmizatin Guide Web Applicatin Tlkit Javadcs Wrkplace Applicatin Javadcs Wrkplace Presentatin API Javadcs New Dcument Name Applicatin Integratin Tlkit Develper s Guide Web Applicatin Tlkit Develper s Guide a) Applicatin Engine UI Service Guide b) Wrkplace Custmizatin Guide Web Applicatin Tlkit Java API Reference Wrkplace Applicatin Java API Reference Wrkplace Presentatin Java API Reference Cpyright IBM Crp. 2002,

62 IBM FileNet P Release Ntes Knwn limitatins Knwn limitatins Applicatin Engine Mapped drives cannt be used t set up shared cnfiguratin when WebSphere is installed as a service. When setting up Applicatin Engine n WebSphere deplyed as a Windws service, mapped drives cannt be used t reference shared cnfiguratin. Instead, a UNC share (which cannt be an admin share such as \\hst\c$) must be used. (: ecmdb ) Cntent Engine The SQL Server and DB2 JDBC drivers have limitatins in uplading r dwnlading large amunts f cntent t Database Strage. Prblems were bserved with cntent sizes greater than 300MB, but actual limitatins will be system and applicatin dependent. Exceeding these limitatins can result in uplad, dwnlad, r CBR indexing failures. Several factrs can influence when this limitatin will be encuntered, including JVM memry, cncurrent usage f the system, and size f the cntent being upladed r dwnladed. Dcumentatin Due t path limitatins with WebSphere/ Windws, place the ecm_help directry clser t the rt directry instead f the default install directry structure f WebSphere. Sme files might nt get indexed due t this limitatin. Search Designer WebLgic AS SP6 Prxy Plug-in Mdules cause Search Designer exceptins. Prcess Engine The filename f a target file specified fr an attachment must nt cntain the pipe symbl ( ) since this character is used as a delimiter fr the Attachment bject. Knwn Issues The fllwing ntes describe knwn issues and critical infrmatin fr this release. Where applicable, each nte includes the assciated Defect Tracking System (DTS) number fr reference and tracking purpses. Fr sme entries, knwn issues might be cited in multiple sectins. Fr instance, an installatin prblem invlving the Cntent Engine might appear in bth the Installatin and the Cntent Engine sectins. As these knwn issues are fixed, they will be mved t a crrespnding sectin under Reslved Knwn Issues. Fr an verview f the knwn issues that have been fixed by a service pack, fix pack, r interim fix, see the assciated readme. FileNet P8 Platfrm Installatin, Uninstallatin, and Upgrades Cntent Engine Fr the Cntent Engine n WebSphere, Oracle databases require additinal grants t crrect XA Recvery errrs. Cpyright IBM Crp. 2002,

63 IBM FileNet P Release Ntes Knwn Issues If Cntent Engine will be deplyed n a WebSphere Applicatin Server, yu must run the fllwing SQL cmmands (as the SYS user) n yur Oracle database t prevent errrs when WebSphere tries t recver Oracle database transactins: grant select n pending_trans$ t public; grant select n dba_2pc_pending t public; grant select n dba_pending_transactins t public; grant execute n dbms_system t <user>; See the IBM web page "Exceptin ccurs during recvery f Oracle database transactins" ( _US&cs=utf-8&cc=us&lang=en) fr details. See als the descriptin fr Oracle bug If yu install IBM FileNet P Cntent Engine and Applicatin Engine nt the same machine running WebSphere and deply them int separate prfiles, IBM FileNet Wrkplace lgns fail with the fllwing errr message: Rt Exceptin: cm.filenet.wcm.api.remteserverexceptin: cm.filenet.api.exceptin.engineruntimeexceptin; Unable t use the specified cnnectin t cmmunicate with the server T permit Wrkplace lgns, d the fllwing steps: 1. (WebSphere nly) Make sure Fix Pack 11 (r higher) is installed. 2. In the administrative cnsle, navigate t Servers > Applicatin Servers and click server_name. 3. Under Java and Prcess Management, click Prcess Definitin. 4. Under Additinal Prperties, click Java Virtual Machine. 5. Under Additinal Prperties, click Custm Prperties. 6. Click New and define a new custm prperty with the fllwing values: Name = cm.ibm.websphere.rb.uniqueservername Value = True 7. Click OK and then click Save n the Cnsle bar. 8. Restart the applicatin server (DB2 nly) Befre upgrading DB2-based bject stres, the DB2 site administratr shuld evaluate current usage f transactin lg files and increase the number and/r size f the secndary lg files (LOGSECOND) in rder t avid a Transactin Lg Full errr (SQL Cde -964) during the upgrade. Als, cntrary t the nte in step 6 f the prcedure "T upgrade items" in the IBM FileNet P8 Installatin and Upgrade Guide task "Upgrade Cntent Engine," d nt cntact IBM Supprt if yu encunter a Transactin Lg Full errr, as this errr can be reslved by the DB2 site administratr The Cntent Engine server exceptin E_FAILED_TO_GET_DATASOURCE caused by XAResurce.XA_OK start() (failed because f invalid packet header) is related t the Micrsft JDBC driver. Yu can reslve this by installing the Micrsft JDBC driver htfix KB Cpyright IBM Crp. 2002,

64 IBM FileNet P Release Ntes Knwn Issues When running Upgrader Tl, yu can select multiple bject stres t be upgraded. While this feature generally wrks, IBM recmmends that yu upgrade ne bject stre at a time. If an errr ccurs during the upgrade, it is easier t diagnse the cause and reslve it if yu are dealing with nly ne bject stre When the Cntent Engine database is Micrsft SQL Server 2000, perfrmance is degraded if the number f entries in the Security Descriptr table fr the database is unusually large; fr example 10,000 entries r mre. Use the fllwing prcedure t make the index fr the Security Descriptr table a clustered index and t change the index n the primary key t be a nn-clustered index. Yu can perfrm the prcedure manually r by using SQL Query Analyzer. Attentin Be sure t use the name f yur primary key index if it differs frm the ne used in this prcedure (PK SecurityDesc 182C9B23). 1. Drp bth indexes in the Security Descriptr table, as fllws: drp index SecurityDesc.I_SecurityDesc37 g alter table SecurityDesc drp cnstraint PK SecurityDesc 182C9B23 g 2. Add bth indexes back int the Security Descriptr table, as fllws: alter table SecurityDesc add cnstraint PK SecurityDesc 182C9B23 PRIMARY KEY NONCLUSTERED ( security_id ) g create clustered index I_SecurityDesc37 n SecurityDesc ( hash ) g(dc DTS ) When yu recrd a respnse file t be used fr a subsequent silent installatin f Cntent Engine, and have specified DB2 as the database type fr the GCD, the respnse file errneusly shws an MS SQL Server (rather than a DB2) driver type, including the driver class name and descriptin. As a wrkarund, after generating the respnse file, edit it by adding the fllwing line: -v vasjdbcdrivetype= The fllwing fur FileNet P8 versin 3.5.x prperties in ObjectStre bjects fr tuning the paging f query results d nt exist in versin 4.0.0: DefaultQueryBatchSize DefaultQueryRwLimit MaxQueryRwLimit EnumBatchSize In versin 4.0.0, the ability t tune the paging f query results is instead cntrlled by three new prperties in the ServerCacheCnfiguratin bject: NnPagedQueryMaxSize QueryPageDefaultSize QueryPageMaxSize Cpyright IBM Crp. 2002,

65 IBM FileNet P Release Ntes Knwn Issues Because there is n ne-t-ne mapping between the fur ld and three new prperties, any changes yu made t the default values f the ld prperties in a versin 3.5.x bject stre will be lst when yu upgrade the bject stre t versin Therefre, yu must manually set the values f the three new prperties in the versin ServerCacheCnfiguratin bject if yu want paging behavir fr query results equivalent t that in versin 3.5.x Instructins fr installing EMC Centera shared libraries were mitted frm IBM FileNet P8 Platfrm Installatin and Upgrade Guide. T use Centera fixed cntent devices with yur IBM FileNet P8 system, yu must install the Centera shared libraries n each machine where yu deplyed Cntent Engine Server. The prcedures fr installing these libraries are shwn belw. Perfrm the prcedure that applies t the perating system n each machine that hsts Cntent Engine Server. T install Centera shared libraries (UNIX): 1. If yu have nt already dne s, lg n as a user with write permissin t the directry where Cntent Engine Server is installed. 2. Access the Cntent Engine installatin sftware. 3. Navigate t the /Centera/install directry, where yu will see tw shell script files: install.sh setcenteralibpath.sh 4. Cpy the /Centera/install directry t a temprary lcatin, where yu will edit its cntents in step Open setcenteralibpath.sh in a text editr, specify the lcatin where yu will install the Centera shared libraries, and save yur edits. Fr example: CENTERA_LIB_PATH=/pt/Centera_SDK PATH=$PATH:$CENTERA_LIB_PATH Nte If yur UNIX perating system is either HP-UX 11i r Slaris, yu must chse either the 32-bit r the 64-bit Centera shared libraries. Be sure t specify the crrect versin, as fllws: 32-bit libraries: CENTERA_LIB_PATH=/pt/Centera_SDK/lib/32 PATH=$PATH:$CENTERA_LIB_PATH 64-bit libraries: CENTERA_LIB_PATH=/pt/Centera_SDK/lib/64 PATH=$PATH:$CENTERA_LIB_PATH 6. Launch the shell script file install.sh frm its temprary lcatin t install the Centera shared libraries:./install.sh The script prmpts yu t specify an installatin directry, as fllws: Intrduce install directry[/usr/lcal/centera_sdk]: Accept the default lcatin, /usr/lcal/centera_sdk, r specify anther lcatin, and then press <Enter>. 7. Open yur applicatin server startup script in a text editr: Cpyright IBM Crp. 2002,

66 IBM FileNet P Release Ntes Knwn Issues (WebSphere) setupcmdline.sh (WebLgic 8.1.x) startweblgic.sh (WebLgic 9.2) setdmainenv.sh 8. Add the fllwing line t yur startup script t run the setcenteralibpath.sh script and save yur edits. Cntinuing the example:./pt/centera_sdk/setcenteralibpath.sh 9. Stp and start the applicatin server t run the startup script. T install Centera shared libraries (Windws): 1. If yu have nt already dne s, lg n as a user with write permissin t the directry where Cntent Engine Server is installed. 2. Access the Cntent Engine installatin sftware. 3. Navigate t the \Centera\install directry, and lcate the cmmand file setcenteralibpath.bat. 4. Cpy setcenteralibpath.bat directry t a temprary lcatin, where yu will edit its cntents in step Open setcenteralibpath.bat in a text editr, specify the lcatin t which yu will install the Centera shared libraries, and save yur edits. Fr example: CENTERA_LIB_PATH=C:\Centera_SDK set PATH=%PATH%;%CENTERA_LIB_PATH% 6. Run the cmmand file install.bat frm its temprary lcatin t install the Centera shared libraries. The cmmand file prmpts yu t specify an installatin file, as fllws: Please prvide the installatin destinatin flder Usage: install.bat INSTALL_DIR Fr example: install.bat C:\Centera_SDK 7. Open yur applicatin server startup cmmand file in a text editr: (WebSphere) setupcmdline.bat (WebLgic 8.1.x) startweblgic.cmd (WebLgic 9.2) setdmainenv.cmd 8. Add the fllwing line t yur startup cmmand file and save yur edits. Cntinuing the example: D:\Centera_SDK\setCenteraLibPath.bat 9. Stp and start the applicatin server t run the startup cmmand file Opening an image in Image Viewer, and then viewing the Java cnsle results in an errr displayed in the cnsle When Cntent Engine is deplyed n WebLgic 8.1.x and uses an Oracle 9i database, sme transactins using synchrnus event handlers can fail, causing the entire transactin t be rlled back Benign security warning messages might be displayed when yu install the IBM FileNet P8 Platfrm 4.0 dcumentatin n IBM WebSphere applicatin servers. Yu can ignre Cpyright IBM Crp. 2002,

67 IBM FileNet P Release Ntes Knwn Issues these messages, as the installatin and deplyment cmpletes successfully and the help functins as expected Due t a limitatin in Virtual Member Manager (VMM), the federated repsitries feature f WebSphere Applicatin Server 6.1 des nt supprt verlapping parent and child dmain suffixes. That is, VMM cannt distinguish amng user IDs having the same base entries in different LDAP repsitries When Windws Active Directry cntains a large number f users and/r grups, it might return a referral instead f a direct bind. Instead f chasing referrals, hwever, the LDAP cnfiguratin created by the Cntent Engine installer thrws exceptins. If Cntent Engine is deplyed n JBss and uses Windws Active Directry as its directry server, the fllwing steps will cause referrals t be chased: 1. Stp JBss. 2. In file JBOSS_DIST/server/server1/cnf/lgin-cnfig.xml, add the fllwing line t sectin <lgin-mdule cde= rg.jbss.security.auth.spi.ldapextlginmdule >: <mdule-ptin name="java.naming.referral">fllw</mdule-ptin> 3. Start JBss Sme LDAP Servers impse a limit n the number f multi-valued attributes that they return. In the Cntent Engine release, the Cntent Engine API Grup.get_users() and User.get_memberOfGrups() methds return nly the number f multi-valued bjects allwed by this limit. This limit affects applicatins written against any f the Cntent Engine 4.0 APIs, including the Java,.NET, COM, and web service APIs. Applicatins, such as P8 Wrkplace, Enterprise Manager, and ther IBM r third-party applicatins, are als affected, especially n actins such as retrieving all users in a grup, r all grups that a user belngs t. The default limitatin fr the supprted IBM FileNet P8 directry servers are: Micrsft ADAM: 2000 Micrsft ActiveDirectry: 2000 Nvell edirectry: unlimited IBM Tivli Directry Server: 500 SunONE Java Directry Server: 2000 The LDAP administratr can change these defaults. Nte that this limitatin will be fixed in the Cntent Engine release If yu specify a nn-default prt number (fr example, 9081) when running Cntent Engine Setup n WebSphere Applicatin Server, yu must perfrm the wrkarund shwn in the fllwing prcedure when Cntent Engine Setup exits: 1. Undeply Cntent Engine. 2. Uncmpress the file Engine-ws.ear. 3. Uncmpress the file wsi-ws.war. 4. In the file web.xml, change the value f the <param-value> element t the nn-default Cpyright IBM Crp. 2002,

68 IBM FileNet P Release Ntes Knwn Issues prt number (fr example, 9081) as shwn belw: <cntext-param> <param-name>wasp.servlet.httpprt</param-name> <param-value>9081</param-value> </cntext-param> 5. Recreate the file Engine-ws.ear. 6. Deply Cntent Engine CEClientUpdater Sl.bin, the prgram that installs the Cntent Engine Java Client Files n a Slaris machine, errneusly warns that yu are attempting t verwrite newer files when it runs n a machine where Applicatin Engine is deplyed. Yu can ignre the warning frm CEClientUpdater Sl.bin fr each f the fllwing Cntent Engine Java Client Files that either are nt currently n the Slaris machine r are lder than thse yu are installing: Wrkplace/dwnlad/p8cjares.jar Wrkplace/WEB-INF/lib/Jace.jar Wrkplace/WEB-INF/lib/javaapi.jar Wrkplace/WEB-INF/lib/p8cjares.jar Wrkplace/WEB-INF/lib/listener.jar If Cntent Engine fails t autmatically start after a rebt f the WebSphere r WebLgic machine n which it is deplyed, manually start Cntent Engine as fllws: On WebSphere: 1. When the rebt f the machine hsting WebSphere is cmplete, lg n as a user with permissin t start WebSphere. 2. Start WebSphere and wait a few minutes until it is running: (UNIX) startserver.sh (Windws) startserver.exe 3. Lg n t the WebSphere Administrative Cnsle (fr example, hstname>:9080/ibm/cnsle) 4. Start Cntent Engine, as in the fllwing WebSphere 6.1.x example: a. Navigate t Applicatins > Enterprise Applicatins b. Select FileNetEngine and click Start. On WebLgic: 1. When the rebt f the machine hsting WebLgic is cmplete, lg n as a user with permissin t start WebLgic. 2. Start WebLgic and wait a few minutes until it is running: (UNIX) startweblgic.sh (Windws) startweblgic.exe3. Lg n t the WebLgic Administratin Cnsle (fr example, hstname>:7001/cnsle) 3. Start Cntent Engine, as in the fllwing WebLgic 9.2.x example: Cpyright IBM Crp. 2002,

69 IBM FileNet P Release Ntes Knwn Issues a. Click Lck & Edit. b. Navigate t FNCEDmain > Envirnment > Deplyments. c. Select Engine-wl and click Start Due t a limitatin in the WebSphere 6.1.x administrative cnsle, yu must create a separate JDBC prvider fr MS SQL Server 2005 bject stre data surces, rather than using the JDBC prvider created by the Cntent Engine installer When Cntent Engine Server is deplyed n JBss and Windws Active Directry is yur directry server, JBss will nt be able t reslve fully qualified dmain names unless yu cnfigure the JBss machine t pint t the crrect DNS server: (Windws) Specify the IP address f the DNS server in the Internet Prtcl (TCP/IP) Prperties dialg bx. (UNIX) Specify the IP address f the DNS server in the file /etc/reslv.cnf, as in the fllwing example (where the preferred and alternate DNS servers are at and ): nameserver nameserver dmain filenet.cm search filenet.cm When invking CEClientUpdater AIX.bin, the prgram that installs the Cntent Engine Java Client Files n AIX machines, d nt use the cnsle flag. If yu are running the prgram n a machine that has n X Windw emulatr, use the silent flag instead f the cnsle flag In the Enterprise Manager, the Index Area dialg has a new prperty, Temp Dir Path, displayed in the General tab. If this prperty was previusly set and saved, it cannt be unset frm the General tab. The wrkarund is t g int the Prperties tab, right-click the prperty value, and select Unset When yu run the Cntent Engine Upgrader Tl t upgrade a DB2-based bject stre, the XML File Creatr screen displays an errneus unsupprted database warning message, which yu can ignre If yu intend t deply Cntent Engine n JBss 4.0.5, and the hst machine des nt have Internet cnnectivity, perfrm the fllwing wrkarund prir t running the Cntent Engine installer: 1. Open the file lgin-cnfig.xml fr editing. This file is typically lcated at:...\server\myserver\cnf, where myserver is the name f the JBss server. 2. In the <!DOCTYPE declaratin, change " t "<jbss_install_dir>/dcs/dtd/security_cnfig.dtd" where <jbss_install_dir> is the directry where JBss is installed. 3. Save yur edit. Cpyright IBM Crp. 2002,

70 IBM FileNet P Release Ntes Knwn Issues Due t an errr in WebLgic Server 8.1.6, when yu deply Cntent Engine, the WebLgic Server cnsle displays a java.lang.nullpinterexceptin errr, even thugh the WebLgic dmain is successfully activated. T prevent this errr frm being lgged, cntact BEA Supprt t get the patch fr CR Windws Integrated Lgn t SQL Server is nt supprted with IBM FileNet P8. In the IBM FileNet P8 Platfrm Installatin and Upgrade Guide task "Install Micrsft SQL Server fr FileNet P8," subtpic "T Cnfigure Distributed Transactin Cmpnents" yu are instructed t lg n t the SQL server as a database administratr. The fllwing CAUTION shuld be fllwed fr the lgn: Use SQL Server database credentials, nt Windws credentials, t lg n. Windws Integrated Lgn t SQL Server is nt supprted with IBM FileNet P The fllwing warnings appear in the Warning.lg file after installatin: WARNING: Admin.xml mdificatin failure. Culd nt find attribute descriptin= in the line: <Admin alias="den-dev-fnadmin" prt="" listeners="100" hst="den-dev-fnadmin" bind="" verbsity="status" mde="" WARNING: Admin.xml mdificatin failure. Culd nt find attribute = in the line: <Admin alias="den-dev-fnadmin" prt="" listeners="100" hst="den-dev-fnadmin" bind="" verbsity="status" mde="" The descriptin and attributes are nt used fr this installatin and these warnings can be ignred Fr Slaris Autnmy K2 installatins, yu must create a link t java in /usr/bin/sparcv9 in rder t run the installer Versin 4.0.0b f the Cntent Engine Setup prgram errneusly specifies a hard-cded HTTP prt number fr WSI. As an example, the META-INF\web.xml file, packaged in an EAR file and wrapped in a wsi-xx.war file, cntains the fllwing XML cntent: <cntext-param> <param-name>wasp.servlet.httpprt</param-name> <param-value>8080</param-value> </cntext-param> where xx is ws (WebSphere), wl (WebLgic), r jb (JBss). The hard-cded prt number (8080 in the example) shuld in fact be set by Cntent Engine Setup t whatever the cnfigured HTTP prt is. As a wrkarund, d the fllwing after Cntent Engine Setup cmpletes: 1. Open the engine-xx.ear file. 2. Open the wsi-xx.war file 3. Edit the web.xml file by changing the hard-cded cntent f the <param-value> XML element t the prt number f the cnfigured HTTP prt. 4. Repackage the wsi-xx.war and engine-xx.ear file If yu experience Wrkplace lgn failures when WebSphere 6.0.x uses static ruting in a netwrk deplyment, and Applicatin Engine and Cntent Engine are each deplyed t Cpyright IBM Crp. 2002,

71 IBM FileNet P Release Ntes Knwn Issues separate managed applicatin server instances, yu must change the static ruting t dynamic ruting. Static ruting is indicated n the deplyment manager by the presence f a static rute file, <server_instance>.wsrrttbl, in a path such as <WAS_install_dir>/prfiles/Dmgr01/cnfig/cells/<nde>/clusters/<server_instance>/. T disable static ruting, delete the static rute file n the deplyment manager and enable dynamic ruting instead. Fr mre infrmatin n static and dynamic ruting, refer t the fllwing IBM dcumentatin: e.nd.dc/inf/ae/ae/trun_wlm_cluster_rutetable_disable.html Versin 4.0.0b f Cntent Engine Setup, when run n a machine that hsts WebSphere 6.x, lks fr a directry named prfiles t access the WebSphere prfiles. If the WebSphere administratr installed the prfiles in a directry that is nt named prfiles, Cntent Engine Setup will nt find it. T wrk arund this prblem, befre running Cntent Engine Setup, create a sft link directry called prfiles, which pints t the directry that cntains the prfiles. When Cntent Engine Setup runs, it will then find the prfiles by using this sft link directry When installing and deplying Cntent Engine n a JBss platfrm, Cntent Engine Setup errneusly sets the lgin-mdule XML element in the ldap-cnfig.xml file t the fllwing: <lgin-mdule cde="rg.jbss.security.auth.spi.ldapextlginmdule" flag="required"> The required flag setting in the lgin-mdule XML element prevents Cntent Engine frm behaving prperly in a multi-dmain/realm. T reslve this prblem, replace the XML element abve with the fllwing: <lgin-mdule cde="rg.jbss.security.auth.spi.ldapextlginmdule" flag="sufficient"> T avid lng respnse times fr large cntent retrievals frm databases and file strage areas, d nt use versin 1.5.0_12 f JRckit JDK with IBM FileNet P8 cmpnents When deplyed n WebSphere SR6, Cntent Engine exhibits significant perfrmance degradatin fr mst transactins. Custmers wh are perfrmance sensitive shuld deply Cntent Engine n WebSphere SR6 instead When running versin 4.0.0b f the Cntent Engine installer, if yu select JBss as the applicatin server type and Sun Java System Directry Server as yur authenticatin prvider, the installer will set the LDAP user filter t an incrrect value, cn. Change the user filter t its crrect value, uid The Cntent Engine and Prcess Engine client installers shuld recgnize ther installed P8 cmpnents, such as Applicatin Engine, Wrkplace XT, and Recrds Manager. In sme cases, when using a Cntent Engine 4.0.x r 4.5.x, r a Prcess Engine 4.0 r 4.5.x client installer, the client installer des nt recgnize a P8 applicatin. Wrkarund: Use the "Other" ptin and navigate t the installed lcatin f the sftware An upgrade f Cntent Engine frm versin t causes FileNet System Mnitr (FSM) t stp mnitring the machines where Cntent Engine is deplyed. After the upgrade, yu must update the cnfiguratin by changing the listener path (CEMP_Daphne_Server1) fr each Cntent Engine machine t its new value (P8 CEMP) and pushing the updated cnfiguratin t each Cntent Engine machine being mnitred. Cpyright IBM Crp. 2002,

72 IBM FileNet P Release Ntes Knwn Issues Keep a recrd f the new listener path in case yu create subsequent FileNet listenerrelated mnitrs. T change the listener path value and push the change t the Cntent Engine machines: 1. Lg int the FSM web cnsle and click the link t launch the FileNet Mnitring Manager. Lg int the Mnitring Manager applicatin. 2. Open the active mnitr cnfiguratin fr the machine where Cntent Engine is deplyed. 3. Fr all cnfigured mnitrs that specify the listener path as a parameter, change CEMP_Daphne_Server1 t P8 CEMP. Refer t FSM Mnitring Guide FileNet P8 4.0.x, available at this web site fr infrmatin abut all P8 4.x mnitrs: 01.ibm.cm/supprt/dcview.wss?rs=3321&cntext=SSEM9N&uid=swg After updating all the listener paths save the mnitr cnfiguratin, which pushes the cnfiguratin t the Cntent Engine machine and restarts the Cala client n the machine. Refer t the chapter Using CalaMMa in FSM Mnitring Guide FileNet P8 4.0.x fr details n using the Mnitring Manager and saving mnitr cnfiguratins. 5. Repeat steps 2 4 fr all the ther machines where Cntent Engine is deplyed. Renditin Engine Renditin Engine installatin media is required t use the uninstaller t remve the Renditin Engine. T cmpletely uninstall Renditin Engine using the supplied uninstaller, yu must use the same install media type frm the same lcatin as yu used t install Renditin Engine. Specifically, if yu installed frm a CD then yu must have the CD available and munted in the same CD drive used when installing; if yu installed frm a mapped drive, the media must be available n the same mapped drive pinting t the same netwrk lcatin when uninstalling; r if yu installed frm a cpy f the installatin media n a lcal drive, the cpy must still exist in the same lcatin. If yu d nt have the install media available, yu must use the prcedures belw t uninstall Renditin Engine. T determine the lcatin f the install media used t install Renditin Engine, d the fllwing: 1. On the Renditin Engine server, launch regedit. 2. Navigate t: 3. HKEY_LOCAL_MACHINE\SOFTWARE\Micrsft\Windws\CurrentVersin\Uninstall 4. Lcate the path frm which Renditin Engine was riginally installed by searching fr "FileNet P8 Renditin Engine 4.0.0" in the Data field. The "InstallSurce" variable cntains the path. If yu installed frm a CD/DVD drive r a mapped drive t the rt f the Renditin Engine media, it wuld be: D:\Installer If yu installed frm a netwrk lcatin UNC path, it wuld be: Cpyright IBM Crp. 2002,

73 IBM FileNet P Release Ntes Knwn Issues \\server\sftware\filenet\p8 RE 4.0.0\Installer Attentin If the install lcatin is a netwrk lcatin with a UNC path then uninstallatin using the uninstaller will nt wrk and yu must use the prcedure belw t uninstall Renditin Engine. T uninstall Renditin Engine if it was installed using a UNC path r if the installatin media r lcatin is nt available, perfrm the fllwing steps. 1. Run "Add r Remve Prgrams", and select "FileNet P8 Renditin Engine 4.0.0". 2. Click "Change/Remve". 3. Select Remve, and click Next. 4. Cmplete the uninstallatin. Attentin This remves nly the entry in the "Add r Remve Prgrams." 5. In the "Add r Remve Prgrams" list select "Vista." 6. Click "Change/Remve." 7. Select Remve, and click Next. 8. Cmplete the uninstallatin. Nte The fllwing will be remved: Files and flders. The Liquent Registry key. The "LIQUENT XML Printer." The desktp shrtcuts "Dmain Manager" and "RenderPerfect Admin." The Prgrams Liquent menu entry. The entry in the "Add r Remve Prgrams." 9. Frm the Start Menu, launch "Printers and Faxes." 10. Verify that the "LIQUENT XML Printer" has been remved. 11. Select File > Server Prperties. 12. Select the Drivers tab and delete the "LIQUENT XML Printer" entry. 13. Select the Prts tab and delete the fllwing entries: C:\Prgram Files\Liquent\filenet\ESPS.PS C:\Prgram Files\Liquent\filenet\liquent.xml 14. Verify that the fllwing files and flders were remved: C:\Prgram Files\Cmmn Files\Liquent C:\Prgram Files\Liquent\filenet 15. Using regedit, verify that the Registry key HKEY_LOCAL_MACHINE\SOFTWARE\LIQUENT has been remved. 16. Verify that the desktp shrtcuts "Dmain Manager" and "RenderPerfect Admin" were remved. Cpyright IBM Crp. 2002,

74 IBM FileNet P Release Ntes Knwn Issues 17. Remve Wrd and WrdPerfect macrs. If the fllwing Micrsft Wrd macr is present n the Renditin Engine server, remve it: cdmacrs.dt If any f the fllwing Wrd Perfect macrs are present n the Renditin Engine server, remve them: espsdtc.wcm espsdtc11.wcm espsdtc12.wcm espsdtc2k.wcm espsdtc9.wcm espsrsym.wcm espsrsym11.wcm espsrsym12.wcm espsrsym2k.wcm espsrsym9.wcm generate.wcm remvehf11.wcm remvehf12.wcm remvehf2k.wcm 18. Rebt the server The maximum file size usable by Renditin Engine is 10 MB. Files larger than this might fail t publish due t Java Out f Memry errrs. T avid memry errrs when publishing large files, with sizes frm 1 MB t 10 MB, make sure yu set the Cntent Engine applicatin server JVM heap sizes t the fllwing: Initial Java heap size (-Xms): 512 MB Maximum Java heap size (-Xmx): 1024 MB Fr infrmatin abut setting the JVM heap sizes, see step 2 f Task 9: Install and Deply Cntent Engine in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide If yu uninstall Renditin Engine 3.0.0a/3.5.1/3.5.1a n a system where Renditin Engine cmpnents and MS SQL (server r client) are cllcated, the uninstallatin breaks the MS SQL Server installatin. This is an issue when upgrading a Renditin Engine 3.x.x system t Renditin Engine 4.0.x, r in any scenari in which yu want t retain the MS SQL server installatin after remving Renditin Engine cmpnents. T avid breaking MS SQL, befre uninstalling Renditin Engine yu must install the fllwing Renditin Engine interim fix: P8RE Cpyright IBM Crp. 2002,

75 IBM FileNet P Release Ntes Knwn Issues Install the interim fix fr the fllwing scenaris: On Cntent Engine: CE + RE fr Publishing Plug-in Server + SQL Client On Cntent Engine: CE + RE fr Publishing Plug-in Server + SQL Server On Renditin Engine Server: RE Server + SQL Client On Renditin Engine Server: RE Server + SQL Server Prcess Engine Recncile Prcess Engine Envirnment Recrds befre Upgrade. Befre upgrading yur Prcess Engine t versin r later yu must recncile yur envirnment recrd. Failing t d this can intrduce irrecverable errrs in the Prcess Engine database, requiring yu t rll back the upgrade and restre the database. Prcess Engine duplicates certain parts f the user security infrmatin in its wn database, and, ver time, the infrmatin in the directry service might be changed r updated. When this happens, the infrmatin in Prcess Engine s envirnment recrds, whether cached r permanent, can end up cntaining ld, invalid infrmatin abut Prcess Engine users and grups. Recnciling this infrmatin allws the administratr t determine hw t reslve any ambiguities. Fr mre infrmatin and instructins n hw t perfrm the recnciliatin, see the IBM FileNet P8 Platfrm nline dcumentatin, FileNet P8 Administratin > Prcess Engine Administratin > Administrative tls > vwtl > Cmmands > envirnment. Unrecnciled Prcess Engine envirnments might cause migratin f the wrng user recrds n upgrade. When a user accunt is recreated with the same shrt name and dmain name (dn), the Prcess Engine envirnment recrd database will cntain multiple recrds with the same accunt name but with different Prcess Engine wrkflw IDs. On an upgrade, the wrng envirnment recrd will be migrated, ptentially causing wrkflw items t be rphaned. This scenari might exist if a specific user name has been decmmissined and then recreated int the system. During the Prcess Engine upgrade it is critical that this user infrmatin is crrect and up t date. Befre upgrading yu must recncile the cached and permanent user data envirnment recrds n the Prcess Engine with the pssibly mre-up-t-date data in an LDAP-based directry service. Fr mre infrmatin n hw t recncile the Prcess Engine envirnment, see the FileNet P8 Online Help tpic FileNet P8 Administratin > Prcess Engine Administratin > Administrative tls > vwtl > Cmmands > envirnment. Backgrund infrmatin abut user migratin during upgrade Fr each envirnment recrd frm vwbject table the upgrader des the fllwing: 1. Extract the full user dn frm f_bjname (blb). 2. Send the full user dn t Cntent Engine server t see if the recrd is valid. 3. If the recrd is valid and has nt been migrated, migrate the envirnment recrd frm vwbject t vwuser. If there are user duplicatins in the envirnment, bth recrds fr the user name have the same user dn. The recrd with the lwer wrkflw ID number is checked first and migrated even thugh this recrd is lder and shuld nt be used. The recrd with the higher Cpyright IBM Crp. 2002,

76 IBM FileNet P Release Ntes Knwn Issues wrkflw ID is checked later and ignred as the user name has already been migrated. If yu have already upgraded yur envirnment and duplicated users have been incrrectly migrated, yu must manually check fr and repair any rphaned wrkflw items. T check successful migratin Nte This prcedure describes a simple scenari where nly ne user has been remved frm LDAP and later reinstated. Yur envirnment might lk different. 4. Check 4.0 VWObject table entries fr nn-migrated envirnment recrds. If the VWObject table cntains envfield entries f the type userid, these envirnment recrds did nt migrate successfully t the new vwuser table. In this scenari tw entries will exist: a. One fr the deleted user where the user dn des nt exist in LDAP. b. One fr the recreated user with the user dn has already migrated. 5. Verify the user ids against user dns. 6. Verify that the tw entries represent users with identical names in LDAP. 7. Check and reassign wrk items fr the verlapping user ids. Using Wrkplace yu must find all wrk items nw incrrectly assigned t the lder wrkflw ID number (the deleted user) and reassign them t the newer wrkflw ID number. T reassign rphaned wrkflw items 1. Lgn t Wrkplace as a Prcess Engine Administratr wh has administratr privilege t access the Prcess Administratr tl. 2. In Wrkplace, select the Admin tab. 3. Launch Prcess Administratr. 4. Query fr wrk items belnging t the decmmissined wrkflw id number. 5. Open each wrk item in the step prcessr and reassign it t the new wrkflw id number In previus versins f Prcess Designer (prir t 4.0.2), it was pssible t create a Prcess Orchestratin wrkflw with the fllwing scenari: Wrkflw A cntains Receive Reply Invke (invking service frm wrkflw B) Wrkflw B cntains Invke (invking service frm Wrkflw A) Receive Reply In Prcess Engine 4.0.2, the abve scenari is nt supprted; transfer fr either wrkflw Cpyright IBM Crp. 2002,

77 IBM FileNet P Release Ntes Knwn Issues will result in a validatin errr. Wrkarund: 1. Remve Invke system instructin in bth Wrkflw A and B and transfer them nnfinalize. 2. Add invke system instructin back t Wrkflw A; manually remve the wrkspace id in the wsdl url. 3. Transfer Wrkflw A finalize. 4. Add invke system instructin back t Wrkflw B. 5. Transfer Wrkflw B finalize If yur installed PA has been upgraded frm versin t versin 4.0.1, the uninstaller might nt prperly detect the required JVM runtime. T successfully uninstall PA Engine yu must pint the uninstaller t the PA Engine installed java.exe either as part f launching the uninstaller r when prmpted by the uninstaller. T uninstall PA Engine 1. On the PA server, start the uninstaller using either f the fllwing methds: *Start the uninstaller frm a cmmand line a) Frm a cmmand line, navigate t the uninstaller directry at: <PA_install_path>\FileNet\Prcess Analyzer Engine\_uninst2 b). Execute uninstaller.exe, passing it the java.exe lcatin: uninstaller.exe -is:javahme "<PA_install_path>\FileNet\Prcess Analyzer Engine\_jvm" Where <PA_install_path> is the directry yu selected t install Prcess Analyzer. Default: C:\Prgram Files *Start the uninstaller frm the Windws Add/Remve sftware snap-in a) On the Prcess Analyzer Server, navigate t Start > Settings > Cntrl Panel and duble-click Add/Remve Prgrams. b) Select the FileNet PA Engine applicatin frm the list f installed prgrams and click Change/Remve. 2. Fllw the instructins prvided by the uninstaller. Nte When prmpted, brwse t and select java.exe frm: <PA_install_path>\FileNet\Prcess Analyzer Engine\_jvm 4. The uninstaller will successfully remve the sftware. Nte Depending n the state f the system, yu might be prmpted t restart the cmputer in rder t cmplete the uninstall prcess Running the Prcess Engine client installer n HPUX Itanium returns an errr 'N java runtime ENV (JRE). Wrkarund: Run the HPUXi client installer with the fllwing cmmand: Cpyright IBM Crp. 2002,

78 IBM FileNet P Release Ntes Knwn Issues./P8PEClientUpdater HPUXi.bin -is:jvmtimer 10 This gives the installer mre time t cmplete JVM verificatin. The default value is The Cntent Engine and Prcess Engine client installers shuld recgnize ther installed P8 cmpnents, such as Applicatin Engine, Wrkplace XT, and Recrds Manager. In sme cases, when using a Cntent Engine 4.0.x r 4.5.x, r a Prcess Engine 4.0 r 4.5.x client installer, the client installer des nt recgnize a P8 applicatin. Wrkarund: Use the "Other" ptin and navigate t the installed lcatin f the sftware. NA The JRE that is autmatically dwnladed t client machines fr Wrkplace applets des nt supprt Daylight Saving Time. Yu can dwnlad JRE r later frm the Sun web site t implement this supprt. Applicatin Engine When Applicatin Engine is cnfigured t use 1-bx SSL redirect and Internet Explrer as the brwser, the brwser fails t lad the graphics f the lgin page and it als fails t lgin. A wrkarund is t use different machine names in the http and https URLs. Fr example, use the machine name in ne and use the IP address in the ther The Applicatin Engine installer checks the installatin partitin fr available space. If yu attempt t install Applicatin Engine n a partitin that has insufficient disk space, the installer prevents the installatin frm prceeding after displaying a descriptive warning. Hwever, under certain circumstances, the installer might display nn-descriptive errrs f the type "One r mre errrs ccurred during the cpying f files..." rather than the descriptive warning message Due t cnflicting lg4j.jar files in the JBss and Applicatin Engine installatin directries, the JBss cnsle displays a large number f lg4j errrs when starting. The errrs d nt impact the Wrkplace web applicatin deplyment. T prevent these errrs frm displaying, d the fllwing: 1. Delete the fllwing temp directry: 2. <JBss_hme>\server\<server_instance>\wrk\jbss.web\lcalhst\Wrkplace 3. Remve the lg4j.jar file frm the <AE_install_path>\Wrkplace\WEB-INF\lib directry. 4. Repackage and redeply the Wrkplace applicatin Applicatin Engine n JBss with Cntainer Managed Authenticatin requires P8AE fix pack. T install Applicatin Engine n JBss with Cntainer Managed Authenticatin (CMA) supprt, yu must install the P8AE fix pack, fllwing the high level steps utlined belw: 1. Run the Applicatin Engine installer, selecting JBss and Cntainer Managed Authenticatin. 2. Befre deplying and cnfiguring Applicatin Engine, install the P8AE fix pack. Fr requirements and detailed instructins, see the Applicatin Engine fix pack Cpyright IBM Crp. 2002,

79 IBM FileNet P Release Ntes Knwn Issues readme (readme-ae htm). Nte Applying the fix pack adds the jbss-web.xml file required fr CMA t the WEB-INF directry. (ecmdb ) Switching frm WAR file t EAR file deplyment. If yu chse t deply Applicatin Engine as a WAR file and later decide t redeply it as an EAR file, yu must uninstall Applicatin Engine and then reinstall the applicatin, selecting EAR file deplyment in rder t add the required files t yur setup. If this change f deplyment type seems likely fr yur setup we suggest that yu install Applicatin Engine as if yu wuld deply an EAR file, which will create bth WAR and EAR files, and then use the WAR file t deply yur web applicatin The sub-task T enable passing user credentials t client applicatins applies t WebLgic 9.x nly, nt versin 8.x. The task "T cnfigure Applicatin Engine (WebLgic 8.1.x)" includes the prcedure step T enable passing user credentials t client applicatins. This step applies t WebLgic 9.x nly, and shuld nt be dne fr WebLgic 8.x. When instructed t "Cntinue with 'T enable passing user credentials t client applicatins' n page xxx", instead yu shuld cntinue with the fllwing task: If yu are perfrming a new installatin: Cmplete the installatin task Install Applicatin Engine Sftware Updates. If yu are perfrming an upgrade: Cmplete the Manually cpy custm data in upgrade task "Upgrade Applicatin Engine," step "Upgrade and cnfigure the Applicatin Engine sftware." During Applicatin Engine uninstallatin, the uninstaller prmpts the user whether r nt t preserve custm-mdified files. On upgraded systems the respnse is nt registered crrectly and custm-mdified files are always deleted. During uninstallatin f freshly installed Applicatin Engines the uninstaller wrks crrectly and preserves the files if requested. Applicatin Engine shared directries must be mapped drives, nt Windws shares. The Applicatin Engine installer prmpts fr lcatins fr the fllwing directries: Cnfiguratin Directry Uplad Lcatin Dwnlad Lcatin Lgfile Lcatin On Windws, if these are shared directries yu must map these lcatins t drives n the Applicatin Engine server and enter the mapped drive infrmatin during installatin When silently upgrading frm Applicatin Engine 4.0.x t Applicatin Engine using WebLgic, the web.xml file is nt created. The wrkarund is t d the upgrade using the User Interface During the uninstallatin f Applicatin Engine, the uninstaller remves the file efrms- Integratin.xml, even when the user chses "N" at the uninstall prmpt fr this file. Cpyright IBM Crp. 2002,

80 IBM FileNet P Release Ntes Knwn Issues Wrkarund: Create a backup f the efrms-integratin.xml file befre running the Applicatin Engine uninstaller On a RedHat 5 64-bit system, the Applicatin Engine and Applicatin Engine ISRA Servlet interactive installers will nt run prperly due t prblems with the embedded JRE in Install Shield When installing Applicatin Engine n HP Itanium, finishing r cancelling the Applicatin Engine installer prgram can result in a syntax errr in the cnsle. Yu can ignre this errr, as it is harmless Silent upgrades frm any versin f Applicatin Engine Applicatin Integratin and File Tracker t versin are nt successful. The wrkarund is t uninstall the previus versins and silently install versin as a new installatin. Wrkarund fr running a silent upgrade f any previus Applicatin Integratin versin t Applicatin Integratin : 1. Silently start the uninstaller using the fllwing statement in the cmmand line: MsiExec.exe /X{35907B7D-02E2-490C-8F3B-54C4E3729D90} /qn LICENSE_ACCEPTED="true" 2. Start the Applicatin Integratin versin silent upgrade as a new installatin: ApplicatinIntegratin.exe /s /v"/qn ADDLOCAL=ALL HOST=cm-xtdev01 PORT=8080 APPLICATION=Wrkplace /L*v %Temp%\FnAppIntSetup.txt LICENSE_ACCEPTED=true" Wrkarund fr running a silent upgrade f any previus File Tracker versin t File Tracker : 1. Silently start the uninstaller using the fllwing statement in the cmmand line: Msiexec.exe /X{4291FBBC-C585-43ED F22D8C6FEE9} /qn LICENSE_ACCEPTED="true" 2. At the cmmand line, start the File Tracker versin silent upgrade as a new installatin: FileTracker.exe /s /v"/qn /L*v %Temp%\FnFileTrackerSetup.txt LICENSE_ACCEPTED=true" Wrkplace XT When installing Wrkplace XT and selecting BEA WebLgic Server fr the Applicatin Server, the Cmpnent Manager Cntent Engine URL displays an incrrect prt number, It shuld be ISV If yu plan t use the migratin tl t upgrade yur WebLgic envirnment frm 9.x t 10, and yu have Wrkplace XT installed with user tken cnfiguratin in place, yu must remve the Wrkplace user tken cnfiguratin befre yu attempt t upgrade WebLgic. Use the fllwing steps t prepare fr the upgrade: 1. Lg in t the WebLgic administrative cnsle. 2. Navigate t Security Realms > myrealm > Prviders > Authenticatin. Cpyright IBM Crp. 2002,

81 IBM FileNet P Release Ntes Knwn Issues 3. Click n Lck & Edit. 4. In the list, select the name f the custm prvider yu specified when yu cnfigured user tken supprt. 5. Click Delete, and click Yes t cnfirm the deletin. 6. Click Activate Change. 7. Shut dwn the WebLgic server. 8. Remve the authenticatin-weblgic-9.jar file and the lg4j jar file frm the fllwing directry: <WL_hme>/server/lib/mbeantypes 9. Perfrm yur WebLgic upgrade. 10.Cnfigure WebLgic per the instructins in the Wrkplace XT Installatin and Upgrade Guide, including the ptinal prcedure t cnfigure WebLgic t supprt user tkens fr Wrkplace XT (including Applicatin Integratin, efrms, Recrds Manager, and thers). Cntent Federatin Services-Image Services After a P8 system has been upgraded frm t 4.0.1, attempting t exprt IS Anntatins t Cntent Engine causes the fllwing errr: :23:08,758 INFO [CmmitAnnts_PrdOS_#14] - Cannt query anntatin cm.filenet.api.exceptin.engineruntimeexceptin: E_BAD_CLASSID: Class ISAnntatin nt fund. at cm.filenet.engine.retrieve.adhcclassretriever.getmergedclassinf (AdHcClassRetriever.java:3728) The prblem has been islated t the t Upgrader tl. Wrkarund: 1. Extract the fllwing Image Services addn imprt data xml file frm the Engine-xx.ear file fr yur installatin. Engine-xx.ear\engine.rar\engine.jar\res\CntentEngineISObjects.xml 2. After the t upgrade cmpletes successfully, run the fllwing steps: a. Open the FileNet Enterprise Manager, navigate t the upgraded bject stre, right-click n it, and then click "All tasks" > "Imprt All". b. Under "Imprt Optins" tab, fr the "Imprt Manifest File", click "Brwse", navigate t the file that yu extracted in step 1, then click n "Imprt". When the imprt is cmplete, the message "Imprt Successful" displays. c. Repeat these steps fr each bject stre being upgraded. After these steps are cmpleted, all the CFS-IS addn infrmatin is present in the upgraded bject stre. Cpyright IBM Crp. 2002,

82 IBM FileNet P Release Ntes Knwn Issues efrms If yu select a target platfrm ther than FileNet P8 efrms, then click the Back buttn, bth the selected platfrm and FileNet P8 efrms will be checked when yu return t the Target Platfrm screen. The installatin cmpletes unhindered if this issue ccurs. Nte that users can mdify the platfrm selectin at any time after installatin. Please see "Set General Preferences" in the user help fr instructins n hw t change the selectin after installatin P8eF installer displays varius errrs in the summary windw and in the lg files. These errrs can be ignred and the install is successful When perfrming an uninstallatin f P8 efrms n UNIX HPUX r Slaris, an errr appears if yur installatin sequence is fllws: 1. P8eFrms P8 efrms 4.0.1(AE) 3. P8 efrms (AE) The summary states that an errr ccurred and prduct uninstallatin failed. An entry is entered in the lg file lcated at: /pt/filenet/ae/efrms_uninstall_lg_4.0.txt This errr can be ignred and the prduct successfully uninstalls. Cntent Engine Nvell edirectry versins and earlier running n 32-bit Windws platfrms with a large set f users and grups might experience ut-f-memry prblems and stp respnding, requiring restart. The prblem is less severe with the FTF2 patch. (edirectry returns "bject nt fund" errrs rather than hanging) Centera library paths, required by Cntent Engine when accessing Centera fixed-cntent devices, are nt recgnized by WebSphere Applicatin Server when it is installed n a Slaris 10 machine. As a wrkarund, d the fllwing: 1. Add the fllwing three lines t the file <prfile>/bin/setupcmdline.sh, where <prfile> is the name f the WebSphere prfile created/designated fr Cntent Engine: CENTERA_LIB_PATH=/pt/test/centera/Centera_SDK/lib/32 LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CENTERA_LIB_PATH exprt LD_LIBRARY_PATH 2. Restart the WebSphere prfile When upgrading, if the file stre index is in use and cannt be renamed, n errr message is returned The Upgrader Tl prgram shuld, but desn't, return an errr message and exit if it cannt give a versin name t a versin 3.5.x file stre index (because anther prgram has lcked the index r Upgrader Tl lacks the crrect permissin t rename the Cpyright IBM Crp. 2002,

83 IBM FileNet P Release Ntes Knwn Issues index). As a wrkarund, d the fllwing after Upgrader Tl exits: 1. Using an apprpriate tl (Windws Explrer r UNIX shell), nte the name f each index directry that Upgrader Tl failed t rename. 2. Open the lg file upgrader.lg, lcated (by default) at C:\Prgram File\CntentEngine\Upgrader, in a text editr and lcate the entry cntaining the ld and (expected) new name fr each index directry nted in step A typical entry in this lg file wuld lk like the fllwing (withut carriage returns): INFO StrageAreaCreatr: flder \\file_stre_server\strage\fs_libsys01b\index\fs0 renamed t \\file_stre_server\strage\fs_libsys01b\index\sbc upgrade_libsys01_fs_libsys01b_fs0. 4. Fr each index directry nted in step 1, manually change the ld name t the new name Yu must set the prepared statement cache t 0 n the XA cnnectin pl fr MS JDBC driver If yu are using WebLgic, yur bject stre database name cannt include extended characters. If yu are upgrading an existing bject stre database with extended characters in the name, yu must rename the database in the FileNet P8 system prir t attempting an upgrade WebLgic cannt supprt ObjectStre databases with extended characters in their names A Scket Write errr ccurs n cntent uplad. When using WebLgic 9.2 and Micrsft SQL Server in a Windws envirnment, yu ll see a Scket Write errr n cntent uplad if yu set the client cnfiguratin parameter FileNet.Cntent.PutBlckSizeKB t (10 MB chunks) in the FileNet.prperties cnfiguratin file, r if yu set it prgrammatically (see CnfiguratinParameter.CONTENT_PUT_BLOCK_SIZE_KB). The wrkarund is t set the parameter t 9000 (9 MB chunks) r less IBM recmmends upgrading ne bject stre at a time when upgrading Cntent Engine t During FileNet P8 prduct testing, several prblems were discvered with the standard versin f the Micrsft SQL Server 2005 JDBC Driver, including a server hang in XML Classificatin that culd result in data crruptin. If yu will be using a Micrsft SQL Server database fr the FileNet P8 prduct, cntact Micrsft Supprt and refer t Knwledge Base (KB) article This KB article is nt available as a standard dwnlad, thus the need t cntact Micrsft supprt directly. Dwnlad the sqljdbc_ _<language>.exe file, which is a zipped versin f all driver-related files. There are 924 files in the zip file. The IBM FileNet P8 Installatin and Upgrade Guide references files that are cmpnents f this JDBC driver. Once the updated versin f the driver has been dwnladed, fllw the standard instructins in that guide, but use the files frm the dwnladed fix. T verify that the crrect versin f the driver has been installed, check that the versin number f the sqljdbc_xa.dll file is Cpyright IBM Crp. 2002,

84 IBM FileNet P Release Ntes Knwn Issues The fllwing fur FileNet P8 versin 3.5.x prperties in ObjectStre bjects fr tuning the paging f query results d nt exist in versin 4.0.0: DefaultQueryBatchSize DefaultQueryRwLimit MaxQueryRwLimit EnumBatchSize In versin 4.0.0, the ability t tune the paging f query results is instead cntrlled by three new prperties in the ServerCacheCnfiguratin bject: NnPagedQueryMaxSize QueryPageDefaultSize QueryPageMaxSize Because there is n ne-t-ne mapping between the fur ld and three new prperties, any changes yu made t the default values f the ld prperties in a versin 3.5.x bject stre will be lst when yu upgrade the bject stre t versin Therefre, yu must manually set the values f the three new prperties in the versin ServerCacheCnfiguratin bject if yu want paging behavir fr query results equivalent t that in versin 3.5.x WebLgic crashes when a lng invalid pladdress is prvided The arithmetic peratrs (+, -, *, /) were nt implemented in 4.0 search Althugh duplicate users are nt supprted, Cntent Engine n lnger thrws a duplicate user exceptin at authenticatin Fr JBss nly web servers: The User and Grup Base DN specified during the P8 Cntent Engine installatin must include an LDAP cntainer/nde that is at least ne level up frm the base r yu will nt be able t lgin using P8 Enterprise Manager t create the Glbal Catalg Database (GCD). Fr example, fr Active Directry, specify: "CN=Users, DC=yur_dmain" rather than "DC=yur_dmain". T include mre LDAP cntainers within yur LDAP realm, edit the JBss lgin-cnf.xml and add mre stanzas fr these LDAP cntainers. Refer t the P8 4.0 Dcumentatin: FileNet P8 Administratin > Enterprise-wide Administratin > FileNet P8 Security > Hw t >Cnfigure fr multiple realms Prcess Engine n UNIX platfrms with Image Services versin IS and thse prir t IS4.1.1 Fix Pack5, supprts nly DB2 8.x client sftware that must be installed in the default DB2 installatin directry r SysV has prblems. This restrictin is remved in Prcess Engine fix pack P8PE in cnjunctin with IS4.1.1 FP When creating a new file stre, the default maximum number f elements, 2500, might be t small and cannt be mdified. As a wrkarund, create anther strage area with an unlimited number f elements and attach it t yur existing strage plicy. Then, remve the ld strage area frm yur existing strage plicy. This prcedure allws new elements t g int the new strage area that has an unlimited maximum. Cpyright IBM Crp. 2002,

85 IBM FileNet P Release Ntes Knwn Issues When yu create a prperty template and enter a display name, a default symblic name is als created (usually with the same name as the display name). If yu change the default symblic name frm the Prperty page, an errr message appears. Click OK t clse the errr message. Change the display name t match the new symblic name, r t a different display name that des nt exist in the system, then click Apply and OK t save the change In the System Manager Dashbard, the envirnment detail "app_versin" value fr the Cntent Engine server des nt prvide a cmplete picture f the installed versin. As a wrkarund, determine the Cntent Engine server build number frm the server status web page ( and verify the versin with yur IBM services prfessinal The "Autmatic dcument classificatin" sectin f the Cntent Engine Administratin Help cntains incrrect infrmatin. In "Understanding autmatic dcument classificatin" the fllwing COM API references, which are invalid fr P8 4.0, shuld be ignred: IDispatch interface and Fnk_XMLClassifier.dll. In "Understanding the XML Classifier", the fllwing sentence refers t utdated infrmatin and shuld be ignred: "Fr the versin f Micrsft's XML DOM supprted by the XML Classifier, see the Hardware and Sftware Requirements dcument, included with ther FileNet P8 Platfrm dcumentatin that can be accessed using the Supprt and Services link n the IBM Infrmatin Management supprt Web site < The lg4j.jar file is missing frm the IBM FileNet Cntent Engine Fix Pack P8CE As a result, any attempt t lg n t Wrkplace using Applicatin Engine will fail. T avid the lgn failure, cmplete ne f the fllwing wrkarunds: Install P8CE befre installing P8CE Upgrade frm Applicatin Engine t Applicatin Engine and then install P8CE The maximum rw size f the underlying DB2 database tables is 32 KB. Therefre, chse a minimal set f addns befre creating an bject stre. After the bject stre exists, be aware that each user prperty reduces the rw size frm what is already reserved by the current system and addn prperties. Yu shuld initially allcate string prperties t be as small as pssible; yu can increase the sizes later in FileNet Enterprise Manager. A string prperty with a large allcatin size is mre space efficient if yu create it as a lng string data type; hwever, lng strings have sme functinality limitatins A CONTENT_FCA_FILE_DOES_NOT_EXIST errr displays when multiple NFS clients access the same directry, Cause: The errrs described belw are due t Netwrk File Share (NFS) directry attribute caching n NFS clients (such as Cntent Engine server hst machines). When multiple NFS clients are accessing the same directry, directry updates made by ne f the servers may nt be immediately visible t the ther servers. Specifically, renames f files frm ne directry t anther d nt frce directry attribute caches t be refreshed n ther NFS clients. File rename ccurs when adding a dcument t the file stre. By default, Linux munts have a 60 secnd attribute cache. Other UNIX variants have a similar default. T identify this issue, enable P8 Cntent Engine tracing with Cntent Strage enabled n all Cntent Engine machines. The fllwing errrs are fund in the P8_Server_trace.lg Cpyright IBM Crp. 2002,

86 IBM FileNet P Release Ntes Knwn Issues and the P8_Server_errr.lg files. 1. A file rename ccurs n CENde1. Nte: { } is an example GUID. CENde1.p8_server_trace.lg: T04:54:10.514Z 1D2A1D2A CSTG - rename [/apps/p8/filestre/inbund/fn{ }{ }] t [/apps/p8/filestre/cntent/fn9/fn5/fn8/fn{ }{ }-0] 2. After the file rename, attempts t retrieve the file ccur n CENde2. The file retrieval attempts ccur within 60 secnds f the file rename. CENde2.p8_server_trace.lg: T04:54:10.642Z 7FC27FC2 CSTG - file desn't exist in the cntent directry, will search inbund /apps/p8/filestre/cntent/fn9/fn5/fn8/fn{ }{ }-0 3. CENde2 fails with a CONTENT_FCA_FILE_DOES_NOT_EXIST errr. CENde2.p8_server_trace.lg: T04:54:38.212Z 44A544A5 ENG - ERROR methd name: retrieve principal name: xxxxx Glbal Transactin: false User Transactin: false Exceptin Inf: cm.filenet.api.exceptin.engineruntimeexceptin: CONTENT_FCA_FILE_DOES_NOT_EXIST: The file des nt exist /apps/p8/filestre/cntent/fn9/fn5/fn8/fn{ }{ }- Wrkarund: Disable attribute caching with the "nac ptin" n the Linux NFS munt cmmand. Disabling attribute caching may affect dcument retrieval perfrmance frm NFS file shares (specifically, Cntent Engine file stres) The base versin f WebSphere Applicatin Server that is bundled with Cntent Engine des nt include cluster supprt. T cnfigure clusters, yu must have Cntent Engine installed n servers that are running the IBM WebSphere Applicatin Server Netwrk Deplyment versin If yu are using Web Services Extensible Authenticatin Framewrk (WS-EAF) and want t retrieve the WS-Security header XML string frm within yur custm lgin mdule, yu must specify the fllwing JVM argument fr the Cntent Engine Server: - Dcm.filenet.authenticatin.wsi.needsWSIHeader. (Nte that yu can als add it as an entry t the FileNet.prperties file.) This prperty cntrls whether the WS-Security header XML string is generated fr each WSI request, which has a perfrmance cst. If yu d nt use WS-EAF, it is nt necessary t specify this JVM prperty. This prperty is als nt needed if yu use WS-EAF but d nt wish t retrieve the WS-Security header XML string frm within yur custm lgin mdule. Cntent Search Engine Neither Verity nr Cntent Engine validates user/grup/dmain fr Verity cnfiguratins, and queries might fail During installatin f Verity using the Cntent Engine Verity installer, the errr ": The cmpnent is nt licensed r nt installed n the hst" appears in the errr lg file. Cpyright IBM Crp. 2002,

87 IBM FileNet P Release Ntes Knwn Issues This is a benign errr message; nrmal use can cntinue An errr is reprted during the installatin f K2 Verity n a UNIX platfrm. T reslve this UNIX-specific knwn issue: On UNIX installs, the /pt/verity/data/hst/admin.xml file must be mdified by running it thrugh a cnversin tl such as Ds2UNIX. The file cntains a Windws carriage return that causes the fllwing errr if nt remved: Errr in verity lg.txt file that picked up a <carriage return> between (mde= <carriage return> verbsity= ) within the admin.xml. The carriage return can als be remved manually using the fllwing instructins: Manually edit /pt/verity/data/hst/admin.xml as fllws: Frm: T: <Admin alias="" prt="" listeners="100" hst="" bind="" verbsity="status" mde="" <carriage return> ="" descriptin=""> <Admin alias="" prt="" listeners="100" hst="" bind="" verbsity="status" mde="" ="" descriptin=""> Indexing fr CBR can appear t hang if the maximum number f dcuments per K2 cllectin is very large. A full text index (als called a K2 cllectin) has a maximum practical limit between 500,000 and 8,000,000 bjects (five hundred thusand and eight millin). If yu exceed this maximum practical limit, perfrmance f the full text indexing is dramatically reduced t the pint that the Cntent Engine can appear t hang. If this ccurs, use ne f the fllwing ptins as a wrkarund: Reduce the value f the VerityServerCnfiguratin.MaxObjectsPerCllectin prperty t a value less than the number f bjects in the cllectin currently being written. Change the value f the VerityCllectin.ResurceStatus prperty f the cllectin currently being written t "clsed". After a few hurs, a new cllectin will be created, and the perfrmance f indexing will return t nrmal Repeated cmbinatins f flder.getcntainees call fllwed by a simple query eventually result in a failure during the query and all subsequent query attempts cntinue t fail until the CEMP app server is restarted Cntent search frm the Query Builder f Enterprise Manager r frm a Wrkplace search template returns the fllwing message in the P8 server errr lg (a secnd attempt t run the search succeeds): cm.filenet.api.exceptin.engineruntimeexceptin;can't authenticate n search. Brker name: visdev_brker, Brker address visdev:9900, Dmain, User: k2user, Errr: java.lang.runtimeexceptin: scket discnnected at cm.verity.net.cnnectin.settimeout(unknwn Surce) at cm.verity.net.cnnectin.grabfrmpl(unknwn Surce) Cpyright IBM Crp. 2002,

88 IBM FileNet P Release Ntes Knwn Issues Accrding t Autnmy, this message is due t a new client-side timeut feature intrduced in Verity The default timeut setting fr searches is 1 hur ( millisecnds): -Dverity.resurce.pl.timeutenable=true -Dverity.resurce.pl.timeut= The timeut setting can be cnfigured by passing the fllwing tw parameters t the JVM that runs the applicatin server: -Dverity.resurce.pl.timeutenable=false -Dverity.resurce.pl.timeut= The first line abve causes the timeut setting in the secnd line t be ignred. T cnfigure the timeut setting n WebSphere Applicatin Server: 1. Start the WebSphere administratin cnsle. 2. Navigate t Servers > Server Types > WebSphere applicatin servers. 3. Click ne f the applicatin servers (fr example, server1), and cmplete the fllwing substeps: a. Navigate t Java and Prcess Management > Prcess definitin > Additinal Prperties > Java Virtual Machine > Generic JVM arguments. b. Type the tw lines shwn abve n line in the Generic JVM arguments field, with a blank character between them: -Dverity.resurce.pl.timeutenable=false - Dverity.resurce.pl.timeut= c. Click Apply and then click Save. d. Stp the applicatin server. e. Start the applicatin server. 4. Click Apply and Save. 5. Repeat steps 3 4 fr each f the ther applicatin servers (if any). T cnfigure the timeut setting n the WebLgic Server: 1. Stp the applicatin server. 2. In the startweblgic.sh (UNIX) file r the startweblgic.cmd (Windws) file, add the fllwing lines: UNIX: JAVA_OPTIONS= -Dverity.resurce.pl.timeutenable=false ${JAVA_OPTIONS} JAVA_OPTIONS= -Dverity.resurce.pl.timeut= ${JAVA_OPTIONS} WIN: SET JAVA_OPTIONS=%JAVA_OPTIONS% - Dverity.resurce.pl.timeutenable=false SET JAVA_OPTIONS=%JAVA_OPTIONS% - Cpyright IBM Crp. 2002,

89 IBM FileNet P Release Ntes Knwn Issues Dverity.resurce.pl.timeut= Save yur edits. 4. Start the applicatin server. T cnfigure the timeut setting n JBss: 1. Stp the applicatin server. 2. In the /bin/run.sh (UNIX) r the C:\bin\run.bat (Windws) file, add the fllwing lines: UNIX: JAVA_OPTS= -Dverity.resurce.pl.timeutenable=false $JAVA_OPTS JAVA_OPTS= -Dverity.resurce.pl.timeut= $JAVA_OPTS WIN: SET JAVA_OPTS=%JAVA_OPTS% - Dverity.resurce.pl.timeutenable=false SET JAVA_OPTS=%JAVA_OPTS% -Dverity.resurce.pl.timeut= Save yur edits. 4. Start the applicatin server If yu encunter errrs in versin f Cntent Search Engine invlving Verity spanning lists exceeding a 4 GB limit n HP-UX r AIX systems, refer t CBR Trubleshting fr FileNet CEMP 4.x.x at 01.ibm.cm/supprt/dcview.wss?rs=203&q1=verity+service+des+nt+start&uid=swg &lc=en_US&cs=utf-8&cc=us&lang=all and cmplete the recvery steps shwn in sectin 13.4 Errr in write_huge. As nted in the sectin 13.4, ne f the recvery steps is t upgrade t a newer release f Verity, which yu d by upgrading t IBM FileNet P r (and applying the Cntent Search Engine P8CSE fix pack r later). If yu have nt yet encuntered these errrs in versin f Cntent Search Engine, yu can avid them by nting the requirements in the Cllectin Limits appendix in Verity Cllectin Reference Versin 6.1 regarding supprt fr 64-bit file systems. In particular, nte that yu must enable 64-bit file system supprt n HP-UX r AIX systems and set the value f the Verity parameter VDK_LARGEFILE_SUPPORT t 1. As nted in the IBM FileNet P Installatin and Upgrade Guide, yu can find the Verity dcumentatin n the machine where yu installed Cntent Search Engine, at where hstname is the CSE machine name. FileNet Services fr Ltus Quickr When adding a dcument t a FileNet P8 library, then checking it ut, mdifying it, and checking it back int the library, the First created n infrmatin fr the file changes t the last mdified date and time. The First created n infrmatin shuld display the date and time the file was first added. Cpyright IBM Crp. 2002,

90 IBM FileNet P Release Ntes Knwn Issues When searching a FileNet P8 system in Ltus Quickr Search Center and the search criteria includes nly invalid characters, such as {, },and., the fllwing message appears: "A prblem ccurred during the search. If the prblem persists, cntact yur System Administratr." Instead f displaying this message, the search shuld execute, but n dcuments shuld be returned ISV If yu use the Micrsft Windws installer, yu might see the fllwing errr message: N entry fund: MakeExecutableActin_zg_ia_sf.jar. It is a nn-fatal errr and yu can ignre this errr. This errr is caused by InstallAnywhere If yu want t use the Cnfiguratin Manager tl t deply FileNet Services fr Ltus Quickr prduct, yu must manually mdify the cnfiguratin files generated by Cnfiguratin Manager. In the deplyapplicatin.xml file, change the fllwing parameters frm the default values t the required FileNet Services fr Ltus Quickr prduct values. 1. <prperty name="ear"> <value>c:\prgram Files\IBM\lib\<insert prduct name here>\engine-ws.ear</value> Replace Engine-ws.ear with the FileNet Services fr Ltus Quickr prduct ear file name. Fr example: C:\Prgram Files\IBM\FN Services fr Quickr\fnqs.ear. 2. <prperty name="applicatinname"> <value>filenetengine</value> FileNet Engine is the Cntent Engine applicatin name. Change the value t the applicatin name fr FileNet Services fr Ltus Quickr prduct. Fr example: FNQuickrServices A search with a query string cntaining at least ne hyphen (-) character might return unexpected results. This is due t a hyphen being treated as punctuatin by the P8 search engine. Examples: A search fr returns dcuments cntaining either , r A search fr 9EA8249E-095A-4AFC D BE will nt return dcuments cntaining that exact string. T reslve this issue, append a wildcard character t the end f the search string. Fr example: a search fr 9EA8249E-095A-4AFC D BE* returns dcuments cntaining 9EA8249E-095A-4AFC D BE. Users with a duble-byte character in their user name cannt lg n t a FileNet P8 system using the Quickr Web UI. An "Invalid credentials fr remte server" errr ccurs On HPUX, HPUX-Itanium, and AIX platfrms, the FileNet Services fr Ltus Quickr uninstaller fails if the Java Virtual Machine (JVM) is nt included in the system path. The fllwing errr message is displayed: N Java virtual machine culd be fund frm yur PATH envirnment variable. Yu must install a VM prir t running this prgram. Cpyright IBM Crp. 2002,

91 IBM FileNet P Release Ntes Knwn Issues This issue is caused by InstallAnywhere. Wrk arund: Add JVM t yur path. Fr example: exprt PATH=$PATH:/user/bin/jave.exe If a flder cntains nly subflders (n dcuments), and the number f subflders displayed is a multiple f the page size, then the ATOM feed fr the flder cntains an unnecessary "next" link n the last page. The Ltus Quickr library viewer and the publish dialgs use ATOM feeds Using Quickr Cnnectrs, renaming a dcument causes the dcument cntent t be lst. Wrkarund: T save the cntent, right click the dcument and select Versins. Highlight the previus versin that cntains the cntent, then click Restre. This creates a new versin with cntent using the riginal dcument name Renditin Engine and Publishing Publishing an Excel file cntaining ne r mre Custm Views fails with the jb listed as in prgress n Renditin Engine and as In Wrk in Enterprise Manager. Only publishing t HTML is affected: yu can successfully publish the dcument t ther frmats PDF master and user passwrds cannt be encrypted in a jb ticket XML string fr Cntent Engine Fr Cntent Engine 4.0.1, the PDF master and user passwrds are encrypted in the jb ticket XML string If the Internet Explrer Enhanced Security Cnfiguratin is used n Windws 2003, a security errr message bx is returned when viewing Publish Jb details in the Dmain Manager. Yu must dismiss fr this message bx fr each selectin. Wrkarund: 1. Frm the Cntrl Panel, select Add r Remve Prgrams. 2. Click Add/Remve Windws Cmpnents. 3. In the Windws Cmpnents Wizard, clear the Internet Explrer Enhanced Security Cnfiguratin ptin in the Cmpnents list bx. 4. Click Next, and then click Finish t cmplete the changes Publishing a dcument t PDF r HTML n a Cntent Engine installed n Slaris WebSphere with IBM Java SDK 1.4.2_12 fails t cmplete and eventually times ut. The IBM Java SDK 1.4.2_12 is part f the WebSphere Fix Pack 17. T reslve this issue, d ne f the fllwing: Switch t IBM Java SDK 1.4.2_11. Use the newer IBM Java SDK 1.4.2_ Micrsft Wrd, Excel, and PwerPint dcuments written in Japanese cannt be published. The wrkarund is t add a Registry key. Make the fllwing changes in the Registry t add an AdbeRender key alng with the Adbe key: Cpyright IBM Crp. 2002,

92 IBM FileNet P Release Ntes Knwn Issues 1. Open the Registry. 2. Navigate t the key HKEY_LOCAL_MACHINE\SOFTWARE\LIQUENT\Adbe. 3. Right-click the key, and then click Exprt 4. Specify a lcatin and enter a file name fr the exprt file, fr example, JapaneseFix, and then click Save. 5. Using Ntepad, pen the exprt file yu created. 6. Replace: with: [HKEY_LOCAL_MACHINE\SOFTWARE\LIQUENT\Adbe] [HKEY_LOCAL_MACHINE\SOFTWARE\LIQUENT\AdbeRender]. 7. Duble-click the exprt file yu mdified t imprt it int the Registry The Renditin Engine client API, which is used t publish a dcument t PDF r HTML is slw t initialize n AIX with WebSphere. The slw initializatin results in the first publish peratin timing ut and causing an errr. Wrkarund: Increase the publishing timeut t accmmdate the slw initializatin. The current default setting is 120 secnds. Add tw minutes t that time setting. Yu can access this setting in the Enterprise Manager > rt nde > Prperties > Publishing tab > Queue Item Database Timeut field. NA This update lists the default prt numbers used by IBM FileNet Renditin Engine t add inbund rules t the Windws firewall. It als prvides infrmatin and instructins t cnfigure Renditin Engine 4.0 cnnectins n Cntent Engine. IBM FileNet P8 Prt Numbers used by Renditin Engine T allw Renditin Engine t cmmunicate with Cntent Engine, yu must pen several prts in the Windws firewall. Cnfigure the inbund rules in the Windws firewall t allw the fllwing Renditin Engine prts access. Prt descriptin Default Prt number Liquent input prt 2867 Liquent ntify prt 2868 Liquent event prt 2869 Liquent admin prt 2870 Liquent file transfer prt 2871 Liquent jb queue prt 2872 Database prt (ne f the fllwing): Micrsft SQL Server Oracle Renditin Engine cnnectins n Cntent Engine Liquent sftware (Liquent Java API in vista.jar) running n the Cntent Engine server must cnnect t the Renditin Engine database and t all f the Renditin Engine servers by using the specified prts fr prprietary TCP/IP scket cmmunicatin. The Cntent Cpyright IBM Crp. 2002,

93 IBM FileNet P Release Ntes Knwn Issues Engine Publishing cde makes API calls t the Liquent Java API. The Renditin Engine servers must als cnnect t the Renditin Engine database and cmmunicate with all Renditin Engine servers and with all Cntent Engine servers that are cnfigured t perfrm publishing. Cntent Engine can use a different database than Renditin Engine (fr example, if Cntent Engine uses IBM DB2 then Renditin Engine must use MS SQL Server r Oracle because Renditin Engine des nt supprt DB2). In this case, the prper database driver must be added t the Cntent Engine server and the Cntent Engine applicatin server must have the database driver path added t its class path. Cnfiguring Renditin Engine cnnectins n Cntent Engine T enable publishing t IBM FileNet P8, use Enterprise Manager t cnfigure Renditin Engine cnnectins n the Cntent Engine server. Fr mre infrmatin, see the FileNet Renditin Engine Installatin and Upgrade Guide. T set up a Renditin Engine Cnnectin (REC) n the Cntent Engine: 1. Launch Enterprise Manager as a GCD administratr user. 2. Right-click the Enterprise Manager [<p8 dmain>] nde and select Prperties. 3. In the Enterprise Manager [<p8 dmain>] screen, select the Publishing tab. 4. Verify the Enable Dispatcher checkbx is checked. 5. In the Select Renditin Engine Cnnectin Field, click New. 6. Cmplete the Create Renditin Engine Cnnectin wizard: a. Specify the site with which yu want t assciate this cnnectin. b. Enter a name and descriptin fr yur new cnnectin. c. Select the database type, MSSQL r Oracle. d. Enter the name f the database server. e. Enter the database name (Micrsft SQL Server) r the service name (Oracle). f. Enter the prt number used by the database. g. Enter the database user name (SQL lgin r Oracle user name). h. Click Create. 1. In the Enterprise Manager [<p8 dmain>] screen, click Apply t save yur changes. 2. The new cnnectin is listed in the Select Renditin Engine Selectin list bx. 3. Click Prperties next t the cnnectin t set the passwrd and Cnnectin State. 4. In the <Renditin Engine Cnnectin> Prperties screen, select Set Passwrd. a. Enter the passwrd. b. Click OK, and OK again t set the passwrd. 1. In the <Renditin Engine Cnnectin> Prperties screen, Cnnectin State drp dwn list, select Enabled. 2. Click Apply and then click OK t save the changes. Cpyright IBM Crp. 2002,

94 IBM FileNet P Release Ntes Knwn Issues 3. Click OK t clse the Enterprise Manager [<p8 dmain>] Prperties screen. Enterprise Manager If yu clse Enterprise Manager while an Event is being prcessed, a deadlck errr ccurs in the database. Any attempt t access the event, subscriptin r event actin causes the system t hang, fllwed by an unhandled exceptin errr. T clear the errr, perfrm the peratin manually frm the cmmand line f the DB2 server When yu exprt an bject-valued prperty that cntains a reference t an external bject in anther bject stre, that bject (and assciated bjects) is pulled int the exprt file; when the bject is subsequently imprted, the external reference becmes an internal reference If yu set a custm path in the Lg File Output Lcatin field and clse the Enterprise Manager [p8dmain] Prperties windw, the path returns t the default setting whenever the Prperties windw is re-pened. T utput the lg file int a custm lcatin, yu must enter the path t that lcatin every time yu run Trace Lgging Changes made t index area prperties are nt reflected in the index areas results pane. T display the updated index areas, yu must refresh the parent bject stre An errr is returned when exprting a security plicy D nt use a duble-byte character set (DBCS) user ID t cnfigure a new dmain r mdify an existing dmain. The EMDmainCnfig.xml file becmes crrupted, causing the Enterprise Manager (EM) cnnectin t fail. Yu can restre the EMDmainCnfig.xml file frm a backup cpy. Hwever, if yu d nt have a backup cpy f the file, yu cannt start EM t cnfigure the Cntent Engine Yu cannt add a grup value frm a chice list t a dcument r ther bject. Yu can create a chice list that includes grups. Yu can assign the chice list t a prperty template and apply the prperty template t a dcument class. Yu can then add a dcument and assign it t that class. Yu can then g t the prperties page f the dcument, select the Prperties tab, select Edit List n the Prperty Template value field, click n Add Value Frm Chice List, and successfully add an individual item. Hwever, if yu select a grup frm the chice list instead, the OK buttn is disabled. The capability t add grups is nt supprted in Enterprise Manager at this time Using the Brwse buttn in Enterprise Manager's Create a Strage Area wizard incrrectly recrds a mapped drive as a lcal drive n the Cntent Engine server when yu create a file strage area. As a result, any external prgram attempting t access the remte file strage area, such as the Autnmy K2 Cntent Search Engine, will search fr a lcal drive and fail t cnnect. Therefre, when using the Create a Strage Area wizard t create file strage areas that are remte frm the assciated Cntent Engine server, type in a full UNC path (fr Windws servers) r NFS path (fr UNIX servers), rather than using the Brwse buttn. If a remte file strage area has already been incrrectly created with a lcal path, use the Mve Strage Area wizard t change the path t UNC r NFS (which yu will enter n the wizard's Specify Strage Area Flder screen). Cpyright IBM Crp. 2002,

95 IBM FileNet P Release Ntes Knwn Issues Prcess Task Manager T minimize memry leaks in Prcess Analyzer Task Manager, users must use 1 publisher thread instead f the default f Prcess Task Manager attempts t launch Netscape t display the nline help. It shuld launch Mzilla. Wrkarund t use Mzilla fr AIX and HP-UX: 1. Lgin t the Prcess Engine system as fnsw. 2. Create a bin directry under fnsw's hme directry. Fr example, if the fnsw hme directry is /hme/fnsw, create /hme/fnsw/bin. 3. Mdify fnsw's.prfile t include the abve new directry. 4. Navigate t fnsw's bin directry; fr example, /hme/fnsw/bin. 5. Create a symblic link named Netscape; fr example, in -s /usr/bin/mzilla netscape (assume the full path fr mzilla is /usr/bin/mzilla). Wrkarund t use Mzilla in Slaris: In additin t the abve steps, perfrm the fllwing: Mdify the mzilla script; fr example, edit /usr/sfw/bin/mzilla t include unset LD_LIBRARY_PATH replace "whence" with "which" if whence des nt exist n yur system Prcess Engine In a High Availability envirnment with an Oracle rack where there are multiple ndes fr the Prcess Engine database, varius access prblems can ccur as the result f expected data nt being available when it is requested. Fr example, an Access Vilatin Exceptin ccurs when creating queues, rsters r event lgs frm the Prcess Cnfiguratin Cnsle. In ther situatins, a wrk bject might g the ISI queue instead f the expected queue. Slutin: In an Oracle rack envirnment with multiple ndes fr the Prcess Engine database, thse ndes replicate each ther at a user-definable interval set in the Oracle parameter, MAX_COMMIT_PROPAGATION_DELAY. If the value f this parameter is set t high, the expected data might nt yet be available when it is requested. The value f MAX_COMMIT_PROPAGATION_DELAY shuld be set t The list f applicatin IDs in the ntifymsg tpic is incrrect, and shuld be replaced by the fllwing list: 1 Wrkplace 2 Web Wrkflw 3 Open Client 6 Recrds Manager Cpyright IBM Crp. 2002,

96 IBM FileNet P Release Ntes Knwn Issues 7 Wrkplace XT Custm applicatin Statistics n queues and rsters with start and end time nt starting up crrectly On the Wrkflw Prperties/Web Services/XML Schema tab f the Prcess Designer, an errr ccurs if yu attempt t lad r paste the cntents f a schema file cntaining mre than ne Include When running the Prcess Task Manager n AIX, yu might see warning messages such as "Culd nt lck System prefs" written t the cnsle. These are nly warning messages and d nt degrade the functinality f the Prcess Task Manager In Prcess Task Manager, resetting the security passwrd causes a java.lang.exceptin: Standard errr: initfnsw: get_request() Wrkarund: In Prcess Task Manager, restart the Prcess Engine server If the database cnnectin is lst during a transfer, the Prcess Engine server fails t reestablish the cnnectin and the transfer appears t be hung. When the transfer peratin hangs, n ther prcess can access the islated regin because the transfer peratin lcks the regin exclusively. Wrkarund: Use the fllwing cmmand t restart the Prcess Engine sftware t recver the transfer peratin: initfnsw -y restart When creating Web services using Receive/Reply/Invke system instructins, d nt use parameter names that cntain numbers, special characters, r spaces. Prcess Designer validatin des nt catch these errrs, which will result in invalid Web Services When using the vwtl, an errr (ERR:d56d005c) might ccur indicating that the wrkspace time stamp is stale. Wrkarund: Restart the Prcess Engine server When using WebSphere Business Mnitr, the Mnitr server stps prcessing events frm a full message queue when the number f events reaches 200K-300K vwlg ignres the timestamp entry in the VWPAEventState table and prunes all f the recrds frm the event lg table. Wrkarund: 1. In Prcess Cnfiguratin Cnsle, cnnect t the Prcess Engine server. 2. Right click the Prcess Engine server name and select Prperties. 3. In VWService Prperties n the Runtime ptins tab, select Enable PA. 4. Cmmit the changes. T verify this setting, run vwtl n the Prcess Engine server, and use the 'cnfig' ptin in any regin that has been initialized. The Disable Analysis Engine flag shuld be set t 'n' In a multifrest envirnment (multiple dmains), it is likely that the same user name, such as "Administratr", can exist in mre than ne dmain. If a nn-unique name is specified Cpyright IBM Crp. 2002,

97 IBM FileNet P Release Ntes Knwn Issues as a participant r tracker in a wrkflw, an errr (ERR=d573000a) will ccur if yu use Prcess Administratr t search fr wrkflws when "Edit all fields" is enabled. The search results will nt display fr that query. In a multifrest envirnment, all user names that will be used in a P8 system must be unique. D nt use default user names, such as "Administratr", as a participant r tracker in a wrkflw Usage Reprter des nt display Prcess Engine data McAfee Virus Scanner 8 has a default setting t blck prt 25 in rder t stp Mass Mailing wrms. This als blcks access t the Exchange server and must be disabled r remved befre the cnnectin can be restred Prcess Engine servers are unable t scale beynd 1000CTPM fr WebSphere applicatin servers When wrkspaceid is > 1000, an errr ccurs when pening fr a Wrkflw Milestne Reached. The errr message is "Fr input string: <wrkspace_num> Exceptin Class:java.lang.NumberFrmatExceptin". Milestnes can be viewed frm Wrkplace in the step prcessr r in an wrk item An errr "Clumn index ut f range" ccurs in the Prcess Administratr when switching frm Edit t Read Only mde after perfrming any task n a wrk item. (Tasks include assign/reassign, lck, cmplete, delete, r terminate.) Wrkarund: Click OK in the errr message dialg bx, and then click Find Nw again Stred prcedures are nt created in the Prcess Engine database if the database is Oracle. Use ne f the fllwing prcedures t reslve the prblem, depending upn hw yu execute the standard SQL scripts during Prcess Engine installatin. T run SQL scripts fr Oracle manually befre running Prcess Engine Setup. 1. Cpy the SQL scripts t the destinatin cmputer as dcumented in the Prcess Engine SQL Scripts appendix f the IBM FileNet P8 Installatin and Upgrade Guide. 2. Edit pe_ra_users_default.sql and remve the EXIT cmmand n the last line. 3. Execute the scripts as dcumented in the Prcess Engine SQL Scripts appendix f the IBM FileNet P8 Installatin and Upgrade Guide. T crrect the prblem after the SQL scripts are executed frm Prcess Engine Setup. 1. Cpy the pe_create_stred_prcedures.sql and pe_grant_sp_permissins.sql scripts frm the Prcess Engine installatin media t the destinatin cmputer. 2. Create a new script with the fllwing cntent and save it t the same directry with the scripts cpied in step 1 and save the file with a.sql extensin. -- Must be run by the Oracle sys admin -- example: sqlplus "sys/<passwrd> as sysdba" Rem Example: sqlplus "sys/<passwrd> as sysdba" Rem This script will call 2 prcedures Rem Usage: when calling this rutine the cmmand line must cntain Rem the fllwing items in this rder Rem <run-time user> Rem f_sw Rem set ech n Cpyright IBM Crp. 2002,

98 IBM FileNet P Release Ntes Knwn Issues -- first drp the PE synnyms befre starting t spl the utput. DROP PUBLIC SYNONYM fn_errr; DROP PUBLIC SYNONYM fn_errrtxt; DROP PUBLIC SYNONYM fn_raversin; DROP PUBLIC SYNONYM fn_raversintxt; spl ff exit 3. Start SQL Plus. Fr example: sqlplus "sys/<passwrd> as sysdba" 4. At the SQL prmpt, script name>.sql <F_SW> Where new script name.sql is the new file yu created in step 2 and F_SW is either the default F_SW user r the alias identified fr Prcess Engine Setup An errr can ccur when transferring wrkflws in a farmed Prcess Engine envirnment if the nde the user is cnnected t ges dwn, ending the user sessin. In this scenari, the running Prcess Engine nde takes wnership f the wrkflw transfer, but the farm is still waiting fr a ntificatin that this has taken place. When an active server cnfirms that the ther server is dwn, the wrkflw transfer prceeds. Sample errr Message: Exceptin executing transfer WF RPC : [Err=9c00001a] Unable t lcate a NCH server fr the specified dmain. [Err=9c00001a] Unable t lcate a NCH server fr the specified dmain When ntificatin language packs are nt installed prperly, errr messages fill the lg file Sme users are unable t pen Java applets, such as Prcess Designer, n a 4.0 system even after installing JRE 5.0 update 9 (JRE 1.5_09). The prblem ccurs when JRE 1.4.x was previusly running n the client. Wrkarund: Uninstall the existing JREs and install JRE 1.5_ In Prcess Administratr, if yu click Find Nw when in Edit mde, yu ll be prmpted t unlck any lcked wrk item. If yu click Yes t unlck the wrk items, an incrrect errr message, "Clumn index ut f range," displays. Wrkarund: Click OK in the errr dialg bx, and click Find Nw again t display the wrk items. The wrk items are unlcked crrectly On UNIX-based Applicatin Engines, when upgrading frm P8 3.5.x t 4.0.x, the /pt/filenet/ruter/taskman.lgin.cnfig file is nt updated t the new P8 4.0.x values. Wrkarund: After users have upgraded their P8 3.5.x Applicatin Engine t 4.0.x, they must edit the /pt/filenet/ruter/taskman.lgin.cnfig file and change the values Frm: FileNetP8 { weblgic.security.auth.lgin.usernamepasswrdlginmdule required debug=false; Cpyright IBM Crp. 2002,

99 IBM FileNet P Release Ntes Knwn Issues }; T: FileNetP8 { cm.filenet.api.util.wsilginmdule required debug=false; }; Perfrmance testing n a cnfiguratin with Windws 2003 SP2, SQL Server 2003 and JBss shwed significant increases in respnse times, ramping up t ver 2 secnds in less than 10 hurs. The prblem is reslved by installing the P8PE fix pack fr Prcess Engine and fllwing guidelines in the P8 4.0 Perfrmance Tuning Guide Trailing 00s are drpped when querying binary data frm Prcess Engine database running n SQLServer Wrkarund: Apply IS 4.0 SP5 HFP3 after upgrading/installing The Prcess Analyzer cnnects t the Prcess Engine but des nt transmit events in the VWLg t the Prcess Analyzer. Wrkarund: Verify that the VWServer name is crrectly defined in the Cnnectin Pint, as dcumented in the wrkarund fr ecmdb (see belw in this table). If the name is crrect, run vwtl t create the database views. Start vwtl at a cmmand prmpt. Fr every regin, type the fllwing at a vwtl prmpt: reg X where X is the regin number. Type the fllwing at the vwtl prmpt: createdbviews When prmpted, respnd by typing: v Repeat fr all affected regins PA starts but thrws an errr when trying t prcess cubes due t n data in the f_events table. Wrkarund: Verify that the VWServer name matches the server name defined fr the Cnnectin Pint. T check the VWServer name in the database, execute: select * frm f_sw.vwserver If the name used fr the Cnnectin Pint des nt match, define a new Cnnectin Pint with the crrect name and delete the ld Cnnectin Pint When Cntent Engine and Prcess Engine are cllcated, and Cntent Engine accesses a remte filestre using Nvell Netwrking, Prcess Engine hangs n startup due t cnflict with Nvell Client 4.91 SP3. Wrkarund: Install Nvell Netware Client 4.91 SP When deleting recrds frm the event lgs, recrds that have nt been prcessed by PA Cpyright IBM Crp. 2002,

100 IBM FileNet P Release Ntes Knwn Issues are nt deleted if PA is nt cnnected. Wrkarund: T use vwlg n a Prcess Engine server withut a PA cnnected, use the '- P' ptin, in additin t ther ptins, t delete recrds frm the event lgs. The '-P' ptin frces deletin f recrds that have nt been prcessed by the PA The release des nt supprt Pint-in-Time Recvery n Oracle, IBM DB2 r Micrsft SQL Server Using the registry entry startshmaddress n Windws, depending n where IS starts in memry, a segmentatin vilatin errr can ccur in the vwtime prcess. This typically ccurs within a few minutes f starting the Prcess Engine This has been addressed by IS via the fllwing SCRs: SCR was released against IS and higher n Windws hardware platfrm nly as a fix t ECM # SCR was released against ISTK and higher n Windws hardware platfrm nly as a fix t ECM # This SCR shuld be btained if vwtime crashes with the abve symptm The stringttime functin assignment causes a wrk item t g int the cnductr queue if the string parameter is blank (empty). This issue ccurs in the versin due t changes required fr supprt f dates beynd This issue will be crrected in fix pack versin The timetstring functin assignment returns a "<Null>" string if the value f the first parameter, time_expr, is blank (empty). This differs frm previus versins where the value returned is "" (i.e. an empty string). This behavir is being crrected in fix pack versin eprcess t BPM Transitin eprcess t P8 transitin is supprted fr Web Wrkflw custmers nly. eprcess t P8 transitin is nt currently supprted fr eprcess custmers that use Open Client. (DTS ) The eprcess HTML step prcessr accessing a P8 envirnment des nt wrk in envirnments with large LDAP, greater than 30,000, ppulatins. eprcess t P8 Migratin eprcess t P8 transitin is nt currently supprted fr eprcess custmers that use the Panagn LDAP integratin features. Business Activity Mnitr Cpyright IBM Crp. 2002,

101 IBM FileNet P Release Ntes Knwn Issues A 'Sizelimit Exceeded' errr can ccur in a BAM system with a Micrsft Active Directry server that has a large number f users. Wrkarund: Increase the MaxPageSize setting in the Active Directry t at least tw times the number f users. Cpyright IBM Crp. 2002,

102 IBM FileNet P Release Ntes Knwn Issues Applicatin Engine Rapidly changing the anntatin fnt size in the Image Viewer can cause the brwser t lck Users cannt access the security page n Wrkplace if the accunt has been deleted Using JRE 1.6 n a client machine causes an errr message t appear when using the Image Viewer. Image Viewer functinality is nt affected after dismissing the errr message The versin tl fr Applicatin Engine, versinae.jar, is nt prperly installed in the Wrkplace/WEB-INF/lib directry When yu are changing the clr f yur anntatins while wrking in the Image Viewer, yu cannt see the OK and Cancel buttns if yu are using Firefx 3.0 running n a Macintsh OSx system When yu install Cntent Engine 4.0.x Client files r Prcess Engine 4.0.x Client files n an Applicatin Engine at versin r later, the client installatin prgrams cannt detect the Applicatin Engine installatin. The selectin screen in the installatin prgram shws Applicatin Engine grayed ut. Wrkarund:Yu can still select Applicatin Engine frm the list, even if it is grayed ut. Yu must then enter the current Applicatin Engine installatin path. Wrkplace ISV When a file is saved t a mapped netwrk drive, the file may nt shw as tracked when it is checked back in depending n the user's permissins t the share The Cmpund Dcuments feature des nt supprt keybard actins when mdifying the rder f child dcuments After adding a Sticky Nte anntatin, the values in the Date Mdified field and Date Created field shuld be identical, but instead display different values McAfee Virus Scanner 8 has a default setting t blck prt 25 in rder t stp Mass Mailing wrms. This als blcks access t the exchange server and must be disabled r remved befre the cnnectin can be restred. (Als affects Prcess Engine DTS ) An incrrect value fr the F_subject field is generated by a wrkflw that is designed t launch when an item is filed int a flder The Max number f search results is incrrect fr simple search in Wrkplace and the Prtlet Quick searches Errrs can ccur when saving a search template in the Search Designer. Wrk arund this memry prblem with the Java envirnment by using the fllwing parameter fr the JRE: -Xms 1024m -Xmx 1024m The Max number f search results is incrrect fr simple search in Wrkplace and the Cpyright IBM Crp. 2002,

103 IBM FileNet P Release Ntes Knwn Issues Prtlet Quick searches The Cmpnent Manager des nt start n HP-UX systems running WebLgic. Wrkarund: Mdify the rutercmd.sh file t use the BEA-supplied JRE. Use a text editr t change <ae_install_path>/ruter/jre/bin/java t /pt/bea/jdk150_03/jre/bin/java The default value fr <ae_install_path> is /pt/filenet/ae In the Image Viewer, certain glbal characters cannt be used in the Draw Transparent bx Classes were remved frm the wcm.jar file, causing an errr in the CE_Operatins adaptr. Reslutin: Add javaapi.jar t the Cmpnent Manager classpath in the taskman.prperties file. Mdify the fllwing file: <AE installatin lcatin>/ruter/taskman.prperties Add./wrkplace/WEB_INF/lib/javaapi.jar t the classpath fr Cmpnent Manager If the Site Preference "Use Path Based URLs" is set t Yes, users will nt be able t pen image dcuments in the Image Viewer. T crrectly view published HTML dcuments created with the Renditin Engine, the Site Preference must be set t Yes. If yu are nt using path-based URLs, the image will pen as expected If the File Tracker is enabled while users have multiple-cntent files checked ut, then the users will be able t check in the multiple-cntent file and retain all the saved cntent items. Otherwise, when File Tracker is enabled, users cannt check in multiple-cntent dcuments With edirectry LDAP, anntatin security user/grup search results d nt match the search criteria entered With File Tracker installed, the AppInt installer's cre install path is nt shwn as a File Tracker cre install path until the user clicks n the Next and then the Back buttns. Nte Despite the wrng path being shwn, the installatin is perfrmed crrectly Wrkplace perfrmance n HP-UX with WebLgic 9.2 is slw. Wrkarund: Assign executin rights (chmd 775) t ne f these files: /bea/weblgic92/server/native/hpux11/ipf32/libmuxer.s /bea/weblgic92/server/native/hpux11/ipf64/libmuxer.s Aut launching fr Flder subscriptins with File event and wrkflw expressin fails after an upgrade When running Wrkplace File Tracker in Windws Vista, an errr message appears and Cpyright IBM Crp. 2002,

104 IBM FileNet P Release Ntes Knwn Issues yu cannt use the Delete lcal file ptin. T wrk arund this issue, it is recmmended yu add the Applicatin Engine(s) n which Wrkplace is running t the Trusted Sites list in Internet Explrer. Yu can access this list in Internet Explrer by ding the fllwing: 1. In Internet Explrer, g t Tls > Internet Optins. 2. Click the Security tab. 3. Click Trusted Sites and add the Applicatin Engine(s) t the list f trusted sites When using Advanced Search via the Quick Search prtlet running n WebSphere Prtal 6.0, selecting any search template results in a "404 file nt fund" errr. Yu can avid this errr by setting the pstthreshld parameter t -1 in the web.xml file, which is lcated in <install lcatin>/wrkplace/web-inf/web.xml. After making this change, re-pack the war file and re-deply Wrkplace fr the changes t take effect. Refer t Task 28a-c in the IBM FileNet P8 Installatin and Upgrade Guide fr mre infrmatin n deplying Wrkplace and packaging the war file. Fllwing is an example f the pstthreshld setting in the web.xml file: <cntext-param> <param-name>pstthreshld</param-name> <param-value>-1</param-value> </cntext-param> When yu access Wrkplace frm the Mzilla Firefx brwser versin 2.0.x, multi-select varius dcuments that cntain spaces in their dcument title, and then use the Dwnlad actin, the Open with WinZip ptin is nt available. The wrkarund is t use Internet Explrer An errr ccurs when an Excel dcument cntaining PivtTables is pened directly frm Wrkplace. This prblem is caused by a Micrsft knwn issue. The Micrsft case number is SRX and the Knwledge Base reference is Wrk arund this errr by dwnlading the dcument and saving it lcally. 1. Frm the File Dwnlad dialg, 2. Click Save. 3. Select a lcatin in the Save As dialg. 4. On the Dwnlad Cmplete dialg, click Open Upgrading frm a Wrkplace Applicatin Integratin fix pack t is nt successful and results in errrs when pening Micrsft Office applicatins. If a fix pack is currently installed, the wrk arund is t uninstall the fix pack and install Upgrading frm t succeeds A multi-cntent dcument that cntains TIF and PDF files des nt pen crrectly when a TIF file r any type f image file is selected as a primary file. Wrk arund this issue by ding the fllwing: 1. In cntent_redir.prperties, use the {n_multi_elements} parameter. 2. If yu want t pen multi-cntent dcuments and want t see a list f the dcument elements, add the {n_multi_elements} parameter t the end f the redirect url:image/tiff=/wcmjavaviewer.jsp?{query_string}{n_multi_elements} in the cntent_redir.prperties. Cpyright IBM Crp. 2002,

105 IBM FileNet P Release Ntes Knwn Issues 3. Any element in the multi-cntent dcument regardless f a MIME type being different frm the primary s MIME type Firefx has a new feature in which yu are prmpted fr the latest available JRE if n JRE is installed and nt prmpted fr a JRE if any JRE is installed (even an ld ne). This is cntrary t Internet Explrer behavir as well as legacy Firefx behavir (1.x), Hwever, it is nt a bug. Firefx might prmpt yu t get a JRE that is nt supprted by Wrkplace XT r might nt prmpt yu t update yur JRE at all. If this ccurs, yu need t manually pick up the supprted JRE prvided by Wrkplace XT. This affects bth Wrkplace and Wrkplace XT. If the client has a Java Runtime Envirnment (JRE) that is lder than the supprted JRE versin (fr example, 1.4.2_0), when the Wrkplace XT user launches an applet (such as Search Designer r Viewer) frm within a Firefx brwser, the user is nt prmpted t install the supprted JRE that ships with Wrkplace XT. Instead, the applets are launched using the client s current JRE. The "Use Java Applets" tpic needs t be updated t include the fllwing instructins t dwnlad the JRE prvided with Wrkplace XT befre launching applets. 1. Lg in t Wrkplace XT. 2. G t p.exe, where <servername:prt> is the name and prt number f yur server. 3. At the Firefx prmpt, dwnlad and save the installer file fr JRE 1.5.0_11 n yur lcal hard drive. 4. Run the dwnladed installer file t install JRE 1.5.0_11 n the client. 5. Restart Firefx and prceed as usual t launch the applets. Nte that these instructins are specific fr JRE In Wrkplace, if yu are using Internet Explrer 7.0, yu may get a dialg bx "The webpage yu are viewing is trying t clse the windw? D yu want t clse this windw?" when yu are attempting t clse an Internet Explrer windw. This is a new security feature fr Internet Explrer 7.0 and there isn't a way t disable this dialg. Click OK and cntinue wrking When creating a guest accunt using the Guest Inf setting in the Btstraps site preference, the guest accunt specified changes frm English t duble-byte characters. This issue ccurs after applying the site preference and lgging back int Wrkplace The Tasks page fr wrkflws nw includes tw new features. The Step Name clumn displays an ellipsis t indicate a specific wrkflw includes multiple steps. When yu view the Infrmatin page fr a wrkflw that includes multiple steps, yu can view the names f the steps n the Infrmatin page. Yu must have the apprpriate access rights t view the names f the steps fr a specific wrkflw. Hwever, if yu are assigned as a tracker fr a wrk item, yu can still view the wrkflw details frm the Infrmatin page Tw new My Active Wrkflws site preference settings were added. The Shw step name clumn setting determines when the step name f a wrkflw is displayed in the list view. The Maximum number f rws t return setting determines the number f wrkflws that are displayed. The maximum number is When a child dcument that is filed in multiple lcatins and is then mved r unfiled using the View Cmpund Dcument actin, an errr ccurs. Wrk arund this issue by ding Cpyright IBM Crp. 2002,

106 IBM FileNet P Release Ntes Knwn Issues the mve r unfile actin frm the Brwse view Oracle WebLgic is nt supprted because f a change which added supprt fr HTTP nly and enabled this setting by default If yu are running WebSphere as a Windws service, and yu are planning t install Applicatin Engine r Wrkplace XT using a UNC path fr the cnfiguratin, uplad, and dwnlad directries, yu must set the "Lg On As" value f the WebSphere service t a specific user with write permissins t the share f the UNC path. Wrkplace XT BPM applets in IBM FileNet Wrkplace XT require restart after a sessin timeut. Wrkplace XT uses cntainer-managed authenticatin. The lifespan f a sessin is cntrlled by the sessin timeut value specified by the applicatin server. The timeut perid fr BPM applets in Wrkplace XT is set thrugh the Keep alive interval in site preferences. Hwever, when a Wrkplace XT sessin times ut based n the applicatin server timeut value, the BPM applets sessin becmes invalid and remains s even after the user lgs int Wrkplace XT again. The user must restart the BPM applets after lgging in again. Fr runtime applets, Tracker, Administratr r Java step prcessrs, wrk in prgress at the time f the sessin timeut is lst. Fr Prcess Designer, the user can save wrk t lcal strage and check it in t the bject stre after lgging back in and restarting the applet When using Firefx 2.x in High Cntrast mde, cntrl sheets n search templates r prperties pages becme transparent. (A cntrl sheet is the interface that pens t allw yu t enter r select additinal infrmatin.) As a result, the text behind the cntrl sheet is visible, making the cntrl sheet text difficult t read. IBM recmmends yu upgrade t Firefx 3.x ISV When yu paste a dcument URL frm the Shw Hyperlink actin int anther brwser sessin in a single-signn (SSO) envirnment, the dcument fails t pen. T wrk arund this failure, refresh the brwser page. This failure ccurs because WebSphere autmatically sets the Cache-Cntrl respnse header t n-cache when streaming a Micrsft Office dcument t Internet Explrer. This behavir is the same as the behavir described in the fllwing Micrsft article: If yu plan t use the migratin tl t upgrade yur WebLgic envirnment frm 9.x t 10, and yu have Wrkplace XT installed with user tken cnfiguratin in place, yu must remve the Wrkplace user tken cnfiguratin befre yu attempt t upgrade WebLgic. Use the fllwing steps t prepare fr the upgrade: 1. Lg in t the WebLgic administrative cnsle. 2. Navigate t Security Realms > myrealm > Prviders > Authenticatin. 3. Click n Lck & Edit. 4. In the list, select the name f the custm prvider yu specified when yu cnfigured Cpyright IBM Crp. 2002,

107 IBM FileNet P Release Ntes Knwn Issues ISV user tken supprt. 5. Click Delete, and click Yes t cnfirm the deletin. 6. Click Activate Change. 7. Shut dwn the WebLgic server. 8. Remve the authenticatin-weblgic-9.jar file and the lg4j jar file frm the fllwing directry: <WL_hme>/server/lib/mbeantypes 9. Perfrm yur WebLgic upgrade. 10.Cnfigure WebLgic per the instructins in the Wrkplace XT Installatin and Upgrade Guide, including the ptinal prcedure t cnfigure WebLgic t supprt user tkens fr Wrkplace XT (including Applicatin Integratin, efrms, Recrds Manager, and thers). Displaying a multilingual dcument title is nt supprted in the Send Mail as Attachment ptin. Fr example, if yur client lcale is set t English, it will display English r ther Latin-1 dcument titles as an attachment in the client, but des nt display duble-byte dcument titles. If the client lcale is set t Japanese, it will display nly Japanese dcument titles prperly. It will nt display a dcument tile in ther languages, such as French r German The Cntent Engine fix pack client installer des nt detect a Wrkplace XT installatin. Therefre, it is necessary t chse the "Other applicatins" ptin t run the Cntent Engine client installer fr WrkPlace Xt If a user enables WebSphere integrated security thrugh the Administrative cnsle, the Wrkplace XT lg ut link fails t functin and returns the user t a blank page, instead f re-directing the user back t the Wrkplace XT sign in page The Send Mail actin fr Wrkplace XT fails with an incrrect class errr message. The failure ccurs fr Wrkplace XT versins 1.1.0, 1.1.1, and because the Prcess Engine client installer verwrites the Wrkplace XT mailapi.jar file Wrkplace XT cannt be installed and an errr will ccur n a system running Slaris 10 and HP-UX 11iv3 and a Turkish lcale. Wrkarund: Change the lcale t en_us.utf If yu are running WebSphere as a Windws service, and yu are planning t install Applicatin Engine r Wrkplace XT using a UNC path fr the cnfiguratin, uplad, and dwnlad directries, yu must set the "Lg On As" value f the WebSphere service t a specific user with write permissins t the share f the UNC path. Cntent Federatin Services (CFS-CS and CFS-IICE) When using Recrds Manager with CFS, the RM user must have at least Mdify Permissin rights n the federated dcuments t declare them as recrds. This is different than the P8 native dcuments. Recrds Manager user nly needs "Mdify Prperties" Cpyright IBM Crp. 2002,

108 IBM FileNet P Release Ntes Knwn Issues rights n the P8 native dcuments t declare them as recrds Database passwrd changes are nt applied n WebLgic. If yu update an incrrect passwrd, the lder passwrd remains in the IICE server cache. Wrkarund: Restart WebLgic server t clean ut ld passwrd cache (WebSphere nly) The first time CFS Exprter cnnects t the IICE server, IICE creates the file <CFS_install_path>/FedExprter/bin/rbtc.*.txt. Yu can safely delete this file, as it has n functin. This is a knwn issue f IBM IICE In the Rule Builder page f the Federatr Administratin applicatin, a query that cntains n prperty criteria and n full-text criteria returns 0 results and thrws the exceptin "N prperty r full text criteria in query" when yu click Get Cunt. This is the knwn issue f IICE 8.3 Web Cmpnent. Wrkarund: D nt click Get Cunt when yu create a query that cntains n prperty criteria and n full-text criteria. These types f rules are saved when yu click Apply. When the rule is run, the crrect number f dcuments will be federated An archived Cntent Services dcument is displayed instead f an errr message. Wrkarund: After yu archive a dcument in CS, lg ff frm IDM Desktp befre yu attempt t view the dcument in Cntent Engine The Federatin Administratr applicatin and the IICE Web Client searches use different values fr blean values than IDM Find. Cntent Services des nt supprt blean prperty values and uses 1 fr Yes and 0 fr N. Wrkarund: D nt use "true", "false", "yes", r "n" in yur search criteria fr the Rule Builder page. Use 1 r 0 instead Wrkplace des nt display an errr message when yu attempt t view a federated dcument whse cntent des nt exist. Fr example, an archived CS dcument, an External CS dcument r a dcument that n lnger exists because the surce dcument was deleted after federatin. Enterprise Manager displays an errr message, but Wrkplace pens the inf page f the federated dcument The RM Bulk Declaratin Service (BDS) des nt supprt declaring federated cntent as a recrd. BDS can be used t declare existing dcuments as recrds, but fr federated dcuments the cntent in the surce repsitry is nt prperly lcked dwn when the recrd is declared thrugh BDS. Due t this limitatin, BDS shuld nt be used t declare existing federated cntent as recrds Federated TIFF image dcuments are nt displayed in the Wrkplace Image Viewer. A Save dialg bx is displayed instead. During federatin, the TIFF image was stred in the Cntent Engine with the MIME type image/tif instead f image/tiff. Wrkarund: Edit the cntent_redir.prperties and icn.prperties files n the Applicatin Engine t add the images/tif mime type. See the tpic cntent_redir.prperties file in the P8 Help: Applicatin Engine Administratin > Key cnfiguratin files and lgs > cntent_redir.prperties file fr mre infrmatin n editing the file. 1. Add the fllwing entries t the cntent_redir.prperties file: image/tiff=/wcmjavaviewer.jsp?{query_string} Cpyright IBM Crp. 2002,

109 IBM FileNet P Release Ntes Knwn Issues image/tif=/wcmjavaviewer.jsp?{query_string} 2. Add the fllwing entries t the icn.prperties file: image/tiff=images/mime/tif image/tif=images/mime/tif The Rule Builder page in the Federatin Administratin applicatin des nt display a data map that has been defined. Pssible causes: 1. The repsitry must be selected in "Include Repsitries" list in the IICE Administratin applicatin. Usually the repsitry is included by default. If it is nt included, yu must manually add the repsitry. D the fllwing t add the repsitry: a. Lg in t the IICE Administratin applicatin, and navigate t Manage Wrkspaces > Repsitries. b. Make sure the repsitry is selected in the Include Repsitries list. 2. Make sure that the repsitry credentials are set in the Federatin Administratin applicatin General Cnfiguratin > Passwrds page With IICE 8.3 Fix Pack 1 with WebLgic, if yu deply the CFS Federatr Administratin applicatin in explded mde, its Rule Builder page returns an exceptin in the WebLgic cnsle windw. The errr is benign and des nt affect functinality. Yu can avid the exceptin by deplying the CFS Federatr Administratin applicatin in a WAR file When yu attempt t delete a federated dcument in Wrkplace, an errr message with inaccurate text is displayed. The fllwing message is displayed: The current peratin (delete r mve cntent) is nt supprted r invalid fr the federated dcument. Unable t delete bject {GUID} in enum prperty Versins. CFS des nt supprt deleting a federated dcument frm Wrkplace r Cntent Engine. Mving a dcument t a new flder in Wrkplace is supprted. The type f mve in the errr message refers t mving a federated dcument frm ne strage area t anther ne. Mving t a different strage area is nt supprted (WebSphere nly) Users will nt be able t lg n if yu have installed IICE Subscriptin Event Services but have nt cnfigured fr Single Sign On (SSO). If yu d nt plan t cnfigure SSO, then IBM recmmends that yu d nt install IICE Subscriptin Event Services. Hwever, if Subscriptin Event Services have already been installed, and yu d nt intend t use SSO, yu can use the fllwing wrkarund t enable lgging n. 1. Lg n t the WebSphere cnsle as an Administratr. 2. Navigate t Enterprise Applicatins > VeniceBridge > Web Mdules > SubscriptinServices.war > Target Mappings. 3. Select the server instance where VeniceBridge is installed. 4. Deselect the Enable check bx. 5. Save the changes and restart WebSphere. Nte that Task 2 f the CFS Installatin and Upgrade Guide prvides a prcedure that enables lgging n in envirnments that use SSO but where the IICE Subscriptin Event Services have nt been installed. Cpyright IBM Crp. 2002,

110 IBM FileNet P Release Ntes Knwn Issues If yu receive the errr "Unable t retrieve item" while federating dcuments frm Cntent Services, the cause may be that CFS is running mre threads than CS allws. By default, CS allws 10 simultaneus library requests per user credential (user name and passwrd). Als by default, CFS uses 10 exprt wrkers and 4 additinal run wrkers, ttaling 14 threads, which is mre than CS allws. T increase the number f threads allwed by CS, perfrm the fllwing prcedure: 1. On the IDM server, g t Start > All Prgrams > FileNet IDM > Cnfigure. 2. Select Additinal Preferences. 3. Under the CS library, g t Libraries. 4. Change the value f Active Requests per User t a larger value. 20 shuld be sufficient fr the default CFS values. 5. Restart the RMI bridge Date prperties n federated dcuments frm Image Services may nt display prperly. Image Services des nt stre time r time zne infrmatin fr a dcument. When the dcument is federated int Cntent Engine, the date is stred with the GMT time zne f the Cntent Engine server. Wrkarund: Change the Wrkplace site preference General Preferences > User settings fr display > Time Zne t use GMT time zne. Keep in mind that dcuments added using Wrkplace will als be impacted by changing the time zne t GMT. Fr example, if a user in Califrnia adds a dcument at 11:30am, it will display in GMT as thugh it were added at 6:30pm The http cache directry grws very large and can prevent retrieving federated dcuments. When HTTP streaming is cnfigured, retrieving federated dcuments thrugh Cntent Engine (CE) creates a temprary directry in the http cache directry n the II Cntent Engine server. Fr example, retrieving 1 millin dcuments creates 1 millin flders in the http cache directry. Wrkarund: Manually clear the http cache directry t prevent it frm grwing t large An RMI bridge memry leak causes prcessing t stp. During a federatin run, the Cntent Services (CS) cnnectr reads the entire dcument cntent int memry and cpies the dcument cntent int the IICE temp directry, int memry, and int HTTP cache directry. This causes a memry leak with the RMI Bridge java prcess and with lnger runs can eventually crash the RMI bridge. Wrkarund: Use multiple RMI bridges fr the CS cnnectr When using MS SQL Server, netwrk prblems can place the federatr database in a lcked state. If a netwrk errr ccurs during a federatin run such that the netwrk cnnectin is brken during a transactin, prcessing des nt resume when the netwrk cnnectin is restred. Wrkarund: Stp and restart the database. This is a knwn SQL Server limitatin. Fr mre infrmatin refer t the Trubleshting MS DTC Transactins tpic in the Micrsft MSDN web site, Navigate t MSDN > MSDN Library > Servers and Enterprise Develpment > SQL Server > SQL Server 2000 > SQL Server 2000 Bks Online > Trubleshting > Server and Database Trubleshting > Trubleshting MS DTC Transactins When using Recrds Manager with CFS, recrd lckdwn fails t update the security Cpyright IBM Crp. 2002,

111 IBM FileNet P Release Ntes Knwn Issues settings fr the dcuments in the external repsitry when the Cntent Engine event subscriptin is used. Wrkarund: Dwnlad the RM fix pack P8RM frm the IBM Infrmatin Management supprt page ( ) While running CFS Upgrader Tl and when entering the ID and passwrd t cnnect t the CFS Federatr database, if yu mistakenly enter the ID and passwrd fr the Cntent Engine bject stre database, the upgrade will fail, but the red icn that indicates 'Failed' Status fr the Federatr nde will nt display. The fllwing errr message will appear in the upgrade lg: "This des nt appear t be a federatin database. It is missing the fd_cntent_reference table." The CFS Federatr Administratin applicatin returns an errr when yu lg back in fllwing a failver that ccurs during the prcess f adding a new repsitry passwrd. The issue is that CFS Federatr Administratin applicatin is persisting an invalid URL even thugh a re-lgin is perfrmed If yu use CFS Federatr Administratin applicatin (General Cnfiguratin screen --> Lgging cnfiguratin) t save a lg file with a different name during a database failver, the filename change will fail but will nt be reprted as having failed It takes lnger t federate a single dcument with multiple versins, than t federate each dcument versin as a standalne dcument. Fr example, it takes lnger t federate a single dcument with five versins than it des t federate five dcuments that each has nly ne versin In the Federatr Administratin tl, if rule is added with trailing space, the rule cannt be edited, disabled, r deleted. T wrk arund the issue, disable the rule and create a new rule As yu map the prperties fr Cntent Engine and IS dcument classes during the cnfiguratin f yur CFS-IS system, the mapping prcess fr each dcument class might get prgressively slwer. The slwdwn ccurs when a dcument class mapping is saved t the server. Wrkarund: Reduce the number f "save" peratins by perfrming the mappings f several dcument class pairs at the bject stre level in Enterprise Manager (EM). 1. In Enterprise Manager, select the bject stre name, right click and select "Prperties." 2. On the bject stre "Prperties" windw, select the "Image Services" tab, and click Add/Edit. Yu can define several dcument class mappings here. 3. Perfrm the IS t Cntent Engine dcument class mappings fr the first dcument class. It is nt necessary t save (click OK) after cmpleting each ne. 4. Return t the "Image Services" tab in the "Prperties" windw and click Add/Edit again t map anther pair f dcument classes. 5. After cmpleting the mappings fr a set f dcument classes, click OK r Apply n the bject stre "Prperties" windw t save the entire grup f mappings t the server If yu select a user in the Lckdwn Exceptin List in the IICE FCD prperties page, the Data Type Unknwn errr ccurs. Wrkarund: When definining a fixed cntent device fr use with IICE, the CFS user cannt be a user wh is als included in the lckdwn exceptin list.. Cpyright IBM Crp. 2002,

112 IBM FileNet P Release Ntes Knwn Issues Using systemprperties = ALL with IICE 8.4 FP1 causes the federatin t fail. Wrkarund: Instead f using systemprperties = ALL, specify the CS cnnectr t use individual system prperties. T specify: 1. Create a custm prperty fr the CS cnnectr with this value: systemprperties = <prperty_name_1>;<prperty_name_2>;...;<prperty_name_n>. Each prperty value is delimited with a semi-cln (;). 2. Use the system prperty name (fr example, idmname, idmid) fr each prperty_name value. D nt use the descriptive labels, such as Title and Item ID. Instead, t include the CS Title and Item ID system prperties, use systemprperties= idmname;idmid When using CFS-IICE fr a FileNet Cntent Services repsitry, if a federated dcument is declared as a recrd, certain security changes are applied t the surce dcument in the Cntent Services repsitry. The security changes are as fllws: The Lckdwn Principal specified in the fixed cntent device is granted Admin level access rights t the surce dcument. Users and grups that had Admin r Owner level access rights are granted Authr level access rights t the surce dcument. These users are given Authr rights instead f View rights s they can create a new versin f the dcument,but cannt mdify the existing dcument. N security changes are applied t the users and grups if they are specified in the LckDwn Exceptin list The Exprter intermittently stps prcessing rules after it has idled fr a lng time. Wrkarund: Restart the Exprter Fr Dcumentum, CFS federates nly dcument items. Wrkflw items are nt returned by queries and are nt federated CFS des nt maintain relatinships between the cmpnents f cmpund dcuments. CFS federates all dcuments that meet the search criteria whether the dcuments have relatinships t ther dcuments r nt If a repsitry prvides a sft-delete capability, that is, when the user deletes the dcument it is nt remved permanently frm the repsitry, instead it is left in a state that allws the dcument t be restred by bth the user and the repsitry administratr. In these type f envirnments, if the federatin query returns sft-deleted dcuments, then the dcuments will be federated and made visible via P8. Refer t yur surce repsitry administratr's guide fr infrmatin abut deleting dcuments permanently The fllwing invalid message might be displayed after running a query: The specified rder-by prperty [prperty name] is nt ne f the query selectin prperties. Wrkarund: D nt use a symblic name that already exists in the surce repsitry in the Element clumn f the datamap When federating Cntent Services dcuments, the ICI RMI bridges culd becme unrespnsive and cease t federate dcuments. T avid this issue, run nly ne instance f the exprter and reduce the number f exprter threads t ne. Cpyright IBM Crp. 2002,

113 IBM FileNet P Release Ntes Knwn Issues P8 Prtlets Fr HP-UX systems, if yu click Cancel in the Setup Wizard, a Java errr message is displayed after the prgram exits When the FileNet P8 Prtlets 4.0 uninstaller is run n a UNIX system, an errr message is displayed after the prgram exits The FileNet P8 Prtal Installer incrrectly cnfirms the available disk space, and then the install fails with a disk space errr. The Installer incrrectly calculates the needed free disk space as 93.2MB. The installer actually needs 275MB After running a dcument r wrkflw plicy and clicking OK n the Cnfirmatin page, yu are prmpted t dwnlad a *.jsp page. In spite f the prmpt, the cnfirmatin is successful. This ccurs when yu access the plicy frm the ne f the main prtlets. Wrkarund: Use the Mre link t display the list f dcuments, and then select the plicy. The prmpt fr the.jsp page des nt appear During upgrade frm 3.5.x t 4.0.0, the users that were created in WebSphere Prtal Server befre the upgrade are remved during the LDAP cnfiguratin prcess, and all user preferences and lgins are lst. Only LDAP users are supprted in The IBM FileNet P8 Prtlets Installatin and Upgrade Guide fr WebSphere is missing prcedure infrmatin fr LDAP settings fr bth install and upgrade. In the Installatin Planning and Prcedures > Prerequisites sectin, Step 3 states "Cnfigure LDAP if needed." It shuld state: "Use the WebSphere Administrative Cnsle t cnfigure LDAP using the same settings as the Cntent Engine." In the Upgrade Planning and Prcedures > Prerequisites sectin, Step 6 states "Cnfigure LDAP if needed." It shuld state: "Use the WebSphere Administrative Cnsle t cnfigure LDAP using the same settings as the Cntent Engine." Fr Prtal n WebSphere 5, after cnfiguring LDAP with the Wizard, yu must verify that the LDAP settings n the Prtlet match that f the Cntent Engine. This is verified thrugh the WebSphere admin cnsle. WebDAV Unable t pen Outlk Data File using WebDAV. When a user tries t cnnect t the Applicatin Engine frm Micrsft Outlk (using File > Open > Outlk Data File), the attempt fails and the fllwing errr message appears: "Yu cannt use an Internet address here. Enter a path that pints t a lcatin n yur cmputer r n the netwrk." Entry templates with the same name cannt be distinguished frm ne anther in Site Preferences. If an bject stre has multiple entry templates all with the same name but lcated in different flders, a user will be unable t distinguish between them when using Site Preferences t assciate ne f the entry templates t a flder. The identically named entry templates will appear in the Site Preference interface withut any infrmatin as t which flder they reside in Windws Explrer displays a cnfusing prmpt when dragging and drpping flders. There is a knwn issue when using Micrsft Windws Explrer as the WebDAV client applicatin. When a user drags and drps a flder frm ne lcatin t anther, Windws Cpyright IBM Crp. 2002,

114 IBM FileNet P Release Ntes Knwn Issues Explrer prmpts the user: "Are yu sure yu want t delete fldername?" Whether the user clicks Yes r N, the flder is deleted frm the riginal lcatin and successfully created in the new lcatin. This is the expected behavir, and users shuld nt be cnfused by the prmpt. Micrsft des nt plan t fix this issue, since it nw supprts Redirectr as its WebDAV client A WebDAV user with "mdify prperties" access cannt view a Micrsft Wrd dcument. The dcument shuld pen read-nly. This issue ccurs n Applicatin Engines cnfigured fr SSL Tw entry templates with the same name cannt be distinguished frm ne anther AWebDAV flder assciated with a dcument entry template can be set up s that users can drag dcuments t the flder and the assciated dcument entry template adds the dcuments t the bject stre. This is cnfigured in Wrkplace Site Preferences > WebDAV Preferences > General. Nte that the dcument entry template specified in this preference shuld nt call a declare recrd entry template. This feature des nt supprt autmatically declaring recrds added t the specified flder If yu are using Windws Vista, WebDAV will nt wrk unless the fllwing Micrsft fix is applied: ED1D64&displaylang=en If yu are running n Micrsft Vista, yu cannt save a dcument in Micrsft Office 2007 applicatins using WebDAV. Internatinalizatin Extended characters in the URL must be encded fr efrms Image By Reference feature efrms cells d nt print in test mde in Arabic lcal Htkeys assigned t nn-latin1 characters d nt wrk fr the Wrkplace Java applet buttns Frm Wrkflw Plicy: Wrkflw system data fields mapping: Dates in F_Deadline and F_Reminder cell are nt lcalized in Japanese regin WebLgic 9.2 glbalizatin implementatin requires a BEA patch in rder fr nn-ascii characters t display crrectly. T apply the patch, d the fllwing: 3. Shutdwn WebLgic. 4. Using Smart Update (BEA accunt creatin required fr patch retrieval): a. Remve the ld patch. b. Frm the BEA WebLgic site, lcate the new patch. Patch Infrmatin: ID: 5LMG Passwrd: IE2QQ2KH Cpyright IBM Crp. 2002,

115 IBM FileNet P Release Ntes Knwn Issues 5. Remve the SET PATCH_CLASSPATH frm <bea\user_prjects\dmains\<dmainname>\bin\setdmainenv.cmd. 6. Exit Smart Update. 7. Restart WebLgic. 8. After the patch is installed, set the fllwing values thrugh the Administrative Cnsle: <mydmain> Servers myserver Prtcls tab IIOP tab Advanced Optins [Shw] Default Char Cdeset: UTF-8 9. Apply and restart the applicatin server as necessary Nn-ASCII username is nt supprted fr WebDAV s that are pened using Wrkplace cannt be pened using a lcalized perating system client. Currently, an English perating system client must be used Cntent Engine marking sets d nt have multilingual functinality like chice lists, prperty templates, and dcument classes d with XLIFF efrms Print Services cnverts right-t-left text t left-t-right in Arabic implementatins When Prcess Engine is running n AIX, Prcess Tracker des nt pen prperly with extended characters in the wrkflw subject name A nn case-sensitive title search fails t recgnize the fur variatins f Turkish "i" n a DB2 cnfiguratin A nn case-sensitive title search fails t recgnize the fur variatins f Turkish "i" n an Oracle cnfiguratin Signut/signin r brwser/java applets restart is required when lcale is changed during a sessin Prcess Orchestratin: The WSDL URL cannt handle wrkflw names that cntain extended characters Japanese dcuments cannt be published if the Watermark is checked Adding a Wrkflw Plicy returns a "Parse errr" if the Wrkflw subject cntains Japanese characters n AIX Uni lcale cntent search cannt supprt Japanese characters Dcument Frm Template Plicies d nt supprt the extended character ' ' in "Target Windw Name It is nt pssible t distinguish between Simplified and Traditinal Chinese when creating XLIFF files. This als affects ther languages that have reginal differences. Language selectins shuld be based n language_regin identifier cde (i.e. zh_cn). Cpyright IBM Crp. 2002,

116 IBM FileNet P Release Ntes Knwn Issues efrms PDF print des nt display the characters in the cell depending n the fnt setting ntificatin templates fr Prcess Engine cannt be imprted r updated if fnsw lcale is set t ther than English In Publish Designer, when a duble-byte cnstant value is entered int a prperty template, the cnstant becmes garbled after publicatin. Wrkarund: Edit the field using Wrkplace r Enterprise Manager, and set the crrect value int this field The Publishing functin (Renditin Engine) will nt wrk fr Japanese MS Office dcuments unless the fllwing registry change is made: 10. Select Start->Run regedit. 11. Navigate t the key HKEY_LOCAL_MACHINE\SOFTWARE\LIQUENT\Adbe. 12. Right-click the key and select Exprt menu item. 13. Specify fr example the filename C:\JapaneseFix and click the Save buttn. 14. Open the saved C:\JapaneseFix.reg file in Ntepad. 15. Replace: with: [HKEY_LOCAL_MACHINE\SOFTWARE\LIQUENT\Adbe] [HKEY_LOCAL_MACHINE\SOFTWARE\LIQUENT\AdbeRender] 16. Duble-click the C:\JapaneseFix.reg file t imprt it int the Registry When mre than ne language versins f the Cntent Engine prperties are imprted int the same bject stre, multiple language versins are visible in the Wrkplace UI using Site Preferences Web Applicatin servers must be cnfigured with UTF-8 encding supprt fr nn-english characters. Set the fllwing in WebSphere/WebLgic servers: Fr WebSphere: Servers/Applicatins servers/<server nde> In the Cntainer Settings area: Cntainer Services ORB Service Custm prperties Make sure there is a prperty with: Name = cm.ibm.corba.orbcharencding Value = 0x Save and Restart the applicatin server as necessary. Fr WebLgic: <mydmain> Servers myserver Prtcls tab IIOP tab Advanced Optins [Shw] Default Char Cdeset: UTF-8 Cpyright IBM Crp. 2002,

117 IBM FileNet P Release Ntes Knwn Issues Apply and restart the applicatin server as necessary The Prcess Cnfiguratin Cnsle cannt publish a wrkflw t the WSRR registry if it cntains extended characters Selecting nn-unicde DB2 database character set causes an incrrect exceptin errr message in nn-english envirnment. A UTF-8 character set must be used IBM FileNet Cnnectr fr SharePint Web Parts: An errr message appears when using Japanese characters in a site name after cmpleting a wrkflw step. The step is cmpleted successfully. T view the cmpleted step, refresh the screen by, fr example, pressing Back n yur brwser windw, and then refresh the page IBM FileNet Cnnectr fr SharePint Dcument Libraries: When specific GB18030 Chinese characters are used in task labels fr task rutes,sme characters are nt displayed crrectly IBM FileNet Cnnectr fr SharePint Dcument Libraries: Files that cntain specific Japanese characters in their titles are nt archived because the FileNet P8 cnnectr fails with an HTTP Errr Bad request errr. P8 efrms The JAWS screen reader des nt recgnize fields with the title n the side Large frms might fail t pen r users might see an errr message n pening An efrms template cannt be changed within a dcument r wrkflw plicy Users with "View Cntent" and "View Prps" permissin can insert/delete rws in a table Fr versins f P8 efrms 4.0 and later, any data returned t a date r time cell frm a lkup must be entered in cannical frmat. Dates must be in YYY-MM-DD frmat regardless f the frmat cnfigured fr the cell. Times must be in HH:MM:SS frmat (including the secnds) regardless f the frmat f the cell. Nte Nn-cannical data will wrk with P8eFrms 3.5, Desktp efrms and Frms Manager Yu cannt tab t a frm buttn Tday, Nw, and Randm functin results are incrrect when embedded as cnstants in OFP An ffline frm can be brught nline and saved even if required cells are empty The sample SQL cde in the "Assessment" sample template that cmes with efrms Designer is incrrect A check functin that returns true with alert "xxx" shuld nt display a ppup dialg with the wrd "Errr" in the title. Cpyright IBM Crp. 2002,

118 IBM FileNet P Release Ntes Knwn Issues Cnditinal tabbing/calculatin des nt wrk with Mac/Safari Clicking the Insert buttn in the Insert Picture dialg bx when the user has nt selected a picture t insert disables the Insert and Cancel buttns Clicking the small signature icn brings up tw Signature Verificatin dialgs with Mac/Safari The tlbar Clse buttn des nt wrk by single click with Firefx 1.5 fr Windws Windw resizing prperty always takes effect even thugh it is nt allwed with Firefx 1.5 fr Windws Clicking int a cell with an nblur actin causes the nblur t fire in Firefx 1.5 fr Windws Using the Cell.shwSignatureDialg methd results in an errr n Firefx 1.5 fr Windws In the efrms Designer help, the methd described fr changing the text style fr a buttn label causes an "Object Required" errr when the frm is laded in IBM FileNet P8 efrms and the buttn is disabled If Windws Server 2003 with Internet Explrer 6 SP1 r SP2 is being used as the client, frms clse withut saving the data when the user clicks the PDF buttn n the tlbar r the Save buttn in a picture cell. There is n prblem if Windws Server 2003 is nt being used as a client The side brder fr a Chice list is always visible and cvers ther bjects n the frm in Firefx fr Macintsh The Mdify Participants page is nt brught t the frnt with Firefx 1.5 fr Macintsh In the "Cnfigure the applicatin server fr data access" sectin f the IBM FileNet efrms fr IBM FileNet P8 Wrkplace 4.0.x Installatin and Upgrade Guide, the instructins t install the JDBC driver fr WebSphere cause FileNet P8 t crash. The JDBC jar file shuld nt be cpied t the <websphere_app_server_directry>/lib/ext directry. Instead the user shuld create a flder (fr example, c:\jars) and cpy the jar file there. Next, yu must reference the jar file n the CLASSPATH fr WebSphere, fllwing the steps belw: 1. Lgin t the WebSphere Administrative Cnsle. 2. Click n Servers n the left side f the screen and then click n server1. 3. Under Server Infrastructure, expand Java and Prcess Management and click Prcess Definitin. 4. On the next page, under Additinal Prperties, click Java Virtual Machine. 5. Enter the path and file name fr the jar file(s) that need t be referenced in the classpath textbx. 6. Examples: Cpyright IBM Crp. 2002,

119 IBM FileNet P Release Ntes Knwn Issues c:\jars\msbase.jar c:\jars\mssqlserver.jar c:\jars\msutil.jar c:\jars\jdbc14.jar 7. Click Apply and then Save The Java TlbarButtn.getDisabledIcnUrl() methd returns an incrrect value On Macintsh with a Firefx brwser, the tw spinner buttns n the page tab navigatin bar cause the page tabs t scrll very slwly Cell length limits are lst when a cell wraps Entering a text string that cntains an apstrphe int a Number cell that is frmatted in the general number frmat results in an errr message The character fnt setting in a cell affects whether efrms PDF Print displays the infrmatin When a signature lcks a large number f cells, navigatin thrugh the signature cell becmes slw The registered trademark symbl ( ) cannt be rendered t PDF frmat The frm.merge methd des nt wrk crrectly if the cell is nt fund in the template Multi-select actins d nt wrk in the Wrkflw Manager Wizard if a step includes a cln (:) Attempting t create a dynamic chice list in a table s that the chices are values frm ther clumns in the same rw f the table causes an errr. There are tw methds f ding this: referring t the clumn withut reference t the rw (<<Clumn1>>), and referring t the clumn with the rw specified using the Rw functin (<<Clumn1[Rw]>>). Neither ne f these methds is currently wrking An empty frm displays when deleting cell data that has been signed in a frm data file r wrk item An Internet Explrer errr is returned when tabbing ut f the last field n a frm A cnflict between F_Respnses fields prevents cmpletin f the wrkflw step. This ccurs if yu have an F_Respnses field n bth the frm and the eruter regin After setting a page t nt printable with the Page.setPrintable methd set t false, the page is still printed The clr picker in the Paint Settings and Layut Preferences dialgs des nt functin If yu save a cmplex frm as a TIFF in the CCITTT G4 Fax frmat at 288 dpi, the resulting image is crrupted and unreadable If yu pen an efrm directly, by entering its URL in the Firefx-2.0 address field, the efrm will nt clse after yu click the Launch Wrkflw buttn r the Clse buttn n the Cpyright IBM Crp. 2002,

120 IBM FileNet P Release Ntes Knwn Issues efrm. This behavir can be crrected by adjusting the fllwing Firefx-2.0 settings: 1. Open a Firefx brwser windw. 2. Type in "abut:cnfig" in the address bar. 3. Scrll dwn t the " dm.allw_scripts_t_clse_windws" entry and duble click n the entry t switch the blean cnditin t "true" 4. Clse the windw Frms with cells cntaining a transparent fill d nt functin with Internet Explrer. Desktp efrms Sme message bxes and prgress dialgs appear underneath ther dialgs The JAWS screen reader des nt read page tabs Disabled menu items are read as enabled (incnsistent reading by JAWS screen reader) An errr dialg appears with n descriptin Yu cannt add dcuments with nn-latin1 characters in file names When signing an I-Sign(POP) / I-Sign(IMAP) signature n a frm, the JAWS screen reader reads ut the characters f the passwrd A lkup that returns a large amunt f data int a table can cause the prgram t crash In the "Exprt recrds" and "Imprt recrds" tpics, the Help des nt say that users can exprt data in the XML File and efrms XML Data frmats. In the "Exprt recrds" tpic, the help des nt say that the data fr all cells will be exprted even thugh users can select specific cells fr exprting Generating a PDF using a script with an incrrect target lcatin causes the machine t crash Desktp efrms can pen ITXs and IFXs that are cmpatible with previus versins f Desktp efrms. This feature is nt dcumented in the help. IBM FileNet Cnnectr fr SharePint Dcument Libraries If yu delete a cllectr in IBM FileNet Cllectr fr SharePint Dcument Libraries, the assciated event lg must be manually deleted. T remve an event lg, fllw the Micrsft Help and Supprt site instructins fr remving event viewer lg files If a UFI Cnfiguratin Manager Data Stre database has been restred frm a backup, an unhandled exceptin ccurs if any mdificatins are made t the database. This is because the cllectin surce cnfiguratins dn't get saved during a backup and are Cpyright IBM Crp. 2002,

121 IBM FileNet P Release Ntes Knwn Issues missing frm the Windws Registry (HKEY_LOCAL_MACHINE\SOFTWARE\IBM\EMRC\4.0\Factries) Wrk arunds are t either use the Windws registry prgram t backup and restre the Factries registry entry r t manually recreate the registry entries. T manually create the required registry entry (repeat n each cllectin surce within the cllectr): 1. Open the cllectin surce and make any mdificatin (i.e. select r unselect a cnfiguratin). 2. Und the mdificatin by setting it back t the riginal state. 3. Save The Last Mdified User and Date Last Mdified FileNet P8 system prperties are verwritten when the Mdify dcument security task is used. This ccurs when the Last Mdified User and Date Last Mdified system prperties are mapped t cmparable SharePint system prperties and the Mdify dcument security task is applied t dcuments that are being archived. The results are the initially set SharePint data are verwritten, where Last Mdified User prperty is set t the P8 Cnnectin cnfigured user, and the Date Last Mdified prperty is set t the date and time the dcument's security is was mdified When the File in Flder task is cnfigured t inherit flder security with the ptin t add flder security t dcument security, the flder permissin inheritance is nt prcessed cmpletely. The flder's inherited security frm a parent flder is nt added t the dcument security. Only the explicit security cnfigured fr the flder class is added The versin series dcuments are nt added as minr versins when the Cntentless ptin is applied. This ccurs when the Capture task in a task rute is cnfigured t prcess dcuments as minr versins as well as cntentless dcuments, but the dcuments are incrrectly added as majr versins When using the pst-prcessing task, if the ptin f 'Cpy & Lck Dwn' is implemented, the crawling time f the SharePint site increases fr each query page." When perfrming an imprt/exprt prcess, there are issues n Micrsft Windws 64-bit perating systems. UFI Services Cmpnents must be run in 32-bit cmpatibility mde by using the CrFlags Cnversin Tl (CrFlags.exe) included with Micrsft Visual Studi 2005/.NET Framewrk 2.0. Use the fllwing syntax t run the tl: crflags /win32+<service_ executable_name> An example is: c:\> CrFlags /32bit+ c:\prgram Files\IBM\UFI\Mercure.Hst.exe) Infrmatin fr the SharePint system site clumn is supplied by the SharePint metadata type, such as Title. When an empty SharePint metadata type site clumn is mapped t an IBM FileNet P8 Cntent Engine string data type prperty that is cnfigured t have a required value, this site clumn is successfully prcessed and the IBM FileNet P8 Cntent Engine dcument is created, but the required prperty is assigned an empty string value When multiple cllectrs are cnfigured t prcess the same site cllectin and the site cllectin was nt previusly prcessed, nly ne cllectr is successfully prcessed because nly ne cllectr can create the pst-prcessing site clumns and cntent type. The failed cllectrs d nt execute and the fllwing errr is lgged: Server was unable t prcess request. The bject has been updated by anther user since it was last fetched. Cpyright IBM Crp. 2002,

122 IBM FileNet P Release Ntes Knwn Issues T avid this errr, d ne f the fllwing: Execute a single cllectr against the site cllectin initially. Instead f creating multiple cllectrs t prcess a site cllectin, create ne cllectr with multiple cllectin surces t prcess the site cllectin An errr message appears when using Japanese characters in a site name after cmpleting a wrkflw step. The step is cmpleted successfully. T view the cmpleted step, refresh the screen by, fr example, pressing Back n yur brwser windw, and then refresh the page Fr IBM FileNet Cnnectrs fr SharePint, if bth WebParts and Dcument Library cnnectrs are installed t the same server, uninstalling the Web Parts slutin causes the remaining User Administratin web part t becme unusable. Fr example: - Existing web parts n pages will shw an errr indicating that they cannt be laded. - If attempting t add a new User Administratin web part, it is still listed as an ptin, but attempts t add it will cause an errr message t be displayed. T fix this prblem, use either the Central Administratin web client r the cmmand line Stsadm.exe and: 1) Retract the Administratin web part slutin file 2) Re-deply the Administratin web part slutin file Nte If bth prducts are installed and yu uninstall the Dcument Library cnnectr, there are n issues IBM FileNet Cnnectr fr SharePint Dcument Libraries versins and releases cannt be cllcated with Recrds Crawler r Manager The Cnnectr Services web.cnfig file sectin in the "Fine-tune perfrmance settings" tpic incrrectly identifies the lcatin f the web.cnfig file. The sectin shuld read as fllws: Cnnectr Web Services allws yu t custmize yur cnfiguratin using the web.cnfig file. This file allws yu t ptimize the tasks yu need t perfrm. The web.cnfig file is a cnfiguratin file fr the Web Services web site and is lcated at: <SharePint_install_drive>\Inetpub\wwwrt\FnSpWebServices Currently, the "Run the archive prcess' in the imprt_prcess.htm tpic includes the prcedure fr starting the archive prcess: T run the archive prcess 1. Frm the the server where the Cnnectr fr SharePint Dcument Libraries is installed, pen the Micrsft Windws Cntrl Panel. 2. Select Administrative Tls, and duble-click the Services applet. 3. In the Services applet, manually start the Task Ruting Engine service This prcedure shuld als include instructins fr stpping the archive prcess: T stp the archive prcess 1. Frm the the server where the Cnnectr fr SharePint Dcument Libraries is installed, pen the Micrsft Windws Cntrl Panel. 2. Select Administrative Tls, and duble-click the Services applet. 3. In the Services applet, manually stp the Task Ruting Engine service. Cpyright IBM Crp. 2002,

123 IBM FileNet Cnnectr fr SharePint Web Parts IBM FileNet P Release Ntes Knwn Issues NA C-Lcatin with Dcument Libraries v2.2 Fr cllcatin f IBM FileNet Cnnectr fr SharePint Web Parts with IBM FileNet Cnnectr fr SharePint Dcument Libraries, Dcument Libraries must be at versin with the patch added prir t installing versin f IBM FileNet Cnnectr fr SharePint Web Parts n every server where the tw prducts are cllcated. D nt install v2.2.0 f IBM FileNet Cnnectr fr SharePint Dcument Libraries after installing versin f IBM FileNet Cnnectr fr SharePint Web Parts Using IBM FileNet Cnnectr fr SharePint Web Parts with Wrkplace XT requires tkens t be enabled fr the Applicatin Engine. If they are nt enabled, after lgging int SharePint, when a user selects t pen a dcument r launch a wrkflw frm a FileNet web part that is cnfigured fr Wrkplace XT, the user will be prmpted t lg n t Wrkplace XT. T enable tkens see IBM FileNet P8 help tpic: FileNet P8 Administratin > Applicatin Engine security T integrate IBM FileNet Cnnectr fr SharePint Web Parts with Applicatin Engine/Wrkplace, Wrkplace must be installed with applicatin-managed authenticatin. If yu want t integrate IBM FileNet Cnnectr fr SharePint Web Parts with an existing instance f Applicatin Engine/Wrkplace that uses cntainer-managed authenticatin, yu need t make ne f the fllwing changes: Uninstall Applicatin Engine/Wrkplace and reinstall it t use applicatin-managed authenticatin. Install a separate applicatin-managed instance f Applicatin Engine/Wrkplace t integrate with IBM FileNet Cnnectr fr SharePint Web Parts. Nte that any Wrkplace installatin integrates successfully with IBM FileNet Cnnectr fr SharePint Web Parts In the IBM FileNet Advanced Search web part, the "is null" r "is nt null" peratrs are ignred. T search fr values that are null r nt null, use the "is equal t" r "is nt equal t" peratr cmbined with a blank value When a deplyed Admin Web Part fr is upgraded t 2.2.1, the deplyed admin Web Part returns the fllwing errr: "Web Part Errr: A Web Part r Web Frm Cntrl n this Page cannt be displayed r imprted. The type culd nt be fund r it is nt registered as safe." Wrk arund: After upgrading t 2.2.1, delete existing User Administratin web parts frm any pages where deplyed and re-add the User Administratin web part t thse pages In a new brwser sessin, if the first dcument yu attempt t pen in the brwse web part is a Micrsft Office dcument (Wrd r Excel), the dcument des nt pen. Instead, the default time zne lcatin displays as the name. If yu press OK it will fail. If it fails, r yu cancel, then repen the dcument, t crrect the prblem. Des nt ccur fr nn-msoffice files. Cpyright IBM Crp. 2002,

124 IBM FileNet P Release Ntes Knwn Issues ISRA Integratin Anntatins cannt be saved when repening an image. Cntent Engine Java and.net APIs When using a WebLgic applicatin server, a BEA patch is required t reslve failures that can ccur when the Cntent Engine API is participating in a transactin. In a WebLgic envirnment, the Cntent Engine server des nt return applicatin exceptins if all f the fllwing are true: The API/client is participating in a transactin. The API/client is using IIOP (wlclient.jar). The API/client is executing as a thick client (nt inside f the applicatin server). In this envirnment, the client instead always sees a general transactin failure (E_TRANSACTION_FAILURE), with n way t determine the specific reasn fr the failure. Cntact BEA supprt, referencing CR , t btain their patch and installatin instructins Querying fr metadata If yur query is intentinally written t retrieve zer result rws, fr the purpse f getting the metadata withut incurring the perfrmance verhead f fetching the rws, n metadata will be returned. The JDBC prvider implements ResultSet.getMetaData() by checking the first clumn returned in the first rw f results. If there are n result rws, the metadata is empty. The JDBC prvider des nt currently expse any way t get the metadata in such cases. Instead f querying fr zer result rws, include "TOP 1" in the query. This will return a single result rw, and the metadata will be available Yu cannt use the EJB transprt frm applets under WebLgic. When running under BEA WebLgic, a knwn issue exists that restricts the interactin between the FileNet P8 4.0 Cntent Engine APIs and BEA s mechanics fr accessing EJBs frm applets. The issue is dcumented in "Accessing EJBs frm Applets" n the BEA web site: AuditDefinitinList.add() fails t thrw an exceptin when an illegal bject is passed. Updating a list bject with illegal bject types is allwed, but a subsequent save peratin fails with a ClassCastExceptin. In a future release, stricter type checking n list update methds such as add will be perfrmed. Attempts t update a list-type bject with an illegal bject type will result in an exceptin N exceptin is thrwn when setting cntainment names f DynamicReferentialCntainmentRelatinship bjects that have a name that exceeds 255 characters. A cntainment name that is lnger than this limitatin is autmatically truncated t 255 characters. Cpyright IBM Crp. 2002,

125 IBM FileNet P Release Ntes Knwn Issues The Cntent Engine APIs supprt Crystal Reprts XI, but d nt supprt Crystal Reprts XI R (Java API nly) Nt all features f the JDBC prvider are implemented. These features are generally methds that are utside the scpe f the primary use case (read-nly reprt writer). Because the JDBC prvider is cmprised largely f nn-expsed classes implementing standard interfaces, behaviral details f these methds cannt be supplied as Javadcs. This infrmatin will be prvided separately in a future dcumentatin refresh r prduct release Clcks n the P8 platfrm engine machines must be synchrnized t successfully run APIs. As dcumented, the islcked() methd des a calculatin based n the LckTimeut prperty and cmpares it t the current system time. Because that calculatin is perfrmed n the client system, the result might be incrrect if the client and server clcks are nt synchrnized If a client applicatin attempts t access an undefined class descriptin, the server thrws the fllwing exceptin: "API_PROPERTY_NOT_IN_CACHE: Prperty Id nt fund in prperties cllectin." This exceptin will be replaced by a mre meaningful exceptin in a future release OIIDs are nt handled cnsistently in backward cmpatibility mde. The OIID prperty, and the ability t reference an bject by OIID, was remved frm the IBM FileNet P8 Platfrm Cntent Engine 4.0 API. Fr backward cmpatibility, the native Cntent Engine query returns the ID when yu select OIID. (Running the same query manually frm the IBM Enterprise Manager, yu'll see the ID, nt the OIID.) Fr a Search.executeXML call, the Cntent Java API des nt return the ID in the XML, but synthesizes and returns the traditinal OIID value. Hwever, when the Cntent Java API encunters an bject reference that is nt a GUID, a path t the bject is assumed and an attempt is made t retrieve the requested bject by path. Since there is n attempt t emulate reference by OIID (as is dne fr the executexml call), an exceptin is thrwn indicating a bad path name. Wrkarund: Specify ID instead f OIID in yur query Incnsistencies ccur between CntentTransfer.RetrievalName.MaximumLength and what is returned by an exceptin. Althugh the value f the MaximumLengthString metadata prperty fr the CntentTransfer.RetrievalName prperty is 2083, the maximum length allwed by the server fr that prperty is 255. If yu attempt t set the RetrievalName prperty t a string that is greater than 255 characters in length, an E_BAD_VALUE exceptin is thrwn When running a.net client applicatin created frm the.net API r the COM Cmpatibility layer using Visual Studi 2005 with Web Service Enhancements (WSE) 3.0 installed, r when using FileNet Enterprise Manager with WSE 3.0, yu might experience high memry usage r an OutOfMemryExceptin exceptin when yu stream large Message Transmissin Optimizatin Mechanism (MTOM) attachments. This prblem ccurs because WSE 3.0 buffers attachments befre they are sent, ptentially creating very large buffers. When using WSE 3.0, yu cannt stream MTOM attachments withut buffering. Micrsft has a WSE htfix available that allws prper, nn-buffered streaming f cntent upladed ver MTOM, which des nt require the entire surce cntent t be laded int Cpyright IBM Crp. 2002,

126 IBM FileNet P Release Ntes Knwn Issues memry at nce. Fr mre infrmatin, see article n the Micrsft supprt site: This htfix is nt available fr general dwnlad; t btain it, yu must call MICROSOFT Setting VerityIndexArea.RtDirectryPath t a UNC path, netwrk share, r munt pint will cause indexing errrs under high stress. Wrkarund: Use the new VerityIndexArea.TempDirectryPath prperty t specify a remte path that is accessible t all Autnmy and Cntent Engine servers. Use the VerityIndexArea.RtDirectryPath fr a lcal path n the Autnmy server that will be ding indexing. Nte that when RtDirectryPath is used, nly the Autnmy server hsting this path can write fr a given index area r the cllectins it cntains. Refer t the reference dcumentatin fr VerityIndexArea.RtDirectryPath and VerityIndexArea.TempDirectryPath fr mre infrmatin Cntent Engine clients based n a prir release thrw an "Unsupprted API Class" when attempting t return all prperties frm an bject that includes the CFSImprtAgentCnfiguratin bject as a prperty. CFSImprtAgentCnfiguratin is a new class in this release. The bjects that can cntain CFSImprtAgentCnfiguratin are Dmain, VirtualServer, and ServerInstance. It is nly when getting all prperties f these bjects that the issue can ccur. There is n client issue when retrieving specific prperties f these bjects. The wrkarund is t update the Cntent Engine client t the current release The BatchItemHandle methds getexceptin and hasexceptin d nt currently wrk as designed. These methds d nt indicate the items that failed in the UpdatingBatch peratin. A failed UpdatingBatch returns nly a single exceptin, which applies t the batch as a whle The VerityServerCnfiguratin.MaxBatchSize prperty shuld nt be set t a value higher than Setting this prperty t higher values can result in Autnmy K2 returning the errr "Invalid dcument ID/key. (-25)". The dcument that triggered the errr will nt be indexed. Cntent Engine Web Service If an authenticatin errr ccurs while a client applicatin is using the Cntent Engine Web Service transprt with the MTOM endpint ( an bscure errr message is generated instead f a nt authenticated errr message The Cntent Engine 4.0 web service is implemented using a ISV OEM prduct: Systinet Server fr Java (SSJ). Using the Systinet Server Cnsle, sme prtins f the Cntent Engine 4.0 web service can be administered r debugged. Our dcumentatin als recmmends that administratrs lg n t the Systinet Server Cnsle and change the passwrd fr the "admin" accunt frm its default value f "changeit". Hwever, when Cntent Engine is running n WebLgic 9.2, the Systinet Server Cnsle cannt be accessed. The wrkarund is as fllws: 1. Shut dwn the WebLgic applicatin server. Cpyright IBM Crp. 2002,

127 IBM FileNet P Release Ntes Knwn Issues 2. Edit the fllwing file: <WebLgic dmain hme>\cnfig\cnfig.xml. 3. Insert the fllwing element, <enfrce-valid-basic-auth-credentials>false</enfrcevalid-basic-auth-credentials> within and at the end f the <security-cnfiguratin> element. 4. Restart the WebLgic applicatin server When using the SOAP endpint t uplad large cntent, an ut-f-memry exceptin n the server during the decding f the cntent attachment can be incrrectly interpreted as the end f the stream. The result is an empty cntent element fr the dcument with n indicatin f an errr having ccurred. Cntent Java API Cmpatibility Layer The fllwing exceptins are accidentally written t the lg4j lgs n ccasin. ERROR ExceptinUtil - Caused by: java.lang.nsuchmethdexceptin: cm.filenet.api.cre.factry$objectstre.getinstance(cm.filenet.api.cre.cnnecti n, java.lang.string) ERROR BadPrpertyValueExceptin - [thrw] There is n prperty named DefaultReservatinType n CE class null. cm.filenet.wcm.api.badprpertyvalueexceptin: There is n prperty named DefaultReservatinType n CE class null. These are internally-handled exceptins, and can be ignred. Lgging f these exceptins will be suppressed in a future fix pack r release The XML returned by Flder.getCntaineesXML({BaseObject.TYPE_FOLDER},null) des nt return mst nn-bject prperties as in previus releases. Instead, nly a small number f well-knwn prperties are returned The requirement t prefix Cntent Java API URLs with "cemp:", intrduced by DTS , has been remved as f the release. If the "cemp:" prefix exists in the URL, it is ignred Ptentially degraded perfrmance when using the default lg4j.xml cnfiguratin file in a JBss applicatin server envirnment. Lgging in a JBss applicatin server envirnment is cntrlled frm a lg4j.xml cnfiguratin file. The default lg4j.xml file distributed with JBss defines sme appenders with lgging levels inherited frm the parent rtlgger but des nt specify a pririty (lgging level) fr thse appenders. The result is that lg4j defaults t the DEBUG level. The DEBUG level in FileNet P8 writes detailed utput t the lg file, which can severely impact system perfrmance. (See "Perfrmance Cnsideratins" in the Lgging tpic f the Cntent Java API Develper's Guide.) Wrkarund: T prevent significant r unexpected lgging that can lead t degraded perfrmance, yu can mdify the default JBss cnf/lg4j.xml file, specifying a pririty f ERROR fr the rt categry. Nte that this might nt be desirable if yu need r want t see JBss debug-level lgging messages. As an alternative, yu can specify an apprpriate lgging level (fr example, ERROR) when defining FileNet P8 appenders, thus preventing the use f the default JBss rt level f DEBUG A new methd signature, getcntentelement(cntentelement, deferredopen) Cpyright IBM Crp. 2002,

128 IBM FileNet P Release Ntes Knwn Issues has been added t the Anntatin, Dcument, and VersinSeries interfaces but is nt fully dcumented in the 3.5.x Cmpatibility Layer javadc. The new signature behaves similarly t the existing getcntentelement signatures, but with the additin f a blean-valued deferredopen parameter. When deferredopen is false, the methd behaves identically t getcntentelement(cntentelement); that is, the specified cntent transfer elements are immediately retrieved and returned in a TransprtInputStream bject. If the value is true, the API defers cntent retrieval t sme later time, such as when a subsequent call t TransprtInputStream.read() is made, and returns an empty TransprtInputStream bject. During the perid f the delay, the returned TransprtInputStream bject cntains n cntent, but its prperties (such as filename, MIME type, and cntent size f the cntent element, if knwn) accurately reflect the cntent t be retrieved. Yu can use the prperty accessr methds n this deferred stream in the same manner as used n the immediately retrieved stream A new cnfiguratin prperty, NnXMLUnicde, has been added t the wcmapicnfig.prperties file. This prperty applies nly t the Cntent Java API cmpatibility layer, and addresses the issue f nn-xml characters (cntrl characters, fr example, 0x13) in a prperty f a Cntent Engine bject. In an applicatin that uses the Cntent Java API cmpatibility layer, cntrl characters in an bject's prperty result in an errr when the applicatin attempts t pen the flder cntaining the bject. The NnXMLUnicde prperty is used by the Cntent Java API methds that return prperties in the frm f XML string data, f Cntent Engine bjects. Fr example, ObjectStre.getCheckutListXML and Dcument.getVersinsXML are tw such methds. Depending n the value f the NnXMLUnicde prperty, the XML methds in the Cntent Java API will r will nt remve nn-xml Unicde (cntrl) characters frm prperty data returned by the XML methds. The NnXMLUnicde prperty ptins are as fllws: If the NnXMLUnicde prperty is nt present in wcmapicnfig.prperties, then the XML methds d nt remve nn-xml Unicde (cntrl) characters frm prperties cntained in the XML returned by the methds. If the NnXMLUnicde prperty is included but is nt set with a value, fr example, "NnXMLUnicde = ", then nn-xml Unicde (cntrl) characters are stripped frm all prperties cntained in the XML returned by the methds. If the NnXMLUnicde prperty is included and is set with a value, fr example, "NnXMLUnicde=###", then the nn-xml Unicde characters are replaced by that value fr all prperties cntained in the XML returned by the methds. Nte that the fllwing XML Unicde characters are allwed in prperty values; that is, using them des nt result in an errr. 0x9 0xA 0xD 0x20 thrugh 0xD7FF inclusive 0xE000 thrugh 0xFFFD inclusive Cpyright IBM Crp. 2002,

129 Cntent Engine COM API (Cmpatibility Layer) IBM FileNet P Release Ntes Knwn Issues Delayed respnse n COM API Cmpatibility Layer MemberfGrup prperties If yu are using Micrsft Active Directry as yur authenticatin prvider and if a user r grup is a member f a large number f grups, User.MemberfGrups and Grup.MemberfGrups prperty respnses can take an excessive amunt f time t cmplete. If yu experience perfrmance degradatin in this envirnment, cntact IBM Custmer Supprt. Prcess Engine API Platfrm: AIX5.3 with DB2 9.2 database. Wrkflw histry fr a wrk bject is nt being stred. Calls t VWParticipantHistry and VWStepWrkObjectHistry will fail due t the inability t retrieve a VWWrkflwHistry bject frm a WrkObject bject. Upgrade t DB2 9.5 t crrect this issue FileNet P8 Dcumentatin Help system and Search functinality The internal search engine used in FileNet P8 help smetimes returns false-psitive results when searching fr a phrase in qutes. The returned tpics might nt cntain the phrase althugh they will cntain the individual wrds that make up the phrase The FileNet Site Publisher (FSP) and Team Cllabratin (TCM) prducts are n lnger available. References t these prducts in the fllwing lcatins f the P8 nline help can be ignred: Web Applicatin Tlkit Javadc: the WebCntentEntryTemplate tpic is nw bslete. Table f Cntents: Site Publisher and Team Cllabratin Manager entries under Enterprise-wide Administratin/Startup and Shutdwn/Expansin Prducts. The ecm_help directry structure: the fspaddn flder and "fsp" subflder, lcated under "ce_help/featureaddns" The P8 help search highlight feature des nt wrk fr sme Latin 1, special characters, and duble byte characters If yu install the help fr the new FileNet Wrkplace XT prduct and any f the fllwing expansin prducts exist n the same FileNet P8 dcumentatin server, the Wrkplace XT entries d nt display as expected in the FileNet P8 Help table f cntents. Yu can fix this prblem by applying the nted fix packs frm the IBM Infrmatin Management supprt Web site < Expansin Prduct Fix Pack Cpyright IBM Crp. 2002,

130 IBM FileNet P Release Ntes Knwn Issues FileNet Prcess Analyzer FileNet Prcess Simulatr FileNet efrms P8PADOC P8PSDOC P8EFDOC The FileNet P8 Help Search functin des nt supprt queries that cntain an apstrphe Wrkplace XT nly: In the efrms help, any actins/functins that are listed as being lcated under Authr, Tls r Authr, Advanced Tls are actually lcated under the Tls drpdwn menu in Wrkplace XT The bullet item fr Image Viewer in the tpic "User Interface (UI)" (under "Applicatin Engine") cntains a link t the "Abut anntatins" tpic in the FileNet P8 Help. This link pints t an internal IBM/FileNet server The fllwing IS fields and definitins were missing frm the Dashbard Help dcumentatin: AllcateIds: A range f cntiguus Image IDs allcated per system base. GetServerInf: Netwrk address and default cache name fr a specific strage library server Wrding regarding certified prfessinal training in the "Abut this Dcument" tpic in the installatin guides fr varius FileNet P8 expansin prducts needs t be updated t read: Installatin by a FileNet Certified Prfessinal (FCP) Recmmended. Fr mre infrmatin n the FCP prgram, refer t the IBM Infrmatin Management Training Web page < The help directry page has bslete links t Team Cllabratin Manager (TCM) under "Help fr administratrs" and "Help fr end users." There is an incrrect link in the "Imprt the sample dashbard fr P8 BPM prcesses" ( mprt_dashbard.htm) tpic. The crrect URL fr the "Install the industry-specific dashbard" hyperlink is: Use this URL t crrectly access the prcedure fr imprting the sample dashbard int the Dashbard client The FileNet Dashbard dcumentatin des nt currently list and define the PCH cunters that supprt numerus prducts at this time Yu can cnfigure Image Viewer t use the Quick Start feature t speed up the time required t launch the Image Viewer applicatin. When a user typically pens an image with Image Viewer, there is a slight delay while a new brwser sessin and the Java applicatin are initialized. Yu can cnfigure Image Viewer t initialize an Image Viewer sessin at the same time that a web brwser sessin is started s that Image Viewer Cpyright IBM Crp. 2002,

131 IBM FileNet P Release Ntes Knwn Issues lads quickly when a user pens an image. When Quick Start is enabled n a Windws client, an icn is displayed in the System tray (bttm right f the Windws Desktp) and a menu item is added t the Start > Prgrams > Startup menu. If the machine is rebted, the Quick Start feature remains enabled. The Quick Start feature is disabled by default. Yu must manually cnfigure Quick Start fr yur site. Once cnfigured, each end user can enable r disable Quick Start n a client as needed. See Enable Image View Quick Start fr instructins n enabling r disabling the Quick Start feature n a Windws client. T cnfigure Image Viewer Quick Start fr yur site Make a backup cpy f the quickstart.htm file. By default, the file is lcated in ne f the fllwing flders: Wrkplace: <AE_install_path>\FileNet\AE\Wrkplace\FnJavaV1Files Wrkplace XT: <XT_install_path>\FileNet\WebClient\WrkplaceXT\FnJavaV1Files Use a text editr t mdify quickstart.htm as shwn belw. Lcate the entry: <script language="javascript"> dcument.write('<applet name="viewne" mayscript cde="ji.applet.jiapplet.class" width="250" height="250" cdebase="." archive="ji.jar">') Change the "archive" setting t depending n yur IBM FileNet P8 client: Wrkplace: archive="ji.jar,p8securitydlg.jar,p8securitydlgresurces.jar" Wrkplace XT: archive="ji.jar,viewer-security-dialg.jar,viewer-securitydialg-i18n.jar" Save the file. Make a backup cpy f WcmJavaViewer.jsp. Wrkplace: <AE_install_path>\FileNet\AE\Wrkplace\UI-INF\jsp\ui Wrkplace XT: <XT_install_path>\FileNet\WebClient\WrkplaceXT\UI- INF\jsp\ui Use a text editr t mdify WcmJavaViewer.jsp as shwn belw: Lcate the entry: write('<applet ARCHIVE="ji.jar" NAME="viewONE" ID="viewONE" '+sizetag + '" HSPACE="0" VSPACE="0" ALIGN="middle" cde="ji/applet/jiapplet" cdebase="./fnjavav1files/">'); Change the "ARCHIVE" setting depending n yur IBM FileNet P8 client: Wrkplace: ARCHIVE="ji.jar,p8securityDlg.jar,p8securityDlgResurces.jar" Wrkplace XT: ARCHIVE="ji.jar,viewer-security-dialg.jar,viewer-security-dialg-i18n.jar" Lcate the entry and add the "write(paramtag+'quickstarturl'" string as shwn belw: write(applettag); write(paramtag+'cde'+peratrtag+'"ji.applet.jiapplet"'+endertag); write(paramtag+'cde'+peratrtag+'"ji.applet.jiapplet.class"'+endertag); write(paramtag+'cdebase'+peratrtag+'"./fnjavav1files/"'+endertag); Cpyright IBM Crp. 2002,

132 IBM FileNet P Release Ntes Knwn Issues write(paramtag+'quickstarturl'+peratrtag+'quickstart.htm'+endertag); Save the file. Stp the applicatin server. Delete the deplyed Wrkplace r Wrkplace XT flder and the temprary directries. Re-deply the Wrkplace r Wrkplace XT applicatin accrding t the instructins fr yur web applicatin server. Restart the applicatin server Sme f the cunter names and paths fr the Cntent Engine bject stre service dcumented in the IBM FileNet Dashbard dcumentatin need t be crrected When searching fr a quted phrase with the "Highlight search terms" ptin selected, the phrase is smetimes remved frm the text f the tpics in the results list. The phrase is nt remved if yu clear the "Highlight search terms" ptin This "NOTE" needs t be added t the "Shw an bject's hyperlink" tpic. When the link prvided by the Shw Hyperlink feature is used in a Micrsft Office applicatin in a cntainer-based-authenticatin envirnment, it will nt wrk. The issue is dcumented in Micrsft Knwledge Base article , where the applicatin makes an initial attempt at pening the hyperlink, but then diverts the link t the default brwser. This diversin lses the sessin infrmatin regarding which bject stre t pen. There is a dcumented wrkarund in the Knwledge Base article, but it may nt suit all custmers The Use Java applets tpic shuld include the fllwing statements: Sme tls are available thrugh prgrams knwn as Java applets. These prgrams require yu t have the Java Runtime Envirnment (JRE) dwnladed and installed n yur lcal cmputer. Yu nly need t dwnlad and install JRE nce; in mst cases, yu are prmpted t dwnlad JRE nly if it is nt present n yur cmputer when yu attempt t use ne f the Java applets. Depending n yur envirnment, yu might need t take the fllwing additinal steps: If yu are using Mzilla Firefx versin 2, yu must ensure that yu have a supprted JRE versin. Cntact yur applicatin administratr fr instructins. The instructins fr the applicatin administratr are: Installing the crrect JRE versin when using Mzilla Firefx The behavir f Firefx 2 when it pens an applet requiring JRE can cause the system t attempt t run Java applets with an unsupprted versin f the JRE. This can ccur in ne f tw ways: If JRE is nt currently installed, Firefx 2 prmpts the user t dwnlad the latest available JRE. This might be a later versin than is supprted by the applicatin. If JRE is already installed, Firefx 2 des nt prmpt the user t install a mre recent versin. The current JRE might be lder than the versin supprted by the applicatin. T avid bth prblems, the user can manually dwnlad the JRE versin prvided with the applicatin. Befre ding s, hwever, yu must identify the apprpriate JRE versin prvided with the applicatin, then prvide the user with the apprpriate instructins. Cpyright IBM Crp. 2002,

133 IBM FileNet P Release Ntes Knwn Issues T identify the JRE versin 1. On the applicatin server, navigate t the applicatin's dwnlad flder. Fr Wrkplace, the default lcatin is c:\prgram Files\FileNet\AE\Wrkplace\dwnlad. Fr Wrkplace XT, the default lcatin is c:\prgram Files\FileNet\WebClient\WrkplaceXT\dwnlad. 2. In the dwnlad flder, lk fr executable files starting with jre. Fr example, n a Windws applicatin server, yu might lcate jre-1_5_0_12-windws-i586-p.exe and jre-1_5_0_09-windws-i586-p.exe. 3. Make a nte f the filename f the file fr the newest JRE versin. In the abve example, yu wuld select jre-1_5_0_12-windws-i586-p.exe. Instructins t manually dwnlad the prvided JRE Using the JRE versin infrmatin abve, yu can tailr the fllwing instructins fr yur site befre prviding the instructins t yur users. Nte If the user has a newer versin f JRE already installed, it may be necessary t uninstall that versin befre prceeding. 1. On the client, lg in t the applicatin. 2. Enter the fllwing address in the Firefx address bar: where <servername:prt> is the name and prt number f yur server <applicatinname> is the name f yur applicatin (fr example, Wrkplace r WrkplaceXT) <jre-executable> is the filename fr the newest JRE versin (identified in the prcedure abve) TIP Once yu have lgged in, the <servername:prt>/<applicatinname> fr yur applicatin is already displayed in the address bar. Yu can simply replace the rest f the displayed address with /dwnlad/<jre-executable>. 3. When prmpted, yu can run the JRE installer r save it n yur lcal hard drive. If yu chse t save it, start the installer by navigating t the flder where yu saved it and duble-clicking the saved file. 4. When the JRE installatin is cmplete, restart Firefx When viewing the IBM FileNet P8 Dcumentatin using Internet Explrer n a Windws platfrm with the Display DPI set t large (120 DPI), HTML rdered lists that cntain mre than nine items might have their leftmst digit truncated. If yu experience this prblem, view the dcumentatin with the Mzilla Firefx web brwser The values fr tw cache prperties are incrrect in the 4.0.x Cntent Engine admin nline help: The incrrectly listed values are: Cde Mdule Cache Entry TTL Cpyright IBM Crp. 2002,

134 IBM FileNet P Release Ntes Knwn Issues Time-T-Live (in secnds) fr entries in the cde mdule cache, with minimum value f 0, a default value f 10, and an upper limit f 3600 Maximum Cde Mdule Cache Memry Maximum memry t allcate fr cde mdule cache entries, with minimum value f 300, a default value f 86400, and an upper limit f The crrect values are: Cde Mdule Cache Entry TTL Time-T-Live (in secnds) fr entries in the cde mdule cache, with minimum value f 300, a default value f 86400, and an upper limit f Maximum Cde Mdule Cache Memry Maximum memry t allcate fr cde mdule cache entries, with minimum value f 2, a default value f 10, and an upper limit f The fllwing infrmatin shuld have been included in the Supprt Matrix sectin f the directry server tpics in ECM help: The LDAP attributes that P8 reads, when reslving member users and member grups in a grup entry, are: LDAP Prvider AD ADAM edirectry SunONE Tivli LDAP Attribute member member member uniquemember, member uniquemember, member N/A Windws security updates smetimes cause the Internet Explrer Back buttn t wrk imprperly when brwsing FileNet P8 help. FileNet P8 Platfrm Startup and Shutdwn Guide In "Sample WebLgic.plicy file (UNIX)" (FileNet P8 Administratin > Enterprise-wide Administratin > Startup and Shutdwn > Applicatin Engine > Cnfigure Cmpnent Manager fr WebLgic cntrl), the fllwing lines apply t WebLgic 8.1 nly: grant cdebase "file:/bea/user_prjects/dmains/mydmain/myserver/.wlntdelete/-" { permissin java.security.allpermissin; }; grant cdebase "file:/bea/user_prjects/dmains/mydmain/myserver/.internal/-" { permissin java.net.scketpermissin "*: ", "cnnect,accept,reslve"; permissin java.net.scketpermissin "*:1-1023","cnnect,reslve"; permissin java.lang.runtimepermissin "getprtectindmain"; permissin java.i.filepermissin "{/}pt${/}filenet${/}wrkplace${/dwnlad${/}-", "read,write"; permissin java.i.filepermissin "{/}pt${/}filenet${/}wrkplace${/} WEB-INF ${/}lib${/}-", "read,write"; permissin java.i.filepermissin "{/}pt${/}filenet${/}wrkplace${/} WEB-INF Cpyright IBM Crp. 2002,

135 IBM FileNet P Release Ntes Knwn Issues ${/}-", "read,write"; }; FileNet P8 Platfrm Installatin and Upgrade Guide In the Install and Deply Cntent Engine task, there is a crss-reference in the Select Cmpnents rw f the table in step 6 f prcedure T run Cntent Engine Setup that pints t the task Install Additinal Instance f Enterprise Manager. This crss-reference shuld pint t the prcedure T install Enterprise Manager P Installatin Guide prcedures fr installing Prcess Engine n HP-UX states that the kernel parameter dbc_max_pct can be set t a value frm 1 t 30. Prcess Engine Setup checks the kernel parameters befre installing and fails if this parameter is set t a value higher than 10. Wrkarund: Set the dbc_max_pct kernel value t n higher than 10 t d the installatin f Prcess Engine. The value can be reset n the HP Integrity platfrm as dcumented after the installatin. The value fr HP-UX shuld remain n higher than Install Guide, Task 8, step 6 (fr UNIX) "Imprt the FileNet Styleset." When specifying the Style Set Alias, the wrng case is used fr the S in FileSystem. "FileNet_Filesystem_PushAPI" must instead be "FileNet_FileSystem_PushAPI". There is a bug in Verity in which the Verity Dashbard creates anther directry called "FileNet_Filesystem_PushAPI", but fails t cpy the style set files frm the surce directry (/pt/verity/data/stylesets/filenet_filesystem_pushapi) t the new directry (/pt/verity/data/stylesets/filenet_filesystem_pushapi) because it gets cnfused which directry t cpy it t, s it cpies the files t itself rather than the new directry. By creating a styleset alias called FileNet_FileSystem_PushAPI, the files will just create a directry (already there) and cpy files frm the surce t itself. Akin t what happens n Windws Verity which desn't exhibit this issue because Windws is case-insensitive The sectin "Task 14: Install Applicatin Engine" cntains incrrect infrmatin fr step 4 fr the Cntent Engine API Cnfiguratin screen. The example URL listed shuld be CEServer:prt# The name f the silent install script file fr the Windws media is incrrect in the Prtlets Installatin Guide. The actual name f the file is prtlets_silent_input_win.txt T avid an InstallShield errr when installing a FileNet P cmpnent n a machine where McAfee VirusScan Enterprise 8.0i is running, either install patch 10 fr VirusScan Enterprise 8.0i, r else enable n-access scanning within VirusScan and make sure that java.exe is nt n the prcess exclusin list A small number f hyperlinks in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide are nt wrking as expected. Hwever, any page numbers r prcedure steps specified in the links are accurate fr manual scrlling r use with Acrbat navigatinal features FileNet efrms fr FileNet P8 Wrkplace 4.0x Installatin and Upgrade Guide Under the "Cnfigure the applicatin server fr data access" sectin f the efrms Cpyright IBM Crp. 2002,

136 IBM FileNet P Release Ntes Knwn Issues Installatin guide the instructins t install the JDBC driver fr WebSphere causes P8 t crash. The JDBC jar file shuld nt be cpied t the <websphere_app_server_directry>/lib/ext directry. Instead the user shuld create a flder, c:\jars fr example, and cpy the jar file there. Next, yu will have t reference the jar file n the CLASS_PATH fr WebSphere. D the fllwing steps t cmplete this: 1. Lgin t the WebSphere Administrative Cnsle. 2. Click n Servers n the left side f the screen and then click n server1. 3. Under Server Infrastructure, expand Java and Prcess Management and click Prcess Definitin. 4. On the next page, under Additinal Prperties, click Java Virtual Machine. 5. Enter the path and file name fr the jar file(s) that need t be referenced in the classpath textbx. Examples: c:\jars\msbase.jar c:\jars\mssqlserver.jar c:\jars\msutil.jar c:\jars\jdbc14.jar 6. Click Apply and then Save Upgrade Guide, Task 11: Upgrade Custm Applicatins - In the Prcess Java API sectin, the Cntent Engine API Files tpic shuld read as fllws: Because the Prcess Engine uses the Cntent Engine API fr authenticatin and directry service access, applicatins being upgraded fr FileNet P8 4.0 will need t have the Cntent Engine API JAR files in their classpath. We recmmend that yu use the Web Services transprt t cnnect yur custm Prcess Engine applicatins t the Cntent Engine. Hwever, fr applicatins that use the J2EE framewrk with facilities specific t an applicatin server (such as JMS), the EJB transprt shuld be emplyed. If yur applicatins use the Web Services transprt, fllw the instructins belw t cnfigure the applicatins t run in a 4.0 envirnment. If yur applicatins use the EJB transprt, refer t the transprt infrmatin in the Getting Started sectin f the Cntent Engine Java and.net Develper's Guide, r t "Cnfiguring the Cmpnent Integratr" in the Cnfiguring the Prcess Develpment Envirnment sectin f the Prcess Engine Develper's Guide. 1. Cpy the CE_API files. Cpy the fllwing directries frm the CE_API directry n the Prcess Engine server. These are lcated under the fnsw directry (fr example, c:\fnsw\ce_api): CE_API \cnfig \lib \wsi The ther directries are nt needed. Cpyright IBM Crp. 2002,

137 IBM FileNet P Release Ntes Knwn Issues This directry is referenced in the fllwing instructins as <CE_API>. 2. Mdify the Classpath. Add the fllwing jar files t the classpath f the Prcess Engine applicatins: <CE_API>\wsi\lib\wasp.jar <CE_API>\lib\Jace.jar Nte that wasp.jar must precede the (existing) reference t pe3pt.jar. 3. Add JVM System Prperties. Add the fllwing JVM system prperties t the cmmand line f the Prcess Engine applicatins: -Djava.security.auth.lgin.cnfig=<CE_API>\cnfig\jaas.cnf.WSI -Dwasp.lcatin=<CE_API>\wsi 4. Specify the Cntent Engine URI. The Cntent Engine server URI needs t be prvided t the Prcess Engine API fr the lkup f the cnnectin pints. Prcess Engine applicatins can use the VWSessin methds t specify this r, fr minimal cde change, d ne f the fllwing: Put the WcmApiCnfig.prperties file in a directry that is in the classpath f the Prcess Engine applicatin. This WcmApiCnfig.prperties file shuld, at a minimum, cntain the fllwing line: RemteServerUrl = cemp: Add the JVM system prperty, filenet.pe.btstrap.ceuri, and specify the CEURI as fllws: -Dfilenet.pe.btstrap.ceuri = In P8 help search, srting by Help categry grups the search results by categry, but des nt srt them In the Upgrade Overview tpic f the IBM FileNet P8 Installatin and Upgrade Guide, functinal expansins that are nt supprted in the release are listed. The list currently cntains Recrds Manager (RM). This is incrrect as RM is supprted Cntrary t statements in the P8 Platfrm Install/Upgrade Guide, the Cntent Engine has been qualified against remte DB2 databases, unlike the Prcess Engine which still requires remte DB2. The errneus statement abut Cntent Engine is repeated several times in the guide The new dynamic security inheritance mdel can have a cmpatibility impact n existing applicatins. These cmpatibility issues are dcumented in the What's New sectin, but shuld als be in the Upgrading Custm Applicatins sectin f the Installatin and Upgrade Guide fr the Cntent Engine. The issues are: (1) the impact f the deprecated SecurityParent prperty, and (2) the handling f an UpdateSecurityEvent. Bth f these issues arise frm the changed security inheritance mdel. The descriptins are repeated belw fr ease f reference: SecurityParent and SecurityFlder Prperties The SecurityParent prperty (n the Dcument and CustmObject classes) has been deprecated. If the SecurityParent prperty is set (by an existing applicatin, fr example), Cpyright IBM Crp. 2002,

138 IBM FileNet P Release Ntes Knwn Issues the new SecurityFlder prperty is assigned the value f the SecurityParent prperty. When upgrading t this release: Objects with the SecurityParent prperty set use the tail (Flder) f the SecurityParent ReferentialCntainmentRelatinship bject t set the SecurityFlder prperty t the SecurityParent value. Any access cntrl entries in the bject that were persisted in the bject s ACL with a surce type f PARENT are remved. Objects having superseded versins that d nt have a SecurityParent prperty set, will have a SecurityFlder prperty set t the SecurityParent prperty value fr the versin that had a security parent. Changed Handling fr UpdateSecurityEvent If an bject is subscribed t the UpdateSecurityEvent event and the security fr an bject changes, the system generates an UpdateSecurityEvent event. In prir releases, mdifying the security f a flder culd als mdify the security f the dcuments cntained in that flder. The applicable access cntrl entry wuld be physically cpied, as inherited, frm the parent flder t the child dcument. Because this mdified a dcument's security descriptr, an UpdateSecurityEvent event was generated fr each child dcument. The new dynamic security inheritance mdel des nt cpy the access cntrl entries. Therefre, the system n lnger generates the UpdateSecurityEvent fr each impacted (inheriting) bject. In the case f a parent flder and multiple child dcuments, nly a single UpdateSecurityEvent event is generated fr the security mdificatin perfrmed n the flder. An update t any bject-valued prperty designated as "inheritable" in the metadata will als generate an UpdateSecurityEvent event In the P8 Platfrm Install/Upgrade Guide, in the Cntent Engine upgrade sectin (T create an XML status upgrade file), the fllwing parameter is incrrect: StyleSetAlias FileNet_Filesystem_PushAPI The crrect value is: StyleSetAlias FileNet_FileSystem_PushAPI (Nte the capitalizatin in the wrd FileSystem) "The tpic "Cnfigure Applicatin Engine (JBss)" incrrectly states that Step 5, "Cnfigure LDAP settings n Applicatin Engine t exactly match the Cntent Engine settings." nly applies t cntainer-managed installatins. In fact, yu must cnfigure LDAP fr bth cntainer-managed and applicatin managed installatins. Fllw the instructins in this step fr either type f installatin An incrrect reference t hetergeneus J2EE server envirnment and WSI supprt is present in the IBM FileNet P8 Platfrm Installatin and Upgrade guide The current 4.0 release f the FileNet P8 Platfrm supprts hmgeneus J2EE envirnments using Enterprise Java Bean (EJB) transprt acrss Applicatin Engine and Cntent Engine applicatin servers nly. The tpic "J2EE Applicatin Server Cnsideratins" in the planning sectin f the IBM FileNet P8 Platfrm Installatin and Upgrade guide incrrectly indicates that Cntent Engine and Applicatin Engine supprt Web Services Interface (WSI) transprt in hetergeneus envirnments. The crrect paragraph shuld read: Requirement fr J2EE applicatin servers. Cpyright IBM Crp. 2002,

139 IBM FileNet P Release Ntes Knwn Issues Cntent Engine and Applicatin Engine are J2EE applicatin server-based applicatins. (Prcess Engine is nt.) Yu must install Cntent Engine and Applicatin Engine in a hmgeneus J2EE envirnment in which all f yur applicatin servers (IBM WebSphere, BEA WebLgic, r JBss) and their versin numbers are identical fr bth cmpnents. Als, the applicatins must use Enterprise Java Bean (EJB) transprt Task 2 f the CFS Installatin and Upgrade Guide, "Create IICE Shared Libraries (WebSphere nly)", is incmplete. Please replace Task 2 with the fllwing: T create IICE shared libraries 1. Lg n t the WebSphere Administratin Cnsle n the applicatin server where IICE is deplyed. 2. Navigate t Envirnment > Shared Libraries. 3. Click New. 4. Enter the fllwing shared library name: iicesubscriptin 5. Prvide a class path t the datastre. Fr example: C:\Prgra~1\IBM\WebSphereIICE\pt\vbr_subscriptin.jar. 6. Apply and save changes t the Master Cnfiguratin file. 7. Navigate t Applicatins > Enterprise Applicatins 8. Select IICE applicatin. 9. Click n Libraries under Additinal Prperties 10. Click Add. 11. Select iicesubscriptin library name frm drp-dwn list. 12. Click OK. 13. Apply and save changes t the Master Cnfiguratin file. 14. Restart WebSphere applicatin server Yu must create a shared Temp directry lcal t the Prcess Simulatr fr bulk insertin f data t the Simulatin Prcess Analyzer database if the fllwing is true: Prcess Simulatr is using a Prcess Analyzer fr analyzing simulatin data AND 1. The database f that Prcess Analyzer is n a server remte frm the Prcess Simulatr. 2. Grant the fllwing access t the directry: Full access rights t the Prcess Simulatr administratr. Read nly access t the Prcess Analyzer database server. Yu will cnfigure Prcess Simulatr t use this shared directry in the fllwing FileNet Prcess Simulatr Installatin and Upgrade Guide tasks: Task 2: Install Prcess Simulatr > T cnfigure Prcess Simulatr fr a remte Simulatin Prcess Analyzer Task 2: Install Prcess Simulatr > T cnfigure and start the Prcess Simulatr Nte In these tasks the Temp directry is incrrectly dcumented as a requirement if the Simulatin Prcess Analyzer and Prcess Simulatr are nt n the same server. Hwever, Cpyright IBM Crp. 2002,

140 IBM FileNet P Release Ntes Knwn Issues in this cntext the lcatin f the Prcess Simulatr is nly imprtant in relatin t the Prcess Analyzer database, nt the Prcess Analyzer server Dcumentatin issues exist fr the installatin f Cntent Engine in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide and the IBM FileNet P8 High Availability Technical Ntice. IBM FileNet P8 Platfrm Installatin and Upgrade Guide The fllwing wrkarunds are prvided fr the knwn issues in this guide. Task 13: Deply Cntent Engine int a Managed Envirnment page 208 In the T redeply Cntent Engine t a managed WebSphere server prcedure, an issue was reprted that a critical pst deplyment step t set the classlading rder fr the CEMP-WebService was missing frm the dcumentatin. This infrmatin is prvided in step 6e f the prcedure. Task 16: Redeply Cntent Engine page 219 In the T redeply Cntent Engine n WebSphere 5.1.x and 6.0.x prcedure, perfrm the fllwing between step 8 and step 9 f the prcedures. 9. Change Class Lader rder. a. G t Applicatins > Enterprise Applicatins > FileNetEngine > Manage Mdules > FileNet CEMP Web Service. b. Change the class lader rder t Classes laded with applicatin class lader first. c. Click Apply. d. Save yur changes t the master cnfiguratin. Task 19: Establish the FileNet P8 Dmain and Glbal Cnfiguratin Data page 232 In the T create FileNet P8 dmain prcedure, the Cntent Engine URL infrmatin in step 3 shuld read: I. In the Add Dmain Cnfiguratin dialg bx, specify the fllwing infrmatin and then click OK: Nickname an identifier (nt part f any credentials) that can be used t cnnect t Cntent Engine Cntent Engine URL In a managed applicatin server envirnment (such as a cluster r a farm) Set ce_server_name t pint t ne f the Cntent Engine servers where the Cntent Engine is deplyed. Set prt t a WSI prt used by ne f the managed applicatin servers/ instances (fr example, 9080 fr WebSphere r 7002 fr WebLgic). In a nn-managed applicatin server envirnment (such as a JBss cluster r a standalne WebSphere r WebLgic), set ce_server_name and prt fr just ne f the applicatin servers. Yu can cnfigure multiple Enterprise Manager cnnectins t the ther nnmanaged applicatins if yu wish. Username the name f the Cntent Engine system user, which must be the accunt yu specified earlier in the Setup Cntent Engine Btstrap Prperties Cpyright IBM Crp. 2002,

141 IBM FileNet P Release Ntes Knwn Issues screen f Cntent Engine Setup. Remember passwrd Select the check bx if yu want t avid typing the passwrd each time yu lg n as this user. (The passwrd will be encrypted.) Use integrated Select the check bx if yu want Kerbers authenticatin fr this user. IBM FileNet P8 High Availability Technical Ntice The fllwing wrkarund is prvided fr the knwn issue in this guide. Installatin and Deplyment Tasks page 46 In the T cnfigure Cntent pst installatin prcedure, the Create a FileNet dmain infrmatin in step 3 shuld read: 3. Cnfigure the FileNet P8 dmain. a. Create a FileNet P8 dmain. Nte D this nce per HA envirnment nly. CAUTION: When yu cnfigure Cntent Engine frm Enterprise Manager yu must pint t nly ne Cntent Engine server. Using a lad-balancer fr the Enterprise Manager cnnectin is nt supprted. Fllw the instructins in T create a FileNet P8 dmain in the IBM FileNet P8 Platfrm Installatin and Upgrade Guide task Install and Deply Cntent Engine. This infrmatin pertains t bth dcuments Sme f the steps in the Cntent Engine redeplyment sectins in the Installatin and Upgrade Guide and the High Availability Technical Ntice are incnsistent. The steps are the same, but the rder in which they are perfrmed is different. In sme sectins, the user is tld t deply the ear, d the classlader steps, create the FileNet Cnnectin Factry, and save and synchrnize the ndes if Cntent Engine is in a server cluster. In ther sectins these steps are presented in different rder, such as deply the ear, create the FileNet Cnnectin Factry, d the classlader sectins, and save and synchrnize the ndes if Cntent Engine is in a server cluster. Fr the sake f cnsistency, the user can cmplete redeplyment steps in this rder: 1. Deply the ear file. 2. Perfrm the classlader steps. 3. FileNet Cnnectin Factry. 4. Save the changes. 5. Synchrnize the files if Cntent Engine resides in a server cluster As f IBM FileNet P8 Cntent Engine Fix Pack 10, the default lkup list f JNDI keys includes "jta/usertransactin". The tpic describing this default list is lcated in IBM FileNet P8 Platfrm Installatin and Upgrade Guide > Upgrading Custm Applicatins > Task 16 > Transactin Entries in the WcmApiCnfig.Prperties File > TxJndiKey. The updated tpic is as fllws: Cpyright IBM Crp. 2002,

142 IBM FileNet P Release Ntes Knwn Issues TxJndiKey Allws yu t specify an explicit key fr the call t InitialCntext.lkup(key) fr lcating a UserTransactin reference. If this is nt specified, the fllwing rdered list is used until a lkup succeeds r the list is exhausted: "java:cmp/usertransactin" "javax.transactin.usertransactin" "UserTransactin" "jta/usertransactin" In the IBM FileNet P8 4.0 Installatin and User Guide tpic T mdify the tempdb database fr Prcess Engine, the fllwing requirement is dcumented: Verify that the space allcated fr the tempdb is at least 80 MB. In additin t this dcumented requirement, verify that the cllatin settings fr the index database (vwdb) and tempdb match T upgrade Cntent Engine and Cntent Search Engine frm versin t 4.0.1, yu must remve all versin 3.5 indexes befre running the Cntent Engine Upgrader tl. This requirement affects the fllwing tpics in versin f the Installatin and Upgrade Guide. Task 7: Upgrade Cntent Search Engine Sftware In the secnd paragraph f the tpic, delete this sentence: "The 3.5.x cntentsearch indexes must be upgraded t 4.0 index areas, nw called K2 cllectins." Replace the furth paragraph f the tpic with the fllwing: "Upgrading Cntent Search Engine sftware frm versin 3.5.x t 4.0 invlves taking nte f yur current prperty-level indexing. Yu then delete and uncnfigure cntent-based retrieval befre upgrading Cntent Engine t versin 4.x. Yu can then install and cnfigure Cntent Search Engine 4.x (Autnmy K2 prduct and related fix packs). Then yu can create new index areas and specify the classes and prperties yu wish t index fr cntent searching." In the Prductin envirnment upgrades subtpic, remve the first tw paragraphs. In the list fllwing the first paragraph f the "CBR upgrade prcess" subtpic, insert the fllwing steps immediately prir t step 1: 1. Take nte f all the prperty-level indexes, because yu must recreate them after upgrading Cntent Engine. 2. Delete all existing indexes and uncnfigure cntent-based retrieval using Enterprise Manager. 3. In the file stre directries, remve the "\index" directry and its subdirectries. In the list fllwing the first paragraph f the "CBR upgrade prcess" subtpic, replace step 2 with the fllwing: 2. Cmplete the upgrade f strage areas as part f the prcess f upgrading Cntent Engine using the prcedures in the upgrade sectin f this guide. a. a.prepare file stres and fixed file stre ndes fr upgrade. Cpyright IBM Crp. 2002,

143 IBM FileNet P Release Ntes Knwn Issues b. b.run the Cntent Engine Upgrader. c. c.install Cntent Search Engine sftware updates. d. d.(ptinal) Mve the file strage areas frm Windws t UNIX. e. e.create new index areas and specify the classes and prperty templates in the classes t be CBR Enabled. f.start an index jb n the classes enabled fr CBR. In the prcedure T upgrade Cntent Search Engine data as part f upgrading Cntent Engine Data" remve the sentence preceding step 1, and remve step 1b. Task 8: Upgrade Cntent Engine Data In the Graphical User Interface t Upgrader Tl subtpic, change the first tw sentences f step 4 in the prcedure T create the XML upgrade status file t this: 4. In the XML Upgrade File Creatr screen, clear the CBR check bx. Click Start t begin creating the XML upgrade status file. In the prcedure T cnfigure JAAS, P8 dmain, CBR, and FCD parameters remve the secnd bullet item (CBR Cnfig.) and remve all f step 2. In the Prepare Items fr Upgrade subtpic, remve step 5 frm the prcedure T prepare file stre and fixed file stre ndes fr upgrade. In the "Cmmand Line Interface t Upgrader Tl" subtpic, remve steps 7 thrugh 10. Task 10: Cmplete Pst-Upgrade Cntent Engine Cnfiguratin In the subtpic "Cmplete Cntent Search Engine Upgrade and Create Cllectins" remve steps 2 and 5 f the prcedure T Cmplete a Cntent Search Engine Upgrade and Create New r Upgraded Cllectins Instructins fr upgrading the ISRA Servlet are missing frm the Installatin and Upgrade Guide. T upgrade the ISRA Servlet: 1. Frm yur applicatin server, undeply the ISRA Servlet. 2. Frm the install_lcatin\_uninstisra flder, run filenet_ae_israservlet_setup_uninstall.exe. 3. Delete the filenet_applicatinengineisraservlet_install_lg_xxx.txt file and the entire ApplicatinEngineISRAServlet flder. 4. Frm the installatin media r yur lcal cpy, start the Applicatin Engine ISRA Servlet installatin prgram: UNIX: <Platfrm>filenet_ae_israservlet_setup.bin. Windws: WINfilenet_ae_israservlet_setup.exe Cntent Engine Java and.net API Develper's Guide An invalid list f restrictins n bject lcking exists in the Cntent Engine Java and.net API Develper's Guide > Cperative Lcking Cncepts > Lcking an Object. Cpyright IBM Crp. 2002,

144 IBM FileNet P Release Ntes Knwn Issues Because there are n restrictins n lcking an bject, the fllwing statement and assciated list items are incrrect and shuld be disregarded: Hwever, yu cannt lck the fllwing: A Dcument bject that is checked ut by anther user A "frzen" Dcument bject (that is, ne whse IsFrzenVersin prperty is true). An bject that is lcked by anther cperating applicatin The rt flder" SharePint Dcument Libraries installatin guide IBM FileNet Cnnectr fr SharePint Dcument Libraries Installatin and Upgrade Guide In "Task 7: Set IIS Manager Accunt Prperties" step 3 is incrrect and shuld read as fllws: 3. In the Applicatin Pl drp-dwn menu, select an applicatin pl that has the same identity that the SharePint web applicatin's applicatin pl is cnfigured t run as In "Task 6: Create Cnnectr Administratin Services": - step 2. shuld read: 2. Run the apprpriate database script lcated at C:\Prgram Files\IBM\UFI\Database Scripts against the database yu just created. - DB2 (db_ufi_400_db2.sql) - Oracle (db_ufi_400_ra.sql) - MS SQL (db_ufi_400_sql.sql) - step 3e shuld read: e. Enter yur Data Stre database lgin name and passwrd and click Retrieve Databases The IBM FileNet Cnnectr fr SharePint Dcument Libraries Versin 2.2 Installatin and Upgrade Guide, in the nn-english envirnment installatin, includes the fllwing nte n page 19: Nte When creating a Micrsft SharePint site, the SharePint site administratr needs t take int accunt the end-user's preferred lcale settings, such as Date frmat. The date frmat displayed n a client brwser is dependent n the 'SharePint User settings'. Where a specific SharePint user lcale has nt been set the calendar lcale is then based n the 'SharePint Site settings'. In rder t display a lcalized calendar n the client fr a particular language, the 'SharePint User settings' and 'SharePint Site settings' must match. This nte is inaccurate. The crrect infrmatin abut the date frmat is: Nte When creating a Micrsft SharePint site, the SharePint site administratr needs t take int accunt the end-user's preferred lcale settings, such as Date frmat. The date frmat displayed n a client brwser is dependent n the SharePint site settings n the Micrsft SharePint server, and des nt depend n the perating system reginal Cpyright IBM Crp. 2002,

145 IBM FileNet P Release Ntes Knwn Issues settings f the client r the perating system reginal settings f the SharePint server. SharePint Web Parts installatin guide The wrng dcument title displays n the windw bar f the PDF fr FileNet IBM Cnnectr fr SharePint Web Parts 2.1. Cntent Engine Due t bugs in IBM JVM 1.4.2, shipped with WebSphere 6.0.2, and in the IBM SDK SR5 Cumulative Fix fr IBM WebSphere, JIT ptimizatin under heavy lad is likely t cause unexpected NullPinterExceptin errrs and ther randm errrs that in turn cause errrs in Cntent Engine applicatins. T wrk arund this prblem, use the WebSphere administrative cnsle t set the JVM ptin Xquickstart as fllws, where yur_server is the name f the machine running WebSphere: 1. If it is nt already running, start the WebSphere administrative cnsle. 2. Navigate t Applicatin servers > yur_server > Java and Prcess Management > Prcess Definitin > Java Virtual Machine 3. In the Generic JVM arguments field, add Xquickstart. 4. Stp and start WebSphere Applicatin Server. If yu are running the netwrk deplyment versin f WebSphere 6.0.2, set this JVM ptin fr the nde agent as well as all yur server instances. If yu cntinue experiencing JIT-related prblems after adding the Xquickstart ptin, remve this ptin and set anther ptin t turn ff JIT ptimizatin, as fllws (but be aware that this alternative ptin may cause perfrmance t degrade by arund 25%): 1. If it is nt already running, start the WebSphere administrative cnsle. 2. Navigate t Applicatin servers > yur_server > Java and Prcess Management > Prcess Definitin > Custm Prperties. 3. Add the fllwing prperty t turn ff JIT ptimizatin: Name: JITC_COMPILEOPT Value: NALL 4. Stp and start WebSphere Applicatin Server The Ntes sectin f the Upgrade Overview tpic in FileNet P8 Platfrm Installatin and Upgrade Guide Sftware Release lists the expansin prducts and add-n cmpnents that must nt be included in versin 3.5.x f FileNet P8 3.5.x prir t upgrading t FileNet P This list shuld include tw additinal items: Cntent Federatin Services fr Cntent Services Cntent Federatin Services fr NTFS Cpyright IBM Crp. 2002,

146 IBM FileNet P Release Ntes Knwn Issues The P8 help Search functin can return sme false-psitive results when searching n a phrase in qutes. The matches might nt have the text tgether as a phrase in the file. This is an internal issue with Lucene EM Help: The search example in "Run CBR Query thrugh EM" has incrrect syntax. In the help tpic Run CBR query frm Enterprise Manager, the Select statement shuld read: SELECT d.this FROM Dcument d INNER JOIN CntentSearch c ON d.this = c.queriedobject WHERE CONTAINS(d.*,'test') English custmers might want t install the Verity K2 Lcale installer and must have access t the Lcale installer license key. FCS custmers must be able t install Verity K2 and the Verity K2 Lcale add-n. Wherever the Verity K2 installer prcedure is dcumented, the Lcale installer shuld be included and the license key stated. (Installatin and Cntent Engine) Instructins t install the Verity Lcale add n: T install lcales frm the Lcale CD after Cntent Search Engine (Autnmy K2) has been installed, prepare yur system with the fllwing: UNIX: - exprt variable VERITY_CFG VERITY_CFG=/pt/verity/k2/cmmn/verity.cfg - exprt VERITY_CFT Windws: 1. Create a directry: <Prgram Files>\Cmmn Files\InstallShield\Universal\<Win platfrm>\x86\<machine_name>\gen1\_vpddb where: <Prgram Files> is the system Prgram Files flder, such as C:\Prgram Files <Win platfrm> is the Windws versin. Valid ptins: Windws XP, Windws 2000 and Windws 2003 <machine_name> machine name n which yu are installing Example: C:\Prgram Files\Cmmn Files\InstallShield\Universal\Windws 2003\x86\myMachine\Gen1\_vpddb 2. Lcate the vpd.script file in yur K2 CLI setup rt flder. Mdify all the instances f the string: <K2InstallDir> t the K2 rt flder ex. C:\Prgram Files\FileNet\CntentEngine\verity <myhstname> t the machine name <WinVersin> t the Windws versin Ensure the entries in the vpd.script file match the flder path in step Cpy vpd.script t the lcatin created in step 1. T run the installer, navigate t the decmpressed lcale installer lcatin and execute the respective installer launcher. The lcale installer will lcate the K2 installatin and start, Cpyright IBM Crp. 2002,

147 IBM FileNet P Release Ntes Knwn Issues based n the settings yu cmpleted abve. Nte The lcale installer requires the fllwing license key: 2UV4MPT-2KPEQBJ- 1D6A6KT-2KPE6KT-2KPE6KS Prcedures fr installing Centera shared libraries were mitted frm the P Installatin and Upgrade Guide Several places in the upgrade dcumentatin instruct yu t edit the CE352t40Upgrade.bat file that is lcated n the installatin CD. If yu attempt t edit the file n the CD yu will nt be able t save the change back t the CD because the file is read-nly Sme WebLgic User and Grup Filter sample values use = instead f ^. # User filter # # The sample default values fr each authenticatin prvider #Active Directry Authenticatin Prvider - "(&(bjectclass^user)(samaccuntname^%u))" #SunOne Authenticatin Prvider -"(&(uid^%u)(bjectclass^persn))" #Nvell Authenticatin Prvider -"(&(cn^%u)(bjectclass^persn))" #IBM Tivli Directry Server -"(&(cn^%u)(bjectclass^persn))" # # Nte: Use ^ in place f = # -V vasauthnusernamefilter="(&(uid^%u)(bjectclass^persn))" ################################################################################ # # Grup filter # # Nte: Use ^ in place f = # # the sample default values fr each authenticatin prvider #Active Directry Authenticatin Prvider - "(&(bjectclass^grup)(samaccuntname^%g))" #SunOne Authenticatin Prvider - "( (&(cn^%g)(bjectclass^grupofuniquenames))(&(cn^%g)(bjectclass^grupofurls)))" #Nvell Authenticatin Prvider -"(&(cn^%g)(bjectclass^grupfnames))" #IBM Tivli Directry Server - "(&(cn^%g)( (bjectclass^grupofnames)(bjectclass^grupofuniquenames)))" # -V vasauthngrupnamefilter="( (&(cn^%g)(bjectclass^grupofuniquenames))(&(cn^%g)(bjec tc lass^grupofurls)))" The fllwing lines were mitted frm the WebSphere sample silent install respnse file in the Cntent Engine Silent Installatin Resurce Files appendix. ######################################################################## # CCL CmpatibilityURL # # replace <cehstname> with the CE hst name r ip -V vcclurl=" The abve lines shuld appear immediately after the COM Cmpatibility Client API sectin (which ends with the line -P beanfeatureccl.active=false). The fllwing lines were mitted frm the WebSphere sample silent install respnse file in the Cntent Engine Silent Installatin Resurce Files appendix. ######################################################################## # CCL CmpatibilityURL # # replace <cehstname> with the CE hst name r ip Cpyright IBM Crp. 2002,

148 IBM FileNet P Release Ntes Knwn Issues -V vcclurl=" The abve lines shuld appear immediately after the COM Cmpatibility Client API sectin (which ends with the line -P beanfeatureccl.active=false) In the FileNet P8 Installatin and Upgrade Guide task "Upgrade Cntent Engine," step 3 f the prcedure "T create the XML upgrade status file" incrrectly states the typical path fr the sysinit.dat file. The crrect path is C:\Prgram Files\FileNet\CntentEngine\syscnfig\sysinit\sysinit.dat Micrsft Visual C++ runtime library is nt a prerequisite fr installing.net applicatins n a Cntent Engine machine, cntrary t what is stated in step 1 f prcedure T run Cntent Engine Setup in the FileNet P8 Installatin and Upgrade Guide task Install and Deply Cntent Engine Yu can set rw limits fr Cntent Based Retrieval (CBR) queries. Rw limits are discussed in the help text. Hwever, that text has since been expanded t prvide mre infrmatin. The fllwing paragraphs include this new rw limit text. Yu can set three types f rw limits that can help yu limit the time and resurces cnsumed by a given CBR query. These rw limits are: FULLTEXTROWLIMIT - a SQL statement ptin that yu can include in yur query. FullTextRwDefault - a prperty f the bject stre, cntaining the limit used if yu d nt specify a FULLTEXTROWLIMIT in the SQL statement. FullTextRwMax - a prperty f the bject stre, cntaining the maximum number f rws that can be returned frm the indexing data during a search. If yu specify a value fr the FULLTEXTROWLIMIT ptin in yur SQL statement, the lesser f the FullTextRwMax and the FULLTEXTROWLIMIT values is used as the maximum number f rws that can be returned. Althugh the FULLTEXTROWLIMIT can help yu save time and resurces, it als has a limitatin. If yu set yur rw limit t lw, the query may stp befre all matches are fund. The query prcess executes in tw phases. First the CBR database is searched fr cntent that matches yur cntent search criteria. Secnd, fr all the dcuments retrieved in the CBR phase, the RDBMS is searched fr index values - such as the authr's name r check-in date - that match yur index search criteria. Fr example, yu can query fr dcuments that include the phrase structural stability and were written by Lee Lindz. If the CBR database cntains mre dcuments that cntain the phrase structural stability than yur rw limit allws, the CBR phase f the query stps befre all structural stability dcuments have been retrieved. If the query stps befre reaching the Lindz dcument in the CBR database, that dcument is nt searched in the RDBMS database. As a result yur search wuld nt find a dcument that matches bth yur criteria and is in the database. Given this limitatin, set yur FULLTEXTROWLIMIT value high enugh t include all matches fr multiple search criteria. Refer t the Develper s Guide and the SQL Syntax Reference page fr additinal infrmatin n rw limits In the prcedure T cnfigure WebSphere 6.1.x database cnnectivity (MS SQL Server) f Task 14c: Cnfigure Cntent Engine Applicatin Server Database Cnnectivity (WebSphere 6.1.x), the value f Data stre helper class name in steps 14 and 18 is incrrect. The crrect value is cm.filenet.engine.util.datastrehelper. Cpyright IBM Crp. 2002,

149 IBM FileNet P Release Ntes Knwn Issues Autnmy cntent-based retrieval (CBR) engine des nt supprt cncurrent indexing r ptimizatin f indexes. Wrkarund: Only ne Autnmy server per site can have the CBR Dispatcher enabled The secnd bullet item in the Ntes sectin f Task 12: Install Enterprise Manager is incrrect. The item shuld read as fllws: If yu ran Cntent Engine Setup n a Windws machine, yu can skip t Establish the FileNet P8 Dmain and Glbal Cnfiguratin Data (GCD) n page 184, as Cntent Engine Setup has already installed Enterprise Manager Page 75 f the CFS-IS Guidelines (September 2007) states: After yu've finished mapping prperties, restart CFS-IS by ging t the Services Cnsle, lcating the FileNet CFS Service' and restarting this service. The dcumentatin shuld state the fllwing: After yu have finished mapping prperties, restart CFS-IS with ne f the fllwing prcedures: In Cntent Engine 3.5, n the Services Cnsle, lcate the FileNet P8 CFS Server fr Image Services, and restart this service. In Cntent Engine 4.0, yu d nt need t restart the IS imprt agents when yu mdify the prperties f the dcument class mappings. If yu chse t stp r restart the imprt agents t manage the wrklad n the Cntent Engine server, refer t the Enabling r Changing the Number f IS Imprt Agents sectin The Install & Upgrade Guide tpic Establish the FileNet P8 Dmain and Glbal Cnfiguratin Data (GCD) shuld state that yu must be a member f the Lcal Administratrs grup r the Pwer Users grup t create the GCD and the FileNet P8 dmain The tpic entitled "View strage area states" describes the disabled strage area icn as fllws: "Strage area has been disabled (unavailable t service requests: users cannt add, view, r mdify dcuments in the strage area)." This statement is partially incrrect, because users can view dcuments in a disabled strage area The tpic entitled "Strage area prperties (Statistics tab)" describes the File bytes prperty as fllws: "Identifies the space used by dcuments stred n the disk vlume in which the strage area resides." This statement is incrrect. The File bytes prperty is the number f bytes f cntent stred n the disk vlume in which the strage area resides. This number might be less than the ttal disk size f the cntent files because f the file system blck size The ObjectSecurityCacheEntryTTL and ObjectSecurityCacheMaxEntrie prperties are incrrectly described in the Cntent Engine Java and.net API reference help. The fllwing descriptins are the crrected text fr these prperties. ObjectSecurityCacheEntryTTL Specifies the Time-T-Live (TTL) in secnds fr entries in the bject security cache. Once the TTL has elapsed, cached infrmatin that has becme stale is discarded and fresh data is btained frm the database. ObjectSecurityCacheMaxEntries Specifies the maximum number f entries in the bject security cache. When the maximum Cpyright IBM Crp. 2002,

150 IBM FileNet P Release Ntes Knwn Issues number is exceeded, the least recently used elements are remved t allw fr mre recently used elements t be cached The tpic "Cncepts: exprting and imprting" in the Cntent Engine Administratin help cntains the fllwing nte: Nte Prir t Cntent Engine versin 3.5.1, the exprt file generated by Enterprise Manager cnsisted f a single XML file. The Security Mapping Wizard and Imprt Helper tls will accept bth pre XML files and the generated.txt file as input int this field. This nte incrrectly implies that a manifest created in Cntent Engine v3.5 can be imprted int Cntent Engine v4.0. This is nt true, and the nte shuld be ignred The dcumentatin fr anntatin access rights shuld reflect that Full Cntrl, Mdify Prperties, View Prperties and View Cntent are the nly valid ptins fr anntatin access rights and custm security settings are nt supprted. Enterprise-wide Adminstratin > Security > Authrizatin > Object access rights and security > Anntatins > Anntatin access rights Add the fllwing new item t the list f security characteristics fr anntatins, which yu can find in the Anntatin access rights tpic f the Enterprise-wide Administratin nline help under Security > Authrizatn > Object access rights and security > Anntatins. The new text describes a limitatin n permissins settings when the Wrkplace r Wrkplace XT applicatin is used t view anntatins: If yu are using Wrkplace r Wrkplace XT, be aware that these applicatins limit permissins n anntatins t the fllwing simplified permissin levels: Owner Cntrl, Mdify Cntent, and View Cntent. Fr mre infrmatin, see the Available permissin levels tpic in User Help > Actins, preferences and tls > Wrk with Security > Manage Security The tpic entitled "Fixed Cntent Devices prperties (General tab)" des nt cntain infrmatin abut the fllwing supprted fixed cntent device prviders: IBM Cntent Manager OnDemand IBM Cntent Integratr IBM Tivli Strage Manager The missing infrmatin will be added t the dcumentatin fr Release The "Slving Kerbers prblems" sectin f the tpic "Kerbers fr Cntent Engine" in ECM Help shuld have cntained the fllwing subsectin: Kerbers authenticatin fails due t WAS initial naming cntext nt set (WebSphere) Attempting t perfrm a Kerbers lgin with either FEM r the AuthnTest utility results in a "Web services Kerbers credential invalid" errr, and Websphere "Failure t btain initial naming cntext" errrs. These errrs indicate that Websphere did nt initialize the Java naming factry, which is required fr Kerbers authenticatin. Set this generic JVM argument: -Djava.naming.factry.initial=cm.ibm.websphere.naming.WsnInitialCntextFactry Open the WAS admin cnsle and expand Servers, click Applicatin servers, click <server name>, then expand Java and Prcess Management n the right, click Prcess Definitin, click Java Virtual Machine and then enter the argument text in the Generic JVM arguments bx (with a space t separate it frm ther args, if needed). Cpyright IBM Crp. 2002,

151 IBM FileNet P Release Ntes Knwn Issues Click Apply and Save, then restart WebSphere Add the fllwing item t the list f anntatin characteristics in the Cntent Engine Java and.net API Develper's Guide, Anntatin Cncepts sectin: * Althugh nt recmmended, yu can prgrammatically cpy an anntatin frm ne dcument t anther. Because the cpied anntatin is unchanged frm the riginal, its cntent element retains the F_ID and F_ANNOTATEDID f the riginal anntatin. A Wrkplace user culd then display the cpied anntatin n the dcument using a dcument viewer, but an errr wuld ccur if the user attempts t mdify and save that anntatin. Fr a user t be able t mdify and save the cpied anntatin n the new dcument, yur prgram must als update the cpied anntatin's cntent element (anntatin.xml) with new GUIDs fr F_ID and F_ANNOTATEDID. Cntent Search Engine In the IBM FileNet P8 4.0 Installatin and User Guide, several steps in the tpic Install and Cnfigure Cntent Search Engine, are incrrect r missing, which can result in K2 dcumentatin being unavailable. In the prcedure T install Autnmy K2 Master Administratin Server n Windws replace step 9c with the fllwing: Set dcbase t the path t the Verity dcumentatin directry within the <Cntext> tag: Fr example: <Cntext path="/verity_dcs" dcbase="c:\prgram Files\filenet\cntentengine\verity\data\dcs" debug="0" reladable="true" crsscntext="false"> </Cntext> Insert the fllwing tw steps int the prcedure T install Autnmy K2 Master Administratin Server n UNIX between steps 9 and 10: Update the dcumentatin XML file and set the access path: a. Access /pt/verity/appserver/cnf/catalina/lcalhst. b. Open the k2_dcs.xml file fr editing. c. Set dcbase t the path t the Verity dcumentatin directry within the <Cntext> tag: Fr example: <Cntext path="/verity_dcs" dcbase="/pt/verity/filenet/cntentengine/verity/data/dcs" debug="0" reladable="true" crsscntext="false"> </Cntext> Update web.xml: a. Open /pt/filenet/cntentengine/verity/data/dcs/web-inf fr editing. b. Replace <myhstname> with the machine name n which yu are installing Cntent Search Engine. Cpyright IBM Crp. 2002,

152 IBM FileNet P Release Ntes Knwn Issues FileNet Services Ltus Quikr On page 26 in the FileNet Services fr Ltus Quickr Installatin and Cnfiguratin Guide, the fllwing nte needs t be replaced: Nte In general, libraries shuld nt have nested cntent structures. That is, the cntent flder fr library A shuld nt be a subflder f the cntent flder f library B. It is permissible t create a library mapped t the bject stre rt, "/", and additinal libraries in the same bject stre. The cntent flder f the additinal libraries cannt be nested within each ther. That nte is incrrect and shuld be replaced with the fllwing infrmatin: Nte In general, libraries shuld nt have nested cntent structures. Fr example, the cntent flder fr library A shuld nt be a subflder f the cntent flder f library B. If yu create a library mapped t the bject stre rt, "/", yu cannt have any ther library in the same bject stre The FileNet Services fr Ltus Quickr Installatin and Cnfiguratin Guide cntains incrrect infrmatin fr cnfiguring Tivli Access Manager single sign-n. D nt use the infrmatin prvided in "Cnfigure Tivli Access Manager Single Sign-On" n page 14. Refer t the Tivli Access Manager single sign-n tech nte available n the IBM supprt site ( The FileNet Services fr Ltus Quickr install guide cntains a typ n page 21 in step 2 f the fllwing prcedure: T generate the cnfiguratin files fr deplyment 1. Lcate the cnfigmanager flder under the FileNet Services fr Ltus Quickr installatin flder. 2. Run cnfigmanager > cnfigmgr.bat generate Cnfig task deplyapplicatin -appserver websphere -deply standard. In step 2, the crrectin shuld be generatecnfig nt generate Cnfig (n space between generate and Cnfig) The Trublesht uninstallatin issues sectin n page 33 in the FileNet Services fr Ltus Quickr install guide needs t be updated with the fllwing prcedure: T remve FileNet Services fr Ltus Quickr manually Windws 1. Open the Registry Editr and lcate all entries that match IBM FileNet Services fr Ltus Quickr. 2. Delete all f the matched entries. 3. Remve all the entries related t IBM FileNet Services fr Ltus Quickr in the.cm.zerg.registry.xml file lcated at c:/prgram Files/Zer G Registry/ 4. Remve all f the directries and files t which yu installed FileNet Services fr Ltus Quickr. UNIX 1. Remve all f the directries and files t which yu installed FileNet Services fr Ltus Quickr. 2. Remve all the entries related t IBM FileNet Services fr Ltus Quickr in the Cpyright IBM Crp. 2002,

153 IBM FileNet P Release Ntes Knwn Issues.cm.zerg.registry.xml file lcated at var/.cm.zerg.registry.xml. Prcess Analyzer After installing the Prcess Analyzer Client sftware using the interactive installer, the shrtcut t the Prcess Analyzer User Guide des nt wrk. Yu can edit the shrtcuts prperties and enter the crrect URL in the target: <ECM dcumentatin URL>/pa_help/userguide.htm, where <ECM dcumentatin URL> is the base URL yu entered during the Prcess Analyzer Client installatin The Prcess Analyzer database prperties tpic in the P8 4.0 FileNet Prcess Analyzer Installatin and Upgrade Guide nw include instructins n preparing the Oracle Prcess Engine database fr XA. The new infrmatin was included in the table in the JDBC Driver Name field, and shuld nw read as fllws: JDBC Driver Name The name f the JDBC driver used t access the PA database. Fr example, the JDBC driver name fr Micrsft SQLServer might be: Fr SQL Server 2000: cm.micrsft.jdbc.sqlserver.sqlserverdriver Fr SQL Server 2005: cm.micrsft.sqlserver.jdbc.sqlserverdriver T prepare the [Oracle PE] database fr XA, perfrm these steps: 1. Lg n t sqlplus as system user; fr example, sqlplus sys/change_on_install@<database ALIAS NAME> 2. Execute cmmand. 3. Grant the fllwing permissins: grant select n v$xatrans$ t public (r <user>); grant select n pending_trans$ t public; grant select n dba_2pc_pending t public; grant select n dba_pending_transactins t public; (when using the Oracle Thin driver r later) grant execute n dbms_system t <user>; If these steps are nt perfrmed n the database server, nrmal XA database queries and updates wrk as expected. Hwever, when the Weblgic Server Transactin Manager perfrms recvery n a re-bt after a crash, recvery fr the Oracle resurce fails with XAER_RMERR. Crash recvery is a standard peratin fr an XA resurce. Cpyright IBM Crp. 2002,

154 IBM FileNet P Release Ntes Knwn Issues Prcess Designer The fllwing infrmatin is missing frm the dbexecute System Instructin tpic in the nline Help fr Prcess Designer: Best practices using stred prcedures Database stred prcedures can thrw exceptins, s yu shuld cnsider handling exceptins in the stred prcedure r in an exceptin map in the wrkflw. If yu have upgraded frm FileNet P8 versin r earlier and yu are using Micrsft SQL Server, yu might see exceptins in delete r update statements that yu did nt see befre. The database will return an exceptin when a delete r update statement that cntains a Where clause des nt select any recrds. Fr example, if yu are deleting all recrds where Name=Dn, if there are n recrds where Name=Dn, the stred prcedure receives an errr frm the database. If yu d nt catch these exceptin in the stred prcedure, then the wrk bject receives the exceptin and ges t either yur exceptin map r t the Malfunctin queue The fllwing tw tpics have incrrect infrmatin related t disabling inheritance in a wrkflw: Preferences - wrkflw Abut inheritance These tw tpics shuld cntain the fllwing statement: If yu disable inheritance in a wrkflw, all items inherited and nt verwritten frm the previus base wrkflw will n lnger be available. If these items are referenced in the wrkflw, validatin errrs will ccur.. Prcess Engine In the nline Help fr Prcess Designer, the tpic "Wrkflw Prperties dialg - data fields" shuld have the fllwing nte after the instructins fr entering the descriptin f the data field: Nte Text yu enter fr the descriptin will display when yu select the data field as a parameter fr a step in the wrkflw. Yu can change the descriptin f each parameter at each step. The descriptin that displays fr a step parameter is the descriptin that exists when yu select that data field as a parameter fr the step. If yu subsequently change the descriptin fr a data field in the Wrkflw Prperties dialg bx, the descriptin des nt change at each step where the data field is used as a parameter. (T update the descriptin at the step, yu can remve the parameter and re-add it.) Detailed steps were added t the "Cnvert existing regin t recvery enabled" tpic t help users recreate Prcess Engine database views. The new sectin is called "Running the database views cmmand." Cpyright IBM Crp. 2002,

155 IBM FileNet P Release Ntes Knwn Issues Prcess Task Manager The Prcess Task Manager tpic "Cnfigure language packs" incrrectly lists the UNIX path t the default ntificatin templates fr English as "/fnsw/lc/sd/msg". The crrect UNIX path is "/fnsw/lcal/sd/msg". Business Activity Mnitr On page 43, the link fails in trying t access IBM dcumentatin fr Creating Applicatin Servers fr versin 6.0. Use the fllwing link t access the dcumentatin: Search fr "Creating applicatin servers". Applicatin Engine Task 14: Install Applicatin Engine has an installatin screen in the incrrect rder. The "Cnfigure User Tken Security" screen listed n page 208 shuld be lcated after the "Specify Dwnlad Lcatin" screen n page 210. Prtal Integratin The sectin Cnfigure JAAS Lgin is missing frm the FileNet P8 Prtal Integratin Installatin and Upgrade Guide fr WebLgic. This sectin belngs after "Cnfigure SSO (ptinal)" and befre "Cnfigure the Prtlets (ptinal)" in the Installatin tasks, and after Run the FileNet P8 Prtlets Installer in the Upgrade tasks. Perfrm the fllwing prcedure fr all systems. T mdify the applicatin server startup script fr JAAS lgin: 1. If the WebLgic server is running, stp the server. 2. Make a backup cpy f the applicatin server startup script. If yu are using a WebLgic dmain, mdify startweblgic.cmd fr Windws r startweblgic.sh fr UNIX. If yu are nt using a WebLgic dmain, mdify startwls.cmd fr Windws r startwls.sh fr UNIX. 3. Use a text editr t pen and edit the applicatin server startup script. 4. Add ne f the fllwing immediately after the classpath entry fr WebLgic. D nt enter the line break shwn after cnfig=. The entire jaas_lgin entry must be n a single line. Jaas Lgin cnfiguratin setting set jaas_lgin=%jaas_lgin% -Djava.security.auth.lgin.cnfig= <Prtlets_install_path>:\FileNet\Prtlets\cnfig\jaas.cnf.WebLgic where <Prtlets_install_path> is the lcatin where yu installed Applicatin Cpyright IBM Crp. 2002,

156 IBM FileNet P Release Ntes Knwn Issues UNIX AIX Engine. Fr example: "C:\Prgram Jaas Lgin cnfiguratin setting jaas_lgin= ${jaas_lgin} -Djava.security.auth.lgin.cnfig= <Prtlets_install_path>/FileNet/Prtlets/CE_API/cnfig/jaas.cnf.WebLgic where <Prtlets_install_path> is the lcatin where yu installed Applicatin Engine. Fr example: Jaas Lgin cnfiguratin setting jaas_lgin= ${jaas_lgin} -Djava.security.auth.lgin.cnfig= /pt/filenet/prtlets/ce_api/cnfig/jaas.cnf.weblgic jaas_lgin="${jaas_lgin} - Dlgin.cnfiguratin.prvider=cm.ibm.security.auth.lgin.CnfigFile where <Prtlets_install_path> is the lcatin where yu installed Applicatin Engine. Fr example: "/pt/filenet/prtlets/ce_api/cnfig/jaas.cnf.weblgic". 5. Add %jaas_lgin% sectin as indicated in the examples belw in bld. WebLgic 8 - Windws - after the CLASSPATH settings ech. ech CLASSPATH=%CLASSPATH% ech. ech PATH=%PATH% ech. ech *************************************************** ech * T start WebLgic Server, use a username and * ech * passwrd assigned t an admin-level user. Fr * ech * server administratin, use the WebLgic Server * ech * cnsle at * ech *************************************************** %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %jaas_lgin% - Dweblgic.Name=%SERVER_NAME% -Dweblgic.management.username=%WLS_USER% - Dweblgic.management.passwrd=%WLS_PW% - Dweblgic.PrductinMdeEnabled=%PRODUCTION_MODE% - Djava.security.plicy="%WL_HOME%\server\lib\weblgic.plicy" weblgic.server WebLgic 8 - UNIX - after the CLASSPATH settings ech. ech CLASSPATH=%CLASSPATH% ech. ech PATH=%PATH% ech. ech *************************************************** ech * T start WebLgic Server, use a username and * ech * passwrd assigned t an admin-level user. Fr * ech * server administratin, use the WebLgic Server * ech * cnsle at * ech *************************************************** %JAVA_HOME%/bin/java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %jaas_lgin% - Dweblgic.Name=%SERVER_NAME% -Dweblgic.management.username=%WLS_USER% - Dweblgic.management.passwrd=%WLS_PW% - Dweblgic.PrductinMdeEnabled=%PRODUCTION_MODE% - Djava.security.plicy="%WL_HOME%/server/lib/weblgic.plicy" weblgic.server WebLgic 9 - Windws - in the WLS_REDIRECT_LOG settings If %WLS_REDIRECT_LOG% == ( ech Starting WLS with line: ech %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %jaas_lgin% -Dweblgic.Name=%SERVER_NAME% - Cpyright IBM Crp. 2002,

157 IBM FileNet P Release Ntes Knwn Issues Djava.security.plicy=%WL_HOME%\server\lib\weblgic.plicy %PROXY_SETTINGS% %SERVER_CLASS% %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %jaas_lgin% - Dweblgic.Name=%SERVER_NAME% -Dweblgic.management.username=%WLS_USER% - Dweblgic.management.passwrd=%WLS_PW% - Djava.security.plicy=%WL_HOME%\server\lib\weblgic.plicy %PROXY_SETTINGS% %SERVER_CLASS% ) else ( ech Redirecting utput frm WLS windw t %WLS_REDIRECT_LOG% %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %jaas_lgin% - Dweblgic.Name=%SERVER_NAME% -Dweblgic.management.username=%WLS_USER% - Dweblgic.management.passwrd=%WLS_PW% - Djava.security.plicy=%WL_HOME%\server\lib\weblgic.plicy %PROXY_SETTINGS% %SERVER_CLASS% > %WLS_REDIRECT_LOG% 2>&1 ) WebLgic 9 - UNIX - in the WLS_REDIRECT_LOG settings If %WLS_REDIRECT_LOG% == ( ech Starting WLS with line: ech %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% $(jaas_lgin) -Dweblgic.Name=%SERVER_NAME% - Djava.security.plicy=%WL_HOME%\server\lib\weblgic.plicy %PROXY_SETTINGS% %SERVER_CLASS% %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% $(jaas_lgin) - Dweblgic.Name=%SERVER_NAME% -Dweblgic.management.username=%WLS_USER% - Dweblgic.management.passwrd=%WLS_PW% - Djava.security.plicy=%WL_HOME%\server\lib\weblgic.plicy %PROXY_SETTINGS% %SERVER_CLASS% ) else ( ech Redirecting utput frm WLS windw t %WLS_REDIRECT_LOG% %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% $(jaas_lgin) - Dweblgic.Name=%SERVER_NAME% -Dweblgic.management.username=%WLS_USER% - Dweblgic.management.passwrd=%WLS_PW% - Djava.security.plicy=%WL_HOME%\server\lib\weblgic.plicy %PROXY_SETTINGS% %SERVER_CLASS% > %WLS_REDIRECT_LOG% 2>&1 ) 6. Save and clse the server startup script The FileNet P8 Prtal Integratin Installatin Guide fr WebSphere cntains incrrect infrmatin. In the "Upgrade Planning and Prcedures" tpic, step 5 incrrectly lists WebSphere Prtal Server 6.x as a supprted envirnment. WebSphere Prtal Server 6.x is nt supprted. D nt use the prcedure "Migrating frm Prtal Server 5.x t Prtal Server 6.x" n page The FileNet P8 Prtal Integratin Installatin and Upgrade Guide fr WebSphere is missing prcedure infrmatin fr LDAP settings fr bth install and upgrade. In the Installatin Planning and Prcedures > Prerequisites sectin, Step 3 states "Cnfigure LDAP if needed." It shuld state: "Use the WebSphere Administrative Cnsle t cnfigure LDAP using the same settings as the Cntent Engine." In the Upgrade Planning and Prcedures > Prerequisites sectin, step 6 states "Cnfigure LDAP if needed." It shuld state: "Use the WebSphere Administrative Cnsle t cnfigure LDAP using the same settings as the Cntent Engine." efrms Designer In the help tpic "Cnfigure HTTP lkups fr text/xml - sample", the usage f the <efrmlkup> tag is incnsistent. Cpyright IBM Crp. 2002,

158 IBM FileNet P Release Ntes Knwn Issues In the help tpic "Cnfigure a buttn with a built-in cmmand," mre infrmatin is required t explain where t enter the URL fr the page that the help buttn shuld bring up. (G t Frm/Template Infrmatin and enter the URL in the "Help URL" field.) In the efrms help, any actins/functins that are listed as being lcated under Authr, Tls r Authr, Advanced Tls are actually lcated under the Tls drpdwn menu in Wrkplace XT The install guide des nt include the mentin f a nn-fatal warning that ccurs during installatin f Designer n tp f the previus versin. Part way thrugh the installatin, a warning dialg appears stating that anther installatin is already in prgress. Yu can either click OK at that pint, r just leave the dialg and the install will cntinue With the release f efrms Designer 5.0.2, yu can use DateTime within the Value dialg when setting cnstant values. This feature is nt dcumented in the efrms Designer help With efrms Designer 5.0.2, yu can use a DateTime value in a lkup, submit, r autincrement. Details f this feature d nt appear in the dcumentatin With efrms Designer 5.0.2, yu can prcess calculated chice lists that cntain DateTime values. This feature is nt dcumented in the efrms Designer help With the release f efrms Designer 5.0.2, yu can use DateTime within the Value dialg when setting cnstant values. A dcumentatin tpic additin is required t cmment n limitatins and recmmend alternative methds efrms Designer 6.0.0, in the help tpic "Cnfigure HTTP lkups fr text/xml - sample", there are incnsistencies in the efrm lkup tag. <efrmlkup> is the crrect syntax fr the lkup tag. All ther variatins are invalid The PurchaseOrder.itx sample template prvided as part f the efrms Designer tutrial, lcated in the default lcatin C:\Prgram Files\FileNet\eFrms\Designer\Tutrials\Use with P8, cntains the fllwing errr: The SQL statement in the '1: PO_Number' field Aut-increment cntains the fllwing entry: Select PONumber frm tblorders; Update tblorders Set PONumber = "PONumber" + 1; Select PONumber frm tblorders; <<1@PO_Number>>" The fllwing SQL statement shuld be entered instead: Select PONumber frm tblorders Update tblorders Set PONumber = "PONumber" + 1 Select PONumber frm tblorders; <<1@PO_Number>>" Cpyright IBM Crp. 2002,

159 IBM FileNet P Release Ntes Knwn Issues P8 efrms In the P8 efrms User Help, "Fill in Tables" tpic, the descriptin f duble arrw scrll (>>) shuld state: Clicking the duble dwn scrll buttn will scrll dwn such that the bttm visible line is shifted t the tp visible line. The behavir is similar t a typical page dwn functin. IBM FileNet Cnnectr fr SharePint Dcument Libraries Currently, the "Run the archive prcess' in the imprt_prcess.htm tpic includes the prcedure fr starting the archive prcess: T run the archive prcess 1. Frm the the server where the Cnnectr fr SharePint Dcument Libraries is installed, pen the Micrsft Windws Cntrl Panel. 2. Select Administrative Tls, and duble-click the Services applet. 3. In the Services applet, manually start the Task Ruting Engine service This prcedure shuld als include instructins fr stpping the archive prcess: T stp the archive prcess 1. Frm the the server where the Cnnectr fr SharePint Dcument Libraries is installed, pen the Micrsft Windws Cntrl Panel. 2. Select Administrative Tls, and duble-click the Services applet. 3. In the Services applet, manually stp the Task Ruting Engine service. IBM FileNet Cnnectr fr SharePint Web Parts The table f cntents entry fr "Search fr dcuments (advanced)" [FileNet P8 Dcumentatin > Expansin Prducts > IBM FileNet Cnnectr fr SharePint > Wrk with IBM FileNet P8 dcuments > Search fr dcuments (advanced)] shuld display the "Search fr dcuments (advanced)" tpic. Instead, it displays the "Search fr dcuments (basic)" tpic. T view the "Search fr dcuments (advanced)" tpic, click n the "advanced" search ptin link in the bdy f the displayed page. Cntent Engine Java and.net API Develper s Guide The ObjectSecurityCacheEntryTTL and ObjectSecurityCacheMaxEntrie prperties are incrrectly described in the Cntent Engine Java and.net API reference help. The fllwing descriptins are the crrected text fr these prperties. ObjectSecurityCacheEntryTTL Specifies the Time-T-Live (TTL) in secnds fr entries in the bject security cache. Once the TTL has elapsed, cached infrmatin that has becme stale is discarded and fresh data is btained frm the database. Cpyright IBM Crp. 2002,

160 IBM FileNet P Release Ntes Knwn Issues ObjectSecurityCacheMaxEntries Specifies the maximum number f entries in the bject security cache. When the maximum number is exceeded, the least recently used elements are remved t allw fr mre recently used elements t be cached Applicatin-server specific JAR files are nly required when setting up a thick client (see Cntent Engine Java and.net API Develper s Guide > Getting Started > Develper Requirements > Setting Up a Thick Client Develpment Envirnment fr infrmatin.) Fr a J2EE applicatin, the required JAR files are already in yur envirnment. If yu are setting up a thick client, als refer t yur applicatin server dcumentatin fr the required JAR files and ther settings fr yur envirnment and their descriptins. Therefre, in the Required Java Archive (JAR) Files tpic in the Cntent Engine Java API Develper s Guide > Getting Started Cncepts, the fllwing prtin f the table is bslete. WebLgic WebSphere Applicatin Server Specific JAR Files WebLgic JAR files cntain applicatin server classes and are nly required when running the Java API ver the EJB prtcl. wlcient.jar - Preferred. (Use weblgic.jar if yu encunter prblems with wlclient.jar.) Typically cntains an applicatin server-specific JAAS lgin mdule as well as applicatin server-specific JNDI classes. Only supprts "iip" prtcl. weblgic.jar - Cntains an applicatin server-specific JAAS lgin mdule as well as applicatin server-specific JNDI classes. Supprts "iip" and "t3" prtcls. WebSphere JAR files cntain applicatin server classes and are required nly when running the Java API ver the EJB prtcl. JAR files are unique t the versin f WebSphere yu are using, as shwn belw. The JAR files typically cntain an applicatin server-specific JAAS lgin mdule as well as applicatin server-specific JNDI classes. The wssec.jar file cntains classes used fr WebSphere authenticatin. Fr WebSphere 5.1.1: j2ee.jar jmxc.jar wssec.jar Fr WebSphere 6.0.2: j2ee.jar management.jar Cpyright IBM Crp. 2002,

161 IBM FileNet P Release Ntes Knwn Issues JBss jbssall-client.jar file cntains applicatin server classes and are required nly when running the Java API ver the EJB prtcl. The JAR file typically cntains an applicatin server-specific JAAS lgin mdule as well as applicatin server-specific JNDI classes. In additin, in Setting Up a Thick Client Develpment Envirnment, all references t the bsleted infrmatin nted abve shuld be ignred, and instead, the applicatin server dcumentatin fr yur envirnment shuld be cnsulted In Getting Started Cncepts > Develper Requirements > Required Java Archive (JAR) Files, the descriptin sectin f the table entry fr wasp.jar cntains tw incrrect references t wsdl.jar. The crrect JAR file name is wsdl_api.jar The tpic "Update event actin with a new cde mdule versin" can be fund in a search but is missing frm the TOC in the Events and Subscriptin sectin f the Cntent Administratin help. This tpic describes hw t update an event actin t reference a cde mdule that has been changed, but is missing infrmatin abut mime type cnfiguratin. Users shuld use the fllwing text instead: Cde mdules are versined dcuments. If yu mdify a Java actin handler cntained within a cde mdule and check it in as a new versin, yu must als update any event actins that reference the cde mdule in rder t use the new versin f the cde mdule. T update a cde mdule and actin 1. Check ut the cde mdule, making nte f its mime type. The mime type can be fund as fllws: a. Right-click the cde mdule. b. Select Prperties frm the cntext menu. c. Select the Prperties tab. d. Nte the Mime Type prperty value. 2. Mdify the Java actin handler surce and cmpile it. 3. Check in the new versin f the cde mdule. Ensure that the mime type f the new versin f the cde mdule is the same as that f the previus versin; therwise, the event actin will nt wrk with the new versin f the cde mdule. 4. Right-click the cde mdule and select Cpy Object Reference frm the cntext menu. 5. D the fllwing steps fr each event actin that references the cde mdule. a. In the tree view, expand Object Stres > bject stre name, and then navigate t the flder where the event actin resides. Fr example: - Dcument Classificatin Actins - Dcument Lifecycles > Dcument Lifecycle Actins - Events > Event Actins b. Right-click the event actin that references the updated cde mdule and select Prperties frm the cntext menu. c. Select the Prperties tab. d. Select the All Prperties radi buttn and scrll t the Cde Mdule prperty at the Cpyright IBM Crp. 2002,

162 IBM FileNet P Release Ntes Knwn Issues bttm f the dialg bx. e. Right-click the Cde Mdule prperty's Prperty Value field and select Paste Object frm the cntext menu. f. In the Select Object frm Paste Buffer dialg bx, select the latest versin bject reference and click OK. g. In the Prperties dialg bx, click Apply, then click OK The dcumentatin fr anntatin access rights shuld reflect that Full Cntrl, Mdify Prperties, View Prperties and View Cntent are the nly valid ptins fr anntatin access rights and custm security settings are nt supprted. The fllwing bullet pint frm the list f anntatin characteristics in the Anntatins Cncepts sectin shuld be updated with the highlighted (bld) text. The text describes a limitatin n permissins settings when the Wrkplace r Wrkplace XT applicatin is used t view anntatins: Yu can wrk with an anntatin's Class bject as yu wuld wrk with the class descriptins assciated with ther Cntent Engine bjects. Fr example, yu can: Return default security fr an bject f the class. Fr example, when yu create a new Anntatin bject, yu might want t determine if the default security is apprpriate fr yur applicatin r yu might display the default security in a user interface and allw the user t change the security. If yu are using Wrkplace r Wrkplace XT, be aware that these applicatins limit permissins n anntatins t the fllwing simplified permissin levels: Owner Cntrl, Mdify Cntent, and View Cntent. Fr mre infrmatin, see the Available permissins tpic in User Help > Actins, preferences and tls > Wrk with Security > Manage Security. These applicatins d nt hnr custm access rights that yu set n anntatins using the API The Cntent Engine Java and.net Develper's Guide des nt clearly state the restrictins fr updating the surce bject f an event actin handler r a lifecycle actin handler. The fllwing text applies t the "Implementatin Cncepts" tpic. In synchrnus event actin handlers r lifecycle actin handlers, d nt update the surce bject f the event; it is nt supprted. T update an event's surce bject, use an asynchrnus event actin handler. But in ding s, make sure t first fetch the persisted instance f the surce bject befre updating it. Fr asynchrnus event actin handlers r dcument classifiers, yu can call the Save methd n the fetched surce bject f the event, as lng as there is n infinite lp t waste system resurces. D nt update the surce bject instance passed t the event handler because, in asynchrnus mde, the surce bject may already have changed befre the event handler executes, and, therefre, the event's surce bject may be bslete. Cntent Engine COM API (Cmpatibility Layer) As dcumented, the islcked() methd des a calculatin based n the LckTimeut prperty and cmpares it t the current system time. Because that calculatin is perfrmed Cpyright IBM Crp. 2002,

163 IBM FileNet P Release Ntes Knwn Issues n the client system, the result might be incrrect if the client and server clcks are nt synchrnized. This issue will be addressed in a future release. Prcess Engine Develper s Guide The 4.0.x dcumentatin did nt crrectly describe the infrmatin necessary t cnfigure the Cmpnent Manager fr JMS. The affected dcuments are:"develping Cmpnent Integratr-Based Wrk Perfrmers" (/develper_help/prcess_java_api/guide/custm/ci_dev.htm) and "Cnfiguring the Prcess Develpment Envirnment" (/develper_help/prcess_java_api/guide/misc/install_pde.htm). This dcumentatin was crrected in the P8 4.5 release. (Refer t that dcumentatin, if necessary.) Prcess Engine API Attempting t run the Prcess Engine API samples (initiated using MainSample) will generate an errr when using the EJB prtcl. efrms Java API Exceptin descriptins are nt cnsistent in the Javadcs. Cpyright IBM Crp. 2002,

164 IBM FileNet P Release Ntes Reslved Knwn Issues Reslved Knwn Issues Miscellaneus Memry leak with WebSphere/Oracle cnfiguratin when statement cache is turned n. The server receives ut-f-memry errrs if statement cache is turned n. The default size f the statement cache is 10; the wrkarund is t set the statement cache size t 0 fr all data surces. Reslved by dcumentatin update ISV sftware BEA JRckit 1.5.0_10 fails when running under heavy lads fr lng perids, with "Errr Message: Illegal memry access. [54]". This is a prblem with the third-party BEA JRckit 1.5.0_10 Java(TM) Virtual Machine (JVM). Cntact BEA supprt fr mre infrmatin. Rebting the applicatin server can smetimes clear the prblem. Alternatively, yu can switch t the Sun JVM that cmes with WebLgic. See the WebLgic dcumentatin fr mre infrmatin The fllwing infrmatin needs t be added t the Cntent Engine Java and.net Develper's Guide: When an applicatin attempts t set the PrpertyDefaultString prperty f a PrpertyTemplateString bject t a lng string that is less than 4000 characters, a DB_ERROR exceptin is thrwn instead f a BAD_VALUE exceptin. This is because the maximum rw size f the database has been exceeded, but nt the maximum length allwed fr the prperty value The fllwing infrmatin needs t be added t the Cntent Engine Java and.net Develper's Guide: If an E_READ_ONLY exceptin is thrwn because a client applicatin is attempting t update ne r mre read-nly prperties during a user-initiated transactin, the transactin will nt be autmatically rlled back by the server; a client applicatin must explicitly rllback r cmmits the data The fllwing infrmatin needs t be added t the Cntent Engine Java and.net Develper's Guide: If a federated dcument class is changed t a native Cntent Engine dcument class and that dcument is deleted n the Cntent Engine server, it will als be deleted n Image Services. Hwever, if an IS Anntatin class is changed t a native Cntent Engine Anntatin class, a deletin f this anntatin n the Cntent Engine server will nt be prpagated t Image Services The reference help incrrectly dcuments the default fr the pagesize parameter fr the fllwing methds:.net - IRealm.FindUsers and IRealm.FindGrups Java - Realm.findUsers and Realm.FindGrups The dcumentatin states that the default is 50; the crrect default is 499. Cpyright IBM Crp. 2002,

165 IBM FileNet P Release Ntes Reslved Knwn Issues In the Cntent Engine Java and.net APIs, the Realm.findUsers and Realm.findGrups methds include a pagesize parameter. The Reference dcumentatin fr this parameter incrrectly states that if the parameter is set t null r zer (0), the page size defaults t 50. In releases prir t 4.0.1a, the default was 50. Hwever, the page size default has been changed t In the Cntent Engine API Develper's Guide, the Event Prperties tpic is in errr. The descriptin f the EventStatus prperty incrrectly states that t retrieve the EventStatus prperty in an event actin handler, yu must retrieve the Event bject using the Factry.fetchInstance methd. In fact, ding s will result in an errr. T retrieve the EventStatus prperty in the event actin handler, use the Event bject that is passed t the handler The fllwing tw crrectins must be made t the cde snippets in the Cntent Engine Java and.net Develper's Guide > Getting Started Prcedures: Fr the cde snippet under Getting Started Prcedures > Getting a Cnnectin > Java tpic: // Get the cnnectin String uri = "t3//remtehst:7001/filenet/engine"; Cnnectin cnn = Factry.Cnnectin.getCnnectin(uri); add a cln after t3, as shwn belw: // Get the cnnectin String uri = "t3://remtehst:7001/filenet/engine"; Cnnectin cnn = Factry.Cnnectin.getCnnectin(uri); Fr the cde snippet under Wrking with Security > Obtaining a LginCntext tpic: // Obtain a JAAS Subject and assciate it with the UserCntext UserCntext uc = UserCntext.get(); uc.pushsubject(usercntext.createsubject("username", "passwrd", "FileNetP8")); add a cnnectin parameter t UserCntext.createSubject, as shwn belw: // Obtain a JAAS Subject and assciate it with the UserCntext UserCntext uc = UserCntext.get(); uc.pushsubject(usercntext.createsubject("cnnectin", "username", "passwrd", "FileNetP8")); In the Java API Reference and the.net API Reference fr the Cntent Engine APIs, the descriptin f the FilterExpressin prperty incrrectly states that the LIKE peratr is nt supprted fr Subscriptin and StragePlicy bjects. In fact, the LIKE peratr is supprted Date bjects retrieved frm the Cntent Java API cmpatibility layer used with Cntent Engine 4.x are stred and retrieved with millisecnd precisin. This Date bject behavir is incnsistent with the Cntent Java API used with Cntent Engine 3.5.x, in which millisecnds are truncated n setting prperty values and millisecnds are runded n reading prperty values. T maintain cnsistency, the Cntent Java API cmpatibility layer nw handles Date bjects in the same way as the Cntent Java API and Cntent Engine 3.5.x. Nte Shuld yu migrate a 3.5.x applicatin running against the Cntent Java API cmpatibility layer t a 4.x applicatin using the native Cntent Engine Java API, yu will see full precisin in date values, with the exceptin f date values that were previusly stred by using the Cntent Java API cmpatibility layer. Fr thse values, the millisecnds will be zer. Cpyright IBM Crp. 2002,

166 IBM FileNet P Release Ntes Reslved Knwn Issues Cntent Engine Develper s Guide links t wrng versin f the FileNet P8 Platfrm Hardware and Sftware Requirements dcument. A link in the Getting Started sectin f the Cntent Engine Java and.net Develper s Guide pints t the 3.5.x versin f the FileNet P8 Platfrm Hardware and Sftware Requirements dcument. See Accessing IBM FileNet Dcumentatin. T access the 4.0.x versin, perfrm the fllwing steps: 1. Click FileNet Cntent Manager in the Select a categry list. The FileNet Cntent Manager Prduct supprt page appears. 2. Click Prduct dcumentatin. The Prduct Dcumentatin fr FileNet Cntent Manager page appears. 3. Click the dcumentatin link fr the FileNet P8 Platfrm. 4. Click the v 4.0 link t pen the FileNet P8 Hardware and Sftware Requirements dcument By default, IIS 6.0 has default recycling settings which will peridically restart the wrker prcess. Users may encunter archive failure during the wrker prcess recycling perid. T avid thse failures while migrating a large set f dcuments frm SharePint t P8, users may chse t change r disable the IIS recycling setting. See the links frm Micrsft fr hw t cnfigure the IIS recycling setting: b359abbf1033.mspx?mfr=true 230c-4b0e-a a3095e1.mspx?mfr=true The "Task 4c: Cnfigure IBM FileNet Wrkplace XT (JBss)" task in the "Wrkplace XT Installatin and Upgrade Guide" includes a step ("6. Disable JBss lgging t prevent unexpected behavir in the deplyed IBM FileNet sftware") fr disabling JBss lgging t avid perfrmance issues. With lgging disabled, the JBss cnsle des nt display messages that the applicatin server has been prperly started, which might be cnfusing t an administratr wh has launched the JBss startup script. T verify that the applicatin server has started prperly, yu can launch the Wrkplace XT client applicatin frm a brwser windw. Alternatively, yu can use the fllwing prcedure t reinstate startup cnsle messages, while aviding excessive tracing messages in the cnsle and lg files. 1) Open the lg4j.xml file (<JBOSS_hme>/server/default/cnf/lg4j.xml) fr editing. 2) Add the fllwing Threshld line fr the FILE appender. <!-- A time/date based rlling appender --> <appender name="file" class="rg.jbss.lgging.appender.dailyrllingfileappender"> <errrhandler class="rg.jbss.lgging.util.onlyonceerrrhandler"/> <param name="file" value="${jbss.server.lg.dir}/server.lg"/> <param name="append" value="false"/> <param name="threshld" value="error"/> 3) Keep the CONSOLE appender threshld at INFO level. <!-- ============================== --> Cpyright IBM Crp. 2002,

167 IBM FileNet P Release Ntes Reslved Knwn Issues <!-- Append messages t the cnsle --> <!-- ============================== --> <appender name="console" class="rg.apache.lg4j.cnsleappender"> <errrhandler class="rg.jbss.lgging.util.onlyonceerrrhandler"/> <param name="target" value="system.ut"/> <param name="threshld" value="info"/> 4) Add the fllwing lines: <categry name="filenet_errr.api"> <pririty value="error"/> </categry> <categry name="filenet_tracing.api"> <pririty value="off"/> </categry> <categry name="cm.filenet.wcm.api"> <pririty value="error"/> </categry> <categry name="cm.filenet-trace"> <pririty value="off"/> </categry> <categry name="cm.filenet-debug"> <pririty value="error"/> </categry> Nte Yu can add additinal categries as needed. 5) Remve the rt categry pririty, if any. <!-- ======================= --> <!-- Setup the Rt categry --> <!-- ======================= --> <rt> Cpyright IBM Crp. 2002,

168 IBM FileNet P Release Ntes Reslved Knwn Issues <pririty value="error"/> <appender-ref ref="console"/> <appender-ref ref="file"/> </rt> In the IBM FileNet Wrkplace XT Installatin and Upgrade Guide, the tpic "Deply IBM FileNet Wrkplace XT (WebSphere)" has an incrrect setting. The fllwing step ccurs in the prcedure "T deply Wrkplace XT (WebSphere 6.1.x)": Step 9 d reads "Under Class lader rder, select 'Classes laded with parent class lader first'." This step shuld read "Under Class lader rder, select 'Classes laded with applicatin class lader first'." In the IBM FileNet Wrkplace XT Installatin and Upgrade Guide, the task "Upgrade IBM FileNet Wrkplace XT" mits an imprtant step fr systems that have been ptinally cnfigured t supprt user tkens with Wrkplace XT. Nte Yu can perfrm this step at any time after yu run the upgrade install. (Optinal) Update authenticatin files t supprt user tkens fr Wrkplace XT. WebSphere a. Stp WebSphere, if it is running. b. Cpy the authenticatin-websphere.jar file frm here: <install_path>/filenet/webclient/wrkplacext/authenticatinfiles t here: <WAS_hme>/AppServer/lib/ext c. Cpy the lg4j jar file frm here: <install_path>/filenet/webclient/wrkplacext/web-inf/lib t here: <WAS_hme>/AppServer/lib/ext WebLgic a. Stp WebLgic, if it is running. b. Cpy the authenticatin-weblgic-9.jar file frm here: <install_path>/filenet/webclient/wrkplacext/authenticatinfiles t here: <WL_hme>/server/lib/mbeantypes c. Cpy the lg4j jar file frm here: <install_path>/filenet/webclient/wrkplacext/web-inf/lib t here: <WL_hme>/server/lib/mbeantypes Cpyright IBM Crp. 2002,

169 IBM FileNet P Release Ntes Reslved Knwn Issues JBss a. Stp JBss, if it is running. b. Cpy the authenticatin-utils.jar file frm here: <install_path>/filenet/webclient/wrkplacext/authenticatinfiles t here: <JBOSS_hme>/server/default/lib Reslved in P8AE-FP In the Image Viewer, when using the Strike Thrugh buttn fr stamp anntatins n previus versins f an image, the "Strike Thrugh" setting is nt saved when the image is repened. Reslved in Fix Pack P8AE-FP001 When running Applicatin Engine n WebSphere with JVM 1.4, WebDAV cnnectin fails. The slutin is t upgrade t JVM 1.5 r later r upgrade t P8AE-FP001. Reslved in Service Pack P8AE The prcedure t add an Outlk message with attachment fails when the fllwing is true: The Outlk message with the attachment was added using an entry template r Add wizard. That attachment was nt als added CBR Search returns dcuments that d nt match the criteria when the NEAR peratr is specified in the criteria fr search templates, stred searches, and simple searches. Reslved in Service Pack P8AE Fr cmpund dcuments, the Add Child wizard incrrectly allws a child dcument t be selected frm an bject stre different frm its parent dcument using Brwse. Yu can create parent-child relatinships nly within the same bject stre When yu install File Tracker using a user-specified lcatin, the Windws DLLs are nt installed under the cre install path. As a result, the File Tracker cannt functin. The wrkarund is t mve the Windws DLL frm the user-specified lcatin t the cre install path. Cpyright IBM Crp. 2002,

170 IBM FileNet P Release Ntes Reslved Knwn Issues Wrkplace FileTracker fails t run if the efrms Designer is installed prir t FileTracker r if FileTracker is installed t a nn-default lcatin. Wrkarund: Cpy the Windws DLL files (atl71.dll, mfc71.dll, mfc71u.dll, msvcp71.dll, and msvcr71.dll) t the default install lcatin. (On Windws: c:\prgram Files\FileNet\FileTracker. On UNIX: pt/filenet/filetracker.) If yu mve the DLL files, the uninstaller will nt remve the DLL files. Yu must manually delete the DLL files frm the default install path File Tracker actins fail with a runtime errr with different scenaris With My Wrkplace Page pen, when the sessin has timed ut, selecting the Sign ut link returns a null exceptin The uninstaller deletes all Applicatin Engine files, even if yu selected N at the prmpt t remve all files. Custmized files in the Wrkplace directry are als remved. Wrkarund: Make a backup cpy f all files befre running the uninstaller Wrkplace sign in attempts fail n Applicatin Engine installatins using Cntainer Managed authenticatin n JBss. Reslved in Fix Pack P8PA The data cmpressin wizard displays Hur and Hur instead f Mnth and Day n the first page. Nte This defect is fixed in this fix pack but it is nt dcumented in the readme fr that fix pack. Reslved in BPM (Prcess Engine) P8PE Service Pack Wrkflw Subscriptins with bth Wrkflw and Event Expressins require manual evaluatins pst-upgrade Supprt fr DB2 is included in the Business Prcess Manager (BPM) installer but it is nt supprted in this release f FileNet P Reslved in BPM (Prcess Engine) The errr displayed says There was a mini-installer failure. Please cancel the installatin and see... If the mini-installer has nt started, please see nulltmp_installer\setup_ut.lg." The crrect lcatin is <drive>:\tmp_installer\setup_ut.lg where the drive is the installatin lcatin fr Prcess Engine sftware The "Back" buttn n the "Select sftware Cmpnents that shuld be started..." shuld be grayed ut. Cpyright IBM Crp. 2002,

171 IBM FileNet P Release Ntes Reslved Knwn Issues After the Prcess Engine patch installer fr Windws has finished cpying the files, the screen "Select sftware Cmpnents that shuld be started" cmes up. At this stage f the installatin when the files have already been cpied the "Back" buttn des nt serve any purpse. The nly way t remve the files is t uninstall the Prcess Engine applicatin. The Back buttn shuld be treated as grayed ut. Reslved in BPM (Prcess Engine) D nt restart the Prcess Service during upgrades. D nt restart the Prcess Service during the Prcess Engine security update as this can cause prblems that will necessitate a restre f the database and a restart f the upgrade prcess. Fr mre infrmatin, see the "T update the Prcess Engine security" prcedure f the IBM FileNet P8 Platfrm Installatin and Upgrade Guide task "Cmplete Pst- Upgrade Prcess Engine Cnfiguratin When attempting t install Prcess Engine n a Windws 2003 SP2 server, the pst bt installatin hangs at 99 percent. T rebt and cmplete the Prcess Engine installatin: Befre rebting the server t cmplete the installatin, create the fllwing zer byte file, C:\temp\fn_newinit, then rebt. T recver frm a hung pstbt installatin: If yu failed t create the file befre rebting, t avid hanging the installer, stp the installatin, create the file, and then and run the pst-bt setup prgram by navigating t the Prcess Engine\IMSInst install flder and executing: setup.exe -pstbt Prcess Engine installs a new ims_start script, which upn installatin, causes prblems when bringing up the Prcess Task Manager. Prir t Prcess Engine 4.0.2, the ims_start script was mdified with an address f After upgrading t Prcess Engine 4.0.2, the address is n lnger stated in the ims_start script. When a user attempts t pen the Prcess Task Manager, the system returns an errr and the Prcess Task Manager des nt pen. Wrkarund: After the installatin, mdify the ims_start script under /fnsw/lcal/sd/ims_start t include the address Fr example: nhup /usr/ccs/bin/dldd 2>&1 >/dev/null elif [ '11' = "$OSVER" ] then if [ 'ia64' = `uname -m` ] then nhup /usr/ccs/lbin/dldd32 +a 0x >&1 >/dev/null else nhup /usr/ccs/lbin/dldd32 +a 0x >&1 >/dev/null Cpyright IBM Crp. 2002,

172 IBM FileNet P Release Ntes Reslved Knwn Issues Ntes: It is nly necessary t add +a 0x t the invcatin fr dldd32 if maxdsiz has the value > 1GB. This was tested using MAXSSIZ = 128MB Reslved in Fix Pack P8CE The IndependentObject interface has 7 methds named fetchprperties, fetchprperty, r refresh. The behavir f sme f these methds will change after the 4.0 release. fetchprperties(prpertyfilter), refresh(), and refresh(prpertyfilter) will nt change and are the preferred frms f these methds t use. fetchprperties(string[]), fetchprperty(string, PrpertyFilter), fetchprperty(string, PrpertyFilter, Integer), and refresh(string[]) are all likely t underg semantic changes and shuld be avided. If yu call the fllwing IndependentObject fetchprperty methds and set their String parameter t a scalar prperty (that is, a prperty that des nt return an bject value), the server thrws a RETRIEVE_NOT_OBJECT exceptin: fetchprperty(string, PrpertyFilter) fetchprperty(string, PrpertyFilter, Integer) The reference help incrrectly dcuments the fllwing methds:.net API - Factry.Dmain.GetInstance(cnn, name) and Factry.Dmain.FetchInstance(cnn, name, filter) Java API - Factry.Dmain.getInstance(cnn, name) and Factry.Dmain.fetchInstance(cnn, name, filter) The secnd parameter, "name", fr these methds is incrrectly dcumented as "The symblic name f the class instance t retrieve." The crrect descriptin fr the "name" parameter is "The name f the dmain t retrieve. If null, the default dmain is retrieved." Befre upgrading Cntent Engine, yu must verify that all pending cntent transactins, indexing requests, and fixed-cntent migratin requests have cmpleted. Yu can d this by running the Cntent Resurce Manager utility, RMU.exe, as shwn in the fllwing prcedure: 1. On each machine where Cntent Engine 3.5.x is installed, d the fllwing: 2. Start File Stre Service if it is nt already running. 3. Stp Object Stre Service and Cntent Cache Service. 4. Start RMU.exe, lcated (by default) at C:\Prgram Files\FileNet\Cntent Engine, n a machine where Cntent Engine 3.5.x is installed. 5. In the Cntent Resurce Manager Utility windw, d the fllwing: a. Navigate t Statistics > Transactins and nte the values f Ttal prepared <phase Cpyright IBM Crp. 2002,

173 IBM FileNet P Release Ntes Reslved Knwn Issues 1>, Ttal cmmitted, and Ttal abrted. b. Navigate t Statistics > Can t D Queue and nte the value f Current items in the can t d queue. c. Add the values f Ttal cmmitted and the Ttal abrted. If the sum equals the value f Ttal prepared <phase 1>, and the value f Current items in the can t d queue is zer, then all cntent transactins have cmpleted. d. Navigate t Indexing Service > Index Cntrl. If the value f Current index queue files is zer, then all pending indexing requests have cmpleted. e. Navigate t Fixed Cntent > Migratin Queuing. If the value f Current number in queue is zer, then all fixed-cntent migratin requests have cmpleted. 6. If all activity checked in step 3 has cmpleted, then stp File Stre Service n each machine where Cntent Engine 3.5.x is installed and exit this prcedure; therwise, d the fllwing: a. Exit frm the Cntent Resurce Manager utility. b. Wait a few minutes, and then return t step 1. Reslved in Fix Pack P8CE The request frwarding feature f the Cntent Engine server is nt supprted in the FileNet P release. This feature is disabled by default; supprt will be added in a subsequent release. Custmers shuld nt attempt t enable this feature in the Cntent Engine release Sme Cntent Cache peratins can have pr perfrmance n Slaris and HPUX systems where the Cntent Cache is n an NFS munted vlume n a different server. This issue is mst bvius with Clear functinality, which can take up t 30 minutes fr the Clear prcess t cmplete, even when there are n cntent elements in the cache. The prblem will be fixed in the next fix pack The default fr pagesize parameter in Realm.findUsers and findgrups (.NET and Java) has been changed t In the Cntent Engine upgrade sectin f the IBM FileNet P8 Installatin and Upgrade Guide, (T create an XML status upgrade file), the fllwing parameter is incrrect: StyleSetAlias The crrect value is: StyleSetAlias FileNet_Filesystem_PushAPI FileNet_FileSystem_PushAPI (Nte capitalizatin f FileSystem) Client cnfiguratin fr JAAS Generally, a Java client prgram accessing the Cntent Engine shuld use the installed JAAS cnfiguratin file fr the relevant applicatin server (such as, jaas.cnf.websphere, jaas.cnf.weblgic, r jaas.cnf.jbss). A client can als chse t use jaas.cnf.wsi. In this case, the definitin f the FileNetP8 stanza in the cnfiguratin file uses the Web Services transprt, rather than the default EJB transprt. Each particular JAAS cnfiguratin file (jaas.cnf.<app server>) cntains the fllwing Cpyright IBM Crp. 2002,

174 IBM FileNet P Release Ntes Reslved Knwn Issues stanzas: FileNetP8 *********** This cnfiguratin shuld be used by all standalne (thick) Java clients. Fr cmpatibility, this stanza can als be used by servlet-based Java clients (such as, the FileNet Wrkplace applicatin), althugh the FileNetP8Server stanza is nw supplied fr this purpse. When using the jaas.cnf.wsi file, this stanza specifies the Web Services transprt, rather than the EJB transprt (specified in this stanza fr the jaas.cnf.<app server> files). FileNetP8WSI **************** This cnfiguratin can be used by Java clients (standalne r within a servlet) that need t use the Web Services transprt, rather than the default EJB transprt. Anther way t accmplish this is t use the jaas.cnf.wsi cnfiguratin file with the FileNetP8 cnfiguratin. FileNetP8Engine ******************* (Nt fr client use.) This cnfiguratin is used internally by the Cntent Engine server's Web Services transprt handling prcesses, and shuld nt be used by clients. FileNetP8Server ******************* This cnfiguratin shuld be used by servlets running n an applicatin server (fr example, FileNet Wrkplace). FileNetP8KerbersService ******************************** (Nt fr client use.) This cnfiguratin is used internally by the Web Services transprt handling prcesses, and shuld nt be used by clients. FileNet ******** (Nt fr client use.) This cnfiguratin shuld be used nly fr JBss installatins, and is used t define the LDAP and (pssibly) Kerbers lgin mdules. This shuld nt be used by clients. There are 11 ther stanzas (such as Credentials, ReceivedCredentials, HttpCredentials) that are required by the server while handling the Web Services transprt r using the Systinet admin cnsle. These stanzas can be remved safely frm a JAAS cnfiguratin file used by a client Fr subscriptins with the Publish Request event as a trigger, d nt use the Filter Expressin and Filter Prperty. Specifying the Filter Expressin r Filter Prperty n a Publish Request event subscriptin prevents the Publish Request event frm launching. Reslved in Service Pack P8CE Due t a memry issue, large dcuments cannt be cmmitted. Cpyright IBM Crp. 2002,

175 IBM FileNet P Release Ntes Reslved Knwn Issues Advanced search fails when the "This" prperty is selected and used t srt the search results. Reslved in Service Pack P8CE If yu want t run P8CE with WebSphere and yu are running P8CE r lwer then yu must either: Apply the Fix Pack P8CE r Apply PK Reslved in Service Pack P8CE The security identifier, which is the ID prperty assigned t a user r grup in Wrkplace and WrkplaceXT user preferences, can be truncated. This can cause users t pssibly lse their user preferences and Favrites in Wrkplace and WrkplaceXT. Reslved in Service Pack P8CE Yu cannt file r unfile a dcument if the dcument name r flder name cntains a single qute r apstrphe. Reslved in Interim Fix Pack P8PE There is a Kerbers authenticatin issue with the Inbx and Public Inbx web parts. When using Kerbers authenticatin, the Inbx web parts and Inbx cntents are displayed fr the user that makes the first request thrugh the web part. All subsequent requests shw the same Inbx cntents, regardless f the user that is authenticated. Reslved in Fix Pack efrms If yu install the FileNet P8 efrms fix pack P8eF n Wrkplace XT, yu must install P8eF r P8eF prir t installing P8eF Failure t d s causes Add Dcument actins t fail in Wrkplace XT. If yu experience prblems adding dcuments after installing the efrms fix pack, yu must remve the cmmns-fileuplad-1.0.jar file frm <wrkplace_xt_install_dir>/filenet/webclient/wrkplacext/web-inf/lib, and redeply the web applicatin. T redeply the web applicatin, perfrm the fllwing steps: 1. Undeply the applicatin. See the "Back up, undeply, and remve" prcedures in "Task 1: Upgrade IBM FileNet Wrkplace XT" in the IBM FileNet Wrkplace XT Install Cpyright IBM Crp. 2002,

176 IBM FileNet P Release Ntes Reslved Knwn Issues and Upgrade Guide fr mre infrmatin. Optinally, if yu custmized yur deplyed cnfiguratin files, als perfrm the "Cpy cnfiguratin" prcedures in that same sectin. 2. If Wrkplace XT is deplyed as a WAR r EAR file, yu must re-create the WAR file r WAR and EAR files. Refer t the prcedure "T recreate the WAR and EAR files" in "Task 7a-c: Deply IBM FileNet Wrkplace XT" in the IBM FileNet Wrkplace XT Install and Upgrade Guide. 3. Redeply the Wrkplace XT applicatin. Refer t "Task 7a-c: Deply IBM FileNet Wrkplace XT" in the IBM FileNet Wrkplace XT Install and Upgrade Guide fr mre infrmatin. Reslved in Fix Pack SPDL-FP : Upn re-installatin t the same lcatin, if a UFI_4.0.1 flder exists and it is nt reused, a new flder is created with an appended incremented value : If the Mve and Create P8 Link pst-prcessing ptin is cnfigured, links are nt created when dcuments exist in a SharePint flder, share the same name value but have different file extensins, such as sample.dc and sample.txt. The link is created and prcessed fr the first dcument, but the additinal links are nt created fr each duplicate-named dcument. All dcuments are archived successfully in the FileNet P8 bject stre, but nly ne link is created After a link is created and clicked in SharePint, the dcument cntent is streamed t the user's brwser; hwever, additinal text is als appended. The additinal text causes issues with pen text frmat-based file types, such as.txt,.html, and Office 2007 files. The file stred in the FileNet P8 bject stre is nt affected. The appended text nly ccurs if the SharePint applicatin (MOSS/WSS) is deplyed n a Windws 2008 (32/64 bit) perating system and 2.2: Site clumns are truncated when their value exceeds the character maximum prperty length defined by IBM FileNet P8. Data culd be lst because the affected SharePint dcuments cntinue t be archived regardless f the truncatin. In additin, the applicatin des nt ntify the user f the pssible data lss. Reslved in Fix Pack SPDL-FP : Upn re-installatin t the same lcatin, if a UFI_4.0.1 flder exists and it is nt reused, a new flder is created with an appended incremented value. Reslved in Fix Pack SPWP-FP In the Firefx brwser, selecting an actin frm a cntext menu in the Brwse r Search results is difficult because the cntext menu flickers. T wrk arund this issue, right-click Cpyright IBM Crp. 2002,

177 IBM FileNet P Release Ntes Reslved Knwn Issues n any area f a list item and select the apprpriate actin When yu cnfigure the Object Stre/Flder parameter fr a Search web part after recently cnfiguring the Rt Object Stre/Flder/Stred Search parameter fr a Brwse web part, the Stred Searches flder incrrectly appears in the Object Stre selectin tree. If yu select a stred search frm the Stred Searched flder, an errr ccurs when the stred search is executed. This issue nly ccurs if caching is enabled n bth the Brwse and Search web parts. T clear the cache, yu can either disable the cache with the Search web part r clse the current brwser sessin. Reslved in Fix Pack SPWP-FP Single sign-n will nt wrk fr IBM FileNet Cnnectr fr Web Parts with WrkplaceXT unless tkens are enabled fr Applicatin Engine. After lgging int SharePint, If a user launches a dcument frm a web part that is assciated with WrkplaceXT, the user will be prmpted t lg n t Wrkplace XT. T enable tkens see IBM FileNet P8 help tpic: FileNet P8 Administratin > Applicatin Engine security Wrkplace must be installed with cntainer-managed authenticatin in rder t integrate with IBM FileNet Cnnectr fr SharePint Web Parts. If yu want t integrate IBM FileNet Cnnectr fr SharePint Web Parts with an existing instance f Applicatin Engine/Wrkplace that uses cntainer-managed authenticatin, yu will need t d ne f the fllwing: Uninstall Applicatin Engine / Wrkplace and reinstall it t use applicatin-managed authenticatin. Install a separate applicatin-managed instance f Applicatin Engine / Wrkplace t integrate with IBM FileNet Cnnectr fr SharePint Web Parts When an existing IIS site is used t create a SharePint web applicatin, the IIS web site flder might be named differently and nt adhere t SharePint's default naming cnventin. SharePint's default naming cnventin is t set the flder name equal t the prt number. The flder name is used by the installer t determine the prt t which the web parts are deplyed. After the installer fails t deply the web parts,the wrkarund is t manually deply the web parts. This is nly an issue if the installer is set t deply t a single web applicatin If the installer is set t deply t all web applicatins, the web parts are deplyed successfully by the installer If yu attempt t launch an efrms wrkflw r cmplete an efrms wrk item frm an IBM FileNet web part, yu might get the errr "Frm Exceptin" with the detailed message "Permissin denied t get prperty Windw.pen." The ptins t wrk arund this issue depend n whether the web part is cnfigured t use a Wrkplace URL r a Wrkplace XT URL. With either cnfiguratin, yu can wrk arund this issue by using a web brwser ther than Firefx. With a Wrkplace URL, yu have an additinal ptin, belw. Wrkplace URL Yu can use this alternative methd t wrk arund the issue nly if it is acceptable t use Cpyright IBM Crp. 2002,

178 IBM FileNet P Release Ntes Reslved Knwn Issues all f the default prperties when saving frm data fr an efrms wrkflw. T use this methd, perfrm the fllwing steps: 1. Ensure that fix pack P8AE is installed. 2. Mdify the efrms Entry Template used by the efrm wrkflw plicy t hide the steps that specify prperties. With these steps hidden, the frm data is saved with all default prperties. Hide the fllwing steps: Select Flder Set Prperties Set Security Reslved in Fix Pack WPXT-FP An errr message ccurs when a user saves an anntatin n a dcument imprted by using CFS-IS, but the anntatin is successfully saved. In Wrkplace XT, using Image Viewer t save an anntatin n a dcument that has been imprted by using CFS-IS displays an errr message: Anntatins save failed (Mdify anntatin errr). An errr message is als written t the Java Cnsle. Yu can safely ignre this message. Upn repening the image, yu can see that the anntatin has been saved n the dcument An incrrect title is displayed in the brwser when pening Wrkplace XT readme files. When viewing the Readme files fr IBM FileNet Wrkplace XT, the brwser's title bar displays incrrect text. The title shuld be "IBM FileNet Wrkplace XT Readme The IBM FileNet Wrkplace XT Installatin Guide is missing infrmatin n the fllwing tpic. If yu are running Prcess Orchestratin r ther BPM features under an SSL cnfiguratin, yu must perfrm the fllwing additinal cnfiguratin: 1. Refer t the FileNet P8 help tpic Wrkplace > Basics > Use Java Applets, specifically t the "Dwnlad certificate" sectin, t install the applicatin server certificate under <install_path>\filenet\webclient\ruter\jre\lib\security 2. Open Prcess Task Manager, and under yur Wrkplace XT nde, pen Cmpnent Manager. 3. Select and stp the cnnectin pint nde. 4. Frm the Web Services tab, click the JSSE Settings tab. 5. Enter the passwrd in the Key Stre Passwrd and Trust stre Passwrd fields. 6. Apply the change and start the Cmpnent Manager nde. 7. Imprt the certificate int the Plug-in keystre: 8. Lcate the Plug-in trust keystre file. Fr example,...\jre\lib\security\cacerts (n extensin). 9. Run keytl.exe frm the JRE \bin directry by entering the fllwing at the cmmand line: <install_path>\filenet\webclient\ruter\jre\lib\security>..\..\bin\keytl -imprt -file "cypher.cer" -alias cyphercer -keystre cacerts -strepass Cpyright IBM Crp. 2002,

179 IBM FileNet P Release Ntes Reslved Knwn Issues changeit (Dcs DTS ) In the Install Guide tpic "Install IBM FileNet Wrkplace XT," the UNIX entry under step 1 f the prcedure "T install the IBM FileNet Wrkplace XT sftware" shuld read as fllws: UNIX - Lg n as a user with write access t the /bin directry and read, write, and execute access t the directry where yu plan t install Wrkplace XT. The user shuld als be a member f the bin grup In the prcedure "T install the IBM FileNet Wrkplace XT sftware", a panel descriptin is missing frm the setup wizard panel table. This panel, "Cnfigure User Tken Security," displays after the "Specify Dwnlad Lcatin" panel, and befre "User Selectins." is as fllws: Cnfigure User Tken Security 2. If needed, select the check bx t create maximum strength keys. By default this ptin is nt selected and Setup creates limited strength (128-bit) keys. If yu select this ptin, the installer creates 448-bit keys. 3. Enter the number f keys t use. Larger numbers f keys prvide mre security. 4. Make a nte f the user tken crypt key path. 5. The UTCryptKeyFile.prperties file cntains the user tken cryptgraphy key used by FileNet P8 applicatins t launch int each ther withut the need fr additinal lgin. The default User Tken Crypt Key file path is: 6. Click Next. UNIX - <install_path>/filenet/authenticatin/ Windws - <install_path>\filenet\authenticatin\ Nte Fr multiple applicatins t pass user tkens t each ther, each participating applicatin must use the same encryptin key file. Cpy the UTCryptKeyFile.prperties file installed with Wrkplace XT t all servers that are hsting a tken-sharing applicatin In the tpic "Cnfigure IBM FileNet Wrkplace XT (WebLgic)," step 5 in the prcedure "T cnfigure WebLgic 9.x t supprt User Tkens fr Wrkplace XT (including Applicatin Integratin) (ptinal)" cntains an errr in the navigatin instructin. The crrect navigatin instructin is "Navigate t Hme > Security Realms > myrealm > Prviders > Authenticatin." In the tpic "Deply IBM FileNet Wrkplace XT (WebLgic)", nte the fllwing variances under the prcedure "T deply IBM FileNet Wrkplace XT (WebLgic 9.2)": After step 4, a new step shuld be added: "Click Install." In the existing step 5, the EAR file has been left ut f the deply instructins. The secnd bullet shuld read as fllws: T deply frm a WAR r EAR file, brwse t and select the radi buttn fr the web_client.war r web_client.ear file in UNIX - <install_path>/filenet/webclient /deply Windws - <install_path>\filenet\webclient \deply Cpyright IBM Crp. 2002,

180 IBM FileNet P Release Ntes Reslved Knwn Issues In the existing step 7, the secnd sentence shuld read as fllws: Use Wrkplace XT r the custm name yu have chsen instead f "web_client". Step 9 shuld read as fllws: Click Activate Changes Adding a dcument using drag and drp fails with SSL When Wrkplace XT is installed n a JBOSS applicatin server and is using the Sun JVM, the server reprts ut-f-memry errrs. T avid the errrs, increase the default allcatin fr the MaxpermSize prperty t 128m, by adding "-XX:MaxpermSize=128m" t the JAVA_OPTS. Reslved in Fix Pack WPXT-FP When adding an t an bject stre, and then sending it using Applicatin Integratin, the is added, but it is nt sent and the fllwing errr message appears: "The send peratin failed because the item was deleted befre it was sent." This ccurs when the Btstrap site preference Outlk - Prmpt t add n Send is set t Yes and the Delete Lcal Cpy ptin is set t Yes in an Outlk prfile Wrkplace XT is unusable if the bject stre display name is changed after Wrkplace XT is deplyed. Fllwing deplyment f Wrkplace XT, if an bject stre display name is changed (fr example, by using Enterprise Manager n Cntent Engine), users are n lnger able t lg in t Wrkplace XT. Attempts t lg in result in a blank screen with an errr indicatr in the brwser status bar An errr ccurs when pening a flder frm the list view, and then clicking the Actins buttn. This ccurs in Internet Explrer, but nt in Firefx. Wrk arund this issue by selecting the flder again in the tree view r selecting it in the list view If yu check a dcument in r ut frm a search results list, the results list is nt updated with the changed values fr the dcument (fr example, checkin date). T view the updated values, yu must perfrm the search again When setting the prperties while adding a dcument, selecting a prperty frm a ppup windw (any windw that appears when yu click "Select Value") will und any changes yu have made t the dcument title. Fr example, if yu change the title frm "My Dcument.dc" t "My Dcument" and then click any "Select Value" link t select a prperty value, the title will revert t "My Dcument.dc." T change the dcument title, make sure yu select all ther prperty values first If the Internet Explrer 6 brwser windw is less than 800x600 pixels in size, the Wrkplace XT Advanced Search page might fail t lad. The user might instead see an errr icn at the bttm f the windw. Wrkarunds: Increase the Internet Explrer 6 brwser windw size t at least 800 pixels wide x 600 pixels high, refresh the brwser windw, and then repen Advanced Search. Cpyright IBM Crp. 2002,

181 IBM FileNet P Release Ntes Reslved Knwn Issues Use Internet Explrer 7 r Firefx 2.0. Reslved in Fix Pack WPXT-FP During an upgrade frm Wrkplace XT x t , with EAR file deplyment specified, the upgrade installer des nt recreate the EAR file. User actin: If yu are cntinuing the install prcess by applying the Cntent Engine r Prcess Engine Client files befre yu deply, n further actin is required. The Client installers will recreate the EAR file. If yu are planning t deply Wrkplace XT after the upgrade withut applying the Cntent Engine r Prcess Engine Client file updates, yu must manually recreate the EAR file befre yu deply. Fllw the prcedure "T recreate the WAR r EAR file (ptinal)" at the beginning f the "Deply IBM FileNet Wrkplace XT (Applicatin_Server_Type)" befre yu perfrm the deplyment steps ISV When yu cmplete r cancel a Wrkplace XT installatin n an HP-UX server, the message "Syntax errr" might be displayed n the cnsle. This message is caused by the InstallShield prgram, and des nt indicate any actual prblems with the installatin. Reslved in Fix Pack WPXT-FP Multiple wrkflw plicies cannt be viewed when they are pened cnsecutively. Fr example, when ne wrkflw plicy is pen, and then a secnd wrkflw plicy is pened, the secnd plicy replaces the first plicy In Wrkplace XT, the Wrkplace Authr Page site preferences have been replaced by the Tls Integratin site preferences. Clicking the Help link frm the Tls Integratin site preference page, hwever, still pens the "Authr Page preferences" help tpic, which includes instructins fr Wrkplace XT. Except fr references t the "authr page", the Wrkplace XT instructins are crrect. On the related "Authr Page Item Settings" tpic, the fllwing items are nt supprted in Wrkplace XT: Item icn Authr view Requires tken Shw link n banner Stred searches and search templates cnfigured t lk fr flders frm multiple bject stres using an aliased prperty des nt return all results On every system that has Recrds Management installed, an errr may ccur in the Prcess Designer. The wrng Cntent Engine name is being picked up frm the rmapi.jar file. Wrk arund this issue by ding the fllwing: Cpyright IBM Crp. 2002,

182 IBM FileNet P Release Ntes Reslved Knwn Issues 1. Create a flder named "classes" in the deplyed lcatin under WEB-INF. Fr WebLgic, if it is deplyed as a directry, the flder will g in this lcatin: <XT installed lcatin>/webclient/wrkplacext/web-inf/classes. Fr WebSphere Applicatin Server, the flder will g under WEB-INF in the deplyed lcatin. 2. Put a cpy f the WcmApiCnfig.prperties file in the "classes" flder When upgrading the Wrkplace XT server, Applicatin Integratin n all Wrkplace XT client installatins must be upgraded t the same versin t ensure actins available within an integrated Office applicatin wrk crrectly In the Search Designer, when creating a search that includes mre than ne bject stre, the Object Subclass listing n the Object Types tab will nt display icns. If nly ne bject stre is being searched, the class icns are displayed When using File Tracker features n an SSL system, a warning message appears, the system lgs ut, and the actins are nt cmpleted. Reslved in Fix Pack WPXT-FP ISV When a file is saved t a mapped netwrk drive, the file may nt shw as tracked when it is checked back in depending n the user's permissins t the share. Reslved in Fix Pack WPXT-FP When mdifying r adding anntatins t an image dcument, the Und buttn (tp left arrw n tlbar) is nt activated. Cnsequently, unwanted changes cannt be undne. Reslved in Fix Pack WPXT-FP The fllwing issues ccur when file tracking is enabled and JRE 1.6.0_14 is used: Brwsing fr files after perfrming a Dwnlad r Check ut and dwnlad results in a Java script errr if the specified qualified path in the site preference is invalid. Wrkarund: Cnfirm the qualified path site preference setting is a valid path and the user has the valid path set up n their lcal system. Brwsing fr files t add after ding an Add actin results in freezing the selected file. Wrkarund: Refcus the Select File dialg bx by clicking the Start menu. Cpyright IBM Crp. 2002,

183 Ntices This infrmatin was develped fr prducts and services ffered in the U.S.A. IBM FileNet P Release Ntes Ntices IBM may nt ffer the prducts, services, r features discussed in this dcument in ther cuntries. Cnsult yur lcal IBM representative fr infrmatin n the prducts and services currently available in yur area. Any reference t an IBM prduct, prgram, r service is nt intended t state r imply that nly that IBM prduct, prgram, r service may be used. Any functinally equivalent prduct, prgram, r service that des nt infringe any IBM intellectual prperty right may be used instead. Hwever, it is the user's respnsibility t evaluate and verify the peratin f any nn-ibm prduct, prgram, r service. IBM may have patents r pending patent applicatins cvering subject matter described in this dcument. The furnishing f this dcument des nt grant yu any license t these patents. Yu can send license inquiries, in writing, t: IBM Directr f Licensing IBM Crpratin Nrth Castle Drive Armnk, NY U.S.A. Fr license inquiries regarding duble-byte (DBCS) infrmatin, cntact the IBM Intellectual Prperty Department in yur cuntry r send inquiries, in writing, t: Intellectual Prperty Licensing Legal and Intellectual Prperty Law IBM Japan, Ltd , Rppngi, Minat-ku, Tky Japan The fllwing paragraph des nt apply t the United Kingdm r any ther cuntry where such prvisins are incnsistent with lcal 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. Sme states d nt allw disclaimer f express r implied warranties in certain transactins, therefre, this statement may nt apply t yu. This infrmatin culd include technical inaccuracies r typgraphical errrs. Changes are peridically made t the infrmatin herein; these changes will be incrprated in new editins f the publicatin. IBM may make imprvements and/r changes in the prduct(s) and/r the prgram(s) described in this publicatin at any time withut ntice. Any references in this infrmatin t nn-ibm Web sites are prvided fr cnvenience nly and d nt in any manner serve as an endrsement f thse Web sites. The materials at thse Web sites are nt part f the materials fr this IBM prduct and use f thse Web sites is at yur wn risk. IBM may use r distribute any f the infrmatin yu supply in any way it believes apprpriate withut incurring any bligatin t yu. Licensees f this prgram wh wish t have infrmatin abut it fr the purpse f enabling: (i) the exchange f infrmatin between independently created prgrams and ther prgrams (including this ne) and (ii) the mutual use f the infrmatin which has been exchanged, shuld cntact: IBM Crpratin J46A/G4 555 Bailey Avenue San Jse, CA U.S.A. Such infrmatin may be available, subject t apprpriate terms and cnditins, including in sme cases, payment f a fee. Cpyright IBM Crp. 2002,

184 IBM FileNet P Release Ntes Ntices The licensed prgram described in this dcument and all licensed material available fr it are prvided by IBM under terms f the IBM Custmer Agreement, IBM Internatinal Prgram License Agreement r any equivalent agreement between us. Any perfrmance data cntained herein was determined in a cntrlled envirnment. Therefre, the results btained in ther perating envirnments may vary significantly. Sme measurements may have been made n develpment-level systems and there is n guarantee that these measurements will be the same n generally available systems. Furthermre, sme measurements may have been estimated thrugh extraplatin. Actual results may vary. Users f this dcument shuld verify the applicable data fr their specific envirnment. Infrmatin cncerning nn-ibm prducts was btained frm the suppliers f thse prducts, their published annuncements r ther publicly available surces. IBM has nt tested thse prducts and cannt cnfirm the accuracy f perfrmance, cmpatibility r any ther claims related t nn-ibm prducts. Questins n the capabilities f nn-ibm prducts shuld be addressed t the suppliers f thse prducts. All statements regarding IBM's future directin r intent are subject t change r withdrawal withut ntice, and represent gals and bjectives nly. This infrmatin cntains examples f data and reprts used in daily business peratins. T illustrate them as cmpletely as pssible, the examples include the names f individuals, cmpanies, brands, and prducts. All f these names are fictitius and any similarity t the names and addresses used by an actual business enterprise is entirely cincidental. COPYRIGHT LICENSE: This infrmatin cntains sample applicatin prgrams in surce language, which illustrate prgramming techniques n varius perating platfrms. Yu may cpy, mdify, and distribute these sample prgrams in any frm withut payment t IBM, fr the purpses f develping, using, marketing r distributing applicatin prgrams cnfrming t the applicatin prgramming interface fr the perating platfrm fr which the sample prgrams are written. These examples have nt been thrughly tested under all cnditins. IBM, therefre, cannt guarantee r imply reliability, serviceability, r functin f these prgrams. The sample prgrams are prvided "AS IS", withut warranty f any kind. IBM shall nt be liable fr any damages arising ut f yur use f the sample prgrams. Trademarks IBM, the IBM lg, and ibm.cm are trademarks r registered trademarks f Internatinal Business Machines Crpratin in the United States, ther cuntries, r bth. If these and ther IBM trademarked terms are marked n their first ccurrence in this infrmatin with a trademark symbl ( r ), these symbls indicate U.S. registered r cmmn law trademarks wned by IBM at the time this infrmatin was published. Such trademarks may als be registered r cmmn law trademarks in ther cuntries. A current list f IBM trademarks is available n the Web at "Cpyright and trademark infrmatin" at Adbe is a registered trademark f Adbe Systems Incrprated in the United States, and/r ther cuntries. Java and all Java-based trademarks are trademarks f Sun Micrsystems, Inc. in the United States, ther cuntries, r bth. Micrsft, Windws, Windws NT, and the Windws lg are trademarks f Micrsft Crpratin in the United States, ther cuntries, r bth. Linux is a registered trademark f Linus Trvalds in the United States, ther cuntries, r bth. UNIX is a registered trademark f The Open Grup in the United States and ther cuntries. Other cmpany, prduct, and service names may be trademarks r service marks f thers. Cpyright IBM Crp. 2002,

185 U.S. Patents Disclsure IBM FileNet P Release Ntes Ntices This prduct incrprates technlgy cvered by ne r mre f the fllwing patents: U.S. Patent Numbers: 6,094,505; 5,768,416; 5,625,465; 5,369,508; 5,258,855. Cpyright IBM Crp. 2002,

186 IBM FileNet P Release Ntes Ntices Cpyright IBM Crp. 2002,

187

188 Prgram Number: 5724-R74, 5724-R76, 5724-R77, 5724-R81, 5724-R85, 5724-R93, 5724-R95, 5724-S00, 5724-S13, 5724-S17, 5724-S19 Printed in USA GC