Setting the Number of File Descriptors per Process
Status
|
If you are... |
This task is... |
|
Installing a new iProcess Engine Version 11.8.0 |
Required |
|
Upgrading from an iProcess Engine Version 11.0 or later |
Possibly required |
Database
Oracle, DB2
Description
When iProcess Engine is started, it must have a sufficient number of available file descriptors per process, based on the number of iProcess Engine users.
The number of files per user that will be needed by iProcess Engine will vary depending on a number of factors that are unique to each site’s procedures and transactions. However, as a guideline, the minimum number of file descriptors per process needed will be the highest of the following three values:
| • | 1024 |
| • | (Number of iProcess Engine users) * 2 |
| • | Number of file descriptors required by the TIBCO iProcess Objects Server, if an iProcess Objects Server is also installed on this machine. See TIBCO iProcess Objects Server Release Notes for details of how to calculate the number of required file descriptors per process. |
When the iProcess Engine is started, it attempts to set the number of files from the system default number to the maximum number allowed. You can display:
| • | the default value by using the UNIX ulimit -n or ulimit -Sn commands (S indicates the soft or default limit). |
| • | the maximum value by using the UNIX ulimit -Hn command (H indicates the hard or maximum limit). |
Procedure
If your current per process file limit is less than the number needed, you must either raise the number of open files for the entire system, or use a script with root execute permissions to set the file handle limit. For more information about how to do this, please see your operating system documentation.
|
Warning |
It is highly recommended that you set the per process file limit as high as possible. iProcess Engine may exhibit unpredictable behavior or even fail if there are no more file descriptors available. Running the command |