Complete Contents
Introduction
Chapter 1 Preparing for Installation
Chapter 2 Installing Netscape Messaging Server 4.1
Chapter 3 Ugrading an Existing Installation
Appendix A Installing a 3.x Directory Server
Index
Messaging Server Installation Guide: Installing a 3.x Directory Server
Previous Contents Index


Appendix A Installing a 3.x Directory Server

This appendix provides a basic outline of the Directory Server 3.x installation process. For additional instructions on Directory Server installation and further configuration options refer to the following documents:

For detailed instructions on how to perform more complex installations, refer to the Directory Server Installation Guide.

Note. If you do not have Directory Server 3.x installed, Netscape strongly recommends that you install Directory Server 4.0 which is included as part of the Messaging Server 4.1 installation program.


Before You Begin Installing a 3.x Directory
As part of the Directory Server 3.x installation process, you must specify the SuiteSpot user and group. The default user and group is nobody because they are assumed to exist on all Unix systems. Netscape recommends, however, that you create a special user and group for this purpose rather than accepting the default. To specify a non-default user and group, you need to create the user and group before beginning the installation process.


Installation Steps Directory Server 3.x
Use the following steps as a general guideline for installing Netscape Directory Server 3.x:

  1. Login as root (Unix) or administrator (Windows NT).
  2. If you have not already done so, transfer the Directory Server installation archive to an installation directory on the machine that is to host the Directory Server.
  3. Go to the installation directory.
  4. For example: root# cd /tmp/ds3install

  5. Unpack the Directory Server archive.
  6. On Windows NT:

    Unzip the product archive file or run the self-extracting exe file if it is included as part of your installation package.

  7. Run the Directory Server setup program.
  8. You are asked if you agree to the license terms. You must enter yes (or simply y) to proceed.
  9. Enter Directory Server installation information as prompted by the ns-setup program.
  10. Be sure to write down the values that you enter. You will use these values again in the Messaging Server installation process.

    Default values are shown enclosed in square brackets. To accept the default value, press Enter or type in an alternative value.

    Server root [/usr/netscape/suitespot]

    This is the server-root directory into which Directory Server will be installed. If you are installing Directory Server 3.x on the same machine as the Administration Server and Messaging Server (which is not recommended), you must install the Directory Server in a server-root directory that is different from the server-root directory used for the Messaging and Administration servers. The directory you specify here is the value referred to as the server-root throughout the rest of these installation instructions.

    Machine's name [default]

    This is the fully qualified host name of the Directory Server machine. For example, dirsrv4.airius.com.

    SuiteSpot User [nobody]

    This is the default user ID under which servers are to be run. Netscape recommends that instead of accepting the proposed default that you create a special user and group for running Netscape servers.

    The SuiteSpot user must already exist before you enter that user ID here. See SuiteSpot User and Group for additional information.

    SuiteSpot Group [nobody]

    This is the default group which will own files shared by various servers. The SuiteSpot group must already exist before you enter it here. See SuiteSpot User and Group for additional information.

    At this point, files are extracted.

    Administration port [nnnn]

    This is the port the Administration server is to access. It must be unique port that is not used by any other application. You can choose any port between the numbers 1024 and 65535.

    Run Administration Server as [root]

    This is the user ID under which the Administration Server is to run. Netscape recommends that you accept root. These instructions assume that you are using root. See Administration Server User for additional information.

    Enter path to 2.x version of Netscape Administration Server root: [/usr/ns-home]

    This prompt asks if you have a Directory Server version 2.x instance that you wish to upgrade to this 3.x version. If you do not have a 2.x Directory Server, accept the default and proceed. If you do have a 2.x server, enter the path to the 2.x installation.

    Server Administrator ID [admin]
    Password:
    Password (again):

    This user is to have administration privileges on the Administration Server. For 3.x servers this is the Suitespot Administrator, for 4.x it is the Configuration Administrator. The default for both is admin, but you are free to select any user ID you wish. This user ID has to already exist. See Suitespot Administrator or Configuration Server Administrator for additional information.

    At this point the installation process starts up the Directory Server. Status messages are displayed.

  11. Press a key to continue.
  12. The URL for administering the Directory Server through a web browser is reported.

  13. At the Web browser prompt, accept the default or enter the command line name of the browser you will use to configure the servers.
  14. The installation procedure then loads the browser and the appropriate URL. (If you will be using a web browser from a Windows or Macintosh computer or a remote system, enter none here and then manually launch the browser and go to the URL reported above by the installation program.)

  15. Choose Create New Netscape Directory Server.
  16. Use your browser to fill in the information at the web page prompts to create the server instance.
  17. Server Name

    This is the hostname of the machine on which the Directory Server is running. For example, dirsrv4.airius.com

    Server Port

    This is the port that the server instance is to use. The port you select cannot be used by any other application on this machine. The default is 389.

    Server Identifier

    This is a unique name that identifies the server instance. By default this is the machine name without the domain name (such as dirsrv1), but it can be any name you choose. If you have more than one instance on the same machine, each must have a different identifier.

    Server User Name

    This is the user ID for the account under which the Directory Server is to run. You can leave this blank, in which case it will run as root.

    SuiteSpot Administrator's ID [admin]
    Password:
    Password (again):

    This is the administrator for all 3.x servers. This prompt is only used to configure this Directory Server instance for SuiteSpot 3.x.

    Directory Suffix

    This is the root of an LDAP tree under which your directory information is stored. The default is o=airius.com, but you should change this to the suffix you use for your directory root.

    Unrestricted User

    Password:

    Password (again):

    This is the Directory Manager. The default is cn=Directory Manager. See Directory Manager for additional information.

  18. Choose OK. You can also use this web page for additional Directory Server tasks as needed.
  19. You must configure the Directory Server for the Administration and Messaging Server 4.1 installation after you have transferred the Messaging Server installation files. The dssetup utility is provided for this purpose. See Configuring a 3.x Directory Server for details.
 

© Copyright 1999 Netscape Communications Corp., a subsidiary of America Online, Inc. All rights reserved.