Service Response Monitor › Test Management › Create Tests › LDAP Tests

LDAP Tests

The LDAP test monitors the amount of time required to connect to the LDAP service on a Windows system, perform a standard user name/password authentication, and then perform a user-defined query.

Options and Arguments

LDAP tests require the following specific options and arguments:

• Domain in which the LDAP Server is located. The hostname or IP address of the LDAP server that you are testing.

  Note: IPv6 addresses can be used, but they must be embedded in brackets, for example [0aff::230:6eff:fe4b:51db]:8080. Here 0aff::230:6eff:fe4b:51db represents the IPv6 address and 8080 represents the port number.

• LDAP Domain. (Optional) The domain in which the LDAP server is located.
• LDAP Port. (Optional) The port on which the LDAP service is running. The default is port 389.
• User Name. (Optional) A valid user name for the LDAP server.
• Password. (Optional) A password for the user name specified. SRM stores the password in encrypted form.
• Query. An LDAP query to perform. For information about the LDAP query language, refer to your LDAP documentation.
• Filter. (Optional) A parameter on which to filter the results of your query.

Specify these options and arguments when you create or modify tests.

Examples

This section includes examples for monitoring the amount of time to connect to a local LDAP server and a remote LDAP server.

Example 1: Testing a Local LDAP Server

Use this example to create a test that monitors the amount of time to connect to the local LDAP server named arch, authenticate the user name ldapUser and the encoded password, and then query for the term annuity.

To create a new test in a policy

1. Click + (New) on the Test Monitors toolbar.

   The New test pane appears.

2. From the Test Type list, select LDAP.
3. In the Description field, specify ldap_arch.
4. In the Test Name field, specify Local LDAP Test.
5. In the Test Interval field, specify 30.
6. In the Test Timeout field, specify 10.
7. In the Samples Per Interval field, specify 1.
8. In the Statistics Window field, specify 120.
9. In the LDAP Server field, specify arch.
10. In the LDAP Domain field, specify TEST.
11. In the User Name field, specify ldapUser.
12. In the Password field, specify ldapPassword.
13. In the Query field, specify cn=annuity,ou=Boston,dc=fleet,dc=com.
14. In the Filter field, specify cn=*.
15. Click Save Test.

When you commit your changes, SRM adds an entry similar to the following to the svcrsp.cf file:

{ 
index=11 
type=ldap
desc="LDAP-TEST" 
dest="arch" 
username="ldapUser" 
encoded=yes 
password="Z28ySGVsbA" 
args="query=cn=annuity,ou=Boston,dc=fleet,dc=com&domain=Test&filter=cn=*" 
interval=30 
samples=1 
timeout=10 
window=120 
tos=0 
limit=0 
status=active 
name="Local LDAP Test"
class=""
context=""
flags="1"
loglevel=1
}

Example 2: Testing a Remote LDAP Server

Use this example to create a test that monitors the amount of time to connect to the remote LDAP server at 10.0.0.123, authenticate the user name ldapRUser and the encoded password, and then query for the term Guest Users.

To create a new test in a policy

1. Click + (New) on the Test Monitors toolbar.

   The New test pane appears.

2. From the Test Type list, select LDAP.
3. In the Description field, specify ldap_remote.
4. In the Test Name field, specify Remote LDAP Test.
5. In the Test Interval field, specify 30.
6. In the Test Timeout field, specify 10.
7. In the Samples Per Interval field, specify 1.
8. In the Statistics Window field, specify 120.
9. In the LDAP Server field, specify 10.0.0.123.
10. In the LDAP Domain field, specify Test.
11. In the User Name field, specify ldapRUser.
12. In the Password field, specify ldapRPass.
13. In the Query field, specify cn=Guest,cn=Users,dc=testlab,dc=com.
14. In the Filter field, specify cn=*.
15. Click Save Test.

When you commit your changes, SRM adds an entry similar to the following to the svcrsp.cf file:

{ 
index=23 
type=ldap
desc="ldap_remote" 
dest="10.0.0.123:389" 
username="ldapRUser" 
encoded=yes 
password="bXVyaWM" 
args="query=cn=guest,cd=users,dc=testlab,dc=com&domain=Test&filter=cn=*" 
interval=30 
samples=1 
timeout=10 
window=120 
tos=0 
limit=0 
status=active 
name="Remote LDAP Test"
class=""
context=""
flags="1"
loglevel=1
}

For information about errors you may encounter when running LDAP tests, see LDAP Test Error Codes.