Upgrade to Latest Stable Version

Notes

• When performing an upgrade is always a good idea to backup your production system. It is also good to perform the update on a test system first in order to mitigate risks in production.
• It is also NOT recommended you use the administration web interface to upgrade your system from one version to another. The administration web interface for upgrading is best used for minor bug updates.
• You can upgrade from any version to any version as long as you follow the manual steps both before and after your upgrade.
• If you have multiple systems in a cluster (all managed by one Management server). Complete upgrade process on the master server before proceeding to the slave nodes. Once all the systems have been upgraded, log in to the the management UI, go to System -> Servers, select all the servers and press Send Profiles. Reboot any services when administration service instructs you to do so.

Upgrade Instructions

Step 1. Follow each of the pre-install instructions starting with the version you currently have installed. Then come back to this step and continue. So if you currently have version 4.0.4 installed, you want to start with the instructions for 4.0.4 and then proceed to the end of the pre-install instructions for each version.

Step 2. Visit download area and decide what version is right for you based on the version numbers. Find the link to the file that ends in .repo and right click in your web browser and copy the link.

Then in a root window on the system you wish to upgrade run

 wget -O /etc/yum.repos.d/sipxecs.repo  <URL to repo file here>

Example:

 wget -O /etc/yum.repos.d/sipxecs.repo http://download.sipfoundry.org/pub/sipXecs/sipxecs-4.4.0-centos.repo

Step 3. Shutdown sipxecs and update your system.

service sipxecs stop
yum update -y

It's good to let your system update all it's packages because

1. The binaries were probably built with the latest packages
2. If ever you needed to update a package for security reasons, you'd want to minimize the changes to your system
3. It's often a requirement for getting assistance on mailing list
4. If you do have any problems, most likely others will see the problem as well and provide a quick solution to your issue.

Step 4. Follow each of the post-install instructions starting with the version you currently have installed. Then come back to this step and continue.

Step 5. Start your system back up.

service sipxecs start

Complete. if you are upgrading a clustered system, see the Notes section at the top of this document for upgrading each slave node.

Before upgrading from 3.10.x

The local domain bind zone is "emptied", if you are using the system as a DNS server, you should copy or backup your zone file before the update. It doesn't effect other zone files on the system, just the one sipx is attached to.

Before upgrading from 4.0.4

If you originally installed your system from the sipfoundry ISO in 4.0.4 and are having issues updating, here's some help:

First you have to determine what your redhat-release is:

cat /etc/redhat-release

If it doesn't say CentOS but says (sipXecs 4.x), then here's what you need to do, AFTER YOU GET A PROPER BACKUP..

Rename your repo file:

ls \-l /etc/yum.repos.d
sipxecs-stable-centos.repo

If you do not have a CentOS-Base.repo or other repos in there, it's OK, this will probably fix a lot, just hold on.

mv sipxecs-stable-centos.repo CentOS-Base.repo

Edit the repo to make it JUST a CentOS repo again - remove these lines and save it:

[sipxecs-stable]
name=SIPfoundry sipXecs pbx - latest stable version
baseurl=[http://sipxecs.sipfoundry.org/pub/sipXecs/4.0.4/CentOS/5/i386/RPM/]
gpgcheck=0
gpgkey=[https://secure2.pingtel.com/RPM-GPG-KEY-pingtel]
enabled=1

Before upgrading from 4.2.x

Remove the old repo file:
Example:

rm /etc/yum.repos.d/sipxecs.repo

Before upgrading from 4.4.0

No special instructions

After upgrading from 3.10.x

The DHCP 120 test will fail if you are using the on board DHCP server. To correct this you need to add the following to the /etc/dhcpd.conf and restart dhcpd (service dhcpd restart). This is not required if you aren't using the Counterpath Enterprise Clients.

# header section of dhcpd.conf
option sip-servers-name code 120 = text;

# subnet section of dhcpd.conf
option sip-servers-name      "<hostname>:12000/cmcprov/login";

After upgrading from 4.0.4

# fix all bad messages 
export TZONE=`date +%Z` 
find /var/sipxdata/mediaserver/data/ -name '*.xml' -exec sed -i "s|\([AP]M\)\s\+</timestamp>|\1 ${TZONE}</timestamp>|g" {} \; 

After upgrading from 4.2.x

No special instructions

After upgrading from 4.4.0

If you wish to install OpenACD run

yum install -y sipxopenacd
chkconfig --add mongod
chkconfig mongod on
service mongod start

If you wish to install support for audiocodes HD phones

yum install sipxaudiocodes