March 6, 2018
eZuce is pleased to announce the General Availability of Uniteme 18.12.centos7. This release includes all of the same new features, improvements and fixes from 18.12 but now allows users to operate on CentOS 7.
The developers and QA staff have been incredibly busy as we’ve had to touch every service of the system and get them to compile and start (thanks team!). All services startup has moved to systemctl for service startup so there was lots of scripting work to be done. Additionally we’ve moved to pre-built freeswitch packages (1.6.20~64bit) instead of building our own.
With all CentOS 7 builds we’re moving away from building ISO’s. Users will need to use the CentOS 7 64 Bit minimal ISO and then perform an RPM install. The ISO creation process is a drain on resources and as we move towards a container based deployment would not be used.
We’re almost done with coding for the next release (19.04). This release will include support for the new Polycom x50 VVX phones. We’ll also still have both CentOS 6 and 7 releases but this will be the last release done for CentOS 6. Looking forward to version 19.08, we will release for CentOS 7 only and with no ISO’s.
uniteme New Features
Uniteme on CentOS 7
Allow user to choose language in UniteWeb
Move to systemctl for service control
Upgrade Freeswitch to 1.6.20
Enhance gridfs-voicemail-cli tool to clean up voicemails across entire database
In UniteWeb allow users to listen to MoH and Greeting files in GUI
Upgraded fail2ban to 0.9.6
Added support for newer Yealink phones
With the upgrade to CentOS 7, the user must install a fresh install of CentOS 7-64 bit and then use the RPM Installation method.
During configuration you will see some errors being echoed to the screen. There's some issue with CFEngine that the CFE team hasn't resolved yet. The errors are benign. You'll see something like the following:
Who Should Install?
This release is recommended for users who need to run Uniteme on CentOS 7. If you are running a CentOS 6 based release in production, it’s recommended that you test the 18.12.centos7 release on CentOS 7 in your environment thoroughly before upgrading. This is the initial release on CentOS 7 and while we’ve done our best to regression test and test all aspects of the system, issues may arise in different environments and scenarios that are not covered in QA tests. Please contact firstname.lastname@example.org if think you may have a patch applied as that may be replaced during the update.
eZuce's software products continuously progress through an Agile based development methodology that keeps feature functionality comprehensive and up-to-date in response to evolving market and customer requirements.
New software releases are made at a rate of two to four releases a year. Releases are numbered in the <yy>.<mm>.<uu> format where <yy> and <mm> designate the year and the month, respectively, in which a release is made generally available. Where applicable, <uu> corresponds to an update release relative to a general release on which fixes are made available.
In order to ensure service continuity and stability, customers may keep their production environments unchanged for up to a 6-month period during which release updates or patches are made available. After a release is more than 6-months old, eZuce customers would have to upgrade to the latest generally available release - inclusive of all fixes to date and any new patches.
Software Release History
We're currently running on a 4-month release cycle.
- April release for 2018 is 18.04
- August release for 2018 is 18.08
Release Level History
- 14.04 - April 30, 2014
- 14.04.1 - June 01, 2014
- 14.04.2 - July 11, 2014
- 14.04.3 - October 24, 2014
- 14.10 - February 5, 2015
- 15.04 - April 29, 2015
- 15.05 - May 27, 2015
- 15.06 - June 30, 2015
- 15.08 - August 31, 2015
- 15.10.1 - December 9, 2015
- 15.12 - January 6, 2015
- 16.02 - March 14, 2016
- 16.04 - May 31, 2016
- 16.08 - October 6, 2016
- 16.12 - January 17, 2016
- 17.04 - April 18, 2017
- 17.08 - September 7, 2017
- 17.10 - December 7, 2017
- 18.04 - June 5, 2018
- 18.08 - September 7, 2018
- 18.12 - January 15, 2019
- 18.12.centos7 - March 6, 2019
For a reasonably performing system, we recommend the following configuration.
Minimum hardware requirements
- Pentium 4 or Xeon processor @ 2.0 GHz Core 64bit or higher
- Minimum 8 GB of RAM with sufficient swap space
- 80 GB disk (75 users depending on usage patterns)
- uniteme supports an unlimited number of voicemail boxes, the total number of hours of recorded messages is determined by the size of the hard-disk. As a rule, for every minute of recorded messages, you will need 1 MB of disk space (About 3 hours per 10 GB of disk space).
CentOS/RHEL 7 x86_64 with latest updates is required.
- Polycom VVX Devices with firmware 5.9.1 (split) are recommended for new installations
- Polycom SoundPoint IP Devices should run firmware 4.0.14 (split)
- AudioCodes Gateways are recommended for PSTN connectivity
- Frafos, Sangoma, Acme Packet and Ingate SBCs are recommended for SIP Trunking and Remote Worker connectivity (commonly referred to as sipXbridge and MediaRelay services respectively).
- NOTE: The eZuce uniteme - "Use built-in SIP Trunk SBC" found in Gateway Details for use with Trunking or Remote Worker solutions should be used only for lab purposes. Additionally, sipXbridge does not work in an HA environment.
Technical Reference Manuals, User Guides, Reach Reference Manuals, and other technical and user information can be found under the following link: Documentation Page
Installing from Repository
uniteme can be installed using the following procedure
- Download and install CentOS 7.x minimal ISO
- Run the following command:
yum update && reboot
- Run the following commands to retrieve and run the eZuce uniteme installer:
curl https://download.ezuce.com/openuc-setup > /usr/bin/openuc-setup chmod +x /usr/bin/openuc-setup openuc-setup
This utility will guide you through the process of installing uniteme from the eZuce software repository.
Upgrade from previous versions
To upgrade to this version of uniteme you will need to backup your current installation, install a new CentOS 7 server, install uniteme from RPM and then restore the previous backup. It's safest to do this with a new physical or virtual server so as to have a means to get back to your old installation should you have trouble.
Backup your system - Backup
Download and Install CentOS 7 minimal (or RHEL 7) - https://www.centos.org/download/
Follow above instructions for "Installing from Repository" or refer to the following wiki page - RPM Installation
Restore your system - Restore
Specific Issues Addressed
Issues Sorted by Issue Number
|Jira #||JIRA Name||RN Content||Enhancement/Fix/Known Issue||Key words|
|SIPX-751||Adapt sipx services / utilities for CentOS 7||Enhancement|
|SIPX-752||Adapt build for CentOS 7||Enhancement|
|SIPX-759||Jitsi preferred transport velocity file||There is an error in the Jitsi velocity file with the Preferred_Transport parameter.|
The correct parameter name in velocity file is:
PREFFERED_TRANSPORT -> PREFERRED_TRANSPORT
|SIPX-774||Add provisioning support for new Yealink T46S T48S ...||Add support for newer Yealink S-Series.|
Old phones are not available anymore (chips will not be produced anymore).
|SIPX-775||Upgrade fail2ban to v0.9.6||The system is currently using an older version of fail2ban (0.8.1) which is known to be buggy and throws iptables errors in the log, such as these:|
2018-11-07 14:54:56,664 fail2ban.actions.action: ERROR iptables -D INPUT -p all -j security-block
iptables -F security-block
iptables -X security-block returned 100
|SIPX-776||Change block size in TFTP service to 1300||Several provisioning problems were tracked to TFTP using 4096 byte UDP blocks which get fragmented and lost on the way in some network environments.||Fix||TFTP|
|SIPX-777||sipxsecurity and firewall logs not appended after rotate||Customer reported that if they put in a filter to watch IP tables for bans, but their sipxsecurity logs show no activity day after day since the last system restart.||Fix||Logs|
|SIPX-778||Grace period is not being read properly by registrar service||The grace period in registrar options does not work as expected. Upon investigation, it became clear that the option is being written in registrar config but not being used. Registrar startup shows value being 0 in 18.04 and later regardless of the setting (SIP_REGISTRAR_EXPIRE_GRACE_PERIOD in /etc/sipxpbx/registrar-config):|
"2018-10-29T14:52:59.016784Z":13:SIP:INFO:18081.iuliu.test::7f57c70c9800:sipxregistry:"RegDB::ensureIndexes existing client: no, expireGracePeriod: 0, expirationTimeIndexTTL: 0"
|SIPX-785||sipxbridge fails to start at system||sipXbridge fails to start at boot time. Upon manual startup, the service stays up. Also, backport this to 18.12 for CentOS 6.||Fix||sipXbridge|
|UC-4761||sipx-dbutil -r not working properly on 18.04 update 1||sipx-dbutil -r is not working on 18.04 update 1, it only returns registrations on the primary.|
Testing indicated that the issue only occurs on servers which are not both Mongo PRIMARY and SIPXCONFIG master. Engineering recommended that line 609 in /bin/sipx-dbutil should be changed from
client = pymongo.Connection('localhost', 27017)
client = pymongo.Connection('localhost', 27017, slaveOk=True)
To allow issuing on SIPXCONFIG master and Mongo PRIMARY or SECONDARY.
|UC-4770||Allow to listen moh and greeting file from user settings||Show audio controls bellow the listen and delete button to be able to pause, change volume, download when listening to the greeting or moh file in user settings instead of opening it in new tab.||Enhancement||UniteWeb|
|UC-4774||Conferences are automatically saved in Inbox||Conferences should be saved in conference folder||Fix||Conference|
|UC-4787||gridfs-voicemail-cli.jar Not Deleting Globally||gridfs-voicemail-cli.jar is assumed to delete voicemails globally in the same fashion as setting a retention policy on user voicemail. Using the command, java -jar gridfs-voicemail-cli.jar --voicemailCleanup 7, should delete all voicemail messages older than 7 days EXCLUDING the saved folder. This would mirror the same functionality observed within the Uniteme web interface. This would also be useful to be able to use within the new voicemail-cli script that was created recently. Does not need to be backported to 17.10-stage as long as an updated jar file can be loaded on the customers system requesting the functionality as they are only using it to cleanup database in preparation for upgrade to 18.08.||Enhancement||Tools|
|UW-408||Add language support||Add possibility to change language in user portal.||Enhancement||UniteWeb|