From b95c71aa74bc45485bdf903410a9f450de265fbd Mon Sep 17 00:00:00 2001 From: maximthomas Date: Wed, 24 Jun 2026 11:54:03 +0300 Subject: [PATCH] Docs: add missing tools references --- opendj-doc-generated-ref/pom.xml | 38 ++++++- .../asciidoc/man-pages/_addrate-examples.adoc | 102 ++++++++++++++++++ .../man-pages/_authrate-examples.adoc | 46 ++++++++ .../man-pages/_description-rate-tools.adoc | 43 ++++++++ .../asciidoc/man-pages/_modrate-examples.adoc | 44 ++++++++ .../man-pages/_searchrate-examples.adoc | 43 ++++++++ .../asciidoc/reference/admin-tools-ref.adoc | 18 +++- 7 files changed, 332 insertions(+), 2 deletions(-) create mode 100644 opendj-doc-generated-ref/src/main/asciidoc/man-pages/_addrate-examples.adoc create mode 100644 opendj-doc-generated-ref/src/main/asciidoc/man-pages/_authrate-examples.adoc create mode 100644 opendj-doc-generated-ref/src/main/asciidoc/man-pages/_description-rate-tools.adoc create mode 100644 opendj-doc-generated-ref/src/main/asciidoc/man-pages/_modrate-examples.adoc create mode 100644 opendj-doc-generated-ref/src/main/asciidoc/man-pages/_searchrate-examples.adoc diff --git a/opendj-doc-generated-ref/pom.xml b/opendj-doc-generated-ref/pom.xml index 36bed8cb46..bdfad239b0 100644 --- a/opendj-doc-generated-ref/pom.xml +++ b/opendj-doc-generated-ref/pom.xml @@ -13,7 +13,7 @@ ~ information: "Portions Copyright [year] [name of copyright owner]". ~ ~ Copyright 2016 ForgeRock AS. - ~ Portions Copyright 2024-2025 3A Systems LLC. + ~ Portions Copyright 2024-2026 3A Systems LLC. --> 4.0.0 @@ -184,6 +184,23 @@ ${project.build.directory}/asciidoc/source/man-pages + + addrate + com.forgerock.opendj.ldap.tools.AddRate + + _exit-codes-0-80-89.adoc + _addrate-examples.adoc + + + + + authrate + com.forgerock.opendj.ldap.tools.AuthRate + + _exit-codes-0-89.adoc + _authrate-examples.adoc + + base64 @@ -284,6 +301,25 @@ _makeldif-see-also.adoc + + + modrate + com.forgerock.opendj.ldap.tools.ModRate + + _exit-codes-0-89.adoc + _modrate-examples.adoc + + + + + searchrate + com.forgerock.opendj.ldap.tools.SearchRate + + _exit-codes-0-89.adoc + _searchrate-examples.adoc + + + diff --git a/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_addrate-examples.adoc b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_addrate-examples.adoc new file mode 100644 index 0000000000..d8205bb0aa --- /dev/null +++ b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_addrate-examples.adoc @@ -0,0 +1,102 @@ +//// + + The contents of this file are subject to the terms of the Common Development and + Distribution License (the License). You may not use this file except in compliance with the + License. + + You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the + specific language governing permission and limitations under the License. + + When distributing Covered Software, include this CDDL Header Notice in each file and include + the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL + Header, with the fields enclosed by brackets [] replaced by your own identifying + information: "Portions Copyright [year] [name of copyright owner]". + + Copyright 2015-2016 ForgeRock AS. + Portions Copyright 2026 3A Systems LLC. + +//// + +== Examples +The following examples use this template file, `addrate.template`: + +[source] +---- +define suffix=dc=example,dc=com +define maildomain=example.com + +branch: [suffix] + +branch: ou=People,[suffix] +subordinateTemplate: person + +template: person +rdnAttr: uid +objectClass: top +objectClass: person +objectClass: organizationalPerson +objectClass: inetOrgPerson +givenName: +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: + +[source] +---- +$ 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: + +[source] +---- +$ 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 +---- \ No newline at end of file diff --git a/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_authrate-examples.adoc b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_authrate-examples.adoc new file mode 100644 index 0000000000..65221a273c --- /dev/null +++ b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_authrate-examples.adoc @@ -0,0 +1,46 @@ +//// + + The contents of this file are subject to the terms of the Common Development and + Distribution License (the License). You may not use this file except in compliance with the + License. + + You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the + specific language governing permission and limitations under the License. + + When distributing Covered Software, include this CDDL Header Notice in each file and include + the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL + Header, with the fields enclosed by brackets [] replaced by your own identifying + information: "Portions Copyright [year] [name of copyright owner]". + + Copyright 2015-2016 ForgeRock AS. + Portions Copyright 2026 3A Systems LLC. + +//// + +== Examples +The following example demonstrates measuring simple bind performance: + + +[source] +---- +$ authrate -p 1389 -g "rand(names.txt)" \ + -D "uid=%s,ou=people,dc=example,dc=com" -w password -c 10 -f + +----------------------------------------------------------------- + Throughput Response Time + (ops/second) (milliseconds) +recent average recent average 99.9% 99.99% 99.999% err/sec +----------------------------------------------------------------- +9796.9 9816.6 1.029 1.029 12.413 161.451 161.835 0.0 +14201.1 12028.1 0.704 0.835 9.508 161.456 167.573 0.0 +14450.0 12835.9 0.692 0.782 8.989 161.835 174.518 0.0 +12934.3 12860.6 0.773 0.779 9.253 161.339 174.426 0.0 +14154.5 13121.0 0.706 0.764 9.025 161.451 177.101 0.0 +^C +---- + +The `names.txt` contains +all the user IDs for the sample suffix. +All user password values have been set to password +for this example. + diff --git a/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_description-rate-tools.adoc b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_description-rate-tools.adoc new file mode 100644 index 0000000000..c5a2002b62 --- /dev/null +++ b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_description-rate-tools.adoc @@ -0,0 +1,43 @@ +//// + + The contents of this file are subject to the terms of the Common Development and + Distribution License (the License). You may not use this file except in compliance with the + License. + + You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the + specific language governing permission and limitations under the License. + + When distributing Covered Software, include this CDDL Header Notice in each file and include + the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL + Header, with the fields enclosed by brackets [] replaced by your own identifying + information: "Portions Copyright [year] [name of copyright owner]". + + Copyright 2015-2016 ForgeRock AS. + Portions Copyright 2026 3A Systems LLC. + +//// + +When you do not use the `-f` option to keep connections open and rebind on the connections, the tool can exhaust its available ports, causing the tool to crash. You can work around this problem on test systems by changing TCP settings on the system. + +For example, on Linux systems, set the following parameters in the `/etc/sysctl.conf` file: + +[source] +---- +net.ipv4.tcp_fin_timeout = 30 +net.ipv4.tcp_tw_recycle = 1 +net.ipv4.tcp_tw_reuse = 1 +---- + +The parameter `net.ipv4.tcp_fin_timeout` sets the length of time in seconds to wait for a final FIN packet before forcing a close of the socket. The default is 60 (seconds). + +The parameter `net.ipv4.tcp_tw_recycle` enables fast recycling of TIME_WAIT sockets. The default is 0 (false). Enabling this can cause Network Address Translation (NAT) issues. + +The parameter `net.ipv4.tcp_tw_reuse` enables reuse of TIME_WAIT sockets for new connections. The default is 0 (false). + +These settings are recommended only for testing, and __not for production systems__. + +After making the changes to `/etc/sysctl.conf` , reload the configuration with the sysctl command: +[source] +---- +sysctl -p +---- \ No newline at end of file diff --git a/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_modrate-examples.adoc b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_modrate-examples.adoc new file mode 100644 index 0000000000..dec829f4f5 --- /dev/null +++ b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_modrate-examples.adoc @@ -0,0 +1,44 @@ +//// + + The contents of this file are subject to the terms of the Common Development and + Distribution License (the License). You may not use this file except in compliance with the + License. + + You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the + specific language governing permission and limitations under the License. + + When distributing Covered Software, include this CDDL Header Notice in each file and include + the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL + Header, with the fields enclosed by brackets [] replaced by your own identifying + information: "Portions Copyright [year] [name of copyright owner]". + + Copyright 2015-2016 ForgeRock AS. + Portions Copyright 2026 3A Systems LLC. + +//// + +== Examples +The following example uses the `modrate` command to write random 16-character description values to user entries: + + +[source, console] +---- +$ grep ^uid: /path/to/Example.ldif | sed -e "s/uid: //" > names.txt + +$ modrate -p 1389 -D "cn=Directory Manager" -w password -A -F -c 4 -t 4 \ + -b "uid=%s,ou=people,dc=example,dc=com" -g "rand(names.txt)" \ + -g "randstr(16)" 'description:%2$s' + +-------------------------------------------------------------------------- + Throughput Response Time + (ops/second) (milliseconds) +recent average recent average 99.9% 99.99% 99.999% err/sec req/res +-------------------------------------------------------------------------- +1085.9 1088.5 993.849 993.849 2135.220 2510.361 2510.361 0.0 2.3 +2086.7 1648.8 1963.980 1683.038 3015.025 3078.628 3215.050 0.0 1.0 +3097.3 2092.6 1332.930 1524.278 2940.131 3024.811 3215.050 0.0 1.0 +3848.3 2501.4 1045.000 1352.583 2902.235 3015.863 3215.050 0.0 1.0 +3641.2 2717.4 1106.157 1290.003 2901.379 3015.597 3215.050 0.0 1.0 +3759.4 2883.0 1065.732 1243.534 2900.400 3015.501 3215.050 0.0 1.0 +^C +---- diff --git a/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_searchrate-examples.adoc b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_searchrate-examples.adoc new file mode 100644 index 0000000000..ebfa7d24a7 --- /dev/null +++ b/opendj-doc-generated-ref/src/main/asciidoc/man-pages/_searchrate-examples.adoc @@ -0,0 +1,43 @@ +//// + + The contents of this file are subject to the terms of the Common Development and + Distribution License (the License). You may not use this file except in compliance with the + License. + + You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the + specific language governing permission and limitations under the License. + + When distributing Covered Software, include this CDDL Header Notice in each file and include + the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL + Header, with the fields enclosed by brackets [] replaced by your own identifying + information: "Portions Copyright [year] [name of copyright owner]". + + Copyright 2015-2016 ForgeRock AS. + Portions Copyright 2026 3A Systems LLC. + +//// + +== Examples +The following example demonstrates measuring search performance: + + +[source, console] +---- +$ grep ^uid: /path/to/Example.ldif | sed -e "s/uid: //" > names.txt + +$ searchrate -p 1389 -b dc=example,dc=com -A -F -c 4 -t 4 \ + -g "rand(names.txt)" "(uid=%s)" + +------------------------------------------------------------------------------- + Throughput Response Time + (ops/second) (milliseconds) +recent average recent average 99.9% 99.99% 99.999% err/sec Entries/Srch +------------------------------------------------------------------------------- +1475.9 1475.9 0.423 0.423 6.938 126.236 126.236 0.0 1.0 +2596.5 2038.4 0.254 0.315 6.866 12.980 126.236 0.0 1.0 +3210.7 2428.2 0.205 0.267 5.733 11.710 126.236 0.0 1.0 +3080.5 2591.0 0.215 0.252 5.733 10.541 126.236 0.0 1.0 +3236.9 2720.1 0.203 0.240 5.258 10.514 126.236 0.0 1.0 +3181.1 2796.8 0.207 0.234 5.258 10.384 126.236 0.0 1.0 +3202.5 2854.8 0.206 0.229 4.825 10.384 126.236 0.0 1.0 +---- diff --git a/opendj-doc-generated-ref/src/main/asciidoc/reference/admin-tools-ref.adoc b/opendj-doc-generated-ref/src/main/asciidoc/reference/admin-tools-ref.adoc index 25535a7208..912180566e 100644 --- a/opendj-doc-generated-ref/src/main/asciidoc/reference/admin-tools-ref.adoc +++ b/opendj-doc-generated-ref/src/main/asciidoc/reference/admin-tools-ref.adoc @@ -12,7 +12,7 @@ information: "Portions copyright [year] [name of copyright owner]". Copyright 2017 ForgeRock AS. - Portions Copyright 2024 3A Systems LLC. + Portions Copyright 2024-2026 3A Systems LLC. //// :figure-caption!: @@ -27,6 +27,14 @@ You can find bundle tools under the folder where you installed OpenDJ directory :leveloffset: 1" +include::../partials/man-addrate.adoc[] + +''' + +include::../partials/man-authrate.adoc[] + +''' + include::../partials/man-backendstat.adoc[] ''' @@ -123,6 +131,10 @@ include::../partials/man-manage-tasks.adoc[] ''' +include::../partials/man-modrate.adoc[] + +''' + include::../partials/man-rebuild-index.adoc[] ''' @@ -131,6 +143,10 @@ include::../partials/man-restore.adoc[] ''' +include::../partials/man-searchrate.adoc[] + +''' + include::../partials/man-setup.adoc[] '''