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.0

Sun 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.0

New 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.

Table 1  Fixed Bugs in Portlet Builder 2.0 

Bug Number

Description

4876142

Web services provider is missing the required jar file.

4875683

PSSim.jsp compiler is unable to read spaces in the URL Req parameters.

4845062

Non-root user cannot add new NBM module in Sun ONE Studio 4 software.

4866932

Portlet files are not getting recognized by loader.

Installation Notes

This 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:

  1. From Sun ONE Studio software, select Tools, Options, IDE Configuration, Systems.
  2. Right click on Modules.
  3. Select Add and Module from NBM File.

    4. Add your Sun ONE Portlet Builder software NBM file from here.

    Note

    Sun ONE Portlet Builder 2.0 software is not an update to previous versions of the software. You must manually remove the JAR files from previous releases and restart Sun ONE Studio software before installing Sun ONE Portlet Builder 2.0 software.

  To Uninstall Portlet Builder

  1. Remove the following software files from the user’s modules directory and modules/ext directory:
    • ps.jar
    • psrun.jar
    • jdom.jar
  2. Remove the psjsh.zip from modules/docs directory.
  3. Restart Sun ONE Studio.

Known Issues

This 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 Feedback

If you have problems with Sun ONE Portlet Builder, contact Sun customer support using one of the following mechanisms:

So that we can best assist you in resolving problems, please have the following information available when you contact support:

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

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 Resources

Useful Sun ONE information can be found at the following Internet locations:

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.