idsktune(1M)

NAME | Synopsis | Description | Options | Extended Description | Exit Status | Attributes

NAME

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. Run the command as super user to obtain the widest range of tuning recommendations.

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

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^TM 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

NAME | Synopsis | Description | Options | Extended Description | Exit Status | Attributes