Release Notes for Plumtree Studio 2.1
Contents
Version History
Release Notes Overview
Common Components Container 1.5 HF208996
Issues Addressed
Post-Release Updates
Version 2.1 SP1
Supported Operating Systems, Application Servers, and Browsers
Issues Addressed
Version 2.1
Supported Operating Systems, Application Servers, and Browsers
Supported Plumtree Products
Documentation
New Features
Issues Addressed
Known Issues
Version History

Common Components Container 1.5 HF208996 - released January 2006

Plumtree Studio 2.1 SP1 - released December 2005

Plumtree Studio 2.1 - released September 2005

Release Notes Overview

These release notes cover all releases of Plumtree Studio 2.1, including hotfixes and service packs. For information on a particular release, please go to the appropriate section of these release notes.

Release notes are occasionally updated after the release date. For the most up-to-date release notes, go to the Product Center at support.plumtree.com.

Common Components Container 1.5 HF208996 for All Operating Systems

It is recommended that this hotfix be applied to ALL servers running any of the following products:

- Plumtree Foundation 6.0 Content Upload Service
- Plumtree Foundation 6.0 API Service
- Plumtree Collaboration 4.1
- Plumtree Studio 2.1
- Plumtree Analytics 1.2
- Plumtree Identity Services - LDAP 2.1
- Plumtree Content Service - Documentum 5.4
- Plumtree Portlet Suite - Lotus Notes 3.2
- Plumtree Portlet Suite - IMAP 3.1
- Plumtree Publisher 6.2 is also affected but has a different resolution. Please see the release notes for Plumtree Publisher for more details.

Issues Addressed

- In multiple products, headers greater than 4KB in size result in requests being truncated, which can negatively impact the functionality of affected products. Headers may exceed 4KB due to large portlet preferences passed by the portal, third party headers, SSO tokens, or other causes. Unexpected error messages may be returned by the portal as a result. (Issue #48757)

Post-Release Updates

- Plumtree Logging Utilties daemon may not restart after installation of Common Components Container 1.5 HF208996. (Issue #50560)

  Workaround: This hotfix stops all Plumtree services residing on a server in order to complete the installation process. It then automatically starts all services residing on that server. Please ensure that the all of the services have been properly restarted.
- Common Components Container 1.5 HF208996 deployment log is in an unusual location. (Issue #50562)

  Workaround: The deployment log is located at $PT_HOME/uninstall/ptportal/6.0/register/hotfix1_deployment.log (Unix and Linux) and %PT_HOME%\uninstall\ptportal\6.0\register\hotfix1_deployment.log (Windows).

Version 2.1 SP1

It is recommended that this service pack be applied to all Plumtree Studio 2.1 servers.

Supported Operating Systems, Application Servers, Databases, and Browsers

Refer to the Interoperability page in the Product Center at support.plumtree.com for the latest information on supported operating systems, application servers, databases, and browsers.

At the time of release, Plumtree Studio 2.1 supports the following:

- Operating Systems: Windows 2003 Server SP1, Solaris 8 and 9 on SPARC, Red Hat Enterprise Linux 3 Update 3 (ES & AS) on x86, SUSE Linux 9 on x86, and AIX 5.3 on POWER3, POWER4, POWER5
- Database Servers: Oracle 9i 9.2.0.5, 9.2.0.6, 10.1.0.3, including RAC configuration and Microsoft SQL Server 2000 SP3a
- Browsers: IE 5.5 and 6.0, Netscape 7.1 and 7.2, and Firefox 1.0

Issues Addressed

- Sun's Java Cryptography Extension (JCE) version 1.2.1 expired on July 27, 2005. Plumtree Studio 2.1 SP1 no longer uses JCE. (Issue #49007)
- Online help for Plumtree Studio has been translated to support the following languages: Chinese (Simplified), Chinese (Traditional), English, French, German, Italian, Japanese, Korean, Portuguese, Spanish, Dutch.

Version 2.1

Supported Operating Systems, Application Servers, Databases, and Browsers

Refer to the Interoperability page in the Product Center at support.plumtree.com for the latest information on supported operating systems, application servers, databases, and browsers.

At the time of release, Plumtree Studio 2.1 supports the following:

- Operating Systems: Windows 2003 Server SP1 and Red Hat Enterprise Linux 3 Update 3 (ES & AS) on x86
- Database Servers: Oracle 9i 9.2.0.5, 9.2.0.6, 10.1.0.3, including RAC configuration and Microsoft SQL Server 2000 SP3a
- Browsers: IE 5.5 and 6.0, Netscape 7.1 and 7.2, and Firefox 1.0

Supported Plumtree Products

Refer to the Interoperability page in the Product Center at support.plumtree.com for the latest information on supported Plumtree products.

At the time of release, Plumtree Studio 2.1 supports the following:

- Plumtree Foundation 6.0

Documentation

The product distribution includes the following documents in the Documentation folder.

Document Title and File Name | Document Description
--- | ---
Attributions Studio_Attributions.txt | Provides a list of third-party technologies used in the product, along with licensing information.
Installation and Upgrade Guide for Plumtree Studio 2.1 Installation_Guide_Plumtree_Studio_v2-1.pdf | Describes how to install and upgrade the components of Plumtree Studio 2.1.
Administrator Guide for Plumtree Studio 2.1 Administrator_Guide_Plumtree_Studio_v2-1.pdf | Describes how to create and manage portlets and database tables using Plumtree Studio 2.1.
Online Help To access online help, click the Help icon. | Describes how to use the components and features of Plumtree Studio 2.1.

New Features

- Plumtree Studio 2.1 supports Red Hat Linux.
- Plumtree Studio 2.1 is compatible with Plumtree Foundation 6.0. Note: You must upgrade your portal deployment to Plumtree Foundation 6.0 to upgrade to Plumtree Studio 2.1.
- Plumtree Studio 2.1 no longer requires a separate application server.
- Plumtree Studio 2.1 administrators can specify whether or not Plumtree Studio databases should be automatically deleted if all portlets associated with a database are deleted.
- Plumtree Studio 2.1 supports Traditional Chinese.

Issues Addressed

- "Yes/No" columns in Studio Record Browser Portlets display "True" or "False" instead of "Yes" or "No". (Issue #38068)
- The Studio Calendar portlet displays the wrong day information if the 31st is selected in a corresponding calendar month and a month with 30 days is chosen afterwards. (Issue #39273)
- Importing data and mapping it to data type Boolean causes entries for the imported columns to display NULL. (Issue #40069)

Known Issues

- Several Plumtree products, including Plumtree Studio 2.1 SP1, can only handle headers less than 4KB in size by default. However, certain configurations of the Plumtree Foundation may send headers that are greater than 4KB in size. This could occur by the portal passing large portlet preferences, third party headers, SSO tokens, etc. This will result in requests being dropped by affected applications, which could affect the functionality of that product. You may notice this as unexpected error messages being returned by the portal. You can also detect the size of the headers by using a TCP tracing tool such as Ethereal that can list header sizes. (Issue #48757)
  To resolve the issue, you must update the file plumtree-bootstrap.jar on the server that is running the product. The steps are:
  1. Contact support and get a newer version of plumtree-bootstrap.jar.
  2. Place the file in the following folder:
  - Windows: \program files\plumtree\common\container\tomcat\5.0.28\bin\
  - Unix: /opt/plumtree/common/container/tomcat/5.0.28/bin/
  3. Restart the services for all affected products on that particular server.
  Replacing plumtree-bootstrap.jar here will update all affected products and allow headers up to 16KB in size.
- Multi-byte characters are not displayed properly in the Reply-To Name input box when installing Plumtree Studio. (Issue #27240)
  Workaround: After running the installer, edit the PTStudioConfig.xml file and specify the correct Reply-To-Name value.
- The user group name is always displayed in the locale of the user who added the group in the Plumtree Studio portlet wizard. (Issue #44662)
- When executing the ptstudiod.sh to start or stop the Plumtree Studio daemon, a message appears indicating that the "Plumtree Test Service" is being started or stopped. The message is erroneous; the Plumtree Studio service is actually being started or stopped. (Issue #45333)
- The Plumtree Studio installer option "Image Service Files only" installs the folder ptstudio\2.1\sql. If the Image Service Files are installed after Plumtree Studio has already been installed on the same machine, the scripts in the sql folders get overwritten with scripts that do not contain user name and password values. (Issue #47876)
  Workaround: If the database has not been scripted yet, reinstall the Studio component to recreate valid scripts.