modrate1 OpenDJ modrate measure modification throughput and response time modrate options attribute : value format string This utility can be used to measure modify throughput and response time of a directory service using user-defined modifications. The following options are supported. -A, --asynchronous Use asynchronous mode and don't wait for results before sending the next request -b, --baseDN {baseDN} Base DN format string -c, --numConnections {numConnections} Number of connections Default value: 1 -e, --percentile {percentile} Calculate max response time for a percentile of operations -f, --keepConnectionsOpen Keep connections open -F, --noRebind Keep connections open and don't rebind -g, --argument {generator function or static string} Argument used to evaluate the Java style format strings in program parameters (Base DN, Search Filter). The set of all arguments provided form the the argument list in order. Besides static string arguments, they can be generated per iteration with the following functions: "inc({filename})" Consecutive, incremental line from file "inc({min},{max})" Consecutive, incremental number "rand({filename})" Random line from file "rand({min},{max})" Random number "randStr({length},charSet)" Random string of specified length and optionally from characters in the charSet string. A range of character can be specified with [start-end] charSet notation. If no charSet is specified, the default charSet of [A-Z][a-z][0-9] will be used. -i, --statInterval {statInterval} Display results each specified number of seconds Default value: 5 -m, --maxIterations {maxIterations} Max iterations, 0 for unlimited Default value: 0 -M, --targetThroughput {targetThroughput} Target average throughput to achieve Default value: 0 -S, --scriptFriendly Use script-friendly mode -t, --numConcurrentTasks {numConcurrentTasks} Number of concurrent tasks per connection Default value: 1 -D, --bindDN {bindDN} DN to use to bind to the server Default value: cn=Directory Manager -E, --reportAuthzID Use the authorization identity control -h, --hostname {host} Directory server hostname or IP address Default value: localhost.localdomain -j, --bindPasswordFile {bindPasswordFile} Bind password file -K, --keyStorePath {keyStorePath} Certificate key store path -N, --certNickname {nickname} Nickname of certificate for SSL client authentication -o, --saslOption {name=value} SASL bind options -p, --port {port} Directory server port number Default value: 389 -P, --trustStorePath {trustStorePath} Certificate trust store path -q, --useStartTLS Use StartTLS to secure communication with the server -T, --trustStorePassword {trustStorePassword} Certificate trust store PIN -u, --keyStorePasswordFile {keyStorePasswordFile} Certificate key store PIN file -U, --trustStorePasswordFile {path} Certificate trust store PIN file --usePasswordPolicyControl Use the password policy request control -w, --bindPassword {bindPassword} Password to use to bind to the server -W, --keyStorePassword {keyStorePassword} Certificate key store PIN -X, --trustAll Trust all server SSL certificates -Z, --useSSL Use SSL for secure communication with the server --noPropertiesFile No properties file will be used to get default command line argument values --propertiesFilePath {propertiesFilePath} Path to the file containing default property values used for command line arguments -v, --verbose Use verbose mode -V, --version Display version information -?, -H, --help Display usage information 0 The command completed successfully. 89 An error occurred while parsing the command-line arguments. The following example demonstrates testing directory performance by using the modrate command to write random 16-character description values to all entries in a sample file. $ grep ^uid: /path/to/Example.ldif | sed -e "s/uid: //" > names.txt $ modrate -p 1389 -D cn=directory\ manager -w secret12 -b "uid=%s,ou=people,dc=example,dc=com" -g "rand(names.txt)" "description:%s" -g "randStr(16)" -A -F -c 4 -t 4 ----------------------------------------------------------------- Throughput Response Time (ops/second) (milliseconds) recent average recent average 99.9% 99.99% 99.999% err/sec ----------------------------------------------------------------- 399.0 399.0 1.546 1.546 8.917 79.764 79.764 0.0 541.6 470.5 1.109 1.294 8.917 181.808 181.808 0.0 755.2 565.4 0.747 1.050 9.828 181.808 181.808 0.0 786.9 620.8 0.718 0.945 10.175 114.424 181.808 0.0 1209.3 738.3 0.469 0.789 8.917 114.424 181.808 0.0 1255.8 824.5 0.474 0.709 8.365 79.764 181.808 0.0 1359.1 900.8 0.430 0.649 7.610 72.218 181.808 0.0 1294.5 950.0 0.463 0.618 7.589 81.093 181.808 0.0 1280.0 986.6 0.471 0.596 7.533 81.093 204.701 0.0 1301.9 1018.2 0.463 0.579 7.506 81.093 204.701 0.0 ^C