SiteProtector 3.0 Update - README
=====================================================================
Last modified: November 11th, 2013
Copyright © 1994-2013 Internet Security Systems, Inc. All rights 
reserved worldwide.

PLEASE READ THIS DOCUMENT IN ITS ENTIRETY.


=====================================================================
CONTENTS
=====================================================================

- Description
- Compatibility
- Applying the Update
- Getting the latest Documentation
- Customer Support
- Reporting product issues
- Files included with The Update


DESCRIPTION 
=====================================================================

This is a Cumulative SiteProtector.jar Patch.  Please see the list
of issues covered below.

Cumulative Patch -- 11/11/2013
=========================================

	SP Workitem 46284 / APAR IV51914
	------------------------------
	When performing a CSV export on a detail analysis view, 
	you may experience an error while exporting the file.

	The following error will appear in the logs when this happens:
		ERROR net.iss.gui.table.export.ExportAction:96   - An error occurred while exporting the file.
		java.lang.NullPointerException
		at net.iss.gui.table.export.CSVExporter.getCellText(CSVExporter.java:90)
		at net.iss.gui.table.export.CSVExporter.export(CSVExporter.java:44)

	The affected audience is anyone attempting to perform a CSV export on a 
	detail analysis view with empty IP Location data.

	This update allows an adjustment to the output of the
	IP Location columns that allows them to be properly outputted
	when they otherwise contain no data.


	SP Workitem 46584 / APAR IV51923
	------------------------------
	When creating certain kinds of reports it may be possible
	to get an error while entering the report parameters, 
	especially if you have a large number of different assets.

	The following error will appear in the Console logs when this happens:
		ERROR net.iss.gui.ParentModalDialog:87   - Comparison method violates its general contract!
		java.lang.IllegalArgumentException: Comparison method violates its general contract!
		at java.util.TimSort.mergeHi(TimSort.java:868)

	The affected audience can be anyone attempting to edit report 
	parameters for certain kinds of reports with a large number of 
	varied assets.

	This update makes a change to how we sort asset information
	to allow better sorting and prevent this from occurring.


	SP Workitem 42913 / APAR IV51937 
	------------------------------
	When saving a view with event details, you may not be 
	able to save the order of your detail columns.

	The audience affected is anyone attempting to save Detail 
	analysis views with reordered detail columns.

	This update makes several changes to how analysis
	views are exported to allow the order of exported
	detail columns to be saved.


=========================================

To resolve this, follow the steps to replace files
in the APPLYING THE UPDATE section carefully. 
Be sure to read any notes on individual fixes.

MD5 for the files included in this update:

- 3059b0eea08c0d67164632a39c3ea3a9	SiteProtector.jar
		
Build Number: 3.0.0.0.519


COMPATIBILITY
=====================================================================
This update is applicable only to:
- SiteProtector 3.0.0.0


APPLYING THE UPDATE
=====================================================================
To apply the update:

Step  0 - Ensure your SiteProtector Core version is 3.0.0.0 
	(displays as 3.0 with no other numbers).

Step  1 - Close out all SiteProtector consoles.

Step  2 - On the Application Server, stop the three 
	SiteProtector services:

	SiteProtector Application Server Service
	SiteProtector Sensor Controller Service
	SiteProtector Web Server

Step  3 - Put the SiteProtector.jar file in the following 
	location on all Consoles.  Be sure to backup the 
	original files first.

	\Program Files\ISS\SiteProtector\Console\bin\

Step  4 - Put the SiteProtector.jar file in the following
	locations on the Application Server.  Be sure to backup 
	the original files first.
	Warning: Never place back up files in the deployment directories.

	\Program Files\ISS\SiteProtector\Application Server\bin\ 
	\Program Files\ISS\SiteProtector\Application Server\deployed-apps\iss\SiteProtector.ear\lib\

Step  5 - On the Application Server, start the three 
	SiteProtector services back up:

	SiteProtector Application Server Service
	SiteProtector Sensor Controller Service
	SiteProtector Web Server

Note: When backing up files it is recommended to use a directory 
that's separate from the SiteProtector directory structure.

If you feel the need to remove the patch at a later date, the original 
files can be restored using the same process.


GETTING THE LATEST DOCUMENTATION
=====================================================================
For the latest version of the SiteProtector Readme file, go to the IBM Security download center:
https://webapp.iss.net/myiss/login.jsp?action=download

For the latest version of the product documentation, go to the IBM Security Product Information Center:
http://publib.boulder.ibm.com/infocenter/sprotect/v2r8m0/index.jsp

CONTACT IBM SUPPORT WORLDWIDE
=====================================================================
IBM Security offers a variety of contact options. To view these options, please visit the IBM Support Portal:
http://www.ibm.com/support/entry/portal


INFORMATION REQUIRED FOR REPORTING PRODUCT ISSUES
=====================================================================
If you encounter a problem with this product, please make notes that
are as detailed as possible about the following:

 - Component and Build versions
 - Specific failure symptoms or undesirable behavior

This information helps us reproduce the problem and resolve it as
quickly as possible. 



FILES INCLUDED
=====================================================================
- SiteProtector.jar		
=====================================================================
=====================================================================