Release Notes

Release Notes for Sun ONE Portlet Builder

Version 1.0

Updated November 15, 2002




These release notes contain important information available at the time of the version 1.0 release of Sun™ Open Net Environment (Sun ONE) Portlet Builder software. Product features, known problems, and other late-breaking issues are either addressed or referenced here. Read this document before you begin using Sun ONE Portlet Builder software.

These release notes contain the following sections:





Sun ONE Portlet Builder, Version 1.0

Sun ONE Portlet Builder software offers developers the opportunity to create custom providers for new types of channels, and to test new channels within a "sandbox" environment, isolated from issues involving authorization, administration, or desktop configuration.

The Portlet Builder Online Help provided with Sun™ ONE Studio software describes the following product features:

The intended audience for Sun ONE Portlet Builder software is assumed to be familiar with Sun ONE Portal Server, as well as the fundamentals of Sun ONE Studio software.





Documentation

For specific details about Sun ONE Portlet Builder software, refer to the Online Help provided with Sun ONE Studio software.

For specific details about Sun ONE Portal Server 6.0, refer to the Sun ONE Portal Server 6.0 Developer's Guide and the product documentation set. These documents can be accessed from the Portal Server link at the following location:

http://docs.sun.com/db/prod/sunone/





Known Problems and Limitations


Manually remove directory and files when reinstalling Portal Server file system.

When the plugin creates the Portal Server file system, it intentionally will not overwrite any existing files. If you wish to have the Portal Server file system reinstalled, you should manually remove the directory or files that you want to be updated, and toggle the enabled flag on the module.

One very important piece of the Portal Server file system is Web-INF/lib/psrun.jar. This is a copy of psrun.jar that was installed in modules/ext. If you wish to update psrun.jar, either replace it in both locations, or remove the Portal Server file system copy and toggle the module enable field to force it to recopy.


Ignore package "recipe" error message.

When you create a .par file in a workspace, the extension .par conflicts with an extension used by the jar packager module. The module produces an error message about the packager "recipe," which should be ignored.


Allow Portal Server file system to convert.

The first time simulate or package runs on a newly constructed Portal Server file system, a message appears about the Portal Server file system not being a web module, asking if you want to convert it. Click OK, and allow it to convert.


Compilation problems are ignored when attempting to start the simulator and packager.

When you start the simulator or packager, compilation failures do not currently stop the packager or simulator execution.


jar file may not be visible on customize list.

You may not be able to compile template-produced files in the workspace, or run the simulator or packager because of missing classes (likely belonging to package com.sun.portal). psrun.jar should be visible as a file system in the list displayed from the Customize option on the popup menu (right-click on the Filesystems node of the explorer). It should also be located within WEB-INF/lib in the Portal Server file system.


Workaround

If it is missing from the Sun ONE Studio Customize list, mount it using Mount Archive under the same popup menu.

If it is missing from WEB-INF/lib, simply create that directory (if necessary), and copy it into that location.


XML file cannot be validated against .dtd file.

The XML file created by the Portal Server component does not create a .dtd file.


The .par file produced by the packager does not contain an "automatic" operation.

Do not try to import into a target Portal Server using the -a option of the par command.


Workaround

Specify an explicit operation on the command.





How to Report Problems

If you have problems with Sun ONE Portlet Builder, contact your support representative with the following information:





For More Information

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


Copyright © 2002 Sun Microsystems, Inc. All rights reserved.

Sun, Sun Microsystems, the Sun logo, Java, JSP, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

Copyright © 2002 Sun Microsystems, Inc. Tous droits réservés.

Sun, Sun Microsystems, le logo Sun, Java, JSP, et Solaris sont des marques de fabrique ou des marques déposées, ou marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.


Last Updated November 15, 2002