This section contains important information about release 6.5.0 of Zenoss Resource Manager (Resource Manager). 

New features

The focus of this release is improved zenhub performance and reporting capabilities:

• The zenhub service now handles device configuration requests more quickly.
• Enterprise reports includes updated support for organizers. 

In addition, the following updates to core components are included in this release:

• MariaDB is updated to version 10.3.
• The RelStorage library is updated to version 3.0.
• The Twisted library is updated to version 19.10.

Finally, the self-monitoring features now include sending notifications when jobs are stuck. An event is sent when there are jobs in the zenjobs (Celery) queue but none have been processed for 10 minutes. 

Considerations and workarounds

Compatibility with Zenoss Service Impact

This version of Resource Manager is compatible with Zenoss Service Impact version 5.5.2 or later. All users are strongly encouraged to upgrade Service Impact to the latest version.

Update considerations

Please note the following update considerations:

• Resource Manager 6.5.0 requires Control Center 1.7.0. Please update Control Center before updating Resource Manager.
• New for this release: A python script to manage custom MariaDB passwords before updating, which preserves custom passwords.
• Virtual appliance installation and update files are based on CentOS 7.6 and include Control Center 1.7.0 and Service Impact 5.5.1. 
• Due to the RelStorage library update, the Resource Manager 6.5.0 update process supports only releases 6.4.1, 6.4.0, and 6.3.2.
  To update earlier releases of Resource Manager to 6.5.0, first update to release 6.4.1.
• Due to the Twisted library update, the Layer2, OpenStack and OpenStackInfrastructure Zenpacks must be updated to their most recent releases before Resource Manager can be updated to release 6.5.0. Other ZenPacks that use the Twisted library may be affected, too.

• During updates to release 6.5.0, the following message appears several times during the MariaDB update and can be ignored: 

  Error    : Column count of mysql.proc is wrong. Expected 21, found 20. Created with MariaDB 100140, now running 100322. Please use mysql_upgrade to fix this error
  error    : Corrupt

Regular expression matching limitation

(ZEN-29376) Resource Manager uses the Apache Solr search platform, which tokenizes fields. Currently, searching a tokenized field with a regex matches only a single token, limiting complex regex searches.

For example, on the INFRASTRUCTURE page, IP Address is a tokenized field. Regex search ^192.168 will not work to filter only IP addresses that start with 192.168. The Device column is untokenized; regex search on the device name works as expected.

NFS client 4.1 is not supported

A file locking defect might exist in NFS 4.1 with RHEL/CentOS 7.4, which could cause zeneventserver to crash and other DFS-related problems. For more information, see Configuring NFS 4.0 or knowledge base article Potential Issues Running With RHEL 7.4 Or CentOS 7.4.

CentralQuery maximum memory allocation pool

(ZEN-15907) The size of the CentralQuery maximum memory allocation pool is set by the RAMCommitment variable in the CentralQuery service definition. The default value is 1024MB. Do not change the value to anything less than 1024MB.

LDAP authentication

(ZEN-31194) This release includes LDAPAuthenticator v3.3.3, which no longer includes an option to skip SSL certificate verification during installation or upgrade. If you are using a self-signed certificate, upload it before upgrading. For more information, see Adding an SSL certificate.

High-availability deployments

The documentation for this release includes a new publication, the Upgrade Guide for High-Availability Deployments. The document includes procedures for performing an update from recent releases of Control Center and Resource Manager to Control Center 1.7.0 and Resource Manager 6.5.0.

Device re-identification can slow or hang the system

(ZEN-32859, ZEN-31163) Re-identifying a device can cause the OpenTSDB reader service to open many connections to OpenTSDB, which in turn can slow or hang the system. This issue occurs when the re-identification is initiated through both the API and the browser interface. To prevent the issue, do not retain performance data when re-identifying devices.   

Installation considerations

On installation, the OpenTSDB database now uses 4 bytes instead of 3 bytes for the UID field. This means that

• the maximum number of data points (metric values) the database can store is now greater than 4.2 billion, up from approximately 16.7 million
• the database requires more storage space (approximately 1 byte more per stored data point)

Updates from previous releases do not get the larger field size; only new installations.

Deprecation notice

In a future release of Resource Manager, the visualization features of the DynamicView ZenPack will be deprecated (removed). For example, the component relationships of a device will not be visualized. 

Tested operating environments

The Resource Manager application is deployed in and managed by Control Center. The operating environments of Resource Manager are the Control Center environments that are tested with a given release. The following sections identify the tested operating environments of Resource Manager and Control Center.

Resource Manager, Control Center, and operating systems

The following table identifies the tested combinations of Resource Manager, Control Center, and operating system releases.

Hypervisors

Public cloud platforms

Amazon Web Services (AWS) is fully tested.

Microsoft Azure has been tested only for collector pools. Creating a full Control Center deployment to operate Resource Manager has NOT been tested on Microsoft Azure.

Fixed issues

Known issues

Installed ZenPacks

This section lists ZenPacks that are automatically installed, those that are packaged but not installed, and those that are obsolete and should be uninstalled. For more information about ZenPacks, see the ZenPack Catalog.

This release of Resource Manager installs the following ZenPacks at the current version listed in the table.

† In a future release of Resource Manager, the visualization features of the DynamicView ZenPack will be deprecated (removed). For example, the component relationships of a device will not be visualized.

Packaged ZenPacks

The following ZenPacks are packaged with Resource Manager, but not automatically installed:

• BigIpMonitor
• Ceph
• CiscoAPIC
• DB2
• DatabaseMonitor
• FtpMonitor
• GoogleCloudPlatform
• HpuxMonitor
• JBossMonitor
• Kubernetes
• Layer2
• Memcached
• Microsoft.Exchange
• Microsoft.Lync
• Microsoft.MSMQ
• NSX
• NetScaler
• NetScreenMonitor
• OpenStack
• OpenStackInfrastructure
• OpenvSwitch
• PostgreSQL
• RabbitMQ
• TomcatMonitor
• XenServer

Obsolete ZenPacks

ZenMailTX is obsolete. If this ZenPack is installed at your site, uninstall it.