mu 5.7.38 → 5.7.39
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE.txt +1 -1
- data/Mu_Gem.html +54 -55
- data/README.md +47 -47
- data/lib/mu/har.rb +1 -1
- data/lib/mu/maker.rb +8 -6
- data/version.rb +1 -1
- metadata +86 -83
data/LICENSE.txt
CHANGED
data/Mu_Gem.html
CHANGED
@@ -367,7 +367,7 @@ table.outline-auto th {
|
|
367
367
|
</div>
|
368
368
|
|
369
369
|
<div id="content">
|
370
|
-
<p>The Mu.gem contains command line application (executables) designed to help you work with Scenarios, Test Sets, Scale tests and all results generated from those tests. In addition, the Mu.gem also supports older REST API commands that you can use to configure the
|
370
|
+
<p>The Mu.gem contains command line application (executables) designed to help you work with Scenarios, Test Sets, Scale tests and all results generated from those tests. In addition, the Mu.gem also supports older REST API commands that you can use to configure the test network interfaces on the appliance, get system status, or even access the appliance CLI. Finally, the Mu. gem exposes API library classes that you can use in your own custom gems. </p>
|
371
371
|
<div id="important">
|
372
372
|
<p><strong>Before Using This Gem</strong>:</p>
|
373
373
|
<ul>
|
@@ -381,9 +381,9 @@ table.outline-auto th {
|
|
381
381
|
<li><em>mime-types</em>. Required by REST-client.</li>
|
382
382
|
</ul>
|
383
383
|
</li>
|
384
|
-
<li><strong><em>Set the
|
384
|
+
<li><strong><em>Set the environment variables</em></strong>.
|
385
385
|
<ul>
|
386
|
-
<li><em><span class="MsoNormal1">MU_IP</span></em><span class="MsoNormal1">. Set the default IP addr</span>ess of the
|
386
|
+
<li><em><span class="MsoNormal1">MU_IP</span></em><span class="MsoNormal1">. Set the default IP addr</span>ess of the appliance management interface.</li>
|
387
387
|
<li><em>MU_ADMIN_USER</em>. Set the default name of the admin user.</li>
|
388
388
|
<li><em>MU_ADMIN_PASS</em>. Set the default <span class="MsoNormal1">admin user password</span>.</li>
|
389
389
|
</ul></li></ul></div>
|
@@ -403,7 +403,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
403
403
|
<tr>
|
404
404
|
<td><p class=MsoNormal><strong>Legacy REST API Commands</strong> <a href="#executables"></a> <a href="#executables"></a> <a href="#executables"></a><a href="#api-methods">go to section »</a>
|
405
405
|
</p>
|
406
|
-
<p> These commands provide access to legacy REST API commands supported by the
|
406
|
+
<p> These commands provide access to legacy REST API commands supported by the appliance. </p></td>
|
407
407
|
<td><ul>
|
408
408
|
<li><a href="#cmd_ddt">cmd_ddt</a></li>
|
409
409
|
<li><a href="#cmd_scale">cmd_scale</a></li>
|
@@ -438,7 +438,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
438
438
|
<li><a href="#cmd_musl">cmd_musl</a></li>
|
439
439
|
</ul>
|
440
440
|
<h2><a name="cmd_appid" id="features4"></a>cmd_appid</h2>
|
441
|
-
<p>Use to run Scale tests for a multi-host App-ID .msl file or a directory of .msl files. Supports command-line options for setting test parameters (such as concurrency and pattern) and for configuring a client/server passthrough Test Bed.
|
441
|
+
<p>Use to run Scale tests for a multi-host App-ID .msl file or a directory of .msl files. Supports command-line options for setting test parameters (such as concurrency and pattern) and for configuring a client/server passthrough Test Bed. Spirent Studio automatically collapses all hosts in the App-ID Scenario to just two hosts, which must be set to two test interfaces. </p>
|
442
442
|
<table border="0" cellpadding="1" cellspacing="1" class=outline>
|
443
443
|
<tr>
|
444
444
|
<th width="102">Command</th>
|
@@ -490,13 +490,13 @@ style="mso-spacerun: yes"> </span></li>
|
|
490
490
|
<tr>
|
491
491
|
<td colspan="2"><p><strong>-i</strong>/<strong>--interfaces</strong> <interfaces></p>
|
492
492
|
<blockquote>
|
493
|
-
<p>Specify
|
493
|
+
<p>Specify test interfaces as a comma-separated list. Example: b1, b2. When using an IP range, specify range and offset. Example: b1-1000:0,b2</p>
|
494
494
|
</blockquote></td>
|
495
495
|
</tr>
|
496
496
|
<tr>
|
497
497
|
<td colspan="2"><p><strong>-m</strong>/<strong>--mu_string</strong> <em><</em>user:pass@mu-ip></p>
|
498
498
|
<blockquote>
|
499
|
-
<p>Specify the user, password, and
|
499
|
+
<p>Specify the user, password, and management IP of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
500
500
|
</blockquote></td>
|
501
501
|
</tr>
|
502
502
|
<tr>
|
@@ -534,7 +534,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
534
534
|
</table>
|
535
535
|
<p><a href="#top">back to top ↑</a></p>
|
536
536
|
<h2><a name="cmd_runscale" id="cmd_runscale"></a>cmd_runscale</h2>
|
537
|
-
<p>Use to run Scale tests by specifying a Scenario .msl file or a directory of .msl files. Supports command-line options for setting test parameters (such as concurrency and pattern) and for configuring the Test Bed with
|
537
|
+
<p>Use to run Scale tests by specifying a Scenario .msl file or a directory of .msl files. Supports command-line options for setting test parameters (such as concurrency and pattern) and for configuring the Test Bed with test interfaces and/or network hosts. </p>
|
538
538
|
<table border="0" cellpadding="1" cellspacing="1" class=outline>
|
539
539
|
<tr>
|
540
540
|
<th width="76">Command</th>
|
@@ -595,13 +595,13 @@ style="mso-spacerun: yes"> </span></li>
|
|
595
595
|
<tr>
|
596
596
|
<td colspan="2" class="outline"><p><strong>-i/--interfaces</strong> <em>interfaces</em></p>
|
597
597
|
<blockquote>
|
598
|
-
<p>Specify
|
598
|
+
<p>Specify test interfaces as a comma-separated list. Example: <span class="code">b1,</span> <span class="code">b2</span>. When using an IP range, specify range and offset. Example: <span class="code">b1-1000:0,b2</span></p>
|
599
599
|
</blockquote></td>
|
600
600
|
</tr>
|
601
601
|
<tr>
|
602
602
|
<td colspan="2" class="outline"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
603
603
|
<blockquote>
|
604
|
-
<p>Specify the user, password, and
|
604
|
+
<p>Specify the user, password, and management IP of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
605
605
|
</blockquote></td>
|
606
606
|
</tr>
|
607
607
|
<tr>
|
@@ -644,7 +644,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
644
644
|
</table>
|
645
645
|
<p><a href="#top">back to top ↑</a></p>
|
646
646
|
<h2><a name="cmd_runverify" id="cmd_runscale2"></a>cmd_runverify</h2>
|
647
|
-
<p>Use to load a Scenario and Test Set template (.xml files) and run a Test Set in Studio Verify. Supports command-line options for setting option values and for configuring the Test Bed with
|
647
|
+
<p>Use to load a Scenario and Test Set template (.xml files) and run a Test Set in Studio Verify. Supports command-line options for setting option values and for configuring the Test Bed with test interfaces and/or network hosts.</p>
|
648
648
|
<table border="0" cellpadding="1" cellspacing="1" class="outline">
|
649
649
|
<tr>
|
650
650
|
<th width="101">Command</th>
|
@@ -684,13 +684,13 @@ style="mso-spacerun: yes"> </span></li>
|
|
684
684
|
<tr class="wide">
|
685
685
|
<td colspan="2"><p><strong>-i/--interfaces</strong> <em>interfaces</em></p>
|
686
686
|
<blockquote>
|
687
|
-
<p>Specify
|
687
|
+
<p>Specify test interfaces and network hosts as a comma-separated list. Example: <span class="code">b1, b2</span>. When using an IP range, specify range/offset. Example: <span class="code">b1-1000:0,web-server</span></p>
|
688
688
|
</blockquote></td>
|
689
689
|
</tr>
|
690
690
|
<tr class="wide">
|
691
691
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
692
692
|
<blockquote>
|
693
|
-
<p>Specify the user, password, and
|
693
|
+
<p>Specify the user, password, and management IP of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
694
694
|
</blockquote></td>
|
695
695
|
</tr>
|
696
696
|
<tr class="wide">
|
@@ -727,7 +727,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
727
727
|
</table>
|
728
728
|
<p><a href="#top">back to top ↑</a></p>
|
729
729
|
<h2><a name="cmd_runscenario" id="cmd_runscale3"></a>cmd_runscenario</h2>
|
730
|
-
<p>Use to load and verify a Scenario template (.xml file). Supports command-line options for configuring the Test Bed with
|
730
|
+
<p>Use to load and verify a Scenario template (.xml file). Supports command-line options for configuring the Test Bed with test interfaces and/or network hosts.</p>
|
731
731
|
<table border="0" cellpadding="1" cellspacing="1" class="outline">
|
732
732
|
<tr>
|
733
733
|
<th width="97">Command</th>
|
@@ -767,13 +767,13 @@ style="mso-spacerun: yes"> </span></li>
|
|
767
767
|
<tr>
|
768
768
|
<td colspan="2"><p><strong>-i/--interfaces</strong> <em>interfaces</em></p>
|
769
769
|
<blockquote>
|
770
|
-
<p>Specify
|
770
|
+
<p>Specify test interfaces and network hosts as a comma-separated list. Example: <span class="code">b1, b2</span>. When using an IP range, specify range/offset. Example: <span class="code">b1-1000:0,web-server</span></p>
|
771
771
|
</blockquote></td>
|
772
772
|
</tr>
|
773
773
|
<tr>
|
774
774
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
775
775
|
<blockquote>
|
776
|
-
<p>Specify the user, password, and
|
776
|
+
<p>Specify the user, password, and management IP of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
777
777
|
</blockquote></td>
|
778
778
|
</tr>
|
779
779
|
<tr>
|
@@ -798,7 +798,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
798
798
|
</table>
|
799
799
|
<p><a href="#top">back to top ↑</a></p>
|
800
800
|
<h2><a name="cmd_musl" id="cmd_runscale13"></a>cmd_musl</h2>
|
801
|
-
<p>Use to create .msl files from <strong>H</strong>TTP <strong>Ar</strong>chive (.har) files, which capture web page loading information in JSON format. You can use the <strong>from_har</strong> command to transform a .har file into a Scenario (in .msl format) suitable for import into
|
801
|
+
<p>Use to create .msl files from <strong>H</strong>TTP <strong>Ar</strong>chive (.har) files, which capture web page loading information in JSON format. You can use the <strong>from_har</strong> command to transform a .har file into a Scenario (in .msl format) suitable for import into Spirent Studio.</p>
|
802
802
|
<table border="0" cellpadding="1" cellspacing="1" class="outline">
|
803
803
|
<tr>
|
804
804
|
<th width="97">Command</th>
|
@@ -898,7 +898,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
898
898
|
</table>
|
899
899
|
<p><a href="#top">back to top ↑</a></p>
|
900
900
|
<h3><a name="api-methods" id="cmd_runscale12"></a>Legacy API Commands </h3>
|
901
|
-
<p>These commands provide access to legacy REST API commands supported by the
|
901
|
+
<p>These commands provide access to legacy REST API commands supported by the appliance. </p>
|
902
902
|
<ul>
|
903
903
|
<li><a href="#cmd_muapi">cmd_muapi</a></li>
|
904
904
|
<li><a href="#cmd_netconfig">cmd_netconfig</a></li>
|
@@ -938,11 +938,11 @@ style="mso-spacerun: yes"> </span></li>
|
|
938
938
|
<p class="code_black_background">mu cmd_muapi:backup -c status</p>
|
939
939
|
<p>Download the backup file (requires a name): <strong>backup</strong> <strong>-c</strong> <strong>get -n</strong><em> filename</em></p>
|
940
940
|
<p class="code_black_background">mu cmd_muapi:backup -c get -n my-backup</p>
|
941
|
-
<p>The
|
941
|
+
<p>The appliance automatically appends the .dat extension to all backup files.</p></td>
|
942
942
|
</tr>
|
943
943
|
<tr>
|
944
944
|
<td valign="top"><p><em>capture</em></p></td>
|
945
|
-
<td class="outline"><p>Manage packet captures recorded using the
|
945
|
+
<td class="outline"><p>Manage packet captures recorded using the appliance. The <strong>status</strong> and <strong>get</strong> commands require the job-id returned by the run command: <strong>capture</strong> <strong>-c</strong><em> command </em><strong>-p</strong><em> port-number</em><strong> -u</strong><em> job-id</em> </p>
|
946
946
|
<p>Start recording packets (this command returns the job-id):</p>
|
947
947
|
<p class="code_black_background">mu cmd_muapi:capture -c run -p a1</p>
|
948
948
|
<p>Get the status of the packet recording job:</p>
|
@@ -1028,7 +1028,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1028
1028
|
<tr class="wide">
|
1029
1029
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
1030
1030
|
<blockquote>
|
1031
|
-
<p>Specify the user, password, and
|
1031
|
+
<p>Specify the user, password, and management IP of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
1032
1032
|
</blockquote></td>
|
1033
1033
|
</tr>
|
1034
1034
|
<tr class="wide">
|
@@ -1077,7 +1077,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1077
1077
|
</table>
|
1078
1078
|
<p><a href="#top">back to top ↑</a></p>
|
1079
1079
|
<h2><a name="cmd_netconfig" id="cmd_runscale6"></a>cmd_netconfig</h2>
|
1080
|
-
<p>Use to access the legacy REST API for configuring
|
1080
|
+
<p>Use to access the legacy REST API for configuring test interfaces, network hosts, and routes.</p>
|
1081
1081
|
<table border="0" cellpadding="1" cellspacing="1" class=outline>
|
1082
1082
|
<tr>
|
1083
1083
|
<th colspan="2">cmd_netconfig Commands</th>
|
@@ -1089,22 +1089,22 @@ style="mso-spacerun: yes"> </span></li>
|
|
1089
1089
|
</tr>
|
1090
1090
|
<tr>
|
1091
1091
|
<td valign="top"><p class="outline"><em>clear_hosts</em></p></td>
|
1092
|
-
<td><p>Remove all network hosts configured in the
|
1092
|
+
<td><p>Remove all network hosts configured in the appliance: <strong>clear_hosts</strong></p>
|
1093
1093
|
<p class="code_black_background">mu cmd_netconfig:clear_hosts</p></td>
|
1094
1094
|
</tr>
|
1095
1095
|
<tr>
|
1096
1096
|
<td valign="top"><p class="outline"><em>clear_interfaces</em></p></td>
|
1097
|
-
<td><p>Clear settings for specified
|
1097
|
+
<td><p>Clear settings for specified test interfaces: <strong>clear_interface -i</strong> <em>interfaces</em></p>
|
1098
1098
|
<p class="code_black_background">mu cmd_netconfig:clear_interface -i b1,b2</p></td>
|
1099
1099
|
</tr>
|
1100
1100
|
<tr>
|
1101
1101
|
<td valign="top"><p class="outline"><em>clear_routes</em></p></td>
|
1102
|
-
<td><p>Remove all user-configured routes in the
|
1102
|
+
<td><p>Remove all user-configured routes in the appliance: <strong>clear_routes</strong></p>
|
1103
1103
|
<p class="code_black_background">mu cmd_netconfig:clear_routes</p></td>
|
1104
1104
|
</tr>
|
1105
1105
|
<tr>
|
1106
1106
|
<td valign="top"><p class="outline"><em>clear_vlans</em></p></td>
|
1107
|
-
<td><p>Remove all vlans for all
|
1107
|
+
<td><p>Remove all vlans for all test interfaces: <strong>clear_vlans</strong></p>
|
1108
1108
|
<p class="code_black_background">mu cmd_netconfig:clear_vlans</p></td>
|
1109
1109
|
</tr>
|
1110
1110
|
<tr>
|
@@ -1140,7 +1140,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1140
1140
|
</tr>
|
1141
1141
|
<tr>
|
1142
1142
|
<td height="75" valign="top"><p class="outline"><em>save</em></p></td>
|
1143
|
-
<td><p>Save changes to the
|
1143
|
+
<td><p>Save changes to the appliance: <strong>save</strong></p>
|
1144
1144
|
<p class="code_black_background">mu cmd_netconfig:save</p></td>
|
1145
1145
|
</tr>
|
1146
1146
|
<tr>
|
@@ -1173,7 +1173,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1173
1173
|
<tr>
|
1174
1174
|
<td colspan="2"><p><strong>-i/--interfaces</strong> <em>interface-or-host</em></p>
|
1175
1175
|
<blockquote>
|
1176
|
-
<p>Specify
|
1176
|
+
<p>Specify test interfaces or network hosts as a comma-separated list. Example: <span class="code">b1, web-server</span>. </p>
|
1177
1177
|
</blockquote></td>
|
1178
1178
|
</tr>
|
1179
1179
|
<tr>
|
@@ -1185,7 +1185,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1185
1185
|
<tr>
|
1186
1186
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
1187
1187
|
<blockquote>
|
1188
|
-
<p>Specify a user, password, and management IP of
|
1188
|
+
<p>Specify a user, password, and management IP of appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
1189
1189
|
</blockquote></td>
|
1190
1190
|
</tr>
|
1191
1191
|
<tr>
|
@@ -1261,7 +1261,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1261
1261
|
</tr>
|
1262
1262
|
<tr>
|
1263
1263
|
<td valign="top"><p><em>setup_test</em></p></td>
|
1264
|
-
<td><p>Setup the Test Bed, reserving the
|
1264
|
+
<td><p>Setup the Test Bed, reserving the test interfaces: <strong>setup_test</strong> </p>
|
1265
1265
|
<p class="code_black_background">mu cmd_ddt:setup_test</p></td>
|
1266
1266
|
</tr>
|
1267
1267
|
<tr>
|
@@ -1286,7 +1286,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1286
1286
|
</tr>
|
1287
1287
|
<tr>
|
1288
1288
|
<td valign="top"><p><em>teardown_test</em></p></td>
|
1289
|
-
<td><p>Unsets the Test Bed selections, releasing the
|
1289
|
+
<td><p>Unsets the Test Bed selections, releasing the test interfaces: <strong>teardown_test</strong> </p>
|
1290
1290
|
<p class="code_black_background">mu cmd_ddt:teardown_test</p></td>
|
1291
1291
|
</tr>
|
1292
1292
|
<tr>
|
@@ -1300,11 +1300,11 @@ style="mso-spacerun: yes"> </span></li>
|
|
1300
1300
|
<p class="code_black_background">mu cmd_ddt:close_all_sessions</p></td>
|
1301
1301
|
</tr>
|
1302
1302
|
<td valign="top"><p><em>csv_export</em></p></td>
|
1303
|
-
<td><p>Exports a Test Set from the
|
1303
|
+
<td><p>Exports a Test Set from the appliance to a. csv file: <strong>csv_export</strong> <strong>-u</strong> <em>uuid</em> </p>
|
1304
1304
|
<p class="code_black_background">mu cmd_ddt:csv_export -u 52add3cf-9040-42ce-b263-8233039931d5</p></td>
|
1305
1305
|
</tr>
|
1306
1306
|
<td height="82" valign="top"><p><em>csv_import</em></p></td>
|
1307
|
-
<td><p>Imports a .csv file to create a Test Set on the
|
1307
|
+
<td><p>Imports a .csv file to create a Test Set on the appliance: <strong>csv_import</strong> <strong>-t</strong><em> filename.csv</em> </p>
|
1308
1308
|
<p class="code_black_background">mu cmd_ddt:csv_import -t my-testset.csv</p></td>
|
1309
1309
|
</tr><tr class="wide">
|
1310
1310
|
<th colspan="2">cmd_ddt Options</th>
|
@@ -1324,7 +1324,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1324
1324
|
<tr class="wide">
|
1325
1325
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
1326
1326
|
<blockquote>
|
1327
|
-
<p>Specify a user, password, and management IP address of
|
1327
|
+
<p>Specify a user, password, and management IP address of appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
1328
1328
|
</blockquote></td>
|
1329
1329
|
</tr>
|
1330
1330
|
<tr class="wide">
|
@@ -1499,7 +1499,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1499
1499
|
<tr class="wide">
|
1500
1500
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
1501
1501
|
<blockquote>
|
1502
|
-
<p>Specify a user, password, and
|
1502
|
+
<p>Specify a user, password, and management IP of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
1503
1503
|
</blockquote></td>
|
1504
1504
|
</tr>
|
1505
1505
|
<tr class="wide">
|
@@ -1548,14 +1548,14 @@ style="mso-spacerun: yes"> </span></li>
|
|
1548
1548
|
</table>
|
1549
1549
|
<p><a href="#top">back to top ↑</a></p>
|
1550
1550
|
<h2><a name="cmd_homepage" id="cmd_runscale9"></a>cmd_homepage</h2>
|
1551
|
-
<p>Use to access information displayed on the
|
1551
|
+
<p>Use to access information displayed on the appliance UI homepage, such as recent updates, backup status, or a list of latest test results.</p>
|
1552
1552
|
<table border="0" cellpadding="1" cellspacing="1" class=outline>
|
1553
1553
|
<tr>
|
1554
1554
|
<th colspan="2">cmd_homepage Commands</th>
|
1555
1555
|
</tr>
|
1556
1556
|
<tr>
|
1557
1557
|
<td width="173" valign="top"><p><em>all</em></p></td>
|
1558
|
-
<td width="398"><p>Gets the complete set of information displayed on the
|
1558
|
+
<td width="398"><p>Gets the complete set of information displayed on the appliance UI home page: <strong>all</strong> </p>
|
1559
1559
|
<p class="code_black_background">mu cmd_homepage:all</p></td>
|
1560
1560
|
</tr>
|
1561
1561
|
<tr>
|
@@ -1575,7 +1575,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1575
1575
|
</tr>
|
1576
1576
|
<tr>
|
1577
1577
|
<td valign="top"><p><em>recent</em></p></td>
|
1578
|
-
<td><p>Gets the "What's New" section from the
|
1578
|
+
<td><p>Gets the "What's New" section from the appliance UI homepage: <strong>recent</strong> </p>
|
1579
1579
|
<p class="code_black_background">mu cmd_homepage:recent</p></td>
|
1580
1580
|
</tr>
|
1581
1581
|
<tr>
|
@@ -1595,7 +1595,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1595
1595
|
<tr class="wide">
|
1596
1596
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
1597
1597
|
<blockquote>
|
1598
|
-
<p>Specify a user, password, and management IP address of
|
1598
|
+
<p>Specify a user, password, and management IP address of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
1599
1599
|
</blockquote></td>
|
1600
1600
|
</tr>
|
1601
1601
|
<tr class="wide">
|
@@ -1614,14 +1614,14 @@ style="mso-spacerun: yes"> </span></li>
|
|
1614
1614
|
</table>
|
1615
1615
|
<p><a href="#top">back to top ↑</a></p>
|
1616
1616
|
<h2><a name="cmd_system" id="cmd_runscale10"></a>cmd_system</h2>
|
1617
|
-
<p>Use to restart
|
1617
|
+
<p>Use to restart Studio services or to get status details for the appliance. </p>
|
1618
1618
|
<table border="0" cellpadding="1" cellspacing="1" class=outline>
|
1619
1619
|
<tr>
|
1620
1620
|
<th colspan="2">cmd_system Commands</th>
|
1621
1621
|
</tr>
|
1622
1622
|
<tr>
|
1623
1623
|
<td valign="top"><p><em>restart</em></p></td>
|
1624
|
-
<td><p>Restart
|
1624
|
+
<td><p>Restart Studio services on the appliance (this does not reboot the appliance): <strong>restart</strong> </p>
|
1625
1625
|
<p class="code_black_background">mu cmd_system:restart</p></td>
|
1626
1626
|
</tr>
|
1627
1627
|
<tr>
|
@@ -1646,7 +1646,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1646
1646
|
<tr class="wide">
|
1647
1647
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
1648
1648
|
<blockquote>
|
1649
|
-
<p>Specify a user, password, and management IP address of
|
1649
|
+
<p>Specify a user, password, and management IP address of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
1650
1650
|
</blockquote></td>
|
1651
1651
|
</tr>
|
1652
1652
|
<tr class="wide">
|
@@ -1665,7 +1665,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1665
1665
|
</table>
|
1666
1666
|
<p><a href="#top">back to top ↑</a></p>
|
1667
1667
|
<h2><a name="cmd_cli" id="cmd_runscale11"></a>cmd_cli</h2>
|
1668
|
-
<p>Use to access the
|
1668
|
+
<p>Use to access the appliance CLI. </p>
|
1669
1669
|
<table border="0" cellpadding="1" cellspacing="1" class=outline>
|
1670
1670
|
<tr>
|
1671
1671
|
<th colspan="2">cmd_cli Commands</th>
|
@@ -1682,7 +1682,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1682
1682
|
</tr>
|
1683
1683
|
<tr>
|
1684
1684
|
<td valign="top"><p><em>ping</em></p></td>
|
1685
|
-
<td><p>Ping the specified IP address from the
|
1685
|
+
<td><p>Ping the specified IP address from the appliance: <strong>ping -a </strong><em>ip-address </em> </p>
|
1686
1686
|
<p class="code_black_background">mu cmd_cli:ping -a 10.10.10.1</p></td>
|
1687
1687
|
</tr>
|
1688
1688
|
<tr>
|
@@ -1692,7 +1692,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1692
1692
|
</tr>
|
1693
1693
|
<tr>
|
1694
1694
|
<td height="89" valign="top"><p><em>traceroute</em></p></td>
|
1695
|
-
<td><p>Get the network route to a specified IP address from the
|
1695
|
+
<td><p>Get the network route to a specified IP address from the appliance: <strong>traceroute -a </strong><em>ip-address </em> </p>
|
1696
1696
|
<p class="code_black_background">mu cmd_cli:traceroute -a 10.10.10.1</p></td>
|
1697
1697
|
</tr>
|
1698
1698
|
<tr>
|
@@ -1707,7 +1707,7 @@ style="mso-spacerun: yes"> </span></li>
|
|
1707
1707
|
<tr class="wide">
|
1708
1708
|
<td colspan="2"><p><strong>-m/--mu_string</strong> <em>user</em>:<em>password</em>@<em>mu-ip</em></p>
|
1709
1709
|
<blockquote>
|
1710
|
-
<p>Specify a user, password, and management IP address of
|
1710
|
+
<p>Specify a user, password, and management IP address of the appliance. Example: <span class="code">admin:admin@10.9.8.7</span></p>
|
1711
1711
|
</blockquote></td>
|
1712
1712
|
</tr>
|
1713
1713
|
<tr class="wide">
|
@@ -1786,18 +1786,17 @@ style="mso-spacerun: yes"> </span></li>
|
|
1786
1786
|
</table>
|
1787
1787
|
<p><a href="#top">back to top ↑</a></p>
|
1788
1788
|
<hr />
|
1789
|
-
<h2>
|
1790
|
-
|
1791
|
-
|
1792
|
-
Dynamics Customer Care is available 9am to 5pm PST, Monday to Friday at the
|
1789
|
+
<h2>Spirent Communications Information</h2>
|
1790
|
+
<p>Spirent
|
1791
|
+
Communications Customer Care is available 9am to 5pm PST, Monday to Friday at the
|
1793
1792
|
toll-free support line at 1-866-276-4640; international customers can
|
1794
|
-
also use 1-408-329-6330. For online communication, visit the
|
1795
|
-
|
1793
|
+
also use 1-408-329-6330. For online communication, visit the Spirent
|
1794
|
+
Communications Customer Care Center at <a
|
1796
1795
|
title="https://forms.netsuite.com/app/crm/marketing/campaignlistener.nl?__lstr=__cl&c=590487&__r=-2147483648&__h=895f7f7a297d1138ee45&url=https://owa.musecurity.com/exchweb/bin/redir.asp?URL=https://forms.netsuite.com/app/crm/marketing/campaignlistener.nl?__lstr=__cl%26c=590487%26__r=-2147483648%26__h=895f7f7a297d1138ee45%26url=http://www.mudynamics.com/support/overview.html"
|
1797
1796
|
href="https://forms.netsuite.com/app/crm/marketing/campaignlistener.nl?__lstr=__cl&c=590487&__r=-2147483648&__h=895f7f7a297d1138ee45&url=https://owa.musecurity.com/exchweb/bin/redir.asp?URL=https://forms.netsuite.com/app/crm/marketing/campaignlistener.nl?__lstr=__cl%26c=590487%26__r=-2147483648%26__h=895f7f7a297d1138ee45%26url=http://www.mudynamics.com/support/overview.html"
|
1798
1797
|
target="_blank">http://www.mudynamics.com/support/overview.html</a>. </p>
|
1799
|
-
<p>In addition to
|
1800
|
-
product documentation, you can also get continuous updates on
|
1798
|
+
<p>In addition to UI Help and the
|
1799
|
+
product documentation, you can also get continuous updates on appliance
|
1801
1800
|
capabilities using the following resources: </p>
|
1802
1801
|
<table width="640" border="1" cellpadding="1" cellspacing="1" class="wide">
|
1803
1802
|
<tr>
|
@@ -1822,6 +1821,6 @@ style="mso-spacerun: yes"> </span></li>
|
|
1822
1821
|
</div>
|
1823
1822
|
<div id="siteInfo">
|
1824
1823
|
Copyright
|
1825
|
-
2011
|
1824
|
+
2011, 2012 Spirent Communications plc, All Rights Reserved.</div>
|
1826
1825
|
</body>
|
1827
1826
|
</html>
|
data/README.md
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
#Mu Ruby Gem <a id="top"/>#
|
2
2
|
|
3
|
-
The Mu Ruby gem contains command line application (executables) designed to help you work with Scenarios, Test Sets, Scale tests and all results generated from those tests. The gem also supports older REST API commands that you can use to configure the
|
3
|
+
The Mu Ruby gem contains command line application (executables) designed to help you work with Scenarios, Test Sets, Scale tests and all results generated from those tests. The gem also supports older REST API commands that you can use to configure the test network interfaces on the appliance, get system status, or even access the appliance CLI. API library classes are exposed for use in your own custom gems.
|
4
4
|
|
5
5
|
###Before Using the Gem###
|
6
6
|
|
@@ -13,9 +13,9 @@ includes ruby 1.8.6 and the following gems (<b>`sudo gem install`</b> <em>`gem`<
|
|
13
13
|
- *rest-client*. Used for HTTP calls.
|
14
14
|
- *mime-types*. Required by REST-client.
|
15
15
|
|
16
|
-
You also need to set the following
|
16
|
+
You also need to set the following environment variables:
|
17
17
|
|
18
|
-
- *MU\_IP*. Set the default IP address of the
|
18
|
+
- *MU\_IP*. Set the default IP address of the appliance management interface.
|
19
19
|
- *MU\_ADMIN\_USER*. Set the default name of the admin user.
|
20
20
|
- *MU\_ADMIN\_PASS*. Set the default admin user password.
|
21
21
|
|
@@ -28,7 +28,7 @@ You also need to set the following Mu environment variables:
|
|
28
28
|
- [cmd\_runverify](#cmd_runverify)
|
29
29
|
- [cmd\_runscenario](#cmd_runscenario)
|
30
30
|
|
31
|
-
- [Legacy REST API Commands](#legacy) provide access to legacy REST API commands supported by the
|
31
|
+
- [Legacy REST API Commands](#legacy) provide access to legacy REST API commands supported by the appliance.
|
32
32
|
|
33
33
|
- [cmd\_ddt](#cmd_ddt)
|
34
34
|
- [cmd\_scale](#cmd_scale)
|
@@ -81,8 +81,8 @@ running Scale tests.
|
|
81
81
|
Use to run Scale tests for a multi-host App-ID .msl file or a directory
|
82
82
|
of .msl files. Supports command-line options for setting test parameters
|
83
83
|
(such as concurrency and pattern) and for configuring a client/server
|
84
|
-
passthrough Test Bed.
|
85
|
-
App-ID Scenario to just two hosts, which must be set to two
|
84
|
+
passthrough Test Bed. Spirent Studio automatically collapses all hosts in the
|
85
|
+
App-ID Scenario to just two hosts, which must be set to two appliance interfaces.
|
86
86
|
|
87
87
|
» see [cmd_appid options](#cmd_appid_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
88
88
|
|
@@ -128,11 +128,11 @@ admin:admin@10.10.2.2 -p 1-100000:360`
|
|
128
128
|
|
129
129
|
**-i**/**--interfaces** <interfaces\>
|
130
130
|
|
131
|
-
> Specify
|
131
|
+
> Specify test interfaces as a comma-separated list. Example: `b1,b2`. When using an IP range, specify range and offset. Example: `b1-1000:0,b2`.
|
132
132
|
|
133
133
|
**-m**/**--mu\_string** *user:pass@mu-ip*
|
134
134
|
|
135
|
-
> Specify the user, password, and
|
135
|
+
> Specify the user, password, and management IP of the appliance. Example: `admin:admin@10.9.8.7`.
|
136
136
|
|
137
137
|
**-o**/**--output** <filename\>
|
138
138
|
|
@@ -161,7 +161,7 @@ admin:admin@10.10.2.2 -p 1-100000:360`
|
|
161
161
|
Use to run Scale tests by specifying a Scenario .msl file or a directory
|
162
162
|
of .msl files. Supports command-line options for setting test parameters
|
163
163
|
(such as concurrency and pattern) and for configuring the Test Bed with
|
164
|
-
|
164
|
+
appliance interfaces and/or network hosts.
|
165
165
|
|
166
166
|
» see [cmd_runscale options](#cmd_runscale_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
167
167
|
|
@@ -221,11 +221,11 @@ search.
|
|
221
221
|
|
222
222
|
**-i/--interfaces** *interfaces*
|
223
223
|
|
224
|
-
> Specify
|
224
|
+
> Specify test interfaces as a comma-separated list. Example: `b1,b2`. When using an IP range, specify range and offset. Example: `b1-1000:0,b2`.
|
225
225
|
|
226
226
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
227
227
|
|
228
|
-
> Specify the user, password, and
|
228
|
+
> Specify the user, password, and management IP of the appliance. Example: `admin:admin@10.9.8.7`.
|
229
229
|
|
230
230
|
**-o/--output** *filename*
|
231
231
|
|
@@ -256,7 +256,7 @@ search.
|
|
256
256
|
|
257
257
|
###cmd\_runverify <a id="cmd_runverify"/>###
|
258
258
|
|
259
|
-
Use to load a Scenario and Test Set template (.xml files) and run a Test Set in Studio Verify. Supports command-line options for setting option values and for configuring the Test Bed with
|
259
|
+
Use to load a Scenario and Test Set template (.xml files) and run a Test Set in Studio Verify. Supports command-line options for setting option values and for configuring the Test Bed with test interfaces and/or
|
260
260
|
network hosts.
|
261
261
|
|
262
262
|
» see [cmd_runverify options](#cmd_runverify_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
@@ -289,11 +289,11 @@ network hosts.
|
|
289
289
|
|
290
290
|
**-i/--interfaces** *interfaces*
|
291
291
|
|
292
|
-
> Specify
|
292
|
+
> Specify test interfaces and network hosts as a comma-separated list. Example: `b1,b2`. When using an IP range, specify range/offset. Example: `b1-1000:0,web-server`.
|
293
293
|
|
294
294
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
295
295
|
|
296
|
-
> Specify the user, password, and
|
296
|
+
> Specify the user, password, and management IP of the appliance. Example: `admin:admin@10.9.8.7`.
|
297
297
|
|
298
298
|
**-o/--output** *filename*
|
299
299
|
|
@@ -318,7 +318,7 @@ network hosts.
|
|
318
318
|
|
319
319
|
###cmd\_runscenario <a id="cmd_runscenario"/>###
|
320
320
|
|
321
|
-
Use to load and verify a Scenario template (.xml file). Supports command-line options for configuring the Test Bed with
|
321
|
+
Use to load and verify a Scenario template (.xml file). Supports command-line options for configuring the Test Bed with test interfaces and/or network hosts.
|
322
322
|
|
323
323
|
» see [cmd_runscenario options](#cmd_runscenario_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
324
324
|
|
@@ -350,11 +350,11 @@ Use to load and verify a Scenario template (.xml file). Supports command-line op
|
|
350
350
|
|
351
351
|
**-i/--interfaces** *interfaces*
|
352
352
|
|
353
|
-
> Specify
|
353
|
+
> Specify test interfaces and network hosts as a comma-separated list. Example: `b1, b2`. When using an IP range, specify range/offset. Example: `b1-1000:0,web-server`.
|
354
354
|
|
355
355
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
356
356
|
|
357
|
-
> Specify the user, password, and
|
357
|
+
> Specify the user, password, and management IP of the appliance. Example: `admin:admin@10.9.8.7`.
|
358
358
|
|
359
359
|
**-o/--output** *filename*
|
360
360
|
|
@@ -375,7 +375,7 @@ Use to load and verify a Scenario template (.xml file). Supports command-line op
|
|
375
375
|
Use to create .msl files from **H**TTP **Ar**chive (.har) files, which
|
376
376
|
capture web page loading information in JSON format. You can use the
|
377
377
|
<b>`from_har`</b> command to transform a .har file into a Scenario (in .msl
|
378
|
-
format) suitable for import into
|
378
|
+
format) suitable for import into Spirent Studio.
|
379
379
|
|
380
380
|
» see [cmd_musl options](#cmd_musl_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
381
381
|
|
@@ -458,7 +458,7 @@ Scenario response.
|
|
458
458
|
##Legacy API Commands <a id="legacy"/>##
|
459
459
|
|
460
460
|
These commands provide access to legacy REST API commands supported by
|
461
|
-
the
|
461
|
+
the appliance.
|
462
462
|
|
463
463
|
- [cmd\_muapi](#cmd_muapi)
|
464
464
|
- [cmd\_netconfig](#cmd_netconfig)
|
@@ -506,11 +506,11 @@ Use to access the legacy REST API for Test Runs (Protocol Mutation, Scenario Mut
|
|
506
506
|
- <b>`backup -c get -n`</b> <em>`filename`</em>
|
507
507
|
- `mu cmd_muapi:backup -c get -n my-backup`
|
508
508
|
|
509
|
-
The
|
509
|
+
The appliance automatically appends the .dat extension to all backup files.
|
510
510
|
|
511
511
|
***capture***
|
512
512
|
|
513
|
-
- Manage packet captures recorded using the
|
513
|
+
- Manage packet captures recorded using the appliance. The <b>`status`</b> and
|
514
514
|
<b>`get`</b> commands require the job-id returned by the <b>`run`</b> command.
|
515
515
|
- <b>`capture -c`</b> <em>`command`</em> <b>`-p`</b> <em>`port-number`</em> <b>`-u`</b> <em>`job-id`</em>
|
516
516
|
- To start recording packets (this command returns the job-id):
|
@@ -607,7 +607,7 @@ The Mu system automatically appends the .dat extension to all backup files.
|
|
607
607
|
|
608
608
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
609
609
|
|
610
|
-
> Specify the user, password, and
|
610
|
+
> Specify the user, password, and management IP of the appliance. Example: `admin:admin@10.9.8.7`.
|
611
611
|
|
612
612
|
**-n/--name** *name*
|
613
613
|
|
@@ -641,7 +641,7 @@ The Mu system automatically appends the .dat extension to all backup files.
|
|
641
641
|
|
642
642
|
###cmd\_netconfig <a id="cmd_netconfig"/>###
|
643
643
|
|
644
|
-
Use to access the legacy REST API for configuring
|
644
|
+
Use to access the legacy REST API for configuring test interfaces, network
|
645
645
|
hosts, and routes.
|
646
646
|
|
647
647
|
» see [cmd_netconfig options](#cmd_netconfig_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
@@ -654,25 +654,25 @@ hosts, and routes.
|
|
654
654
|
|
655
655
|
***clear\_hosts***
|
656
656
|
|
657
|
-
- Remove all network hosts configured in the
|
657
|
+
- Remove all network hosts configured in the appliance.
|
658
658
|
- <b>`clear_hosts`</b>
|
659
659
|
- `mu cmd_netconfig:clear_hosts`
|
660
660
|
|
661
661
|
***clear\_interface***
|
662
662
|
|
663
|
-
- Clear settings for specified
|
663
|
+
- Clear settings for specified test interfaces.
|
664
664
|
- <b>`clear_interface -i`</b> <em>`interface,interface`</em>
|
665
665
|
- `mu cmd_netconfig:clear_interface -i b1,b2`
|
666
666
|
|
667
667
|
***clear\_routes***
|
668
668
|
|
669
|
-
- Remove all user-configured routes in the
|
669
|
+
- Remove all user-configured routes in the appliance.
|
670
670
|
- <b>`clear_routes`</b>
|
671
671
|
- `mu cmd_netconfig:clear_routes`
|
672
672
|
|
673
673
|
***clear\_vlans***
|
674
674
|
|
675
|
-
- Remove all vlans for all
|
675
|
+
- Remove all vlans for all test interfaces.
|
676
676
|
- <b>`clear_vlans`</b>
|
677
677
|
- `mu cmd_netconfig:clear_vlans`
|
678
678
|
|
@@ -715,7 +715,7 @@ argument).
|
|
715
715
|
|
716
716
|
***save***
|
717
717
|
|
718
|
-
- Save changes to the
|
718
|
+
- Save changes to the appliance.
|
719
719
|
- <b>`save`</b>
|
720
720
|
- `mu cmd_netconfig:save`
|
721
721
|
|
@@ -739,7 +739,7 @@ argument).
|
|
739
739
|
|
740
740
|
**-i/--interfaces** *interface-or-host*
|
741
741
|
|
742
|
-
> Specify
|
742
|
+
> Specify test interfaces or network hosts as a comma-separated list. Example: `b1,web-server`.
|
743
743
|
|
744
744
|
**-j/--json** *object*
|
745
745
|
|
@@ -747,7 +747,7 @@ argument).
|
|
747
747
|
|
748
748
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
749
749
|
|
750
|
-
> Specify a user, password, and management IP of
|
750
|
+
> Specify a user, password, and management IP of the appliance. Example: `admin:admin@10.9.8.7`.
|
751
751
|
|
752
752
|
**-o/--output** *filename*
|
753
753
|
|
@@ -827,7 +827,7 @@ Use to access the legacy REST API for Test Sets (Studio Verify).
|
|
827
827
|
|
828
828
|
***setup\_test***
|
829
829
|
|
830
|
-
- Setup the Test Bed, reserving the
|
830
|
+
- Setup the Test Bed, reserving the test interfaces.
|
831
831
|
- <b>`setup_test`</b>
|
832
832
|
- `mu cmd_ddt:setup_test`
|
833
833
|
|
@@ -857,7 +857,7 @@ Use to access the legacy REST API for Test Sets (Studio Verify).
|
|
857
857
|
|
858
858
|
***teardown\_test***
|
859
859
|
|
860
|
-
- Unsets the Test Bed selections, releasing the
|
860
|
+
- Unsets the Test Bed selections, releasing the test interfaces.
|
861
861
|
- <b>`teardown_test`</b>
|
862
862
|
- `mu cmd_ddt:teardown_test`
|
863
863
|
|
@@ -875,13 +875,13 @@ Use to access the legacy REST API for Test Sets (Studio Verify).
|
|
875
875
|
|
876
876
|
***csv\_export***
|
877
877
|
|
878
|
-
- Exports a Test Set from the
|
878
|
+
- Exports a Test Set from the appliance to a csv file.
|
879
879
|
- <b>`csv_export -u`</b> <em>`uuid`</em>
|
880
880
|
- `mu cmd_ddt:csv_export -u 52add3cf-9040-42ce-b263-8233039931d5`
|
881
881
|
|
882
882
|
***csv\_import***
|
883
883
|
|
884
|
-
- Imports a .csv file to create a Test Set on the
|
884
|
+
- Imports a .csv file to create a Test Set on the appliance.
|
885
885
|
- <b>`csv_import -t`</b> <em>`filename.csv`</em>
|
886
886
|
- `mu cmd_ddt:csv_import -t my-testset.csv`
|
887
887
|
|
@@ -897,7 +897,7 @@ Use to access the legacy REST API for Test Sets (Studio Verify).
|
|
897
897
|
|
898
898
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
899
899
|
|
900
|
-
> Specify a user, password, and management IP address of
|
900
|
+
> Specify a user, password, and management IP address of the appliance. Example: `admin:admin@10.9.8.7`.
|
901
901
|
|
902
902
|
**-n/--names** *name-array*
|
903
903
|
|
@@ -1061,7 +1061,7 @@ Use to access the legacy REST API for Scale tests (Studio Scale).
|
|
1061
1061
|
|
1062
1062
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
1063
1063
|
|
1064
|
-
> Specify a user, password, and
|
1064
|
+
> Specify a user, password, and management IP of the appliance. Example: `admin:admin@10.9.8.7`.
|
1065
1065
|
|
1066
1066
|
**-o/--output** *filename*
|
1067
1067
|
|
@@ -1095,13 +1095,13 @@ Use to access the legacy REST API for Scale tests (Studio Scale).
|
|
1095
1095
|
|
1096
1096
|
###cmd\_homepage <a id="cmd_homepage"/>###
|
1097
1097
|
|
1098
|
-
Use to access information displayed on the
|
1098
|
+
Use to access information displayed on the appliance UI homepage, such as recent updates, backup status, or a list of latest test results.
|
1099
1099
|
|
1100
1100
|
» see [cmd_homepage options](#cmd_homepage_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
1101
1101
|
|
1102
1102
|
***all***
|
1103
1103
|
|
1104
|
-
- Gets the complete set of information displayed on the
|
1104
|
+
- Gets the complete set of information displayed on the appliance UI home page.
|
1105
1105
|
- <b>`all`</b>
|
1106
1106
|
- `mu cmd_homepage:all`
|
1107
1107
|
|
@@ -1125,7 +1125,7 @@ Use to access information displayed on the Mu UI homepage, such as recent update
|
|
1125
1125
|
|
1126
1126
|
***recent***
|
1127
1127
|
|
1128
|
-
- Gets the "What's New" section from the
|
1128
|
+
- Gets the "What's New" section from the appliance UI homepage.
|
1129
1129
|
- <b>`recent`</b>
|
1130
1130
|
- `mu cmd_homepage:recent`
|
1131
1131
|
|
@@ -1143,7 +1143,7 @@ Use to access information displayed on the Mu UI homepage, such as recent update
|
|
1143
1143
|
|
1144
1144
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
1145
1145
|
|
1146
|
-
> Specify a user, password, and management IP address of
|
1146
|
+
> Specify a user, password, and management IP address of the appliance. Example: `admin:admin@10.9.8.7`.
|
1147
1147
|
|
1148
1148
|
**-o/--output** *filename*
|
1149
1149
|
|
@@ -1157,13 +1157,13 @@ Use to access information displayed on the Mu UI homepage, such as recent update
|
|
1157
1157
|
|
1158
1158
|
###cmd\_system <a id="cmd_system"/>###
|
1159
1159
|
|
1160
|
-
Use to restart system services or to get status details for the
|
1160
|
+
Use to restart system services or to get status details for the appliance.
|
1161
1161
|
|
1162
1162
|
» see [cmd_system options](#cmd_system_options) | » see [documentation format](#documentation_format) | » back to [top](#top)
|
1163
1163
|
|
1164
1164
|
***restart***
|
1165
1165
|
|
1166
|
-
- Restart
|
1166
|
+
- Restart Studio services (this does not reboot the appliance).
|
1167
1167
|
- <b>`restart`</b>
|
1168
1168
|
- `mu cmd_system:restart`
|
1169
1169
|
|
@@ -1187,7 +1187,7 @@ Use to restart system services or to get status details for the Mu system.
|
|
1187
1187
|
|
1188
1188
|
**-m/--mu\_string** *user*:*password*@*mu-ip*
|
1189
1189
|
|
1190
|
-
> Specify a user, password, and management IP address of
|
1190
|
+
> Specify a user, password, and management IP address of the appliance. Example: `admin:admin@10.9.8.7`.
|
1191
1191
|
|
1192
1192
|
**-o/--output** *filename*
|
1193
1193
|
|
@@ -1219,7 +1219,7 @@ Use to access the Mu CLI.
|
|
1219
1219
|
|
1220
1220
|
***ping***
|
1221
1221
|
|
1222
|
-
- Ping the specified IP address from the
|
1222
|
+
- Ping the specified IP address from the appliance.
|
1223
1223
|
- <b>`ping -a`</b> <em>`ip-address`</em>
|
1224
1224
|
- `mu cmd_cli:ping -a 10.10.10.1`
|
1225
1225
|
|
@@ -1231,7 +1231,7 @@ Use to access the Mu CLI.
|
|
1231
1231
|
|
1232
1232
|
***traceroute***
|
1233
1233
|
|
1234
|
-
- Get the network route to a specified IP address from the
|
1234
|
+
- Get the network route to a specified IP address from the appliance.
|
1235
1235
|
- <b>`traceroute -a`</b> <em>`ip-address`</em>
|
1236
1236
|
- `mu cmd_cli:traceroute -a 10.10.10.1`
|
1237
1237
|
|
@@ -1243,7 +1243,7 @@ Use to access the Mu CLI.
|
|
1243
1243
|
|
1244
1244
|
**-m/--mu\_string** *user***:***password***@***mu-ip*
|
1245
1245
|
|
1246
|
-
> Specify a user, password, and management IP address of
|
1246
|
+
> Specify a user, password, and management IP address of the appliance. Example: `admin:admin@10.9.8.7`.
|
1247
1247
|
|
1248
1248
|
**-o/--output** *filename*
|
1249
1249
|
|
@@ -1308,4 +1308,4 @@ must pass the file contents encoded as a Ruby string. For example:
|
|
1308
1308
|
|
1309
1309
|
* * * * *
|
1310
1310
|
|
1311
|
-
Copyright 2012
|
1311
|
+
Copyright 2012 Spirent Communications plc, All Rights Reserved.
|
data/lib/mu/har.rb
CHANGED
@@ -453,7 +453,7 @@ class Har
|
|
453
453
|
cs_send.literal_no_format("\"");
|
454
454
|
else
|
455
455
|
# If the payload contains a string that looks like it will require ruby variable interpolation #{} => \x23{} when escaped
|
456
|
-
if(payload =~ /#\{
|
456
|
+
if(payload =~ /#\{.*\}/)
|
457
457
|
new_payload = payload.split(/#\{/).join("#\"\n\"{")
|
458
458
|
payload = new_payload
|
459
459
|
end
|
data/lib/mu/maker.rb
CHANGED
@@ -1,3 +1,5 @@
|
|
1
|
+
require 'mu/helper'
|
2
|
+
|
1
3
|
module MuSL
|
2
4
|
# A simple DSL for making MuSL code. Invoke thusly and provided nested
|
3
5
|
# blocks to construct the scenario:
|
@@ -17,6 +19,8 @@ class Maker
|
|
17
19
|
end
|
18
20
|
|
19
21
|
class Scenario
|
22
|
+
include Mu::Helper
|
23
|
+
|
20
24
|
def depth
|
21
25
|
@depth ||= 0
|
22
26
|
end
|
@@ -83,10 +87,6 @@ class Maker
|
|
83
87
|
end
|
84
88
|
end
|
85
89
|
|
86
|
-
def escape text
|
87
|
-
text.gsub(/\\/, '\\\\').gsub(/\r/, '\\r').gsub(/\n/, '\\n').gsub(/"/, '\\"')
|
88
|
-
end
|
89
|
-
|
90
90
|
def attrs kvs = {}
|
91
91
|
return '' if kvs.empty?
|
92
92
|
|
@@ -174,6 +174,8 @@ class Maker
|
|
174
174
|
end
|
175
175
|
|
176
176
|
class Send < Block
|
177
|
+
include Mu::Helper
|
178
|
+
|
177
179
|
def base64_encode kvs={}
|
178
180
|
if block_given?
|
179
181
|
scenario.block 'base64_encode' + scenario.attrs(kvs) + ' [', ']' do
|
@@ -238,12 +240,12 @@ class Maker
|
|
238
240
|
yield self
|
239
241
|
end
|
240
242
|
else
|
241
|
-
scenario.line('"' +
|
243
|
+
scenario.line('"' + escape(text) + '\r\n"')
|
242
244
|
end
|
243
245
|
end
|
244
246
|
|
245
247
|
def string text=''
|
246
|
-
scenario.line('"' +
|
248
|
+
scenario.line('"' + escape(text) + '"')
|
247
249
|
end
|
248
250
|
|
249
251
|
def literal text
|
data/version.rb
CHANGED
@@ -1 +1 @@
|
|
1
|
-
VERSION='5.7.
|
1
|
+
VERSION='5.7.39'
|
metadata
CHANGED
@@ -1,92 +1,90 @@
|
|
1
|
-
--- !ruby/object:Gem::Specification
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
2
|
name: mu
|
3
|
-
version: !ruby/object:Gem::Version
|
4
|
-
version: 5.7.
|
5
|
-
prerelease:
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 5.7.39
|
6
5
|
platform: ruby
|
7
|
-
authors:
|
6
|
+
authors:
|
8
7
|
- MuEng
|
9
8
|
autorequire:
|
10
9
|
bindir: bin
|
11
10
|
cert_chain: []
|
12
|
-
|
13
|
-
|
14
|
-
|
11
|
+
|
12
|
+
date: 2012-08-17 00:00:00 -07:00
|
13
|
+
default_executable:
|
14
|
+
dependencies:
|
15
|
+
- !ruby/object:Gem::Dependency
|
15
16
|
name: nokogiri
|
16
|
-
requirement: &2162368720 !ruby/object:Gem::Requirement
|
17
|
-
none: false
|
18
|
-
requirements:
|
19
|
-
- - ! '>='
|
20
|
-
- !ruby/object:Gem::Version
|
21
|
-
version: 1.4.4
|
22
17
|
type: :runtime
|
23
|
-
|
24
|
-
version_requirements:
|
25
|
-
|
18
|
+
version_requirement:
|
19
|
+
version_requirements: !ruby/object:Gem::Requirement
|
20
|
+
requirements:
|
21
|
+
- - ">="
|
22
|
+
- !ruby/object:Gem::Version
|
23
|
+
version: 1.4.4
|
24
|
+
version:
|
25
|
+
- !ruby/object:Gem::Dependency
|
26
26
|
name: rest-client
|
27
|
-
requirement: &2162368260 !ruby/object:Gem::Requirement
|
28
|
-
none: false
|
29
|
-
requirements:
|
30
|
-
- - ! '>='
|
31
|
-
- !ruby/object:Gem::Version
|
32
|
-
version: 1.6.1
|
33
27
|
type: :runtime
|
34
|
-
|
35
|
-
version_requirements:
|
36
|
-
|
28
|
+
version_requirement:
|
29
|
+
version_requirements: !ruby/object:Gem::Requirement
|
30
|
+
requirements:
|
31
|
+
- - ">="
|
32
|
+
- !ruby/object:Gem::Version
|
33
|
+
version: 1.6.1
|
34
|
+
version:
|
35
|
+
- !ruby/object:Gem::Dependency
|
37
36
|
name: mime-types
|
38
|
-
requirement: &2162358160 !ruby/object:Gem::Requirement
|
39
|
-
none: false
|
40
|
-
requirements:
|
41
|
-
- - ! '>='
|
42
|
-
- !ruby/object:Gem::Version
|
43
|
-
version: '1.16'
|
44
37
|
type: :runtime
|
45
|
-
|
46
|
-
version_requirements:
|
47
|
-
|
38
|
+
version_requirement:
|
39
|
+
version_requirements: !ruby/object:Gem::Requirement
|
40
|
+
requirements:
|
41
|
+
- - ">="
|
42
|
+
- !ruby/object:Gem::Version
|
43
|
+
version: "1.16"
|
44
|
+
version:
|
45
|
+
- !ruby/object:Gem::Dependency
|
48
46
|
name: json
|
49
|
-
requirement: &2162357680 !ruby/object:Gem::Requirement
|
50
|
-
none: false
|
51
|
-
requirements:
|
52
|
-
- - ! '>='
|
53
|
-
- !ruby/object:Gem::Version
|
54
|
-
version: '0'
|
55
47
|
type: :runtime
|
56
|
-
|
57
|
-
version_requirements:
|
58
|
-
|
48
|
+
version_requirement:
|
49
|
+
version_requirements: !ruby/object:Gem::Requirement
|
50
|
+
requirements:
|
51
|
+
- - ">="
|
52
|
+
- !ruby/object:Gem::Version
|
53
|
+
version: "0"
|
54
|
+
version:
|
55
|
+
- !ruby/object:Gem::Dependency
|
59
56
|
name: hexy
|
60
|
-
requirement: &2162357140 !ruby/object:Gem::Requirement
|
61
|
-
none: false
|
62
|
-
requirements:
|
63
|
-
- - ! '>='
|
64
|
-
- !ruby/object:Gem::Version
|
65
|
-
version: 0.1.1
|
66
57
|
type: :runtime
|
67
|
-
|
68
|
-
version_requirements:
|
69
|
-
|
58
|
+
version_requirement:
|
59
|
+
version_requirements: !ruby/object:Gem::Requirement
|
60
|
+
requirements:
|
61
|
+
- - ">="
|
62
|
+
- !ruby/object:Gem::Version
|
63
|
+
version: 0.1.1
|
64
|
+
version:
|
65
|
+
- !ruby/object:Gem::Dependency
|
70
66
|
name: uuid
|
71
|
-
requirement: &2162356600 !ruby/object:Gem::Requirement
|
72
|
-
none: false
|
73
|
-
requirements:
|
74
|
-
- - ! '>='
|
75
|
-
- !ruby/object:Gem::Version
|
76
|
-
version: 2.0.2
|
77
67
|
type: :runtime
|
78
|
-
|
79
|
-
version_requirements:
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
68
|
+
version_requirement:
|
69
|
+
version_requirements: !ruby/object:Gem::Requirement
|
70
|
+
requirements:
|
71
|
+
- - ">="
|
72
|
+
- !ruby/object:Gem::Version
|
73
|
+
version: 2.0.2
|
74
|
+
version:
|
75
|
+
description: |-
|
76
|
+
The Mu gem allows users to include Mu libraries within scripts
|
77
|
+
that interact with the appliance software. The gem also supplies command line interfaces
|
78
|
+
to many of these same libraries
|
79
|
+
email:
|
80
|
+
- support@mudynamics.com
|
81
|
+
executables:
|
86
82
|
- mu
|
87
83
|
extensions: []
|
84
|
+
|
88
85
|
extra_rdoc_files: []
|
89
|
-
|
86
|
+
|
87
|
+
files:
|
90
88
|
- lib/mu/api/ddt.rb
|
91
89
|
- lib/mu/api/homepage.rb
|
92
90
|
- lib/mu/api/muapi.rb
|
@@ -121,28 +119,33 @@ files:
|
|
121
119
|
- version.rb
|
122
120
|
- LICENSE.txt
|
123
121
|
- README.md
|
124
|
-
|
122
|
+
has_rdoc: true
|
123
|
+
homepage: http://www.spirent.com
|
125
124
|
licenses: []
|
125
|
+
|
126
126
|
post_install_message:
|
127
127
|
rdoc_options: []
|
128
|
-
|
128
|
+
|
129
|
+
require_paths:
|
129
130
|
- lib
|
130
|
-
required_ruby_version: !ruby/object:Gem::Requirement
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
- !ruby/object:Gem::Version
|
131
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
132
|
+
requirements:
|
133
|
+
- - ">="
|
134
|
+
- !ruby/object:Gem::Version
|
135
135
|
version: 1.8.7
|
136
|
-
|
137
|
-
|
138
|
-
requirements:
|
139
|
-
- -
|
140
|
-
- !ruby/object:Gem::Version
|
141
|
-
version:
|
136
|
+
version:
|
137
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
138
|
+
requirements:
|
139
|
+
- - ">="
|
140
|
+
- !ruby/object:Gem::Version
|
141
|
+
version: "0"
|
142
|
+
version:
|
142
143
|
requirements: []
|
144
|
+
|
143
145
|
rubyforge_project:
|
144
|
-
rubygems_version: 1.
|
146
|
+
rubygems_version: 1.3.5
|
145
147
|
signing_key:
|
146
148
|
specification_version: 3
|
147
|
-
summary:
|
149
|
+
summary: Spirent Communications General Purpose Library and Command Line Tool
|
148
150
|
test_files: []
|
151
|
+
|