======================================================================
Halcyon PrimeAlert (R) Adapter for Tivoli
Version 2.2.0
Release Notes
======================================================================
Copyright (c) 1998-2007 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: 2.2.0 2.1.0 2.0.1 2.0.0a 2.0.0 1.0.0
======================================================================
VERSION/DATE: 2.2.0/2007-11-15
ENHANCEMENTS
----------------------------------------------------------------------
- Added event management integration between Sun MC and Tivoli.
Updates in the status of a Sun MC alarm in either monitoring
framework will be reflected in the other framework. This ensures
that event records are consistent and current regardless of the
console the operator is viewing.
- Added the HALAdapterTivoli-ReverseAck.sh script which simplifies
the reverse acknowledgement process for Sun MC alarms.
- Consolidated all the previous classes of Sun MC alarms appearing
in Tivoli to one class.
- Added support for Solaris 10.
- Added support for Solaris zones.
- Improved logging functionality. The details of each successful
SNMP trap is written to a historical logfile, one per trap host.
- Log an error to the system log when $ESDIR or $PADIR are undefined.
- Added extra varbinds to the SNMP trap forwarded to Tivoli,
specifying the name of the EventAction rule that initiated adapter
script execution, and a unique identifier for each Sun MC alarm.
BUG FIXES
----------------------------------------------------------------------
- If an IP address is provided, the script now attempts to resolve it
to a hostname, as the snmptrap command cannot handle IP addresses.
- Documentation improvements.
- Fixed a bug that would cause non-default RMI ports to be parsed
incorrectly or not at all.
UPGRADE STRATEGY
----------------------------------------------------------------------
- If you have customized your HALAdapterTivoli-trap.sh or
HALAdapterTivoli-postemsg.sh scripts, you will need to update the
new version of this script with your customizations.
Halcyon Monitoring Solutions will fully support the un-customized
version of the scripts and at our discretion may attempt
to help users with customized versions.
If you have customized your scripts, take the following steps:
1. Perform a diff of the original version of the script with the
version currently installed in /var/opt/SUNWsymon/bin/HALEventAction,
and note all of your changes.
Note: If you have already run the install script and upgraded the
adapter, the previously installed version of the integration scripts
will be saved to the following files:
HALAdapterTivoli-trap.sh.before_[date]_at_[time]
HALAdapterTivoli-postemsg.sh.before_[date]_at_[time]
2. After installing the new version of the Adapter for
Tivoli, update the script appropriately with any changes you
wish to keep, and resolve any conflicts.
- The following files have been updated with new entries or have
been entirely redesigned:
HALAdapterTivoli.oid
HALAdapterTivoli.cds
HALAdapterTivoli.baroc
If TEC is updated to include the newest version of these files,
non-updated versions of the Tivoli adapter may cease to generate
events. If the Adapter for Tivoli module is updated, and the
TEC server continues to use non-updated versions of these files,
the Tivoli Adapter my also cease to generate alarms in Tivoli.
- The following file has been rendered obsolete and removed from
this distribution altogether:
HALAdapterTivoliPostemsg.baroc
It is strongly recommended that all Sun MC servers be
concurrently updated with the most recent version of the Tivoli
adapter. If this is not possible, customizations to the .cds and
.baroc files may be required to ensure all alarms are
successfully received in Tivoli.
KNOWN PROBLEMS
----------------------------------------------------------------------
- None.
======================================================================
VERSION/DATE: 2.1.0/2004-10-01
ENHANCEMENTS
----------------------------------------------------------------------
- Added a command line utility that allows the Sun MC Console to be
launched directly to a agent details window from a remote
Framework.
- Alarms sent from Sun MC alarms may now be acknowledged via an SNMP
set using any 'snmpset' command.
- Added ability to specify multiple hostnames in the script arguments.
As a result, one row in EventAction can be used to integrate with
multiple systems.
- The EventSource parameter sent to Tivoli can now be specified in
the arguments to the postemsg EventAction script. Note, using this
feature requires modifications to Tivoli's baroc file, which
Halcyon can not assist with.
BUG FIXES
----------------------------------------------------------------------
- The varbinds eventOpenTime and eventCloseTime will now report
the correct event open or close time rather than the time the
event was processed by EventAction.
UPGRADE STRATEGY
----------------------------------------------------------------------
- If you have customized your HALAdapterTivoli-trap.sh or
HALAdapterTivoli-postemsg.sh script, you will need to update
the new version of this script with your customizations.
Halcyon Monitoring Solutions will fully support the un-customized
version of the scripts and at our discretion may attempt
to help users with customized versions.
If you have customized your scripts, take the following steps:
1. Perform a diff of the original version of the script with the
version currently installed in /var/opt/SUNWsymon/bin/HALEventAction,
and note all of your changes.
Note: If you have already run the install script
and upgraded the adapter, the previously installed version of the
trap script will be saved to the file:
HALAdapterTivoli-trap.sh.before_[date]_at_[time]
HALAdapterTivoli-postemsg.sh.before_[date]_at_[time]
2. After installing the new version of the Adapter for
Tivoli, update the script appropriately with any changes you
wish to keep, and resolve any conflicts.
KNOWN PROBLEMS
----------------------------------------------------------------------
- None.
======================================================================
VERSION/DATE: 2.0.1/2004-07-09
ENHANCEMENTS
----------------------------------------------------------------------
- Added ability to specify multiple hostnames in the script arguments.
As a result, one row in EventAction can be used to integrate with
multiple systems.
- Added TEC 3.9 support.
- Added support for Sun Management Center's Agent Update feature.
BUG FIXES
----------------------------------------------------------------------
- Fix security hole which allowed the execution of arbitrary commands.
UPGRADE STRATEGY
----------------------------------------------------------------------
- The postemsg integration no longer supports the "-p" argument. As a
result, this release is not compatible with the previous version.
The following steps must be taken after the installation of this
product:
1) All rows in the PrimeAlert EventAction that use the "-p" argument
with the postemsg integration must be modified so that the "-p"
argument is no longer used.
2) The postemsg binary must be copied to:
/var/opt/SUNWsymon/bin/HALEventAction/postemsg
Optionally, you may create a symbolic link from this path to the
postemsg executable or use a wrapper script if special processing
is required.
======================================================================
VERSION/DATE: 2.0.0a/2003-07-08
ENHANCEMENTS
----------------------------------------------------------------------
- Add support for Sun MC 3.5
UPGRADE STRATEGY
----------------------------------------------------------------------
- None. This version is compatible with the previous version.
======================================================================
VERSION/DATE: 2.0.0/2003-04-04
ENHANCEMENTS
----------------------------------------------------------------------
- Add postemsg as a method of integration.
BUG FIXES
----------------------------------------------------------------------
- None.
KNOWN PROBLEMS
----------------------------------------------------------------------
- None.
UPGRADE STRATEGY
----------------------------------------------------------------------
- None. This version is compatible with the previous version.
======================================================================
VERSION/DATE: 1.0.0/2002-08-28
ENHANCEMENTS
----------------------------------------------------------------------
- None. This is the FCS release.
BUG FIXES
----------------------------------------------------------------------
- None. This is the FCS release.
KNOWN PROBLEMS
----------------------------------------------------------------------
- None.
---//---
</pre>