2014-2015ForgeRock AS.addrate1OpenDJ${docTargetVersion}addratemeasure add & delete throughput and response timeaddrateoptionstemplate-file-pathDescription
This utility can be used to measure add and optionally delete
throughput and response time of a directory server using user-defined entries.
The template-file-path argument
identifies a template file that has the same form as a template file
for the makeldif command.
For details, see
makeldif.template.
Options
The following options are supported.
Specifies the age at which added entries will become candidates for deletion
Use asynchronous mode and do not wait for results before sending the next request
Warm up duration in seconds
Default value: 0
Number of connections
Default value: 1
The algorithm used for selecting entries to be deleted which must be one of "fifo", "random", or "off".
Default value: FIFO
Maximum duration in seconds, 0 for unlimited
Default value: 0
Calculate max response time for a percentile of operations
Keep connections open
Keep connections open and do not rebind
A constant that overrides the value set in the template file
Display results each specified number of seconds
Default value: 5
Max iterations, 0 for unlimited
Default value: 0
Target average throughput to achieve
Default value: 0
Disable the purge phase when the tool stops.
By default, when you interrupt the tool
it deletes the remaining entries that it added before returning.
Path to look for template resources (e.g. data files)
The seed to use for initializing the random number generator
Default value: 0
Specifies the number of entries to be added before deletion begins
Default value: 10000
Use script-friendly mode
Number of worker threads per connection
Default value: 1
LDAP Connection Options
DN to use to bind to the server
If you do not specify a bind DN,
then the operations are performed as an anonymous user.
In many directories anonymous users have no right to add or delete entries.
Use the authorization identity control
Directory server hostname or IP address
Default value: localhost.localdomain
Bind password file
Certificate key store path
Nickname of the certificate that the server should use
when accepting SSL-based connections or performing StartTLS negotiation
SASL bind options
Directory server port number
Default value: 389
Certificate trust store path
Use StartTLS to secure communication with the server
Certificate trust store PIN
Certificate key store PIN file.
A PIN is required when you specify to use an existing certificate
as server certificate
Certificate trust store PIN file
Use the password policy request control
Password to use to bind to the server
Certificate key store PIN
Trust all server SSL certificates
Use SSL for secure communication with the server
Utility Input/Output Options
No properties file will be used to get default command line argument values
Path to the file containing default property values used for command line arguments
Use verbose mode
General Options
Display version information
Display usage information
Exit Codes0
The command completed successfully.
80
The command could not complete due to an input/output error.
89
An error occurred while parsing the command-line arguments.
Examples
The following examples use this template file,
addrate.template.
sn:
cn: {givenName} {sn}
initials: {givenName:1}{sn:1}
employeeNumber:
uid: user.{employeeNumber}
mail: {uid}@[maildomain]
userPassword: password
telephoneNumber:
homePhone:
pager:
mobile:
street: Street
l:
st:
postalCode:
postalAddress: {cn}${street}${l}, {st} {postalCode}
description: This is the description for {cn}.
]]>
The following example adds entries, and then randomly deletes them
when more than 10,000 entries have been added.
$ addrate -p 1389 -D "cn=Directory Manager" -w password \
-f -c 10 -C random -s 10000 addrate.template
-----------------------------------------------------------------------
Throughput Response Time
(ops/second) (milliseconds)
recent average recent average 99.9% 99.99% 99.999% err/sec Add%
-----------------------------------------------------------------------
466.7 467.2 20.738 20.738 187.00 201.00 201.00 0.0 100.00
588.9 528.1 17.015 18.661 166.00 201.00 201.00 0.0 100.00
1584.9 880.3 6.076 11.109 150.00 196.00 201.00 0.0 79.87
1577.8 1054.5 6.138 9.252 132.00 192.00 201.00 0.0 50.00
1853.0 1214.4 5.188 8.010 124.00 187.00 201.00 0.0 49.99
^CPurge phase...
2482.7 1426.2 3.790 6.783 114.00 187.00 201.00 0.0 9.77
The following example also adds entries, and then deletes them
in the order they were added after they are 10 seconds old.
$ addrate -p 1389 -D "cn=Directory Manager" -w password \
-f -c 10 -C fifo -a 10 addrate.template
-----------------------------------------------------------------------
Throughput Response Time
(ops/second) (milliseconds)
recent average recent average 99.9% 99.99% 99.999% err/sec Add%
-----------------------------------------------------------------------
2065.6 2068.1 4.646 4.646 30.00 51.00 58.00 0.0 100.00
1479.7 1773.3 6.567 5.449 46.00 59.00 67.00 0.0 99.23
1443.4 1663.3 6.730 5.820 56.00 112.00 120.00 0.0 50.01
1462.6 1613.0 6.635 6.005 56.00 102.00 120.00 0.0 50.08
1452.2 1580.8 6.678 6.129 62.00 110.00 120.00 0.0 49.97
^CPurge phase...
1344.5 1541.4 7.170 6.280 69.00 176.00 1900.00 0.0 17.30
1703.3 1564.6 5.449 6.151 68.00 176.00 3000.00 0.0 0.00