Work Item Server (WIS) process - high handle count

Work Item Server (WIS) process - high handle count

book

Article ID: KB0079857

calendar_today

Updated On:

Products Versions
TIBCO iProcess Engine (Oracle) 11.4.*, 11.5.*, 11.6.*

Description

If any process has more than a 40,000 handle count then it can be viewed as a concern to System Administrators.

The WIS (wisrpc.exe) is a multi-thread application and there are a lot of objects that may be accessed by different threads.  Because of this, the WIS needs a lot of locks. The WIS acquires all its locks (which translates into handles) when the process starts up.

Issue/Introduction

Information regarding the high number of handles per WIS process

Environment

All OS and Platform. Versions 11.4.*, 11.5.*, 11.6.*

Resolution

The total number of locks/handles acquired depends on the WIS_LOCK_POOL_SIZES attribute which by default is set to MEDIUM.  At this setting, the WIS acquires roughly 65K locks on start up but this number will not continue to grow. It may fluctuate up and down slightly but stay in this range.

The amount of handles acquired can be changed by updating the size value accordingly -

swadm set_attribute 0 WIS 0 WIS_LOCK_POOL_SIZES <SIZE VALUE>

It is unlikely more than 65,000 will be required but the amount can be modified by using the values LARGE, HUGE, GIGANTIC and VAST if required.

For smaller values, here are the associated handle counts for the <SIZE VALUE>

MEDIUM - approximately 65,000
SMALL - approximately 40,000
TINY - approximately 20,000

Additional Information

Work Item Server:
https://docs.tibco.com/pub/ipe-oracle/11.6.1/doc/html/wwhelp/wwhimpl/js/html/wwhelp.htm#href=tib_ipe_architecture_guide/server.08.2.htm#1031044

WIS_LOCK_POOL_SIZES:
https://docs.tibco.com/pub/ipe-oracle/11.6.1/doc/html/wwhelp/wwhimpl/js/html/wwhelp.htm#href=tib_ipe_admin_guide/adm_prat.10.062.htm#1442255