###################################################################### # EFA 3.0.0.9 RELEASE NOTES ###################################################################### # Copyright (C) 2015-2016 https://efa-project.org # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . ####################################################################### Welcome to EFA Version 3.0.0.9! Many thanks goes to the developers of EFA and maintainers of all 3rd party packages! These release notes will help guide you through the 3.0.0.9 update. Many fixes and enhancements have been made to EFA. Please review the CHANGELOG for further information. https://raw.githubusercontent.com/E-F-A/v3/3.0.0.9/CHANGELOG ###################### How To Update ################################## It is recommended that you suspend your mail flow and snapshot prior to updating or to back up the entire appliance. 1) Stop mail flow temporarily (at firewalls/mailservers) 2) Snapshot your VM and its memory using your hypervisor tools 3) If the update fails for any reason, immediately roll back to snapshot 4) Report failure at https://forum.efa-project.org sudo /usr/local/sbin/EFA-Update -check sudo /usr/local/sbin/EFA-Update -update The first time you run this update, the kernel may update. If this happens, the script will halt to give you an opportunity to restart. After restarting and booting to the new kernel, rerun EFA-Update to continue the update process to 3.0.0.9. EFA-Update will not proceed until you are running on the latest kernel. This is to ensure that open-vm-tools updates appropriately if present. After updating, please run "Update GeoIP Database" update as soon as possible from MailWatch under Tools/Links. ####################################################################### ################ Important Info -- Custom Tweaks ###################### Many EFA users have modified their EFA installations and made tweaks that may "disappear" after an update to 3.0.0.9. Updated files have been automatically backed up to the following location: /var/EFA/backup/ (Other versions may be present if updating from an older version) You may need to re-implement customizations after update to 3.0.0.9 For example, if you are using Active Directory integration, this will need to be turned back on (see MailWatch Changes below) ###################### Perl Module Cleanup ############################ Redundant perl modules in /usr/local /usr/lib64/perl5 and /usr/share/perl5 that are superceded with RPMs are removed in this update. As a precaution, these locations are backed up to /var/EFA/backup/3.0.0.9 as tarballs of each branch. If you are missing perl modules after updating, you can find them here, or, preferably, you can reinstall the missing modules. ####################################################################### ###################### HTTPS Enabled by Default ####################### HTTPS is now enabled by this update. You will receive a certificate error if you have not updated SSL/TLS certificates on EFA. Please update your certificates at /etc/pki/certs/localhost.crt and /etc/pki/private/localhost.key with your own versions, if needed. ####################################################################### ################### New Feature -- EFA-Monitor ######################## EFA Monitor is a new feature in 3.0.0.9. EFA Monitor checks for critical services running every minute via cron and attempts to restart them if they are not running. By default, 3 attempts are made before giving up for the day. When performing maintenance tasks that require stopping services, disable the cron from running. sudo /usr/local/sbin/EFA-Configure Choose option 15 to enable and disable maintenance mode ####################################################################### ###################### New Feature -- Munin ########################### Munin is now included in EFA. A link to Munin can be found in MailWatch under Tools. Munin provides details stats and graphs for various parts of the EFA system beyond the simple mail statistics graphs. Note that HTTPS should be enabled to access Munin, and DNS must be set up properly in your environment for EFA. ####################################################################### ########################## Known Issues ############################### 1) If you are running commercial VMware-Tools, open-vm-tools may install itself after updating to 3.0.0.9. Reapply VMware-Tools after updating to 3.0.0.9. Run the following command to remove open-vm-tools: sudo rpm -e open-vm-tools 2) Error, "could not search" when logging into MailWatch after updating to 3.0.0.9 This occurs when Active Directory integration is enabled. Check /var/www/html/mailscanner/conf.php Change the following line to 'mail' from 'proxyaddresses', if needed... define('LDAP_EMAIL_FIELD', 'proxyaddresses'); Change the following define('LDAP_MS_AD_COMPATIBILITY', true); 3) EFA-Update hanging at end of update (logsave not exiting) This is a known issue. This is usually caused from processes that spawned off of the script and have not closed. You can kill the logsave process (Ctrl+C if running interactively) ####################################################################### ########################## Reporting Issues ########################### Please visit https://forum.efa-project.org and report bugs under the 3.x Bugs forum. #######################################################################