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:
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
andPort
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-qualifiedTruststore Filename
and re-enter theTruststore Password
in the probe configuration. -
For probes with authentication type
Server and client
: provide both the full-qualifiedTruststore Filename
andKeystore Filename
and re-enter theTruststore Password
as well as theKeystore 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
-
Login as admin user and export the configuration.
-
Stop the ESM server.
-
Open the file
org.ops4j.datasource-phoenix.cfg
with a text editor. -
Search for the line defining the JDBC URL. It should start with
url=jdbc:h2:
. -
Add
;MV_STORE=FALSE
to the end of the URL. -
The result should look like the following for the configuration database:
url=jdbc:h2:./configuration;AUTO_SERVER=TRUE;AUTO_RECONNECT=TRUE;MV_STORE=FALSE
-
Save the changed file.
-
Restart the server.
-
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:
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:
|
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