Run the command line version of the 8x8 Network Utility for Windows
The 8x8 Network Utility can also be run from a command line in the DOS window. When tests are completed from the command line, they are automatically sent to 8x8.
To install, open DOS, and navigate to where you unzipped the 8x8 Network Utility files. Launch the utility using the following format for adding the required switches:
8x8NetUtil.exe [/K:key /C:company] [/I:site-identifier] [/T:test-flags] [/N:repeat-count | /D:repeat-duration] [/S:silent-mode] [/O:output-path] [/A:accept-terms-and-conditions] [/F:force-interface] [/P:profile]
To view the help screen, run the utility with /?.
Running the 8x8NetUtil command with no command line switches runs all tests once, using the previously activation code and site identifier (if entered). Otherwise, the test fails and displays a notification that the utility has not been activated.
Use command switches
The command line version of the 8x8 Network Utility is controlled via command switches and test flags:
| Command | Description |
|---|---|
| /K | Key - The 12-digit alphanumeric activation key generated by 8x8. If a key is specified, a company name must be present. |
| /C | Company - The company name associated with the activation key, if it has been specified by 8x8. If the key has not been registered yet, this is the name that will be registered with the key. If a company name is specified, a key must be present. |
| /l | Site identifier - Any identifier you wish to use to identify the specific location where the diagnostic tool is running (location, branch, etc). |
| /T |
Test flags - The test (or list of tests) to run:
|
| /R | Repeat interval - How often the tests should repeat, in minutes. If the selected tests run longer than this value, the tests repeat immediately. If the repeat interval is not specified, but /N or /D are specified, the tests run as quickly as possible. |
| /N | Repeat count - The number of times the tests should be run. The value must be greater than <1>. |
| /D | Repeat duration - The total length of time the tests should run, in minutes. If this value is less than the repeat interval, the tests will only run once. The value must be greater than <0>. |
| /S | Silent - Determines whether the tool is visible or invisible as the test runs. The value must be <1> to run silently, or <0> to run visibly. |
| /O | Output file - Designates an alternate place to output the saved log file. |
| /M | Monitor mode - Allows the continuous monitoring mode to run; any tests defined with /T are ignored. The value must be <1> to run monitoring mode, or <0> to run a defined test. |
| /A | Accept terms and conditions - Accepts the terms and conditions automatically without showing the user a prompt. The value must be set to <1> to accept. |
| /P | Profile - Runs the predefined profile (Baseline, Monitor, Quick, Continuous, Custom). |
| /F | Force-interface - Forces the tool to use a particular network interface wherever possible. |
| /? | Help - Displays the help screen. |
If you run the command line without first accepting the terms and conditions from the GUI, you are prompted on the first instance to accept the terms and conditions. Simply enter <Y> in the command line to accept. The terms and conditions can also be accepted automatically by including /A:1 in the command line.
Run the baseline test via command line
The following example uses the key <abc1234def456>, the company name <CompanyName>, the site identifier <branch23>, runs all tests only one time, automatically accepts the terms and conditions, and sends the results to 8x8:
8x8NetUtil.exe /K:abc1234def456 /C:CompanyName /I:branch23 /P:"Baseline" /S:1 /A:1
If you must use spaces (not recommended), use quotes where needed:
8x8NetUtil.exe /K:abc1234def456 /C:“Company Name” /I:“branch 23” /P:"Baseline" /S:1 /A:1
Run the monitor test via command line
The following example uses the key <abc1234def456>, the company name <CompanyName>, the site identifier <branch23>, runs only the media test 250 times silently (invisibly), automatically accepts the terms and conditions, and sends the results to 8x8:
8x8NetUtil.exe /K:abc12def456 /C:CompanyName /I:branch23 /P:"Monitor" /S:1 /A:1
If you must use spaces (not recommended), use quotes where needed:
8x8NetUtil.exe /K:abc12def456 /C:“My Name” /I:“branch 23” /P:"Monitor" /S:1 /A:1
