IBM Support

Getting "e800042c" error when starting IBM P8 Process Engine with NetBIOS disabled.

Troubleshooting


Problem

The IBM P8 Process Engine 4.5.0 server has a dependency on NetBIOS, which is documented in the IBM P8 documentation (see link "Plan & Prepare Your Environment for IBM FileNet P8 4.5" in related information). In some high availability scenarios, IBM P8 Process Engine will encounter a performance issue with NetBIOS enabled (see link "Process Engine performance issue with NetBIOS enabled" in related information).

Symptom

Steps to reproduce the behavior on a Microsoft Windows-based IBM P8 Process Engine 4.5.0 server:

  1. Disable NetBIOS over TCP/IP (see "Process Engine performance issue with NetBIOS enabled" link below or consult Microsoft product documentation for more information).
  2. If started, stop the IBM P8 Process Engine server software using the Process Task Manager application.
  3. Start the IBM P8 Process Engine server software using the Process Task Manager application.
  4. An error will occur preventing processing of IBM P8 Process Engine software.


    Full error text:

    Standard output: Termination of FileNet software completed.
    Terminating processes...
    Initializing FileNet software...
    Exec of 'fn_build -a -q /fnsw/local/logs/fn_build/fn_build.log' returned non-zero status of '0xe800042c'.
    Software will now be shutdown due to previous error.
    Starting index database...
    Shutting down security database...
    Terminating processes...
    Shutting down index database...
    Termination of FileNet software completed.
    Exit value: 0

In addition to the signature seen in IBM P8 Process Engine's Task Manager application, a corresponding pattern of errors is also logged to the Microsoft Windows Event log:
  1. 232,0,1068 fn_build -a -q /fnsw/local/logs/fn_build/fn_build.log [PID=3664 TID=7380] ...
    SLMl: Did not find any valid machine IDs!
  2. 232,0,1068 fn_build -a -q /fnsw/local/logs/fn_build/fn_build.log [PID=3664 TID=7380] ...
    CDB_inter_verify - could not read license data from NCH
  3. 232,0,1068 fn_build -a -q /fnsw/local/logs/fn_build/fn_build.log [PID=3664 TID=7380] ...
    fn_build: Error while trying to verify license, see the logs/fn_build/verify.txt file.
  4. 211,1,13 TM_daemon_ctl -f 508 -p 0x868 -c 0x1 [PID=2480 TID=5744] ...
    Exec of 'fn_build -a -q /fnsw/local/logs/fn_build/fn_build.log' returned non-zero status of '0xe800042c'.
  5. 211,1,11 TM_daemon_ctl -f 508 -p 0x868 -c 0x1 [PID=2480 TID=5744] ...
    A failure occurred while waiting for a process to complete.

Cause

IBM P8 Process Engine 4.5.0 / IBM FileNet Image Services 4.1.2 has a check for machine id within the SLMl layer which fails when NetBIOS is disabled.

Resolving The Problem

To resolve the problem, upgrade to IBM P8 Process Engine 4.5.1 or install IBM FileNet Image Services 4.1.2 patch 3 or higher on your IBM P8 Process Engine 4.5.0 server. Either route will apply IBM FileNet Image Services SCR 341474 to the server, which prevents the machine id lookup that fails when NetBIOS is disabled.

During an IBM test, applying IBM FileNet Image Services 4.1.2 patch 3 to IBM P8 Process Engine 4.5.1, introduced the following error signature:

    212,0,7 <fnsw> fn_build -a -q /fnsw/local/logs/fn_build/fn_build.log (2304.976.3 0x900.3d0) ... [CRITICAL]
    fn_build/mssql_glob-3: cannot get value for mssql_home from RDB_MSSQL table, query=database_ID=3. Aborting!
The resolution was found in technote1399615 (see "Technote on fn_build/mssql error" in related information below). In short, the resolution to that issue is:
    Create an empty file called "fnsw_update" in the "\fnsw_loc\tmp" directory and restart the software.

[{"Product":{"code":"SSNW2F","label":"FileNet P8 Platform"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Process Engine","Platform":[{"code":"PF033","label":"Windows"}],"Version":"4.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21450352

Page Feedback