LDAP-UX Client Services B.04.10 with Microsoft Windows Active Directory Server Administrator's Guide

Environment Variables
The ldapschema utility supports the following environment variables:
LDAP_BINDDN
The Distinguished Name (DN) of an administrator who has permissions to
read and modify LDAP directory server schema.
LDAP_BINCRED
The password for the privileged LDAP directory user.
LDAP_HOST The host name of the LDAP directory server. The LDAP_HOST variable uses
the “hostname:port” format. If the port is not specified, default port number
is 389 for regular connections, or 636 for SSL connections.
Options specified on the command line override the values in environment variables. For example,
if the -j /tmp/secret.txt option is specified on the command line, and the LDAP_BINDCRED
environmental variable is set, the password of the LDAP directory server administrator is obtained
from the /tmp/secret.txt file.
Examples
This section describes examples using the ldapschema tool.
An Example for Querying the Schema Status
The following command queries the status of RFC 2307 schema on Windows 2003 Active Directory
Server, ldaphost:
ldapschema –q /etc/opt/ldapux/schema/rfc2307.xml -h ldaphost –T ads
–V 2003
The LDAP directory server version number bears no effect unless also specified in the XML files
being processed. Version specification must follow the same format as version specification used
in the /etc/opt/ldapux/schema/rfc2307.xml and /etc/opt/ldapux/map-rules.xml
files.
An Example for Extending the New Schema into the Directory Server
The following procedures are used to extend Windows 2003 Active Directory Server, ldaphost,
with custom Sample schema:
1. Create the schema definition file, /etc/opt/ldapux/schema/sample.xml, which
contains attribute type and object class definitions for the Sample schema.
2. This step is recommended. Query the current status of the Sample schema on the server by
running the following command:
ldapschema –q /etc/opt/ldapux/schema/sample.xml -h ldaphost
–T ads –V 2003 -D "<binddn>" -j /tmp/secret.txt
The directory manager password can be specified at the prompt (-w- option) or in a file (-j
<password_file>).
3. Based on the results produced by Step 2, correct any invalid definitions.
4. Extend the Active Directory Server schema with new Sample schema elements by executing
the following command:
ldapschema –e /etc/opt/ldapux/schema/sample.xml -h ldaphost
–T ads –V 2003 -D "<binddn>" -j /tmp/secret.txt
The LDAP directory server version number bears no effect unless also specified in the XML files
being processed. Version specification must follow the same format as version specification used
in the /etc/opt/ldapux/schema/sample.xml,
/etc/opt/ldapux/schema/schema-ads.xml, and
/etc/opt/ldapux/schema/map-rules.xml files.
Schema Extension Utility 163