idsktune

generate system tuning recommendations for running Directory Server Enterprise Edition server software

Synopsis

./idsktune  [-q] [-D] [-v] [-c] [-i install-path]

Description

The idsktune command checks patch levels and kernel parameter settings for the system on which Directory Server or directory client applications run, making tuning recommendations as it performs the checks.

Caution:

Information given by idsktune may not apply to the current version or platform upon which it is run.

Run the command as super user to obtain the widest range of tuning recommendations.

The idsktune command is delivered only with the zip distribution software.

The idsktune command suggests changes you make to the system, but does not itself make any changes. You must fix at least all ERROR conditions identified by the idsktune command.

The idsktune command reports as missing all patches recommended at the time of release and not installed on the system, even patches for packages not installed on the system.

Options

The idsktune command supports the following options.

-c

Display tuning recommendations only for directory client applications.

Default is to display recommendations for both directory client applications and for Directory Server.

-D

Run in debug mode, displaying messages to showing commands the idsktune command runs internally, preceded by DEBUG.

-i install-path

Check the specified installation directory to ensure enough space is available.

-q

Run in quiet mode, reporting only information about key system prerequisites and essential settings.

-v

Display the version information about the build and exit.

Extended Description

The idsktune command verifies and reports on the following settings depending on the underlying system.

Operating system and kernel versions

Solaris and Red Hat version numbers
Solaris kernel build date
Solaris, and HP-UX patches

Memory and disk space

Physical memory size
Swap space or swap partition size
Memory resource limits
File descriptor resource limits

Scheduler settings

Maximum threads per process for HP-UX
Maximum files for HP-UX

TCP settings

Many of the following are system-specific TCP tuning settings.

Listen backlog queue size
tcbhashsize, tcbhashnum and tcp_msl
sominconn and somaxconn
ipport_userreserved_min
tcp_close_wait_interval and tcp_time_wait_interval
tcp_keepalive_interval
tcp_max_listen
tcp_conn_request_max
tcp_conn_req_max_q and tcp_conn_req_max_q0
tcp_rexmit_interval_initial
net.inet.ip.portrange.hifirst and tcp_smallest_anon_port
tcp_slow_start_initial
net.inet.tcp.delayed_ack and tcp_deferred_ack_interval
link_speed on /dev/hme

Tuning system settings, especially network stack settings, involves considering potentially not just directory applications and Directory Server, but also other applications running on the system and in the environment. In general, however, implementing the recommendations optimizes directory performance whether the system is dedicated to Directory Server or shared with other applications.

Exit Status

The idsktune command exits with status 0 if it completes successfully and no ERRORs are found. Otherwise, it exists with non-zero status.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	Zip distribution only
Stability Level	Evolving