Bookshelf v7.5: Tuning the Siebel Server for AIX

AIX provides several environment variables that can be tuned to optimize Siebel Server performance. These environment variables and their values are used as start parameters when the Siebel Server is started. Table 38 and Table 39 describe each of these environment variables and their recommended settings.

Table 38. Environment Variables Used for Optimization in $SIEBEL_ROOT/siebenv
Environment Variable	Value	Description
AIXTHREAD_SCOPE	`S`	Controls contention scope, S signifies system-based contention scope (1:1).
AIXTHREAD_MNRATIO	`1:1`	Controls the M:N ratio of number of kernel threads that should be employed to handle runnable pthreads.
AIXTHREAD_MUTEX_DEBUG	`OFF`	Maintains a list of active mutexes for use by the debugger.
AIXTHREAD_RWLOCK_DEBUG	`OFF`	Maintains a list of read-write locks for use by the debugger.
AIXTHREAD_COND_DEBUG	`OFF`	Maintains a list of condition variables for use by the debugger.

Table 39. Environment Variables Used for Optimization in
$SIEBEL_ROOT/bin/siebmtshw
Environment Variable	Value	Description
RT_GRQ	`ON`	Causes thread to be put on a global run queue rather than on a per-CPU run queue.
SPINLOOPTIME	`1000`	Controls the number of times to retry a busy lock before yielding to another processor.
YIELDLOOPTIME	`4`	Controls the number of times to yield the processor before blocking on a busy lock (only for libpthreads).
MALLOCTYPE	buckets	Malloc buckets provide an optional buckets-based extension of the default allocator. It improves malloc performance for applications that issue large numbers of small allocation requests. When malloc buckets is enabled, allocation requests that fall within a predefined range of block sizes are processed by malloc buckets. All other requests are processed in the usual manner by the default allocator.
MALLOCMULTIHEAP	heaps:n	Controls the number of heaps within the process private segment. n should be equal to the number of processors on the server.
LDR_CNTRL	`LOADPUBLIC@MAXDATA=0x50000000`	The `LOADPUBLIC` option directs the system loader to load all modules requested by an application into the global shared library segment. Set LDR_CNTRL in the environment of the user, or preferably, in the shell script that launches the executable needing the extra memory. The MAXDATA value reserves five 256 MB segments for all executables launched from this environment, and overrides the default executable setting. The default depends on the executable. With the default value, a Siebel component can support a maximum value of 5000 for the `MAXTASK` parameter. With this value, `MAXTASK` can go up to 9000. Depending on the environment, you may reserve up to a maximum of six segments. If it is not possible to use that many segments, Siebel Server will terminate very early.