Netscape logo Installation Guide
Netscape Directory Server

Previous      Contents      Index      DocHome      Next     

Chapter 2   Computer System Requirements


Before you can install Netscape Directory Server (Directory Server), you must make sure that the systems on which you plan to install the software meet the minimum hardware and operating system requirements.

These requirements are described in detail for each platform in the following sections:

Supported Platforms


This release of Directory Server is supported on the following platforms:

Hardware Requirements


On all platforms, you will need:

The table below contains some guidelines for disk space and memory requirements depending on the number of entries managed by your Directory Server. This assumes entries in the LDIF file are approximately 100 bytes in size and only the recommended indexes are configured. If you are using larger entries, make sure that at least four times the size of the LDIF file is available on disk.



Number of Entries

Disk Space and Memory Required

10,000 - 250,000 entries

Free disk space: 2 GB Free memory: 256 MB

250,000 - 1,000,000 entries

Free disk space: 4 GB Free memory: 512 MB

Over 1,000,000 entries

Free disk space: 8GB Free memory: 1 GB



Operating System Requirements


This section contains information on operating-system versions and patches required for installing Directory Server:

dsktune Utility

For UNIX platforms, Directory Server provides a utility named dsktune that can help you verify whether you have the appropriate patches installed on your system. The utility also provides useful information and advice on how to tune your kernel parameters for best performance.

To enable you to run dsktune before installing the Directory Server, the utility is placed, along with the setup program, in the directory where you unpack product binaries. After you've installed the Directory Server, you can find the utility in the serverRoot/bin/slapd/server directory.

For information on running dsktune, see Chapter 8 "Troubleshooting."

Solaris 8 Operating System

If you run Directory Server on a Solaris operating system, you must ensure that the recommended patch cluster is installed. Solaris patches are identified by two numbers, for example 106125-10. The first number (106125) identifies the patch itself. The second number identifies the version of the patch, in the example above the patch is version number 10. We recommend installing the latest version of the patch in order to benefit from the latest fixes.

See the Solaris Operating Environment Security Sun Blueprint at http://www.sun.com/blueprints/0100/security.pdf for advice on guarding against potential security threats.

This section covers these topics:

Verifying Disk Space

Ensure that you have sufficient disk space before downloading the software.

Current working directory: 120 MB
Partition containing /usr/netscape: 2 GB

Verifying Required System Modules

Directory Server requires the use of a SPARC v8+ or an UltraSPARC (SPARC v9) processor, as these processors include support for high performance and multiprocessor systems. Earlier SPARC processors are not supported.

If you run Directory Server on a 64-bit Sun Solaris 8 UltraSPARC machine, it will run as a 32-bit application.

Installing Patches

You must use Solaris 8 with the Sun recommended patches. The following Sun patches should be installed on your system before installing this Netscape product. The command "showrev -p" will list the patches which have been installed. If you need to get a patch, see the web page sunsolve.sun.com or FTP to ftp://sunsolve.sun.com/pub/patches.

You will need to reboot your machine after installing these patches.

In addition to the patches listed here, you may want to install the latest patch cluster for your version of Solaris, which includes additional recommended and security patches. The Sun recommended patch clusters can be obtained from your Solaris support representative, or from http://sunsolve.sun.com.


Table 2-1    Solaris 8 Patch List  


108528-09:

SunOS 5.8: kernel update patch

108652-35:

X11 6.4.1 Xsun patch

108725-05:

SunOS 5.8: st driver patch

108827-10:

SunOS 5.8: libthread patch

108827-19

SunOS 5.8: /usr/lib/libthread.so.1 patch

108869-06:

SunOS 5.8: snmpdx/mibiisa/libssasnmp/snmplib patch

108875-09:

SunOS 5.8: c2audit patch

108968-05:

SunOS 5.8: vol/vold/rmmount patch

108974-11:

SunOS 5.8: dada, uata, dad, sd and scsi drivers patch

108975-04:

SunOS 5.8: /usr/bin/rmformat and /usr/sbin/format patch

108977-01:

SunOS 5.8: libsmedia patch

108985-03:

SunOS 5.8: /usr/sbin/in.rshd patch

108987-04:

SunOS 5.8: Patch for patchadd and patchrm

108989-02:

SunOS 5.8: /usr/kernel/sys/acctctl and /usr/kernel/sys/exacctsys patch

108991-13:

SunOS 5.8: /usr/lib/libc.so.1 patch

108993-03:

SunOS 5.8: nss and ldap patch

109091-04:

SunOS 5.8: /usr/lib/fs/ufs/ufsrestore patch

109137-01:

SunOS 5.8: /usr/sadm/install/bin/pkginstall patch

109181-03:

SunOS 5.8: /kernel/fs/cachefs patch

109277-01:

SunOS 5.8: /usr/bin/iostat patch

109279-13:

SunOS 5.8: /kernel/drv/ip patch

109318-12:

SunOS 5.8: suninstall patch

109320-03:

SunOS 5.8: LP patch

109322-07:

SunOS 5.8: libnsl patch

109324-02:

SunOS 5.8: sh/jsh/rsh/pfsh patch

109326-05:

SunOS 5.8: libresolv.so.2, in.named patch

109326-07:

SunOS 5.8: libresolv.so.2 and in.named patch

109470-02:

CDE 1.4: Actions Patch

109587-03:

SunOS 5.8: libspmistore patch

109742-04:

SunOS 5.8: /kernel/drv/icmp patch

109783-01:

SunOS 5.8: /usr/lib/nfs/nfsd patch

109805-03:

SunOS 5.8: pam_krb5.so.1 patch

109898-02:

SunOS 5.8: /kernel/drv/arp patch

109951-01:

SunOS 5.8: jserver buffer overflow

110075-01:

SunOS 5.8: /kernel/drv/devinfo and /kernel/drv/sparcv9/devinfo patch

110283-03:

SunOS 5.8: mkfs and newfs patch

110286-02:

SunOS 5.8: mkfs and newfs patch

110322-01:

SunOS 5.8: /usr/lib/netsvc/yp/ypbind patch

110383-01:

SunOS 5.8: libnvpair patch

110387-03:

SunOS 5.8: ufssnapshots support, ufsdump patch

110453-01:

SunOS 5.8: admintool patch

110458-02:

SunOS 5.8: libcurses patch

110662-02:

SunOS 5.8: ksh patch

110700-01:

SunOS 5.8: automount patch

110898-02:

SunOS 5.8: csh/pfcsh patch

110901-01:

SunOS 5.8: /kernel/drv/sgen and /kernel/drv/sparcv9/sgen patch

110934-01:

SunOS 5.8: pkgtrans, pkgadd, pkgchk and libpkg.a patch

110939-01:

SunOS 5.8: /usr/lib/acct/closewtmp patch

110943-01:

SunOS 5.8: /usr/bin/tcsh patch

110945-01:

SunOS 5.8: /usr/sbin/syslogd patch

110951-01:

SunOS 5.8: /usr/sbin/tar and /usr/sbin/static/tar patch

111071-01:

SunOS 5.8: cu patch

111111-01:

SunOS 5.8: nawk line length limit corrupts patch dependency checking

111232-01:

SunOS 5.8: patch in.fingerd

111234-01:

SunOS 5.8: patch finger

111293-03:

SunOS 5.8: /usr/lib/libdevinfo.so.1 patch

111325-01:

SunOS 5.8: /usr/lib/saf/ttymon patch

111327-02:

SunOS 5.8: libsocket patch

111363-01:

SunOS 5.8: /usr/sbin/installf patch

111548-01:

SunOS 5.8: catman, man, whatis, apropos and makewhatis patch

111570-01:

SunOS 5.8: uucp patch



Tuning the System

Basic Solaris tuning guidelines are available from several books, including Sun Performance and Tuning: Java and the Internet (ISBN 0-13-095249-4). Advanced tuning information is available in the Solaris Tunable Parameters Reference Manual (806-4015) which can be obtained from http://docs.sun.com/ab2/coll.707.1/

Setting File Descriptors

The system-wide maximum file descriptor table size setting will limit the number of concurrent connections that can be established to Directory Server. The governing parameter, rlim_fd_max, is set in the /etc/system file. By default, if this parameter is not present, the maximum is 1024. It can be raised to 4096 by adding to /etc/system a line

set rlim_fd_max=4096

and rebooting the system.


Caution  

This parameter should not be raised above 4096 without first consulting your Sun Solaris support representative as it may affect the stability of the system.




Tuning TCP Parameters

By default, the TCP/IP implementation in a Solaris kernel is not correctly tuned for Internet or Intranet services. The following /dev/tcp tuning parameters should be inspected and, if necessary, changed to fit the network topology of the installation environment.

The tcp_time_wait_interval in Solaris 8 specifies the number of milliseconds that a TCP connection will be held in the kernel's table after it has been closed. If its value is above 30000 (30 seconds) and the directory is being used in a LAN, MAN or under a single network administration, it should be reduced by adding a line similar to the following to the /etc/init.d/inetinit file:

ndd -set /dev/tcp tcp_close_wait_interval 30000

The tcp_conn_req_max_q0 and tcp_conn_req_max_q parameters control the maximum backlog of connections that the kernel will accept on behalf of the Directory Server process. If the directory is expected to be used by a large number of client hosts simultaneously, these values should be raised to at least 1024 by adding a line similar to the following to the /etc/init.d/inetinit file:

ndd -set /dev/tcp tcp_conn_req_max_q0 1024
ndd -set /dev/tcp tcp_conn_req_max_q 1024

The tcp_keepalive_interval specifies the interval in seconds between keepalive packets sent by Solaris for each open TCP connection. This can be used to remove connections to clients that have become disconnected from the network.

The tcp_rexmit_interval_initial value should be inspected when performing server performance testing on a LAN or high speed MAN or WAN. For operations on the wide area Internet, its value need not be changed.

The tcp_smallest_anon_port controls the number of simultaneous connections that can be made to the server. When rlim_fd_max has been increased to above 4096, this value should be decreased, by adding a line similar to the following to the /etc/init.d/inetinit file:

ndd -set /dev/tcp tcp_smallest_anon_port 8192

The tcp_slow_start_initial parameter should be inspected if clients will predominately be using the Windows TCP/IP stack.

Windows NT 4.0 Server

This section describes how to install Directory Server on Windows NT:

Configuring a Machine to Run Directory Server

Directory Server should be installed on a computer which is isolated from the public Internet by a network-level firewall. This is necessary to protect the Windows NT operating system from IP-based attacks.

No other network functions should be provided by this computer. The computer should not be dual-booting system or run other operating systems. At a minimum, the computer system should have at least 256 MB of RAM, 2 GB of disk, a Pentium II or later processor, and a 100 MBps Ethernet connection.

Ensure that you have sufficient disk space before downloading the software.

Download drive: 120 MB
Installation drive: 200 MB

Verifying Required System Modules

Directory Server is not supported on Windows NT 3.5.1 or earlier releases, or Windows NT for the Alpha architecture. Neither is it supported on Windows NT Workstation, because this form of the operating system is not suitable for scalable Internet or Intranet server deployments. Windows NT Workstation is limited in its allowable setting for connection backlog. Windows NT Server allows a connection backlog setting of more than 10, which is necessary for TCP/IP servers under heavy load.

Installing Windows NT Server

During the installation of Windows NT, please observe the following:

Installing Third-Party Utilities

You need an UNZIP utility to unpack the Directory Server software. There are many commercially licensed, free, and shareware tools available, such as PKZIP or Winzip. Note that shareware unregistered versions of PKZIP 2.70 maintain a TCP/IP connection to an Internet advertising service, and so may not be suitable for installation on this system.

You may need to install Adobe Acrobat Reader to read the documentation. It can be downloaded from this site: http://www.adobe.com/products/acrobat/readstep2.html

To edit the server configuration file, you will need a text editor that is capable of handling large text files (Notepad and Wordpad are not suitable). If you are already familiar with Emacs on UNIX, a port to Windows can be downloaded from ftp://ftp.cs.washington.edu/pub/ntemacs/. There are many other shareware and commercial text editors available.

To display non-English characters using any Netscape browser, you can obtain general internationalization advice and more specific information about the Bitstream Cyberbit font from the following URL:

http://developer.netscape.com/software/jdk/i18n.html

To download the Bitstream Cyberbit font use the following FTP link:

ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows

Before downloading the font, read the READMEfirst.txt and ReadMe.htm files.

Installing Microsoft Utilities

The following additional utilities are recommended to improve the security of the Windows NT Operating System. They are not required for the operation of the Directory Server.

If you have the Resource Kit CD-ROM produced by Microsoft Press, then copy the utility passprop.exe from the Windows NT Server Resource Kit onto the system. The utility is located on the CD in the i386\netadmin directory. You will need this later to enable Administrator account lockout.

At this point you will need to install Service Pack 4 or later, if not already installed. This is needed for the installation of Microsoft Internet Explorer 5. Service packs can be obtained from http://www.microsoft.com/windows/servicepacks/

You will need to install Microsoft Internet Explorer 5 or later, as this is needed by the Security Configuration Manager.

The Microsoft Security Configuration Manager is located on the Service Pack 6a CD-ROM, or can be downloaded from ftp://ftp.microsoft.com/bussys/winnt/winnt-public/tools/scm/. This tool is described in Microsoft Knowledge Base article Q195227.

Ensuring System Clock Accuracy

So that date and time stamps in log files can be correlated with those of other computer systems, the system clock should be kept reasonably in sync. As the NET TIME command requires NetBIOS, which will be disabled during post-installation system configuration, either a TCP/IP based NTP client should be installed (such as the shareware program Tardis) or a time radio receiver attached. See http://www.ntp.org/ for more information on NTP clients for Windows NT.

Installing Windows Service Packs and Hotfixes

Windows NT Service Packs include key fixes that are necessary to maintain the security and reliability of the operating system. The hotfix series contains important changes for problems that were found after the service pack was released.

Configuring the System Post Installation

The Windows environment will require tuning to provide optimum performance for Directory Server in an operational environment. Consult the Windows system administrator's documentation or support channel for information on NT tuning for multi-threaded internet services. The sections that follow provide some guidelines.

Windows 2000 Server and Advanced Server

This section covers the following:

Configuring a Machine to Run Directory Server

Directory Server should be installed on a computer that is isolated from the public Internet by a network-level firewall. This is necessary to protect the operating system from IP-based attacks.

No other network functions should be provided by this computer. The computer should not be a dual-booting system or run other operating systems. At a minimum, the computer system should have at least 256 MB of RAM, 16 B of disk, a Pentium II or later processor, and a 100 MBps Ethernet connection.

Ensure that you have sufficient disk space before downloading the software.

Download drive: 120 MB
Installation drive: 200 MB

Verifying Required System Modules

Directory Server is not supported on Windows 2000 Pro or Windows 2000 DataCenter Server.

Installing Windows 2000 Server

During the installation of Windows 2000, observe the following:

Installing Third-Party Utilities

You need an UNZIP utility to unpack the directory server software. There are many commercially licensed, free and shareware tools available, such as PKZIP or Winzip. Note that shareware unregistered versions of PKZIP 2.70 maintain a TCP/IP connection to an Internet advertising service, so it may not be suitable for installation on this system.

You may need Adobe Acrobat Reader to read the documentation. If you do not have it installed, you can download it from: http://www.adobe.com/products/acrobat/readstep2.html

To edit the server configuration file, you will need a text editor that is capable of handling large text files (Notepad and Wordpad are not suitable). If you are already familiar with Emacs text editor on UNIX, a port to Windows can be downloaded from ftp://ftp.cs.washington.edu/pub/ntemacs/. There are many other shareware and commercial text editors available.

To display non-English characters using any Netscape browser, you can obtain general internationalization advice and more specific information about the Bitstream Cyberbit font from the following URL:

http://developer.netscape.com/software/jdk/i18n.html

To download the Bitstream Cyberbit font use the following FTP link:

ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows

Before downloading the font, read the READMEfirst.txt and ReadMe.htm files.

Ensuring System Clock Accuracy

To facilitate the correlation of date and time stamps in log files with those of other computer systems, keep your system clock reasonably in sync. As the NET TIME command requires NetBIOS, which will be disabled during post-installation system configuration, either a TCP/IP based NTP client should be installed (such as the shareware program Tardis), or a time radio receiver attached. See http://www.ntp.org for more information on NTP clients for Windows.

Installing Windows Service Packs and Hotfixes

Windows 2000 Service Packs include key fixes which are needed to maintain the security and reliability of the operating system. The hotfix series contains important changes for problems discovered after the service pack had been released.

Configuring the System Post Installation

The Windows 2000 environment requires tuning to provide optimum performance for Directory Server in an operational environment. Consult the Windows 2000 system administrator's documentation or support channel for information on Windows 2000 tuning for multi-threaded internet services.

HP-UX 11.0 Operating System

This section contains the following information:

Verifying Disk Space Requirements

Ensure that you have sufficient disk space before downloading the software.

Download drive: 120 MB
Installation drive: 2 GB

Verifying Required System Modules

Directory Server is not supported on HP-UX 10 or earlier versions. The minimum system module required is HP-UX 11. Directory Server may be used on a 64 bit HP-UX 11 environment, but will run as a 32 bit process, and is limited to 1 GB of process memory.

For best results, Directory Server requires an HP 9000 architecture with a PA-RISC 1.1 or PA-RISC 2.0 CPU.

Installing Patches

Before you install Directory Server, ensure that the host system is updated with the latest patches recommended by the operating-system vendor. Because the list of recommended patches changes with time, you must always check the operating system vendor's site for a list of patches that you may need to install. Listed below are two URLs to aid you in this effort:

http://welcome.hp.com/country/us/eng/support.htm
http://www.hp.com/products1/unix/java/

Here are some recommendations:

Tuning the System

Set your kernel parameters as follows:

You also need to turn on large file support in order for Directory Server to work properly. To change an existing file system (from one that has no large files to one that accepts large files):

  1. Unmount the system using the umount command. For example:
  2. umount /export
     
  3. Create the large file system. For example:
  4. fsadm -F vxfs -o largefiles /dev/vg01/rexport
     
  5. Remount the file system. For example:
  6. /usr/sbin/mount -F vxfs -o largefiles /dev/vg01/export
     

For additional information and recommendations about setting these parameters, consult your operating-system documentation.

Installing Third-Party Utilities

You will need the gunzip utility to unpack the directory server software. The GNU gzip and gunzip programs are described in more detail at http://www.gnu.org/software/gzip/gzip.html and can be obtained from many software distribution sites.

You may need Adobe Acrobat Reader to read the documentation. If you do not have it installed, you can download it from: http://www.adobe.com/products/acrobat/readstep2.html

DNS and NIS Requirements (UNIX only)

Prior to installation, it is necessary to have configured the DNS resolver and NIS domain name.

The DNS resolver is typically set by the file /etc/resolv.conf. However, also check the file /etc/nsswitch.conf, and on Solaris /etc/netconfig, to ensure that the DNS resolver will be used for name resolution.

If you are not already using NIS, you will also need to set the default NIS domain name. Typically this is done by placing the NIS domain name in the file /etc/defaultdomain and rebooting or by using the domainname command.



Previous      Contents      Index      DocHome      Next     

© 2001 Sun Microsystems, Inc. Portions copyright 1999, 2002 Netscape Communications Corporation. All rights reserved.


Last Updated August 23, 2002