Chapter 7. Troubleshooting

This chapter describes the most common installation problems and how to solve them. It also provides some tips on checking patch levels and kernel parameter settings for your system.

This chapter has the following sections:

7.1. Running dsktune

The dsktune utility provides an easy and reliable way of checking the patch levels and kernel parameter settings for your system. You must install the Directory Server before you can run dsktune.

On Solaris platforms, if you run the dsktune utility, it reports as missing any of the patches from the Sun recommended patch list that are not installed on your system, even if they relate to packages that you have not installed.

To run dsktune:

  1. Change to the installation directory for your Directory Server.

    By default, this directory is /opt/redhat-ds/servers.

  2. Change to the bin/slapd/server subdirectory.

  3. As root, enter the following command:

    ./dsktune

The following is an example of output that dsktune generates. dsktune does not itself make any changes to the system.

Executing /tmp/redhat/dsktune...

Red Hat Directory Server system tuning analysis version 
04-APRIL-2005.

NOTICE : System is hppa2.0/549-hp9000/785/J5000-hpux_B.11.11.

WARNING : Only the superuser can check which patches are installed. 
 You must run 
dsktune as root to ensure the necessary patches are present. 
 If required patches 
are not present, the server may not function correctly.

NOTICE : The tcp_keepalive_interval is set to 7200000 milliseconds 
(120 minutes). 
 
This may cause temporary server congestion from lost client 
connections.

An entry similar to the following should be added to 
/etc/rc.config.d/nddconf:

TRANSPORT_NAME[10]=tcp

NDD_NAME[10]=tcp_keepalive_interval

NDD_VALUE[10]=600000

NOTICE : The NDD tcp_rexmit_interval_initial is currently set to 
3000 milliseconds (3 seconds). 
 This may cause packet loss for clients on Solaris 
2.5.1 due to a bug in that version of Solaris. 
 If the clients are not using 
Solaris 2.5.1, no problems should occur.

NOTICE : If the directory service is intended only for LAN or 
private high-speed WAN environment, this interval can be reduced 
by adding an entry similar to the following to 
/etc/rc.config.d/nddconf file:

TRANSPORT_NAME[10]=tcp

NDD_NAME[10]=tcp_rexmit_interval_initial

NDD_VALUE[10]=500

NOTICE : The NDD tcp_ip_abort_cinterval is currently set to 75000 
milliseconds (75 seconds). 
 This may cause long delays in establishing outgoing connections if 
the destination server is down.

NOTICE : If the directory service is intended only for LAN or 
private high-speed WAN environment, this interval can be reduced 
by adding an entry similar to the following to 
/etc/rc.config.d/nddconf file:

TRANSPORT_NAME[10]=tcp

NDD_NAME[10]=tcp_ip_abort_cinterval

NDD_VALUE[10]=10000

NOTICE : The NDD tcp_ip_abort_interval is currently set to 75000 
milliseconds (75 seconds). 
 This may cause long delays in detecting connection failure if the 
destination server is down.

NOTICE : If the directory service is intended only for LAN or 
private high-speed WAN environment, this interval can be reduced 
by adding an entry similar to the following to 
/etc/rc.config.d/nddconf file:

TRANSPORT_NAME[10]=tcp

NDD_NAME[10]=tcp_ip_abort_interval

NDD_VALUE[10]=60000

ERROR  : The NDD tcp_smallest_anon_port is currently 49152. 
 This allows a maximum 
of 16384 simultaneous connections. 
 More ports can be made available by adding an 
entry similar to the following to /etc/rc.config.d/nddconf:

TRANSPORT_NAME[10]=tcp

NDD_NAME[10]=tcp_smallest_anon_port

NDD_VALUE[10]=8192

WARNING: tcp_deferred_ack_interval is currently 50 milliseconds. 
This will cause the operating system to insert artificial delays 
in the LDAP protocol. 
 It should be reduced during load testing. 
An entry similar to the following can be added to 
the /etc/rc.config.d/nddconf file:

TRANSPORT_NAME[10]=tcp

NDD_NAME[10]=tcp_deferred_ack_interval

NDD_VALUE[10]=5

WARNING: largefiles option is not present on mount of /opt, 
although it is present on other file systems. 
 Files on the /opt file system will be limited to 2GB in 
size.

NOTICE : /opt partition has only 90MB free.

Continue [n]?

Example 7-1. Sample dsktune Output