- 18 Jun 2021
- 7 Minutes to read
- Print
- DarkLight
- PDF
Version 2021.1
- Updated on 18 Jun 2021
- 7 Minutes to read
- Print
- DarkLight
- PDF
UPGRADE REQUIREMENTS
The database migrations will be performed in release 2021.1 and will make it difficult to downgrade to Nectar Foundation releases 8.7.1 and below. We strongly advise customers to back up the RIG database before upgrading to 2021.1.
NECTAR FOUNDATION
WARNING: The Derby database version was upgraded in Release 8.3. This makes downgrade impossible. Customers MUST back up the database directory BEFORE upgrading to Release 8.3.
- It is not possible to use Remote Software Upgrade on a Linux platform to upgrade from a version prior to v8.6.
- RIG Client requires JRE 1.8 and above.
- Note: Runtime version will be enforced before RIG Client JAR files are downloaded.
- Before upgrading to v2021.1, your existing installation must be at v5.6.2.x or later, licensed, and started successfully. If you attempt to upgrade directly to v2021.1, then the installer will display the following message:
Selected installation’s main version is earlier than 5.6.2 required for upgrade.
- For the server to start successfully, the port number specified for the serverport property of the server. properties file must not be in use. If the port is already in use, change the port number to an unused port number to correct the issue. The default port number is 80.
TECHNICAL NOTES
CISCO UCM VKM
- When upgrading RIGs from a release prior to v8.0 that are monitoring Cisco UCM systems, additional time will be required based on the number of historical call detail records (CDRs) to perform database migration following restart.
- If the Cisco UCM VKM module is enabled on a system when upgrading to v2021.1 from a pre-7.x release, the Installer will detect it and display a warning message, informing the user to offboard any existing Cisco UCM systems before proceeding with the upgrade. For more information on offboarding, see Cisco UCM VKM Configuration Guide.
- Once the Cisco UCM system(s) has been offboarded, the user can re-run the upgrade process and select the Module Override to complete the upgrade.
CISCO MEETING SERVER VKM
For licensing, a status is received for each type of license (nolicense, activated, or expired). If a nolicense case, a WARNING event is generated. However, if the customer does not want to see these nolicense events, they can disable the associated poller(s).
CISCO EXPRESSWAY VKM
When onboarding Cisco Expressway VKM, use the same username and password across all cluster peers.
MICROSOFT SKYPE FOR BUSINESS VKM
Customers who upgrade to v2021.1 have the option to continue using the Legacy SfB module. However, to access the new SfB features available since v8.0, you must:
- Offboard the Legacy SfB system.
- Enable and onboard the new SfB VKM and system.
AVAYA CALL MANAGEMENT SYSTEM (CMS) VKM
As of v8.1, Nectar no longer supports Avaya CMS r16 (and earlier). CMS r16 uses the 256-bit Diffie-Helman encryption algorithm, which is considered a security risk and has been deprecated. It is no longer supported in current SSH-2 implementations.
If you accept this CMS security vulnerability, you can maintain CMS r16 monitoring with Nectar using a Nectar version prior to v8.1.
AVAYA SYSTEM MANAGER VKM
If you onboard Avaya System Manager with invalid credentials, you must delete the incorrect entry and re-onboard the System Manager.
For more information, see Nectar Deployment Guide – Avaya System Manager r7.1 and above.
AVAYA SERVICE MONITORING WEB SERVICES API
Nectar leverages Avaya’s Service Monitoring Web Services API (IP Office r10.1 and above). If you are currently monitoring an IPO r10.1 or above with Nectar v7.3 and prior, you can migrate to Nectar’s new API support by following these steps:
- Disable and remove the existing monitoring.
- Delete any IP Office traps in the Receiver module.
- Disable the previous module and enable the new module using RIG > Module Configuration.
- Restart the RIG.
For more information, see Avaya IP Office r10.1 and above Deployment Guide.
MOTHER MODULE
The Mother Module must be enabled for Perspective deployments. For more information, see Mother Module RIG Guide.
Properties File
After upgrading to v2021.1, if you have or plan to manipulate a properties file that uses a file path or directory, then you must verify that you are using the proper backslash (\) or forward slash (/):
Windows:
- Use double backslash (\\), for example, <drive>:\\<folder>\\<folder|file>
or
- Use single forward slash (/), for example, <drive>:/<folder>/<folder|file>
Linux/iOS:
- Use single forward slash (/), for example, /<folder>/<folder|file>
GENERAL DATA PROTECTION REGULATION
You must upgrade to ‘Version 7.2 or later’ (CIP, EIP, RIG, Perspective Agent/Controller as well as the Nectar Foundation Client) to enable the new General Data Protection Regulation (GDPR) audit logging. Logging is enabled by default but can be customized to suit your specific auditing needs. The Apps\<partner name>\etc\log4j2.xml file is used to enable that customization after the upgrade to ‘Version 7.2 or later’.
The upgrade to ‘Version 7.2 or later’ will back up your existing log4j2.xml file before installing the new version of that file.
If you have previously customized the log4j2.xml file, you will have to manually migrate those changes to the new log4j2.xml file. Your previous version can be accessed by navigating to Apps\<partner name>\rollback\etc\log4j2.xml AFTER you have upgraded.
New features, Improvements and resolved issues
Below you will find improvements, bug fixes, and technical upgrades for v2021.1.
New Features
Description | Notes | |
---|---|---|
CMP-7869 | Upgraded Embedded Apache SSHD and FTPD servers | |
CMP-9224 | Use MAC Address of endpoints as endpoint identifier |
Improvements
Issue | Description | Notes |
---|---|---|
CMP-3205 | Implemented data retention configuration and processing | |
CMP-8064 | Move System Selection dropdown box inside DynList | |
CMP-9632 | Report on CUCM License Usage | |
CMP-9864 | Support CUCM 12.5 WSDL | |
CMP-9985 | Syslog TCP listener | |
CMP-10044 | Create Genesys SNMP Collection Object | |
CMP-10045 | Create Media Control Platform Agents from the application table | |
CMP-10048 | Create Resource Manager Agent from the application table | |
CMP-10070 | Create Routing Agents and pollers | |
CMP-10071 | Create ORS HTML Collection Class | |
CMP-10072 | Create SIP Server Agents and Pollers | |
CMP-10073 | Create SIP Trunk Agents and Pollers | |
CMP-10077 | Create Message Server Connection Class | |
CMP-10118 | Create SIP HTTP Request Calling Class | |
CMP-10194 | Trap Processing - Configuration | |
CMP-10208 | Issue with Retention period settings | |
CMP-10227 | Add localAddress to Genesys Application Collection | |
CMP-10237 | Move traps in the new MIB from legacy module to new module | |
CMP-10254 | Remove SIP Entity Agents and Pollers | |
CMP-10280 | Allow disabling of HTTP port | |
CMP-10281 | Avaya CM Connection Wizard gets stuck | |
CMP-10283 | Inventory Server calcs for reconciliation | |
CMP-10301 | Add current ComStruc to log output | |
CMP-10307 | Correct usage of StringUtils, NumberUtils, etc. | |
CMP-10310 | Call Detail not populating | |
CMP-10313 | Hide 'Index Value' Column | |
CMP-10343 | Upgrade Windows JRE to RedHat OpenJDK 1.8.0_292 |
Resolved issues
Description | Notes | |
---|---|---|
CMP-7626 | Missed to display mandatory alert message while Adding Poll Function | |
CMP-9609 | KNS >> Not able to delete multiple Collections & Inventory | |
CMP-9648 | Avaya System Manager r7.1 Agent folder structure is removed while off-boarding Session manager (r6.3/6.2) VKM | |
CMP-9691 | Inconsistent value is displaying in the Poller History table view | |
CMP-9739 | Copy to Clipboard pop-up menu option not working in Call Detail Screen or Events Table | |
CMP-9756 | Show Events and Node menus not working under Dashboard > Maps | |
CMP-9899 | Events not passing Cisco phone IP address | |
CMP-9961 | CTI Server Inventory view shows blank records | |
CMP-9962 | Agents are not created for CTI Servers | |
CMP-10172 | Poller graph's Y axis labels getting cut off | |
CMP-10220 | Extremely high values for cpuUtilizationSNMP poller | |
CMP-10240 | IP Override Field Blank | |
CMP-10246 | Some of the CUCM Syslog events are not getting auto cleared | |
CMP-10247 | RTQOS time zone change not displaying correctly | |
CMP-10255 | RIG is repeatedly losing connectivity with CIP | |
CMP-10257 | Copy to Clipboard option does not work while selecting all the records | |
CMP-10260 | RIG Call records are blank even though Call Details histogram and columns are populated | |
CMP-10269 | Need to add new version to Scripted VKM CMP Version pull down menu | |
CMP-10270 | Truncated values in CDS table | |
CMP-10272 | Single Cisco CMS collection failing after RIG upgrade | |
CMP-10278 | Extremely high values for snmpDiskUsage (Physical Memory) poller | |
CMP-10297 | CloudQOSSession created duplicate entries | |
CMP-10299 | Remote softphone calls cannot be found in Current Call table | |
CMP-10326 | SNMP collector not sending -1 value when SNMP collection fails | |
CMP-10327 | Enhance collection execution status message | |
CMP-10331 | SIP Server->sipCallManager->Call_Rate alert level needs to be level 2 | |
CMP-10335 | Unable to add the Nectar IP address in CUCM CDR parameter | |
CMP-10347 | Add Release Notes link to the RIG | |
CMP-10353 | Call Summary table retention failure |
Technical Documentation
The following documents were created and/or revised for release 2021.1 and can be found on the Nectar Knowledge Center. For all other documents, look in previous releases in the Nectar Knowledge Center.
Filename | Document Name |
Nectar Deployment Guide-Avaya System Manager r7.1 and above v3.0 | Nectar Deployment Guide: Avaya System Manager r7.1 and above |
Nectar Foundation OpenJDK RIG Deployment Guide v1.0 | Nectar Foundation OpenJDK RIG Deployment Guide |
Nectar Foundation SSL Certificates Configuration Guide v5.0 | Nectar Foundation SSL Certificates Configuration Guide |
SUPPORTED PRODUCTS
Currently, Nectar supports the following devices and applications. Nectar is consistently adding support for different devices and applications.
Note: Nectar can monitor any server-based (Windows or Linux) application. Please check with your Nectar Channel Account Manager for an application or device that you would like to monitor that is not listed here.
VENDOR KNOWLEDGE MODULES
Avaya Aura Communication Manager (ACM)
| Cisco Meeting Server
|
Avaya Business Communication Manager (BCM)
| Cisco Unified Communications Manager (CUCM)
|
Avaya Call Management System (CMS)
Note: CMS r16 and earlier require using a Nectar release prior to Nectar r8.1. | Cisco Unity Connection
|
Avaya Communication Server 1000 (CS1000)
| Cisco Expressway
|
Avaya System Manager
| IPC Unigy
|
Avaya Session Manager
| Microsoft Lync 2010 and 2013 |
Avaya IP Office
| Microsoft Skype for Business |
Avaya Modular Messaging
| Uninterruptible Power Supply (UPS) Module
|
Avaya Voice/Experience Portal (AVP/AEP)
|
VENDOR KNOWLEDGE SCRIPTS
Cisco Unified Border Element (CUBE) | Sonus 1K/2K Session Border Controllers (SBCs) |
Cisco 4K and 5K Integrated Services Routers (ISRs) | VMware ESXi |
INFORMATION PACKS
Aculab PLC Groomer II | Juniper Networks Netscreen VPN Firewall Poller Pack |
AudioCodes Mediant Gateway Poller Pack 1000 and 3000 | Juniper Networks Netscreen VPN Firewall Trap Pack |
AudioCodes Mediant Gateway Trap
| Juniper Networks Poller Pack |
Avaya Aura AES Poller Pack | Juniper Networks Trap Pack |
Avaya Aura AES Trap Pack | Linux Server (Host Wizard) |
Avaya Media Gateway Poller Pack | Microsoft Server (Host Wizard) |
Avaya G860 Media Gateways | Nagios Trap Pack |
Cisco Router Poller Pack | NetApp Poller Pack |
Cisco Router Trap Pack | NetApp Trap Pack |
Dell OpenManage Poller Pack | NICE Perform eXpress Trap Pack |
Extreme Networks Poller Pack | Oracle Poller Pack |
Extreme Networks Trap Pack | Oracle Trap Pack |
Genesys Poller Pack | Oracle Solaris Poller Pack |
Genesys Trap Pack | Sonus 1K/2K Poller Pack |
HP Autonomy etalk Qfiniti Call Recording Trap Pack | VMware Poller Pack |