Upgrading an ET/BWMGR v5 System

This document is antiquated. The procedure is not completely implemented in the GUI.

Check For Upgrade

If you're running 5.0.33 or later, you should have a link on the top menu of the ET/BWMGR GUI titled "Check For Upgrades". If you have that link, skip the next section. If you don't have the link, you'll need to download the upgrader.

Download the Upgrader

You'll need to contact support with your IP to allow the download. Once it is set up, log into your system and su to root. Then do the following:

cd /
tar -xvzf bwmgr_upgrader.tgz

Upgrader download

You can now run the upgrade page in the browser. Log into the ET/BWMGR GUI, and enter the page name manually:

Upgrader init

Note that upgrading is a 2 step process; first you have to download the new upgrader (if there is one), and then you do the upgrade. This is done to make sure you have an upgrader that is compatible with anything new that we add. If you have the current upgrader, you'll just get a message telling you that you're up to date.

Upgrader ready

Next you press "Check For Upgrade". If there are any files different from what you have on your system, you'll be informed that you are not in sync.

Upgrade ready

Pressing "Get Upgrade" will download the files. You can press "View Files" to see the files that will be downloaded. If there are files you do not want upgraded (because of some change or customization you have made), put the file in your /usr/local/www/bwmgr/upgrader_exclude file. Files in the exclude file will not appear in the list. So if you add something you'll have to run the upgrader from the beginning again to exclude the file.

Upgrader downloading

Depending on how behind your system is, there could be a lot of files to update. The Downloading screen will let you know what's going on, and when it's done, a Reboot message will appear with instructions.

Upgrader reboot

Before rebooting, you should go back to the main screen to update the DB if required. You may not be able to get back to the main screen is something changed, in which case you'll need to just reboot. You should fully refresh your browser to make sure you get the latest javascript files.

Upgrading the Location DB

If you haven't yet installed the location Database, you'll need to do that just once. It's a very large download, about 300MB, so you should consider downloading it off-peak hours. Rather than downloading the very large index files, indexes are built after the download, so it could take a very long time if your cpu is busy doing other things.

To download the DB, Select Manual Upgrade, and enter DB in the text field.

Manual db

Press Check Upgrade and it will check to see which files you need. If you have none, it will show that 3 files are needed.

Db ready

Press Get Upgrade and it will start downloading. If you lose the connection you should be able to refresh and check again and resume the download. The Abort button will stop the download and a resume button will appear as well.

Db downloading

The 3 tables are downloaded separately. As each file completes, it will unpack the tarball and then rebuild the index. You'll see a message when the index is being rebuilt.

Rebuild index

Rebuilding the indexes can take a very long time. The first 2 files are smaller but the 3rd file is very, very large. You cannot "Abort" the operation, as once the command is issued to MySQL it can't be interrupted. You just need to wait until it's done. On an Atom like the ET/A1600, it can take 10 minutes to build the indexes with no traffic running through the box.

Next: Importing stats from ET/BWMGR v4 to v5