Enabling LDAP directory services

LDAP is only supported with reentrant libraries. You must use isql_r, instead of isql, when connecting to a server using LDAP directory services.

Using a directory service

Configure the LDAP server according to the vendor-supplied documentation.

Add the path environment variable to the LDAP library for your platform, for example:
```
setenv LD_LIBRARY_PATH \
$LD_LIBRARY_PATH:$SYBASE/$SYBASE_OCS/lib3p
```
See Table 5-5 for a list of environment variables and libraries for your platform.

Configure the libtcl*.cfg file to use directory services.

Use any standard ASCII text editor to:

Remove the semicolon (;) comment markers from the beginning of the LDAP URL lines in the libtcl*.cfg file under the [DIRECTORY] entry.
Add the LDAP URL under the [DIRECTORY] entry. See Table 5-2 for supported LDAP URL values.

The LDAP URL must be on a single line.

Following is the context for this entry:

ldap=libsybdldap.so
ldap://host.port/ditbase??scope??
bindname=username?password

For example:

[DIRECTORY]
ldap=libsybdldap.so ldap://huey:11389/dc=sybase,dc=com??one??
bindname=cn=Manager,dc=sybase,dc=com?secret

where “one” indicates the scope of a search that retrieves entries one level below the DIT base.

For 64-bit support, replace lib3p with lib3p64 and libsybdldap.so with libsybdldap64.so for the above examples.

For information on the supported platforms, see Chapter 2, “OpenLDAP,” in the Open Client Client-Library/C Reference Manual.

Table 5-4 defines the keywords for the ldapurl variables.

**Table 5-4: ldapurl variables**
Keyword	Description	Default	CS_* property
host (required)	The host name or IP address of the machine running the LDAP server	None
port	The port number on which the LDAP server is listening	389
ditbase (required)	The default DIT base	None	CS_DS_DITBASE
username	Distinguished name (DN) of the user to authenticate	NULL (anonymous authentication)	CS_DS_PRINCIPAL
password	Password of the user to be authenticated	NULL (anonymous authentication)	CS_DS_PASSWORD

Verify that the appropriate environment variable points to the required third-party libraries. Table 5-5 lists the location of the Netscape LDAP SDK libraries.

**Table 5-5: Environment variables**
Platform	Environment variable	Library location
HP HP-UX Itanium 32-bit	SHLIB_PATH	$SYBASE/$SYBASE_OCS/lib3p
HP HP-UX Itanium 64-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p64
HP HP-UX PA-RISC 32-bit	SHLIB_PATH	$SYBASE/$SYBASE_OCS/lib3p
HP HP-UX PA-RISC 64-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p64
Linux x86 32-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p
Linux x86-64 64-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p64
Linux POWER 32-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p
Linux POWER 64-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p64
IBM AIX POWER 32-bit	LIBPATH	$SYBASE/$SYBASE_OCS/lib3p
IBM AIX POWER 64-bit	LIBPATH	$SYBASE/$SYBASE_OCS/lib3p64
Sun Solaris x86-64 32-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p
Sun Solaris x86-64 64-bit	LD_LIBRARY_PATH_64	$SYBASE/$SYBASE_OCS/lib3p64
Sun Solaris SPARC 32-bit	LD_LIBRARY_PATH	$SYBASE/$SYBASE_OCS/lib3p
Sun Solaris SPARC 64-bit	LD_LIBRARY_PATH_64	$SYBASE/$SYBASE_OCS/lib3p64

Add your server entry to the LDAP server using dscp or dsedit. See “Adding and modifying server entries”, and “Adding a server to the directory services”.