HEAD
Foglight® Agent Manager 6.3.0 Development Kit
Released with Foglight Management Server 6.3.0
Release Notes
April 2023
Resolved issues and enhancements
Getting started with the Foglight Agent Manager Development Kit
Foglight® solution simplifies application performance
monitoring and reduces the skills and effort required to manage applications,
the user experience, and the supporting infrastructure. Foglight® Agent Manager
6.3.0 Development Kit Released
with Foglight Management Server 6.3.0 Release Notes April 2023 Resolved issues and enhancements Getting started with the Foglight
Agent Manager Development Kit Foglight® solution simplifies application performance
monitoring and reduces the skills and effort required to manage applications,
the user experience, and the supporting infrastructure. 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. Foglight agents require the Foglight Agent Manager (FglAM) to manage their
life-cycles and centralize communications with the Foglight Management Server. The Agent Manager Development Kit enables developers to
create and manage custom Foglight agents. These Release Notes cover the resolved issues, known issues, workarounds, and
other important information about the 6.3.0 release of the Agent
Manager Development Kit. Review all sections before starting the installation. For information about issues resolved in the Agent Manager
6.3.0 release, see the
Foglight Agent
Manager 6.3.0 Release Notes. Version 6.3 of Foglight contains the following new features and updates:
=======
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. Foglight agents require the Foglight Agent Manager (FglAM) to manage their life-cycles and centralize communications with the Foglight Management Server. The Agent Manager Development Kit enables developers to create and manage custom Foglight agents. These Release Notes cover the resolved issues, known issues, workarounds, and other important information about the 6.3.0 release of the Agent Manager Development Kit. Review all sections before starting the installation. For information about issues resolved in the Agent Manager
6.3.0 release, see the
Foglight Agent
Manager 6.3.0 Release Notes. Version 6.3 of Foglight contains the following new features and updates:
>>>>>>> 2a2d6e02e7bdbeeb32fd1ca375b3860006871983
Note: The FglAM 32-bit platforms are no longer supported as of FglAM
6.0.0. The following is a list of issues addressed and enhancements implemented in this Foglight Agent Manager release. Defect ID Resolved Issue FOG-2998 HA peers turn into STANDALONE after server restarts due to force
termination of server process or DB connection issue FOG-974,FOG-1682, FOG-3372, FOG-3373 Updated Foglight Management Server and Agent Manager JRE to
version 1.8.0_322 FOG-3037 Update Solaris JRE for FglAM to use OpenJDK distribution The following is a list of issues known to exist at the time of this release. Defect ID Resolved Issue The init-agent-manifest-props macro
=======
The following is a list of issues addressed and enhancements implemented in this Foglight Agent Manager release. Defect ID Resolved Issue FOG-2998 HA peers turn into STANDALONE after server restarts due to force termination of server process or DB connection issue FOG-974,FOG-1682, FOG-3372, FOG-3373 Updated Foglight Management Server and Agent Manager JRE to version 1.8.0_322 FOG-3037 Update Solaris JRE for FglAM to use OpenJDK distribution The following is a list of issues known to exist at the time of this release. Defect ID Resolved Issue The init-agent-manifest-props macro
>>>>>>> 2a2d6e02e7bdbeeb32fd1ca375b3860006871983
in fglam-ant-macros fails if the
manifest file uses a namespace prefix, because the
<xmlproperty> tag creates variables
with the namespace prefix in the name. Defect ID Resolved Issue FAM-4697 The Agent harness shows topology property updates multiple times in
message trees. FAM-4494 A verified submission status is never updated. FAM-4492 First verified submission is always lost. FAM-4261 The Agent harness reports the following error on debug level 1:
java.lang.IndexOutOfBoundsException: Index: 10, Size: 10 FAM-3908 A NullPointerException is thrown
while an agent instance created by the
AgentControlService is displayed under the Agent Type node in the
tree. FAM-3880 Adding additional agent instances of the same type can cause a null
pointer exception as a result of a call to the
JTree.updateUI(). FAM-3879 The ASP string editor in the Agent harness interprets "\n" as a new line. FAM-3775 Setting a label on an enum type
property in the agent-definition.xml can cause a fatal error. FAM-3774 The Agent harness cannot write some configuration files to the state directory. FAM-3563 A core dump occurs while generating a heap dump from the Agent
Harness menu on a Red Hat Enterprise Linux 6.x OS virtual machine. Defect ID Resolved Issue FAM-4787 An old agent running with a newer cartridge on the Management Server
with an updated and incompatible ASP schema causes a
NullPointerException in the agent's generated property wrappers. FAM-4180 Up-to-date check for topology wrappers is invalid. FAM-4133 TopologyValidator should ignore
user-defined topology types that are only referenced from dynamic
properties. FAM-3751 Core properties of a topology type that is a subtype of the
TopologyObject type are being
overridden. This release of the Foglight Agent Manager Development Kit does not include
any third party known issues. The 6.3.x Foglight Agent Manager cartridge requires Foglight Management
Server 5.9.2 or later. The cartridge is compatible with all previously
released versions of the Agent Manager client application. Agent Manager upgrades from a 5.5.4.x legacy
=======
Defect ID Resolved Issue FAM-4697 The Agent harness shows topology property updates multiple times in message trees. FAM-4494 A verified submission status is never updated. FAM-4492 First verified submission is always lost. FAM-4261 The Agent harness reports the following error on debug level 1:
java.lang.IndexOutOfBoundsException: Index: 10, Size: 10 FAM-3908 A NullPointerException is thrown
while an agent instance created by the
AgentControlService is displayed under the Agent Type node in the
tree. FAM-3880 Adding additional agent instances of the same type can cause a null
pointer exception as a result of a call to the
JTree.updateUI(). FAM-3879 The ASP string editor in the Agent harness interprets "\n" as a new line. FAM-3775 Setting a label on an enum type
property in the agent-definition.xml can cause a fatal error. FAM-3774 The Agent harness cannot write some configuration files to the state directory. FAM-3563 A core dump occurs while generating a heap dump from the Agent Harness menu on a Red Hat Enterprise Linux 6.x OS virtual machine. Defect ID Resolved Issue FAM-4787 An old agent running with a newer cartridge on the Management Server with an updated and incompatible ASP schema causes a NullPointerException in the agent's generated property wrappers. FAM-4180 Up-to-date check for topology wrappers is invalid. FAM-4133 TopologyValidator should ignore
user-defined topology types that are only referenced from dynamic
properties. FAM-3751 Core properties of a topology type that is a subtype of the
TopologyObject type are being
overridden. This release of the Foglight Agent Manager Development Kit does not include any third party known issues. The 6.3.x Foglight Agent Manager cartridge requires Foglight Management
Server 5.9.2 or later. The cartridge is compatible with all previously
released versions of the Agent Manager client application. Agent Manager upgrades from a 5.5.4.x legacy
>>>>>>> 2a2d6e02e7bdbeeb32fd1ca375b3860006871983
release require an intermediary upgrade to 5.6.7 prior to upgrading to 5.8.5 or
later. To complete this intermediary upgrade, install one or more of the Agent
Manager 5.6.7 platform-specific cartridges (as required), and upgrade the legacy
hosts to this release before deploying the 6.3.x
Agent Manager cartridge or
upgrading the Foglight Management Server to version
6.3. After all of
the legacy hosts are running version 5.6.7, and the Foglight Management Server
is upgraded to version 5.9.2 or later, you can start upgrading your hosts to
version 6.3.x. For more information about upgrading the Management Server and the Agent
Manager, see the Foglight Upgrade Guide. The following operating system is not supported as of version
5.9.8: For detailed information about system requirements, see the
System Requirements and Platform Support Guide. Foglight includes a licensing capability that restricts access to those
features that are defined in the license. All Management Server installations
require a license that grants access to server-specific parts of the browser
interface and the features associated with them. Foglight cartridges are also
license-protected. While some cartridges are covered by the base Foglight
license (such as Foglight Agent Manager cartridges and the Cartridge for
Infrastructure), others may require an additional license. Foglight
Infrastructure Utilities are covered by the base Foglight license. To activate a trial or a purchased commercial license: The Agent Manager Development Kit is packaged with the Foglight Agent Manager
and released with Foglight Management Server. For information about what is included in the Foglight
=======
For more information about upgrading the Management Server and the Agent
Manager, see the Foglight Upgrade Guide. The following operating system is not supported as of version
5.9.8: For detailed information about system requirements, see the
System Requirements and Platform Support Guide. Foglight includes a licensing capability that restricts access to those features that are defined in the license. All Management Server installations require a license that grants access to server-specific parts of the browser interface and the features
associated with them. Foglight cartridges are also license-protected. While some cartridges are covered by the base Foglight license (such as Foglight Agent Manager cartridges and the Cartridge for Infrastructure), others may require an additional
license. Foglight Infrastructure Utilities are covered by the base Foglight license. To activate a trial or a purchased commercial license: The Agent Manager Development Kit is packaged with the Foglight Agent Manager and released with Foglight Management Server. For information about what is included in the Foglight
>>>>>>> 2a2d6e02e7bdbeeb32fd1ca375b3860006871983
6.3 release package,
see the
Foglight Release Notes.
Refer to the
Foglight Agent Manager Guide
for installation instructions. Additional information is available from the following: This section contains information about installing and operating this product
in non-English configurations, such as those needed by customers outside of
North America. This section does not replace the materials about supported
platforms and configurations found elsewhere in the product documentation. This release is Unicode-enabled and supports any character set. In this
release, all product components should be configured to use the same or
compatible character encodings and should be installed to use the same locale
and regional options. This release is targeted to support operations in the
following regions: North America, Western Europe, and Latin America, Central and
Eastern Europe, Far-East Asia, Japan. This release has the following known capabilities or limitations: The
Management Server and Agent Manager client will be enabled for Global Operations, but not localized to any
particular locale. Legacy Foglight 4 agents will continue to be limited to the
locales supported under Foglight 4. Consult the Global Operations statement for
each agent to determine its own capabilities and limitations. The Agent Manager currently
requires installation in a directory path with only ASCII characters. Quest creates software solutions that make the benefits
=======
Refer to the
Foglight Agent Manager Guide
for installation instructions. Additional information is available from the following: This section contains information about installing and operating this product in non-English configurations, such as those needed by customers outside of North America. This section does not replace the materials about supported platforms and configurations
found elsewhere in the product documentation. This release is Unicode-enabled and supports any character set. In this release, all product components should be configured to use the same or compatible character encodings and should be installed to use the same locale and regional options. This
release is targeted to support operations in the following regions: North America, Western Europe, and Latin America, Central and Eastern Europe, Far-East Asia, Japan. This release has the following known capabilities or limitations: The Management Server and Agent Manager client will be enabled for Global Operations, but not localized to any particular locale. Legacy Foglight 4 agents will continue to be limited
to the locales supported under Foglight 4. Consult the Global Operations statement for each agent to determine its own capabilities and limitations. The Agent Manager currently requires installation in a directory path with only ASCII characters. Quest creates software solutions that make the benefits
>>>>>>> 2a2d6e02e7bdbeeb32fd1ca375b3860006871983
of new technology real in an increasingly complex IT landscape. From database
and systems management, to Active Directory and Office 365 management, and cyber
security resilience, Quest helps customers solve their next IT challenge now.
Around the globe, more than 130,000 companies and 95% of the Fortune 500 count
on Quest to deliver proactive management and monitoring for the next enterprise
initiative, find the next solution for complex Microsoft challenges and stay
ahead of the next threat. Quest Software. Where next meets now. For more
<<<<<<< HEAD
information, visit
https://www.quest.com/.
Technical support is available to Quest customers
with a valid maintenance contract and customers who have trial versions. You can
access the Quest Support Portal at
https://support.quest.com.
The Support Portal provides self-help tools you
can use to solve problems quickly and independently, 24 hours a day, 365 days a
year. The Support Portal enables you to:
Quest, the Quest logo, Foglight, and Where next meets
now are trademarks
and registered trademarks of Quest Software Inc. in the U.S.A. and other
countries. For a complete list of Quest Software trademarks, please visit our
website at
www.quest.com/legal. Red Hat, JBoss, the JBoss logo, and Red Hat Enterprise
=======
information, visit
https://www.quest.com/.
Technical support is available to Quest customers
with a valid maintenance contract and customers who have trial versions. You can
access the Quest Support Portal at
https://support.quest.com.
The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hours a day, 365 days a year. The Support Portal enables you to:
Quest, the Quest logo, Foglight, and Where next meets
now are trademarks
and registered trademarks of Quest Software Inc. in the U.S.A. and other
countries. For a complete list of Quest Software trademarks, please visit our
website at
www.quest.com/legal. Red Hat, JBoss, the JBoss logo, and Red Hat Enterprise
>>>>>>> 2a2d6e02e7bdbeeb32fd1ca375b3860006871983
Linux are registered trademarks of Red Hat, Inc. in the U.S. and other countries.
CentOS is a trademark of Red Hat, Inc. in the U.S. and other countries.
Fedora and the Infinity design logo are trademarks of Red Hat, Inc.
Microsoft, .NET, Active Directory, Internet
Explorer, Hyper-V, Office 365, SharePoint, Silverlight,SQL Server, Visual Basic,
Windows, Windows Vista and Windows Server are either registered trademarks or
trademarks of Microsoft Corporation in the United States and/or other countries.
AIX, IBM, PowerPC, PowerVM, and WebSphere are trademarks of International
Business Machines Corporation, registered in many jurisdictions worldwide. Java,
Oracle, Oracle Solaris, PeopleSoft, Siebel, Sun, WebLogic, and ZFS are
trademarks or registered trademarks of Oracle and/or its affiliates in the
United States and other countries. SPARC is a registered trademark of SPARC
International, Inc. in the United States and other countries. Products bearing
the SPARC trademarks are based on an architecture developed by Oracle
Corporation. OpenLDAP is a registered trademark of the OpenLDAP Foundation. HP
is a registered trademark that belongs to HewlettPackard Development Company,
L.P. Linux is a registered trademark of Linus Torvalds in the United States,
other countries, or both. MySQL is a registered trademark of MySQL AB in the
United States, the European Union and other countries. Novell and eDirectory are
registered trademarks of Novell, Inc., in the United States and other countries.
VMware, ESX, ESXi, vSphere, vCenter, vMotion, and vCloud Director are registered
trademarks or trademarks of VMware, Inc. in the United States and/or other
jurisdictions. Sybase is a registered trademark of Sybase, Inc. The X Window
System and UNIX are registered trademarks of The Open Group. Mozilla and Firefox
are registered trademarks of the Mozilla Foundation. IOS is a registered
trademark or trademark of Cisco Systems, Inc. and/or its affiliates in the
United States and certain other countries. Apple, iPad, iPhone, Mac OS, Safari,
Swift, and Xcode are trademarks of Apple Inc., registered in the U.S. and other
countries. Ubuntu is a registered trademark of Canonical Ltd. Symantec and
Veritas are trademarks or registered trademarks of Symantec Corporation or its
affiliates in the U.S. and other countries. OpenSUSE, SUSE, and YAST are
registered trademarks of SUSE LCC in the United States and other countries.
Citrix, AppFlow, NetScaler, XenApp, and XenDesktop are trademarks of Citrix
Systems, Inc. and/or one or more of its subsidiaries, and may be registered in
the United States Patent and Trademark Office and in other countries. PostgreSQL
is a registered trademark of the PostgreSQL Global Development Group. MariaDB is
a trademark or registered trademark of MariaDB Corporation Ab in the European
Union and United States of America and/or other countries. Intel, Itanium,
Pentium, and Xeon are trademarks of Intel Corporation in the U.S. and/or other
countries. Debian is a registered trademark of Software in the Public Interest,
Inc. OpenStack is a trademark of the OpenStack Foundation. Amazon Web Services,
the "Powered by Amazon Web Services" logo, and "Amazon RDS" are trademarks of
Amazon.com, Inc. or its affiliates in the United States and/or other countries.
Infobright, Infobright Community Edition and Infobright Enterprise Edition are
trademarks of Infobright Inc. POLYCOM®, RealPresence® Collaboration
Server, and RMX® are registered trademarks of Polycom, Inc. All other marks and
names mentioned herein may be trademarks of their respective companies.
Unlike other
=======
Contents
Welcome to Foglight
Unlike other
>>>>>>> 2a2d6e02e7bdbeeb32fd1ca375b3860006871983
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 Agent Manager Development Kit
New in this release
Foglight Agent Manager Development Kit
New in this release
Resolved issues and enhancements
Known issues
Development Kit core
FAM-292
Resolved issues and enhancements
Known issues
Development Kit core
FAM-292
Agent harness
Tooling
Third party known issues
Upgrade and compatibility
Agent harness
Tooling
Third party known issues
Upgrade and compatibility
System requirements
Final platform support notice
Product licensing
Getting started with the Foglight Agent Manager
Development Kit
Contents of the release package
System requirements
Final platform support notice
Product licensing
Getting started with the Foglight Agent Manager
Development Kit
Contents of the release package
Installation instructions
Additional resources
Globalization
About Us
Installation instructions
Additional resources
Globalization
About Us
Technical support resources
Copyright© 2023 Quest Software Inc.
Technical support resources
Copyright© 2023 Quest Software Inc.