Home

Trixbox 2.0 to 2.2 upgrade guide

Posted August 29th, 2007 by fusion94

How To Upgrade Trixbox 2.0 to Trixbox 2.2
This guide is an attempt to gather into one easy-to-find place, all the information about upgrading from Trixbox 2.0 to Trixbox 2.2. Please add any tips, tricks or unsolved problems you find (put them at the end if you're not sure where).

These notes are provided 'as is' by members of the Trixbox user community and are used at your own risk.

This page attempts to summarize and collate this forum thread about Trixbox 2.2 upgrades.

The official line suggests that to upgrade you can do either of the following:

* Upgrade components with the package manager such as tbm_GUICore, or
* Run yum update (from ssh)

Note
trixbox-update.sh was depricated with trixbox 2.0. So because the package manager is a web interface to the yum repository, you can either use the package manager to selectivly install/upgrade components or do a yum upgrade to do a mass update.

Before you start

  1. You may wish to make a full backup of your system.
  2. Make a copy of the contents of the folder /etc/asterisk as the update will most likely change some of these files and you may lose your customisations in files such as sip.conf and vm_email.inc etc.
  3. Make a copy of the folder /var/lib/asterisk/sounds if you have installed customised sounds or changed any of the sounds files as these may be overwritten.

After you've upgraded
Once you have upgraded to Trixbox 2.2 and upgraded FreePBX, a number of FreePBX modules will need updating otherwise they may be left in a disabled state - use the Module Admin page in FreepBX to 'check for updates online' and upgrade//install the required modules. Note that you may need to run through the process more than once to catch all upgrades.

Common Problems
Incomplete list of package repositories

"Warning: fread(): Length parameter must be greater than 0. in ..."

The folder /etc/yum.repos.d should contain the following files - if not, visit the link below and make these files using the text provided there and your favourite editor:

* CentOS-Base.repo
* CentOS-Media.repo
* trixbox.repo
* trixboxaddons.repo
* trixboxdevel.repo
* trixboxbeta.repo

The text for these files can be found here: http://tinyurl.com/2o652r

Package Manager times out when reading packages
Package manager returns an error (not the same as above) or the package list never turns up. This may happen if you have a slow PC (eg: required on a PIII 1GHz) or a slow Internet connection

  1. Login to your server (ssh)
  2. Open /etc/php.ini in your favourite editor
  3. Change the parameter "max_execution_time = 30" to "max_execution_time = 150" (try 300 if you still get errors)
  4. Save your changes
  5. Restart httpd - eg: service httpd restart
  6. Check the packages again

Zaptel not running after update
Typical Symptoms: Cannot enter conferences or check voicemail (always getting password or login incorrect)

  1. login to your server (ssh)
  2. Edit all the files in /etc/yum.repos.d and remove the semicolon (uncomment) the lines that reference the kernel
  3. Save your changes
  4. If you have recently performed a system update, reboot to make sure you are running the latest kernel and re-login
  5. Issue the following commands:
    1. yum install kernel kernel-devel (NB: this may not install anything if the packages are already installed)
    2. cd/usr/src
    3. wget http://ftp.digium.com/pub/zaptel/releases/zaptel-1.2.17.1.tar.gz
    4. tar xvfz zaptel-1.2.17.1.tar.gz
    5. cd zaptel-1.2.17.1
    6. make linux
    7. make install
  6. Re-edit the files edited in step 2 to re-comment references to the kernel (put the semicolon back).
  7. Reboot your server.

The command 'lsmod' should now show whether the desired zap modules (according to your configuration) are loaded.

Trixbox still shown as 2.0 / new 'Trixbox green' look and feel not installed by update

  1. Login to your server (ssh)
  2. Issue the command: yum install tbm-GUIcore
  3. Follow the prompts to install the new GUI and dependencies
  4. Check whether any new Trixbox updates now show up in the Package Manager and install them if required.

NB: quite a few Trixbox updates and new modules may now show, but you may not need all of them for your current configuration.

Freebox 2.2.0rc3 not upgraded to current
Sometimes after upgrading and clicking on Asterisk -> FreePBX, the FreePBX version shows 2.2.0rc3 instead of the latest version. If you go to the modules page and install the ifreepbx.i386 module you will get the current module.

Note: Its not clear that 2.2.0rc3 is undesirable or even incorrect.

Upgrade FreePBX
To be honest, the best thing is to update FreePBX to the latest version manually from the command prompt after upgrading Trixbox.

http://freepbx.org/support/documentation/installation/upgrading-your-system

Please place general questions about this wiki page below here and add your initials to the end
Question: What is the version after installing the ifreepbx.i386 module?