This section describes the eZuce openUC 15.05 software release, including:
- Software Enhancements
- Application, Hardware, and Documentation Requirements
- Installation & Upgrade Instructions
- Two attachments (PDF files) containing Fixes for internally-reported issues and for customer-reported issues
Software Release History
Starting with the April 2014 release, OpenUC will have a regular release cycle for new features and a new versioning schema which incorporates the Year and Month of release. Starting with April 2015 this schedule will be accelerated to monthly. We'll back off to bi-monthly after June. We're searching for the right cadence for customers, developers and the QA team.
- April release for 2014 is 14.04
- December release for 2014 is 14.10 (delayed for 14.04.3)
- April release for 2015 is 15.04
- May release for 2015 is 15.05
- June release for 2015 is 15.06
- August release for 2015 is 15.08
- October release for 2015 is 15.10
- December release for 2015 is 15.12
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
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 4 GB of RAM with sufficient swap space
- 80 GB disk (75 users depending on usage patterns)
Note: OpenUC supports an unlimited number of voice-mail 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).
- Operating System:
CentOS/RHEL 6 x86_64 with latest updates is required.An i386 version is also provided as is (without any support).
- Polycom VVX Devices with firmware 4.1.7 are recommended for new installations
- Polycom SoundPoint IP Devices should run firmware 4.0.7
- AudioCodes Gateways are recommended for PSTN connectivity
- Sangoma, AudioCodes, Acme Packet and Ingate SBC's are recommended for SIP Trunking and Remote Worker connectivity (commonly referred to as sipXbridge and MediaRelay services respectively).
- NOTE: The eZuce openUC - "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. The openUC "Built-In SIP Trunk SBC" (sipXbridge) will not be supported in any production or live environment.
Technical Reference Manuals, User Guides, Reach Reference Manuals, and other technical and user information can be found under the following link: Documentation Page
Installation and Upgrade Notes
After OpenUC 15.05 is downloaded and installed,the clusterId read tag is unique (same as locationId). Follow these steps to propagate the new read tags to the MongoDB replica set:
- In the OpenUC menu, click System>Database.
- Click the Add query metadata button.
- To verify that the MongoDB replica contains the unique read tags, run in the command line:
Special MongoDB note
Please be aware of this Mongodb requirementshttp://docs.mongodb.org/manual/reference/ulimit/“Note: Both the “hard” and the “soft” ulimit affect MongoDB’s performance. The “hard” ulimit refers to the maximum number of processes that a user can have active at any time. This is the ceiling: no non-root process can increase the “hard” ulimit. In contrast, the “soft” ulimit is the limit that is actually enforced for a session or process, but any process can increase it up to “hard” ulimit maximum.Every deployment may have unique requirements and settings; however, the following thresholds and settings are particularly important for mongod and mongos deployments:
ulimit –a -f (file size): unlimited -t (cpu time): unlimited -v (virtual memory): unlimited -n (open files): 64000 -m (memory size): unlimited -u (processes/threads): 32000
Always remember to restart your mongod and mongos instances after changing the ulimit settings to make sure that the settings change takes effect.If you limit virtual or resident memory size on a system running MongoDB the operating system will refuse to honor additional allocation requests.After every install/upgrade please check that "cat /proc/$pid_of_mongo/limits" have the recommended value of 655350. To make this value permanent you need to create this file /etc/security/limits.d/99-mongodb-nproc.conf and add the following lines:mongodb soft nproc 64000mongodb hard nproc 64000mongodb soft nofile 64000mongodb hard nofile 64000 .
If you have a patch installed to your system a new patch may be required. Please contact firstname.lastname@example.org if think you may have a patch applied as that may be replaced during the update.
Installing from ISO image
Download openUC ISO
Download the ISO image corresponding to your hardware and write the image to a DVD.
- The ISO files are available here: https://download.ezuce.com/openuc/ISO/
- You will need a valid ezuce.com user ID to login and download.
- We recommend the 64 bit installation in most cases. This ISO file name ends in x86_64.iso
- Boot from the DVD created with the openUC ISO image.
- Press Enter at the boot screen below to begin the openUC installation.
- Select Manual Configuration under Enable IPv4 support and select OK.
- Set a static IPv4 address with the corresponding networking information and click OK.
- In certain situations an warning of the use of indicated storage devices will be displayed.
- Select the language to be used during the installation.
- Select the keyboard layout to be used.
- Select the timezone to be used.
- Set a root password.
- Login to the system as root with the password you provided earlier and continue on to the Configure of openUC.
Installing from Repository
OpenUC can be installed using the below procedure
- Download and install CentOS 6.x minimal ISO
- Run the following command:
yum update && reboot
- Run the following commands to retrieve and run the eZuce openUC 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 openUC from the eZuce software repository.
Upgrade from previous versions
When upgrading OpenUC from 4.6 Update 11 or 14.4.3 to 15.05 follow these steps to ensure the SEC service is correctly running:
- 1. Upgrade from 4.6 Update 11 or 14.4.3 to 15.05.
- 2. After the upgrade is complete, perform the usual restart.
- 3. Once possible, connect via CLI and monitor processes using top. Notice that the SEC process is using a lot of CPU memory.
- 4. Perform another restart OR restart only the Sipxlogwatcher service.
Support Tips and Contact Information
Please see the Getting Support section for support tips and support contact information.
Enhancements, Fixes and Known Issues
Click the following for Beta release issues: