Configuring libtcl.cfg for LDAP

Use the libtcl.cfg files to specify an LDAP server name, port number, DIT base, user name, and password to connect to an LDAP server.

The default libtcl.cfg file is located in %SYBASE%|%SYBASE_OCS%\ini.

In its simplest form on 32-bit LDAP drivers, the libtcl.cfg file is in this format:

[DIRECTORY]
ldap=libsybdldap.dll

where ldapurl is defined as:

ldap://host:port/ditbase

For a 64-bit LDAP driver, the format is:

[DIRECTORY]
ldap=libsybdldap64.dll

You can use either a 32-bit or a 64-bit LDAP driver on Windows x64.

When an LDAP server is specified in the libtcl.cfg file and the libtcl64.cfg file (when applicable to your platform), the server information is accessible only from the LDAP server. Adaptive Server ignores the interfaces file. Open Client and Open Server applications that use the -i option at start-up override the libtcl.cfg file and use the interfaces file.

To use a directory service, you must:

1. Configure the libtcl.cfg file, and the libtcl64.cfg file (when applicable,) 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 the Configuration Guide for supported LDAP URL values.

   WARNING! You must enter the LDAP URL on a single line.

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

   For example:

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

   On Windows x64, the .dll file is called libsybdldap64.dll.

2. Verify that the appropriate environment variable points to the required third-party libraries. The Netscape LDAP SDK libraries are located in:

   • %SYBASE%\%SYBASE_OCS%\lib3p on 32-bit platforms

   • %SYBASE%\%SYBASE_OCS%\lib3p64 on Windows x64

   The Windows PATH environment variable must include this directory.

3. Once you have edited the libtcl.cfg file, use dsedit to add a server to the directory service:

   1. From the Windows task-bar, select Start | Programs | Sybase | Connectivity | Open Client Directory Service Editor.

   2. Select LDAP from the list of servers, and click OK.

   3. Click Add New Server Entry.

   4. Enter:

      • The server name – this is required.

      • Security mechanism – optional. A list of security mechanism OIDs are located in %SYBASE%\ini\objectid.dat.

      • HA server name – optional. This is the name of the high-availability failover server, if you have one.

   5. Click Add New Network Transport.

      • Select the transport type from the drop-down list.

      • Enter the host name.

      • Enter the port number.

   6. Click OK twice to exit the dsedit utility.

For more information, see the configuration guide for your platform.