Foglight 5.9.2 Release Notes Revision 1
Release Notes Revision 1
Foglight 5.9.2 Release Notes Revision 1 is a re-release of the Foglight 5.9.2 Release Notes with the following change:
Welcome to Foglight
Resolved issues and enhancements
Third party known issues
Upgrade and compatibility
Getting started with Foglight
Welcome to Foglight
Quest's Foglight® solution simplifies application performance monitoring and reduces the skills and effort required to manage applications, the user experience, and the supporting infrastructure.
Unlike other solutions, Foglight uses a single code base, and has a model-driven design that couples fast deployment and accelerated time-to-value. It offers the modular flexibility required to deliver a range of capabilities and sophistication to meet the needs of any organization—from those still focused on technology-centric monitoring to those that have completed the transition to application-centric or transactional monitoring.
Foglight performs equally well in physical, virtual, and mixed infrastructure environments, providing visibility into issues affecting the application and end-user experience. Intuitive workflows help you quickly move from the symptom to the root cause in the application, database, infrastructure, or network to resolve issues, reducing mean time to resolution. Predefined and drag-and-drop dashboards provide insight that is tailored to each stakeholder. By offering comprehensive visibility into your monitored environment, Foglight helps ensure that cross-functional teams collaborate on and prioritize issues that matter most to the business.
These Release Notes cover the resolved issues, known issues, workarounds, and other important information about the 5.9.2 release of Foglight. Review all sections before starting the installation.
The Foglight 5.9.x code line has dropped JBoss Server 4.2.3, which includes the following changes:
- Remove JBoss dependency in HA and Federation environments.
- Remove JBoss bootstrap, the SAR file deployment, and other unknown deployment types.
- Use Narayana as the transaction manager and use MBean server provided by JDK.
- Change the deployment type to WAR, and add the support for converting the JBoss Artifacts deployment type to the WAR deployment.
- Remove the jboss-web.xml file. Remove org.jboss and its sub namespace package classes. Only a few of .jar files have been kept and worked as third party libraries.
As a result of JBoss removal, the Foglight 5.9.x code line includes a number of critical changes which require particular attention for customers upgrading from a 5.7.x version. Specifically, three primary functional capabilities (server side data handling, Federation, High Availability) that used legacy JBoss components in versions prior to 5.9.x have been re-written to improve Foglight Management Server security. This has the following specific impacts on customers upgrading from a 5.7.x version.
- Foglight Management Servers must be upgraded to version 126.96.36.199 before they can upgrade to the 5.9.x code line. If the Foglight Management Server is below 188.8.131.52, the installer will fail and display the appropriate error message.
- All Quest or Quest partner delivered cartridges that have a dependency on the changed components in the data submission handler must be upgraded prior to upgrading to the 5.9.x code line. A complete list of cartridges is available in the Foglight Upgrade Guide. If there are incompatible Quest or Quest partner delivered cartridges, the installer will fail and display the appropriate error message.
- Other custom cartridges may have a dependency on the server side data handling component that has changed. A pre-upgrade analysis tool has been developed to identify any custom cartridges that might need change.
- Before upgrading to 5.9.x, Quest recommends you create a Management Server Support Bundle to facilitate future communications with support regarding upgrade failures.
- There are new configuration requirements for customer running High Availability (HA) or Federation. The details are covered in sections specific to HA and Federation in the Foglight Upgrade Guide.
As a result of these changes, it is critical that all customers review the upgrade instructions in detail. Customers are encouraged to contact support with questions or concerns.
The 5.9.2 release of the Foglight Management Server contains the following new features:
- Added the capability of configuring audit log for REST API requests. (FGL-19524)
- Added the support to interface with REST APIs by using Auth-Token. With the help of this new approach, the Management Server can acquire the access of REST API directly, without an additional login operation. (FGL-19488)
- Disabled Run Script API by default for the sake of safety. (FGL-19468)
- Added a new runNamedScript API (GET). (FGL-19449)
- Removed the All System Changes chart from the Alarms dashboard. (WCF-15977)
- Added the Blackouts tab on the Alarms dashboard. (FGL-19532)
- Agent Status
- Removed Start data collection and Stop data collection buttons from the Administration > Agents > Agent Status dashboard. (FGL-19534)
- Updated the Licenses table on the Administration > Setup > Manage Licenses dashboard, to show Capacity, Usage, and Unit information. (WCF-15949)
- Added a new Proxy Configuration dashboard under Administration > Setup. This dashboard is used to enable, disable, and configure proxy connections. (FGL-19571)
- In the Run Report wizard, collapsed all templates in the Templates By Module tab by default. (FGL-19496)
Rules & Alarms
- Added Critical and Fatal severities for Catalyst Database Latency Check rule. (FGL-19552)
- Added the capability for showing notifications that require customers' further actions across the top of the screen. (FGL-19498)
- Added the capability for validating a rule before importing and deploying this rule. (FGL-19401)
- Added the capability for customizing email messages for alarms under Service Builder. (FGL-19254)
- Added the support of SUSE Linux Enterprise Server 12 SP3.
Third party libraries
- Upgraded embedded PostgreSQL to version 9.4.15. (FGL-19591)
- Upgraded Tomcat to version 7.0.82. (FGL-19555)
- Upgraded Struts 2 libs to version 2.3.34. (FGL-19484)
- Upgraded JVM JDK to version 1.8.0_144. (FGL-19455)
- Upgraded Groovy to version 2.4.12. (FGL-19388)
- Upgraded commons-beanutils to version 1.9.3. (FGL-19388)
- Upgraded JavaMail to version 1.6.0. (FGL-19388)
Installation & Upgrade
- A new PhoneHomeClient cartridge is added into the Foglight Management Server installer, which builds up the communication between Data Protection SaaS Portal and Foglight Management Server. With the help of this PhoneHomeClient cartridge, the Portal provides visibility into the availability of Foglight, issues with data collection, a view of active alarms and license usage management. (FGL-19509)
- Improved the installer to provide the location of the installer log when errors are encountered during installation. (FGL-19476)
- Added the capability for detecting obsolete JVM options in server.config during upgrade. (FGL-19301)
- Added the support to automatically assign a group to new AD Kerberos SSO users. (FGL-19535)
- Added a new Add this to Standard View function for custom dashboards and reports on the Actions > General bar. (WCF-16002)
- Added the support of circle indicators for Map Topology.
Foglight Agent Manager
The Foglight Agent Manager (FglAM) was upgraded to version 5.9.2. For more information about the Foglight Agent Manager 5.9.2, refer to the Foglight Agent Manager 5.9.2 Release Notes.
The Infrastructure cartridge was upgraded to version 5.9.2. For more information about the Foglight for Infrastructure 5.9.2, refer to the Foglight for Infrastructure 5.9.2 Release Notes.
New in the 5.9.1 release
The 5.9.1 release of the Foglight Management Server contains the following new features:
- As a result of JBoss removal, redesigned the Federation implementation based on Spring remote call.
- Used Spring remote call over RMI, to replace JBoss remote call used in the Federation environment previously.
- Added the support of SSL communication between Federation Master and Children.
- Added the support of authentication through certificates between Federation Master and Children.
- Triggered the sync process for all topology objects from MBean to avoid incomplete synchronization. (FGL-19321)
- Removed the previous security token configuration, as the authentication through certificates is now being used in the Federation environment. (FGL-19217)
- Provided a more concise procedure to generate Keystores for both Federation Master and Children.
- To improve the synchronization performance in the Federation environment, only the modified topology objects will be synchronized between the Federation Master and children. (FGL-19120/FGL-18967)
High Availability (HA)
- As a result of JBoss removal, redesigned the HA implementation based on JGroups. (FGL-18829)
- Use the standalone JGroups library to support HA.
- Provided the secured communication between nodes using secretKey. (FGL-18983)
- Auth-Token has been replaced with Access-Token in this 5.9.1 release, but Auth-Token is still supported. Quest recommends that you change to use Access-Token as the request header for REST APIs. (FGL-19352)
- Added the customization support for publishing REST APIs. (FGL-18989)
- Added a new pushData API (POST) to push data into the Management Server. (FGL-18876)
- Added a new pushAlarm API (POST) to push alarms into the Management Server. (FGL-18875)
IPv6 support (Preview)
- Added the support of IPv6 protocol on the Management Server, Foglight Agent Manager, and Infrastructure cartridge. (FREQ-837)
Note: Only link-local address is verified and supported on the Management Server. For more information about platforms supported by the Foglight Agent Manager, refer to the Foglight Agent Manager 5.9.1 Release Notes.
- Management Server Configuration
- Removed JBoss related ports from the Ports table on the Administration > Support Bundles > Management Server Configuration dashboard. (FGL-18958)
- Removed ORB ports from the server.config file. (FGL-18997)
- Removed ORB (IIOP) and ORB (IIOP) SSL information from the Ports table on the Administration > Support Bundles > Management Server Configuration dashboard. (WCF-15909)
- Added a new Import New Language For PDF option on the Administration > Support Bundles > Management Server Configuration dashboard. (WCF-15881)
- Email Configuration
- Added the StorageAdministrator and OpenStackAdminInvalidated variables in the Email Routing table on the Email Configuration dashboard. (WCF-15797)
- Added the capability to export a custom report as the .csv file. (FREQ-981)
- Added the support of SUSE Linux Enterprise Server 12 SP2. (FGL-19209)
Third party libraries
- Upgraded HttpClient to version 4.x. (FGL-18536)
- Upgraded Spring Core to version 4.3.5. (FGL-17712)
Foglight Agent Manager
The Foglight Agent Manager (FglAM) was upgraded to version 5.9.1. For more information about the Foglight Agent Manager 5.9.1, refer to the Foglight Agent Manager 5.9.1 Release Notes.
The Infrastructure cartridge was upgraded to version 5.9.1. For more information about the Foglight for Infrastructure 5.9.1, refer to the Foglight for Infrastructure 5.9.1 Release Notes.