Exit Print View

Sun OpenDS Standard Edition 2.2 Installation Guide

Get PDF Book Print View

Document Information

Which Install To Choose

Sun OpenDS Standard Edition System Requirements

Hardware Requirements

Supported Operating Systems

Operating System Requirements

Java Requirements

Java Environment Variables

To specify a JVMTM Installation for the Directory Server

File Descriptor Requirements (Linux Systems)

To Increase the File Descriptor Limit (Linux)

Specific Requirements for Installation in a Solaris Zone

Getting the Software

Installing the Directory Server

Installing the Proxy Server

Configuring the JVM, Java Options, and Database Cache

Starting and Stopping Your Server Instance

Managing the Server as a Service

Uninstalling the Directory Server

Uninstalling the Proxy

File Descriptor Requirements (Linux Systems)

To ensure good server performance, the total number of client connections, database files, and log files must not exceed the maximum file descriptor limit on the operating system (ulimit -n). By default, the directory server allows an unlimited number of connections but is restricted by the file descriptor limit on the operating system. Linux systems limit the number of file descriptors that any one process may open to 1024 per process. (This condition is not a problem on Solaris machines, x86, x64, or SPARC).

After the directory server has exceeded the file descriptor limit of 1024 per process, any new process and worker threads will be blocked. For example, if the directory server attempts to open a Oracle® Berkeley JE database file when the operating system has exceeded the file descriptor limit, the directory server will no longer be able to open a connection that can lead to a corrupted database exception. Likewise, if you have a directory server that exceeds the file descriptor limit set by the operating system, the directory server can become unresponsive as the LDAP connection handler consumes all of the CPU's processing in attempting to open a new connection.

To fix this condition, set the maximum file descriptor limit per process on Linux machines.

To Increase the File Descriptor Limit (Linux)

  1. Display the current hard limit of your machine.

    The hard limit is the maximum server limit that can be set without tuning the kernel parameters in proc file system.

    $ ulimit -aH
    core file size (blocks)       unlimited
    data seg size (kbytes)        unlimited
    file size (blocks)            unlimited
    max locked memory (kbytes)    unlimited
    max memory size (kbytes)      unlimited
    open files                    1024
    pipe size (512 bytes)         8
    stack size (kbytes)           unlimited
    cpu time (seconds)            unlimited
    max user processes            4094
    virtual memory (kbytes)       unlimited
  2. Edit the /etc/security/limits.conf and add the lines:
    *     soft   nofile  1024
    *     hard   nofile  65535 
  3. Edit the /etc/pam.d/login by adding the line:
    session required /lib/security/pam_limits.so
  4. Use the system file limit to increase the file descriptor limit to 65535.

    The system file limit is set in /proc/sys/fs/file-max .

    echo 65535 > /proc/sys/fs/file-max
  5. Use the ulimit command to set the file descriptor limit to the hard limit specified in /etc/security/limits.conf.
    ulimit -n unlimited
  6. Restart your system.