4.3 Initializing the LDAP Directory

All system information (system structure, the configuration and deployment method for each Branch Server, available client images, and Point of Service terminal types) is stored in an LDAP directory on the Administration Server.

Novell Linux Point of Service can use the following LDAP directories: OpenLDAP, eDirectory™, or IBM Directory Services. The posInitLdap script defines the LDAP directory schema and the initial records for OpenLDAP. Likewise, the posInitEdir script defines the directory schema and the initial records required for eDirectory.

NOTE:To run the LDAP directory on IBM Directory Services, run posInitLdap, then import the /etc/opt/SLES/POS/template/ldif.pos file into IBM Tivoli* Directory Server.

The following sections review the procedure required to run posInitLdap or posInitEdir and verify the LDAP directory.

4.3.1 Running posInitLdap.sh

The posInitLdap script defines the LDAP directory schema and the initial records for OpenLDAP. It cannot add the Novell Linux Point of Service LDAP directory to an existing openLDAP tree; it creates an entirely new LDAP directory tree.

To create the Novell Linux Point of Service LDAP directory for OpenLDAP:

  1. After you have installed the Novell Linux Point of Service Administration Server, log in as root on the Administration Server.

  2. Run posInitLdap.sh.

  3. Specify your company name without spaces or special characters.

  4. Specify your country abbreviation.

    Use de for Germany, us for United States, uk for United Kingdom, and so forth.

  5. Specify the LDAP administrator password.

    NOTE:You are assigning the password for the LDAP directory administrator account. The Branch Server uses this account to access the LDAP directory and this account is required to use posAdmin to add objects to the LDAP directory.

  6. Determine if you want to use SSL when the Branch Server connects to the LDAP directory on the Administration Server.

    • Select Y to use an SSL connection when the Branch Server connects to the LDAP Directory.
    • Select N to disable SSL.

    posInitLdap creates the certificates and keys required to run SSL regardless of whether or not SSL is enabled. This allows you to switch to SSL at a later time if desired.

    NOTE:The keys and certificates are located in the /etc/opt/SLES/POS/keys/ directory on both the Administration and Branch Servers.

  7. posInitLdap provides a summary of the LDAP directory data based on your input. If all data is correct, press Enter.

    If there is something wrong with the input data, abort the installation by pressing Ctrl+C.

  8. The script initializes the basic LDAP database structure and performs some tests, then displays a summary of the configuration and test results. When the tests are successfully completed, the script displays a success message. To complete the initialization, press Enter.

4.3.2 Running posInitEdir.sh

The posInitEdir script defines the LDAP directory schema and the initial records for eDirectory. It cannot add the Novell Linux Point of Service LDAP directory to an existing eDirectory tree; it creates an entirely new tree.

To create the Novell Linux Point of Service LDAP directory for eDirectory:

  1. After you have installed the Novell Linux Point of Service Administration Server, log in as root on the Administration Server.

  2. Install eDirectory on the Administration Server.

  3. Run posInitEdir.sh.

  4. Specify the eDirectory tree name you want to create.

    IMPORTANT:posInitEdir does not add to an existing eDirectory tree.

  5. Specify your company name without spaces or special characters.

  6. Specify your country abbreviation.

    Use de for Germany, uk for United Kingdom, us for United States, and so forth.

  7. Specify the LDAP administrator password.

    NOTE:This password is for the account the Branch Server uses to access the LDAP directory.

  8. posInitEdir provides a summary of the LDAP directory data based on your input. If all data is correct, press Enter.

    If there is something wrong with the input data, abort the installation by pressing Ctrl+C.

  9. The script initializes the basic LDAP database structure and performs some tests, then displays a summary of the configuration and test results. When the tests are successfully completed, the script displays a success message. To complete the initialization, press Enter.

4.3.3 Verifying the LDAP Directory

After you run posInitLdap or posInitEdir, the LDAP directory has been initialized on the Administration Server and the LDAP service is available. At this point, you should have a basic tree structure with a root, a Country container, and an Organization container.

You can verify that the LDAP structure is accessible using a GUI-based LDAP browser, such as GQ, or an ldapsearch command. Table 4-2 lists the parameters required to access the LDAP directory using GQ.

Table 4-2 Parameters for accessing the LDAP directory with GQ

Parameter

Value

LDAP Host

IP address of the Administration Server

LDAP Port

Port assigned to LDAP; for example, 389

Base DN

Distinguished name of the base container; for example, o=mycorp,c=us

Bind DN

Distinguished name of the administrative user; for example, cn=admin,o=mycorp,c=us

Bind Password

LDAP administrator password defined when you ran posInitLdap or posInitEdir.

Before you create a Branch Server, you must use the posAdmin command to create the LDAP objects required to configure the Branch Server and boot its Point of Service terminals. For detailed instructions on creating these objects, see Section 6.2, Creating Branch Server Objects in LDAP.