You are here: Use the Utility for Mac > Run the Command Line Version

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

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:

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

 


Send us your feedback