======================================================================
               Halcyon PrimeAlert (R) for Sun Web Server
                           Version 2.1.0
 
                           Release Notes
======================================================================
Copyright (c) 1998-2008 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.1.0e 2.1.0b 2.1.0a 2.1.0 1.0.2 1.0.1a
                           1.0.1  1.0.0


======================================================================
VERSION/DATE: 2.1.0e/2008-05-02


ENHANCEMENTS
----------------------------------------------------------------------
- Added support for Sun MC 4.0.

- Improved logfile analyzer performance.

- Module supports access log rotation by scanning the access log and 
  all archived access logs for web server traffic.

- Module supports local timezone changes by only analyzing access logs 
  before and after a timezone change.  During a timezone change, 
  logfile analysis is temporarily halted. 

- Both monthly and daily virtual domain traffic are now reported. 

- SUN's webserver performance statistics file can now be entered as a
  module load parameter.  Thus, the performance statistics file can 
  be set to any arbitrary filename.

- Virtual domain traffic is now computed only when at least one 
  virtual domain is being monitored.  That is, at least one row on
  the "Current Month" table is enabled.

- Dropped support for Solaris 2.6 and 2.7.


BUG FIXES
----------------------------------------------------------------------
- Module was reporting incorrect server traffic for a given 
  virtual hostname due to incorrect string matching.  Module now 
  reports correct server traffic.

- Replaced the term "Monitored URL Host" with the term 
  "Virtual Server ID".

- Prevented irrational alarms from appearing at module load time.

- For "Current Month" table, the term "Identifier" was replaced 
  with the term "Description". 


UPGRADE STRATEGY
----------------------------------------------------------------------
- If PrimeAlert for Sun Web Server version 2.1.0b was previously
  installed, please follow the steps below for upgrading to version
  2.1.0e.

  1) If necessary, update 'Virtual Server ID' values in the
     'Current Month' table to match virtual server identifers
     logged on the server's access log.

  2) Install PrimeAlert for Sun Web Server version 2.1.0e.

  3) Stop the agent.

  4) Delete all files under:
     [ESDIR]/log/https-[Web Server Instance]_[Module Instance]

     where ESDIR is /var/opt/SUNWsymon for a SUN MC agent
     and   ESDIR is /var/opt/Neuron    for a Neuron agent (usually)

  5) Start the agent.


KNOWN PROBLEMS
----------------------------------------------------------------------
- Problem:
  Sun Manager Center 3.6 and up is experiencing problems serving help
  files from the server layer.

  Workaround:
  Please refer to Troubleshooting for a workaround to this problem.


- Problem:
  Some folders are empty or cannot be opened when selecting data
  properties for use with Sun Management Center Performance Reporting
  Manager or Group Operations

  Workaround:
  See the FAQ for details on how to work around this issue.


- Problem:
  If the module has been loaded with an incorrect "Web Server
  Installation Path" and/or an incorrect "Web Server Instance", then
  the mistake is corrected, the "Processes" and "Space Monitoring"
  folders will not properly update with the correct parameters.
  The "Logfiles" folder will update correctly and is not affected by
  this issue.

  Workaround:
  Reload the module with correct parameters


NOTES
----------------------------------------------------------------------
- Server traffic results are only accurate up to the module's last
  refresh operation.  That is, current web server traffic is not
  reported until a module refresh operation occurs.

- Performing a web server access log rotation before a module refresh
  operation may cause inaccuracies in server traffic results.
  If possible, perform web server access log rotation after a module
  refresh operation.

- The module ignores records which have the exact same timestamp as
  the last record processed during the last refresh operation.  That
  is, the module is configured to ignore out of sequence records.

- Partial server traffic results are stored in the agent's log
  directory.  These files are not deleted by the module when it is
  deactivated since historical server traffic would be lost.

- Zero server traffic may be reported initially when the time required
  for analyzing the web server log file is greater than the console
  refresh time interval.  This may occur when the size of the web
  server log file is greater than 1 GB.




======================================================================
VERSION/DATE: 2.1.0b/2006-12-18


ENHANCEMENTS
----------------------------------------------------------------------
- Added web server access log rotation support.


BUG FIXES
----------------------------------------------------------------------
- Same as version 2.1.0a (please see below).


UPGRADE STRATEGY
----------------------------------------------------------------------
- Same as version 2.1.0a (please see below).


KNOWN PROBLEMS
----------------------------------------------------------------------
- Same as version 1.0.2 (please see below).


NOTES
----------------------------------------------------------------------
- Server traffic results are only accurate up to the module's last 
  refresh operation.  That is, current web server traffic is not   
  reported until a module refresh operation occurs.

- Performing a web server access log rotation before a module refresh 
  operation may cause inaccuracies in server traffic results. 
  If possible, perform web server access log rotation after a module
  refresh operation.

- The module ignores records which have the exact same timestamp as 
  the last record processed during the last refresh operation.  That 
  is, the module is configured to ignore out of sequence records. 

- Partial server traffic results are stored in the agent's log  
  directory.  These files are not deleted by the module when it is 
  deactivated since historical server traffic would be lost. 

- Zero server traffic may be reported initially when the time required 
  for analyzing the web server log file is greater than the console 
  refresh time interval.  This may occur when the size of the web  
  server log file is greater than 1 GB.


======================================================================
VERSION/DATE: 2.1.0a/2006-11-10


ENHANCEMENTS
----------------------------------------------------------------------
- Server traffic is now monitored by URL Host (virtual domain) name
  not by directory name.


BUG FIXES
----------------------------------------------------------------------
- Same as version 2.1.0 (please see below).


UPGRADE STRATEGY
----------------------------------------------------------------------
- Same as version 2.1.0 (please see below).


KNOWN PROBLEMS
----------------------------------------------------------------------
- Same as version 2.1.0 (please see below).


======================================================================
VERSION/DATE: 2.1.0/2006-07-26


ENHANCEMENTS
----------------------------------------------------------------------
- Added server traffic monitoring support.

- Added Sun Management Center 3.6.1 support.

- Added x86/x64 Solaris support.

- Added Solaris 10 support.

- Added PrimeAlert Neuron support.

- Help documentation update.

- Help files now served from the Sun Management Center server
  layer.

- Added Agent Update support.


BUG FIXES
----------------------------------------------------------------------
- Improved SNMP availability test by eliminating full SNMP walk.


NOTES:
----------------------------------------------------------------------
- Removal of iPlanet Web Server 4.1 support.


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


KNOWN PROBLEMS
----------------------------------------------------------------------
- Problem:
  The rows in the "Current Month" do not refresh right away.

  This is a known issue. Please refer to the TroubleShooting notes for
  a workaround to this problem. 

- Problem:
  There is zero traffic reported in the "Current Month" folder for a 
  given directory.

  This is a known issue. Please refer to the TroubleShooting notes for
  a workaround to this problem. 

- Problem:
  Sun Manager Center 3.6 is experiencing problems serving help files
  from the server layer. Please refer to Troubleshooting for a
  workaround to this problem.

- Problem:
  The rows in the "Processes" and "Space Monitoring" folders contain
  incorrect parameters.

  This is a known issue.  The module was initially loaded with either 
  an incorrect "Web Server Installation Path" or an incorrect 
  "Web Server Instance" and then reloaded with the corrected load 
  parameter. The "Processes" and "Space Monitoring" folders
  will not update correctly.  The "Log File" folder will update
  correctly and is not affected by this issue.

  Workaround:
  Manually change the rows in the affected folders.

- Problem:
  HALiWS module uses The Webalizer for web server logfile analysis, but
  The Webalizer reports at most 133 characters per line.  Thus, a  
  Monitored Directory name can be at most about 100 characters long.

  Workaround:
  This is a known limitation of The Webalizer.  Halcyon recommends
  Monitored Directory names are not longer than 100 characters.


======================================================================
VERSION/DATE: 1.0.2/2004-04-30


ENHANCEMENTS
----------------------------------------------------------------------
- Added Sun Java System Web Server version 6.1 support.

- Added Web Server availability test.


BUG FIXES
----------------------------------------------------------------------
- The Overview section will not have negative rates when the Web 
  Server is restarted.

- Changes to the default rows in the Processes, Logfiles and Space
  Monitoring sections are persistent across agent restarts.


NOTES:
----------------------------------------------------------------------
- Module has been renamed to "PrimeAlert for Sun Web Server" from 
  "PrimeAlert for Sun ONE Web Server".


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


KNOWN PROBLEMS
----------------------------------------------------------------------
- Sun Manager Center 3.6 is experiencing problems serving help files
from the server layer. Please refer to Troubleshooting for a
workaround to this problem.


======================================================================
VERSION/DATE: 1.0.1a/2003-07-16


ENHANCEMENTS
----------------------------------------------------------------------
- Added Sun MC 3.5 support.


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



======================================================================
VERSION/DATE: 1.0.1/2002-10-12


ENHANCEMENTS
----------------------------------------------------------------------
- Solaris 9 support.

- Support for Sun Management Center Performance Reporting Manager.

- Support for Sun Management Center Group Operations.

- Support for Sun ONE Web Server 6.0


BUG FIXES
----------------------------------------------------------------------
- Module is available in the Module Specification picklist in the
  Filters tab of PrimeAlert EventAction.

- Documentation upgrades.


NOTES:
----------------------------------------------------------------------
- Removal of Solaris 2.5.1 support.

- Removal of Sun Management Center 2.x support.


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


KNOWN PROBLEMS
----------------------------------------------------------------------
- Problem:
  When monitoring multiple Web Server instances, Sun ONE Web Server
  will only provide SNMP data for one of the instances.

  Workaround:
  None

- Problem:
  Some folders are empty or cannot be opened when selecting data
  properties for use with Sun Management Center Performance Reporting
  Manager or Group Operations

  Workaround:
  See the FAQ for details on how to work around this issue.

- Deployment of Module Configuration Parcels using Group Operations
  fails without any errors

  Workaround:
  Load module manually on each agent.

- Problem:
  If the module has been loaded with an incorrect "Sun ONE Web Server
  Installation Path" and/or an incorrect "Web Server Instance", and
  the mistake is corrected, the "Logfiles" folder will not properly
  update with the correct parameters. The "Processes" and "Space
  Monitoring" folders will update correctly and are not affected by
  this issue.

  Workaround: 
  Reload the module with correct parameters

- Problem:
  When multiple versions of Sun ONE Web Server are being monitored on 
  the same system, the SNMP Agent Status field may have an incorrect 
  value.
 
  Workaround:
  None

======================================================================
VERSION/DATE: 1.0.0/2002-06-24


ENHANCEMENTS
----------------------------------------------------------------------
- None.  This is the First Customer Shipment (FCS) release.


BUG FIXES
----------------------------------------------------------------------
- None.  This is the First Customer Shipment (FCS) release.


KNOWN PROBLEMS
----------------------------------------------------------------------
- Problem:
  If the module has been loaded with an incorrect "iPlanet Web Server
  Installation Path" and/or an incorrect "Web Server Instance", then
  the mistake is corrected, the "Logfiles" folder will not properly
  update with the correct parameters. The "Processes" and "Space
  Monitoring" folders will update correctly and are not affected by
  this issue.

  Workaround: 
  Reload the module with correct parameters

---//---