Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP CIFS Server 3.0g Administrator's Guide version A.02.03.01: HP-UX 11i v1, v2 and v3 > Chapter 6 LDAP Integration Support

Configuring the LDAP-UX Client Services

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

You need to configure the LDAP-UX Client Services if it is not already configured. This section describes major steps to configure LDAP-UX Client Services with the Netscape Directory Server 6.11/6.21 or Red Hat Directory Server 7.0/7.1. For detailed information on how to configure the LDAP-UX Client Services, see the "Configure the LDAP-UX Client Services" section of LDAP-UX Client Services Administrator's Guide at http://www.docs.hp.com.

You must run the setup program to configure the LDAP-UX Client Services. This requirement must not be skipped. Otherwise, the HP CIFS Server with LDAP support will not work properly.

When you run the setup program to configure the LDAP-UX Client Services on a client system, setup does the following major tasks for you:

  • Extends your directory schema with posixAccount objectclass and attributes, if not already done.

  • Creates a configuration profile entry in your Netscape Directory from information you provide. The profile contains the information required by clients to access user and group data in the directory, for example:

    • Your directory server host

    • Your directory server network port

    • Location of your user, group and other information in the directory

  • Updates the startup file of the local client with your directory and configuration profile location.

  • Downloads the configuration profile from the directory to the LDAP client system.

  • Assigns your base DN as your LDAP suffix for user and group searches.

  • Starts the product daemon, ldapclientd, if you choose to start it. For LDAP-UX Client B.03.20, you must start the client daemon for LDAP-UX functions to work.

Quick Configuration

You can quickly configure the LDAP-UX Client Services by selecting the default value for most of the configuration parameters as follows:

  1. To be consistent with the Samba organizational unit defaults, you must edit the /opt/ldapux/migrate/migrate_common.ph file to change the default group objectclass under $RFC2307BI structure from ou=Group to ou=Groups.

  2. Log in as root and run the setup program:

    $ cd /opt/ldapux/config
    $ ./setup

    The setup program asks you a series of questions and usually provides default answers. Press the Enter key to accept the default, or change the value and press Enter. At any point during setup, press Control+b to back up or Control+c to exit the setup program.

  3. Choose Netscape/Red Hat Directory as your LDAP directory server (option 1).

  4. Enter either the host name or IP address of the directory server where your profile exists, or where you want to create a new profile.

  5. Enter the port number of the previously specified directory server that you want to store the profile. The default port number is 389.

    Setup checks the directory to see if the schema has been extended with the posixAccount objectclass and attributes. This must be done, but only needs to be done once.

  6. If the schema has already been extended, setup skips this step. Otherwise, to extend the schema, enter the Distinguished Name (DN) and password of the directory user who can extend the directory schema. For example, you can enter "Directory Manager " as the directory manager DN and password of the directory manager.

    To extend the schema, you are prompted for the following input:

    1. Enter the DN of the directory user. The default value is displayed. To use the default, press the Enter key; otherwise, enter you DN name.

    2. Enter the password.

  7. If you are creating a new profile, add all parent entries of the profile DN to the directory (if any). If you attempt to create a new profile and any parent entries of the profile do not already exist in the directory, setup will fail. For example, if your profile will be cn=ldapuxprofile, dc=org, dc=hp, dc=com, then the base path, org.hp.com,must exist in the directory or setup will fail.

  8. Next enter either the DN of a new profile, or the DN of an existing profile you want to use.

    If you are using an existing profile, setup configures your client, downloads the profile, and exits. In this case, continue with step 11 below.

  9. If you are creating a new profile, enter the directory manager DN and password of the directory user who can create a new profile.

  10. Next enter the host name and port number of the directory where you want to store your name service data. For high availability, each LDAP-UX client can look for name service data in up to three different directory hosts. You can enter up to three hosts, to be searched in order.

  11. Enter the base DN where clients should search for user name service data like passwd, group, hosts, services, etc.

  12. You can quickly configure a directory server and the first client by accepting the remaining default configuration parameters when prompted.

    Table 6-1 “Configuration Parameters and Default Values” shows the configuration parameters and the default values that they will be configured with.

    Table 6-1 Configuration Parameters and Default Values

    Parameter

    Default Value

    Type of client binding

    Anonymous

    Bind time limit5 seconds
    Search time limitno limit
    Use of referralsYes
    Profile TTL (Time To Live)0 - infinite
    Use standard RFC-2307 object class attributes for supported servicesYes
    Use default search descriptions for supported servicesYes

    Authentication method

    Simple

     

    For the detailed configuration parameters information listed in the table 6-1, see "Appendix B: LDAP-UX Client Services Object Classes" of LDAP-UX Client Services B.03.20 Administrator's Guide at http://www.docs.hp.com.

  13. After entering all the configuration information, setup extends the schema, creates a new profile, and configures the client to use the directory.

  14. Configure the Name Service Switch (NSS).

    Save a copy of the /etc/nsswitch.conf file and edit the original to specify the ldap name service and other name services you want to use. See the /etc/nsswitch.ldap file for a sample. You may be able to just copy /etc/nsswitch.ldap to /etc/nsswitch.conf. See nsswitch.conf(4) for more information.

  15. You will be asked whether or not you want to start the client daemon, /opt/ldapux/bin/ldapclientd. You must start the client daemon for LDAP functions to work.

  16. Run the following command to verify your configuration:

    $ /opt/ldapux/bin/ldapsearch -T -b "cn=schema" -s base \ 
    "(objectclass=*)"|grep -i posix

    Ensure that the posixAccount objectclass is displayed in the output when you run the ldapsearch command. The output is as follows:

    objectClasses: ( 1.3.6.1.1.1.2.0 NAME 'posixAccount' DESC 'Standard LDAP objectclass' SUP top AUXILIARY MUST ( cn $ uid $ uidNumber $ gidNumber $ homeDirectory) MAY ( userPassword $ loginShell $ gecos $ description ) X-ORIGIN 'RFC 2307' )

    objectClasses: ( 1.3.6.1.1.1.2.2 NAME 'posixGroup' DESC 'Standard LDAP objectclass' SUP top STRUCTURAL MUST ( cn $ gidNumber ) MAY ( userPassword $ memberUid $description ) X-ORIGIN 'RFC 2307' )

    NOTE: You can use the ldapsearch command-line utility to locate and retrieve LDAP directory entries. This utility opens a connection to the specified server using the specified Distinguished Name (DN) and password, and locates entries based on the specified search filter. For details, see the Netscape Directory Server Administrator's Guide or the Red Hat Directory Server Administrator's Guide available at http://www.docs.hp.com/en/internet.html.
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2007 Hewlett-Packard Development Company, L.P.