Upgrading from version 1.5.x to 1.5.x

This document describes general guidlines how to upgrade Arrow Telecom's ArrowBilling between minor releases of branch 1.5 versions

Before You Upgrade

Upgrade between branch 1.5 is considered minor upgrade and does not require significant downtime of the system. In fact, it is possible to do upgrade with no downtime at all. There are no modifications needed to database tables. However, as the precaution, we strongly recommend to have your database backup up to date.

What You need to Update

Depending on exact version components and Radius server you use, there may be more or less work involved in upgrade.  

Which Radius server am I using?

To get to know which Radius server is currently used on your system, do following:

ps ax | grep radius

If you have BSDRadius running, the output will be something like this:

/usr/local/bin/python /usr/local/bin/bsdradiusd.py

If you are using FreeRadius, the output will be similar to this:

/usr/local/sbin/radiusd 

If you are using Freeradius

In case you are running Freeradius, the upgrade is very simple:

  • backup your existing billing directory:
cp -R billing/ billing_back/
  • copy distribution tarball in directory above existing billing directory.
cp billing-x.x.x.tgz dtl
  • extract it (overwrites files in existing billing directory). 
tar -xvzf billing-x.x.x.tgz
  • Restart Radius server
killall radiusd && radiusd

The upgrade is complete.

If you are using BSDRadius

In case of BSDRadius, follow same steps above as described for Freeradius. Additionally, check if there is need to upgrade either wobble library or bsdradius itself. Please refer to supplied documentation or check reference table below.

If you need to upgrade wobble library:

  • change to wobble directory under billing
cd billing/wobble/
  • run setup
python setup.py install

If you need to upgrade bsdradius:

  • change to bsdradius directory under billing
cd billing/bsdradius/
  • run setup
python setup.py install
  • restart bsdradius
killall bsdradiusd && bsdradiusd

Reference table for components supplied with various ArrowBilling versions

wobble

ArrowBilling 1.5.0 -> wobble 1.0

ArrowBilling 1.5.1 -> wobble 1.1

bsdradius

ArrowBilling 1.5.0 -> bsdradius 0.7.0

ArrowBilling 1.5.1 -> bsdradius 0.7.0

required component upgrade table

for wobble library: 

 wobblefrom ArrowBilling 1.5.0  
 to ArrowBilling 1.5.1
 upgrade needed
 
   
for bsdradius:
 bsdradiusfrom ArrowBilling 1.5.0
 
  to ArrowBilling 1.5.1 upgrade not needed