Appliance Quick-Start Guide

Unpacking

Unpack the appliance. Inside the box you should see 1 or 2 AC power cords and rack-mount accessories.

If you are not familiar with the equipment, we highly recommend that you begin by testing with a small, non- production network, before placing the appliance in a production environment.

Appliance Rear Panel

Your appliance has been configured and is ready to use. Before you use it you should complete some steps to customers and secure your appliance. The main ethernet port is the port labeled igb0. All appliances currently offered have the admin port of igb0. Connect this port to your ethernet network.

The power supplies are auto-switching power supples and can be connected to 120V to 240V.

The appliance can be accessed at address 192.168.0.100. YOu can log in as root with the password saturn5.

Task Summary

- Change Passwords
- Configure IP Address
- Set Time Zone
- Rename the Path(s), if desired
- Set up Services
- Make a Recovery USB)

Logging In to the Appliance

To configure the appliance without having to set up a monitor and keyboard, you can log into the appliance from a terminal.

#ssh -l root 192.168.0.100 The authenticity of host '192.168.0.100 (192.168.0.100)' can't be established. ED25519 key fingerprint is SHA256:xyVti62I0dVYzfrKMT+atEWA2l5QsA7LGfaJ8QIKGoQ. This key is not known by any other names. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added '192.168.0.100' (ED25519) to the list of known hosts. (root@192.168.0.100) Password for root@etbwmgr: Last login: Tue Oct 22 15:47:09 2024 from 192.168.0.141 FreeBSD 14.1-RELEASE BWMGR Wwelcome to the ET/BWMGR Appliance! etbwmgr#

You'll need to run bwmgrSetup to configure your password and network:. The bwmgrSetup utility streamlines this process:

etbwmgr# etbwmgr# bwmgrSetup Re-Initialize mySQL Database? (y/n)?: n etbwmgr Database Exists, Skipping... Change Passwords? (y/n)?: y Enter Root/Admin Password: Confirm Password: Passwords set OK Configure Network? (y/n)?: y Connect the administrative interface and press return Select the interface you want to be your Administrative Interface Interface Status --------- ------ ix0 Down ix1 Down igb0 Up IP: 192.168.0.100 em0 Down Select Interface: igb0 IP Address(192.168.0.100): 192.168.0.99 Enter IP Mask(255.255.255.0): Enter Default Gateway: 192.168.0.1 Enter DNS Server(8.8.8.8): Enter Hostname: FooBox Using the Following Values for : IP Address: 192.168.0.99 IP Mask: 255.255.255.0 Default Gateway: 192.168.0.1 DNS: 8.8.8.8 Hostname: FooBox Use these Settings? (y/n): y Bridge Already Set up, Changes must be made Manually

Setting up Bridging

If you’re setting up a new software appliance you can also use the

If there is no bridge configured, you will be prompted to set one up. You'll also be setting up your outside interface; this is the ethernet port on your bypass card that is connected to the internet router.

etbwmgr# bwmgrSetup Re-Initialize mySQL Database? (y/n)?: n etbwmgr Database Exists, Skipping... Change Passwords? (y/n)?: n Configure Network? (y/n)?: n Do you want to configure Bridging? (y/n): y Connect your Outside Interface and press Return ix0 Down ix1 Down igb0 Up em0 Down Enter Bridge Outside Interface: ix0 Enter Second Bridge Interface: ix1

Note that fiber cards (ix0, ix1) will not show “UP” until the are initialized, so you can’t use the “Connect your Outside Interface” check. ix0 will be the plug at the top of the card.

Once you've completed the utility, your local networking and bridge has been set up. If you have more than 1 bridge and are setting up a software appliance, you'll need to refer to FreeBSD Handbook to see the commands to set up a bridge. You can also edit /etc/rc.bridge to see the commands used to create the first bridge.

Note that the IP address change will not take place until after you boot the system.

Setting up the time zone

We *may* have set up your time zone for you, but we also may not have. For a software appliance you’ll need to change the time zone for both the main system and for PHP which has it’s own setting.

Top see if it’s already setup, use the date command

#etbwmgr# date Tue Oct 22 16:05:27 UTC 2024

The default is UTC; if you don’t see your time zone here you’ll need to set it up.

tzsetup is a guided visual tool to help you set up the correct time zone.

# txsetup

Accessing the HTML GUI

The Bandwidth Manager’s GUI can be accessed at the system’s IP address (currently still 192.168.0.100). The password is initially set to saturn5,; you should change that also.

# bwmgr guipassword admin YOURPASSWORD

After logging in you should see the Graphical Interface.

Enable Services

Navigate to the services menu and set up your services that will start at boot up. bypassd will open the bypass and keep they open; while you’re testing you might wan to open and close them manually with the bypass command

Make a Recovery USB

One you have your system step and, you should make a recovery USB. You'll be able to boot from this or recover files in the event of a crash. You'll need an 8GB or larger USB.

1) Insert the USB into a USB slot in your system
2) Check to conform the USB is detected:

diskutil list

You should see da0 for the USB.

3) Run the backup utility

diskutil da0 backup

If you have a dual disk system and plan to keep a backup, you can skip this step, but a recovery usb will also allow you to reinstall, so it's handy to have just in case.

Next Steps

The basic set-up of your Bandwidth Management Appliance is done. Now it's time to continue to the Appliance Manual.