How to use this document

This document provides details and links to issues and resolutions for the 2.0 release series.

There are two options when applying a patch

1. Apply the patch listed here. If the patch is a simple and does not require restarting the Application Server it may be quicker to just apply the quick fix.
2. Upgrade to the latest revision: Contours upgrade in many cases is quicker than applying the patch. If a restart of the Application Server is required many times it's our recommendation to download the whole latest revision and upgrade.
   

Be sure to also review the  http://www.jamabackstage.com/docs/DOC-1226 to see what's planned for the next release

Minor releases and patches

2.9

2.9.7

Issue: Permissions got corrupted when saving new permssions.

Resolution:

1. Unzip  the  AclServiceImpl.zip.zip file (attached below http://jamabackstage.com/servlet/JiveServlet/download/1210-67-1247/AclServiceImpl.zip).
2. Replace  class: AclServiceImpl.class in  "{tomcat}/webapps/contour/WEB-INF/classes/com/jamasoftware/contour/service/impl"  with the new class file in the zip.
3. Restart  Tomcat

2.9.5

Issue: Value in Item in Set field is not properly cleared.

Resolution/Workaround:

1. Unzip  file jx.js_2_9_5_patch.zip (attached below http://jamabackstage.com/servlet/JiveServlet/download/1210-63-1242/jx.js_2_9_5_patch.zip).
2. Replace  file "jx.js"  in "{tomcat}/webapps/contour/js" with the new js file in  the zip.
3. Clear your browser cache.
4. Point to your Contour  instance.

2.8

2.8.0 - 2.8.1

Issue: Relationship option/filter window is broken for read-only users .

Resolution/Workaround:

1. Unzip file jx.js_2_8_1_patch.zip (attached below http://www.jamabackstage.com/servlet/JiveServlet/download/1210-56-1229/jx.js_2_8_1_patch.zip).
2. Replace file "jx.js"  in "{tomcat}/webapps/contour/js" with the new js file in the zip.
3. Clear your browser cache.
4. Point to your Contour instance.

Issue: Excel Import: Can't preview/import unicode characters for rich text fields .

Resolution/Workaround:

1. Unzip file BaseContourImporter.zip (attached below http://www.jamabackstage.com/servlet/JiveServlet/download/1210-51-1227/BaseContourImporter.zip).
2. Replace class BaseContourImporter.class in "{tomcat}/webapps/contour/WEB-INF/classes/com/jamasoftware/contour/importer" with the new class files in the zip.
3. Unzip file DataImportController.zip (attached below http://www.jamabackstage.com/servlet/JiveServlet/download/1210-53-1228/DataImportController.zip)
4. Replace class DataImportController.class in "{tomcat}/webapps/contour/WEB-INF/classes/com/jamasoftware/contour/view/controller/project" with the new class files in the zip.
5. Restart Tomcat

2.7

2.7.0 - 2.7.2

Issue: Delete project broken for SQL Server and Oracle.

Resolution:

1. Unzip the HibPropertyEntryDaoImpl.zip file (attached below).
2. Replace class: HibPropertyEntryDaoImpl.class in "{tomcat}/webapps/contour/WEB-INF/classes/com/jamasoftware/contour/dao/hibernate" with the new class file in the zip.
3. Restart  Tomcat

Issue: Various synchronization issues using JIRA Connector

Resolution:

1. Unzip the SynchronizationJobHelper.zip file (attached below).
2. Replace class: SynchronizationJobHelper.class in "{tomcat}/webapps/contour/WEB-INF/classes/com/jamasoftware/contour/service/helper" with the new class file in the zip.
3. Restart  Tomcat

2.6

2.6.0 - 2.6.3

Issue: Debugging information for org.springframework.security package is logged in Contour log file.

Resolution: Add the following line to the end of file %tomcat_home%/webapps/contour/WEB-INF/log4j.properties and restart Tocmat:

log4j.logger.org.springframework.security=INFO

2.6.0

Issue: After right clicking an item in the grid, double clicking on another item will show the first item instead of the current one.

Resolution: Install  Contour_Patch_2_6_0.zip (attached below, instructions included in zip file).

2.5

2.5.5

Issue: Security issue with blank password when Active Directory anonymous binding is enabled .

Resolution/Workaround:

1. Unzip the LdapUserDaoImpl.zip file (attached below).
2. Replace classes: LdapUserDaoImpl.class and LdapUserDaoImpl$UserContextMapper.class  in "{tomcat}/webapps/contour/WEB-INF/classes/com/jamasoftware/contour/dao/ldap" with the new class files in the zip.
3. Restart  Tomcat

Issue: When "Remember Me" is selected, links from Contour are not followed properly in IE.  An "Object Expected" popup is seen, and the app becomes unusable.

Resolution/Workaround:

1. Download the following file:  http://www.jamabackstage.com/docs/DOC-1352
2. Replace this file in your tomcat webapps directory:  %tomcat_home%/webapps/contour/js/EJSChart/EJSChart.js
3. Clear any local browser cache.

2.4

2.4.3

Issue: LDAP can't be enabled.

Resolution/Workaround:

Option 1: Upgrade to 2.4.4

Option 2: Add/Update LDAP property in database

If  property "jama.system.ldap.enable.ldap" is already in propertyEntry table,  change propertyValue to ‘true’.

Otherwise add an entry to the proeprtyEntry table by running the following query:

     insert into propertyEntry (propertyName, propertyType, propertyValue, scope, refId) values('jama.system.ldap.enable.ldap', 1, 'true', 1, 0);

Option 3:

1. Unzip the DwrPropertyServiceImpl.zip file (attached below).
2. Replace class:  DwrPropertyServiceImpl.class in "{tomcat}/webapps/contour/WEB-INF/classes/com/jamasoftware/contour/dwr/impl" with the new class file in the zip.
3. Restart  Tomcat
4. Now the LDAP can be enabled in System Properties.

2.4.2

Issue: Key editable property and release dropdown list don't change when switching projects and editing
items of the same type.

Resolution: Install  Contour_Patch_2_4_2.zip (attached below, instructions included in zip file).

2.3

2.3.3

Issue: Attachments appear to be missing. Error log states no attachments found in directory.

Resolution: Restart Tomcat.

Issue: Notifications between the 1st and 8th of each month are sent using the incorrect dates

Resolution: upgrade to the 2.3.x or apply the attached patch below

2.2

2.2.2

Issue: Upload Attachment Item

The upload button on Item attachment dialog is broken.

Resolution: Install # (attached below, instructions included in zip file).

2.1

2.1.1

Issue: Copy project

If you select to include Release or Tags there are issues around these two options.

* Tags:  duplicates will be created in the new project

• Release: dupicates are created in the original project

Resolution (logged to be fixed in next release 2.2)

2.0

2.0.3

Issue: Tomcat doesn't start  and/or notifications are not being sent

Resolution (Fixed in 2.0.4 and 2.1)  :

1. Remove these jar files from the contour\WEB-INF\lib

• geronimo-activation_1.1_spec-1.0-M1.jar

• geronimo-javamail_1.4_spec-1.0-M1.jarbq

• geronimo-servlet_2.5_spec-1.1-M1.jar

2. Restart Tomcat

2.0.0

Issue: Unable to click on an item within the relationship section

Resolution:

1. Workaround: Click on the cell to the right of the link

2. Install 2.0.2 patch (attached below, instructions included in zip file)