The
This section summarizes the new features in this release.
The
When an email notification is generated in Audit, the body of the email now includes a URL allowing only authorized users to access the event details, including parameters on the event.
Engage adapters can now define the security policies they require.
This section provides information about fixes and improvements made to the
The following issues are fixed in Engage Platform 5.4.8:
Node promoted to MASTER immediately fails. (PFM-7821)
When keepalived periodically runs the check-db-status script, that script will recheck the node state again before returning a failure result. If the state is different than when the script first checked, it now returns a success result to mitigate the race conditions described in this ticket.
Restoring a backup from Platform-5.2 to a Platform-5.3 or above appliance breaks the clustering functionality. (PFM-7276)
Removed the option to restore postgres configuration from the restore-backups page. Workaround: When restoring a backup on platform 5.3 from platform 5.2, leave the postgresql.conf restore option unchecked.
Backup script fails if Mirth is removed but a remaining mirth_restore database is still present. (PFM-7191)
Detection of a valid Mirth database will no longer be misled by the existence of another database owned by the mirth db role. Remove old Mirth databases (i.e., mirth_previous, mirth_restore). Workaround: Edit the file '/opt/EXTENSION/lib/migration/dataset_importer.rb' and add "require 'dataset_cache'" to the top of the file.
CSV Data Import fails without reference to DatasetCache (PFM-7186)
The ei_import_dataset script will not fail when provided with a proper csv. DatasetCache is now included in the script.
Changing the net mask of the virtual IP in a clustered environment fails to remove the existing virtual IP when keepalived is reloaded. (PFM-7110)
Upstream changes have been implemented to fix clearing of VIP on reload. Workaround: Remove the old VIP from the command line, using the following command.
'sudo ip addr del <ipaddress>/<cidr> dev bond0'
When using an LDAP integration, any users that were created prior to the LDAP, whether imported or manually created, will be able to login with both the old and the new AD passwords. (PFM-6499)
The system will now detect LDAP users and prevent login using local credentials.
Automatic backups are no longer scheduled as a chron job. (PFM-7800)
The create-cronjob script has been updated to fall back and create a systemd timer instead.
Purge of backup files in a secondary standalone appliance is now working as designed. (PFM-7914)
The "purge-backups.enable" file is now being created for the secondary appliance. The write-automatic-backups-config script was updated to check if local backups are enabled or if appliance type = secondary.
Automatic backups no longer become disabled during a platform 5.2 to 5.3 upgrade. (PFM-7793)
The migration of cron job to systemd timer has been fixed. During the process where the system migrates the cron jobs to systemd timers, a file is created to be used as a semaphore to indicate the timer is set up; this file is now created with the correct name.
This section provides information about known product defects and limitations in the current release.
Exporting the solution package fails on certain configurations.
Package export can fail with a Page Not Found error due to a rule involving the MassAlerts dataset. (PFM-6205)
Attribute transformation RegEx cannot distinguish the appendage of a string literal of a number right after the RegEx attribute. (PFM-7216)
No known workaround.
Audit Log reports an exception if the appliance time is set for far future (i.e., + 10 years) and then reverted back to the current time. (PFM-6250)
Workaround: Remove and recreate the current audit database schema by executing the following commands:
sudo -u extension psql -p 5433 -c "DROP SCHEMA public cascade;" audit sudo -u extension psql -p 5433 -c "CREATE SCHEMA public;" audit sudo -u extension psql -p 5433 -c "CREATE extension hstore;" audit
Redeploy the ei-audit.jar (it may take several minutes until the audit database is restored to a functional state):
sudo su extension; touch /opt/glassfish/glassfish/domains/extension/autodeploy/bundles/ei-audit.jar
The XMPP Certificate Manager is empty. (PFM-6127)
Workaround: Make sure the adapter is running, refresh the adapter page, and wait for the XMPP Certificate Manager to display.
When adding new trusted certificates for adapters, GlassFish must be restarted. (PFM-5949)
Workaround: Obtain certificate chain, upload via Security > Certificates, and restart GlassFish.
Removing Mirth also removes extension-install and extension-support-keys packages. (PFM-4499)
Workaround: Do not remove Mirth if not using it; disable the service. If Mirth is removed, reinstall the extension-support-keys and extension-install packages.
Datasets created from new adapters fail to save and deactivate the "Save" button. (PFM-1942)
Workaround: Create the required datasets before configuring the adapters.
GlassFish locks up during Felix deployment of JTAPI libraries. (PFM-1882)
Workaround: Avoid unnecessary configuration changes to the adapters in production deployments. If a configuration change is necessary, schedule a maintenance window with the customer anticipating that a GlassFish restart may be required to return the server to an operating state.
Clinical alarms can be delayed depending on how recipients are computed. (PFM-985)
Workaround: Add the following filters followed by a vacuum analyze:
Handler queues do not start up within 5 minutes of rebooting appliance. (PFM-459)
Workaround: Wait for Adapter Services to display the correct status.
SNMP Community name does not support special characters, "$",“%”, “/”, “\”: (PFM-303)
Workaround: First enter the community string without the special character from the SNMP tab.
Login into system vi CLI, then:
cd /etc/snmp cp snmpd.conf snmpd.conf.orig vi snmpd.conf
Edit the configuration adding the special characters, e.g.:
rocommunity Solarwind$ default -V eiView trapcommunity Solarwind$ trap2sink 10.159.77.225 Solarwind$ 162
Restart the SNMP daemon:
sudo /etc/init.d/snmpd restart
Large workflow queries can cause OutOfMemory errors, and GlassFish to become unresponsive. (PFM-273)
Workaround: Follow proper change control methods when configuring new workflows.
If a CSV file contains an "id" column, the sequence for the table will be left out of sync, resulting in an error in Audit Log with stack trace containing "ERROR duplicate value violates unique constraint" after completing a CSV import. (PFM-266)
Workaround: If the CSV file contained an "id" column, it will cause the table serial sequence to get out of sync until the sequence catches up to the last CSV ID imported. Do not include the "id" column when importing CSV files.
During import of ResponderSync adapter, clicking the button allows adapter creation without mandatory fields. The error message "Staff Assignment Service URL undefined already used in another configuration." is displayed if the ResponderSync adapter is not configured correctly. (PFM-263)
Workaround: The ideal workaround is to re-image the appliance or VM to begin a fresh import action, and avoiding the issue during the configuration of the ResponderSync adapter.
Alternate: It is possible to salvage the current work from the import using the following steps:
Cloning rules may take a significant amount of time with no visual indicator to the user. This may lead the user to attempt the clone several times and cause unexpected results, i.e., clones of clones. (PFM-242)
Workaround: After clicking the button to clone the rules, wait until the clone finishes completely before clicking the button again.