Oracle Coherence Monitor

Release Notes

 


Version 6.3.0 Release Notes

Alerts

19689: Two new alerts for proxy/extend backlog

Two new limits alerts OcExtendConnectionByteBacklogHigh and OcProxyNodeByteBacklogHigh have been added to the OCMON alerts set. These alerts are associated to Extend Connections and Proxy Node respectively.

20763: New Alert OcHATargetFailed

A new alert OcHATargetFailedhas been added. This alert triggers when the (distributed service) target status (HATarget) has not been met. The HA Target value is determined using the PartitionAssignment MBean in Coherence Versions 12 and above. In prior versions of coherence, the default value of MACHINE-SAFE is used. The default value can be overridden by setting the substitution variable $ocmDefaultHATarget to the desired value.

20866: New Cache Activity Alerts

New alerts are available to monitor cache activity across cache tiers and alert if it is excessive. The metrics represent rate of various activities against a given tier of a given cache for a given service in a given (coherence) cluster. The tier can be front, where appropriate, or back. Caches and services are named, and (coherence) clusters are represented by their named monitoring connection. A new alert - OcCacheRateTotalPutsHigh has been added. This alert will trigger when the rate of cache puts goes above the specified threshold for the specified duration. This alert has per cluster, per (cache) service, per cache and per (cache) tier overrides. This alert appears in the "Other" Category when triggered. A new alert - OcCacheRateTotalGetsHigh has been added. This alert will trigger when the rate of cache gets goes above the specified threshold for the specified duration. This alert has per cluster, per (cache) service, per cache and per (cache) tier overrides. This alert appears in the "Other" Category when triggered. A new alert - OcCacheRateCacheMissesHigh has been added. This alert will trigger when the rate of cache misses goes above the specified threshold for the specified duration. This alert has per cluster, per (cache) service, per cache and per (cache) tier overrides. This alert appears in the "Other" Category when triggered. A new alert - OcCacheRateStoreReadsHigh has been added. This alert will trigger when the rate of cache store reads (load operations) goes above the specified threshold for the specified duration. This alert has per cluster, per (cache) service, per cache and per (cache) tier overrides. This alert appears in the "Other" Category when triggered. A new alert - OcCacheRateStoreWritesHigh has been added. This alert will trigger when the rate of store writes (store and erase operations) goes above the specified threshold for the specified duration. This alert has per cluster, per (cache) service, per cache and per (cache) tier overrides. This alert appears in the "Other" Category when triggered. These alerts are disabled by default as appropriate threshold values will vary by installation an will need to be set accordingly.

Cache

19448: Single Cache Summary trends now displayed correctly

In previous versions, under certain circumstances, data for the Trend Graphs were not displayed correctly. This is no longer the case.

Cluster

20641: New Top Level Cluster Selection Screen

A new top level cluster selection screen has been added. The new top level screen consists of a single table where each row represents a coherence cluster that is being monitored. Selecting a row in the Cluster Selector table will navigate to the Cluster - Overview screen for that cluster. Data will come from the selected dataserver, and the named connection will be selected cluster drop down selector on the cluster overview screen. Each row in the table has summary overview data for the monitored (coherence) cluster. The Columns in the table are described as follows. Connection: The name of the used defined connection used to connect to the monitored coherence cluster. Alert Severity: A "traffic light" icon representing the max alert severity of alerts on that cluster. * Red - Alerts have triggered for the given cluster. * Amber - Warning Alerts have triggered for the given cluster. * Green - No Alerts have triggered for the given cluster. Alert Count: The number of Alerts for the given cluster. Cluster Size: The total number of nodes for the given cluster. Caches: The total number of caches for the given cluster. Objects: The total number of objects stored in the given cluster. Data Sever:The name of the Data Server (connection) used to monitor the given cluster For Standalone OCM Systems where there is only one (default) dataserver - the dataserver is named __default. In systems where there are multiple dataservers used to monitor coherence clusters, each dataserver is named using the named dataserver connection used to connect to that dataserver. In this way the table contains all the (declared) dataservers used to monitor coherence clusters. In the case of dataservers monitoring multiple coherence clusters via multi cluster monitoring, there will be one row for each connection on that cluster. Selecting that row in the table will navigate to the Cluster - Overview screen for that cluster. Data will come from the selected dataserver, and the named connection will be selected cluster drop down selector on the cluster overview screen.

20761: Add background colors for new StatusHA Values

Background colors have been added for the new StatusHA Values RACK-SAFE and SITE-SAFE, where the StatusHA value is displayed in existing displays. A contrasting text color is used

Data Sources

19009: Optimized JMX data retrieval option using custom MBeans (JMX Tables)

An option is available to speed up retrieval of Coherence MBean information (over JMX) by providing the aggregated MBean data in tabular form by using custom MBeans. This option is useful when monitoring large clusters (clusters with a large number of nodes, caches and or services) using JMX, where the volume of data retrieved can effect the time taken to retrieve all the data, and thus limit the sampling rate for monitoring data. By using custom MBeans the data is aggregated within the cluster, and transmitted in the form of tabular data, rather than as individual attributes, reducing the time taken to query the data. Enabling this requires (unlike default JMX monitoring) that the custom MBeans (contained in a jar) are deployed and registered on all nodes in the cluster, and the monitoring is configured to query the custom MBeans. The Oracle Coherence Documentation describes registering custom mbeans in a declarative manner in detail https://docs.oracle.com/cd/E18686_01/coh.37/e18682/custom_mbeans.htm#COHMG4712 The key points are: * The Custom MBeans must be found at run time. Make sure to place the library that contains the MBeans in the classpath of the coherence nodes/members including the JMX management-enabled member. * The Custom MBeans are specified using a MBean Configuration Override File The Custom MBeans (CacheTable, ServiceTable, StorageManagerTable) are contained in the jar ocjmxtables.jar. The jar ocjmxtables.jar is located in the rtvapm/ocmon/lib directory of the ocmon installation. This jar file must added to the classpath of the Coherence members to be monitored. This may require that the jar be copied to a location that is visible to all the coherence members. This may vary based on your deployment. It may prove convenient to copy it to where the coherence jars are deployed, so they can use the same classpath root. The tangosol.coherence.mbeans system property specifies an MBean configuration override file to be used instead of the default custom-mbeans.xml override file. The MBean configuration file to be used is called sl-custom-mbeans.xml and is contained at the root of the ocjmxtables.jar. Thus when the ocjmxtables.jar is added to the Coherence members classpath, it can be specified by setting the tangosol.coherence.mbeans system property for the Coherence cluster members to reference it thus -Dtangosol.coherence.mbeans=/sl-custom-mbeans.xml The above should be applied to all Coherence cluster members so that the tangosol.coherence.mbeans system property is set to /sl-custom-mbeans.xml If you have configured your coherence cluster correctly, you should be able to connect to the cluster using JConsole, and see in addition to the previous Cache, Service, and StorageManager MBeans the new custom CacheTable, ServiceTable, and StorageManagerTable MBeans. To configure the ocm monitoring system to use the Custom MBeans, you should configure your monitoring system to use JMX as normal, and then uncomment the (rtview.properties) line below # JMX TABLES # # Uncomment the line below to use the JMX tables custom mbeans #maincollector.sl.rtview.cmd_line=-ocjmxtables so that the -ocjmxtables command line argument is passed to the maincollector program (typically this is the dataserver) If this is done, then the log file will contain the following text at startup ... using OC JMX Tabular Data And at runtime, the previous JMX queries ( as seen in the JMX Metrics Administration display in the MBean Query Key column of the RTView JMX Query Statistics table ) * Coherence:type=Cache,* 0 * -1 *- * Coherence:type=Cluster 0 * -1 *- * Coherence:type=Service,* 0 * -1 *- Will now be * Coherence:type=CacheTable,* 0 CacheTable -1 *- * Coherence:type=ServiceTable,* 0 ServiceTable -1 *- * Coherence:type=StorageManagerTable,* 0 StorageManagerTable -1 *- And should have a reduced execution time leading to a reduced total (Jmx Query) Execution time. In Summary * Add the ocjmxtables.jar to the classpath of the cluster members * Set -Dtangosol.coherence.mbeans=/sl-custom-mbeans.xml for the cluster members JVM's * Use the maincollector.sl.rtview.cmd_line=-ocjmxtables property for the OCM monitoring system.

General

19864: Enhanced visibility of Status in Summary pages

The visibility of the Status text has been enhanced in the Single Cache -> Cache Summary and the Cache Service -> Single Service Summary displays.

19623: Updated all displays with new resizing behavior

Six OCM displays were modified so that when they are stretched vertically the upper and lower data display elements (heatmaps, bar charts, etc) resize equally. Prior to this change only one of those elements would resize, with the other remaining at the initial height. The six displays are: Cluster Views -> All Services History Cluster Views -> All Nodes History Cache Services -> Service Metric Heatmap Cache Services -> Single Service History All Caches -> Current Activity Chart All Nodes -> Communication Issues

19625: Modified trend colors

The colors of certain displays have been modified to improve their readability.

20854: New CPU Metric in Cache, UI and Alert

A new metric is available to monitor average CPU use across a cluster by storage class, and alert if it is excessive. A new Metric AvgCpuPercent has been added to the OcNodeTotals cache. This metric is the average CPU usage of all the nodes of a given storage class in a cluster. The storage class is represented by the StorageEnabled index column, which can be true or false. Thus metrics for storage enabled nodes in a cluster are aggregated into a cache row where StorageEnabled = true, and non storage enabled nodes in a cluster are aggregated into a cache row where StorageEnabled = false. This metric is displayed as trace on the Cluster - Memory/Network Health display. The Metric has the legend "Avg. CPU %" and is displayed (for storage enabled nodes) in the Storage Nodes trend grouping and (for non storage enabled nodes) in the Process Nodes trend grouping. A new alert - OcClusterNodesCPUHigh has been added. This alert will trigger when the average CPU usage for the cluster / storage class goes above the specified threshold for the specified duration. This alert has a per cluster and a per (cluster) storage class override. This alert appears in the "Other" Category when triggered.

20865: New Cluster Nodes Alerts

New Alerts are available to monitor memory use and network health across a cluster by storage class, and alert if it is excessive. The metrics are averaged across all of the nodes of a given storage class in a cluster. The storage class is represented by the StorageEnabled index column, which can be true or false. Thus metrics for storage enabled nodes in a cluster are aggreagated into a cache row where StorageEnabled = true, and non storage enabled nodes in a cluster are aggreagated into a cache row where StorageEnabled = false. A new alert - OcClusterNodesMemHigh has been added. This alert will trigger when the average memory usage for the cluster / storage class goes above the specified threshold for the specified duration. This alert has a per cluster and a per (cluster) storage class override. This alert appears in the "Memory" Category when triggered. A new alert - OcClusterNodesSentFailureRateHigh has been added. This alert will trigger when the average (network/packet) sent failure rate for the cluster / storage class goes above the specified threshold for the specified duration. This alert has a per cluster and a per (cluster) storage class override. This alert appears in the "Memory" Category when triggered. A new alert - OcClusterNodesRcvdFailureRateHigh has been added. This alert will trigger when the average (network/packet) received failure rate for the cluster / storage class goes above the specified threshold for the specified duration. This alert has a per cluster and a per (cluster) storage class override. This alert appears in the "Network" Category when triggered.

20878: Cache activity Alerts enabled as EM key metrics

New Cache Activity Alerts are available as Key Metrics to monitor cluster health based on excessive cache activity. The new Alerts are of CI-TYPE OC-CACHE, and monitor cache activity. CI-TYPE OC-CACHE has indices that represent (coherence) Cluster, (Cache) Service, Cache (Name) and Tier (front or back as appropriate). The Top Level (Level 0) Cache Key Metric Alerts are as follows The OcCacheRateTotalPutsHigh Alert sets the threshold for the (Cache) Rate Cache Puts metric. The OcCacheRateTotalGetsHigh Alert sets the threshold for the (Cache) Rate Cache Gets metric. The OcCacheRateStoreReadsHigh Alert sets the threshold for the (Cache) Rate Cache Misses metric. The Top Level 1 Cache Key Metric Alerts are as follows The OcCacheRateStoreReadsHigh Alert sets the threshold for the (Cache) Rate Store Reads metric. The OcCacheRateStoreWritesHigh Alert sets the threshold for the (Cache) Rate Store Writes metric. These alerts are disabled by default as appropriate threshold values will vary by installation and will need to be set accordingly.

Monitor

20537: New properties to limit Display Server table cells

The Monitor has been enhanced to support 3 new properties to limit the amount of data that is passed from the Display Server to the browser for tables. The following properties have been added to common\conf\rtvapm.properties: cellsperpage - This limits the number of cells (columns*rows) that will be displayed in a table object. This avoids the sluggish performance, timeouts, and out-of-memory exceptions that might otherwise occur from processing and transmitting all of the rows at once Table objects with more than the specified number of cells are paged. This means that the Display Server only sends the rows that are visible plus a few rows before and after the visible rows. As the user scrolls, the new rows are requested from the Display Server. This results in a small delay between the scroll action and the data showing up in the table. The default is 20000. cellsperexport - This limits the number of cells (columns*rows) that will be exported for the Export to Excel and Export to HTML operations. The default is 40000. cellsperreport - This limits the number of cells (columns*rows) that will be exported for the Export to PDF operation. The default is 20000. For all of the new properties, a value of less than 1000 will disable the property. Values larger than the defaults may result in slower performance, timeouts and/or out-of-memory exceptions when interacting with tables in displays in the thin client.

Platform Support

20536: Support added for Red Hat Linux 7

RHEL 7 is now a supported platform for RTView.

Proxy / Extend

19610: Fixed Proxy/Extend Connections trend

The Proxy Services -> Proxy / Extend Connections display has been improved to prevent some errors in the trend graphs. Alert Level has been also added to the two tables that show Proxy and Remote End Point information. Alert Level has been also added to the two tables shown in Proxy Services -> Proxy / Extend Detail display.

19611: Enhanced Proxy/Extend Client Heatmap

The Proxy Services -> Proxy / Extend Overview has been enhanced to be driven through four more metrics: Alert Severity, Alert Count, Bytes Backlog, and Proxy Bytes Backlog. Total metrics have been removed from the Metric drop down. Now from the heatmap one can drill down to the Proxy Services -> Proxy / Extend Connections display.

19690: Added OutgoingByteBacklog to proxy node and extend client caches

OutgoingByteBacklog has been added to history in the OcProxyServiceStats, OcProxyServiceTotals, and the OcExtendConnections caches. As part of this change, the column "OutgoingByteBacklog" has been added to the history tables OCM_PROXYSERVICESTATS, OCM_PROXYSERVICETOTALS, and OCM_EXTENDCONNECTIONS. These history tables are not enabled in a default configuration, so not all users will already be using these tables. Users who do have existing database tables will need to alter their table to include this additional column. (Task 19797 also has caused changes to OCM_PROXYSERVICESTATS. See that release note for more information.) The new table structure (DB2 example) is: CREATE TABLE "OCM_EXTENDCONNECTIONS" ( "TIME_STAMP" TIMESTAMP , "OutgoingByteBacklog" BIGINT , "UUID" VARCHAR(100) , "name" VARCHAR(100) , "Connection" VARCHAR(100) , "Location" VARCHAR(100) , "RemoteEndpoint" VARCHAR(100) , "DeltaTotalBytesReceived" BIGINT , "DeltaTotalBytesSent" BIGINT , "DeltaTotalMessagesReceived" BIGINT , "DeltaTotalMessagesSent" BIGINT , "DeltaRefreshTime" BIGINT , "RateTotalBytesReceived" DOUBLE , "RateTotalBytesSent" DOUBLE , "RateTotalMessagesReceived" DOUBLE , "RateTotalMessagesSent" DOUBLE ) IN "USERSPACE1" ; CREATE INDEX "rtvts_ocm_extendconnections" ON "OCM_EXTENDCONNECTIONS" ("TIME_STAMP"); CREATE INDEX "rtvpk_ocm_extendconnections" ON "OCM_EXTENDCONNECTIONS" ("Connection","Location","name","UUID","RemoteEndpoint","TIME_STAMP"); CREATE TABLE "OCM_PROXYSERVICESTATS" ( "TIME_STAMP" TIMESTAMP , "name" VARCHAR(100) , "Location" VARCHAR(100) , "RequestPendingCount" BIGINT , "Connection" VARCHAR(100) , "ConnectionCount" INTEGER , "OutgoingByteBacklog" BIGINT , "DeltaTotalBytesSent" BIGINT , "DeltaTotalBytesReceived" BIGINT , "DeltaRefreshTime" BIGINT , "RateTotalBytesSent" DOUBLE , "RateTotalBytesReceived" DOUBLE ) IN "USERSPACE1" ; CREATE INDEX "rtvts_ocm_proxyservicestats" ON "OCM_PROXYSERVICESTATS" ("TIME_STAMP"); CREATE INDEX "rtvpk_ocm_proxyservicestats" ON "OCM_PROXYSERVICESTATS" ("Connection","Location","name","TIME_STAMP"); CREATE TABLE "OCM_PROXYSERVICETOTALS" ( "TIME_STAMP" TIMESTAMP , "Connection" VARCHAR(100) , "name" VARCHAR(100) , "ConnectionCount" INTEGER , "DeltaTotalBytesSent" BIGINT , "DeltaTotalBytesReceived" BIGINT , "RateTotalBytesSent" DOUBLE , "RateTotalBytesReceived" DOUBLE , "DeltaTotalMessagesSent" BIGINT , "DeltaTotalMessagesReceived" BIGINT , "RateTotalMessagesSent" DOUBLE , "RateTotalMessagesReceived" DOUBLE , "RequestPendingCount" BIGINT , "OutgoingByteBacklog" BIGINT ) IN "USERSPACE1" ; CREATE INDEX "rtvts_ocm_proxyservicetotals" ON "OCM_PROXYSERVICETOTALS" ("TIME_STAMP"); CREATE INDEX "rtvpk_ocm_proxyservicetotals" ON "OCM_PROXYSERVICETOTALS" ("Connection","name","TIME_STAMP"); See rtvapm/ocmon/dbconfig/*.sql for the example schema that pertains to your database.

19797: Added the Service Name as an index to proxy/extend caches

The Proxy / Extend Overview, Proxy /Extend Connections, and Proxy /Extend Detail displays have been enhanced to provide better drill down capabilities and additional information about alert state of Proxy Services and Extend Connections. As part of this change, the column "name" has been added to the history table OCM_PROXYSERVICESTATS as an index column. Users with existing database tables will need to alter their table to include this additional column. (Task 19690 also has caused changes to this table. See that release note for more information.) The new table structure (DB2 example) is: CREATE TABLE "OCM_PROXYSERVICESTATS" ( "TIME_STAMP" TIMESTAMP , "name" VARCHAR(100) , "Location" VARCHAR(100) , "RequestPendingCount" BIGINT , "Connection" VARCHAR(100) , "ConnectionCount" INTEGER , "OutgoingByteBacklog" BIGINT , "DeltaTotalBytesSent" BIGINT , "DeltaTotalBytesReceived" BIGINT , "DeltaRefreshTime" BIGINT , "RateTotalBytesSent" DOUBLE , "RateTotalBytesReceived" DOUBLE ) IN "USERSPACE1" ; CREATE INDEX "rtvts_ocm_proxyservicestats" ON "OCM_PROXYSERVICESTATS" ("TIME_STAMP"); CREATE INDEX "rtvpk_ocm_proxyservicestats" ON "OCM_PROXYSERVICESTATS" ("Connection","Location","name","TIME_STAMP"); See rtvapm/ocmon/dbconfig/*.sql for the example schema that pertains to your database.

RTView Core Functionality

20643: New option to restrict number of characters in alert comments in the alert ds

The Alert data source has been enhanced with a new Maximum Characters Allowed in Comments Field property to limit the number of characters it will store in the Comments field. In previous releases, new comments were appended to the existing contents of the Comments field with no limit on the amount of text. This caused problems for alert persistence and alert history if the Comment field became longer than corresponding database field could handle. For this enhancement, the order of the comments has been reversed so that new comments are added before existing contents in the Comments field. If the Maximum Characters Allowed in Comments Field is greater than 0 and a new comment is added to an alert, the content of the Comments field will be trimmed by removing characters from the end of the contents if necessary to stay under the limit. By default, this feature is disabled and the Comments field will grow unbounded as new comments are added. To enable the limit, set the Maximum Characters Allowed in Comments Field in the Alerts tab of the Application Options dialog to a value greater than 0. You can set it using the following property: sl.rtview.alert.commentlimit This comment limit is be available via a data attachment to alert-commentlimit to facilitate building a UI that will prevent users to enter comments longer than this limit. Note that the UI text entry limit should be set to 100 characters less than the comment limit in order to account for the time stamp, user name and hard returns between comments. Persisted alerts with comments from a previous versions will have mixed order on the Comments contents. It will be oldest->newest for persisted comments, then newest->oldest for new comments added in this and later releases. Persisted comments from previous versions that have been persisted and are longer than the specified Maximum Characters Allowed in Comments Field will be trimmed on startup.

Alerts

19141: alertExpireMode added to event alerts

Event Alerts have been enhanced with a new property, alertExpireMode. This property supports 2 options: - Initial Time - if selected and the alertExpireTime is greater than 0, the alert will clear if the alertExpireTime has passed since the alert was generated. - Last Update Time - if selected and the alertExpireTime is greater than 0, the alert will clear if the alertExpireTime has passed since the alert received a data update Note that only indexed event alerts can receive data updates, so the Last Update Time option will not work for unindexed event alerts.

19291: Cleared event alerts no longer regenerated in ssa

In previous releases, event alerts that did not have a mapping for Cleared in the valueTableMap were erroneously regenerated after being cleared when running with Self Service Alerts enabled. This has been fixed.

20664: New option to exit if alert persistence is enabled but database table is unavailable

The Alert data source has been enhanced with a new property: sl.rtview.alert.exitOnPersistInitFailed This property controls what happens when alert persistence is enabled but cannot be initialized due to a database problem or configuration issue. When exitOnPersistInitFailed is set to false (default), RTView will initialize the alerts with persistence disabled. This is the behavior in previous releases. When exitOnPersistInitFailed is set to true, RTView will exit after the persistence initialization has failed without initializing the alerts.

Builder - Editing

19879: Fixed NPE when deleting local var with same name as global

A bug has been fixed in the Builder which caused a NullPointerException to be thrown if a local variable was deleted and the local variable had the same name as a global variable.

Commands

18643: japanese chars no longer garbled by "Send Email" command

The email command will now properly encode Japanese and other Asian characters contained in the text of the email. In prior release, such characters were garbled.

19854: Email command no longer garbles Japanese chars in name of attached file

The Send Email command no longer garbles Japanese and other non-ascii characters in the names of files attached to an email.

Data Historian

19469: Avoid removal of all batch data when some data is wrong.

The historian will no longer discard all rows in a batch if a SQL exception is thrown during an row insert. Instead it will catch the exception and continue with the other row inserts in the batch and commit all of the successful inserts at the end of the batch.

19786: smoothCompaction no longer throws NPE when there are no compaction rules

Previously a NPE was thrown when -smoothcompaction was used with a cache with a compaction type of "aggregate" but with no compaction rules. Now this scenario fails silently.

19915: Simple retention now applied only to tables without compaction rules

If a cache history table that was persisted by the historian had no compaction rules, then the simple retention time limit was applied to ALL tables persisted by the historian. This was incorrect. The simple retention limit will now only be applied to tables without compaction rules.

19992: New Smooth Compaction configuration options

New arguments have been added to customize how compaction smoothing is performed. -smoothingonly Run smoothing only without data being provided -smoothcompaction:table1,table2 Restrict the tables being smoothed to those specified

20019: Compaction smoothing no longer sets incorrect "run after" date

Previously, the smooth compaction option caused an an incorrect "run after" date to be set for further compaction. This could result in a small portion of data not being compacted. This has been fixed.

20067: Data retention (purging) now correctly performed after compaction/smoothing

Previously, database retention logic was incorrectly postponed after smoothing/compaction had taken place on a table. This could result in the retention of more data than specified in historian configuration. This has been fixed.

20159: Sync up data from the history cache when historian starts

The Historian supports a new option named persistInitTimeRange which affects the cache persistence feature. Normally, when the cache persistence feature is enabled in the historian, the historian begins collecting cache history data starting at the time when each data server connects. This is adequate in most situations. The persistInitTimeRange option can be used to specify a time range, in seconds, back from the current time that the historian should get cache history data from the data server. This can be useful if the historian is started sometime after the data server, so the data server has collected cache history that hasn't been sent to the historian. For example, if the data server was started an hour before the historian, then the historian could be started as follows, so that it will request an hour of cache history from the data server: run_historian -persistCaches:true -persistInitTimeRange:3600

20187: Option to perform compaction for a time range prior to "now"

An option was added to the Historian to allow for the smoothing process to only go back as far as a specified range in the form: -smoothCompactionRecent:NN Where NN is '1d' or '1w'

20254: Retention-only compaction now executed correctly

Previously the historian would fail to run compaction if the Compaction Rules consisted of a single rule that only specified a duration of Raw data (-). This has been fixed.

20637: New option to limit length of strings from cache table stored in db

The historian has been enhanced to support a limit on the length of a string from a cache table column that it will store in the database. If a string is longer than the specified limit, it will be truncated to the limit before it is stored in the database table. This can avoid SQL exceptions encountered when the length of a string exceeds the capacity of the column's data type (for example, 4000 characters in an VARCHAR2 column in Oracle). The limit is specified by a new property named stringColMaxLen. This can be specified in HISTORY.ini as follows: stringColMaxLen 3500 It can also be specified on the command line or a properties file. By default the property has no value, so no limit is enforced.

Data Server

20596: Fixed duplication in connection error messages

A bug has been fixed which caused duplication of log messages when a client lost its connection to a data server.

Data Sources

18403: Fixed cache bug with maxNumberOfCurrentRows and blank timestampColumnName

The cache data source no longer throws a NullPointerException if a cache has maxNumberOfCurrentRows > 0 and a blank timestampColumnName.

19563: -sqltryodbc:false is now the default RTView behavior

By default, the SQL data source will no longer attempt to make an ODBC connection to XYZ if an sql query or command is executed that references a database XYZ but there is no definition of XYZ in OPTIONS.ini. Instead the following error message will appear in the console: Undefined SQL database XYZ To force the SQL data source to attempt an ODBC connection when an undefined database is referenced as in prior releases, specify the following command-line options: -sqltryodbc:true The option can also be specified in OPTIONS.ini: sqltryodbc true or in a properties file: sl.rtview.sql.sqltryodbc=true Note that RTView will still make an ODBC connection to database XYZ if it appears in OPTIONS.ini with the odbc driver specified, regardless of the -sqltrodbc option. However, note that the ODBC driver is not supported in Java 1.8 or newer. If an ODBC connection is attempted in java 1.8 or newer, the following error messages will appear in the console: ClassNotFoundException: sun.jdbc.odbc.JdbcOdbcDriver (ODBC driver is not available in Java 1.8 or newer) Unable to connect to database <XYZ>: No suitable driver found for jdbc:odbc:XYZ

19928: ODBC option removed from Builder and Historian GUI

The checkbox labeled "Use ODBC Driver" has been removed from the SQL Add Database dialog in the Builder and also from the Database Options panel of the Historian UI. This change was made because the JdbcOdbc driver is no longer supported by Oracle beginning in Java 1.8 and in earlier releases it was not intended for production use. If an existing OPTIONS.ini or HISTORY.ini file contains a database connection that was saved with the "Use ODBC Driver" box checked, those connections will still work in this release if run with java < 1.8. In the new UI, such entries will now show: JDBC Driver Class Name : sun.jdbc.odbc.JdbcOdbcDriver JDBC Database URL : jdbc:odbc:<dbname> ... rather than showing the checked "Use ODBC Driver" box. But, if run with java 1.8 or newer, the following error will appear in the console for each database that is configured to use ODBC: ClassNotFoundException: sun.jdbc.odbc.JdbcOdbcDriver (ODBC driver is not available in Java 1.8 or newer)

20100: Cache extend-by-sql query now ignores row filters with value=*

A bug has been fixed in the cache data source which affected cache data attachments using the Extend with SQL option and which also use a row filter with multiple columns or multiple values, where * is used as one or more filter values. In those cases, the "where" clause in the SQL query generated by the cache data source was incorrect and returned no rows. This is fixed.

20191: Prevent data with timestamp < historyTimeSpan from going to history

In prior releases, a row with a timestamp older than a cache's historyTimeSpan could be added to the cache's history table and would not be removed until the next update. In this release this has been fixed so that such a row is not added to the history table in the first place.

20692: Fixed bogus timeout of sql query

A problem has been fixed in the SQL datasource which would sometimes cause a query to fail with a bogus timeout error showing a very large and incorrect timeout value.

20767: xml parser no longer throws exception if token >= 8192 chars

In previous releases, the JMS and XML data sources would throw an ArrayIndexOutOfBoundsException if an XML string token contained 8192 or more characters and none of those characters was a space. This is fixed.

Display Server

18024: Fixed ArrayIndexOutOfBounds on Grid containing more than 1 icon type

In prior releases, the display server threw an ArrayIndexOutOfBounds exception if a display was opened containing an object grid configured with more than one icon per item, and the display was not rendered in the thin client. This is fixed.

19512: Support audio and threshold command in thin client

The thin client now supports the Play Audio File command and threshold commands. In addition, a new property named valueCommandResetTrigger has been added to the display objects that support threshold commands. ------------------- Play Audio File command: The thin client now supports the Play Audio File command. The support for audio file formats varies by platform, as follows. - The Play Audio File command is not supported in Internet Explorer version 8 and older. - In a desktop browser (Internet Explorer 9 or newer, Firefox, Chrome) .wav and .mp3 files are supported. However, Internet Explorer uses the Windows Media Player to play .wav files, which may require user confirmation or may fail due to security settings. - In mobile browsers (e.g. Safari on iOS) only .mp3 files are supported, and the user must click on the "Enable Audio" button that appears in a display the first time an audio command is executed. - The "Beep" command is still not supported in the thin client. Note that in the builder/viewer, only .wav files are supported by the Play Audio File command. This has always been the case and has not changed in this release. --------------------- Threshold command: There are four objects that support threshold commands: obj_circ2d_ilvx_ra4, obj_rect_ilvx_ra4, obj_circ2d_ilvx_da3, and obj_rect_ilvx_da3. A threshold command can be defined using any of the properties named value*Command on those objects. In this release, if the webChartFlag property is checked on an object with a threshold command, the threshold command will be executed in a thin client deployment when appropriate. In prior releases, threshold commands were ignored in a thin client deployment. If the threshold command is a supported client-side command it will be executed in the browser. The client-side commands are: Play Audio File, Drilldown/Set substitution, Execute Custom Command (if the custom command has a javascript implementation), Open Browser. All other commands are executed by the display server or (for a data source command) in the data server. A new property named valueCommandResetTrigger was added to the objects that support threshold commands. Typically, once a threshold command has been executed by one of those objects because the value exceeds or equals a limit, the command will not execute again until the value exceeds another limit. But now, if the value of valueCommandResetTrigger property is changed, then the object's threshold command will be executed again even if the value property has not changed. Changing the value of valueCommandResetTrigger when the object's value is not at or above a limit has no effect.

19813: Fixed javascript error thrown by obj_datechooser in IE

A bug in the thin client has been fixed which caused an "unterminated string constant" error message to appear in Internet Explorer's javascript console when the date chooser control was clicked.

19880: Fixed unstable dropdown list in FF & Chrome

In prior versions of the thin client, on each display refresh the dropdown list of the combo box control would scroll and the highlighted list item would change, even if the refresh did not change the items in the list. This behavior could make it difficult to use the dropdown list. This problem has been fixed. Note that this problem affected the thin client in Firefox and Chrome, but not Internet Explorer.

20021: Images now found when rtv file loaded from subdirectory

In prior releases, the thin client would fail to load images for some objects if the images and the display containing the objects were in a subdirectory of the display server's working directory. This is fixed.

20097: “loading …” label no longer remains after loading finished

A problem has been fixed in the thin client that would sometimes cause the "loading..." message to remain on the display after the display had finished loading.

20237: Touchscreen PCs no longer display thin client in tablet mode

In prior releases, if the thin client was opened in a browser on a PC with a touchscreen, items would be missing from in the right-click context menu. The missing items includied the Drill Down, Execute Command, and Export Table to Excel items, plus any custom menu items. This is fixed.

20582: Enable mouse cursor to change appearance when hovering over composites

If a composite object has its drilldownTarget set, then in the thin client the "hand" cursor will appear when the mouse is over the composite. This is consistent with the behavior of other objects that have a drilldownTarget.

20621: Fixed: obj_rect_il may not draw in comp grid if webLabelFlag=1

A bug in the thin client has been fixed that sometimes caused objects with the webLabelFlag property checked to not to be drawn if the objects were in a composite display inside an object grid instance.

20623: Table no longer fails to populate when cellsperpage is smaller than visible cells

A bug in the display server has been fixed which sometimes caused table cells in the thin client to always contain "..." if the cellsperpage property was set. Typically this occurred if the cellsperpage value was small (in the range of 1000 to 2000) and a table with many columns was opened. It was unlikely to occur with a typical cellsperpage value of 10000 or more. The problem is fixed for all cellsperpage values. As before, a value less than 1000 is ignored.

20679: Table row selection in AW grid no longer unreliable in IE >= 10

In previous releases, when using the thin client in IE 10 and 11, after performing a drilldown from a table object subsequent row clicks in the same table may be ignored. This is fixed.

General

20017: rtvquery servlet now uses "UTF-8" instead of "UTF8"

The rtvquery servlet will now specify UTF-8 character encoding for all responses. Previously, the servlet specified UTF8 which was not recognized by Internet Explorer versions 9 and older and caused an exception with the message "Could not complete the operation due to error c00ce56e"

20326: New -version flag that prints version information without starting the app

Each of the RTView applications now supports a -version option on the command line which will cause the app to print the RTView version information and then exit immediately. For example: run_dataserver -version

Logging

19543: Alert notification script output error when using log4j

Alert notifications from an RTView now go to a log4j output as desired.

Object Library

19796: Table Rows containing larger images no longer clip

A problem in the display server has been fixed which could cause the heights of table rows containing images to be too small to display the entire image. This problem only occurred if multiple instances of the rtvdisplay servlet were connected to the same display server instance.

19936: Added support for data quality to obj_statushistory

The status history chart (obj_statushistory) has been enhanced to indicate data quality. Two new properties have been added, named valueQualityColumnName and valueQualityBadValuesList. These properties can be used to set a color and pattern to be plotted when on a bar when the data quality is bad. The valueQualityColumnName property can be set to the name of the table column that contains a value indicating the data quality for each row. The column can contain string, integer, or boolean values. The valueQualityBadValuesList property can be set to a string containing value,label pairs with each pair separated by semicolons. This is used to assign a label to a numeric bad quality value, for example "-1,no data;0,stale data" The default value for valueQualityColumnName is blank, which means that the new feature is disabled. In this mode the color and pattern for each bar is determined by getting the value for that row from the column specified by valueColumnName, and looking up that value in the chart's barProperties. (This is the behavior in all prior releases). If valueQualityColumnName non-blank, then for each row R the row's value to be plotted is determined as follows: - let Q = value of quality column for row R, and V = value of value column for row R - if Q is blank, then the quality is considered good and V is used at the row value, as normal. - else if the valueQualityBadValuesList property is blank, then Q is used as the row value. - else if valueQualityBadValuesList contains an entry "Q,X" then X is used as the row value - else the quality is considered good (since no match was found in valueQualityBadValuesList) and V is used at the row value Then the row value is looked up in barProperties, as usual, to determine the color and fill pattern. That value is also shown in the mouseover text as usual. For example, consider the following data table: Plant Status Quality ----- ------ ------- A online 1 B offline 1 C online -1 D offline 0 ... where 1 = data OK, -1 = no data, and 0 = stale data. Next, consider a status history chart with these properties: indexColumnNames = Plant valueColumnName = Status valueQualityColumnName = Quality valueQualityBadValuesList = -1,no Data;0,stale data barProperties = online : green offline : blue no data : red stale data : orange Note that valueQualityBadValuesList has no entry for quality = 1, because that is the "good" quality value. With that configuration, when the data table shown above is applied to the chart, it will plot a segment for each Plant as follows: A green (since Status = online and Quality = 1 / OK) B blue (since Status = online and Quality = 1 / OK) C red (since Quality = -1 / no data) D orange (since Quality = 0 / stale data)

20142: Fixed minor usability problems with tree/accordion control

The following minor problems with the tree and accordion control object are fixed: 1 The initialExpandDepth property is now only applied to new branches. Previously, on a tree control with valueTableType = Row-node the initialExpandDepth was improperly reapplied on each update to the tree, reopening any existing branches that the user may have closed. 2. In the thin client, the labels on accordion buttons are now aligned properly: Parent (non-leaf) node labels are left aligned, and leaf node labels are center aligned. This is consistent with the accordion in the builder/viewer. Previously, parent node labels were center aligned in the thin client, which was incorrect. 3. On a tree control In the thin client, a click on the +/- icon now opens/closes the tree branch as expected but it no longer selects the node or triggers the tree control's command. This is now consistent with the tree control behavior in the viewer. 4. On an accordion control In the thin client in most browsers, a click on a left/down arrow icon now opens/closes the branch as expected but it no longer activates the accordion button or triggers the accordion control's command. However, in IE version 8 or older, and in the viewer, the accordion button is still activated and the control's command is executed.

20638: New property to limit text entered into text area control

The text area control (obj_c1textarea) has been enhanced to enforce an optional maximum character limit. (The text field control, obj_c1textedit, has supported this feature for several releases). maxCharacters - The maximum number of characters that will be submitted to the control's actionCommand. The default value is blank (no limit). The limit does not restrict the length of the text in the control, instead the limit is checked before the command is executed and if the limit is exceeded, the command is not executed. inputValidVarToSet - Attach to a local variable. This variable will be updated with a value of 1 if the maxCharacters limit is blank or the text is less than or equal to the maxCharacters limit, or updated with a value of 0 if the text length exceeds the maxCharacters limit. invalidInputMsgVarToSet - Attach to a local variable. This variable will be updated with an error message if the text length exceeds the maxCharacters limit, or updated with an empty string if the text length is less than or equal to the maxCharacters limit.

Platform Support

19592: Support Chrome as a browser for the thin client

The thin client is now supported in Chrome, on Windows. The version tested was Chrome 35.0. Chrome was not tested on iOS or Android.

19925: Support Java 1.8

Java 1.8 is now officially supported. NOTES: As noted in the release notes for 19927 and 19928, the JdbcOdbc driver is no longer supported by Oracle beginning in Java 1.8. Version v4.14.137 of IBM DB2's db2jcc.jar driver is required to work with Java 1.8

Security

20794: Fixed XSS Security Issue in Thin Client Deployment

A cross-site scripting (XSS) vulnerability in the thin client has been fixed.

Scripts

19952: Solaris 10 Script change not always executed

On Solaris 10 systems the rtvapm_init.sh script modifies other scripts in common/bin to use the bash shell. Under certain conditions this operation was not executed. This has been fixed.

Version 6.2.0 Release Notes

Alerts

18863: Notify when the hit Percentage drops below a percentage

A new alert - OcCacheHitPercentageLow- has been added. This alert will trigger when the current Hit % (total current hits/total current gets) drops below the specified threshold for a sampling period and the specified cache(s). This alert has a service/cache override.


18864: New alert for average read Millis

A new alert - OcStoreReadMillisHigh - has been added. This alert will trigger when the current average read millis (total current StoreReadMillis/total current StoreReads) drops below the specified threshold for a sampling period and the specified cache(s). This alert has a service/cache override.


Cache

18866: Time Range Comparison Cache

A new display has been added that allows for analysis of cache data between two sets of time ranges.


Cluster

18790: Cluster Selection display user experience improvements

The Oracle Coherence Cluster Selection display has been enhanced to provide a more intuitive default sort order for each table.

18797: Readability enhancements to Cluster Views / Overview display

To provide a less cluttered appearance, some data fields on the Cluster Overview display have been re-positioned.

Data Historian

18736: Sybase support for OCM history tables

Two support issues for Sybase have been addressed: 1) When auto-creating a database table for Sybase, the Historian will now declare a column of type SMALLINT rather than BIT for a boolean column in a cache table. This is necessary because Sybase does not allow a BIT column to be used in an index, and some EM caches use boolean columns as index columns. This change has also been made to the database schema file for Sybase found under rtvapm\ocmon\dbconfig. 2) The following error that was seen with some Sybase drivers should be fixed: WARNING: unrecognized database product name "sql server". A lost connection to __RTVHISTORY will be undetected.


19180: All trends now show 7 days of data

All trend graphs have been enhanced to allow the display of up to 7 days of data.


Node

18865: GC Duty Cycle in Node History Heatmap

A new display has been added to show the GC Duty Cycle for all the nodes in a cluster. The display can be accessed from the existing All Nodes History Heatmap, from a newly added "GC Metrics" button.


19449: All Nodes Heatmap now shows departed nodes correctly

In prior versions, under certain circumstances, various All Nodes Heatmaps showed departed nodes incorrectly. This is no longer the case.


19555: Log Scale fixed for the All Nodes History Heatmap

The Log Scale functionality of the All Nodes History heatmap has been restored. A bug in the previous version left the Log Scale setting ineffective. Also, resizing of this display will now result in both heatmaps equally sharing the available display space.


RTView Classic

Data Historian

16720: Table creation for Sybase now declares NULL for non-index columns

Two problems in the Historian have been fixed related to Sybase: 1) The following exception was sometimes thrown when the historian was storing or compacting data: SQLException: The column <abc> in table <xyz> does not allow null values. 2) The following exception was sometimes thrown when the historian was compacting data: SybSQLException: The 'CREATE TABLE' command is not allowed within a multi-statement transaction in the <xyz> database. Both problems are fixed.


19312: Sybase integer conversion error fixed

A problem has been fixed that caused the Historian to throw an exception when compaction of an integer column by averaging produced a floating point result, when used with Sybase. The exception was reported as "Scale error during implicit conversion of NUMERIC value". This has been fixed by setting "arithabort numeric_truncation off" in the active session between the Historian and the Sybase database.


Data Server

19477: Data Server NPE when DS is busy and pushing data to a disconnecting client

A problem has been fixed that in rare circumstances caused the data server to throw a NullPointerException and become unresponsive after a client disconnected.


Data Sources

18738: Data type handling improvements for Extend by SQL option

Three problems affecting the Extend By SQL option in cache data source attachments have been fixed. The first problem caused the following SQL error in some conditions when a cache attachment was configured with the Extend By SQL option and a filter on a string column, and the database in use was Sybase: "Implicit conversion from datatype 'VARCHAR' to 'INT' is not allowed. Use the CONVERT function to run this query." The second problem caused SQL errors when a cache attachment was configured with the Extend By SQL option and a filter on a Boolean column, and the database in use was Sybase, Oracle, DB2, or MySQL. The third problem caused the Extend By SQL query result to use integer columns for columns that were Boolean in the cache, if the database was Oracle or DB2. All three problems are fixed.


19204: Improved support for mbeans that serialize (Tabular/Composite)DataSupport

The JMX adapter was updated to handle mbeans that serialize TabularDataSupport and CompositeDataSupport objects, as used in some Tibco BusinessEvent mbeans. The previous adapter would return a text blob for BE methods that returned these types. Now, these objects are properly deserialized into an RTView table.


Object Library

19504: listbox selection no longer clears when list changes

A problem has been fixed in the viewer which caused the selected item in a list box control (obj_c1tlb) to be deselected when the control's listValues property was updated.


19511: Listbox validation bug fixed

A problem in the listbox control (obj_c1tlb) has been fixed which caused it to ignore changes to the listValues property in some cases.


Version 6.1.0 Release Notes

18476: New Columns added to the OcNodeStats Cache and Database Table

New columns that reflect the state of TCMP traffic on a per node basis have been added to the the OcNodeStats Cache and persisted to the corresponding Database Table (OCM_NODESTATS) to enable historical analysis. The Columns contain Delta and Rate information obtained from the raw (incrementing) count value. The new columns are DeltaNackSent, DeltaPacketsResentEarly, DeltaPacketsResentExcess, RateNackSent, RatePacketsResentEarly, RatePacketsResentExcess.

18490: Departed Nodes now correctly displayed

The Departed Nodes indicator on the Cluster Overview display, and the Departed Nodes table on the Cluster Stability Metrics display, were inaccurate in their reporting of departed nodes. This has now been fixed, and required a change to the ocmRowExpirationTimeForDelete property in the rtview.properties file. This property is now set to 86400, which allows the OCMonitor to wait 24 hours before removing records of expired nodes.

Alerts

18297: New alert CacheQueueSize

The alert OcCacheQueueSizeHigh has been added to trigger when the CacheQueueSize for ALL nodes exceeds a threshold.

18298: New alert OcSendQueueSize

The OcSendQueueSize alert has been added to inform the user when a Send Queue exceeds a given threshold.

18407: Support new EM alert notifier

Alert notifications in OC Monitor have been enhanced to support easier integration with EM. In order to support this, the previously supported notifications properties are no longer being used. See the upgrade notes section below if you have modified or overridden the values for any of the notification properties. The following properties are defined in rtvapm.properties for notifications: sl.rtview.alert.notifierenabled - Set to true to enable alert notifications. This defaults to true. To disable alert notifications, set this to false. sl.rtview.alert.notifiercommandnew - Set this to the command to execute when a new alert is generated. This defaults to executing the my_alert_actions.bat. To execute my_alert_actions.sh, set the following: sl.rtview.cmd_line=-sub:$scriptEnding:sh. To execute a different script with the same arguments, set the following (where my_script is the name of your script): sl.rtview.cmd_line=-sub:$alertActionScript:my_script sl.rtview.alert.notifiercommandsevincrease - Set this to the command to execute the first time an alert changes severity. The default for this is the same as the sl.rtview.alert.notifiercommandnew. sl.rtview.alert.notifiercommandcleared - Set this to the command to execute the when an alert is cleared. By default, no command is configured. To execute a script, copy the notifiercommandnew line and replace $alertActionScript with the name of the script you want to execute. To execute a custom java command, see the example in common\conf\custom_handlers.properties. sl.rtview.alert.notifiercommandchanged - Set this to the command to execute when a column in the alert table changes. To execute a script, copy the notifiercommandnew line and replace $alertActionScript with the name of the script you want to execute. To execute a custom java command, see the example in common\conf\custom_handlers.properties. This must be used in conjunction with the sl.rtview.alert.notifiercolumns property sl.rtview.notifiercolumns - Set this to the name of one or more columns to execute the sl.rtview.alert.notifiercommandchanged notification when they change. For multiple columns, use a semi-colon delimited list. Note that this should be limited to the minimum number of necessary columns, preferably less than 5, as a large number of columns increases the persistence load on the central alert server. You may alternatively execute a custom java command instead of a script for alert notifications. An example of this is provided under RTVAPM_HOME\ocmon\sample\custom. To use the sample custom code, you must build it and add the custom package and jar to your application: 1. Run RTVAPM_HOME\ocmon\sample\custom\make_classes.bat. This will build the custom handlers and output them in RTVAPM_HOME\ocmon\sample\custom\lib\rtvapm_custom.jar. 2. Modify common\conf\custom_handlers.properties to uncomment the sl.rtview.alert.notifiercommandnew line. Also, modify the sl.rtview.cp line to %RTVAPM_HOME%/ocmon/sample/custom/lib/rtvapm_custom.jar. You can optionally uncomment the sl.rtview.alert.notifiercommandsevincrease, sl.rtview.alert.notifiercommandcleared, sl.rtview.alert.notifiercommandchanged and sl.rtview.alert.notifiercolumns lines if you want those additional notifications to execute your custom java command notification. 3. When you run the data server, add the following to the command line: -properties:%RTVAPM_HOME%/common/conf/custom_handlers Upgrade Information The following properties from rtvapm\common\conf\rtvapm.properties have been removed or replaced. If you have modified any of these properties in rtvapm\common\conf\rtvapm.properties or overridden them in your properties file, you will need to make the following modifications. sl.rtview.alert.alertcommand - use sl.rtview.notifiercommandnew instead. Also set the same value on the sl.rtview.notifiercommandfirstsevchange property if you want to receive a notification the first time the severity changes on an alert. If you do not want to receive notifications the first time the severity changes on an alert, set sl.rtview.notifiercommandfirstsevchange to a blank value. sl.rtview.alert.renotificationmode - This property is no longer supported. sl.rtview.alert.renotifyonsevchangedmode - This property is no longer supported. This property previously defaulted to 1. If you set it to 0, set the sl.rtview.notifiercommandfirstsevchange to a blank value. If you set it to 1, set the sl.rtview.alert.notifiercommandchanged to the same value as sl.rtview.notifiercommandnew and set the sl.rtview.alert.notifiercolumns property to Severity. With this configuration, you will get a notification each time the Severity changes. If you only want to act on increases, add logic to support this to your script or custom command code. sl.rtview.alert.renotficationcommand - This property is no longer supported. sl.rtview.alert.commentcommand - This property is no longer supported. To receive notifications when the comment changes, set the sl.rtview.alert.notifiercommandchanged to the value you previously used for the commentcommand property. Set the sl.rtview.alert.notifiercolumns property to Comments. sl.rtview.alert.alertclearedcommand - This property is no longer supported. Use the sl.rtview.alert.notifiercommandcleared property instead.

18492: New alerts for Cache status

Two new alerts, OcEndangeredCache and OcNodeSafeCache, have been added: OcEndangeredCache For each node in the cluster, an alert is executed if the StatusHA value is ENDANGERED. By default the alert is disabled. OcNodeSafeCacheTwo For each node in the cluster, an alert is executed if the StatusHA value is NODE-SAFE. By default the alert is disabled.

18541: New alerts on the number of nodes falling below a threshold

Three new alerts have been added to trigger when node counts dip below their respective thresholds: OcLowTotalNodeCount, OcLowStorageNodeCount, OcLowClientNodeCount. The three alerts are disabled by default.

Data Historian

18322: New variable to set how much historical data to load on startup

The new substitution variable $ocmHistoryTimeSpan has been added to rtview.properties to allow the user to set the number of days of history data that is loaded at startup. The value to be set is based in seconds with the default being 1296000 (15 days).

Data Model

18475: Add Nacks to History and the Node History Heatmap.

To aid in troubleshooting communication errors, the data points "Delta Nacks Sent" and "Rates Nacks Sent" have been added to the Node History heatmap display. Both appear in the Metric drop-down list, and both have been added to the tooltips for both heatmaps (Process and Storage Nodes) on that display.

General

17946: Single Service Summary Display now showing all data

The Cache Services > Single Service Summary display now correctly displays historical data.

18434: Expiration now indicated for Nodes, Caches and Services

Previously, under certain circumstances the All Caches - Current Size Chart display would display incorrect cache totals. This is no longer the case. (Expired Cache nodes are not counted) This has been achieved by implementing Expiry for Nodes, Caches and Services. Expiry affects data elements, UI elements and configuration properties. Expired Data items are represented by the addition of an Expired column in the current table of a cache, where a row in the cache represents the entity in question. For Expired entities Expired will be true. For currently active entities (i.e. non expired) Expired will be false. Expired entities contain the last known data for that entity. Expired entities are indicated in the UI by a dark red color. Expired entities may be shown in aggregates (Tables, Heatmaps) along with non expired entities and individual Expired entities may be displayed on their own displays that represent that entity. Cells in heatmaps that indicate an expired entity will have this dark red color and rows in data tables that represent an expired entity will have a dark red background. Often the last column in the table will be the Expired column, allowing for sorting/grouping of expired and non expired entities Displays that represent an expired entity typically have a drop down selector that selects a particular entity. Expired entities are represented by an appended [X] at the end of the selector dropdown. When an expired entity is selected the display background will be set to dark red to reinforce that this is an expired entity. The display shows the last known values for the entity where available. Typically trend graphs will only show data up the point of expiry of the entity. Expiry currently relies on the absence of previously available data during an update. Some data is required for the update to succeed. Total absence of data means there is no data to update. Expiry behavior is controlled by properties. Previously the user could control time base expiry. Expiry is now event based and must be configured correctly. For new installs the defaults are set correctly and the user need not be concerned. Users migrating from a previous version, or using a properties file from a previous version, need to take care that the following properties are not redefined (so as to take the correct default values) or are explicitly set using the the following values. # Configure to detect expired entities in caches on update, and delete expired entities after a finite time. By Default # Expiry Mode # 3 = Mark + Delete # Mark Expired Entities. Delete Expired Entities. # # Known entities are Nodes, Caches and Cache Services at this point. Consider what Entity a row in a configured cache represents # sl.rtview.sub=$ocmRowExpirationMode:3 # # Detect Expired Entities, by absence, on update, rather than by (implicit assumed) absence after minimum time-out since last updated. # expiration time of -1 means use update mechanism rather than time mechanism. # sl.rtview.sub=$ocmRowExpirationTime:-1 Failure to do so may result in undesired behavior. The user can still control when expired entities are deleted, and thus no longer appear in displays, or are available for selection. By default expired entities are deleted after 24 hours. Users can override this setting if desired: thus # Delete expired entities from caches a finite time after they expire. # Can be used to limit the grown of configured current caches based on the rate of growth/churn # (Creation + Expiry of new entities with unique identifiers) # By default set to 24 hours - ocmRowExpirationTimeForDelete (86400 = 24 hrs) # sl.rtview.sub=$ocmRowExpirationTimeForDelete:86400

18435: 'Delta' columns now format numbers with "," seperator

The Delta Columns in the "Totals For Each Cache over all Storage Nodes" table in the "All Caches - Current Activity Table" display are now formatted with "," thousands separator like the non delta numeric columns. Additional Delta Columns that are now formatted with "," thousands separator like the non delta numeric columns, can be found in the following displays: "Single Cache - Cache Detail Tables" display Bottom Table labeled "Statistics By Node for Selected Cache" "Proxy / Extend Detail" display Bottom Table labeled "Extend Client Connections"

18436: Proxy Service CPU % now displayed correctly

Previously, the Proxy Service CPU % may have been displayed incorrectly in various Proxy Services displays. This is no longer the case.

18537: Alert indicators added to the overview screen.

A set of six alert indicator lights has been added to the Cluster Views / Overview display. The lights indicate the aggregated status for Memory, Network, Stability, Tasks, Data Quality and "Other" alerts. Green signifies no alert, yellow signifies at least one warning, and red signifies at least one alarm level alert. Clicking within this area will display the Alert Detail Table for more specific information on the alerts.

18651: SQL definitions added for optional history tables

Several changes have been made to the history table SQL schemas. 1) SQL table schema definitions have been added for those history tables that are disabled in the default configuration. Those tables are: OCMCACHESERVICESTATS_TABLE OCMINVOCATIONSERVICESTATS_TABLE OCMCACHESTATS_TABLE OCMSTORAGESTATS_TABLE OCMPROXYSERVICESTATS_TABLE OCMPROXYSERVICETOTALS_TABLE OCMEXTENDCONNECTIONS_TABLE OCMJVMGCINFO_TABLE OCMJVMMEMORYPOOL_TABLE OCMJMXMGMTDATA_TABLE Definitions have also been added for two legacy tables. These tables do not store historical data, but errors may be thrown to the console if they are not found. HISTORY HISTORY_S 2) The max length for VARCHAR columns has been increased across all history tables to 255. Users should not need to modify existing tables.

RTView Classic

Data Sources

18670: Gaps in extend-by-sql cache data attachment fixed

A bug has been fixed that caused time gaps to appear in data supplied a cache attachment configured as follows: Cache : MyCache Table : history, or history_combo Time Range : <any value larger than the time range of data available in the cache table above> Extend with SQL : on Begin Time: <blank> End Time: <blank> Update Once: off (if Table = history) Update : On Condense or Always (if Table = history_combo) A cache attachment with that configuration will periodically update its listeners, as new data is added to the cache history table. In prior releases, a time gap would eventually appear between the most recent data retrieved by the Extend with SQL query and the oldest data in the cache history table. This is fixed.


18707: Enhance rowExpiredIndexColumns behavior in Mark+Delete mode

The row expiration feature of the cache data source has been enhanced to allow the rowExpiredIndexColumns and the rowExpirationTimeForDelete properties to be used in combination. If a cache is configured as follows ... rowExpirationMode = 3 (Mark + Delete) rowExpirationTime = -1 rowExpirationTimeForDelete = any value > 0 rowExpiredIndexColumns = any subset of the cache's index columns ... then if a row X exists in the cache's current table and that row's values in the columns specified by the rowExpiredIndexColumns are not matched in the data table applied to the cache's valueTable property, the row will be marked as Expired. Subsequently, if row X is not updated again before the time specified by the rowExpirationTimeForDelete property has elapsed then row X will be deleted from the cache's current table.

Display Server

18689: Support updates to drillDownColumnSubs on table

The drillDownColumnSubs property of the table object (obj_table02) can be attached to data. However, in previous releases the thin client only read that property when the display was opened and ignored subsequent updates from the data attachment. This has been fixed.

Platform Support

18746: Table index names shortened for Oracle and Sybase

The historian will now keep index names to 30 characters or less on Oracle and Sybase to avoid "identifier is too long" errors from those databases.

Version 6.0.0 Release Notes

Alerts

17248: ObjectCountDelta*Cache now only triggers for back of near-cache

Both the ObjectCountDeltaUpCache and ObjectCountDeltaDownCache alerts have been modified to ensure that no alerts are generated due to object count changes in the front of the near cache. Alerts will only reflect activity in the back portion of a near cache.

17988: Integrate OCM alerts into the EM framework

The existing set of OCM alerts has been updated to work within the new EM framework.


18182: Support global alert notification definitions

The alert notification functionality has been enhanced. The changes include: - The alert command is my_alert_script.bat. - The alert command executes for new alerts and on the first severity change. Alert notification is now setup through property files, rather than by editing .rtv files. - To use my_alert_actions.bat, copy it from common\bin to your project directory and modify the end of the script to do the appropriate action. - To use my_alert_actions.sh, copy it from common\bin to your project directory and modify the end of the script to do the appropriate action. Also, add this to your properties file: sl.rtview.cmd_line=-sub:$scriptEnding:sh - To use a different script, add it your project directory and add the following to your properties file: sl.rtview.cmd_line=-sub:$alertActionScript:my_custom_script where "my_custom_script" is the name of your script. If it does not use the .bat extension, also add the following to your properties file: sl.rtview.cmd_line=-sub:$scriptEnding:XX where "XX" is the extension for your script. - To use a different command, add the following property to your properties file: sl.rtview.alertCommand=XX where XX is the command to execute. This can be any RTView command string. See the documentation for the alertCommand property on any of the alerts for more information on this. There are also several properties that can now be set: sl.rtview.alert.renotificationmode sl.rtview.alert.renotificationtime sl.rtview.alert.renotifyonsevchangedmode sl.rtview.alert.renotficationcommand sl.rtview.alert.commentcommand sl.rtview.alert.alertclearedcommand Further information can be found in the alert documentation.


18219: Alert when JMX connections drop

The alert OcNoJmxConnection has been added which will execute after sensing that JMX connection has been disconnected for a set amount of time. By default the alert is set to ON and the default time value is 60 seconds..


18220: OCM Processing Time Alert.

A new alert - OcJmxProcessingTime - will trigger when the sum of the data collection tIme (sum of the JMX Queries) and the data processing Time (sum of all the functions) is greater than the JMX Period * the threshold. The threshold defaults are 80% for warning, 90% alarm. The alert duration default is 0 and the alert is disabled by default.


18221: StoreFailures alert.

An OcStoreFailure alert has been added which can trigger when the DeltaStoreFailures on the CacheTotals Stats exceeds a specified threshold.


18222: Alert - Minimum Node Memory after GC Alert

The alert OcMemoryUsedPercentageAfterGC has been added which will trigger on low memory conditions that might occur in a node after garbage collection. The alert is disabled by default.


18254: Custom handler and custom alert command added to sample project

OC Monitor has been enhanced with an optional custom package that lets you define custom functions and commands. The custom package code is in %RTVAPM_HOME%\ocmon\projects\sample\custom\src\com\sl\rtvapm\custom. To build the custom package classes, run %RTVAPM_HOME%\ocmon\projects\sample\custom\src\make_classes.bat. This will build the classes and output them in %RTVAPM_HOME%\ocmon\projects\sample\custom\lib\rtvapm_custom.jar. You may modify the custom function handler, RtvApmFunctionHandler.java, to implement custom functions for use in custom displays. The custom function handler api is described in the RTView Classic documentation under Customization->Custom Functions and Customization->Customization API. You may modify the custom command handler, RtvApmCommandHandler.java, to implement custom commands for use in custom displays or as alert notification commands. The custom command handler api is described in the RTView Classic documentation under Customization->Custom Commands and Customization->Customization API. To enable these classes, include %RTVAPM_HOME%\common\conf\custom_handlers.properties in your command line: -properties:%RTVAPM_HOME%/common/conf/custom_handlers The RtvApmCommandHandler class contains a sample alert notification command named my_alert_command. You can use this example as a starting place to implement your own custom alert notification command. To use the my_alert_command custom command for alert notifications, uncomment the sl.rtview.alert.alertcommand line in %RTVAPM_HOME%\common\conf\custom_handlers.properties.


Cache

17969: Provide new metrics in the All Caches History display

Five new metrics have been added to the All Caches History Heatmap display. These are: StoreFailures (Delta) StoreReads (Delta) StoreReadMillis (Delta) StoreWrites (Delta) StoreWritesMillis (Delta)


18051: All Caches current size display obscures conn OK light

An indicator light was obscured by a button on the Current Size display. The button has been moved so that the indicator light is now visible.

18165: Cache Summary - Add Delta/Rate Selection

Delta/Rate Selection added to the "Single Cache - Summary" Display A new "Use Rates" Checkbox has been added to the "Single Cache - Summary" display that allows the user to select either Delta values or Rate Values to be used in the display for Trend Graphs and "Activity - Current" Values. Delta/Rate Selection added to the "Single Service - Summary" Display A new "Use Rates" Checkbox has been added to the "Single Service - Summary" display that allows the user to select either Delta values or Rate Values to be used in the display for Requests And Messages Trend Graphs and "Current" Value displays.


Configuration

18416: Update database schemas

The database schema files have been updated, and are now under rtvapm\ocmon\dbconfig.


Development and Build

18014: Integrate OCM custom functions into RTView EM

OCM custom functions are available in EM CSP ocmon. The OCM custom functions are available in the EM CSP ocm by use of the package ocmon and the jar file rtvapm_ocmon.jar

General

17931: Supress unwanted error messages in dataserver logs

Spurious ERROR message no longer occurs Previously, under certain circumstances the proxyServiceConnectionManagerData3_RTDelta function would generate ERROR messages regarding invalid columns. This is no longer the case.

18201: Rename cache names to be consistent with EM naming conventions

All Cache names have changed and been given an OC prefix.

18238: Create a Proxy Node History heatmap.

A History Heatmap has been added that displays the sent and received statistics for each of the Proxy nodes. It can be navigated to via Proxy Services / Proxy Nodes History


Node

17968: Provide new metrics for the All Node History heatmap

Two new metrics have been added to the All Nodes History Heatmap display. These are: DeltaPacketsSent and DeltaPacketsReceived.


Proxy / Extend

17399: History Heatmap for Extend Connections

A History Heatmap has been added that allows for the selection of a proxy node and exposes the Extend Client information. It can be navigated to via Proxy Services / Extend Connections History


Version 5.9.1 Release Notes

Alerts

17880: EndangeredAllCaches alert now triggers correctly

Previously under certain circumstances the EndangeredAllCaches alert would trigger incorrectly. This is no longer the case

17906: Tabular Alerts regression fixed

Tabular alerts now work as intended.

Cache

17900: All Caches - Activity Heatmap can now show Units or Objects

The All Caches - Activity Heatmap now has a "Use Objects instead of Units" check box, allowing for use of either Units or Objects for the heatmap cell sizing, and mouse over tool-tips


Cluster

17862: Large object totals for cache services now displayed correctly

Previously Large object totals for cache services may not have displayed correctly in the Cluster Overview Display. This is no longer the case.

General

17851: Connection status now displays correctly

Previously, under some circumstances the connection status may not have displayed the correct connection status. This is no longer the case.

Scripts

17849: Historian no longer issues an alert persistence error

The Historian is no longer used for alert persistence. Alert persistence settings have been removed from the Historian script files.

17850: topocm.sh script now stops the OCM Agent when appropriate

Previously the stopocm.sh script tried to stop the OCM agent when it was not in use. This is no longer the case

Version 5.9.0 Release Notes

Alerts

16667: Duration increased in HSQLDB alertdefs.script

Duration changed from 0 to 60 for BadCommunicationCluster and BadCommunicationNode alert definitions in database alertdefs files Previously the initial value of Duration for the BadCommunicationCluster and BadCommunicationNode alert definitions was 0. The value of duration has been increased to 60 seconds, so that the alert condition will have to persists for a minute before the alert is triggered

16806: -dbretry:30000 added to script defaults for database retry

The dbretry command line option is now automatically set to 30000 milliseconds when the ocm_setup scripts (Win and Unix) are executed.

16837: Alert Comments now saved

The Manage Alert Detail dialog now persists time and date-stamped comments.

17492: Updates to the Manage Alert dialog

The Manage Alerts dialog is now resizable. Additionally, an field for displaying the index column has been added to aid in identifying the source of the alert.

17495: Implemented alert persistence

The OCM the alert persistence mechanism is now on by default and allows the alert state to be maintained when the data server is restarted.

17789: Unix/Linux alert notification fixed

Unix/Linux alert scripts are now called with an explicit ./ to ensure they are found in the current directory without assuming that ".", the current directory, is in the current shell execution path.

Cluster

17535: Multi-cluster support

Support has been added for allowing multiple clusters to be monitored with one instance of the OCM. The Multi-Cluster Configuration is suitable for monitoring many small clusters with a single OCM instance. Multiple clusters must be monitored using the JMX connection method of data access. See documentation for configuration information under Configuring a Data Connection->Configuring a JMX Connection.


Configuration

16810: Add dataserver_url Examples to OCM Property Files

The property files in the conf directory now contain examples of the usage of the dataserver_url property.

17758: Corrected bad database table name in OPTIONS.ini

The commented out $OCMCACHESERVICESTATS_TABLE substitution has been corrected to: #sub $OCMCACHESERVICESTATS_TABLE:OCM_CACHESERVICESTATS to provide a consistent definition if un-commented.

Customization

17432: REST based interface for OCM data servers added

The rtvquery servlet has been added to OCM. The rtvquery servlet allows your custom client application to retrieve data from the Data Server via a REST interface. Additionally, in order to provide details about OCM caches in the cluster that persist data to the database, a new set of auto-generated documentation has been under ocmdocs\cachedocs. This documentation describes settings for the cache such as persisted columns, default table sizes and compaction rules. For more information see the documentation under Additional Configurations -> Custom Web App Queries


Data Historian

Compaction

17616: Historian compaction rules now configurable

Options have been provided for altering the way the OCM historian does data compaction when managing data in the historical database. Decreasing compaction rates will result in larger database tables. See the Cache substitutions section of the documentation for details on setting the $ocmCompactionRules substitution.

Data Model

17053: Rework and Cleanup of Cache Definitions

Schemas and table names have been changed for persisted historical data. Alert information is not affected but all other persisted data is affected. Upgrading users will have to create new schema definitions to store historical information. See the database configuration section of the documentation for details.

17613: maxNumberOfHistoryRows now externally configurable

For resource optimizations, it is now possible to configure the amount of data that OCM is storing in internal caches. See the documentation under Cache substitutions for the use of ocmMaxNumberOfHistoryRowsSmall, ocmMaxNumberOfHistoryRowsMedium, and ocmMaxNumberOfHistoryRowsLarge,

17615: Condense rules now more easily configured

Substitutions have been provided for changing the way OCM does data compaction. This allows for users to determine the granularity of the raw and compacted data. Reducing compaction results in larger resource usage. See the Cache substitutions section of the documentation for the details on setting these substitutions: ocmMaxNumberOfHistoryRowsSmall, ocmMaxNumberOfHistoryRowsMedium, ocmMaxNumberOfHistoryRowsLarge, ocmCondenseRowsRawDataTimeSpan, ocmCondenseRowsInterval, ocmCompactionRules,

Deployment

17638: Support for JMX tables for data retrieval on Coherence 3.7.1

The JMX tables option for supporting optimized JMX data retrieval now supports Coherence version 3.7.1. This enhancement is backward compatible and will still support Coherence 3.5.x, 3.6.x and 3.7.x


General

16894: RackName now appearing in Group By drop down

The RackName now appears in the Group By drop down in Single Cache->Node/Group Distribution.

17045: Ability to select longer time range in trend charts

Trend charts have been enhanced so that not only can you view data currently being held in the in-memory caches, but you can change the time periods so that you can view all metrics which have been stored in the historical database.

17306: Implemented proper resize behavior

The OC Monitor is now fully resizable. Where applicable, key display items will expand for greater readability as the application grows in size.

17627: User interface changes

The following UI changes have been made: 1) There is a new multi-cluster drop-down at the top left of each display. 2) The "open in new window" button is now at the top right of each dsplay (to the immediate left of the Help (?) button). 3) The Administration / SL Administration display now appears and resizes correctly.

17671: About screen added

An About display has been added to the OC Monitor. It displays product and version information, and shows a list of all available data sources. The About display is reachable from the Administration node on the navigation tree.

17782: Graphs traces corrected in Single Node Summary

Under certain circumstances the Single Node Summary traces would not display aligned data. This is no longer the case.


JMX Data Access

17464: jmx_mbeans_change_dynamically set to false by default

A change was made to JMXOPTIONS.ini to override a default setting for the JMX Data Source. To minimize the number of JMX metadata queries, the option jmx_mbeans_change_dynamically has been set to false.

JVM metrics

16605: JVM GC trends now plot correctly on all platforms

Previously in certain circumstances, the JVM GC trends for a single node may have show no data, when GCInfo data was available. This no longer the case, and the trends are plotted correctly for available data.

16843: Loading status label added to Single Node Summary

On initial launch of the OC Monitor, Thread and Class Loader data require 3 update passes before their data is displayed. A label has been added to the Single Node Summary display that explains the delay. The label will not appear once the data is ready for display.

Node

16607: Node labels corrected

The All Nodes -> Memory Usage and All Nodes -> Packet Communication Trends displays will no longer show incorrect trace label names.

17370: Indication of expired nodes is now configurable

Indication of expired nodes is now an optional feature. See the documentation under Substitutions->Cache Substitutions to determine how to configure the substitutions ocmRowExpirationMode, ocmRowExpirationTime and ocmRowExpirationTimeForDelete to get the desired results.


17610: SendQueueSize attribute added

The Send Queue Size metric has been added to 4 displays: Cluster Views / Memory/Network (at upper right of display) Single Node / Node Summary (in Packet Communication area) Single Node / Node Detail (last column in Node MBean Data table) All Nodes / All Nodes - Detail (last column in MBean Detail Data table)

Proxy / Extend

17797: Removed total KB sent/received traces from extend detail page

KB Sent / Received Totals are no longer displayed in proxy/extend connections trends since these were only increasing totals. The Deltas of the messages + bytes sent and received are still displayed.


Scripts

17087: OCM proxy scripts adjusted to avoid ServerSocket binding errors

The startDemoProxyNodes script was changed to avoid a port conflict error.

17182: Coherence version property and env var removed

Commented examples referencing the "ocm.coherence_version" property were removed from property and script files as these examples are no longer of use.

17368: make_ocmonitor_war.bat no longer fails due to copy error

The make_ocmonitor_war script now correctly builds the ocmonitor.war file.

Service

17796: Active Threads Trend Correctly Displayed and Labeled

Previously, under certain circumstances the Active Threads Trend would not be correctly displayed or labeled in the Single Service Summary Screen. This is no longer the case.

Timing / Performance

17108: Data Server optimisation

Performance enhancements have been included to improve garbage collection handling.

Version 5.8.0 Release Notes

Alerts

16660: _win & _unix alertdefs no longercause setGmsVarFromString errors

Previously, when using ts_alertdefs_win.rtv or ts_alertdefs_unix.rtv as ts_alertdefs.rtv ( for script based alert handling ) in projects/myocm, you might see the following error message displayed at startup: "ERROR: setGmsVarFromString, value passed in for value must be a double." This is no longer the case.

Cache

16791: New service selector for All Caches / Storage Nodes Cache Map

The All Caches / Storage Nodes Cache Map has been enhanced to permit selection of only those nodes running a specific service. Note that "unused" caches, which are caches that aren't identified with any specific service, will always be displayed, regardless of the service filter selection.

16807: New All Caches History heatmap

An "All Caches History" heatmap has been added to the OCM navigation tree. This provides a way to see in one page a short-term history of activity on all the caches running in a cluster.

16808: All Caches Size and Activity Charts now readable w/ many caches

Previously, the All Caches / Current Size Chart and the All Caches / Current Activity Chart displays would become unreadable if there were many caches (> 50). This behavior has been corrected.

Cluster

15630: Show node start times in Stability page, dead nodes in overview

The "departed node" count has been added to the OCM Overview page and the Grid Stability page has been modified to show a table of all nodes and their start times, sorted by the most recently created. This provides a quick way to see which nodes have departed and returned to the cluster recently.

16822: New All Nodes History heatmap

An "All Nodes" History heatmap has been added to the OCM navigation tree. This provides a way to see a short-term history of the activity on all the nodes running in a cluster.

Configuration

16234: Database template configuration files added

A new directory, dbconfig, has been included with the Oracle Coherence Monitor product. The files in this directory can be used to configure the application to use a database other than the demo HSQLDB instance provided with OCM. For more information on how to utilize these files, dbconfig/README.txt has been provided with the files. The default status for all alerts has been configured, in these files and in the HSQLDB database included with projects\myocm, to be disabled by default.

16772: New default coherence properties in conf property files.

The property files in the conf directory have new default values for coherence management properties. The new default values will improve the data collection behavior of OCM. The properties changed are: tangosol.coherence.management.refresh.policy tangosol.coherence.management.refresh.expiry

Data Historian

17044: Trend Charts now show 7 days worth of data

Previously for some trend charts when the time range was selected as '7 days', the charts would only show data for the past 2 days and not 7 days. The Trend charts will now show 7 days of data when a 7 day time range is selected. The following displays are affected All Nodes > Memory Usage Trends All Nodes > Communication Trends All Caches > Size Trends All Caches > Activity Trends Single Cache > Size Trends Single Cache > Activity Trends Single Node > JVM Memory Trends Single Node > JVM GC Trends

General

16586: Corrected Data Server connections in debug display

Data Server Connections now display correctly in debug display when using Data Server and rich client on Unix. Previously the Data Server Connections in the rtv_debug display (accessible from the Administration->Metrics Administration display via the "RTView Internal Statistics" button) may not have displayed correctly when using the Unix_RunOCMonitor_DS.sh script. This is no longer the case.

16857: Average (Total) Execution Time value to Added to Debug Displays

An Average (Total) Execution Time Value has been added in addition to the Total Execution Time value for the JMX and Function Statistics Debug Displays

17195: Log4j Msgs button removed from ts_node_detail.rtv

Due to the number of connections needed and the volume of log data to process, the Log4j functionality has been removed from the OCM.

17202: Alert Admin tabular alert table no longer scrolls on row select

On the Administration -> Alert Administration display, the tabular alert table's scrollToSelectionFlag has been set to 0 rather than 1. This will prevent the selected item to scroll out of view when run in the thin client.

JMX Data Access

16696: OCM JMX Tables option now works correctly when using OCM Agent

Previously the OCM JMX Tables option did not work correctly when both the properties: ocm.use_jmxtables=true ocm.use_agent=true ...were set in the Cluster properties files. This is no longer the case.

Scripts

16642: Integrate Windows services support into the OCM/OCV batch files

OCM / OCV Monitoring applications can now be installed and run as Windows services. The OCM applications can be managed all at once using the startocm.bat script using the following command line arguments startocm.bat propfile [-test] [-svc(install|remove|start|stop)] where * propfile = cluster property file name w/o extension * -test = echo variables and command lines w/o execution * -svcinstall = Install all apps for an OCM instance as Windows Services * -svcremove = Remove the Windows Services for all apps for a specific OCM instance * -svcstop = Stop the Windows Services for all apps for a specific OCM instance * -svcstart = Start the Windows Services for all apps for a specific OCM instance The affected OCM apps (as appropriate) are the OCM agent, the OCM Data Server. the OCM Display Server and The OCM Historian. The [-svc(install|remove|start|stop)] command line argument can be used with the individual Win_RunOCM* scripts as required. OCV applications can managed all at once using the startocv.bat script using the following command line arguments startocv.bat propfile [-test] [-svc(install|remove|start|stop)] where * propfile = cluster property file name w/o extension * -test = echo variables and command lines w/o execution * -svcinstall = Install all apps for an OCV instance as Windows Services * -svcremove = Remove the Windows Services for all apps for a specific OCV instance * -svcstop = Stop the Windows Services for all apps for a specific OCV instance * -svcstart = Start the Windows Services for all apps for a specific OCV instance The affected OCV apps are the OCV Data Server and the OCV Display Server and The OCM Historian. The [-svc(install|remove|start|stop)] command line argument can be used with the individual Win_RunOCV * scripts as required.

16646: Fixed typo in startDemoProcessNodes2.sh

Previously a typo in the unix script startDemoStoreNodes2.sh in the sims/myclusters directory caused the created ProcessNode05 to create and update the incorrect cache -foo instead of the intended cache foo. This is now no longer the case, and the intended cache foo is created and updated by ProcessNode05 when using the unix script startDemoStoreNodes2.sh

16650: make_ocvdisplay_war.sh now able to make OCV wars

Previously, directory errors in make_ocvdisplay_war.sh prevented the creation of OCV war files on unix. This is no longer the case.

16689: Missing JARs added to OCV make_myclasses classpaths

In the OCV projects/myocv/src/ocv/myclasses directory, the make_myclasses script files have had references to gmsjrtviewds.jar and gmsjocds.jar added to their respective javac classpaths.

16990: my_alert_actions.sh now parses arguments with spaces

The my_alert_actions.sh script has been modified to better handle arguments that contain spaces.

17180: make_ocmonitor_war now updates correct .war file

The make_ocmonitor_war script file now correctly updates the correct war file.

17385: encode_string utility added

The encode_string utility has been added to Oracle Coherence Monitor. This utility can be called from the command line to return a hash value of a string. Example: encode_string helloworld Results: encrypted value: 01338013350134201342013450135301345013480134201334

Service

16789: Service History Heatmap modified to show Location, not Member

The Cache Services / Service History Heatmap now shows the Location of each node in the tooltip box that appears when you mouse over a strip in the heatmap. This corrects a problem that occurred if the member name had not been set for the nodes

16790: New All Services History heatmap

An "All Services" History Heatmap has been added to the OCM navigation tree. This provides a way to see a short-term history of the activity on all the services running in a cluster. The drilldown targets for All Caches / Current Size Chart and All Caches / Current Activity Chart were changed to Single Cache / Cache Summary.

Simulators

16350: Provide option to execute Entry Processor and Invocation Service

The OCSIMDATA simulator has been enhanced to provide the option to perform Entry Processors and Invocation Services for testing. The Custom Display 2 / OCSIMDATA page has been enhanced to show the state of the checkboxes that control these options. The Client Configuration dialog has been enhanced to provide checkboxes to enable / disable these options. When enabled, each update will result in one simple entry processor executed on every object in the specified caches or to perform an invocation on every node in the cluster.

17375: OCM Simulators enhanced to work with Coherence 3.7.1

The Simulators in the OCM 5.8.0 release work with Coherence 3.7.1

Timing / Performance

16870: Delta Function optimization

The performance of the RTView Delta function has been improved significantly when there are a large number of unique index column combinations.

Version 5.7 Release Notes

Alerts

16537: New alert DepartedNodesPercentage

A new alert - DepartedNodesPercentage - has been added to trigger an alert when a user-defined percentage of nodes depart within a user-defined period of time. This percentage is measured against the total number of nodes (both running and departed). The DepartedNodesPercentage alert is disabled by default and the default warning and alarm thresholds are 90% and 95%.


16538: New Alert AvailableMemoryLowNodeSpike added

A new alert "AvailableMemoryLowNodeSpike" has been added which allows user to be alerted if the memory used on a node exceeds a %age of the average memory used in the last 24 hours. This alert allows users to enter threshold values which would be a percentage above average, relevant to a 24 hour period. For example if a user entered 50% for this threshold and the average memory consumption on a particular node over 24 hours was 40% of total , then an alert would be triggered if that nodes current memory consumption was over 60% of total. The time span of 24 hours (86400 seconds) is controlled by the $AVERAGE_MEMORY_TIME_WINDOW substitution.


16539: New Alert BadCommunicationNodesInTimeRange Added.

A new alert BadCommunicationNodesInTimeRange has been added which allows users to be alerted when a percentage of nodes ( or more) meet the criteria for the BadCommunicationNode alert within a time range. The Time range is currently defaulted to 5 minutes ( 300 seconds), but can be changed by modifying the $BAD_COMMUNICATION_NODES_TIME_RANGE substitution variable


16540: Provided ability to disable the alerting system

The OC Monitor now offers the ability to disable the alerting system. When disabled, all alerting is suspended. On the Alerts Administration display, a pair of buttons has been added to allow for disabling and re-enabling of the alerting system. As a precaution against accidental disabling of the system, indicator labels appear on both the Alerts Administration and Alert Detail displays to serve as reminders of the disabled state. A confirmation dialog also appears prior to disabling the alerting system.


16552: AlertLabel substitution now passed to example alert handlers

The alertLabel substitution ($alertLabel), which may contain spaces, is now passed to the the example alert handlers * java = MyCommandHandler.java * windows = my_alert_actions.bat * unix= my_alert_actions.sh They show how to extract the value of this arg and echo it, together with the other arguments passed to the alert action command


Data Historian

16546: Cache Size/Activity Trends now display correctly with Oracle

Previously when loading historical data from an Oracle database for use with the Cache Size/Activity Trends, the trends may have not displayed correctly. This is no longer the case, and the trends now correctly display the loaded historical data.

16573: Historical Cache Trend Graphs now display correctly with ORACLE

Previously under certain circumstances various cache related trend graphs may have not displayed accurate data when using an ORACLE database for the historical data. This is no longer the case.


Reporting

16568: Correct database tables used when non default values selected

Previously if you selected non default values for the database tables in the cluster .properties file ( by means of the substitution variables) e.g ocm.cachetotals_sub=-sub:$CACHETOTALS_TABLE:CACHETOTALS ocm.nodestats_sub=-sub:$NODESTATS_TABLE:NODESTATS ocm.alertdefs_sub=-sub:$ALERTDEFS_TABLE:ALERTDEFS ocm.alertdefs_tab_sub=-sub:$ALERTDEFS_TAB_TABLE:ALERTDEFS_TAB you may have seen SQL errors at run time from the DataServer when using the following scripts. Win_RunOCMBuilder_DS.bat Win_RunOCMonitor_DS.bat Win_RunOCMDisplayServer_DS.bat Win_RunOCMReportGen_DS.bat Unix_RunOCMBuilder_DS.sh Unix_RunOCMReportGen_DS.sh This is no longer the case


Version 5.6c1 Release Notes

Administration

16470: Total JMX query time added to Admin Metrics

The Admin Metrics page has been enhanced to show a trend chart of the total JMX query time, i.e. the total time taken to query the monitoring MBeans from Coherence. A Total MBean count is also shown. The Total MBean count shown includes miscellaneous MBeans such as Cluster and Connection beans.

Alerts

16149: LongGCDurationNode alert added

The OCMonitor now has a LongGCDurationNode alert that will trigger when garbage collection times extend beyond user specified durations. It can be accessed on the Alert Administration page and allows for the setting of a warning level, an alarm level and a duration, as well as a setting to enable or disable the alert. By default the alert is enabled and is set to trigger a warning after 1 second GC duration, and an alert after 2 seconds of GC duration.

16291: Alert Definition Files added for Unix and Windows

Alternate OCM alert definition files are available that execute a batch file or shell script when an alert is triggered. The new files are provided as an alternative to the custom Java command used in the default alert configuration. The files are in the projects/myocm directory ts_alertdefs_win.rtv - executes my_alert_actions.bat ts_alertdefs_unix.rtv - executes my_alert_actions.sh Select the appropriate file for the platform that hosts OCM processes. Copy the file in the myocm directory, and change the name to ts_alertdefs.rtv. Then restart the OCM processes. The my_alert_actions scripts send the alert information to standard output by default. This can be changed as needed to send the alert information to the desired destination.

16335: New alerts for cache's object count delta.

The OCM monitor now has ObjectCountDeltaUpCache and ObjectCountDeltaDownCache alerts. They can be found on the Alert Administration page and are tabular alerts that will allow for the setting of warning levels, alarm levels and duration for each cache, and are triggered on the absolute value of the cache's object count delta. ObjectCountDeltaUpCache will trigger when the count deltas increase in value and hit the specified thresholds. ObjectCountDeltaDownCache will trigger when the count deltas decrease in value and hit the specified thresholds. Since these are tabular alerts (like the CapacityLimitCache alert), selecting either in the Active Alert Table will display a "Per Cache Alert Setting" list of caches, rather than the "Current Alert Settings" box that is displayed for scalar alerts. These alerts are both disabled by default.

16336: New HighTaskBacklogNode alert

The OCM monitor now has a HighTaskBacklogNode alert to warn and/or alert when the backlog of tasks extends beyond a user threshold. It can be found on the Alert Administration page and allows for the setting of a warning level, an alarm level and a duration, as well as a setting to enable or disable the alert. By default the alert is disabled. It is set to trigger a warning after a threshold of 10, and to trigger an alert after a threshold of 20.

16384: New HighPendingRequestNode alert

The OCM monitor now has a HighPendingRequestNode alert. It can be found on the Alert Administration page and will allow for the setting of warning levels, alarm levels and duration. It is triggered when the RequestPendingCount reaches the specified thresholds. This alert is set to be initially disabled.

16385: New HighThreadAbandonedNode alert

The OCM monitor now has a HighThreadAbandonedNode alert. It can be found on the Alert Administration page and allows for the setting of warning levels, alarm levels and duration. It is triggered when Coherence's Thread Abandoned Count reaches the user-specified thresholds. This alert is set to be initially enabled with warning and alert levels both set to 0. and a duration set to 60.

16433: New HighGCDutyCycleNode alert

The HighGCDutyCycleNode alert has been added to the OC Monitor. This is a scalar alert which will trigger if any Node has breached the threshold allocated for the duty cycle (% of time spent in Garbage Collection). By default, this alert is enabled with defaults of 10(%) for the warning, 20(%) for the alarm, and a duration of 10 seconds.

Cache

14493: Eviction statistics added to Cache Summary

The OC Monitor now monitors and displays Eviction metrics. These can be found on both the Cache Activity Trends display and the Cache Summary display.

16467: Persistence information added to Cache Summary, Trends

The OC Monitor Cache Summary display has been enhanced with the following fields: Persistence Type, size of Write Queue, total number of writes and total number of write failures. The OC Monitor Single Cache Active Trends display has been enhanced with a trend graph plotting the size of the Write Queue.

16468: Cache Storage Index Info page enhanced

The Index Info page that comes up when a Node is selected in the Single Cache / Storage Detail page has been enhanced. It now shows the "cardinality" (or number of unique extractors), and the total number of indexes associated with this node and cache.

Cluster

16194: Memory/Network Display no longer times out

In previous versions of OCM, the Cluster Views Memory Network Display would give a timeout error when running in the Display Server. This problem has been fixed.

16198: Cluster Stability Metrics Page trend is now a flex trend

The trend chart in the Cluster Views - Stability Metrics display has been replaced with the a flex trend chart.

16218: Memory/Network display enhanced to show info by Storage class

The Cluster Views, Memory Network Display has been enhanced to display aggregate information for Process Nodes and Storage Nodes separately. The display contains four trend graphs - Publish Failures, and Received Failures for Process Nodes, Memory Utilization % for Process Nodes, Publish Failures and Received Failures for Storage Nodes, Memory Utilization % for Storage Nodes.

16420: Client/Storage spark charts now load historical data

The spark charts on the Cluster Views Overview display now load data from history. In previous versions of OCM the spark charts showed 5 minutes of data. They now show the last 20 minutes of data.

Configuration

15996: New Oracle Coherence properties added to cluster properties file

New Oracle Coherence properties can now be set from cluster properties files. These properties are listed as available for use the SampleCluster.properties file. The properties (as described the the Oracle Coherence documentation) are: tangosol.pof.enabled tangosol.pof.config tangosol.coherence.ttl

Data Model

16431: Duty Cycle added to JVM GcInfo Cache.

A New DutyCycle column has been added to the JVM GcInfo Cache. The column represents the %of time that that the given Garbage collector for the given node has been engaged in garbage collection over the last update period (where the update period is the jmx sample period for coherence Mbeans)

Deployment

16510: Location column in All Nodes - Detail Display corrected

Previously, under certain circumstances, the thin client may not have displayed the Location Column in the All Nodes - Detail Display correctly on its initial display. This is no longer the case.

Development and Build

16293: Libraries are no longer signed

The RTView libraries included with RTView for APM | OC Monitor are no longer signed.

General

16170: Non-Flex chart toggle buttons removed

By default the OCM Monitor uses Flex Graphs. Users may use the -fxreplace application option to use non-Flex graphs instead. In previous versions, the displays contained "FX" and "No FX" buttons which could be used to navigate between Flex and the non-Flex graphs. These buttons have been removed from OCM.

16458: Updated Custom displays

The Custom Displays tab in the OCM Navigation Panel on the left provides access to 2 custom display pages. These pages have been modified to provide users valuable information regarding the use of the RTView Builder to develop custom displays and incorporating them into the OCM framework. A couple of empty custom display pages are provided to make it easy for users to build their own custom displays.

16508: Error message no longer appears in Front Back Cache Analysis

Previous when navigating to the Single Cache -> Front/Back Analysis display you may have sen an error message that said GmsRtViewLocalDs: addObject(__$cacheNameFormat) object is already in table, not added. This is no longer the case

16509: Error Message no longer generated for Alert Detail Table

Previously when navigating to the Alert Detail Table (Alert Views->Alert Detail Table) Display, the following error message may have been generated ERROR: Initial value for variable does not match specified data type. Setting data type to string. This is no longer the case.

JMX Data Access

16332: New optimized JMX data retrieval option using custom mbeans

A new feature has been added to OCM that provides the ability to collect monitoring JMX data from a Coherence cluster much more efficiently. By using a custom MBean to compact the data before it is passed through the Coherence MBeanServer, the rate of data collection is made faster by a factor of up to 3 X. Additionally, the CPU load and the volume of data transferred is also significantly reduced.

16446: New "Fast JMX" option to minimize garbage collection overhead

A new option, -fastjmx, has been added to OCM to enable a mode of operating that minimizes garbage collection during the acquisition of JMX MBeans for Coherence. The -fastjmx option will tell the OCM data collection component (i/e OCM Agent, DataServer, or directly connected client) to minimize garbage collection, by reusing data buffers where possible and assuming similarly sized bean counts on each update cycle. This is especially valuable for use in very large clusters with many MBeans where garbage collection can cause messages from cluster nodes indicating that the MBeanServer is not responding due to garbage collection.


16469: New agent-based data collection option in cluster.properties

There is a new property in cluster.properties file that allows for the use of agent-based data gathering from the coherence cluster. The agent is used to gather data from coherence cluster and supply it to the OCM Data Server process. The agent is responsible for acquiring data from the coherence cluster, and forwarding it to the data server process. Since the agent does not have the overhead of the Data server, which aggregates and processes raw data into caches, it creates fewer transient objects which are then subject to garbage collection. In situations where large amounts of transient data triggers potentially length garbage collection pauses in a node in the cluster, potentially increasing the likelihood of communication delays and other gc activity in the cluster, the agent based approach may be beneficial. Note: The agent-based approach adds an additional java process and agent->Data Server communication to the monitoring machine. The agent based approach can be utilized by setting the property ocm.use_agent=true in the cluster.properties file, before starting any OCM processes.

JVM metrics

16432: GC Duty cycle trend added to JVM GC trends

The OCM now displays trend data reflecting the percent of time spent in garbage collection, also known as the Duty Cycle.

16435: Percent CPU Time corrected and shown in Node displays

The OCM Single Node / JVM Summary display now displays the correct "Percent CPU" value. A trend line of the CPU Percent is also now displayed in the Single Node Summary page. The All Nodes CPU page has been restored (under All Nodes) and shows CPU for all nodes in a heatmap

Node

16414: "Service Trends" display moved to the Single Node group

The Service Trends display that was in the Cache Services category has been moved to the Single Node category.

Oracle Coherence Viewer

16272: Cache now selected on a per-display basis

In prior versions, the selection of a cache on one tab's display changed the selected cache on the other displays. This has now been fixed so that each tab's selected cache remains independent of the others. Changing the selected cache on one display will not effect the selected cache on the other displays.

16273: Each query execution is now seen as a new query

In previous versions, it was possible for the same query, when run multiple times, to use the cached results. This has been updated so that each query execution is seen as a new query and executed as such.

16364: Query no longer fails when max rows contains a comma

Errors in processing comma separators in the Max Rows field of the Query Objects Tab have been resolved.

Proxy / Extend

16039: Data correction for 'Proxy / Extend Connection Detail' display

In the previous version, the units value (KB) was missing from the Bytes Sent and Bytes Rcvd values. This has now been fixed. Additionally, Delta columns have been added for each of these two columns.

16453: New Proxy/Extend Heatmap and Connection History display

A heatmap showing proxy services with extend clients has been added to OCM. The headmap colors are user-selectable. Beneath the heatmap, a trend chart displays the total connections and total byes transferred across all proxies.

16454: New category for Proxy / Extend displays

The OC Monitor has been enhanced with a Proxy Services tab that includes three new displays: Proxy / Extend Overview - includes a heatmap of the extend connections and a trend graph of the total connections and total bytes transferred across all proxies Proxy / Extend Connections - includes tabular data about the proxy services and a trend graph messages and bytes sent and received. Proxy / Extend Detail - similar to the above, but with a table of extend client connection data.

Reporting

16368: Report templates enhanced to enable duration setting

The $reportDuration substitution has been added to allow the user to specify the time range displayed in the charts. By default, the $reportDuration substitution is set to 1 Hour. The charts in the report will display an hours worth of data. The valid entries for the $reportDuration substitution are set in the constants.xml file: All Data 2 Mins 5 Mins 20 Mins 1 Hour 4 Hours 8 Hours 24 Hours Last 2 Days Last 7 Days When setting the $reportDuration substitution on the command line, the substitution command must be enclosed in double quotes Win_RunOCMReportGen_DS "-sub:$reportDuration:4 Hours" -report:ts_report.xml The substitution my optionally be set in the OPTIONS.ini file. sub $reportDuration:'2 Mins'

Scripts

16196: HSQLDB scripts enhanced to respect RTV_JAVAOPTS environment var

The scripts used to run the default OCM database, HSQLDB, have been enhanced to respect the RTV_JAVAOPTS environment variable, used for changing Java VM configuration. The RTV_JAVAOPTS environment variable can be configured on the command line, or using the common conf/ocm_setup script

16199: Alert actions script now works on Solaris

In previous versions the alert actions script (my_alert_actions.sh) did not work on Solaris platforms. The script has been enhanced to work on Solaris platforms.

16200: Script error in run_ocsimdata on Solaris

In the previous versions, the rtview/bin/run_ocsimdata.sh script did not run on Solaris. This has been fixed.

16214: Machine Name added to simulator nodes to ensure unique location

Simulator nodes, used in the demo cluster scripts now have machine names added to the member names to ensure unique location ID's.

16271: OCV Display Server now uses correct stylesheet on Unix

The Unix scripts Unix_RunOCViewer.sh Unix_RunOCViewer_DS.sh Unix_RunOCVDisplayServer_DS.sh have been update to use the rtv_darkstyles stylesheet by default.

16484: New Background behavior available for OCM processes

It is now possible to run OCM processes in the background, minimizing the number of processes running in an OCM monitoring situation. When running in background mode, OCM processes do not output to the command line, instead output appears in a log file in a log directory as specified in the cluster.properties file. The logging directory is specified by the ocm.log_dir=logs property, and individual named log files, by the ocm.agent_log=DemoCluster_agent.log ocm.data_log=DemoCluster_dataserver.log ocm.display_log=DemoCluster_displayserver.log ocm.historian_log=DemoCluster_historian.log properties in the cluster. properties file. NOTE: The logging directory and the log file names cannot contain spaces. The options to be used prior to running the process, can be shown by using the -test command line argument. OCM processes can be run in the background by using the -bg command line argument. Note: The startocm script on unix uses the -bg option by default.

Service

16428: New Single Service Summary display added

The Single Service Summary Display has been added to the Cache Services Category. This display shows performance metrics for a single service aggregated across all nodes.

Version 5.5c1 Release Notes

Alerts

15953: New alert, CapacityLimitCache, has been added

A new alert, CapacityLimitCache, has been added to the Oracle Coherence Monitor. This alert is the same as the CapacityLimitAllCaches alert, except that is allows you do set the warning level, alarm level and enabled flag for each cache being monitored. In the CapacityLimitAllCaches alert, a single warning level, alert level and enabled flag is applied to all alerts being monitored. By default, all caches in the new CapacityLimitCache are disabled. To configure this alert, navigate to the Alert Administration page and select CapacityLimitCache from the Active Alert Table at the top. This will populate the bottom of the display. The Enabled and Duration options under Current Alert Settings apply to the alert as a whole. For example, if Enabled is deselected here, no alerts will be generated for any of the caches. The Per Cache Alert Settings are applied to the selected cache. Select one or more caches from the table, adjust the Warning Level, Alarm Level and Enabled fields to the left, then click Save Settings to apply the per cache alert settings and save them to the alert database. Select one or more alerts in the table and click Remove Settings to remove the settings for the selected cache(s) from the database. This will disable the selected cache for the alert. The status column of the Per Alert Cache Settings table indicates the state of the alert settings for the corresponding cache. Valid Status values are as follows: saved - The settings have been applied and saved to the alert database. blank - No settings have been applied or saved for the corresponding cache. absent - Settings have been saved for a cache that is not active.

Data Historian

16181: Cache Size/Activity Trends now display correctly with Oracle

Previously when loading historical data from an Oracle database for use with the Cache Size/Activity Trends, the trends may have not displayed correctly. This is no longer the case, and the trends now correctly display the loaded historical data.

General

16098: Directory structure changes

The directory structure of RTView for Oracle Coherence Monitor has changed as follows: 1. A lib directory has been added to the top level. This directory contain gmsjocm.jar, which used to be in rtview\lib. 2. The myclusters directory has been moved to sims\myclusters. 3. The myocm, myocv and myocv_ols directories have been moved to projects. A subdirectory named src has been added to the projects that contain same source code. The source files are in package subdirectories under src. 4. A servlets directory has been added to the top level. This directory contains the ocmonitor servlet directory which used to be located in rtview\servlets\ocmonitor.

16179: Cluster Views-Memory/Network. graph label changed

The Cluster Views-Memory/Network display flex graph title label has been changed to "Memory/Network Metrics for Cluster"

JVM metrics

16081: Data points now correct when changing Garbage collector

Previously, when changing the selected Garbage collector in Single Node - GC Statistics Trend Display the trend display may have not updated correctly to show all the relevant data points. This is no longer the case.

Navigation

16127: Communication Issues bar graphs now sort correctly

Previously bars in the Upper graph in the Communication Issues - By Node display would not order correctly when the Sent Failure Rate or Received Failure Rate Sort By: options were selected. This is no longer the case.

16128: Service now set correctly in Single Cache - Summary display

Previously when drilling down from the Cache Data table in the Single Node - Summary display, the selected Service in the Single Cache Summary display was not set correctly, and thus the appropriate information was not displayed. This is no longer the case

Scripts

15968: make_ocmonitor_war.bat and make_rtvdata_war.bat improved

The OCM batch files make_ocmonitor_war.bat and make_rtvdata_war.bat were originally designed to only be executed from higher level batch files that initialized the environment for them. They have been enhanced to initialize the environment independently.

16164: Test simulator nodes can now be run in demo cluster

New simulated cluster scripts (startDemoTestNodes ) allow the starting of simulated nodes for use in a demo cluster

Service

16080: Cache services displays now show Messages metric

The graphical Cache Service displays now show the Messages metric. This is the number of messages for the given node in the measured interval.

Version 5.4h1 Release Notes

Cache

16125: All Caches - Current Size Chart displays data correctly for Unit

Previously the All Caches - Current Size Chart may not have displayed data correctly for Units. Thus display now displays the data correctly

Data Sources

SQL Data Source

16124: Historian database support for Oracle

A bug preventing the use of Oracle for the Historian database has been fixed.

Version 5.4g1 Release Notes

Alerts

15963: Custom command now used when alert is triggered

The default action executed when an OCM alert is triggered has been changed from a Beep to a custom command. The source for the custom command is provided in myocm/MyCommandHandler.java. The command sends alert information to the data server log file. Sample alert output as it appears in the data server log is provided below: Custom alert command executed clusterName = DemoCluster alertName = DepartedNode alertIndex = ProcessNode04.sleltx1 alertId = 1000 alertSeverity = 2 alertText = High Alert Limit exceeded, current value: 1.0 limit: 1.0 The default behavior can be changed by editing MyCommandHandler.java to produce the desired functionality. A script is provided (make_myclasses.bat, make_myclasses.sh) that compiles the handler and updates myclasses.jar. A batch file (my_alert_actions.bat) and a shell script (my_alert_actions.sh) are provided that can also be configured for execution when an alert is triggered. The steps are: 1. Extract ts_alertdefs.rtv into the myocm directory Unix/Linux: cd $RTVOC_HOME/myocm jar xvf ../rtview/lib/gmsjocm.jar ts_alertdefs.rtv Windows Double-click rtvoc_cmd.bat to open a command window cd myocm jar xvf ..\rtview\lib\gmsjocm.jar ts_alertdefs.rtv 2a. Windows Edit ts_alertdefs.rtv using the Builder or a text editor. Replace all occurrences of the alertCommand property with the following: alertCommand="system cmd 'my_alert_actions.bat $clusterName ~$alertName~ ~$alertIndex~ ~$alertID~ ~$alertSeverity~ $alertText'" Save ts_alertdefs.rtv and restart the data server. 2b. Unix/Linux Edit ts_alertdefs.rtv using the Builder or a text editor. Replace all occurrences of the alertCommand property with the following: alertCommand="system cmd 'my_alert_actions.sh $clusterName ~$alertName~ ~$alertIndex~ ~$alertID~ ~$alertSeverity~ $alertText'" Save ts_alertdefs.rtv and restart the data server. Note: If after testing the batch file and shell script you want to return to the custom command, the alertCommand property to use is: alertCommand="system cust my_alert_command '$clusterName $alertName~$alertIndex~$alertID~$alertSeverity~$alertText'" Then rebuild myclasses.jar and restart the data server.


Service

16027: New Displays available with cache services information

New displays are available showing additional cache services information: New Cache Services Tab with * Service Metrics Overview * Service Metrics Detail * Service Metric - History * Cache Service Details Display (moved) New Front/Back Analysis Display in Single Cache Tab

16028: New Service trends display for cache services.

New Service trends display for cache services. This display shows trend graphs , On a per node / location basis, for the 6 metrics * CPU% * Requests * Request Average Duration * Request Pending Count * Task Backlog * Active Threads These are the same metrics Sshown in the services Overview heatmap, or individually in the history heatmap. The metrics are shown as trend graphs, with a user selectable Time Range The user selects an individual location (node) to plot metrics for the available locations are filtered by user selectable Service and Host.

Version 5.4e1 Release Notes

JMX Data Access

15997: Option to specify (non default) named JMX connection

OCM now has means of specifying (non default) named JMX connection for obtaining coherence data. use the command line option: -ocm.jmxconn: or add to the properties file: sl.rtview.ocm.jmxconn property=


Reporting

15958: Added ability to generate reports from the command line

The report generation capability of RTView has been added to OCM by the inclusion of the appropriate jar files in the library, and additional command line scripts, so that reports featuring OCM displays can be generated from the command line.


Version 5.4c1 Release Notes

Data Historian

15530: Size of history caches now configurable

The size of the history caches used by the ocmonitor can now be configured by the user, by setting the value of the $rtvCacheHistorySize global substitution. This can be done in the Application Options General->Substitutions Tab.


Version 1.3.0 Release Notes

14491: Using Oracle as Historian Database no longer throws exception

The calculation of the Hit Percent for caches sometimes resulted in a NaN (not a number) result. When written to a database using the historian, some databases would complain or crash. This problem has been fixed.

14494: New "Cache Browser" display

A "Cache Browser" display has been added that permits the user to select a cache and see the list of keys in that cache. When a key in the list is selected, the content for that key is shown.

14511: New "cumulative" checkbox added to several Cache data displays

A "cumulative" checkbox has been added to several displays showing cache statistics. This permits the user to select whether to view data for the last time interval (10 seconds by default) or the cumulative total since the cache was initiated.

14512: Navigation panel reworked

The Navigation panel has been reorganized to better reflect the functional grouping of the various displays

14513: Cache Totals By Cache page split into Activity/Capacity

Cache Totals are now presented in two separate displays, one showing Activity metrics and the other showing Capacity metrics

14517: Additional administration displays added

Two new administration displays have been added. There are the Cache and Node administration pages. Log in as super to access these pages.

14523: New "Communication Issues" display

A new display "Communication Issues" has been added. This display shows the packet transmission statistics broken down by Node.

14525: Cache Totals Activity and Capacity page now affected by Service

The Cache Totals displays are now properly filtered by the Service dropdown list.

Version 1.2.0 Release Notes

14443: New High Level Overview page

A new top-level summary display was added to the Data Grid Monitor. Objects in this display drill down to the relevant displays that contain greater detail.

14448: Unix shell scripts added

Unix bash shell scripts have been added, to duplicate the functionality of the Windows batch files. The documented instructions are now applicable to all supported platforms.

14460: Windows run* scripts modified to clean up temp variables

The Windows scripts to invoke RTView applications as a member of the Coherence cluster have been modified to properly clean up after execution or termination by control-C.

14461: Size of all tables increased to 1000

The node and cache detail tables previously were limited to 100. The limit is now 1000.

Version Release Notes

14826: Cache browser does not work with simulator

The Cache Browser view again displays data with the simulated cluster, as a DistributedCache service has been added to the simulator.

Administration

14727: Admin pages now always visible, but buttons disabled

The behavior of displays based on roles has been changed. Now, the displays are always visible, but the buttons are disabled if user does not have permissions.

14751: Show RTView Memory Utilization Information in Metrics Admin page

The Metrics Administration display has been enhanced to show the memory used by RTView to store the history of Cache and Node statistics that are presented in trend charts.

14781: Admin Node and Admin Cache page corrections

Some interaction errors in the Node and Cache administration pages have been corrected. The selected Location is now shown instead of the node id. A value entered in an edit field will remain during the confirm process rather than disappear as in previous versions.

15261: Boolean updating of Enabled properly supported in Alert Admin

The Alert Administration page now supports all databases without change to the rtv files. Previously there was an issue working with databases that do not support a boolean type, but this has been corrected.

Alerts

14622: Alert mechanism added to Oracle Coherence Monitor

The ability to generate and customize Alerts has been added to the Oracle Coherence Monitor application. Alerts may be managed by administrators, who set the threshold values as desired within the GUI of the Oracle Coherence Monitor application. An initial set of 7 alert types is available: Available Memory Low for Cluster Available Memory Low for Node Bad Communication by Cluster Bad Communication by Node Capacity Limit for All Caches Capacity Limit for Cache Endangered StatusHA for All Caches

14776: Alert provided for Departed Nodes

The "DepartedNode" alert has been added to the Oracle Coherence Monitor. This alert is triggered whenever a node leaves the cluster for more than the specified delay time (default = 60 seconds). When a departed node rejoins the cluster, the alert is cleared. This alert may be disabled/ enabled from the Alert Admininstration page.

14951: Alert Summary view updated to indicate disabled alerts

The Alert Summary view has been updated to indicate that disabled alerts in gray. Unimplemented alerts have been removed.

14964: Removed unimplemented alerts

Unimplemented Alerts are no longer visible. These will be added back to the views once they have been implemented.

Cache

14716: New Activity/Capacity Trend views for All Caches

Two new displays have been added, the All Caches Activity and Capacity Trends. These show up to ten active Caches comparing total activity or capacity against one another. The user can select which metric to compare.

14758: All Caches Activity/Capacity Charts now scale better

The Current Activity and Current Capacity charts now scale graphically to accomodate larger number of caches.

14759: Cache Statistics page now shows average object size

The Cache Statistics page now shows average object size

14820: Tier Selector added to All Caches Activity/Capacity Bar Charts

The All Caches Activity and Capacity Chart displays have been modified to provide a "Tier" selector. This enables the user to specify either Front or Back tier caches to be shown in these displays.

14836: Corrected spiking in Cache Activity hit/miss history

In previous versions, the Cache Activity trend chart would show spikes in the historical data. This has been fixed.

15257: "All Services" option now available for all pages

It is now possible to select all Services and see the activity and capacity for all caches across all services on a single page. Simply select "All Services" wherever the Service: selector is available to see all the caches on all services.

15258: Improve Cache Service page to show more useful information

The Cache Services display has been enhanced to provide more useful information.

15259: Added ability to shorten long cache names

Long cache names can now be shortened for display in the RTView OC Monitor. By default, cache names longer than 28 chars will show only the first 14 characters followed by a ".." and the last 14 characters. This format can be controlled by a substitution variable $cacheNameFormat contained in the OPTIONS.ini file. By default it is set to 14*14. Users may change this to N*M where N represents the number of initial characters to display, and M represents the number of ending characters to display. This format substitution may also be set to override what is in the OPTIONS.ini by using the command line option: -sub:$cacheNameFormat:N*M

15879: Caches removed from current cache displays when destroyed

Previously OCM would persist the display of caches, after they had been destroyed. This is no longer the case, as caches are removed from the current internal tables when they are destroyed.

15944: Storage IndexInfo view now displays all Index values.

Previously the Storage IndexInfo view display would only display a single IndexInfo value. Now it displays all InfoIndex elements, like jconsole.

Cluster

14760: Storage Node Count on overview display is now correct

On the Overview display, the Storage Node Count was sometimes incorrect. This problem has been corrected.

14818: The Invocation Service Detail page was incorrect

The Invocation Service detail page was incorrectly showing the same information as the Cache Service Detail page. This has been corrected.

Configuration

15964: Coherence Properties available in SampleCluster.properties file

A list of the Coherence properties available for use in cluster.properties files is provided in the SampleCluster.properties file.

Customization

14739: Mechanism added for including custom displays in navtree

The Oracle Coherence Monitor application has been enhanced look for, by default, a navigation panel configuration file called "custom_navtree.xml". If found it will read this file and add the contents to the left hand navigation panel. One sample display is included by default in demos/ocmdemo.

15062: HISTORY.ini and ts_alertdefs.rtv in ocmdemo for customization

The demos/ocmdemo directory now contains a default Historian configuration file (HISTORY.ini). It is configured to use the built-in HSQLDB database. This directory also contains a default Alerts configuration display (ts_alertdefs.rtv). The default action on any alert is to issue a beep. This can be changed by editing the ts_alertdefs file using the RTView Builder.

Data Historian

14701: HSQLDB used for RTVHISTORY and ALERTDEFS database

HSQLDB is now available for the new Oracle Coherence Monitor application for persisting Alert definitions and saving data for the Data Historian. To start the database, you must run the following command line script from the demos/ocmdemo directory: run_hsqldb The Oracle Coherence Monitor is configured to find and use this database by default.

14742: Eliminated need for substitution change to load historian data

There is no longer any need to make changes to OPTIONS.ini to select whether historical data comes from the database or in- memory tables. Historical data now always comes from in-memory tables, and is pre-loaded from any HISTORY database available and enabled.

14897: SQL query to Oracle no longer fails due to using reserved word

In previous versions, a SQL query to an Oracle Historian database failed due to using a reserved keyword. This was changed to a non- reserved name.

15061: Displays and Historian updated to use new SQL timestamp mode

The default OCM displays and configuration files have been enhanced to take advantage of the new Historian timestamp mode that stores timestamps as SQL TIMESTAMPs, rather than as VARCHAR. This permits the creation of database scripts to manipulate or purge the historical data using the TIME_STAMP column.

Data Sources

Oracle Coherence Data Adapter

15986: OC listener registration modified to minimize memory usage

In 5.4d and earlier, the OCDs mechanism for registering for data listeners (the __NEW__ key) used a large amount of memory, since it used a ContinuousQueryCache which makes a complete copy of every object in the cache of interest. This has been modified so that the listener is attached directly to the cache of interest and memory utilization is greatly reduced.

Deployment

14644: Restructuring of application directory and scripts

The organization of the Oracle Coherence Monitor (OCM) has changed, as have the scripts used to run it. DIRECTORIES Oracle Coherence Monitor no longer in a single directory, but has been integrated more closely into the RTView directory structure. Main class files and displays - All of the files necessary to run the Oracle Coherence Monitor are now included in lib/gmsjocm.jar, which is included in the classpath when you pass in the -ocm argument. As a consequence, you are not required to run the OCM from a specific location. Run scripts - The scripts are now located in the RTV_HOME/bin directory, and are included in the users PATH in an initialized command windows. Documentation - Expanded documentation can now be found in the RTView Userguide, in the Monitoring Oracle Coherence subsection. Simulated Cluster - The simulated cluster is now located in demos/ocmdemodata. Customization - The demos/ocmdemo directory contains copies of the configuration files that are included in lib/gmsjocm.jar, as well as some new examples of customization. JMX CONNECTIONS The Oracle Coherence Monitor connection is controlled via the $conn substitution. Previously $conn was set to "Development" by default, and "Development2" was used to connect to a remote JMX RMI. "Development" has been renamed to "LocalJmxNode", and Development2 has been renamed to "RemoteJmxRMI". "RemoteJmxRMI" is now the default value of $conn. SCRIPTS RTView applications now recognize two new mutually-exclusive command line arguments, -ocm and -ocmnode. They must be the first argument used. -ocm: Adds gmsjocm.jar to the classpath, and by default connects RTView applications to Oracle Coherence via a remote JMX RMI on port 9991. -ocmnode: Adds gmsjocm.jar and COHERENCE_HOME/lib/ coherence.jar to the classpath, runs the application as an Oracle Coherence Node, and sets $conn to LocalJmxNode. By default - Dtangosol.member.name will be set for you, but you can override this default by setting -Dtangosol.member.name in the RTV_JAVAOPTS variable. The scripts have been replaced as follows: run_monitor run_ocmonitor run_monitor_node run_ocmonitor -ocmnode run_builder_node run_builder -ocmnode run_historian_node run_historian -ocmnode run_dataserver_node run_dataserver -ocmnode run_displayserver_node run_displayserver -ocmnode The old scripts will eventually be removed from the product.

15495: Applet Throws "Unable to load MyRtvAppManager" but Still Runs

When running in an applet, the Oracle Coherence Monitor no longer throws the following error: ERROR: cannot create RTView MBeans: access denied javax.management.MBeanServerPermission createMBeanServer) ERROR: Unable to load MyRtvAppManager. Pack it into one of your applet jars and restart the browser.

Development and Build

14797: Launcher arguments supported in any order

In the previous release, if the -ocm and -ocmnode command line arguments were used, they had to be the first argument specified. This has been fixed so that the arguments can now be specified in any order.

Documentation

14852: Updated OCM help screens

The popup Help windows for the Oracle Coherence Monitor have been revised and improved.

General

14718: Name changes in navigation tree

The names of some of the displays in the navigation tree have been changed to better reflect their purpose.

14725: Time range and cache name selectors now global

The selection of Time Range or Cache is now retained across a change of display.

14757: Service/Cache/Node dropdown lists auto-populate

The dropdown lists for Service, Cache, and Node will now auto- populate based on the available selections. It is no longer necessary to predefine selector variables with substitutions on initialization. Also, when switching to a different service, the cache selector is automatically set to the first cache in that service.

15260: Option to use process name as the location name

A new command line option -processnames has been added to indicate that the Process Name is to be used as the Location Name for all nodes.

15287: Excessive data no longer sent by Data Server to OCM

When the OCM is used in conjunction with the Data Server, excessive amounts of data were being transferred to the OCM and it would continually increase. This problem has been corrected.

15297: Log4J messages available from each node

A feature has been added to the Oracle Coherence Monitor to permit users to see the Log4J messages coming from the Coherence nodes. If a Coherence node is outputting log4j messages, and its "Application" name is assigned to be the same as its Location (member.machine.rack.site), then the messages will appear in a drilldown window that can be selected from the Node Summary page. Note that the LOG4JOPTIONS.ini file must be configured to make a connection to the appropriate Log4J SocketHubAppender.

15593: Connection Status indicator now shows JMX and Data Server status

Connection Status indicator on the Grid Overview page now shows both the JMX status and the state of a Data Server connection if the monitor is connected to a Data Server. The indicator will be changed to a grey color if the Data Server is being used but is not connected. Otherwise a red color indicates that the JMX connection to the Coherence cluster is not established properly. Green indicates a successful connection.

15916: Separate hosts now correctly identified in certain displays.

Previously under some configurations, separate hosts were misidentified and aggregated as a single host "localhost". This is now no longer the case, as the machines are uniquely identified.

JMX Data Access

16049: Gaps in JMX Trend Data no longer occur

Previously, under certain circumstances, gaps would appear in certain trended JMX Data. This is no longer the case

16069: Non-Authentication Remote JMX connections work again

Previously, under certain conditions, non-authenticated JMX connections may not have connected. This is no longer the case.

Navigation

16036: Navigation tree organization and accuracy improved

Previously some the navigation tree did not always correctly reflect the display that was accurate, nor was it completely consistent with the drill down options from the top-level displays. This has been addressed.

Node

14712: New option to generate unique Node Names

A new option, -idnames, can be used to start any of the Oracle Coherence Monitor applications. If started with this option, node names will be forced to be unique, even if the Member Name is not uniquely assigned.

14714: Memory/Communication Trends by Node Display added

Two new displays have been added, Memory Trends and Communication Trends. These show the memory utilization and the communication failure rate for the worst ten nodes in a trend graph over a selectable time range.

14779: Failure rates and time range selection added to Comm. Issues

Instead of showing absolute packets resent/repeated in the Communication Issues view, failure rates are now shown. Additionally, the time range selector has been enabled to show time range averages on cached data.

15440: Node Location now shown in Departed Nodes display

The Location identifier is now shown in the Cluster Stability Departed Nodes table, along with the ip address and port.

Reporting

14764: Provide button to perform a Print PDF operation

A new feature has been added to generate a PDF report consisting of several of the key displays in the Oracle Coherence Monitor application. The button labelled "Generate Report" on the Administration -> Admin Metrics display will cause the generation of a PDF report from the configuration file ts_report.xml contained in the gmsjocm.jar file. The generation of the PDF report requires a lot of memory, so it is recommended that you add "-Xmx256m" to the RTV_JAVAOPTS variable to increase the amount of memory available.

Scripts

15063: Sample RTV_JAVAOPTS and RTV_USERPATH added to myocm_setup

The myocm_setup scripts now contain commented-out sample settings of RTV_USERPATH and RTV_JAVAOPTS for users to modify as needed.

16025: Startup, shutdown, and status scripts available

New scripts are now available that start, stop or find a set (Data Server, Display Server and Historian) of OCM server processes for a specified cluster running on localhost. The tagbase portion of process tags is set to the name of the cluster property file. The scripts use new properties defined in cluster .properties files. Unix/Linux: startocm.sh propname [test] propname - cluster property file name w/o extension test - output command lines w/o execution statusocm.sh propname propname - cluster property file name w/o extension stopocm.sh propname propname - cluster property file name w/o extension Windows: startocm.bat propname [test] propname - cluster property file name w/o extension test - output command lines w/o execution Additional Support Files: Template and example files have been provided for five clusters conf/Cluster1.properties conf/Cluster2.properties conf/Cluster3.properties conf/Cluster4.properties conf/Cluster5.properties webconf/make_myocm5_wars.sh webconf/make_myocm5_wars.bat The HSQLDB provided for use with the myocm project has been enchanced with alert threshold and history tables for five clusters (Cluster1-Cluster5). It also uses a different port (3380)

16057: Bourne shell compatability fixed

Previously the following scripts would have generated errors when run under the Bourne shell . Unix_RunOCVDataServer.sh Unix_RunOCVDisplayServer_DS.sh Unix_RunOCVHistorian_DS.sh This is no longer the case.

Service

15915: LocalCacheService and its associated caches will now appear

Previously the LocalCache service did not appear as one of the available services in OCM. Now the LocalCacheService and its associated caches will appear (if any are present)

15987: Services statistics now include historical data

Historical Data is now available for the service statistics cache

 

 

 


 

RTView contains components licensed under the Apache License Version 2.0.

 

Treemap Algorithms v1.0  is used without modifications and licensed by MPL Version 1.1. Copyright © 2001 University of Maryland, College Park, MD

 

Datejs is licensed under MIT. Copyright © Coolite Inc.

 

jQuery is licensed under MIT. Copyright © John Resig,

 

JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

 

jQuery is licensed under MIT. Copyright (c) 2009 John Resig, http://jquery.com/ JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

 

JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 

SL, SL-GMS, GMS, RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2015 Sherrill-Lubinski Corporation. All Rights Reserved.