Run the command line version of the 8x8 Network Utility for Mac

The 8x8 Network Utility can also be run from the command line in the Terminal window. When tests are completed from the command line, they are automatically sent to 8x8.

To install, open Terminal, and navigate to where you unzipped the 8x8 Network Utility files. Launch the utility using the following format for adding the required switches:

./8x8NetUtil [-k key] [-c company name] [-i site identifier] [-t test flags] [-n repeat count | -d repeat duration]

To view the help screen, run the utility with -h.

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.
-i

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:

  • A - All tests (case-sensitive; distinct from test flag a)
  • d - DNS
  • p - Ping
  • h - HTTP
  • t - NTP (time)
  • o - Outbound Connectivity
  • n - NAT
  • s - System Information
  • a - ALG (case-sensitive; distinct from test flag A)
  • m - Media
  • f - Fragmentation
  • r - Traceroute (route)
  • b - Bandwidth
  • l - Bufferbloat
-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.

-o

Output file - Designates an alternate place to output the saved log file.

-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.
-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.

-h

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 -k abc1234def456 -c CompanyName -i branch23 -t A -a 1

If you must use spaces (not recommended), use quotes where needed:

./8x8NetUtil -k abc1234def456 -c “Company Name” -i “branch 23” -t A -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, automatically accepts the terms and conditions, and sends the results to 8x8:

./8x8NetUtil -k abc1234def456 -c CompanyName -i branch23 -t m -n 250 -a 1

If you must use spaces (not recommended), use quotes where needed:

./8x8NetUtil -k abc123def456 -c “Company Name” -i “branch 23” -t m -n 250 -a 1