System -> Servers
, select all the servers and press Send Profiles
. Reboot any services when administration service instructs you to do so.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
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.
Consider upgrading to sipXecs 3.10 then following instructions from there.
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.
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 |
Remove the old repo file:
Example:
rm /etc/yum.repos.d/sipxecs.repo |
Version 4.4.0 is available on CentOS 5 but not CentOS 6. Version 4.6.0 is available on CentOS 6 but not CentOS 5. Therefore you must make a backup your 4.4.0 system, then install a fresh 4.6.0 system, then restore your 4.4 backups by uploading them from the "Restore" web page. I would strongly suggest you test the this process in a lab to reduce the change you will encounter any problems when upgrading the real system as it will be time consuming to revert back. For example, a VMWare virtual machine would be fine or any virtual environment just to ensure restore goes smoothly. The test machine does not have to have same IP address as the original machine as was the case in prior versions.
Be sure to read "After Upgrading to 4.6.0" in this document for notes about restoring from backups.
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"; |
If you have voicemail messages from the old version, let's say <=4.0.X, you might hit the XX-9461
|
If you have customized versions of vxml files, you'll lose them starting on 4.2.0 as VXML are no longer used for Voicemail. |
No special instructions
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 |
It's unlikely you upgraded directly to 4.6.0 because installation on CentOS required a full reinstall. You probably restored from backups.
When restoring from backups, not all settings may have migrated correctly. You will need to reset which services you want enabled on each machine. These were called "roles" in 4.4, and are now simply a list of services. Navigate to menu in administration user interface : System/Servers. There you will see links along the left hand side of the web page such as "Core Services" or "Telephony Services". Go through each link and enable the services you would like to have running. Hover your mouse over each service for more information about the service and what function it provides. Services will automatically start in about 10-30 seconds after you've applied your changed.
If the 'superadmin' password is not correctly decrypted during the restore, you can use 'service sipxconfig reset-admin' to reset it. You can then log in to the Admin GUI with no password and set a new password.