44.8 Troubleshooting Workflow Related Issues

44.8.1 Resolving StackOverflow Error on Recursive Workflows

Issue: In a recursive workflow, when the event does not flow to the next approval, the following StackOverflow error is seen in the catalina.out log file:

Servlet.service() for servlet [spring] in context with path [/IDMProv] threw exception [Handler dispatch failed; nested exception is java.lang.StackOverflowError] with root cause java.lang.StackOverflowError

This issue may be observed in a specific environment in which Identity Manager is deployed. For more information, see Increasing the Stack Size for Recursive Workflows.

Workaround: To resolve this issue, set the value for the maxThreads attribute to 400 in the server.xml file located at:

Linux: /opt/netiq/idm/apps/tomcat/conf

Windows: C:\NetIQ\idm\apps\tomcat\conf

44.8.2 Workflow Legacy Forms Displaying Errors After Upgrading to Identity Manager 4.8.5 Version

Issue: After upgrading to Identity Manager 4.8.5, workflow forms on the Identity Manager user interface is displaying errors. This issue is only observed in the legacy forms. For example, when one of the fields in the request form uses the outdated .size() function, the following error message is displayed:

Field 1: An error 'TypeError: $(...).size is not a function' was encountered while executing the script '$('#_Field0').val("Size: " + $( "li" ).size() ):'

This issue applies to Identity Manager 4.8.5 or later.

Workaround: Legacy form is updated in this release to use jQuery 3.5.1. As a result, existing forms that use outdated functions from previous jQuery versions may display errors after upgrading. Deprecated functions, however, may not throw an error and are still valid.

To resolve this issue, we recommend that you remove the outdated and deprecated functions from existing forms and replace them with valid jQuery functions. You can perform this operation in Designer by using the ECMA Expression Builder. The ECMA Expression builder can be accessed via the scripts section of a form or the properties tab of a form field. After saving the form, ensure that the provisioning request definition is deployed.

The following table lists the valid jQuery functions to use in place of the deprecated and outdated functions:

Replace

With jQuery functions

Deprecated functions

jQuery.parseJSON()

JSON.parse()

jQuery.isArray()

Array.isArray()

For a list of all deprecated jQuery functions between jQuery version 2.0.3 and 3.5.1, see https://api.jquery.com/category/deprecated/.

Outdated functions

.andSelf()

.addBack()

.error( handler)

.on("error", handler)

.load( handler)

.on("load", handler)

.context

No replacement

.size()

.length

.unload( handler)

.on("unload", handler)

For a list of all functions no longer supported between jQuery version 2.0.3 and 3.5.1, see https://api.jquery.com/category/removed/.

44.8.3 Workflow Forms Hang While Loading

Issue: The application is unable to load some workflow forms. The following error is reported in the NGINX error.log file: upstream prematurely closed connection while reading response header from upstream. This issue happens when the IGAFormRenderer, which is launched by the NGINX service, exceeds the maximum number of TCP connections allowed on the server. This issue applies to Identity Manager 4.8.5 or later.

Workaround: This issue is related to the server’s ulimit settings. Navigate to the /etc/init.d/netiq-golang.sh file on the application server and add the "ulimit -n 4096" line as shown in the following sample, followed by the NGINX service restart:

#!/bin/bash
. gettext.sh
TEXTDOMAIN=install
export TEXTDOMAIN
TEXTDOMAINDIR=/opt/netiq/idm/uninstall_data/common/locale/
export TEXTDOMAINDIR
case $1 in
start)
str1=`gettext install "Starting IGA form renderer backend."`
echo $str1
ulimit -n 4096
(/opt/netiq/idm/apps/sites/IgaFormRenderer.sh -config /opt/netiq/idm/apps/sites/config.ini -golangPort 3000 start &> /dev/null) &
;;

44.8.4 Workflow Forms Not Loading After Upgrading Identity Manager on Windows

Issue: If you have upgraded Identity Manager to version 4.9 on a Windows system, you may encounter an error while launching a helpdesk ticket creation form or other workflow forms. This error occurs because the IGA Form Renderer Service on the Windows system becomes unresponsive after the upgrade. As a result, the application fails to render the forms upon requesting permission or a resource.

Workaround: After upgrading to Identity Manager 4.9, start the IDM Apps Tomcat service, followed by the NetIQ Nginx Service and NetIQ IGA Form Renderer Service.