To upgrade from Enswitch 2.7 to Enswitch 2.8

1. On all Asterisk machines, review /etc/asterisk/voicemail.conf for local customisations. If there are any, they must be merged into the rate plan custom settings as below, so make a note of them. Then do:
   • cp /opt/enswitch/current/install/etc/asterisk/voicemail.conf /etc/asterisk/voicemail.conf
2. On all Asterisk machines, edit /etc/crontab and remove the following lines if they exist:

   /opt/enswitch/current/sbin/enswitch_conference_notify
   /opt/enswitch/current/sbin/enswitch_cleanup_local
   /opt/enswitch/current/sbin/enswitch_mwi_sync
   

   Their functions have been moved to the enswitch_routed housekeeping process.
3. On all machines, check out /opt/enswitch/branches/2.8.
4. On all machines, update the /opt/enswitch/current symlink.
5. On the primary database machine, do:
   • /opt/enswitch/current/bin/enswitch_upgrade
6. On all Asterisk machines, edit /etc/asterisk/modules.conf, and remove the "noload => chan_iax2.so" line if it exists. This is to allow fax calls to be sent to iaxmodem.
7. On all Asterisk machines, edit /etc/asterisk/extensions.conf, and check it contains either:

   #include /opt/enswitch/current/etc/asterisk/extensions_phone.conf
   

   or

   [enswitch-phone]
   exten => _[0-9*#]!, 1, GotoIf($[ "${ENSWITCH-MUSIC}" = "" ]?3)
   exten => _[0-9*#]!, 2, SetMusicOnHold(${ENSWITCH-MUSIC})
   exten => _[0-9*#]!, 3, Dial(SIP/${EXTEN}@${ENSWITCH-PHONE-DOMAIN}|3600|${ENSWITCH-PHONE-OPTS})
   exten => h, 1, DeadAGI(agi://127.0.0.1/end)
   exten => t, 1, Hangup
   

   (customised if necessary for features such as IAX support). This has changed since 2.7.
8. On all Asterisk machines, do:
   • /opt/enswitch/current/bin/enswitch_install hylafax
   • /etc/init.d/enswitch_routed restart
   • asterisk -rx reload
9. On all web machines, do:

   Debian / Ubuntu:

   • apt-get install libtext-csv-perl
   • invoke-rc.d apache2 restart

   Others:

   • perl -MCPAN -e 'install Text::CSV'
   • service httpd restart
10. If running the SOAP API, on all web machines do:
    • /etc/init.d/enswitch_soapd restart
11. If there is only a single OpenSER machine, do:
    • /etc/init.d/enswitch_sipd restart
    • /etc/init.d/openser restart
12. If there are a pair of OpenSER machines using heartbeat, do:
    • /etc/ha.d/resource.d/enswitch_sipd restart
    • /etc/ha.d/resource.d/openser restart
13. Edit the custom settings for the system rate plan, and add custom settings for voicemail and fax notification as desired.
14. Test calls and the web interface.