Additional settings for installing on HP-UX

Before you install IBM® WebSphere® MQ on an HP-UX system, you must check that the kernel is configured correctly.

Kernel configuration

It is possible that the default kernel configuration is not adequate because IBM WebSphere MQ uses semaphores and shared memory.

Before installation, review the configuration of the machine and increase the values if necessary. Consider using the values of the tunable kernel parameters given in Figure 1. These values might need to be increased if you obtain any First Failure Support Technology ( FFST) records.

Note:

Semaphore and swap usage do not vary significantly with message rate or message persistence.
WebSphere MQ queue managers are independent of each other. Therefore system tunable kernel parameters, for example shmmni, semmni, semmns , and semmnu need to allow for the number of queue managers in the system.

See the HP-UX documentation for information about changing these values.

Figure 1. Minimum tunable kernel parameters values

   shmmax           536870912
   shmseg           1024
   shmmni           1024
   semaem           16384
   semvmx           32767
   semmns           16384
   semmni           1024 (semmni < semmns)
   semmnu           16384
   semume           256
   max_thread_proc  66
   maxfiles         10000
   maxfiles_lim     10000

You must restart the system after you change any of the tunable kernel parameters.

System resource limits

You can set global limits for the size of process data segments and the size of process stack segments for the whole system. These limits are set by altering the tunable kernel parameters.

The tunable kernel parameters are:

Parameter	What it controls	Consider minimum value
maxdsiz	Maximum size of the data segment for 32-bit processes	1073741824
maxdsiz_64bit	Maximum size of the data segment for 64-bit processes	1073741824
maxssiz	Maximum size of the stack segment for 32-bit processes	8388608
maxssiz_64bit	Maximum size of the stack segment for 64-bit processes	8388608

If other software on the same machine needs higher values, then the operation of IBM WebSphere MQ is not adversely affected if those higher values are used.

For the full documentation for these parameters see the HP-UX product documentation.

To apply the settings to an HP-UX 11i system which has the System Administration Manager (SAM) utility, you can use SAM to achieve the following steps:

Select and alter the parameters
Process the new kernel
Apply the changes and restart the system

Other releases of HP-UX might provide different facilities to set the tunable kernel parameters. Consult your HP-UX product documentation for the relevant information.

The ulimit shell command

On a per-shell basis, the available limits can be tuned down from the values stored for the System resource limits preceding parameters. Use the ulimit shell command to tune the values of the parameters with a combination of the following switches:

Switch	Meaning
-H	The hard limit
-S	The soft limit
-d	The data segments size
-s	The stack segment size

Verifying that the kernel settings are applied

You can verify that the resource limits have not been lowered by a ulimit command and that the queue manager experiences the correct limits. To do so, go to the shell from which the queue manager is started and enter the following command:


ulimit -Ha
ulimit -Sa

Among the console output you can see:


data(kbytes)   1048576
stack(kbytes)  8192

If lower numbers are returned, then a ulimit command has been issued in the current shell to lower the limits. Consult with your system administrator to resolve the issue.

For more information on configuring your system, see How to configure UNIX and Linux® systems for WebSphere MQ.