ET/BWMGR V8 Upgrade Guide

If you've used previous versions of the ET/BWMGR, or you have an existing system, you will have to adjust. your rulesets to accommodate a new way of thinking about traffic management. Following are some of the notable changes you'll have to consider.

Notable Changes

- License files are moved to /etc/bwmgr
- License request files are now sent directly to ET and not stored on the system
- BWMGR utilities are moved to /usr/local/bin
- There is 1 ruleset; rules are no longer associated with interfaces
- Paths define how traffic moves through the system
- Bursting is now internalized
- Rules can now have more than 1 address
- Sections and Groups are now detached from the ruleset
- Alerts have been replaced with Messages where operators can post
- You can now select the number of CPUS to display (Sorted by Usage) to accommodate many core systems

Migrating Your Data from V6 to V8

Two utilities are provided on your V8 system that can be used to import your profiles, users, customers and graph data to your new system.

/etc/bwmgr/utils/dump_bwmgrv6 /etc/bwmgr/dump_bwdatav6

You'll find these 2 files on your v8 system. You'll need to copy these 2 files from your v8 system to /usr/local/bin on your v6 system. After copying them, make sure they are executable:

chmod +x /usr/local/bin/dump_bw* rehash

dump_bwmgrv6

dump_bwmgrv6 can be used to create a file that will allow you to import your settings into your v8 system.

This utility will generate mysql statements to import the bwprofiles, time_profiles, customers, users, user_roles and quota_plans to your V8 system.

dump_bwmgrv6 > bwmgrv6.sql

When completed, check the file to make sure it didn't terminate with an error.

dump_bwdatav6

Usage: dump_bwdata Y-m-d

This utility dumps your graph data into a file that can be imported into your v8 system. Depending on how many rules you have, this file can be quite large. You can specify a date up to 6 months from the date of generation.

Note that you can run this program multiple time with overlap so you can get the bulk of the data when you initially build your system; and then you can run it again before you cut over to get as much of the data as possible.

dump_bwmgrv6 2025-7-1 > bwdatav6.sql

This will dump all of the date from July 1st.

Once completed, you should check the file to make sure it didn't terminate with an error:

tail bwdatav6.sql

INSERT IGNORE into bwdatav8 set `name`='AllTraffic',`date`='2025-08-12',`stamp`='1755029400',`duration`='300',`bps_in`='0',`bps_out`='0',`pps_in`='0',`pps_out`='0'; INSERT IGNORE into bwdatav8 set `name`='AllTraffic',`date`='2025-08-12',`stamp`='1755029700',`duration`='300',`bps_in`='0',`bps_out`='0',`pps_in`='0',`pps_out`='0';

You should see some INSERT statements, and the file should be quite large if you have graph data. If so you're ready to import.

Importsql

Copy the file to your V8 system and run imporsql to import your data:

importsql etbwmgr bwmgrv6.sqlimportsql etbwmgr bwdatav6.sql

Error messages will be displayed on the terminal. Please report any errors that you cannot resolve.