HP V-Class Server
HP-UX Configuration Notes

Publication Date: December 1998

Copyright: © Copyright Hewlett-Packard Company 1998

Edition: WWW edition, modified 25 November 1998


Contents

Overview

HP-UX Kernel Parameters

Parameter Settings for V-Class Technical Workloads

Parameter Settings for V-Class Commercial Workloads

Creating HP-UX Kernels for V-Class Servers

Documentation

List of Configurable HP-UX Kernel Parameters


Overview

This document describes recommended HP-UX V11.0 kernel configurations for HP V-Class servers.

Suggested HP-UX kernel configurations are provided for the following types of V-Class server use:

Configuration Utilities

You can perform the HP-UX configuration tasks described here by using the System Administration Manager (SAM) utility (/usr/sbin/sam) or the kmtune utility (/usr/sbin/kmtune).

NOTE: For details on configuring kernel parameters using kmtune, see the kmtune(1) man page. This document only covers using SAM.

You can use SAM's Configurable Parameter subarea to perform most of the procedures described in this document. To access this subarea do the following: (1) run SAM, (2) enter the Kernel Configuration area by double-clicking its icon, and (3) double-click the Configurable Parameters icon.


HP-UX Kernel Parameters

HP-UX configurable kernel parameters specify how system hardware resources are used by HP-UX and the programs and users it supports.

By setting kernel parameters to the values recommended for your type of server use, you can configure HP-UX to make optimal use of your V-Class server.

Settings for configurable HP-UX parameters are initially established when the HP-UX operating system is installed from scratch (for instance, when installing HP-UX 11.0 using Ignite-UX). Parameter settings are preserved when upgrading the operating system.

You can set HP-UX parameters to specific numeric values, or to computed values by specifying formulas. For example, the following are three ways of specifying 8 megabytes: 8388608, 0x800000, and 8*1024*1024.

Several new configurable parameters are available in HP-UX V11.0. These include parameters for adjusting variable page size, support for 64-bit applications, and other new operating system features.

Changing Parameter Values

To set parameter values you can either modify individual kernel parameters, or apply a tuned parameter set that modifies several parameter values at once.

SAM also lets you set a kernel's parameter values by copying them from an existing kernel (such as /stand/vmunix) or a system description file (such as /stand/system). You can do this in SAM's Configurable Parameters subarea by selecting the "Actions" menu, then the "Templates" submenu, then selecting menu items to load and apply kernel values.

You may need to manually change HP-UX parameter settings for HP V-Class servers in the following situations:

After changing configurable kernel parameter values in SAM, you must do the following for the new kernel to take effect:

  1. Instruct the SAM utility to generate a new kernel. This new kernel will have the new parameter settings.

  2. Establish that the new kernel be moved into place to become the default kernel during the next system shutdown or startup.

    You can do this automatically by using SAM, or manually by using kmupdate. If using kmupdate, you also should move the new kernel configuration file /stand/build/system.SAM to /stand/system.

  3. Reboot the system.

If you do not have SAM reboot the server, you can use the reboot command to reboot the system at a specified time and warn users of the impending reboot. See reboot(1M) for details.

For a detailed procedure to configure HP-UX for V-Class servers, see "Creating HP-UX Kernels for V-Class Servers".

Using Tuned Parameter Sets

Tuned parameter sets provide settings for collections of kernel parameters. Several different parameter sets are provided for configuring HP-UX for using your server in different situations. For example, the three types of V-Class server use listed in "Overview" are supported by parameter sets.

You can access tuned parameter sets through the "Actions" menu of SAM's Configurable Parameters subarea. These sets also are stored as files in the directory /usr/sam/lib/kc/tuned.

Listing Kernel Parameters

System administrators may list HP-UX kernel parameter settings using the SAM utility (/usr/sbin/sam) or the kmtune utility (/usr/sbin/kmtune). A complete list is provided through SAM's Configurable Parameters subarea. Users who do not have root permission should use kmtune.

Running kmtune with no options lists all kernel parameters and their current values. To list only specified kernel parameters use the -q option. For example, kmtune -q vps_ceiling lists the the vps_ceiling parameter's setting . See the kmtune(1M) man page for details.


Parameter Settings for V-Class Technical Workloads

Scientific and technical workloads have very large data sets and may have long processing times. Examples include NASTRAN, Abaqus, mechanical and electrical design applications, and fluid dynamics applications.

The "V-Class Technical Server" tuned parameter set provides HP-UX kernel parameter settings for running such workloads on HP V-Class servers.

The following are key kernel parameters for V-Class servers running scientific and technical workloads:

These parameters are described below in Table 1.

Table 1 HP-UX parameter settings for HP V-Class technical environments

HP-UX Parameter

Recommended V-Class Technical Setting

Description

hfs_ra_per_disk 1

64

Sets the amount of filesystem read-ahead (in kilobytes) for HFS filesystems.

hfs_max_ra_blocks 1

8

Places a ceiling on the maximum number of read-ahead blocks that the kernel may have outstanding for a single HFS filesystem.

maxdsiz

1342177280

(0x50000000 hexadecimal)

Sets the maximum size (in bytes) of a 32-bit process's static data storage segment.

maxdsiz_64bit

17179869184

(0x400000000 hexadecimal)

Sets the maximum size (in bytes) of a 64-bit process's static data storage segment.

maxssiz

8388608

(0x800000 hexadecimal)

Sets the maximum size (in bytes) of a 32-bit process's dynamic storage segment, also called the "stack size".

maxssiz_64bit

1073741824

(0x40000000 hexadecimal)

Sets the maximum size (in bytes) of a 64-bit process's dynamic storage segment, also called the "stack size".

vps_ceiling

64

(0x40 hexadecimal)

Sets the maximum page size (in kilobytes) that the kernel can select when it chooses a page size based on a system's configuration and the object size.

vxfs_ra_per_disk 1

1024

Sets the amount of filesystem read-ahead (in kilobytes) for VXFS filesystems.

vxfs_max_ra_kbytes 1

1024

Places a ceiling on the total amount of read-ahead (in kilobytes) a VXFS filesystem may have outstanding.

Table footnotes:

  1. You should set the hfs_ and vxfs_ parameters manually using the SAM utility. They are not part of the "V-Class Technical Server" tuned parameter set

Parameter Settings for V-Class Commercial Workloads

Commercial workloads include Oracle, online transaction processing (OLTP) applications, decision support (DSS) applications, and other data processing applications.

Two tuned parameter sets are available in SAM for configuring HP-UX for running commercial workloads on V-Class servers. One parameter set ("OLTP/Database Server System") is useful on servers dedicated to running data processing applications only. The other set ("OLTP/Database Monolithic System") is for servers that not only run data processing applications but also run other miscellaneous programs and allow interactive user log-ins.

These two commercial configurations are described in the next sections.

Configuring a Dedicated Commercial Server

The "OLTP/Database Server System" tuned parameter set provides a good HP-UX configuration for HP V-Class servers dedicated to running commercial data processing applications. These systems provide limited, if any, interactive user access.

Table 2 lists some of the key kernel parameter settings provided through the SAM utility's "OLTP/Database Server System" tuned parameter set.

Table 2 HP-UX parameter settings for dedicated HP V-Class commercial environments (partial listing)

HP-UX Parameter

"OLTP/Database Server System" Setting

Description

bufpages

(nproc*3)

Number of buffer pages.

dbc_max_pct

2

Maximum dynamic buffer cache size (% of memory).

dbc_min_pct

2

Minimum dynamic buffer cache size (% of memory).

maxuprc

((nproc*9)/10)

Maximum number of user processes.

maxusers

200

The MAXUSERS value; used in various kernel formulae.

nproc

((maxusers*3)+64)

Maximum number of processes.

Configuring a Mixed-Use Commercial Server

For HP V-Class servers running data processing applications as well as miscellaneous other applications, the "OLTP/Database Monolithic System" tuned parameter set provides a good HP-UX configuration. These systems may provide interactive log-ins for user access in addition to commercial OLTP/DSS application support.

Table 3 shows the key HP-UX parameter settings provided by the SAM utility's "OLTP/Database Monolithic System" tuned parameter set.

Table 3 HP-UX parameter settings for mixed-use HP V-Class commercial environments (partial listing)

HP-UX Parameter

"OLTP/Database Monolithic System" Setting

Description

bufpages

0

Same as in Table 2.

dbc_max_pct

20

dbc_min_pct

5

maxuprc

((nproc*8)/10)

maxusers

400

nproc

(((10*maxusers)/3)+128)


Creating HP-UX Kernels for V-Class Servers

This section has instructions for using SAM to configure HP-UX for HP V-Class servers.

An alternative to using SAM to modify a kernel is using the kmtune utility; for kmtune information see kmtune(1).

Step 1: Run SAM and enter the Configurable Parameters subarea.

Step 2: Apply the appropriate tuned parameter set.

Step 3: Process the new kernel.

Step 4: Select a method for installing the new kernel.

After SAM processes the new kernel, you are presented with the following options:

(Graphic)

These options are described below.

Step 5: Manually set the system to use the new kernel when rebooted.

This step is not needed if you had SAM move the kernel into place and reboot.

You can schedule the new kernel files to be moved into place by using the kmupdate utility and moving the new kernel description file into place.

Step 6: Set the system to reboot.

This step is not needed if you had SAM move the kernel into place and reboot.


Documentation

You can order print and CD documentation and can access free online HP-UX and HP V-Class server information, as described below.

Ordering Documentation

To order copies of this or other HP documentation, call 1-800-227-8164.

To place an order from outside the United States, or if you cannot use the 1-800 number, call 415-857-2384. Please have the part number (xxxxx-xxxxx) and the exact title of the document available when ordering.

To obtain a document's order number, refer to the online version of the document from the following WWW site:

Additional ordering information is available from:

Free Online Documentation

Free online versions of HP-UX V11.0 documentation are available from the following WWW site:

The above site also contains additional information about HP-UX V11.0 kernel parameter settings.

For hardware documentation, including V-Class information, refer to:

Print and CD versions of this documentation are available as described in the section "Ordering Documentation" above.


List of Configurable HP-UX Kernel Parameters

More information about the configurable parameters in Table 4 is available in the SAM online help (available from the Configurable Parameters subarea's Help menu) and from

Table 4 lists HP-UX kernel parameter names and descriptions.

Table 4 List of HP-UX Kernel Parameters

Parameter Name

Description

NSTREVENT

Max Number of Outstanding Streams bufcalls

NSTRPUSH

Max Number of Streams Modules in Single Stream

NSTRSCHED

Number of Streams Scheduler Daemons to Run

STRCTLSZ

Max Size of Streams Message Control (Bytes)

STRMSGSZ

Max Size of Streams Message Data (Bytes)

acctresume

Threshold to Resume Accounting

acctsuspend

Threshold to Suspend Accounting

aio_listio_max

Max No. of AIO Ops That Can Be Specified in lio_list Call

aio_max_ops

Maximum No. of AIO Ops That Can Be Queued At Any Time

aio_physmem_pct

Percentage of Physical Memory Lockable for Request Call-Back Operations

aio_prio_delta_max

Max Slowdown Factor; Greatest Delta Allowed in aiocb's aio_reqprio Field

allocate_fs_swapmap

Allocate Swapmap Space at swapon

alwaysdump

Bit-Mask of Kernel Memory Pages Included in Dumps

bufcache_hash_locks

Buffer Cache Spinlock Pool Size

bufpages

Number of Buffer Pages

chanq_hash_locks

Channel Queue Spinlock Pool Size

create_fastlinks

Create Fast Symbolic Links

dbc_max_pct

Max Dynamic Buffer Cache Size as Percent of System RAM Size

dbc_min_pct

Min Dynamic Buffer Cache Size as Percent of System RAM Size

default_disk_ir

Immediate Report (Write Cache Enable) Behavior for SCSI Disks

dontdump

Bit-Mask of Kernel Memory Pages Excluded From Dumps

dskless_node

Diskless Node Flag

dst

Daylight Savings Time Policy

eqmemsize

Minimum Number of Equivalently Mapped Memory Pages on the Reserve List

fs_async

Select Asynchronous Writes

ftable_hash_locks

File Table Spinlock Pool Size

hfs_max_ra_blocks

Maximum Number of Read-ahead Blocks for a Single HFS Filesystem

hfs_ra_per_disk

Filesystem Read-ahead (KBytes) for HFS Filesystems

initmodmax

Max No. of Kernel Modules Saved By System Crash Dump

io_ports_hash_locks

I/O Ports Spinlock Pool Size

ksi_alloc_max

System-wide Limit of Queued Signal That Can be Allocated

ksi_send_max

Max No. of Queued Signals a Process May Send and Have Pending at Receiver(s)

max_async_ports

Maximum Number of asyncdsk Ports That Can be Open At One Time

max_fcp_reqs

Maximum Number of Concurrent Fiber Channel Requests Per Adapter

max_thread_proc

Max No. of Threads Allowed in Each Process

maxdsiz

Max Data Segment Size (Bytes)

maxdsiz_64bit

Max Data Segment Size (Bytes)

maxfiles

Soft File Limit Per Process

maxfiles_lim

Hard File Limit Per Process

maxssiz

Max Stack Segment Size (Bytes)

maxssiz_64bit

Max Stack Segment Size (Bytes)

maxswapchunks

Max Number of Swap Chunks

maxtsiz

Max Text Segment Size (Bytes)

maxtsiz_64bit

Max Text Segment Size (Bytes)

maxuprc

Max Number of User Processes

maxusers

Value of MAXUSERS Macro

maxvgs

Max Number of Volume Groups

mesg

Enable Sys V Messages

modstrmax

Max Size (Bytes) of Kernel-Module Savecrash Table

msgmap

Max Number of Message Map Entries

msgmax

Message Max Size (bytes)

msgmnb

Max Number of Bytes on Message Queue

msgmni

Number of Message Queue Identifiers

msgseg

Number of Segments Available for Messages

msgssz

Message Segment Size

msgtql

Number of Message Headers

nbuf

Number of Buffer Cache Headers

ncallout

Max Number of Pending Timeouts

ncdnode

Max Number of Open CDFS Files

nclist

Number of cblocks for pty and tty Data Transfers

ndilbuffers

Number of DIL Buffers

nfile

Max Number of Open Files

nflocks

Max Number of File Locks

ninode

Max Number of Open Inodes

nkthread

Max Number of Kernel Threads Supported by the System

no_lvm_disks

Boolean; Set Only If System Has No LVM Disks

nproc

Max Number of Processes

npty

Number of ptys (Pseudo ttys)

nstrpty

Max Number of Streams-Based PTYs

nstrtel

Number of Telnet Session Device Files

nswapdev

Max Devices That Can be Enabled for Swap

nswapfs

Max File Systems That Can be Enabled for Swap

num_tachyon_adapters

Number of Tachyon-based Fiber Channel Adapters in the System

o_sync_is_o_dsync

Enable/Disable Translation of O_SYNC to O_DSYNC in open(2)/fcntl(2) Calls

page_text_to_local

Enable/Disable Swapping of Program Text Segments to Local Swap

pfdat_hash_locks

Pfdat Spinlock Pool Size

public_shlibs

Public Shared Libraries

region_hash_locks

Region Spinlock Pool Size

remote_nfs_swap

Enable Swapping Across NFS

rtsched_numpri

Number of POSIX.1b Realtime Priorities to Support

scroll_lines

Number of ITE Off Screen Lines

sema

Enable Sys V Semaphores

semaem

Max Value for Adjust on Exit Semaphores

semmap

Max Number of Semaphore Map Entries

semmni

Number of Semaphore Identifiers

semmns

Max Number of Semaphores

semmnu

Number of Semaphore Undo Structures

semume

Semaphore Undo Entries Per Process

semvmx

Semaphore Maximum Value

sendfile_max

Max No. of Buffer Cache Pages Usable by sendfile System Call

shmem

Enable Sys V Shared Memory

shmmax

Max Shared Mem Segment (Bytes)

shmmni

Number of Shared Memory Identifiers

shmseg

Shared Memory Segments Per Process

streampipes

Force All Pipes to be Streams-Based

swapmem_on

Allow Memory to Exceed Swap Space

swchunk

Swap Chunk Size (1K Blocks)

sysv_hash_locks

System V IPC Spinlock Pool Size

tcphashsz

TCP Hash Table Size, in Bytes

timeslice

Scheduling Interval (10 mS Ticks)

timezone

Minutes West of Greenwich

unlockable_mem

Non-Lockable Memory (4096-Byte Pages)

vnode_cd_hash_locks

Vnode Clean/Dirty Spinlock Pool Size

vnode_hash_locks

Vnode Spinlock Pool Size

vps_ceiling

Maximum System-Selected Page Size (in Kbytes)

vps_chatr_ceiling

Maximum chatr-Selected Page Size (in Kbytes)

vps_pagesize

Default User Page Size (in Kbytes)

vxfs_max_ra_kbytes

Total Amount of Read-ahead (KBytes) a VXFS Filesystem may have Outstanding

vxfs_ra_per_disk

Filesystem Read-ahead (KBytes) for VXFS Filesystems

vx_ncsize

Directory Name Lookup Cache (DNLC) Space Needed for VxFS Inodes