AppManager for Avaya Communication Manager Release Notes 8.0.0.1

Date Published: September 2021

AppManager for Avaya Communication Manager is a scalable telephony solution for enterprises and branch offices, providing call processing, messaging, and contact center functions. Use AppManager for Avaya Communication Manager to monitor Communication Manager clusters, including vital components, such as Switch Processing Elements (SPE), Enterprise Survivable Servers (ESS), Local Survivable Processors (LSP), H.248 media gateways, IP stations, attendant consoles, remote office stations, hunt groups, trunk groups, and announcement ports.

This release improves usability and resolves previous issues. Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure that our products meet all your needs. You can post feedback in the AppManager forum on NetIQ Communities, our online community that also includes product information, blogs, and links to helpful resources.

The documentation for this product is available on the NetIQ website in HTML and PDF formats on a page that does not require you to log in. If you have suggestions for documentation improvements, click the comment on this topic button to the right of each section on any page in the HTML version of the documentation posted at the AppManager Modules page. To download this product, see the AppManager Module Upgrades & Trials website.

1.0 What’s New?

This release of AppManager provides the following enhancements:

  • Support for SQL Server Express edition and SQL Server 2017, 2016, 2014, 2012, and 2008 R2: This release supports SQL Server Express edition and SQL Server 2017, 2016, 2014, 2012, and 2008 R2 on the proxy agent computers. For more requirements, see the System Requirements.

  • Support for Windows Server 2019 and 2016. This release supports Windows Server 2019 and 2016 installed on the agent computers. For more information, see the System Requirements.

  • Added knowledge script DeleteCDRRecords: NetIQ AppManager for Avaya Communication Manager now has a new knowledge script, called DeleteCDRRecords. You can use this KS to delete call detail records (CDR) from the supplemental database.

To get the updates provided in this release, install the module to the AppManager repository (QDB) and on the agent computer, and then propagate changes to any running jobs for the Knowledge Scripts that were updated in this release. AppManager 7.x does not automatically update renamed or copied Knowledge Scripts. For more information, see the “Upgrading Knowledge Script Jobs” section in the AppManager for Avaya Communication Manager Management Guide, included in the download package.

This release of AppManager for Avaya Communication Manager replaces all Previous Releases.

2.0 System Requirements

For the latest information about supported software versions and the availability of module updates, visit the AppManager Supported Products page. Unless noted otherwise, this module supports all updates, hotfixes, and service packs for the releases listed below.

AppManager for Avaya Communication Manager has the following system requirements:

Software/Hardware

Version

NetIQ AppManager installed on the AppManager repository (QDB) computer, on each proxy agent computer, and on all console computers

7.0 or later

Support for Windows Server 2008 on AppManager 7.x requires AppManager Windows Agent hotfix 71704 or later. For more information, see the AppManager Suite Hotfixes page.

Avaya Aura Communication Manager (also known as Avaya Communication Manager)

8.1, 8.0, 7.1.3, 7.0, 6.3, 6.2, 6.1, 6.0, 5.x, or 4.x

NOTE:For version 5.2.1, install Avaya Communication Manager Service Pack 3 or later to improve SNMP performance. For more information, see the Avaya Aura Communication Manager 5.2.1 SP3 Release Notes.

Microsoft Windows operating system installed on the agent computers

One of the following versions:

  • Windows Server 2019

  • Windows Server 2016

  • Windows Server 2012 R2

  • Windows Server 2012

  • Windows 8 (32-bit and 64-bit)

  • Windows Server 2008 R2

  • Windows Server 2008 (32-bit and 64-bit)

  • Windows 7 (32-bit and 64-bit)

Microsoft SQL Server installed on the proxy agent computers

One of the following versions, to enable the functionality of the Avaya CM supplemental database:

  • SQL Server Express edition

  • SQL Server 2017

  • SQL Server 2016

  • SQL server 2014

  • SQL server 2012

  • SQL Server 2008 R2

AppManager for Microsoft Windows module installed on repository, proxy agent, and console computers

7.6.170.0 or later. For more information, see the AppManager Module Upgrades & Trials page.

Microsoft .NET Framework

4.0 or above.

Microsoft SQL Server Native Client 11.0

(for TLS 1.2 support)

11.3.6538.0 or later

NOTE:The SQL Server Native client can be installed from this Microsoft download link.

NOTE:If you want TLS 1.2 support and are running AppManager 9.1 or 9.2, then you are required to perform some additional steps. To know about the steps, see the article.

3.0 Contents of the Download Package

Avaya Communication Manager includes a managed object, qNQAvayaCM.dll, and Knowledge Scripts to discover and monitor Avaya Communication Manager resources. The download package includes these release notes, a management guide, and several files that are used during installation:

  • AM70-AvayaCM-8.0.30.1.msi, the module installer.

  • AM70-AvayaCM-8.0.30.1.ini, a configuration file used with the AppManager setup program.

  • AM70-AvayaCM-8.0.30.1.xml, a configuration file used for deploying the module with Control Center. This is the file you check into the Control Center Web Depot.

  • ckAvayaCM.exe, the pre-installation check used with the AppManager setup program.

When you download the module, these files are copied by default to the local folder on the download computer. Consider copying these files to the \windows_installation\setup\Setup Files folder on the same distribution computer on which you saved your main AppManager software and documentation. By doing so, you maintain all AppManager software in one location that is easily accessible when you want to add more repositories, management servers, or agents.

4.0 Installing This Module

Run the module installer to install the module components in the following locations:

  • On all proxy agent computers you want to monitor (agents) to install the agent components

  • On all console computers to install the Help and console extensions

Run the module installer only once on each of these computers.

When you install to each QDB, select the option to install Knowledge Scripts, and then specify the SQL Server name of the server hosting the QDB, as well as the case-sensitive QDB name.

Important This release provides SQL stored procedures. To ensure module functionality, run the module installer for each QDB attached to Control Center.

Install Knowledge Scripts only once per QDB. The module installer now installs Knowledge Scripts for each module directly into the QDB instead of to the \AppManager\qdb\kp folder as in previous releases.

For more information about installing this module, see the AppManager Management Guide, included in the download package.

5.0 Known Issues

NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. The following issues are currently being researched. If you need further assistance with any issue, please contact Technical Support.

  • A port conflict might occur if a monitored computer has Windows Media Player installed on it. The port conflict occurs when another application, in this case the Windows Media Player services, is competing for UDP port 5005. To work around this issue, NetIQ Corporation recommends you use an alternate port number, such as 5006, or a port confirmed to be available with the netstat command. For more information on specifying the UDP port number, see section 2.7 and 2.10 in the AppManager for Avaya Communication Manager Management Guide. (ENG325896)

  • The tilde “~” character is not allowed in the name of an Avaya resource object. Because the tilde “~” is used as a delimiter, you cannot use a tilde in the name of an Avaya resource object. (DOC327296)(ENG123459)

  • AvayaCM Knowledge Scripts fail after modifications to the local repository. If you have already run the Discovery_AvayaCM script and you modify or replace local repository data, such as reinstalling a local repository, you must run the Discovery_AvayaCM script again on the affected resources to synchronize the contents of the local repository. Until you run the discovery again, other AvayaCM Knowledge Scripts will continue to fail. (ENG288115)

  • SNMP request failures. If you do not have an H.248 Media Gateway in your monitored environment, the AvayaCM_RegisteredResources Knowledge Script always raises an event for SNMP request failure. (ENG245960)

  • Multiple Trap Receiver objects created when multiple devices discovered. The module creates a Trap Receiver object for each discovered Communication Manager when multiple Communication Managers are discovered at the same time. When using the Comma-separated list of associated server IP addresses parameter to discover Trap Receivers for multiple Communication Managers, run a separate Discovery_AvayaCM job for each Communication Manager. (ENG282591)

  • Incomplete details for calls to softphones. Softphones might not report all available call statistics for incoming calls. A softphone is software for making VoIP calls. (ENG289808)

  • Off-Premise Telephone (OPT) stations might not be reported as registered by Communication Manager. Some OPT stations, such as SIP phones, might not be reported as registered by the Communication Manager server. These devices are reported as unregistered by the PhoneInventory, PhoneDeregistrations, and RegisteredResources Knowledge Scripts, regardless of the devices' status. (ENG289809)

  • PhoneInventory filtering feature not working properly. The PhoneInventory Knowledge Script creates an inventory of all phones when you select Type in the Select by parameter. (ENG291994)

  • Duplicate SSRCs cause inaccurate datastream. When two calls use the same Synchronization Source (SSRC) value at the same time, call quality statistics are recorded only for the first of the two conflicting calls. The lack of call quality statistics for a call results in an inaccurate value (less than it should be) for the ActiveCalls datastream. The SSRC is the source of a Real-Time Protocol (RTP) packet stream. (ENG292562)

6.0 Previous Releases

This release of Avaya Communication Manager includes enhancements added in previous releases.

6.1 Hotfix 7.6.0.1., March 2019

This release of AppManager provides the following enhancement:

  • Support for Avaya Communication Manager 7.1.3 and 8.0: This hotfix release of AppManager, provides support for Avaya Communication Manager 7.1.3 and Avaya Communication Manager 8.0.

This release of AppManager for Avaya Communication Manager resolves the following customer issue:

  • AvayaCM module causing agent crash: This hotfix release of AppManager for Avaya Communication Manager resolves AvayaCM module agent crash when using multiple TrunkGroups.(ENG347110)

6.2 Hotfix 7.5.0.7., May 2016

This release of AppManager resolves the following issue:

  • No data for Active Calls - Close/Shutdown RTCP Socket Correctly an issue occurs when multiple call data jobs are running at the same time when an agent restarts for any reason, access to the RTCP port can then become blocked resulting in an ERROR AvayaCM - The RTCPListener's "bind" call failed with error code 10048 log and 0 value for the call data collection stream. With this release, the socket management code was updated and a mutual exclusion region was applied to prevent these errors from occurring. (ENG340966).

6.3 Hotfix 7.5.0.6., March 2016

This release of AppManager provides the following enhancements:

  • Packages new Aura MIBs. With this release the new AVAYA-AURA-CM-MIB and AVAYA-AURA-CMALARM-MIB installs in the appmanager/bin directory. These MIBs are necessary to discover Aura call managers, and to fully decode traps received with the corresponding MIBs in SNMPTraps. (ENG340609).

  • Allows Discovery of call managers using AVAYA-AURA-CM-MIB SNMP MIB. With this release, Avaya allows discovery of call managers using the AVAYA-AURA-CM-MIB (Avaya releases 6.3 and later). Upon discovery, Avaya creates treeview objects that are necessary for the call managers to support call data collection functionality. Avaya also creates treeview objects that enable jobs requiring additional SNMP queries. (ENG340608)

  • Allows discovery of non-SNMP Avaya. With this release Avaya allows the discovery of Avaya call managers for which SNMP access is not available. Upon discovery, Avaya creates treeview objects necessary for call managers to support call data collection functionality. Avaya does not create treeview objects which allow jobs that require additional SNMP queries for these servers. (ENG340611)

  • Discovers station folder and allows station-based Knowledge Scripts for Aura and non-SNMP systems. With this release, Avaya the discovery of Avaya call managers that do not have access to SNMP. Upon discovery, Avaya creates treeview objects necessary for the call managers to support call data collection functionality. Avaya does not create treeview objects for enabling jobs that require additional SNMP queries for the servers. (ENG340911)

  • Updates licensing count for non-SNMP Avaya. This release updates the treeview details for Avaya call servers discovered without SNMP to include an estimated “subscriber count” from the CDR database. For call servers discovered using Avaya SNMP MIBs, the “subscriber count” used for licensing is the registered stations count in the Avaya SNMP MIB. (ENG340906)

6.4 Hotfix 7.5.0.5., December 2015

This release resolves the following issues:

  • Renaming Avaya trunks cause AppManager to stop monitoring the trunks. This release resolves the issue in which the datapoints for the trunks were reported with the “old” object name until discovery. With this release, the name in the datastream will match the name by which the object is known in the treeview. The exception is for objects identified by an index number in the name, following the device discovery, when the Add Avaya Index to Discovered Names parameter is selected, datastreams for these objects will match the index number in the treeview, regardless of whether the name matches.(ENG339487) For additional information about the Add Avaya Index to Discovered Names parameter, see the “Discovering Avaya Communication Manager Resources” in the Management Guide.

  • AvayaCM always reports LSP Status against 1 LSP after ENG337359 PF. This release resolves the issue that occurred after ENG337359 when the agent managed object, which was running a job against multiple objects, reports all error events against only the first object in the list. With this release, when the agent managed object runs a job against multiple objects, any errors detected against those objects will be reported.(ENG338876)

  • Trunk Groups with duplicate names are not displayed. This release resolves an issue in which any trunk group that had a name which was not unique was identified with a numeric suffix. With this release, a new parameter Add Avaya Index to discovered names was added to discovery. When you select this parameter, all discovered Avaya objects for collected indices are placed in the treeview with a treeview name formed by suffixing the index of the object to the Avaya name for the object. Fax test 1 at index 14 becomes Fax test 1[14]and Fax test 2 at index 15 becomes Fax test 2[15].(ENG334424) For more information about the Add Avaya Index to discovered names parameter, see the “Discovering Avaya Communication Manager Resources” section in the Management Guide.

  • AvayaCM_HuntGroupUsage and other Knowledge Scripts not collecting data, and AvayaCM is sharply limited in the number of simultaneous “get requests” that can be processed. This release resolves a set of issues where AvayaCM was unable to provide SMNP data for requests because the request rate and volume exceeded its internal performance limits. We reduced the number of requests and the limited request rate to reduce the load on AvayaCM to better allow it to keep up with the requests.(ENG338854, ENG336716, ENG337359, ENG336037)

6.5 Release 7.5.62.0, October 2013

This release resolves the following issues:

  • AvayaCM_CallActivity Knowledge Script generates multiple data streams for a single metric. This release resolves an issue in which the AvayaCM_CallActivity script created multiple data streams and did not correctly associate data points with those data streams, instead of creating a single data stream and associating all data points with that data stream. With this release, an update to the AvayaCM_CallActivity script allows the script to create data streams and data points correctly (ENG330096)

  • AvayaCM_SecurityViolations Knowledge Script does not return security violation data. This release resolves an issue in which the AvayaCM_SecurityViolations script did not report security violation data when the login port name you wanted to monitor was blank. With this release, the AvayaCM_SecurityViolations script accurately reports security violations in this situation. (ENG330474)

  • Discovery_AvayaCM Knowledge Script does not fully discover an Avaya device although it reports a successful discovery. This release resolves an issue in which the Discovery_AvayaCM script reported a successful discovery for an Avaya Communication Manager cluster, but due to an SNMP message or a task timeout error, the job did not actually discover all the resources for that cluster. With this release, an update to the Discovery_AvayaCM script prevents the script from discovering resources and instead generates an event message stating that discovery failed when an SNMP message or task timeout error occurs on an Avaya CM cluster. (ENG330086)

This release includes the following support:

  • Support for Windows 8 and Windows Server 2012. This release supports Windows 8 and Windows Server 2012 on proxy agent computers. For more information, see the System Requirements.

  • Support for Avaya Communication Manager 6.3, 6.2, and 6.1. You can use this release of AppManager for Avaya Communication Manager to monitor Avaya Communication Manager version 6.3, 6.2, and 6.1.

6.6 Release 7.5.52.0, March 2013

This release resolved the following issue:

  • Some AvayaCM Knowledge Scripts assign events to the wrong object in a folder containing the same type of objects. This release resolves an issue that occurred when you ran an AvayaCM script on a TreeView folder that contained more than one object of the same type, and the script assigned events only to the first object in the folder. With this release, when you run an AvayaCM script on a folder object, the script assigns an event to the correct object in that folder. (ENG325279)

  • Some AvayaCM Knowledge Scripts generate an “Internal Failure” error message when the device object has a comma in its name. This release resolves an issue in which an AvayaCM script failed when you ran the script on an object folder in the TreeView and an object in that folder had a comma in its name. In this situation, the script incorrectly identified the comma as a delimiter, creating a mismatch between the object names and the details for those objects. With this release, the AvayaCM scripts run without failing on objects that contain a comma in their names. (ENG324772)

6.7 Release 7.5.49.0, October 2012

This release resolved the following issue:

  • AvayaCM_AddPhone Knowledge Script cannot add a phone with an extension of more than ten digits. This release resolves an issue in which the AvayaCM_AddPhone script raised an error message stating that an extension was not found, when the extension actually existed, but contained more than ten digits. With this release, the AvayaCM_AddPhone script now supports extensions of up to 15 digits. (ENG321315)

  • AvayaCM_PhoneQuality Knowledge Script incorrectly labels zero delay measurements at the start of a call. This release resolves an issue in which the AvayaCM_PhoneQuality script reports a zero round-trip delay at the start of a call, even though the true delay is at that time unknown. This error resulted from an invalid metrics report received from the 96x1 Avaya station firmware. With this release, the AvayaCM_PhoneQuality script identifies and excludes invalid zero round trip time metrics reports at the start of the call. (ENG322414)

6.8 Release 7.5.40.0, October 2011

This release resolved the following issue:

  • The AvayaCM_SystemUptime job fails due to a negative uptime value. This release resolves an issue in which the AvayaCM_SystemUptime Knowledge job failed because AppManager incorrectly reported the system uptime value as a negative number, which caused the script to fail. With this release, AppManager no longer reports the negative value. (ENG312274)

  • Invalid data from an AvayaCM_PhoneQuality job causes a negative datastream value. This release resolves an issue in which the AvayaCM_PhoneQuality job encountered invalid packet loss data that resulted in a data point of -1. With this release, the AvayaCM_PhoneQuality job ignores the invalid packet count if no valid data is available, which keeps the job from generating a negative data stream value. (ENG312807)

  • Type 1 call data records are not generated when trace level is set to Error. This release resolves an issue in which type 1 call data records (CDRs) did not get generated with the default trace level setting of Error, as well as the Info setting. This release ensures that Type 1 CDRs get generated regardless of the trace level settings. (ENG313291)

  • A discovered object with a comma in its name causes AvayaCM Knowledge Scripts to fail. This release resolves an issue in which AvayaCM Knowledge Scripts failed when run on an object containing a comma in its name. This release allows you to run scripts on the following objects, even if they contain commas in their names: LSS, ESS, trunk group, hunt group, announcement, and gateway objects. However, because the name of the cluster is used as the name of the SQL database, and a comma is a special character to SQL, the cluster object name cannot contain a comma. With this release, you can successfully run all AvayaCM scripts on objects that have commas in their names, so long as the cluster name itself does not contain a comma. (ENG311613)

6.9 Release 7.5.35.0, August 2011

This release provided the following enhancements:

  • Support for Avaya Communication Manager 6.0. You can use this release of AppManager for Avaya Communication Manager to monitor Avaya Communication Manager version 6.0. For more information, see the System Requirements.

  • Support for retrieving configuration data when running the AddPhone Knowledge Script. You can use the AvayaCM_AddPhone script to retrieve SNMP configuration data for your phones, leading to a faster setup for phone quality monitoring. (ENG308004)

  • Support for filtering by Facilities Restriction Level (FRL) codes. You can use the AvayaCM_CallFailures Knowledge Script to filter by some or all FRL codes. (ENG287372)

This release also resolved the following issues:

  • The AvayaCM_PhoneQuality Knowledge Script fails due to negative datastream values. This release resolves an issue in which the AvayaCM_PhoneQuality script generated “internal failure” errors because of negative values in the PctPacketLoss datastream. With this release, an update to the code of the AvayaCM_PhoneQuality script prevents the errors. (ENG309871)

  • Improve information provided by AvayaCM_SNMPTrap Knowledge Script for unmapped traps. This release resolves an issue in which the event message for the AvayaCM_SNMPTrap script provided a default message for unmapped traps which did not contain enough data to describe the cause of the event. With this release, the AvayaCM_SNMPTrap script includes more information in the default event message for unmapped traps. (ENG276822)

  • Allow user-selectable filters for call completion codes in the AvayaCM_CallFailures Knowledge Script. This release allows you to specify specific Avaya Communication Manager failure codes to be considered in counting failed calls for the AvayaCM_CallFailures script. With this release, a new Knowledge Script parameter lets you filter by failure code, including calls with a duration of zero. (ENG294041)

7.0 Contact Information

Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please email Documentation-Feedback@netiq.com. We value your input and look forward to hearing from you.

For detailed contact information, see the Support Contact Information Web site.

For general corporate and product information, see the NetIQ Corporate Web site.

For interactive conversations with your peers and NetIQ experts, become an active member of our community. The NetIQ online community provides product information, useful links to helpful resources, blogs, and social media channels.