FlowPort SP2 Patch Release Notes: SPAR706516240Patch_2_1_3_63.jar and DocuShare.jar ( fp213p07 ) 
For SPAR706516240Patch_2_1_3_63.jar and DocuShare.jar release version 2.1.3.63.39 
Released On November 21, 2002 
Release Notes updated on November 26, 2002 

For the latest FlowPort information, the customer can access the FlowPort Support web site at: 
http://www.xerox.com/flowport/support 

I. Overview 
This file, fp213p07.exe , contains 3 files : DocuShare.jar , SPAR706516240Patch_2_1_3_63.jar and fp213p07_Readme.txt . The patch has been released to address the problems described on item II below and it is only for installation on a FlowPort server running FlowPort 2.1.1 SP2 ( 2.1.3.63 ). Two files, DocuShare.jar and SPAR706516240Patch_2_1_3_63.jar, are needed for the patch to fully work. Installing only one file will not repair any the problems referred on item II below. When initialized, the DocuShare.jar engine will log a DEBUG entry to the latest DAE log file. This entry identifies the DocuShare.jar with a release date version. 

II. Fixes on this patch 
* DocuShare version 3.0 ( DS3 ) fails to work with FlowPort 
New implementations on DocuShare version 3.0 have caused a communication breakdown with between FlowPort and DocuShare 3.0. This patch ( fp213p07.exe ) provides the mean for FlowPort to communicate with DocuShare 3.0. Please note that all Forms that were created for DocuShare 2.2 must be edited in order to work with the new adjustments of DocuShare 3.0. Please Contact FlowPort Support and/or DocuShare Support for more information. Other DocuShare patches may be needed to be able to use handprint regions in Document Management fields for documents stored to DocuShare 3.0 repositories. Please consult with DocuShare Support to verify that you have the necessary DocuShare patch installed. 

* arrayIndexOutOfBoundsException error 
When printing a token for a DocuShare file and the user's locale is set for a language other than English, an arrayIndexOutOfBoundsException error may occur. This patch corrects this problem for all locales. 

* Cannot specify multiple DocuShare collections on same coversheet 
Specifying multiple DocuShare collections on the same Distribute Document cover sheet on a DocuShare server hosted by Netscape Enterprise web server, would result in a NullPointerException error. 

* Some Java enhancements and work-arounds 
Changes were made to implement a workaround for a Java URLConnection problem. 

* Improved Docushare Error Messages 
For a few cases where uploading a document to a DocuShare repository fails, some nullPointerException error messages are now replaced with more descriptive messages. These messages may assist the user, DocuShare or FlowPort support personnel in diagnosing some of those problems. 

III. Patches Superseded 
* 2.1.3.63.37 
* 2.1.3.63.29 
* 2.1.3.63.27 

IV. Distribution 
* This patch is to be installed on ALL FlowPort servers running SP2. 

V. Installation of Patch 
The patch installation requires the server to be running FlowPort software version SP2 ( v2.1.3.63 ) and the Patch Manager ( PatchManager.jar ). (If the PatchManager is not installed , follow item VII, 'PatchManager installation steps.' If a previous version of this patch was installed on the server, follow item VI, 'Uninstalling this patch' before following item V, 'Installation of Patch.') 

1. Installing the SPAR706516240Patch_2_1_3_63.jar 

* Copy the SPAR706516240Patch_2_1_3_63.jar file to the FlowPort/PROGRAM/jars directory 
* Rename the DocuShare.jar file on the FlowPort/PROGRAM/jars directory to DocuShareOLD.jar 
* Copy the DocuShare.jar file to the FlowPort/PROGRAM/jars directory 
* Logon to FlowPort as admin 
* Click on the light blue APPLICATIONS tab 
* Click on the ' Patch Manager ' link under ' Configure Applications and Services ' 
* Click on the ' Install New Patch ' link 
* Type SPAR706516240Patch_2_1_3_63.jar after .../PROGRAM/jars/ (please watch the caps). The entry should look like: 

.../PROGRAM/jars/ SPAR706516240Patch_2_1_3_63.jar 

* Click on 'Install Application or Service' 
* The bold message 'Configuration Done' should come up with 'Installed service SPAR706516240Patch_2_1_3_63.' 
* Click on 'Continue' and it will take you to the light blue APPLICATIONS tab 
* Click on the 'Patch Manager' link under 'Configure Applications and Services'. 
* A new entry for 'SPAR706516240Patch_2_1_3_63' should be there. 
* if the new entry is not there, follow the 'Installing the SPAR706516240Patch_2_1_3_63.jar' steps again 

2. Installing the DocuShare.jar 

* Click on the 'APPLICATIONS' light blue tab 
* Click on 'Install new Application or Service' 
* Type DocuShare.jar after .../PROGRAM/jars/ (please watch the caps). The entry should look like: .../PROGRAM/jars/DocuShare.jar* Click on 'Install Application or Service' button 
* The bold message 'Configuration Done' should come up 
* Click on 'Continue' 
* Click on light blue RESTART tab 
* Click on the Restart button 
* Allow for normal FlowPort startup sequence and return to normal FlowPort usage. 
* Logon to FlowPort as admin 
* Click on the light blue APPLICATIONS tab 
* Click on the 'Distribute Document' link under 'Configure Applications and Services' 
* Go to FlowPort/log directory 
* Sort the files on that directory by date 
* Open the latest DAE?.log file 
* Go all the way to the bottom of the file and look for this entry: 

DEBUG Nov 25, 2002 5:06:18 PM >>> 
Using DocuShare update 706516240 (2002NOV19) 

This DEBUG entry, with its appropriate FlowPort date stamp, confirms the complete installation of the patch. 

VI. Uninstalling this patch 
If you should experience problems and would like to withdraw this patch, please follow these steps: 

1. Uninstalling SPAR706516240Patch_2_1_3_63.jar 

* Logon to FlowPort as admin 
* Click on the light blue APPLICATIONS tab 
* Click on the 'Patch Manager' link under 'Configure Applications and Services' 
* Look under 'Patch Name' for SPAR706516240Patch_2_1_3_63 
* Click under the X to the left of SPAR706516240Patch_2_1_3_63 
* Click on the 'Uninstall Selected Patches' button 
* A warning message asking you to confirm the uninstalling of this patch will pop up. Click on 'OK' 
* You will see this message: 

Uninstalling patch SPAR706516240Patch_2_1_3_63 
Deleting patch SPAR706516240Patch_2_1_3_63 
1 Patches removed. Please reboot FlowPort unless you were so instructed not to. 

* Click on Done 
* With Windows Explorer, go to c:\Xerox\FlowPort\PROGRAMS\jars and delete the SPAR706516240Patch_2_1_3_63.jar file 

2. Uninstalling DocuShare.jar 

* Rename the DocuShare.jar file on the FlowPort/PROGRAM/jars directory to DocuShareNEW.jar 
* Rename the DocuShareOLD.jar file on the FlowPort/PROGRAM/jars directory to DocuShare.jar 
* Click on the 'APPLICATIONS' light blue tab 
* Click on 'Install new Application or Service' 
* Type DocuShare.jar after .../PROGRAM/jars/ (please watch the caps). The entry should look like: 
.../PROGRAM/jars/DocuShare.jar 
* Click on 'Install Application or Service' button 
* The bold message 'Configuration Done' should come up 
* Click on 'Continue' 
* Click on light blue RESTART tab 
* Click on the Restart button 
* Allow for normal FlowPort startup sequence and return to normal FlowPort usage. 
* Logon to FlowPort as admin 
* Click on the light blue APPLICATIONS tab 
* Click on the 'Distribute Document' link under 'Configure Applications and Services' (This will initialize the DocuShare.jar engine and cause it write an entry to the latest DAE log file.) 
* Using the Windows Explorer, go to FlowPort/log directory 
* Sort the files on that directory by date 
* Open the latest DAE?.log file 
* Go all the way to the bottom of the file and look for this entry: 

DEBUG Nov 25, 2002 5:06:18 PM >>> 
Using DocuShare update 706516240 (2002NOV19) 

* If it is there, follow the '2. Uninstalling DocuShare.jar' steps again. 
* If the entry is not there, go to c:\Xerox\FlowPort\PROGRAMS\jars and delete the DocuShareNEW.jar file. 

VII. PatchManager installation steps 

* Insert the FlowPort CD on you server's CDROM 
* Browse the CDROM 
* Go to the 'bin\Utils' directory 
* Copy the 'PatchManager.jar' file to the FlowPort/ImportJars directory 
* Open the web browser and logon to FlowPort as admin 
* Click on the 'APPLICATIONS' light blue tab 
* Click on 'Install new Application or Service' 
* - Delete the '/PROGRAM/jars/' part of the entry and replace it with '/ImportJars/' 
* Type 'PatchManager.jar' after '/ImportJars/' The entry should look like: 
.../ImportJars/PatchManager.jar 

* Click on 'Install Application or Service' button 
* The bold message 'Configuration' should come up together with 'Installed service Patch Manager. Configure the service' 
* Click on 'Configure the service' to install or uninstall a patch 


====================================================================== 
This patch is provided to resolve documented issue(s). 

Patches do not go through a full regression test, however, limited testing is done to ensure the problem is resolved and the operation of the software has not been impacted. If you experience issues with the installation and/or subsequent operation of the software and require assistance from our Customer Support Center, an active Support Agreement will be required. If you do not have a valid Support Agreement you will be required to renew/purchase a Support Agreement to obtain assistance and you will be required to pay a fee to Xerox for such renewal/purchase. 

All title, copyrights, patent rights, and other proprietary rights to the patch and the underlying software and all copies reside exclusively with Xerox and/or its licensor(s). 

IN NO EVENT SHALL XEROX BE LIABLE TO YOU FOR ANY DAMAGES, EITHER DIRECT, SPECIAL, INDIRECT, INCIDENTAL CONSEQUENTIAL OR PUNITIVE DAMAGES IN ANY WAY ARISING OUT OF OR RELATED TO THIS SOFTWARE PATCH OR UNDER A CLAIM OF ANY TYPE OR NATURE BASED ON ANY THEORY FOR LIABILITY (INCLUDING CONTRACT, TORT OR WARRANTY) EVEN IF THE POSSIBILITY OF SUCH DAMAGES HAS BEEN COMMUNICATED. 
======================================================================