Codebox Software

BitMeter OS FAQ

• How do I access the Web Interface?
• How can I make the Web Interface accessible from another computer?
• How can I stop/start/restart the BitMeter Web Interface?
• Where can I get the source code for BitMeter OS?
• How can I remove BitMeter OS from my Mac?
• How can I backup the data that BitMeter OS has stored?
• Can I run BitMeter OS alongside BitMeter 2 on my PC?
• How can I make it more obvious which computer I am monitoring, when using the web interface?
• How can I permanently change the default web interface colours?
• Is it possible to import BitMeter OS data from a remote host into my local database?

How do I access the Web Interface?

To view the Web Interface on your computer, just click on this link

How can I make the Web Interface accessible from another computer?

The following command, executed from a Command Prompt/Terminal Window, will enable remote access next time the Web Interface is started:

bmdb webremote

To disable remote access, use this command

bmdb weblocal

Note that these commands don't take effect immediately, the web interface must be restarted first, see below.

How can I stop/start/restart the BitMeter Web Interface?

The following commands will stop/start the Web Interface in Windows (these must be executed from a Command Prompt)

sc stop  BitMeterWebService
sc start BitMeterWebService

The following commands will stop/start/restart the Web Interface in Linux (these must be executed from a Terminal Window)

sudo /etc/init.d/bitmeterweb stop
sudo /etc/init.d/bitmeterweb start
sudo /etc/init.d/bitmeterweb restart

The following commands will stop/start the Web Interface in Mac OS X (these must be executed from a Terminal Window)

sudo launchctl stop  uk.org.codebox.bitmeterweb
sudo launchctl start uk.org.codebox.bitmeterweb

Where can I get the source code for BitMeter OS?

The source code is available on the SourceForge website.

How can I remove BitMeter OS from my Mac?

To uninstall BitMeter OS on a Mac, just run this command (you may be prompted for the admin password):

/Library/Application\ Support/BitMeter/bmremove.sh

How can I backup the data that BitMeter OS has stored?

All the data that BitMeter OS records is stored in a single database file, so it is very easy to backup:

• On Windows: C:\Documents and Settings\All Users\Application Data\BitMeterOS\bitmeter.db
• On Linux: /var/lib/bitmeter/bitmeter.db
• On Windows: /Library/Application Support/BitMeter/bitmeter.db

Can I run BitMeter OS alongside BitMeter 2 on my PC?

Yes, there are no conflicts between BitMeter OS and BitMeter 2, you can run them both together with no problems.

How can I make it more obvious which computer I am monitoring, when using the web interface?

It is possible to assign a name to each instance of BitMeter OS, which will be displayed in the title of the web interface. To assign a name, use the bmdb utility with the setconfig option, as follows:

bmdb setconfig web.server_name "Robs Laptop"

How can I permanently change the default web interface colours?

To change the colours used to represent upload and download values in the graphs on the web interface, use the bmdb utility with the setconfig option, as follows:

bmdb setconfig web.colour_dl "#f906f0"
bmdb setconfig web.colour_ul black

Be careful when setting these values - no validation checks are performed on the values that you enter, supplying an invalid value can cause the web interface to stop working!

Is it possible to import BitMeter OS data from a remote host into my local database?

Yes, you can do this using the bmsync utility.