IBM Support

JR51916: AFTER YOU MIGRATE TO IBM BPM V8.5.5, THE DOCUMENT STORE APPLICATION REPORTS AN ERROR AND EVENT MANAGER DOES NOT START

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When the IBM Business Process Manager (BPM) document store
    application starts for the first time after you migrate to IBM
    BPM V8.5.5, a number of configuration steps run to enable new
    document store functions. One of these steps corrects the
    permissions on document store objects. If a document store
    authorization is unresolved, this step fails with the following
    exception:
    
    EmbeddedECMIn E   CWTDS1100E: An error occurred while validating
    or creating the default configuration for the IBM BPM document
    store.
    
    com.ibm.bpm.embeddedecm.exception.UnexpectedFailureException:
    CWTDS0000E: An unexpected failure occurred.
    Details: 'FNRCE0051: E_OBJECT_NOT_FOUND: The requested item was
    not found.
    Principal
    S-1-98-828663094-926245218-909390893-909389109-959263843-7583960
    02-1647587384-1701209398-1681220404-67108864 not found.'
    
    As a result, the permissions of document store objects are
    inconsistent. When the configuration restarts because the
    document store application starts again upon server start, the
    failed step does not repeat and you encounter another error:
    
    EmbeddedECMIn E   CWTDS1100E: An error occurred while validating
    or creating the default configuration for the IBM BPM document
    store.
    
    com.ibm.bpm.embeddedecm.exception.ObjectDefinitionCannotBeMigrat
    edException: CWTDS0002E: The object definition
    'CustomObject.ObjectDefinitionState' cannot be migrated.
    Details: 'The requester has insufficient access rights to
    perform the requested operation.'
    Explanation: During the migration of a predefined object
    definition for the IBM BPM document store, an unexpected
    exception occurred.
    Action: Check the server log files.
    
    In addition, you observe that the Event Manager has not started
    and IBM Process Center cannot connect to IBM Process Server.
    

Local fix

Problem summary

  • With this fix, the step that corrects the document store
    permissions can be enforced to run when the document store
    application starts.
    

Problem conclusion

  • A fix is/will be available for IBM BPM V8.5.5.0 that ensures the
    step runs that corrects the document store permissions during
    migration. In addition, IBM BPM checks whether the a permission
    is still valid and prevent the first exception from recurring.
    
    On Fix Central (http://www.ibm.com/support/fixcentral), search
    for JR51916:
    
    1. Select IBM Business Process Manager with your edition from
      the product selector, the installed version to the fix pack
      level, and your platform, and then click Continue.
    
    2. Select APAR or SPR, enter JR51916 , and click Continue.
    
    When you download fix packages, ensure that you also download
    the readme file for each fix. Review each readme file for
    additional installation instructions and information about the
    fix.
    
    After you install the fix, you must set a JVM property by
    completing the following steps:
    
    1. Log in to the administrative console and choose All Servers.
    2. For each application target server, complete the following
      steps:
     a. Click Process definition > Java Virtual Machine > Custom
       properties.
     b. Click New.
     c. Name the JVM property as
       "DocumentStoreConfigurationForceFixPermissions" and the value
       to "true".
     d. Click OK and then Save.
    3. Restart the application server.
    
    When the IBM BPM document store application has started without
    errors, remove the custom property, otherwise the document store
    permissions update each time the server starts.
    

Temporary fix

  • Not applicable
    

Comments

APAR Information

  • APAR number

    JR51916

  • Reported component name

    BPM ADVANCED

  • Reported component ID

    5725C9400

  • Reported release

    855

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-12-01

  • Closed date

    2015-02-02

  • Last modified date

    2015-02-02

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    BPM STANDARD

  • Fixed component ID

    5725C9500

Applicable component levels

  • R855 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFTDH","label":"IBM Business Process Manager Standard"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"855","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
02 February 2015