Sun ONE Portlet Builder 2.0 Release Notes |
Sun ONE Portlet Builder 2.0 Release Notes
Version 2.0
Part Number 816-6767-10
December 2003
These release notes contain important information available at the time of release of Version 2.0 of Sun Open Net Environment (Sun ONE) Portlet Builder software. New features and enhancements, known limitations and problems, technical notes, and other information are addressed here. Read this document before you begin using Portlet Builder 2.0 software.
The most up-to-date version of these release notes can be found at the Sun ONE documentation web site: http://docs.sun.com/prod/sunone. Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and manuals.
These release notes contain the following sections:
About Portlet Builder, Version 2.0Sun ONE Portlet Builder software offers developers the opportunity to create custom providers and portlets for new types of channels, and to test new channels within a sandbox environment, isolated from issues involving authorization, administration, or desktop configuration.
The intended audience for Sun ONE Portlet Builder software is assumed to be familiar with Sun ONE Portal Server software, as well as the fundamentals of Sun ONE Studio software.
What’s New in Portlet Builder, Version 2.0New features in Portlet Builder 2.0 software include support for JSR 168. Developing portlets is similar to developing a web module, or web application. The portlet specific information is contained in a portlet.xml file, which resides in the WEB-INF directory of the web module. Rather than test or package individual portlets, you can test or package the portlet application. The portlet application is tested through the existing simulator, using the test harness. When the portlet application is packaged, the result is a .war file, which the deployer program can install on a portal server.
Bugs Fixed in Portlet Builder 2.0
Below is a short description of the most important bugs fixed in Portlet Builder 2.0 software.
Installation NotesThis section contains:
Operating Systems Requirements
The Sun ONE Portlet Builder software requires one of the following operating systems:
Software Requirements
The Sun ONE Portlet Builder software requires the Sun ONE Studio 4.0 or 5.0 software.
Instructions for Installing and Uninstalling Portlet Builder 2.0
This section contains:
Installing Portlet Builder 2.0
Before you install Portlet Builder 2.0, ensure that your system meets the Software Requirements outlined in this document.
To install the software:
To Uninstall Portlet Builder
Known IssuesThis section contains a list of the more important known issues at the time of the Portlet Builder 2.0 release.
4883936
The Sun ONE Studio software cannot use Sun ONE Application Server software as the server for running portal simulation.
Workaround Set up Tomcat to be the default server. The IDE compiler cannot read the JSP classes under WEB-INF and so they should be moved to the desktop directory.
4876681
When trying to use the portlet builder to create a custom channel that calls other classes, the simulator cannot find the classes.
Workaround Set the jspCompilerWARClassPath setting to tell JSPProvider where to find class. the jspCompilerWARClassPath setting is in the /etc/opt/SUNWps/dektop/desktopconfig.properties file found in the portal server filesystem.
4919648
Portlet Builder does not include support for filters in property setting /editing.
4946844
Displays an error message while simulating a webservices provider.
Workaround The following property needs to be reset in Studio runtime tab:
Internal Tomcat -> External Execution Process->Arguments
Prepend the following:
-Dhttp.proxyHost=NameOfProxyServer -Dhttp.proxyPort=PortNumber
This the way to deal with any provider which wishes to make HTTP connections when studio is operating behind a proxy.
4965122
Displays exception while deploying a .par file on win2K.
How to Report Problems and Provide FeedbackIf you have problems with Sun ONE Portlet Builder, contact Sun customer support using one of the following mechanisms:
- Sun Software Support services online at
http://www.sun.com/service/sunone/softwareSo that we can best assist you in resolving problems, please have the following information available when you contact support:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
You might also find it useful to visit the following interest group sites, where Sun ONE Portlet Builder software topics are discussed:
Sun Welcomes Your Comments
Sun is interested in improving its documentation and welcomes your comments and suggestions. Email your comments to Sun at this address:docfeedback@sun.com
Please include the part number (816-6767-10) of the document in the subject line and the book title (Portlet Builder 2.0 Release Notes) in the body of your email.
Additional Sun ResourcesUseful Sun ONE information can be found at the following Internet locations:
- Sun ONE Documentation
http://docs.sun.com/prod/sunone- Sun ONE Professional Services
http://www.sun.com/service/sunps/sunone- Sun ONE Software Products and Service
http://www.sun.com/software- Sun ONE Software Support Services
http://www.sun.com/service/sunone/software- Sun ONE Support and Knowledge Base
http://www.sun.com/service/support/software- Sun Support and Training Services
http://www.sun.com/supportraining- Sun ONE Consulting and Professional Services
http://www.sun.com/service/sunps/sunone- Sun ONE Developer Information
http://sunonedev.sun.com- Sun Developer Support Services
http://www.sun.com/developers/support- Sun ONE Software Training
http://www.sun.com/software/training- Sun Software Data Sheets
http://wwws.sun.com/software
Copyright © 2003 Sun Microsystems, Inc. All rights reserved.
Sun, Sun Microsystems, the Sun logo, Solaris, Java and the Java Coffee Cup logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Use of Portlet Builder is subject to the terms described in the license agreement accompanying it.