Upgrading to v6

This document describes the upgrade procedure for an existing ET/BWMGR appliance.

The upgrade to v6 is a 2 step process; first you have to pull down the upgrader, and then you can get the system upgrade. The v6 upgrader has a GUI component and a CLI version; so that something goes wrong with the GUi you can continue the upgrade with the CLI version. The following describes the process of upgrading your current system to v6.

All Systems

No matter what version of ET/BWMGR you're running, You need to pull down the upgrader using your GUI upgrade tool. Most versions have a screen like this:

Upgrader upgrader

If you have a very old system (v5.0.x), you may not have a check upgrader screen. The 5.0 screen looks like this:

Upgrader 50

Just click on Check For Upgrade and it should be able to pull down the upgrade without any problems.

Note that it's possible that the upgrader could fail because the connection was lost (it's a stream and not a tcp connection); if it fails try to refresh and run the upgrade again.

After Downloading the Upgrader

The upgrader package for v6 is just what's needed for the CLI; about 5 files. After you've completed the download you'll need to log into the system and use the CLI Upgrader.

Running the CLI Upgrader

Once you've installed the Upgrader, you can install packages with the CLI upgrader. While you can still use the GUI upgrader to download patches or minor releases once you're running v6; the CLI is the preferred (and supported) way to get your upgrade.

To get the latest files, run rehash (to find the new binaries) and then run the CLI upgrader:

#bwmgrUpgrader getUpgrade

will get whatever files you need to get your system up to date. Answer 'y' to any prompts to install a file over an existing file.

If files are missing after running the command, run it again. It's http so sometimes the connections can fail for various reasons.

After the Upgrade is Complete

Once the upgrade is complete, your GUI will look broken. This is because you have the v6 GUI but you're still running the old system drivers. You need to reboot the system. The Shutdown tab should work as it doesn't require the driver. If not, you can just reboot from the console:

# reboot

After the reboot, refresh your browser and the screen should look something like this if you're running the dark theme:

Bwmgr ready dark

Test the tabs to make sure everything works.

If your DB doesn't Connect

If you changed the password on your DB, you'll need to edit /etc/bwmgr/config.php to the correct credentials.

If your passwords don't work

The upgrade should maintain your passwords, but there's always a chance for a glitch. You can reset the passwords from the CLI

# bwmgr guipassword admin PASSWORD

You can do this for any user at any time to change the password. You need to be logged in as root to run this command.

Important Info on Changes in v6

The biggest change in v6 is that we've replaced the RRD files with a straight DB. There's a number of reasons for this; one is the ridiculous volume of things that are required in the system to use the RRD libraries; another is that they're not as accurate as raw data. So your old data will not show up in graphs.

To transfer your old data to the "bwdata" DB, you can run a provided utility.

# rrd2bwdata

Running this with no parameters will read all of the rrd files in /usr/local/etc/bwmgr/graphs. We HIGHLY RECOMMEND removing old and unneeded rrd files before you upgrade your system. The utility will only copy data that is less than 180 days old. If you need more or want less, you can adjust the $OLDEST variable in /usr/bwmgr/utils/rrd2bwdata

Rrd sixmonths

billingd has been removed from v6; bwmgrd now collects both rule stats and customer billing date. You should remove billingd from your /etc/crontab.

Next: Customer Portal