SurgeSuppressor 3.0

SurgeSuppressor

Last Updated: 02/10/2023

The ECG team is pleased to announce the release version 3.1.1 of SurgeSuppressor.

This version includes support for the R22, R23, and R24 versions of the BroadWorks API.

The complete list of changes is at the bottom of this page.

Upgrading from a previous version of SurgeSuppressor involves a large number of changes. Please refer to the installation details.

Fixed SNMP dependency incompatibilities.
Fixed issue where the installer tried to set the ownership of the lib directory to a user that doesn't exist.

Fixed issue with handling of users with Personal VM Settings. Addresses 'Interesting record did not match logic block. Unexpected error.'

Updated password handling to generate passwords for accounts rather than passing provided values to SurgeMail. This is necessary due to changes within R22.
SurgeSuppressor will now wait when encountering connection issues until they are resolved before continuing to process logs.
The configuration has been centralized inside the spring configuration file.
The installation layout has been updated.
- Configuration is now located at /etc/surge-suppressor
- Logs are now location at /var/log/surge-suppressor
- Application files are still at /opt/surge-suppressor
Combined the USERID and PATTERN creation modes into a single mode called PRESCRIBED.

Added BroadWorks Connection retry. If SurgeSuppressor boots up and there is no connection to BroadWorks or SurgeSuppressor loses connection while running it will attempt to reconnect based on an Exponential Backup up to 100 attempts.
Added BroadWorks Connection failure SNMP notification.

Added control of e-mail address generation. This can now be configured to three options.
- USERID - This is the original mode that enforces e-mail addresses and usernames to have the BroadWorks UserID.
- PATTERN - This allows the specification of a pattern that uses the UserID value. The pattern is configurable.
- PERMISSIVE - This generates the email address as specified by the provisioner. This is unsafe and should only be used if the other options are unavailable.

Now built using Java 1.8.
Now uses the SurgeMail REST API to perform modifications rather than the TellMail command-line utility.
Logging now uses Log4j2 for configuration.
The configuration is now written in JSON using the ECG properties library.
Now uses ECG integrated licensing.
SNMP traps now include more detailed text for error messages.