Sun ONE Directory Server Resource Kit 5.2 Tools Reference |
Chapter 10
The idsktune Optimization ToolThe idsktune tool helps automate the process of optimizing server settings to initiate their best performance. This chapter provides instructions on how to use the idsktune tool. It contains the following sections:
OverviewThe default operating system and network settings on many platforms are not suitable for most high performance directory services. Tuning is the process of modifying these settings for optimal performance of both directory clients and directory servers. The idsktune tool helps automate this task by checking for necessary patches and suggesting the optimal kernel and TCP/IP settings for running Sun ONE Directory Server.
Note
This tool does not modify the system; it only provides suggested settings. The system administrator must make these changes manually.
idsktune is provided with Directory Server in the DirectoryServer_base/bin/slapd/server directory. However, the DSRK and its updates should include the latest version of the tool in the DSRK_base/bin/dsrk52 directory.
System TuningThe idsktune tool gathers information about the operating system, kernel, and TCP stack in order to make tuning recommendations. Because of system differences, most of the tuning parameters in the following sections are for Solaris and UNIX� systems only. On the Microsoft� Windows platforms, the idsktune tool verifies operating system compatibility and service patch level.
OS and Kernel Settings
The tool displays current operating system version numbers and patch information, along with any recommended patches. It also verifies disk and memory availability and warns of any deficiencies. Specifically, idsktune verifies and reports on the following:
TCP Settings
The idsktune tool reads the current settings of your system’s Transmission Control Protocol (TCP) module and makes recommendations for changes. The tool does not perform any of these modifications. Instead, it displays the command-line for the ndd tool, which the system administrator should use to set the parameter. The ndd tool is available on the Solaris platform. An equivalent tool should be used if you are tuning a different platform.
The idsktune tool verifies and makes recommendations on the following 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 (Linux) and tcp_smallest_anon_port
- tcp_slow_start_initial
- net.inet.tcp.delayed_ack (Linux) and tcp_deferred_ack_interval
- link_speed on /dev/hme (Solaris platform)
The idsktune tool verifies all of the settings for the Solaris 2.6 and Solaris 8 operating systems that are described in “Tuning System Settings” in Chapter 5 of the Sun ONE Directory Server Installation and Tuning Guide.
Further Information
Basic and advanced information about tuning your Solaris system is available through the following books and websites:
- Sun Performance and Tuning: Java and the Internet (ISBN 0-13-095249-4)
- Solaris Performance Administration (ISBN 0-07-011768-3)
- “Solaris 2.x - Tuning Your TCP/IP Stack and More” (http://www.sean.de/Solaris/soltune.html)
- “Solaris Tunable Parameters Reference Manual” (http://docs.sun.com/doc/817-1759)
- “Tuning Tru64 UNIX for Internet Servers” (http://h30097.www3.hp.com/docs/internet/TITLE.HTM)
- sys-check tool for Tru64 (OSF/1) UNIX (http://h30097.www3.hp.com/sys_check/resources.html)
Command UsageAlthough this command should be run as root to get a full report on all settings, most settings are verified when it is run as any user. However, you must be root if you wish to modify any of the operating system, kernel, or TCP settings based on the idsktune recommendations.
Syntax
The syntax of the idsktune command takes the following form:
idsktune [-v | -D | -q | -c | -\?]
Options
Table 10-1 details the command-line options for idsktune.
Sample OutputCode Example 10-1 is an example of running idsktune on an untuned Solaris 8 system. This is the default output displayed when no options are used.