Upgrading ipbx

From Taridium

Revision as of 18:44, 4 October 2010

Free ipbx updates are provided to all registered and licensed customers. Contact support@taridium.com if you can't access the repositories.

ipbx upgrades consist of two parts:

1. The ipbx software and related components as licensed by Taridium.

2. The Asterisk Open Source back-end as distributed by Taridium.

Upgrades of ipbx should be performed during off hours, but will usually not affect any ongoing voice traffic unless the switching package asteriskXX - e.g. asterisk14 or asterisk16 (formerly also the asterisk package) and/or related components need to be upgraded. See the change log for details on each specific upgrade.

Upgrading ipbx via Web Interface

Go to Advanced Setup → Maintenance and click on check for updates - if an update is available, you can select install update to perform the upgrade. Depending on your connection speed, the upgrade can take up to 5 minutes.

You will not be able to upgrade via web interface if you have changed your MySQL default password - use the command line upgrade instead.

Upgrading ipbx via Command Line

Make sure your system is connected to the internet and that name resolution is working properly. To upgrade via command line, log into your system as root and enter:

 [root@ipbx ~]# yum update ipbx

Once the update has been completed run ipbx-config and select option 6 to upgrade the database. Some updates will not include a database upgrade, but it is always advisable to run the database upgrade, to make sure any changes have been applied. It is normal that several revisions of the database will be applied if you haven't upgraded with every new version. Note that failing to upgrade the database might prevent your PBX from working properly, so always check for database upgrades!

 [root@ipbx ~]# ipbx-config
 
 ************************************************************
                                                             
   ipbx 2.0 Configuration                      
   (c) 2010 taridium                                   
                                                             
 ************************************************************
 
 
 Select Configuration Option:
 
 1 <- Configure ipbx for the first time and use default
      configuration
 2 <- Create full database backup
 3 <- Fix file system permissions
 4 <- Restore default ipbx database (will erase all settings)
 5 <- Reset admin password
 6 <- Upgrade ipbx database (safe mode)
 
 0 <- Exit
 
 please enter your choice:

Upgrading Asterisk

To upgrade Asterisk, first check which major version packages are currently in use on your system. Standard distributions are named asterisk14 and asterisk16 (this package was previously called asterisk only) Login to your system as user root:

 [root@ipbx ~]# rpm -q asterisk16

or

 [root@ipbx ~]# rpm -q asterisk14

To upgrade your current package replace XX with your major version (or asterisk only), below:

 [root@ipbx ~]# yum update asteriskXX

After all packages have been updated you can restart asterisk:

 [root@ipbx ~]# service asterisk restart

Check if the ipbx configuration manager can connect to Asterisk:

 IPBX*CLI> realtime mysql status 
 Connected to ipbx@localhost, port 3306 with username ipbx for 12 seconds.

 IPBX*CLI> cdr mysql status 
 Connected to ipbx@localhost, port 3306 using table cdr for 12 days, 17 hours, 48 minutes, 22 seconds.
 Wrote 5661 records since last restart.

Change Log

Detailed information about changes in ipbx releases can be found in the ipbx change log.