IBM Directory Server Version 4.1 QuickStart

Note

Before using this information and the product it supports, read the general information under Appendix A, Notices.

First Edition (April 2002)

This edition applies to version 4, release 1, of The IBM Directory and to all subsequent releases and modifications until otherwise indicated in new editions.

(C) Copyright International Business Machines Corporation 1998, 2002. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Preface

This document describes how to install IBM(R) Directory version 4.1 through the InstallShield GUI, for the following platforms:

To install IBM Directory on Linux 390, TurboLinux 6.5, or Hewlett-Packard platforms, see the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.

IBM Directory version 4.1 requires any platform to have a minimum 256MB memory.

This document is not intended to be used in a Network Information Service (NIS) environment.

This document is not intended to be used on an RS/6000(R) SP(TM) environment node. See the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms for more information.

This document is not intended to be used in an HACMP environment.

If you have a previous version of IBM Directory installed, do not use this document. See the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.

Contents

Preface

Installing using InstallShield GUI

  • Installing IBM Directory version 4.1 on a Windows NT and Windows 2000 platform
  • Installing IBM Directory version 4.1 on a UNIX-based platform

    • IBM Directory Configuration (ldapxcfg)

  • Setting the IBM Directory administrator DN and password
  • Configuring a directory database
  • Configuring a Web server

    • Loading a sample database

    Troubleshooting

    Appendix A. Notices

  • Trademarks

    • Index

    Installing using InstallShield GUI

    InstallShield GUI has two installation options: Typical and Custom. This QuickStart focuses on the Typical installation. For the Custom installation, see the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.

    Typical installation uses default settings.

    Note:
    Windows NT and Windows 2000 platforms are installed and configured when the InstallShield GUI is used. All other platforms must use the configuration tool, ldapxcfg, for configuration after installation. See IBM Directory Configuration (ldapxcfg) for more information.
    Note:
    On UNIX(R) systems, you must be logged in as root. On Windows NT and Windows 2000 systems, you must be logged on as an Administrator ID.
    Note:
    If you install IBM Directory version 4.1 and its components using InstallShield GUI, you must uninstall IBM Directory, if necessary, using the InstallShield GUI. See the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms for more information.

    Installing IBM Directory version 4.1 on a Windows NT and Windows 2000 platform

    Windows 2000 Service Pack 2 users must perform the following before installation:

    1. Go to Start->Run... and type secpol.msc.
    2. Double-click Local Policies.
    3. Double-click User Rights Assignments.

    At this point, a list of policies is displayed. The user needs to add the Administrator group to the following policies:

    Do the following to add the Administrator group to these policies:

    1. Right-click on the appropriate policy, and click Security....
    2. Click Add... in the new window.
    3. Select the Administrators group in the scrollbox, then click Add....
    4. Click OK.
    5. Click OK again to exit.

    Repeat these procedures for each of the three previous policies. When finished, restart your computer.

    To begin installing IBM Directory version 4.1 on a Windows NT and Windows 2000 platform:

    1. Insert the CD in your CD-ROM drive. If the installer does not automatically start, click Start->Run. Depending on whether you are installing locally from a CD or remotely from the network, select the drive for your CD-ROM or for the appropriate network path and then select the package you want to install, for example, SSL-enabled or non-SSL-enabled. Double-click the Setup.exe icon. The Language panel is displayed.
      Note:
      This is the language used in the installation wizard, not in the IBM Directory. You choose the language used in the IBM Directory in step 6.
    2. Select the language you want to use during IBM Directory installation. Click OK.

      Note:
      If a previous version of IBM Directory is installed on your system, see "Migration" in the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.
    3. To continue with the installation, click Next.
    4. After reading the Software license, click I accept the terms in the license agreement. Click Next.
    5. Any previously installed components and corresponding version levels are displayed. Click Next.
    6. Select the language you want to use in IBM Directory 4.1. Click Next.
    7. To install to the default directory, click Next.
    8. Select Typical installation. Click Next.
    9. The following list displays:

      Select the features you want to install. Click Next.

      Note:
      If you select to install the Server, you must select to install both the Client and the DMT.
    10. If you selected Server 4.1 in step 9, continue here. If you did not select Server 4.1 in step 9, go to step 12.

      Do one of the following only:

      Enter a distinguished name and password. The default distinguished name is cn=root. Enter the password again to confirm.

      Note:
      Record this password for future reference.
      Note:
      The IBM Directory administrator DN must contain cn= as part of the DN.
      The IBM Directory administrator DN is the DN used by the directory's administrator.
    11. Enter a Windows user ID and password for the DB2(R) system ID. If you are using an existing Windows user ID, be sure your password is correct. The user ID default is db2admin. Type the password. Type the password again to confirm.
      Note:
      This panel does not appear if you already have a supported version of DB2 on your machine.
      Note:
      If you have an existing Windows user ID for the DB2 system ID, you must enter the correct password for the ID here in order to install the DB2 correctly.
    12. Click Next. A screen summarizing the components selected for installation and configuration is displayed. If you wish to change any of your selections, click Back. To begin installation, click Next.
      Note:
      Any corequisite products needed by IBM Directory, such as DB2 or a Web server, are automatically installed. These products are listed in the summary described in this step.
    13. After the files are installed, the Client README opens. If you installed the server, the Server README is also available. Click Next from the Client README to open the Server README. Click Next.
    14. The reboot panel is displayed. You can select to reboot now or later. Click Next.
    15. Click Finish. If in the previous step you selected to reboot your computer now, the computer starts the reboot immediately.
      Note:
      You must restart your system to complete the IBM Directory configuration and to create the DB2 database. You are unable to use the IBM Directory product until this is completed. During the restart, the configuration panel is displayed.
    16. You have completed a Typical installation and configuration.
    17. Verify the installation configuration of the IBM Directory server. See Loading a sample database.

    Installing IBM Directory version 4.1 on a UNIX-based platform

    To begin installing IBM Directory 4.1 on a UNIX-based platform:

    1. Go to the root directory on your CD. Invoke setup. The Language panel is displayed.
      Note:
      This is the language used in the installation wizard, not in the IBM Directory. You choose the language used in the IBM Directory in step 6.
    2. Select the language you want to use during IBM Directory installation. Click OK.

      Note:
      If a previous version of IBM Directory is installed on your system, see "Migration" in the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.
    3. To continue with the installation, click Next.
    4. After reading the Software license, click I accept the terms in the license agreement. Click Next.
    5. Any preinstalled components and corresponding version levels are displayed. Click Next.
    6. Select the language you want to use in IBM Directory 4.1. Click Next.
    7. Select Typical installation. Click Next.
    8. The following list displays:

      Select the features you want to install. Click Next

      Note:
      If you select to install the Server, you must select to install both the Client and the DMT.
    9. A screen summarizing the components selected for installation and configuration is displayed. If you wish to change any of your selections, click Back. To begin installation, click Next.
      Note:
      Any corequisite products needed by IBM Directory, such as DB2 or a Web server, are automatically installed. These products are listed in the summary described in this step.
    10. After the files are installed, the Client README opens. If you installed the server, the Server README is also available. Click Next from the Client README to open the Server README.
    11. Click Finish.
    12. You have completed a Typical installation. To configure the IBM Directory, see IBM Directory Configuration (ldapxcfg).

    IBM Directory Configuration (ldapxcfg)

    This configuration utility is not necessary if you are installing IBM Directory version 4.1 on a Windows NT and Windows 2000 system. The InstallShield GUI configures the IBM Directory for Windows NT and Windows 2000.

    Note:
    You can reconfigure IBM Directory for Windows NT and Windows 2000 using the ldapxcfg utility, if necessary.

    Configuration of an IBM Directory consists of setting the IBM Directory administrator DN, configuring a database, and configuring a Web server for IBM Directory.

    Setting the IBM Directory administrator DN and password

    To set the IBM Directory administrator DN and password:

    1. Select Set the directory administrator name and password, and then click Next.
      Note:
      The IBM Directory administrator DN must contain cn= as part of the DN.
    2. Type the IBM Directory administrator DN (or accept the default DN), type in a password, and retype to confirm the password.
      Note:
      Record this password for future reference.
    3. Click Next.
    4. Review the Configuration Summary panel, and then click Configure.
    5. The Configuration Completion panel is displayed. Click OK.

    Configuring a directory database

    To configure a directory database:

    1. Select Create the directory DB2 database. Click Next.
    2. Select Create a default directory DB2 database or Use my own DB2 database (this selection is also referred to as a custom database). For information on creating a custom database, see "Appendix C. Creating a database manually" in the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms. The default directory selections are recommended.
    3. Click Next.
    4. For the default database selections: If prompted, select Create a Universal DB2 database (UTF-8) to create the database in the Universal Character Set, or select Create a local codepage DB2 database to create the database in the local codepage. You can also select Create a database for Change Log support to enable the change log.
    5. If prompted, specify the directory where you want the database to reside, or accept the default directory. Click Next.
      Note:
      Select a drive with at least 80 MB of free space.
    6. If you selected Use my own DB2 database, fill in the four required fields. Click Next.
    7. The Configuration Completion panel is displayed. Click OK.

    Configuring a Web server

    To configure a Web server:

    1. Ensure that the Web server is installed.
    2. Select Configure a web server for directory server administration.
    3. Click Next.
    4. Choose the appropriate Web server.
    5. Click Next.
    6. If prompted, enter the full pathname of the Web server configuration file.
      Note:
      Make note of the pathname of the Web server configuration file.
      Click Next.
    7. Review the Configuration Summary panel, and then click Configure.
    8. The Configuration Completion panel is displayed. Make note of the administration Web address, and then click OK.
    9. Stop the Web server. Restart the Web server. For more information on this, see the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.
    10. Verify the installation configuration of the IBM Directory server. See Loading a sample database.

    Loading a sample database

    The following information enables you to load a sample database and start the IBM Directory server.

    Note:
    This information does not apply to Linux platforms or HP platforms. To install a sample database on a Linux platform or on an HP platform, see the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.
    1. Using a Web browser, connect to http://hostname/ldap, then log on as the IBM Directory administrator DN.
      Note:
      hostname is the name of the machine you installed the IBM Directory on.
      Note:
      Some Web servers might require you to specify index.html in the Web address. If you are unable to get to the Server Administration tool with http://hostname:portnumber/ldap, try http://hostname:portnumber/ldap/index.html. The default port number is 80.
    2. You are presented with the IBM Directory Server Administration panel.
    3. Enter your IBM Directory administrator ID.
    4. Click Logon.
    5. Click Settings in the left navigation bar. Click Suffixes.
    6. Enter a Suffix DN.
      Note:
      You must enter o=ibm,c=us.
    7. Click Update.
    8. Click Database in the left navigation bar. Click Import LDIF.
    9. Verify that Path and file name is the correct path where you installed IBM Directory. The path name must specify sample.ldif.
    10. Click Import. If successful, you receive the following message in Completed task messages:

      x entries have been successfully added out of x attempted.

    11. Click Current State.
    12. Click Start/Stop.
    13. Click Start. You see the following message:

      The directory server is running.

    You have verified that the sample database is loaded correctly, and that the installation is successful.

    Troubleshooting

    If you are having problems installing or configuring the IBM Directory version 4.1 product, refer to the IBM Directory Server Version 4.1 Installation and Configuration Guide for Multiplatforms.

    Appendix A. Notices

    This information was developed for products and services offered in the U.S.A. IBM might not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

    IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

    IBM Director of Licensing
    IBM Corporation
    North Castle Drive
    Armonk, NY 10504-1785
    U.S.A.

    For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

    IBM World Trade Asia Corporation Licensing
    2-31 Roppongi 3-chome, Minato-ku
    Tokyo 106, Japan

    The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

    This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information at any time without notice.

    Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

    IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

    Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

    IBM Corporation
    Department LZKS
    11400 Burnet Road
    Austin, TX 78758
    U.S.A.

    Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

    The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

    Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

    Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

    All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

    All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

    Trademarks

    The following terms are trademarks of International Business Machines Corporation in the United States, or other countries, or both:

    IBM DB2 RS/6000 SP

    Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

    Windows, Windows 2000 and Windows NT are registered trademarks of Microsoft Corporation.

    UNIX is a registered trademark of The Open Group in the United States and other countries.

    Other company, product, and service names may be trademarks or service marks of others.

    Index

    C D I L S T U W