Dec 20th, 2018
First Posted
May 30th, 2012

Appliance USB Demo

The Appliance USB Demo is a self-contained, bootable system image file that will allow you to verify hardware compatibility and test product features before purchasing a Software License, and also allows for product testing prior to the purchase of a Hardware Appliance. Once you download the image and burn it to a locally-purchased USB flash drive, you can then boot from USB and test a fully functional ET/BWMGR Bandwidth Management system in your network.

Choosing Hardware

If you need to manage a lot of traffic, we recommend buying a Hardware Appliance; not because we make more money, but because we can fully support it. We actually charge more for software in many cases, because it's more work for us to support untested hardware, than it is to support hardware that we have in our development lab. When choosing hardware, please use our hardware selection guide.

Burning the USB Image

To download and write the image, you will need a computer with internet access, running Linux, FreeBSD, Windows, or Mac OS X, and a USB flash drive of 2GB or greater size. Windows machines will need additional software to "burn" the image to the USB device.

General Hardware Requirements

To boot and run the demo, you will need the following:

  • Intel or AMD 64 Bit CPU
  • 2 or 3 compatible Ethernet interfaces for bridging (see the hardware list above.) While the system with work with only 2 interfaces, 3 is highly recommended for performance reasons.
  • USB 2.0 ports and BIOS support for booting from USB flash drive.
  • 4GB RAM, 8GB+ recommended
  • Safari or Chrome Web Browser (to access the product GUI)

It's best to use the 3-port configuration to test the demo, especially if you are testing performance on a fast network segment. While the product will operate with 2 ports, it completely changes how the system works, as the IP address will be attached to the same bridge that is passing the managed traffic. Having 2 dedicated ports for managing traffic is a much more efficient use of hardware. However, if you simply want to explore the GUI and product features on a single connection or small test network, using 2 ports is an acceptable configuration, just not the recommended production set-up.

Demo Limitations

When you first boot the Demo USB, the ET/BWMGR is restricted to operating in Test Mode. In Test Mode, you can pass data, create up to 10 rules and gather statistics for 1 hour. The system will not shape or limit traffic in Test Mode, and the monitor will drop packets if there are more than 100pps. The purpose of Test Mode is to determine if your hardware is compatible with the software, and can pass traffic through the bridge properly.

After you've verified your hardware, you can install the product to hard drive and continue your testing. The next step is to request a Demo License that will allow you to run a fully functional system for up to 4 hours at a time for 20 days. In order to re-start the Demo at the end of each 4 hour period, a reboot will be required. Once your test requirements have been satisfied, you can proceed with either a license purchase, or a hardware appliance.

Request To Download the Demo Image

To avoid excessive downloads by curiosity seekers, we ask that you contact us prior to downloading the demo image. Please open a sales ticket and tell us about your company's needs. Please fill out the contact form, including company name and phone number. In the contact form, please include the IP address you will be downloading from, so that we can set up access to the USB image. While we cannot always comment on individual hardware, providing your motherboard model and CPU type, along with your maximum throughput requirements will allow us to better assist you in your demo or purchase planning.

The Demo Image is 64 bits only.

Downloading the Image

Once you receive the download link on the sales ticket, sownload the file to your desktop machine and write the image to the USB flash drive (see instructions below).
The file has a .zip extension. In OS/X, it may automatically decompress after the download, if not, it will when you click on it. To do it manually:

unzip filename.zip

The resulting file should be an approximately 1.8GB file with a .img extension.

Windows XP, Vista, 7

To download the image, click on the link in the ticket. You will also need the Image Writer for Windows software to properly write the image to the USB flash drive, as it cannot be copied by simply dragging or pasting. You will see the download link on the right side of the page, in the green box: download the latest binary (version 5.0.12 at the time of writing). You may also need WinZip to extract the image from the .zip file. Once you have installed the software and downloaded and unzipped the image, you can use the Image Writer software to write the image.

Mac OS X

You will not need any special software to write the image. To download the image, click on the link in the ticket, and make note of the folder that it is stored in. Option-click on the download window to open the folder that the download is stored within. If the file is not automatically uncompressed after the download, double-clicking on the file will extract the image file.

Writing the image to your USB flash device

Windows XP, Vista, 7

Click on "Start" and then "My Computer" to open a file manager window. You will see the list of available drives. Plug in the USB flash drive, and you should see a new drive appear. In this example, we see the new device as drive E:.

Double-click on Win32DiskImager.exe to start the program. The default drive is A: so you will likely get an error getting a handle on the device. Click "OK to clear the message. Select your USB drive letter underneath the Device pull-down. Then, click on the folder icon to select the disk image. Make sure you do not select a file with a .zip extension, you need the .img file. Double-check that you have selected the correct USB drive and then click on "Write". Before removing the USB flash drive, eject the disk by right-clicking on the device under "My Computer" and selecting "eject". If your USB device has an activity light, wait for it to stop flashing before removing it from the USB port.

Mac OS X

Insert your USB flash drive. You will not need to initialize, format, or partition the drive. If you see this prompt upon inserting your USB device:

Click Ignore to dismiss the message. Do not eject or format the drive.

Finding the Device Name

Open a terminal window, and run this command to list all detected drives:

$ diskutil list
0: GUID_partition_scheme *250.1 GB disk0
1: Apple_HFS Macintosh HD 200.0 GB disk0s1

0: FDisk_partition_scheme *3.9 GB disk1
1: DOS_FAT_32 NONAME 4.0 GB disk1s1

The main system/root disk should be on disk0. In this example, our USB disk is named disk1. As with most newly-purchased USB drives, it has a MS-DOS format partition. Whether your USB drive is blank or formatted, you do not need to partition or format the drive.

if you insert a USB drive with MS-DOS or Apple HFS filesystem(s), they will be automatically mounted. You must unmount any such filesystems before you can write the image, and you must do so without ejecting the device. This is how to do that (again, using the example of disk1):

$ diskutil unmountDisk disk1

If you mistakenly eject the device, simply remove and then re-insert the USB device.

Next, in the same terminal window, change your directory to the folder where you downloaded the image. In this example, it is in the Downloads folder. In our example our device is disk1, so we must write the image to the raw device rdisk1. Please double-check your disk name to ensure you don't overwrite the wrong disk!

Replace "#" with the number of your USB disk!

$ cd Downloads
$ dd bs=1m if=etbwmgr-demo-50.18.img of=/dev/rdisk#

Writing the file can take anywhere from 3-15 minutes, depending on the speed of your flash device and USB controller. No information will be printed until the write is complete.

When the write is complete, you will see the pop-up prompt again.

Click on Eject, and then remove the USB disk, which is now ready for use. If you accidentally click on "Ignore", then you can manually eject the disk with this command:

$ diskutil eject disk#

Hardware Bypass / Failover

If you have purchased a software appliance with one of our hardware bypass ethernet cards, you will want to install that before booting from the USB. Power down the machine, and Install the ET/GigFailover in any available PCI-E slot. When powered off, the two ports will be physically connected, acting as a passive crossover coupler. Connect each port to a host or switch, using the cable you would normally use if the port was active - patch cable for a switch, and crossover cable for a host.

It's a good idea to confirm that traffic passes between the connected devices before continuing, to ensure that your "bypass mode" setup is working, as this is the state the card will be in when the unit is either placed manually into the bypass mode, or if it is automatically placed there due to a failure condition.

First Boot

Once the network interfaces are installed, all that's left to do is plug your USB flash drive in the computer you will use for the demo. Make sure that the USB device is the first boot target. Enter the BIOS at boot (usually by pressing "del" or "F2" at boot, depending on the BIOS), and select your USB drive as the first boot device. This may be under the "Boot Order" menu, or some motherboards consider a USB flash drive to be a hard drive, so you must choose the USB device as the first hard drive in that case.

Once the boot is complete, the network setup utility will run automatically. You will need to answer a short series of questions to set up networking, after which you can access the demo machine by telnet, SSH, or the GUI. First, you must choose a password that will be used for all remote access to the demo.

Creating Database..Done

Enter Root/Admin Password: *******
Confirm Password: *******

Updated password of ET/Admin user admin
GUI Password Updated

Connect the administrative interface and press return.

Select the interface you want to be your Administrative Interface

Interface  Status
igb0 Up
igb1 Down
ix0 Down
ix1 Down

Select Interface: em0

Enter IP Address:
Enter IP Mask(
Enter Default Gateway:
Enter DNS Server:
Enter Hostname: etbwmgr

Using the Following Values for em0:
IP Address:
IP Mask:
Default Gateway:
Hostname: etbwmgr
Enter Use these Settings? (y/n): y

Configure Bridging
Interface Status
igb0 Up
igb1 Down
ix0 Down
ix1 Down

Enter Bridge Outside Interface: ix0
Enter Enter Second Bridge Interface: ix1


Networking is now set up on the system. For initial testing, you can start Test Mode with the following command.

bwmgr_license start test

Logging in

You can log in remotely via Telnet or SSH from your workstation, or you can just keep working on the console. To log in from a terminal, you can log in as "admin", and then su to super user. You'll enter the password you selected when you first booted the demo for both prompts below.

telnet -l admin IP_ADDRESS
user: admin
password: *******

At the prompt, type "su -".

> su -
password: ******

You're now logged into the system console.

Before you can access the gui, you have to set up a small static config file with your local parameter.

cd /usr/local/www/bwmgr/config
cp static-config.default static-config.php

and then edit static-config.php with your local settings.

Accessing the GUI (Graphical User Interface)

The GUI runs as the Document Root on the system, so to access it you'll need to fire up a browser. We recommend either Safari or Chrome. We develop in Safari, so we highly recommend that you use that.

Just enter the address of the Demo Appliance and you should get a login page.

Enter Admin as the user and your password, and it should bring you to the main screen.

Installing to Hard Drive

The next step is to install the software to a hard drive. While the software will run from a USB, everything will be very slow, and you'll run out of space quickly. To install to an attached hard drive:

Verify the Hard Drive is detected and determine the device name:

ada0 [305245 MB] WDC WD3200AAJS-56M0A0 (01.03E01) (Blank)
da0 [7389 MB] Kingston DataTraveler 2.0 1.00 (BSD / Configured / Root)

To install to ada0:

diskutil ada0 build

This will wipe out the disk and build and format a file system for the install. All parameters are auto-configured, so there's nothing to compute. It will ask you to verify that you want to initialize the disk. To install the software:

diskutil ada0 install

Once the system is installed, you should halt the system with the 'halt' command, remove the USB and then reboot from the hard drive.

Initial Setup

The system includes a test license which will run for 1 hour after a fresh booth. The test will allow you to create rules and see matches, but it won't do any shaping or firewalling and the monitor is not functional. To start, you should set up a system and verify that you can successfully pass traffic at full speed. First, go to Admin->Settings and set your basic settings:

You should set up your default interface, the meters interface and the Max Throughput. Your Default Interface and Meters Interface are usually the one you set to "Outside" in the setup. ix0 in our case.

The meters can also be scaled to the amount of traffic you have, or your license limit. This must be a multiple of 10Mb/s. Hit Save Settings when you're done to save the settings.

Add A Rule

Next you should add a rule. First select the interface to your outside interface.

Now add a rule that matches everything.

Now you may start to see hits on the rule right away. If you don't, you can check your interfaces in the ifacs tab.

You should see the 2 bridge interfaces showing the link as "up". The Active / InActive tells you if there are rules on the interfaces; both interfaces on a bridge cannot be active. If you are routing or using NAT then you can have rules on both interfaces in your path.

If all goes well, you'll see hits on the rule.

After some time you can click on the graph icon to see that graph data is being gathered correctly.

Obtaining a Demo License

Test most will not enforce firewall rules or shape/limit traffic. You will only see "hits" on the rules. You'll need a demo license to test the product.

You can issue a request for a demo license right from the GUI using the License link. If you are running ET/BWMGR v5.0.32 or earlier, then you will need to generate the file manually using the bwmgr_license command-line utility.

After we issue the license (you can use the Check License button to see if it's been issued), you'll need to run Admin->Update to get the necessary modules to replace the basic demo modules.

Next Steps

See the for examples on how to set up a factory-fresh bandwidth management appliance, or skip right to the Appliance Manual for advanced instructions for a long-term demo or permanent installation.

Add Comment