Overview

This FP provides various functional fixes for IBM Enterprise Content Management System Monitor (ESM) 5.5.5.

Requirements:

Requires at least a working installation of ESM 5.5.5.

Supersedes all previous FPs and IFs for ESM 5.5.5.

Certifications:

None.

Tip

For tips and tricks regarding the configuration and maintenance of IBM Enterprise Content Management System Monitor please check the CENIT Field Guides at IBM ESM Field Guides.

The updated documentation can be downloaded from the IBM download pages.

Installation Steps

New installation

The installer of this FP/IF cannot be used for a fresh installation.

Before

  • Check if there is an installer.properties file in the same directory where the installer binary was copied to.

    • If so, remove this file from the directory before starting the installer.

  • Proceed as described in the Install Guide of the ESM.

Server
  • Proceed as described in the Install Guide of the ESM.

  • Due to a 3rd-party limitation whitespaces in the installation path are currently not supported under Unix/Linux.

  • If you want to import e.g. the configuration from an existing server into the new server, you must upgrade the existing server to the same version as the new one.

Agent
  • Proceed as described in the Install Guide of the ESM.

  • Due to a 3rd-party limitation whitespaces in the installation path are currently not supported under Unix/Linux.

After

  • No further special actions must be taken directly after the installation has ended.

When updating an existing installation

Before updating make sure you have made a backup of your current installation.

Note

You can export your configuration and later import it again from a subtopic in the Administration view. But that import is only possible from a file exported from the same product version!

This step is necessary if you are planning to switch the storage type of the H2 database from the default MV mode the PR mode. You must then export the configuration after the update and before switching the database type.

For details, see the section about database corruptions below.

Note

Debug and logging settings like e.g. plusdebug directories will be removed by an update.

Note

If you have deployed probes that are no longer available or have been renamed, e.g. for ImageServices, it may be necessary to execute the following steps for the agents these probes were deployed to after the agent has been updated:

  1. Stop the agent.

  2. Remove the configuration database file from the agent.

  3. Restart the agent again.

The list of renamed and removed probes can be found in the readme file and the release notes document.

Before

  • It is not recommended to mix GUI based and console mode based installations. This can lead to configuration settings erroneously enclosed with double quotes, e.g. "1883" instead of plain 1883.

  • Check if there is an installer.properties file in the same directory where the installer binary was copied to.

    • If so, remove this file from the directory before starting the installer.

  • When updating from ESM 5.5.0.0 IF 3 check if there are MkfLargeRecBlocks probes configured.

    • If so, these must be removed. Deactivating alone is not sufficient.

    • The MkfLargeRecBlocks probe is only supported for IS 3.6, which is no longer supported by ESM 5.5 and newer.

    • These version restrictions were already mentioned in the product’s documentation from ESM 5.5 on.

  • When updating from ESM 5.5.0.0 IF 2 check if there are BatchIt probes configured.

    • If so, these must be removed. Deactivating alone is not sufficent.

    • After the update, the BatchIt probes have to be created again manually.

  • The encryption strength is enhanced by the 5.5.2.0 IF 1; especially between server and agent. Updating from versions older than 5.5.2.0 IF 1 will prevent a communication between the updated component, e.g. the server, and an older component, e.g. an agent. So all agents must be udpated to be able to connect to an updated server.

  • When updating from ESM 5.5.5.0 IF 3 or older check if there are Processes or ProcessInstance probes configured - these probes will be replaced by the new ProcessCount probe during update.

    • If so, check if the parameters contain specific counts for process instances and note them down.

    • After update, adjust the evaluation of these probes to reflect the required process counts. This can not be done automatically during update.

  • When updating from ESM 5.5.5.0 IF 3 or older check if there are ImageServicesServerProcesses probes configured - this probe will be removed during update.

    • If so, note down the parameters of these probes.

    • After update, create instances of the new ProcessCount probe with the parameters you noted down before. This can not be done automatically during update.

Server
  • We recommend to stop the ESM server.

  • Proceed with the update guided by the installer.

  • Due to a 3rd-party limitation whitespace in the installation path are currently not supported under Unix/Linux.

Agent
  • We recommend to stop the ESM agent.

  • Proceed with the update guided by the installer.

  • Due to a 3rd-party limitation whitespace in the installation path are currently not supported under Unix/Linux.

After

  • When updating from ESM 5.5.2.0 or older check if there are MssqlProcesses probes configured

    • If so, review the evaluation of the sample

      • the return value (message) up has been changed to value = 1

      • the return value (message) down has been changed to value = 0

      • the return value (message) remote is no longer supported; trying to use this probe for remote MSSQL instances now results in an error

  • When updating from ESM 5.5.2.0 IF 2 or older check if any Listener or ListenerForLicences probes are configured

    • If Listener probes are configured, adjust the Listener path

      • for meters, add the suffix /value to the Listener path if it is not present (Example: /RPC/ExecuteChanges/Requests In Progess must be changed to /RPC/ExecuteChanges/Requests In Progess/value)

      • for events, add the suffix /total count to the Listener path if it is not present (Example: /CPU/jvm_free_memory must be changed to /CPU/jvm_free_memory/total count)

      • check the column headings in the IBM System Dashboard for Enterprise Content Management to check which suffix must be added

    • If ListenerForLicences probes are configured, review the Application Name and Application Instance

      • the mentioned fields no longer support a list of entries

      • use * to match all application names and/or instances; alternatively, configure several instances of the ListenerForLicences probe

  • When updating from ESM 5.5.4.0 or older check if any CustomDatabaseQuery probes are configured

    • If so, you may want to review the setting of the timeout parameter of these probes because the unit of this parameter has been changed from milliseconds to seconds.

  • When updating from ESM 5.5.4.0 or older check if any LdapConnection or LdapPerformance probes are configured

    • If so, you will need to adjust the login.conf on the corresponding agents because the login module has changed. Refer to the Configuration Guide for an example of a login.conf file.

  • When updating from ESM 5.5.5.0 IF 2 or older check if there are ICC4SAPArchiveStatus probes configured.

    • If so, you will need to check the settings of the new fields Server and Port in the Icc4Sap subsystem.

    • In addition, you will need to provide the list of archives to be checked in the new field List Of Archive Names in the probe configuration.

    • For probes with authentication type Server: add the full-qualified Truststore Filename and re-enter the Truststore Password in the probe configuration.

    • For probes with authentication type Server and client: provide both the full-qualified Truststore Filename and Keystore Filename and re-enter the Truststore Password as well as the Keystore Password in the probe configuration.

    • Refer to probe description in the IBM Enterprise Content Management System Monitor Probes and Situations Guide for details.

  • When updating from a version before 5.5.5.0-003 you should add the following entry to the database clean-up configuration settings of the server in <server install dir>/karaf/etc/de.cenit.phoenix.server.dbcleanup.cfg. Add the new entry in a separate line at the end of that file:

    • cleanup.reports.per.config.remaining.count = 100

After an update it is recommended to explicitly clear the web browser’s caches to trigger a fresh update of the UI and its components. This is done by pressing the control key (CTRL) and the function key number 5 (F5) simultaneously on your keyboard while the focus is in the ESM’s browser window or tab.

Database Corruption with H2

The following is only for the server not the agent.

Note

We have reports that under some circumstances the embedded database of the server has gone corrupt beyond repair. It looks that especially the configuration database is affected by this issue.

Follow the instructions below to avoid this risk. Read them carefully and if in doubt ask your support representative for help.

Important

Before switching the database mode of the H2 database you should export the configuration to a file, from which you can later re-import it. Chaning the storage mode will wipe-out the complete content of the database. So you will need the export to be able to restore your configuration after the change was applied.

The export is made through a function in the Administration view, see the documentation for details.

Changing the storage mode is done by changing the JDBC-URL of the datasources defined in the server’s configuration org.ops4j.datasource-phoenix.cfg which can be found below <server install dir>/karaf/etc/.

Procedure

  1. Login as admin user and export the configuration.

  2. Stop the ESM server.

  3. Open the file org.ops4j.datasource-phoenix.cfg with a text editor.

  4. Search for the line defining the JDBC URL. It should start with url=jdbc:h2:.

  5. Add ;MV_STORE=FALSE to the end of the URL.

  6. The result should look like the following for the configuration database: url=jdbc:h2:./configuration;AUTO_SERVER=TRUE;AUTO_RECONNECT=TRUE;MV_STORE=FALSE

  7. Save the changed file.

  8. Restart the server.

  9. Login as admin user and import the exported configuration.

Note

Keep in mind: The database is created anew with standard settings by the first server start after the JDBC-URL has been changed. So you have to use the default password for the admin user before emporting your configuration.

Virus Scanners

We strongly advise to exclude the karaf folder of the server from virus scans and from access by other external programs that potentially can lead to file locks. This can lead to database corruption.

Microsoft Windows Server Core

ESM does not support an installation on Microsoft Windows Server Core, neither for the server nor for the agent component. You have to use an installation with the so called Desktop Experience. For details see the Microsoft webpages.

Known Limitations

Call # IBM APAR # Description

13539

-

HTTP 404 server error when selecting situations in configuration without an existing agent (agent was deleted)

Selecting a situation in the configuration that uses a probe assigned to a no longer existent agent will trigger a 404 error. Portlets and situations can still be deleted.

Solution

No workaround. A workaround is not needed for the functionality as deletion is still possible. The error message is annoying but has no further impact to the system.

13537

-

Java based probes for CPU and Memory can fail on HP-UX at first

It was reported, situations using the Cpu or Memory probes will fail to execute with unsatisfied link exceptions or class cast exceptions after the first installation of these probes. This was only reported for these probes on HP-UX.

Solution

Create a new situation with a new probe of the affected type (Cpu or Memory) or use one of the other CPU or memory probes instead.

13510

-

Detailed information for incidents not available after situation was deleted

It is possible the so called context aka detailed information about an incident is no longer accessible when the associated situation no longer exists. The UI will show an error saying "Selected Incident with id …​ is not available".

Solution

Currently there is no workaround.

12785

-

Duplicate detection has issues with very high input rates

The duplicate detection will not work reliably if the sample input rate is extremely high. This can be the case e.g. for logfiles or the MS Windows event log file. With scheduled probes this issue was not reported.

Solution

Currently there is no workaround.

12760

-

Duplicate count in portlets appears only after a second item has been suppressed

The first suppressed incident of a situation is not signalled by the counter in the portlets. The counter appears only if there are at least two suppressed incidents for that situation.

Solution

At the moment a workaround does not exists.

12759

-

The indicator for duplicate counts disappears from portlets

The duplicate counter icon at the right side of entries in the tables in portlets disappears when switching between the Monitoring and an other view e.g. Configuration and then switching back again. For the newest entry that has an active duplicate filter, the counter will reappear if the count is updated, but for older entries it is not restored.

Solution

Look into the history of the situation, it will show all suppression counters for all entries.

12159

-

On MS Windows no service installed at all if installed with no start-up after installation

Currently there will no service be created if automatic start at system start was not enabled for an installation on MS Windows. This behaviour will change in the future, so a service with start-up type "manual" will be created in that case.

Solution

Use the service installer in <install directory>/karaf/bin to create a service manually.

7774

-

start/stop/status does not work out of the box with /bin/sh on some Solaris installations

When trying to start, stop or check the status of the product, the call will fail with an error like e.g. "export KARAF_DEBUG= : is not an identifier".

The Apache Karaf scripts use /bin/sh as the shebang-path. On some Solaris installations this shell does not support one-liners like "export FOO=bar".

Solution

Replace the #!/bin/sh in the first line of the scripts below <installation dir>/karaf/bin/ by #!/bin/bash or by any other shell, that is installed on your system and that supports one-liners to export variables like "export FOO=bar".

7076

-

Wrong counter shown when closing incidents

When closing one or more incidents, the counter in the confirmation message shows the counter of all incidents regardless of yet closed incidents.

Solution

There is no workaround available.

5155

-

No NTLM authentication for HTTP probes

The following probes currently do not support NTLM authentication:

  • Http

  • WebResponseTime

  • WebStatusMonitor

Solution

No workaround exists. Probably NTLM support will never be implemented.

3814

-

GeneralDiskspace monitor does not work for NFS mounts

The GeneralDiskspace probe does not support NFS mounts at the moment.

Solution

If possible use the Diskspace probe. Beware it lacks the sophisticated features of the GeneralDiskspace probe.

Fixes and Feature list

5.5.5-001

Call # IBM APAR # Type Area Description

12898

-

Fix

Installation

The Agent did not start on HP-UX, because the karaf scripts were missing the -d64 option for the IBM Java 8 JRE.

12897

-

Fix

Monitoring

The fallback mapping is no longer skipped for multi-sample probes (e.g. WMI or CustomDatabaseQuery).

12856

-

Enh

Monitoring

The probes OnDemandPingOkay and OnDemandPingTime are now supported on Windows.

12854

-

Enh

Monitoring

The probes ElogFileExistence and ImageServicesSystemStatus have been converted to Java. The probe ImageServicesServerProcesses has been removed. Use the new ProcessCount (located under the Agent subsystem) probe instead which also replaces the Processes and ProcessInstances probe.

12813

-

Enh

Monitoring

Sharing of evaluations between different situations is now possible. This will minimise the configuration effort if identical evaluation logics are used by more than one situation.

12806

-

Enh

Monitoring

The list of incidents shown in the history (aka details view) of a situation group or a situation can now be filtered by different criteria.

12805

-

Enh

Installation

Encrypted connections for the configuration and monitoring databases are supported for IBM DB2 and MS SQL Server by the standard JDBC URL properties of these databases.

12775

-

Fix

Monitoring

Some OnDemand probes did not recognize when the logon to the OnDemand system failed and returned a sample with value 0. This has been fixed.

12765

-

Enh

Monitoring

Some cepest probes did use the password in clear text on the command line. If technically possible this was fixed. But there are some legacy probes that are still using passwords at the command line calling external programs.

12761

-

Enh

Installation

Masking of backslashes in JDBC-URLs e.g. for SQL Server, is no longer necessary. The JDBC-URL can be entered with a single backslash alone.

12735

-

Enh

Monitoring

The following Image Services probes have been removed:

  • EmptyDisksInOsar

  • ImageServicesUniversalAlphanumeric

  • ImageServicesUniversalNumeric

  • Integral_Sds_DeviceStatus

  • Integral_Sds_DeviceThresholds

  • NlsSdsDeviceStatus

  • NlsSdsDeviceThresholds

  • OsarDemandStatus

  • OsarDriveContents

  • OsarDriveInfo

  • OsarGripperConfig

  • OsarGripperContents

  • OsarGripperDisabled

  • OsarLibraryMode

  • OsarSlotContents

  • OsarSlotInfo

12686

-

Enh

Monitoring

The probes DynamicBatchRecord, ImageServicesCacheStatistic, PrintQueueStatistics, PrintQueueStatus and WorkflowQueueEntries have been converted to Java.

12685

-

Enh

Monitoring

The probes CourierStatistic and CeInfoImportAgentStatistic have been converted to Java.

12684

-

Enh

Monitoring

All Ppmoi* probes have been converted to Java. The PpmoiRdbmsLicenseLimitExceeds probe was removed, because it is no longer possible to get this information from by calling "PPMOI show".

12683

-

Enh

Monitoring

The probes DeserializeCalls, FindObjectCalls, LoggedOnUsers, RejectedUsers, ServiceLogonCalls and SoftSluViolations have been converted to Java.

12682

-

Enh

Monitoring

All MkfHits* probes have been converted to Java.

12681

-

Enh

Monitoring

All Mkf*Blocks probes have been converted to Java. All these probes now support a list of MKF DB types to check.

12680

-

Enh

Monitoring

All ImageServicesCachePercentage* and ImageServicesCacheSectors* probes have been converted to Java.

12679

-

Enh

Monitoring

The probes AllMkfDatabasesAvailable, PermanentDatabaseAvailability, SecurityDatabaseAvailability and TransientDatabaseAvailability have been merged into a single Java-based probe MkfDatabaseAvailability.

12162

-

Enh

Monitoring

New portlet for aggregation reports, see also entry for 11443.

12156

-

Enh

Monitoring

The list of agents is now sorted in two steps. First by state and then alphabetically descending by name.

12149

-

Fix

Monitoring

In the debug output of some Cepest-based HTTP probes, the password was visible in cleartext. This has been fixed.

12148

PJ46456

Enh

Installation

Cumulative security update of the IBM Java 8 JREs that are shipped with IBM ESM 5.5+ Also: The tool to migrate an IBM ESM 5.2.0.5 configuration to IBM ESM 5.5+ is removed from the product with this version.

12145

-

Enh

Monitoring

Only configurations from the same product version can be imported.

12143

-

Enh

Monitoring

The automatic base monitoring deployment on new agents can now be directly set from the UI.

12142

-

Enh

Monitoring

The OnDemandCpuUse probe is no longer supported and was removed from the product. Existing configurations are removed when installing this update.

12132

-

Fix

Monitoring

The limitation that prevent incidents to be created when a duplicate filter is fixed and no longer exists.

12113

-

Enh

Monitoring

The FileDescriptorUsage probe can no longer be used, because it is removed from the product. There were technical limitations, that made the values returned by the probe quite useless. It only showed the file descriptors used by the JVM of the agent itself.

11443

-

Enh

Monitoring

A new type of reports to create delta calculations is now available. The generated reports of this type are intended to be used in a special portlet, see entry for ID 12162.

11442

-

Enh

Monitoring

A new probe to count client connections found in the Apache HTTPd access log was implemented. It is possible to filter these connections by HTTP status codes.

11396

-

Enh

Installation

A command line tool to export the monitoring data into CSV files for later import into IBM DB2 or MS SQL Server databases exists.

Caution: This tool will be removed from the product again with one of the next releases (major or modification) or fixpacks after the upcoming one. Its sole purpose is to ease the migration for customers from H2 to IBM DB2 and MS SQL Server, which both are supported since 5.5.5.0.

11351

-

Enh

Monitoring

It is now possible to directly add a graphical portlet for a situation group to the monitoring dashboard.

9146

-

Enh

Monitoring

It is now possible to manually set the shown state of an Agent to "offline". This does not affect the agent itself, especially it does not lead to a shutdown of an agent in any way. This functionality’s sole purpose is to fix wrong status indicators for agents that are no longer accessible but could not send a status change to the server.

9088

-

Enh

Monitoring

The base monitoring is only deployed on new agents if their version matches that of the server. This change prevents configuration deployments on outdated agents.

8001

-

Enh

Monitoring

The CaseManagerCaseStatus and CaseManagerTaskStatus probes are now also capable of handling non-default solutions and are now also actively searching through sub-folders of tasks and cases.

6538

-

Enh

Cross-Cutting-Concerns

HTTP Strict Transport Security (HSTS) is now enabled in the HTTP header of the web-UI.

5071

-

Enh

Monitoring

The Icc4SapArchiveStatus probe has been switched to a pure Java implementation.

5.5.5-000-003

Call # IBM APAR # Type Area Description

12775

-

Fix

Monitoring

Some OnDemand probes did not recognize when the logon to the OnDemand system failed and returned a sample with value 0. This has been fixed.

12765

-

Fix

Monitoring

Some cepest probes did use the password in clear text on the command line. If technically possible this was fixed. But there are some legacy probes that are still using passwords at the command line calling external programs.

12162

-

Fix

Monitoring

New portlet for aggregation reports, see also entry for 11443.

12156

-

Fix

Monitoring

The list of agents is now sorted in two steps. First by state and then alphabetically descending by name.

12149

-

Fix

Monitoring

In the debug output of some Cepest-based HTTP probes, the password was visible in cleartext. This has been fixed.

12147

PJ46410

Fix

Installation

Cumulative security update of the IBM Java 8 JREs that are shipped with ESM 5.5.5.

12145

-

Fix

Monitoring

Only configurations from the same product version can be imported.

12143

-

Fix

Monitoring

The automatic base monitoring deployment on new agents can now be directly set from the UI.

12132

-

Fix

Monitoring

The limitation that prevent incidents to be created when a duplicate filter is fixed and no longer exists.

12113

-

Fix

Monitoring

The FileDescriptorUsage probe can no longer be used, because it is removed from the product. There were technical limitations, that made the values returned by the probe quite useless. It only showed the file descriptors used by the JVM of the agent itself.

11443

-

Fix

Monitoring

A new type of reports to create delta calculations is now available. The generated reports of this type are intended to be used in a special portlet, see entry for ID 12162.

11442

-

Fix

Monitoring

A new probe to count client connections found in the Apache HTTPd access log was implemented. It is possible to filter these connections by HTTP status codes.

11396

-

Fix

Installation

A command line tool to export the monitoring data into CSV files for later import into IBM DB2 or MS SQL Server databases exists.

Caution: This tool will be removed from the product again with one of the next releases (major or modification) or fixpacks after the upcoming one. Its sole purpose is to ease the migration for customers from H2 to IBM DB2 and MS SQL Server, which both are supported since 5.5.5.0.

11351

-

Fix

Monitoring

It is now possible to directly add a graphical portlet for a situation group to the monitoring dashboard.

9146

-

Fix

Monitoring

It is now possible to manually set the shown state of an Agent to "offline". This does not affect the agent itself, especially it does not lead to a shutdown of an agent in any way. This functionality’s sole purpose is to fix wrong status indicators for agents that are no longer accessible but could not send a status change to the server.

9088

-

Fix

Monitoring

The base monitoring is only deployed on new agents if their version matches that of the server. This change prevents configuration deployments on outdated agents.

6538

-

Fix

Cross-Cutting-Concerns

HTTP Strict Transport Security (HSTS) is now enabled in the HTTP header of the web-UI.

5071

-

Fix

Monitoring

The Icc4SapArchiveStatus probe has been switched to a pure Java implementation.

5.5.5-000-002

Call # IBM APAR # Type Area Description

12048

-

Fix

Monitoring

The probes ObjectsNotStoredFinally, SubscriptionRetryError, ContentSearchServicesIndexingErrors and ContentSearchServicesIndexRequests did not work for case-sensitive MSSQL databases. This has been fixed.

12003

-

Fix

Monitoring

Closing and deleting incidents from a filtered portlet works now as expected.

12002

-

Fix

Monitoring

Custom probes: It is now possible to set specific sample fields. With this the limitation of the returned value to be identical to the return code of the custom probe is also obsolete.

11988

-

Fix

Monitoring

The logic for selecting the correct Objectstore (OS) in the ObjectstorePerformance probe has been reviewed. The probe now monitors only the OS configured and does not allow a wildcard to monitor more than one OS at a time.

11970

-

Fix

Monitoring

New probe named "ObjectstoreRecoveryBinProbe". It counts the number of objects in the recovery bins in the configured object stores.

11969

-

Fix

Monitoring

The IS domain name must now be explicitly set in a new field in the IS subsystem configuration.

11968

-

Fix

Monitoring

New probe named "ObjectstoreNewObjectsProbe". It counts new objects of a specific type per day in the configured object stores.

11967

-

Fix

Monitoring

New probe named "ObjectstoreCustomQueryProbe". It executes a custom query against IBM FileNet P8 object stores and counts the returned objects.

11430

-

Fix

Installation

On some MS Windows installations instead of the integrated JRE the OS’s JRE was sometimes falsely referenced in the service start-up configuration. Now this is no longer the case.

11415

PJ46329

Fix

Installation

Cumulative security update for IBM Java 8 JRE included in the product.

11389

-

Fix

Monitoring

It is now possible to activate or deactivate all probes in all situations of a situation group.

11365

-

Fix

Monitoring

The DLL used by the WMI probes is now thread-safe, so multiple WMI probes can be executed at the same time without causing any issues.

11316

-

Fix

Cross-Cutting-Concerns

In the configuration there is now a simple context sensitive help per subsystem, probe, and task where applicable.

11313

-

Fix

Monitoring

The OnDemand probes that are based on the ODWEK API have been re-implemented as pure Java probes.

11291

-

Fix

Monitoring

It is now possible per portlet to define a fixed scaling factor for numeric values. The default is 1 (one), no scaling. Decimal values are possible to allow up and down scaling.

11270

-

Fix

Cross-Cutting-Concerns

MS SQL Server is now supported for storing configuration data.

11268

-

Fix

Cross-Cutting-Concerns

IBM DB2 is now supported for storing configuration data. Prior to this, only the monitoring data could be stored into IBM DB2.

11264

-

Fix

Cross-Cutting-Concerns

Microsoft SQL Server is now supported for storing monitoring data.

10224

-

Fix

Installation

When updating or deinstalling the product, the complete "karaf/agent" subdirectory is now saved to the "backup" directory and in case of an update restored again.

9684

-

Fix

Monitoring

Configuring more than one Windows Event Log probe for one host (agent) no longer breaks the complete monitoring of that host.

It is still not supported to have more than one Windows Event Log probe per host, because of the bookkeeping process for this type of probe. Use the filter settings in the configuration to achieve the same goal with one probe only. For details read the documentation.

9146

-

Fix

Monitoring

It is now possible to manually set the shown state of an Agent to "offline". This does not affect the agent itself, especially it does not lead to a shutdown of an agent in any way. This functionality’s sole purpose is to fix wrong status indicators for agents that are no longer accessible but could not send a status change to the server.

9103

-

Fix

Monitoring

The global sample filter editor now stays open after changes have been saved aka applied.

8064

-

Fix

Monitoring

The standard situations group named "All Situations" is no longer deletable. It cannot be renamed either.

3749

-

Fix

Tasks

A new wizard allows to edit task triggers per task in one place. This complements the existing task trigger configuration in the automation of a situation.

5.5.5-000-001

Call # IBM APAR # Type Area Description

11413

-

Fix

Monitoring

The P8 Audittrail probe no longer fails with a NullPointer-Exception if a log entry contains null values in CLOBs.

11395

-

Fix

Monitoring

It is now possible to disable the default behaviour to automatically deploy a basic monitoring to new agents. This has to be done by creating the text file <server install dir>/karaf/etc/de.cenit.phoenix.server.services.agents.AgentBasicMonitoringInitializer.cfg with the following text in one line as its only content: disable=true

11374

-

Fix

Monitoring

A memory leak in the monitoring view in combination with Firefox was fixed. But please see the related Known Limitation for restrictions, that could not be fixed for now.

9700

-

Fix

Cross-Cutting-Concerns

The sometimes observed behaviour of agents losing the connection to their server after some time is fixed.

9675

-

Fix

Cross-Cutting-Concerns

Scheduled Reports are now saved on disk in the directory "<server install dir>/karaf/server/reports/" as PDFs instead of being saved in the database.

8568

-

Fix

Monitoring

A continuously blocking task that should forward incidents no longer leads to block the sample processing.

11384

-

Fix

Administration

The dashboard settings are now also included in an export and the probes are no longer deactivated. Instead the user now must explicitly disable the probes while importing.

5.5.5

Call # IBM APAR # Type Area Description

9697

-

Enh

Monitoring

IBM JRE specific JSSE2 system properties to enable TLSv1.2 are now always set.

8592

-

Fix

Monitoring

The GeneralDiskspace probe now correctly handles continuation lines in df output.

8456

-

Enh

Monitoring

The table of subsystem references in the configuration wizard now has descriptive column headers.

8442

PJ46088

Enh

Installation

Cumulative security update for IBM Java 8 JRE included in the product.

8434

-

Enh

Monitoring

Narrower title leaves more space for information bar, which also acts as a navigational breadcrumb in views that are showing a hierarchy.

8368

-

Enh

Monitoring

It is no longer possible to define a schedule for callback probes (e.g. logfile probes). These do not need a schedule as they are triggered automatically. So the definition of a schedule has no effect et all.

8335

-

Enh

Cross-Cutting-Concerns

If HTTPS is enabled accessing the web-UI through the HTTP-URL the user will automatically redirected to the HTTPS URL.

8333

-

Enh

Cross-Cutting-Concerns

Self-monitoring: It is possible to automatically send emails if one or more agents are in the state of "timed out" and/or if one or more tasks failed to run properly (state "failed" and "canceled").

8281

-

Enh

Build-Environment

For ODM logfile monitoring the formatfile for the IBM WebSphere logfile can be used.

7964

-

Fix

Monitoring

The CMOD probes will no longer fail if the CMOD installation is not in the default directory.

7077

-

Fix

Installation

Custom v2s format files are now retained between updates of the server and the agent.

5987

-

Enh

Monitoring

All file names and domain user names can now be entered in the correct OS specific format. This means that it is no longer required to replace backslashes in file names and user names by forward slashes.

5125

-

Enh

Cross-Cutting-Concerns

An exported configuration can now be imported. The import reads a JSON file that was created through an export, see extra release notes for that feature.

5124

-

Enh

Cross-Cutting-Concerns

Export of the configuration is now possible. In this first version one can now export the configuration, without the situations and probes to a JSON file. That file can later be used for an import, see extra release notes entry for that feature.

5091

-

Enh

Monitoring

The WebResponseTime and WebStatusMonitor probes have been switched to a pure Java implementation. Please note that due to technical changes the FULL_RESPONSE_TIME option for the WebResponseTimer probe is no longer available. Probes that use this option will automatically be changed to the option TOTAL_DURATION instead. Also please note that the both probes currently don’t support NTLM authentication.

5084

-

Enh

Monitoring

The LdapConnection and LdapPerformance probes have been switched to a pure Java implementation. Please note that the login.conf for existing probes must be adjusted. Refer to the Configuration Guide for an example of a login.conf file.

5049

-

Enh

Monitoring

The CaseManagerCaseStatus, CaseManagerSolutionStatus and CaseManagerTaskStatus probes have been switched to a pure Java implementation.

4184

-

Fix

Monitoring

The CustomDatabaseQuery probe no longer ignores its timeout setting. Note that the setting is now in seconds instead of milliseconds.

3764

-

Enh

Monitoring

New agents connecting to the server the first time will get a set of probes for monitoring basic paramesters like CPU, memory, and diskspace. Existing agents will not be affected.

3752

-

Enh

Monitoring

Deep copy of subsystems is now supported. A deep copy is a copy of a subsystem populated with copies of the references of the child subsystems found in the original.

3751

-

Enh

Monitoring

Shallow copy of subsystems is now supported. A shallow copy is a copy of a subsystem populated with references of the child subsystems found in the original.

Details on features

Introduced in ESM 5.5.5-001

  • The probes OnDemandPingOkay and OnDemandPingTime are now supported on Windows.

  • The probes ElogFileExistence and ImageServicesSystemStatus have been converted to Java. The probe ImageServicesServerProcesses has been removed. Use the new ProcessCount (located under the Agent subsystem) probe instead which also replaces the Processes and ProcessInstances probe.

  • Sharing of evaluations between different situations is now possible. This will minimise the configuration effort if identical evaluation logics are used by more than one situation.

  • The list of incidents shown in the history (aka details view) of a situation group or a situation can now be filtered by different criteria.

  • Encrypted connections for the configuration and monitoring databases are supported for IBM DB2 and MS SQL Server by the standard JDBC URL properties of these databases.

  • Some cepest probes did use the password in clear text on the command line. If technically possible this was fixed. But there are some legacy probes that are still using passwords at the command line calling external programs.

  • Masking of backslashes in JDBC-URLs e.g. for SQL Server, is no longer necessary. The JDBC-URL can be entered with a single backslash alone.

  • The following Image Services probes have been removed:

    • EmptyDisksInOsar

    • ImageServicesUniversalAlphanumeric

    • ImageServicesUniversalNumeric

    • Integral_Sds_DeviceStatus

    • Integral_Sds_DeviceThresholds

    • NlsSdsDeviceStatus

    • NlsSdsDeviceThresholds

    • OsarDemandStatus

    • OsarDriveContents

    • OsarDriveInfo

    • OsarGripperConfig

    • OsarGripperContents

    • OsarGripperDisabled

    • OsarLibraryMode

    • OsarSlotContents

    • OsarSlotInfo

  • The probes DynamicBatchRecord, ImageServicesCacheStatistic, PrintQueueStatistics, PrintQueueStatus and WorkflowQueueEntries have been converted to Java.

  • The probes CourierStatistic and CeInfoImportAgentStatistic have been converted to Java.

  • All Ppmoi* probes have been converted to Java. The PpmoiRdbmsLicenseLimitExceeds probe was removed, because it is no longer possible to get this information from by calling "PPMOI show".

  • The probes DeserializeCalls, FindObjectCalls, LoggedOnUsers, RejectedUsers, ServiceLogonCalls and SoftSluViolations have been converted to Java.

  • All MkfHits* probes have been converted to Java.

  • All Mkf*Blocks probes have been converted to Java. All these probes now support a list of MKF DB types to check.

  • All ImageServicesCachePercentage* and ImageServicesCacheSectors* probes have been converted to Java.

  • The probes AllMkfDatabasesAvailable, PermanentDatabaseAvailability, SecurityDatabaseAvailability and TransientDatabaseAvailability have been merged into a single Java-based probe MkfDatabaseAvailability.

  • New portlet for aggregation reports, see also entry for 11443.

  • The list of agents is now sorted in two steps. First by state and then alphabetically descending by name.

  • Cumulative security update of the IBM Java 8 JREs that are shipped with IBM ESM 5.5+ Also: The tool to migrate an IBM ESM 5.2.0.5 configuration to IBM ESM 5.5+ is removed from the product with this version.

  • Cumulative security update of the IBM Java 8 JREs that are shipped with ESM 5.5.5.

  • Only configurations from the same product version can be imported.

  • The automatic base monitoring deployment on new agents can now be directly set from the UI.

  • The OnDemandCpuUse probe is no longer supported and was removed from the product. Existing configurations are removed when installing this update.

  • The FileDescriptorUsage probe can no longer be used, because it is removed from the product. There were technical limitations, that made the values returned by the probe quite useless. It only showed the file descriptors used by the JVM of the agent itself.

  • A new type of reports to create delta calculations is now available. The generated reports of this type are intended to be used in a special portlet, see entry for ID 12162.

  • A new probe to count client connections found in the Apache HTTPd access log was implemented. It is possible to filter these connections by HTTP status codes.

  • A command line tool to export the monitoring data into CSV files for later import into IBM DB2 or MS SQL Server databases exists.

Caution: This tool will be removed from the product again with one of the next releases (major or modification) or fixpacks after the upcoming one. Its sole purpose is to ease the migration for customers from H2 to IBM DB2 and MS SQL Server, which both are supported since 5.5.5.0. * It is now possible to directly add a graphical portlet for a situation group to the monitoring dashboard. * It is now possible to manually set the shown state of an Agent to "offline". This does not affect the agent itself, especially it does not lead to a shutdown of an agent in any way. This functionality’s sole purpose is to fix wrong status indicators for agents that are no longer accessible but could not send a status change to the server. * The base monitoring is only deployed on new agents if their version matches that of the server. This change prevents configuration deployments on outdated agents. * The CaseManagerCaseStatus and CaseManagerTaskStatus probes are now also capable of handling non-default solutions and are now also actively searching through sub-folders of tasks and cases. * HTTP Strict Transport Security (HSTS) is now enabled in the HTTP header of the web-UI. * The Icc4SapArchiveStatus probe has been switched to a pure Java implementation.

Introduced in ESM 5.5.5-000-003

ESM 5.5.5-000-003 did not introduce any new features.

Introduced in ESM 5.5.5-000-002

ESM 5.5.5-000-002 did not introduce any new features.

Introduced in ESM 5.5.5-000-001

ESM 5.5.5-000-001 did not introduce any new features.

Introduced in ESM 5.5.5

  • IBM JRE specific JSSE2 system properties to enable TLSv1.2 are now always set.

  • The table of subsystem references in the configuration wizard now has descriptive column headers.

  • Cumulative security update for IBM Java 8 JRE included in the product.

  • Narrower title leaves more space for information bar, which also acts as a navigational breadcrumb in views that are showing a hierarchy.

  • It is no longer possible to define a schedule for callback probes (e.g. logfile probes). These do not need a schedule as they are triggered automatically. So the definition of a schedule has no effect et all.

  • If HTTPS is enabled accessing the web-UI through the HTTP-URL the user will automatically redirected to the HTTPS URL.

  • Self-monitoring: It is possible to automatically send emails if one or more agents are in the state of "timed out" and/or if one or more tasks failed to run properly (state "failed" and "canceled").

  • For ODM logfile monitoring the formatfile for the IBM WebSphere logfile can be used.

  • All file names and domain user names can now be entered in the correct OS specific format. This means that it is no longer required to replace backslashes in file names and user names by forward slashes.

  • An exported configuration can now be imported. The import reads a JSON file that was created through an export, see extra release notes for that feature.

  • Export of the configuration is now possible. In this first version one can now export the configuration, without the situations and probes to a JSON file. That file can later be used for an import, see extra release notes entry for that feature.

  • The WebResponseTime and WebStatusMonitor probes have been switched to a pure Java implementation. Please note that due to technical changes the FULL_RESPONSE_TIME option for the WebResponseTimer probe is no longer available. Probes that use this option will automatically be changed to the option TOTAL_DURATION instead. Also please note that the both probes currently don’t support NTLM authentication.

  • The LdapConnection and LdapPerformance probes have been switched to a pure Java implementation. Please note that the login.conf for existing probes must be adjusted. Refer to the Configuration Guide for an example of a login.conf file.

  • The CaseManagerCaseStatus, CaseManagerSolutionStatus and CaseManagerTaskStatus probes have been switched to a pure Java implementation.

  • New agents connecting to the server the first time will get a set of probes for monitoring basic paramesters like CPU, memory, and diskspace. Existing agents will not be affected.

  • Deep copy of subsystems is now supported. A deep copy is a copy of a subsystem populated with copies of the references of the child subsystems found in the original.

  • Shallow copy of subsystems is now supported. A shallow copy is a copy of a subsystem populated with references of the child subsystems found in the original.


Created on 2021-03-30 03:19:18 UTC