======================================================================
                    Halcyon Neuron Agent for Linux
                             Version 3.3.0        

                             Release Notes
======================================================================
Copyright (c) 1998-2011 Halcyon Monitoring Solutions, Inc.


Note: For the latest information on this product, go to the
      web site at http://www.HalcyonInc.com

      Refer to the README file(s) for all other information.

Versions Documented Below: 3.3.0 3.2.0 3.1.0 2.1.0a 2.1.0 2.0.0 1.1.0
                           1.0.0

======================================================================
VERSION/DATE: 3.3.0/2011-01-07

ENHANCEMENTS
----------------------------------------------------------------------
- Neuron agent can now run as either root or non-root user.

BUG FIXES
----------------------------------------------------------------------
- DirectoryMonitor will be given disk access only when the disk is
  available.

- Events are now forwarded to Halcyon Neuron Server using HTTP
  instead of MessageGateway.

- 'System Monitor (Default)' entries can now be manually removed from
  Reporter.

- Event History table and the 'Module Explorer' hierarchy are now
  both updated when events are either acknowledged or unacknowledged.

UPGRADE STRATEGY
----------------------------------------------------------------------
- To upgrade, please perform the following steps:
  1) stop the Neuron agent

  # /opt/Neuron/bin/na stop agent

  2) upgrade Neuron agent

  # HALNeuronLinux-install.sh 

  3) restart the agent

  # /opt/Neuron/bin/na start agent

- This release is compatible with the prior version.  For
  upgrades from any other older versions, please read the
  successive Upgrade Strategies in sequence.

KNOWN PROBLEMS
----------------------------------------------------------------------
- Benign EventTarget warning messages may appear in the agent log if no
  SNMP or XML targets are configured.


======================================================================
VERSION/DATE: 3.2.0/2010-05-05

ENHANCEMENTS
----------------------------------------------------------------------
- "Disabled" module events can now be forwarded to Neuron Management
  Suite as "Warning" events.

- "Down" module events can now be forwarded to Neuron Management
  Suite as "Critical" events.

- The Reporter module now uses one binary for monitoring all
  versions of sparc Solaris and one binary for monitoring all
  versions of x86 Solaris.

- The Reporter module can now monitor 64 bit Solaris processes.

- 32 bit Reporter process database files are now upgraded to 64 bit
  when Reporter is upgraded to version 3.2.0 and up.

BUG FIXES
----------------------------------------------------------------------
- Fixed occasional resending of events by PrimeAlert EventTarget. 

- Reporter module made more resilient to unexpected core dumps.

- Occasional problems sending e-mail notifications have been fixed.

- Fixed occasional irrational alarm appearing in PrimeAlert AgentHealth
  module.

- When a module is disabled then enabled, repeating "Log" events
  are no longer being forwarded to Neuron Management Suite.

- Fixed bug where Neuron Linux is not forwarding events to Neuron
  Management Suite.

- Fixed link under Neuron banner which now forwards user to the correct
  version of Neuron agent help page.

- Reporter's default http path is now set correctly.

UPGRADE STRATEGY
----------------------------------------------------------------------
- Uninstall the following patch file before upgrading:

      PADIR/cfg/base-sendmail.tcl

  ..where PADIR is typically /var/opt/Neuron/.

- This release is compatible with the prior version.  For
  upgrades from any other older versions, please read the
  successive Upgrade Strategies in sequence.

KNOWN PROBLEMS
----------------------------------------------------------------------
- Benign EventTarget warning messages may appear in the agent log if no
  SNMP or XML targets are configured.

- Answering "Whole Root Zone" when running the install in a Sparse
  Root Zone will result in errors and warnings during the installation
  of product packages.  Either choose an PAROOT/install directory
  that is not shared, or follow the "Adding Sparse Root Zone Support"
  instructions in the README.install.

- The PrimeAlert SystemMonitor module could not collect IPC Facilities
  statistics on a Solaris 10 system.


======================================================================
VERSION/DATE: 3.1.0/2009-08-18

ENHANCEMENTS
----------------------------------------------------------------------
- The Neuron Agent's performance data as gathered by Reporter can
  now be extracted by Halcyon's Neuron Core.

- If the Neuron Agent's EventTarget is configurated to send Neuron
  Agent events/alarms to Halcyon's Neuron Core, the Neuron Core
  will keep track of the Agent as an asset.  By doing this, all
  such agents can be accessed from a single central Agent Viewer
  from within Halcyon's Neuron Management Portal (part of the
  Halcyon Neuron Core).

  Please note that the term "Neuron" no longer refers just to this
  Agent product.


UPGRADE STRATEGY
----------------------------------------------------------------------
- All prior Neuron Agent patches have been integrated into
  this version, and thus must be uninstalled.  Please read the
  uninstallation instructions that came with each patch.

  For your convenience a utility can be found in the product
  tarball's "util" subdirectory which will remove the latest
  patches.  Its output indicates which patches it is looking
  for and whether it has found them.

- Any product customizations provided by Halcyon (not to be
  confused with user alarm scripts or actions) may need to
  be updated.  Please contact Halcyon Support if you have
  any such customizations.

  For your convenience, a utility to discover customizations
  can be found in the product tarball's "util" subdirectory.

- This release is compatible with the prior version.  For
  upgrades from any other older versions, please read the
  successive Upgrade Strategies in sequence.


KNOWN PROBLEMS:
----------------------------------------------------------------------
- Benign EventTarget warning messages may appear in the agent log if no
  SNMP or XML targets are configured.

- Answering "Whole Root Zone" when running the install in a Sparse
  Root Zone will result in errors and warnings during the installation
  of product packages.  Either choose an PAROOT/install directory
  that is not shared, or follow the "Adding Sparse Root Zone Support"
  instructions in the README.install.

- The PrimeAlert SystemMonitor module could not collect IPC Facilities
  statistics on a Solaris 10 system.



======================================================================
VERSION/DATE: 3.0.0/2009-05-15


ENHANCEMENTS
----------------------------------------------------------------------
- Added the Neuron Portal, a module that can centrally track the
  availability and status of other Neuron Agents, monitored objects,
  and pingable hosts.

- The Neuron Agent's EventTarget now has the ability to send Neuron
  Agent events/alarms to Halcyon's Neuron Core. This enables events
  to be viewed and managed centrally, and easily allows forwarding
  and filtering to 3rd party Enterprise Management Frameworks using
  the Halcyon Neuron Integration product.

  Please note that the term "Neuron" no longer refers just to this
  Agent product.


BUG FIXES
----------------------------------------------------------------------
- Fixed occasional errors in IPC statistics.

- Fixed problems discovered with "CPU Usage" of PrimeAlert 
  SystemMonitor and enhanced the definitions/calculations used in the
  "Physical Memory" section of PrimeAlert SystemMonitor module.

- Fixed occasional problems with "Filesystem Usage" section of
  PrimeAlert SystemMonitor module. 

- Fixed an occasional Neuron agent memory growth condition.

- Fixed occasional problems with the text of the alarm close event
  traps sent from Neuron.

- Fixed occasional event message translation failures that result in
  dropped notifications.

- A problem was fixed where file scanning operations would miss lines
  written to a logfile when the log was being written to at a
  very high rate.  Note that this problem did not affect PrimeAlert
  LogFileMonitor, only certain other modules or features that used
  the specific affected subsystem.  This includes PrimeAlert Hardware
  Monitor and PrimeAlert EventGateway (used to receive traps from
  other devices or systems).

- Fixed the problem where long module instance names would affect the
  functionality of certain modules.

- Agent startup more resilient to errors in circular logfiles.


UPGRADE STRATEGY
----------------------------------------------------------------------
- All prior Neuron Agent patches have been integrated into
  this version, and thus must be uninstalled.  Please read the
  uninstallation instructions that came with each patch.

  For your convenience a utility can be found in the product
  tarball's "util" subdirectory which will remove the latest
  patches.  Its output indicates which patches it is looking
  for and whether it has found them.

- Any product customizations provided by Halcyon (not to be
  confused with user alarm scripts or actions) may need to
  be updated.  Please contact Halcyon Support if you have
  any such customizations.

  For your convenience, a utility to discover customizations
  can be found in the product tarball's "util" subdirectory.

- This release is compatible with the prior version.  For
  upgrades from any other older versions, please read the
  successive Upgrade Strategies in sequence.


KNOWN PROBLEMS
---------------------------------------------------------------------
- Benign EventTarget warning messages may appear in the agent log if no
  SNMP or XML targets are configured.



======================================================================
VERSION/DATE: 2.1.0a/2008-01-09

BUG FIXES
----------------------------------------------------------------------
- Fixed occasional install error.  No upgrade is necessary.


======================================================================
VERSION/DATE: 2.1.0/2006-04-18


ENHANCEMENTS
----------------------------------------------------------------------
- None.


BUG FIXES
----------------------------------------------------------------------
- Fixed Red Hat Linux Enterprise 64 bit installation issue.

- Filesystems with long names will no longer cause data acquisition
  errors.


UPGRADE STRATEGY
----------------------------------------------------------------------
- None.  This release is compatible with the previous version.



======================================================================
VERSION/DATE: 2.0.0/2006-03-28


ENHANCEMENTS
----------------------------------------------------------------------
- Added capability to sort tables based on alarm severity, field
  name and field values.

- The interface will automatically update after a management operation
  has been performed.

- Single button to update the navigation and details frames.

- Color coded links for more clarity.

- User interface improvements:

   1) Default size of Attribute Editor window is larger

   2) Hierarchy frame is resizable

   3) Hierarchy content does not wrap making it easier to identify
      navigation folders

   4) Multiple graphs can be viewed at the same time from separate
      windows.
    
   5) Improved color scheme for clarity.

- Added capability to monitor dynamic filenames that change over time
  using PrimeAlert FileSizeMonitor.

- Added capability to specify the alarm severity within PrimeAlert
  FileSizeMonitor for a file that does not exist.

- The data file for a module will not be removed when a module is
  unloaded.

- Added the capability to specify custom messages and custom data
  for use with Agent Based Alarm Actions.  See the Agent Based Alarm
  Actions section of the html documentation for more details.

- Users may specify action script overrides in $PADIR/bin.

- Added physical memory usage statistics.

- Added automatic reporting for the following properties:

  1) 5 Minute Load Avg
  2) Percent Disk Used
  3) CPU - Percent Average Usage
  4) Percent Swap Used
  5) Percent Physical Memory Used

- Enhanced security so that action commands can only be executed
  from $PADIR/bin.  In addition, these commands must be owned and
  executable by root and not contain any special characters that
  may be interpreted by the shell.  An error will be written to
  the agent.log if an action does not meet the required criteria.

- Added capability to configure email notification during install.


NOTES
----------------------------------------------------------------------
- The default HTTP and SNMP ports have been changed to 6680 and 6681
  respectively. 

- Changed PAROOT and PADIR to /opt/Neuron and /var/opt/Neuron
  respectively.

- The start script has been renamed from 'pa' to 'na'.


BUG FIXES
----------------------------------------------------------------------
- Filesystem usage section reported 'nan' for the Space Used (%)
  column for system specific filesystems.  These filesytems are no 
  longer reported on.

- The status message and correct alarm severity will be included in
  all transition states of an alarm.

- The open time for an alarm has been corrected.

- Module load parameters containing dashes will be presented properly
  in the web interface.

- The timestamps for alarms will be reported using the timezone of
  the agent rather than GMT.

UPGRADE STRATEGY
----------------------------------------------------------------------
- This release is NOT compatible with the previous version.  To
  perform a proper upgrade, please take the following steps:

  1) Stop the previous version of Neuron

     # /opt/PrimeAlert/bin/pa stop agent

  2) Uninstall the previous version of Neuron

     # cd /var/opt/PrimeAlert/uninstall

     # ./HALUninstall.sh

  3) Copy the previous configuration to the new directory

     # mv /var/opt/PrimeAlert /var/opt/Neuron

  4) Install the current version of Neuron.  See the README.install
     file for more details.


======================================================================
VERSION/DATE: 1.1.0/2005-11-07


ENHANCEMENTS
----------------------------------------------------------------------
- Added capability to specify custom alarm messages.

- Documentation enhancements.


BUG FIXES
----------------------------------------------------------------------
- Fixed broken links in the documentation.

- Miscellaneous bug fixes.


UPGRADE STRATEGY
----------------------------------------------------------------------
- None.  This release is compatible with the previous version.


-----------------------------------------------------------------------
VERSION/DATE: 1.0.0/2004-11-15

BUG FIXES:

None.

ENHANCEMENTS:

None.


KNOWN PROBLEMS:

None.

---//---