From b2a9d4c1f69ef5453cec5771c2a68d50ab83434f Mon Sep 17 00:00:00 2001 From: Douglas Bagnall Date: Fri, 4 Jan 2019 15:14:58 +1300 Subject: [PATCH] xml_docs: update traffic script documentation Signed-off-by: Douglas Bagnall Reviewed-by: Tim Beale Autobuild-User(master): Douglas Bagnall Autobuild-Date(master): Wed Jan 9 03:53:58 CET 2019 on sn-devel-144 --- docs-xml/manpages/traffic_learner.7.xml | 3 +- docs-xml/manpages/traffic_replay.7.xml | 83 +++++++++++++++++++------ 2 files changed, 64 insertions(+), 22 deletions(-) diff --git a/docs-xml/manpages/traffic_learner.7.xml b/docs-xml/manpages/traffic_learner.7.xml index 6fd7975393d..b921035e4bd 100644 --- a/docs-xml/manpages/traffic_learner.7.xml +++ b/docs-xml/manpages/traffic_learner.7.xml @@ -118,8 +118,7 @@ The model is stored in JSON format, and also contains - information about the conversation rate and DNS traffic - rate. + information about the packet rate and DNS traffic rate. diff --git a/docs-xml/manpages/traffic_replay.7.xml b/docs-xml/manpages/traffic_replay.7.xml index da8da5cf3c6..167bd9e0b08 100644 --- a/docs-xml/manpages/traffic_replay.7.xml +++ b/docs-xml/manpages/traffic_replay.7.xml @@ -21,6 +21,7 @@ traffic_replay -F, --fixed-password <test-password> + -T, --packets-per-second <number> -S, --scale-traffic <scale by factor> -r, --replay-rate <scale by factor> -D, --duration <seconds> @@ -41,6 +42,9 @@ -P, --machine-pass --option <option> -d, --debuglevel <debug level> + --conversation-persistence <0-1> + --latency-timeout <seconds> + --stop-on-any-error summary-file dns-hostname @@ -53,6 +57,7 @@ --number-of-groups <total groups> --average-groups-per-user <average number> --group-memberships <total memberships> + --max-members <group size> dns-hostname @@ -104,11 +109,10 @@ summary-file - File containing the network traffic to replay. This should either be - a traffic-summary (generated by traffic_summary.pl) - or a traffic-model (generated by traffic_learner). - Based on this file, this tool will generate 'conversations' which - represent Samba activity between a network host and the DC. + File containing the network traffic to replay. This should be a + traffic-model (generated by traffic_learner). + Based on this file, this tool will generate 'conversations' which + represent Samba activity between a network host and the DC. @@ -153,7 +157,7 @@ When the summary-file is a traffic-model (produced by traffic_learner), use these options to alter the traffic that gets generated. - + -D|--duration <seconds> @@ -163,22 +167,34 @@ - -r|--replay-rate <factor> + -T|--packets-per-second <number> - Replays the traffic faster by this factor. This option won't - affect the number of conversations (which is based on the - traffic model), but the rate at which the packets are sent will - be increased. + Generate this many packets per second, regardless of + the traffic rate of the sample on which the model + was based. This cannot be used with . -S|--scale-traffic <factor> - Increases the number of conversations by this factor. This - option won't affect the rate at which packets get sent (which - is still based on the traffic model), but it will mean more - conversations get replayed. + Increases the number of conversations by this factor, + relative to the original traffic sample on which the + model was based. This option won't affect the rate at + which packets get sent (which is still based on the + traffic model), but it will mean more conversations + get replayed. It cannot be combined with + , which sets the traffic rate in a + different way. + + + + + -r|--replay-rate <factor> + Replays the traffic faster by this + factor. This option won't affect the number of packets + sent, but it will squeeze them into fewer + conversations, which may reduce resource usage. @@ -201,7 +217,28 @@ a traffic-summary file, or to use the --random-seed option. - + + --stop-on-any-error + Any client error causes the whole run to stop. + + + + + --conversation-persistence <0-1> + Conversation termination (as decided + by the model) is re-interpreted as a long pause with + this probability. + + + + --latency-timeout <seconds> + Wait this long at the end of the run + for outstanding reply packets. The number of + conversations that have not finished at the end of the + timeout is a failure metric. + + + @@ -214,7 +251,7 @@ not actually used for traffic generation - the traffic generation is still based on the number of conversations from the model/summary file. - + Generating a large number of users can take a long time, so it this option allows this to be done only once. @@ -241,7 +278,7 @@ Creates the specified number of groups, for assigning the test users to. Note that users are not automatically assigned to groups - use either --average-groups-per-user or - --group-membership to do this. + --group-memberships to do this. @@ -268,7 +305,13 @@ on average. Some users will belong to more groups and some users will belong to fewer groups, but the total of all member linked attributes would be 300. This option is - incompatible with the --group-membership option. + incompatible with the --average-groups-per-user option. + + + + --max-members <group size> + Limit the largest group to this size, + even if the other group options would have it otherwise. @@ -422,7 +465,7 @@ along with the full DNS hostname of the DC being tested. You also need to provide some user credentials, and possibly the Samba realm and workgroup (although the realm and workgroup may be determined - automatically, for example from the /etc/smb.conf file, if one is + automatically, for example from the /etc/smb.conf file, if one is present). E.g. traffic_replay traffic-summary.txt