Thursday Feb 19, 2009

WSRP 2.0 FCS binary

The WSRP 2.0 FCS binary is now available for download from the OpenPortal WSRP project download page and has implemented all the WSRP 2.0 mandatory and most of the optional features. This project binary is being shipped into the below release vehicles apart from the above standalone install which the project provides as a wsrp-configurator.jar

2. Liferay version 5.2 and higher.

The source code for the above is tagged as "liferay-5.2-snapshot" - In case you need the code for some debugging.

On the trunk work continues on the 2.1 release -- Which is a maintenance release. Please use the project mail list for any questions and comments.

Monday Feb 16, 2009

OpenPortal WSRP as a Liferay Plugin

There has been quite a few queries on Liferay OpenPortal WSRP integration, Here are some notes in addition to the below blog entries.

  1. OpenPortal WSRP is now moved to liferay plugins under wsrp-portlet directory - Yes this is the case even in Liferay 5.2 and in all future versions.
  2. The WSRP Administrative interface ( Producer and Consumer admin  portlets ) will appear in the "Control Panel" if the WSRP Portlet plugin is deployed successfully.
  3. The OpenPortal WSRP has dependency on the Metro stack, Hence deploying it on application servers other than glassfish or tomcat may conflict with the applications servers webservices stack. The above plugin is tested and recommended to be deployed over glassfish or tomcat liferay distribution.
  4. Make sure that you set portlet.container.impl=sun in as mentioned in the above blog.

Monday Dec 29, 2008

Setting up a WSRP 2.0 Producer in Liferay or Websynergy

Here is a note on how to setup a WSRP Producer on Liferay or Websynergy instance. The OpenPortal WSRP Producer version 2.0 is integrated into the liferay trunk, the next major release of Liferay i.e version 5.2 will have both the OpenPortal WSRP Producer and Consumer integrated into it.

If you are looking for some notes on how to use the OpenPortal WSRP Consumer in liferay. Please refer to this earlier blog "Liferay consumes OpenPortal WSRP".

A. Setting the portal properties :

If you are using a liferay build/binary, before we start make sure that your has portlet container set to Sun Container.

Here is the snippet.


Note : The above configuration is not required on the websynergy binary/setup, Websynergy bundle by default sets the container to Sun.

Make sure you restart the server after this configuration.

B. Deploy a Portlet:

Now deploy any portlet, say a simple sample portlet like the the "Bookmark Portlet" binary readily available for download from the Portlet repository project.

Make sure this portlet works fine by adding to the user page before we proceed.

Note : You can deploy the above portlet either using the "Plugin Installer" or by copying to the hot deploy directory.

C. WSRP Producer administrative portlet:

The administrative functionality for the WSRP Producer are provided by a portlet called the "WSRP Producer", The same portlet is available or integrated into the "Control Panel" of the Liferay Portal.

Login as administrator and choose to use this portlet or choose the control panel --> WSRP Producer option to get the administrative GUI.

D. Creating a WSRP Producer :

Follow instructions below to create a WSRP Producer using the above GUI.

  1. Click on "Add Producer" button.
  2. Enter a name for the Producer.
  3. Choose your options
    1. Say 2.0 (To create a 2.0 WSRP Producer).
    2. Registration Required and Inband supported.
    3. More details on these options here.
  4. The newly created producer is disabled by default.
  5. To enable this producer, edit the producer by clicking on newly created producer.
  6. The "Bookmark Portlet" which we deployed should be available in "Unpublished" portlets list.
  7. Move this portlet from "Unpublished" to "Published" list.
  8. Save the configuration, by clicking on "save" button.
  9. The producer would still be disabled.
  10. Edit the producer again and change the status to "Enabled"
  11. Save the configuration.

The WSDL URL for this producer is automatically generated, You can get the URL in the edit screen of the producer, share this WSDL URL with the consumers who wish to use this portlet on their portal.

You can create any number of producer instances on the the same portal and export different list of portlets for each producer. As you can see setting up a WSRP 2.0 producer in Liferay is just a matter of few clicks without any need for programming effort.

Stay tuned on the OpenPortal WSRP Project mailing list for more information w.r.t to this integration.

Monday Nov 03, 2008

OpenPortal WSRP 2.0 Beta

The OpenPortal WSRP 2.0 beta is now available part of Java Application Platform SDK Update 6. Its also available as a separate download from the project download page. Its recommended to use OpenPortal PortletContainer version 2.0_01 with this.

Also checkout the WSRP 2.0 Beta Article available as the part of Java Application Platform SDK Update 6.

Please uninstall previous versions before installing this release.

Note : If you are using a build from the OpenPortal WSRP trunk i.e you checkout, build and install a OpenPortal WSRP version, its recommended to continue so. Since this WSRP 2.0 beta release is from branch that was created a while back for the Java Application Platform SDK U6 release.

Friday Aug 08, 2008

Liferay consumes OpenPortal WSRP

The OpenPortal WSRP Project consumer is now integrated into Liferay Portal. The next stable release of Liferay is expected to have both the OpenPortal WSRP producer and consumer integrated in it.

This is the first milestone integration called phase 1, where an usable OpenPortal WSRP consumer integrated into Liferay Portal. Here is the list of features that are supported in this phase 1 integration.

  1. Ability to create multiple WSRP consumers.
  2. Ability to create WSRP portlets and view them.
  3. Integrated with Liferay channel URL rewriter
  4. Integrated WSRP resource proxy
  5. WSRP eventing
  6. WSRP shared render parameters
  7. WSRP leasing
  8. WSRP resource serving
  9. WSRP caching.

Here are some screen shots of this integration

A. Finding WSRP Consumer Admin Portlet:

    The WSRP consumer admin portlet is integrated into the Liferay as an admin portlet that enables management of multiple WSRP Consumers.

After successful login click -->Add Application --> choose Admin category ---> WSRP Consumer Admin Portlet

B. Rendered WSRP Consumer Admin Portlet:

The following screen shot shows the WSRP consumer admin portlet rendered on the Liferay portal desktop.

C. Finding WSRP channels:

The WSRP channels created using the WSRP Consumer Admin Portlet appear under the WSRP category in the "Add Application" drop down.

D. Rendered WSRP Channel:

The following screen shot shows a remote portlet rendered on the Liferay Portal desktop.

Stay tuned on the OpenPortal WSRP Project mailing list for more information w.r.t to this integration.  

Tuesday Apr 08, 2008

OpenPortal WSRP 1.0 FCS binary download


The WSRP version 1.0 FCS is the latest stable binary from the WSRP v1 project. This is expected to be the last binary release from the WSRP v1 Project and this project will remain in maintenance mode, only serious issues reported will be fixed from now on. This same binary is integrated into the following releases.

  1. Sun Java System Portal Server 7.2 release and
  2. Java Application Platform SDK Update 5.
From now on all future developments and feature integration will happen only on the WSRP version 2.0 project. 

A. Binary download

  1. WSRP version 1.0 FCS bits  requires
  2. Portlet Container 2.0 RC2

B. WSRP documents:

  1. Install Instructions
  2. User Guide
  3. FAQ

C. Portlet Container documents:

  1. Install Instructions

D. See Also:

  1. Portlet Repository binary

Wednesday Mar 12, 2008

WSRP 2.0 Resource serving and Caching


Checkout the following announcements on the release of a new milestone binary from OpenPortal WSRP Project.

  1. Project Announcement : OpenPortal WSRP version 2.0 milestone 3 now available   or
  2. Blog on PortalPost .


This new milestone 3 supports the following feature set

  1. WSRP 2.0 getResource
  2. WSRP 2.0 Caching
    1. Markup Caching
      1. Expiration Markup Caching
      2. Validation Markup Caching
    2. Resource Caching
      1. Expiration Resource Caching
      2. Validation Resource Caching
  3. Tomcat 5.5 support
  4. Migrated code to the latest WSRP 2.0 schema


Pls note that the previous milestones have already provided the following WSRP  version 2.0  feature sets.

  1. WSRP 2.0 Eventing.
  2. Shared/Public render parameters.


The above links also provides sample portlets and configuration instructions to try out these features. If you have questions on how to use the OpenPortal WSRP Project and other comments/suggestions/requests, consider joining the alias.

Tuesday Feb 12, 2008

WSRP Eventing and Shared Render parameter preview

Just a repost of the information on Portal Post w.r.t to WSRP version 2.0 milestone 2 binary. Here is the actual post  

The OpenPortal WSRP version 2.0 milestone 2 binary is now available for download. The binary along with install instruction is available on the Open Portal WSRP download pageThis is the second milestone release from the OpenPortal WSRP Project that implements the OASIS WSRP version 2.0 specification. The main intent of this release is to preview the following optional features defined in the WSRP version 2.0 of OASIS specification.

  1. WSRP Eventing
  2. Shared/Public render parameters
Pls follow the instructions in coordination preview document on how to test and use these features that'll help you to understand the implementation.

Here are the links to the complete set of documents for this milestone.
  1. Install Instructions
  2. User Guide
  3. WSRP v2 Coordination samples
Stay tuned for more optional feature implementation in the future milestones of the OpenPortal WSRP version 2.0 project. If you would like to keep track of future announcements and additions to the OpenPortal WSRP Project, please subscribe to the alias.

If you have questions on how to use the OpenPortal WSRP Project and other comments/suggestions/requests, we urge you to join the alias.

Please report any issues that you encounter while trying OpenPortal WSRP version 2.0 milestone 2 to

Friday Feb 01, 2008

Manual instructions for WSRP on Tomcat

Check the following thread for the manual instructions of installing and configuring OpenPortal WSRP on Tomcat. The above instructions is validated against the following binaries.

  1. Tomcat version 5.5.25
  2. Metro version 1.1
  3. Portlet Container version 2.0 Beta 2 (2 Jan  2008 build)
  4. WSRP latest trunk binary.

Stay tuned to the OpenPortal WSRP aliases for more news related to automatic configuration soon. 

Friday Dec 14, 2007

WSRP version 2.0 implementation on OpenPortal WSRP project

The implementation of the WSRP version 2.0 is in full swing in the OpenPortal WSRP Project community. Here is the link to the project wiki page that tracks this project.
Apart form this the following documents are also available for review
  1. WSRP v2 FSD
  2. WSRP Consumer Admin Usecases
  3. Eventing Usecases
  4. Architecture changes for WSRP v2
  5. Project Plan
If you have comments or questions, pls join the project and post your queries or comments. Stay tuned for the milestone 1 drop which is expected in the next few weeks also for more features in the future drops.

Friday Nov 16, 2007

Uninstalling OpenPortal WSRP and PortletContainer

Here is how you uninstall OpenPortal WSRP and OpenPortal PortletContainer projects after successful installation without having to uninstall the whole glassfish application server. Recently I came across this issue since someone asked about it and this information was not available or documented anywhere.


Uninstall OpenPortal WSRP :

Upon successful install of OpenPortal WSRP, The installer would have created a 'wsrp' directory as <glassfish_install>/domains/domain1/wsrp. There is a setup.xml under this directory, invoking the 'uninstall-wsrp' ant target does the job. Here is the example

# ant -f setup.xml uninstall-wsrp.

Make sure you restart the glassfish application server after this.


Uninstall OpenPortal PortletContainer :

Similar instructions apply the OpenPortal PortletContainer uninstall procedure. Upon successful install of OpenPortal PortletContainer, the installer would have created a 'portlet-container' directory as <glassfish_install>/domains/domain1/portlet-container. There is a setup.xml under this directory, invoking the 'uninstall-pc' ant target does the job. Here is the example


# ant -f setup.xml uninstall-pc.

 Make sure you restart the glassfish application server after this.

Thursday Sep 20, 2007

WSRP 1.0 beta part of Java Application Platform SDK Update 3 Beta release



OpenPortal WSRP 1.0 beta is now integrated into the Java Application Platform SDK Update 3 Beta release. The WSRP implementation provided over the OpenPortal Portlet Container 2.0 beta which is also available in the same Java Application Platform SDK bundle.


Portlet Container 2.0 beta implements some of the JSR286 features based on the early access draft , its available as a preview in the above bundle.


Here is the location to get all the details about this bundle ( download, release notes, install instructions, articles and more).  


Wednesday Aug 22, 2007

OpenPortal WSRP Project consumed by OpenPortal


The OpenPortal WSRP project is consumed or integrated into the OpenPortal project, Here is a note on some of the integration that was done.

Java Persistence API based (JPA) based datastore :

Added a new datastore for storing WSRP Producer and WSRP Consumer related configurations The file based datastore that OpenPortal WSRP Project is unacceptable as the configurations stored in file would be local to specific portal server node. The JPA based WSRP datastore implementation by default uses derby as backend to store all the WSRP Producer and Consumer related configuration information.


Note : The source code for this resides in the OpenPortal WSRP Project as this can be used outside of the OpenPortal. Watch this space for more details on how to use it in OpenPortal WSRP Project.

User Management:

The OpenPortal project customizes the user datastore of the OpenPortal WSRP Project, its provides user store where WSRP users are created and managed on to the LDAP server that is used by the OpenPortal installation. OpenPortal project creates creates people container under organizational units for each consumer registration The people container is used for creating phantom users that are specific to a consumer registration.


Note : Pls see the other entries on WSRP User Identity Propagation to know more about phantom users and identity propagation techniques

Role Management :

OpenPortal uses roles in LDAP/Access Manager to store explicitly cloned portlets. Explicit clones are portlet clones that are created by consumers that needs to be shared by all the users. Hence the cloned portlet is stored on to the role and all users under that consumer registration are assigned to this role, which makes the portlet clone available to all the users under this consumer registration.


Here is a simple representation, the WSRP Producer and WSRP Consumer stores configuration onto a database. The WSRP Producer uses the AM /LDAP  server to create users and roles for the above mentioned functionalities.


Single SignOn Token(SSOToken) Identity Propagation:

OpenPortal uses AccessManager(AM) to authenticate users, authenticated users are represented by a Single SignOn Token(SSOToken) in AM. Since SSOToken is used only in OpenPortal, the SSO identity propagation is added as an extension by the OpenPortal Project to WSRP Project.


When this option is selected the SSOToken associated with the user is propagated as an UserContext extension by the WSRP Consumer to the WSRP Producer which represents a user. 


Note : This identity propagation mechanism assumes that both Consumer and Producer Portal are OpenPortal installations. Pls see this entry for more details

WSRP Mbeans :

The OpenPortal WSRP Project Mbeans are consumed by the OpenPortal and integrated into the OpenPortal Portal Administration Server (PAS) module, the WSRP Mbeans are deployed on to the Common Agent Container for APG and Orion/Common Agent Container (CACAO/CAC) management server. The OpenPortal administrative console (psconsole) provides a user interface for WSRP administrative purposes using the above Mbeans.


Note: Pls see the architecture here and the intent of this design.

WebService Single Sign On (WSSSO) Portlet :

The OpenPortal project provides a portlet/user-interface that allows users to add/provide Single SignOn information in the form of a username and password. This portlet stores the user credentials that is used by the WSRP Consumer to create a OASIS Username Token profile and propagate the user identity to the WSRP Producer portal.


Note : The WSSSO Portlet uses the SSOAdapter infrastructure to store user credentails, Pls see here for more information on SSO Adapter.


Wednesday May 23, 2007

Article on WSRP

We have put together an article on the Open Portal WSRP Project titled "Open-Source Portal Initiative at Sun, Part 4: Web Services for Remote Portlets".  This article provides an overview about the Open Portal WSRP Project and some details about its architecture, deployment, build process and usage instructions.

Following are the links to all the article in this series

Monday May 07, 2007

OpenPortal is the new name

The Enterprise class Portal Server Project now has a new name, its called OpenPortal. It also has a brand new logo. All the subproject are now referred with OpenPortal prefixed to them. For e.g. the Enterprise-class WSRP Open Source Project is now called OpenPortal WSRP Project.


Apart from this, the Sun Java System Portal Server 7.1 source code is also available for download on the OpenPortal Project, check out the download page for more details.  Please keep a watch on the Portal Post for announcements related to the OpenPortal Project. 




« July 2016