IBM FileNet eProcess 5.2.0 Fix Pack Readme: eProcess-5.2.0-001
© Copyright IBM Corporation 2010. All Rights Reserved.

About this fix pack
Accessing IBM FileNet documentation, compatibility matrices, and fix packs
Known Issues
New in this fix pack
Installation, migration, upgrade, and configuration
Requirements
Install this fix pack
Uninstall this fix pack
Product fix history
Contact customer support
Notices
Trademarks

About this fix pack

This document describes the fixes and new functionality available for eProcess 5.2.0 (that is, IBM FileNet Image Manager Process Engine 3.5.4 and IBM FileNet Process Java Application, Connector and Toolkit (PJAC) 3.5.4). This document also provides information on installing this fix pack.

There are five fix pack packages; four platform-specific packages for the Process Engine, one for the web server. In order to maintain synchronization between the Process Engine and the web server, you must install one package on the Process Engine and one package on the web server (see below).

fix package Name Install on...
eProcess-5.2.0-001-AIX.tar.gz Process Engine/AIX
eProcess-5.2.0-001-HPUX.tar.gz Process Engine/HP-UX
eProcess-5.2.0-001-SOL.tar.gz Process Engine/Solaris
eProcess-5.2.0-001-Win.zip Process Engine/Windows
fix package Name
Install on...

eProcess-5.2.0-001-PJAC.zip

Web server running FileNet Web Services or Open Client

After installing this fix pack, see the eProcess 5.2.0 Release Notes on the Information Management support page (www.ibm.com/software/data/support) for information about new and remaining problems in the product.

Accessing IBM FileNet documentation, compatibility matrices, and fix packs

Documentation

To access documentation for IBM FileNet P8 Platform and related products:

  1. Navigate to the Information Management support page (www.ibm.com/software/data/support).
  2. From the "Select a category" list, select FileNet Business Process Manager.
  3. From the Product Support page, click Documentation.
  4. From the Additional Documentation support links box, click the Doc Link for eProcess.
  5. From the Product Documentation page for FileNet eProcess Services:
    1. If necessary, click a product Doc Link to display the list of component product documentation.
    2. Click the icon in the appropriate release column to access the document you need.

Compatibility

Compatibility information is available in the IBM FileNet Panagon Hardware and Software Requirements guide which is located here:

ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/wsopendoc/40x/idm_cs_eforms_eprocess_hw_sw_guide.pdf

Fix packs

To access fix packs for IBM FileNet eProcess and related products:

  1. Navigate to the Information Management support page (www.ibm.com/software/data/support).
  2. From the "Select a category" list, select FileNet Product Family.
  3. From the "Select a product" list, select FileNet eProcess.
  4. Click Download under “FileNet Business Process Manager support”.
  5. For fix packs, select 'Updates' and click Search.
  6. From the search results page, click IBM FileNet Fix Packs.
  7. From the IBM FileNet fix packs page, click a product name.

Known Issues

New in this fix pack

For more information about the resolved defects in this fix pack, see "Product fix history".

For more information about new features and known issues, see the IBM FileNet eProcess 5.2.0 Release Notes.

Installation, migration, upgrade, and configuration

Requirements

Install this fix pack

For Process Engine modules

Notes

  1. Download the appropriate file from the IBM FileNet FTP site. Refer to the list of available packages at the beginning of this document.
  2. Verify that there is a current system backup.
  3. Extract the contents of the ZIP file to a temporary location.
  4. On Windows:

    1. Stop all Process routers connected to the Process Engine.
    2. From the Process Task Manager console, stop:

      • PPM
      • Process Service
    3. Stop IMS Control Services service.
    4. Stop Process Engine Services Manager service.
    5. Execute the command "killfnsw -D -y -S".
    6. Execute IMPE-3.5.4-001-Win.exe.

    On UNIX

    1. Stop all Process routers connected to the Process Engine.
    2. From the Process Task Manager console, stop:
    3. Execute the command: "killfnsw -DAyS".
    4. For AIX, as root, execute slibclean.
    5. As root, execute one of the following:

  5. Restart the Process Service, PPM and the Windows services previously stopped on the Process Engine.

    1. (Windows only) Use the Windows Services tool to restart the "IMS ControlService" and "Process Engine Services Manager" services.
    2. To start the Process Task Manager console:
      • Windows Select Process Task Manager from the FileNet P8 Platform/Process Engine group in the Start menu.
      • UNIX As fnsw user, start vwtaskman.
    3. Select the Process Service node and click Start.
    4. Select the PPM node and click Start.
  6. Systems using an Oracle database need to trigger a long raw to blob database conversion by going into vwtool and doing a "count*".
  7. (Windows only) Complete the "Post-Install PE Configuration" section below.
  8. Install this fix pack on all web servers that access this Process Engine. See For web server... below.

Post-Install PE Configuration

Performing the following procedure allows Process Engine to use the largest available contiguous free memory area for shared memory allocations. Failing to perform this procedure results in shared memory not being allocated during normal execution, and the system will not function as expected.

Complete these vwtool steps to obtain the address for the largest free memory block and use that address to create a new registry key. You will then verify that address by running ipc_tool.

To configure contiguous free memory for Process Engine (Windows only)

  1. From a command prompt, start vwtool.
  2. Use the processmap command to find the largest contiguous free memory area, as in:
    <vwtool:1>processmap
    vwtool returns the following:
    Process Id (CR=this vwtool process):
    Press Return (CR) to get the process map for this process, as in the following example, where the process ID is 4764. Note however, that it is recommended to use any of the VWJs process as opposed to the vwtool process, since the VWJs processes load the most DLLs and provides a more complete picture of the modules loaded in memory:

    C:\FNSW\BIN\vwtool.exe (ID:4764)
    Address Attrib Size Owner
    ======= ====== ==== =====
    00000000 Free 65536
    00010000 Private 4096
    00011000 Free 61440
    00020000 Private 4096
    …….(pages of memory addresses omitted here)
    7EFDF000 Private 4096
    7EFE0000 Mapped 1048576
    7F0E0000 Private 15728640
    7FFE0000 Private 65536
    C:\FNSW\BIN\vwtool.exe (ID:4764)

    (Biggest Free area found : 505044992 bytes at offset 0x1225A000, there are
    potentially 493184 Kb available for shared memory allocation by the PE server)

    Rounded up to nearest 64K boundary, for use as registry entry StartShmAddress,
    best free block address is 0x12260000

    In this example, 0x12260000 is the desired address. In some cases you may only see the line referencing the largest free block because the value is already at a 64K boundary.

  3. Run the Windows regedit command to create a key for IS ShmStartAddress, using the address found in step 2. Run regedit on the PE server and go to:
    HKEY_Local_Machine\Software\FileNet\IMS\CurrentVersion\
    (64-bit Windows) HKEY_Local_Machine\Software\Wow6432Node\FileNet\IMS\CurrentVersion\

  4. Create a new key of type DWORD. Name the key: StartShmAddress
  5. Enter or verify the following in the Edit DWORD Value Screen: Value name = StartShmAddress Value data =
    From the example above the value will be 12260000. Base is hexadecimal.
  6. Click OK.
  7. Exit regedit.
  8. Verify the setting by executing the following at a command prompt:
    ipc_tool -A
    The following is an example of the information that is returned.

    Shared memory usage for Image Services:

    ipc_tool VERSION 4.1.2.4

    Segment size: 16777216 bytes (16 MB)

    Max shared memory configured for Image Services: 129 segments (2064 MB)

    Max shared memory allowed by the system: 88 segments (1408 MB)

    Address Manager segment:

    Address Shm id Creator
    0 0x12260000 Global\FNSHM_464d0000 Shared addrmgr

    Shared memory data segments:

    Address Shm id Creator Used Free
    1 0x13260000 Global\FNSHM_464a0000 FileNet server 16706516 37880
    2 0x14260000 Global\FNSHM_464a0001 FileNet server 16715428 49452
    3 0x15260000 Global\FNSHM_464a0002 FileNet server 16609828 156228
    4 0x16260000 Global\FNSHM_464a0003 FileNet server 8080952 8691080

    Total Image Services shared memory allocated: 64 MB

For web server (FileNet Web Services or Open Client) modules

  1. Download the appropriate file from the IBM FileNet FTP site. Refer to the list of available ZIP files at the beginning of this document.
  2. Extract the contents of the ZIP file to a temporary location on the install machine.
  3. Close all web sessions accessing the web server.
  4. Stop all Process Routers.
  5. Run PJAC-3.5.4-001.exe from the local drive.
  6. On the Web Server, navigate to the following folder: <drive>\FileNet\IDM directory
  7. Right-click on the folder and select Properties from the menu.
  8. Click on the Security tab.
  9. Click the Advanced button, and select the group "Users (machine name\Users)".
  10. Select the check box "Allow inheritable permissions from the parent to propagate to this object and all child objects. Include these with entries explicitly defined here", and then click Apply.
  11. Ensure the machine name\Users entry in the security list has "Read and Execute", "Read", "List folder contents" "Special permissions" rights.
  12. Repeat Step 6 through 11 for the DocImages folder (...\FileNet\IDM\Web\DocImages).
  13. Restart IIS.

Uninstall this fix pack

To remove this fix pack, restore the backup files.

Product fix history

The table below lists the fixes and features in this fix pack. The following abbreviations are used:

eProcess-5.2.0-001


APAR Name Defect ID Type Area Description
PJ33761
759672
Fix
PWM
Opening a tracker item from within Personal Work Manager intermittently produces a blank window.
PJ34261
785093
Fix
IMPE
Unauthorized users can access and process work objects in a Work Performer queue.
PJ34620
782922
Fix
IMPE
A 'segmentation violation' error occurs when committing a large number of documents while performing queries using subVar filters.
PJ34751
772528
Fix
PAdmin
You cannot delete a workflow through the eProcess Process Administrator.
PJ35252
786275
Fix
PAdmin
When searching for work items in the Inbox queue, search results in Process Administrator do not display all of the available users.
PJ35628
791550
Fix
IMPE
The sun_fixup_tool does not fix libraries correctly, resulting in segmentation violations on the Workflow/Image Services server during transfers.
PJ36095
796036
Fix
IMPE
Process Engine processes crash with a '0xC0000003' exception during startup/shutdown.
PJ36245
776143
Fix
IMPE
In UNIX environments, the installer fails to detect IS version 4.1.1.
PJ36490
831779
Fix
IMPE
Poor performance occurs when opening Personal Work Manager, due to long getQueueDefinition and fetchUserList calls.
PJ36627
837949
Fix
IMPE
A query formed by the vwaemsg process performs poorly due to full table scans on the event log table.
PJ36660
786817
Fix
IMPE
VWJs processes generate unnecessary Java.foo.vgc files.
PJ36662
743897
Fix
IMPE
When using an inherited workflow which has the same milestones as the parent workflow, a validation error occurs.
PJ36663
746823
Fix
Designer
eProcess Designer is missing hot key displays in the U.S. version.
PJ36665
839291
Fix
Designer
In the Workflow Inheritance and DBExecute step, inherited data fields do not display in the field name dropdown menu.
PJ36669
839289
Fix
Designer
The Field Name list gets alphabetically unsorted in the Field usage window of Process Designer.
PJ36674
800328
Fix
IMPE
Using the Process Configuration Console to import the exported XML file returns exception: "Failed to parse Field hashtable XML".
PJ36685
840087
Fix
IMPE
F_StepName field is not updated in the Roster when a work item transitions between two or more Participant steps in a workflow.
PJ36764
743240
Fix
PAdmin
An error message: "Column Index Out of Range" is displayed after a work item is completed and the exact query is rerun in Process Administrator.
PJ37010
847810
Fix
IMPE
The TerminateProcess step does not delete all child work objects.

Contact customer support

For information about contacting customer support:

  1. Navigate to the Information Management support page (www.ibm.com/software/data/support).
  2. On the Information Management Support page, search for: How to get support for IBM FileNet products.

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Corporation
J74/G4
555 Bailey Avenue
San Jose, CA 95141
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA  95141-1003
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Trademarks