6.16 Checking IPC Requirements

The Oracle Tuxedo system uses interprocess communications (IPC) resources heavily. On many systems, the default values for the parameters that control the size and quantity of the various IPC resources are below the minimums needed to run even a modest Oracle Tuxedo application. Therefore, you may need to reset some parameters. After editing your UBBCONFIG file, you should determine whether you have enough IPC resources for your application.

To perform this task, enter the following tmloadcf(1) command, specifying your edited UBBCONFIG file as input:

tmloadcf -c UBBCONFIG

With the-coption, the tmloadcf program prints a list of the minimum IPC resources required for your application, but does not create or update the TUXCONFIG file. The following is an output report based on the values in ubbsimple.

Output Produced by tmloadcf -c
Ipc sizing (minimum /T values only)... 
Fixed Minimums Per Processor 
SHMMIN: 1 
SHMALL: 1 
SEMMAP: SEMMNI 
Variable Minimums Per Processor 
SEMUME, A SHMMAX SEMMNU, * * 
Node SEMMNS SEMMSL SEMMSL SEMMNI MSGMNI MSGMAP SHMSEG 
------ ------ ------ ------ ------ ------ ------ ------ 
sftuxe 17 5 12 A + 1 13 26 75K 
where 1 <= A <= 8. 
The number of expected application clients per processor should be added to each MSGMNI value.

The output report identifies IPC resources by their traditional UNIX names. To map the traditional names to the names specific to a UNIX platform, see the data sheet for that platform in Oracle Tuxedo 22c Release (22.1.0.0.0) Platform Data Sheets.

The example output report indicates that to run simpapp, your system must have SEMUME, SEMMNU, and SEMMNS set to no less than 17. SEMMSL must be at least 5, and SEMMNI and SEMMAP at least 4 (assuming the value of A is 3). MSGMNI must be at least 13, and MSGMAP at least 26. Finally, the product of SHMMAX and SHMSEG must be at least 75K bytes.

The IPC values are application-dependent, and the numbers in this example reflect a very small configuration. If other client or server applications that use IPC resources are running on the same system with an Oracle Tuxedo application, then the requirements of both applications must be satisfied. Keep in mind also that every machine participating in an application must have sufficient IPC resources available.

If the current IPC resources are inadequate, you must increase the values of the associated IPC parameters.

For instructions on changing the current IPC values for a UNIX system, see the data sheet for your platform in Oracle Tuxedo 22c Release (22.1.0.0.0) Platform Data Sheets.