So you have heard of Sun's Open Source Portlet Container and want to try it out. The portlet container comes with out of the box integration hooks with GlassFish. I'll try to chalk out the steps for the installation of the Sun Open Source Enterprise Portlet Container on GlassFish.

    Requirements :

• GlassFish :) You can download it from this link. By default, a domain named domain1 will be created in the $GLASSFISH_HOME/domains directory when you install it.
• Portlet container source code.
  
• Apache Ant (1.6.5 and above) - The deployment is done using ant tasks.
  
• Maven (2.0.4 and above) - The Portlet Container code is built using maven.
  
• SVN client (to get the code of Portlet Container).
  

    Just follow these steps and you should be able to get the Portlet Container working on GlassFish.

1. Download the portlet container source code.
   

       Please check the Getting Started page of the project to get the code of the project. It also provides link for maven download and svn client download and setup.
   

2. cd portlet-container
   
3. mvn clean package verify
4. A directory viz., dist/portlet-container will be created under the portlet-container directory.
5. cd dist/portlet-container
6. Edit config/pcenv.conf file and provide the value for GLASSFISH_HOME.
7. ant -f setup.xml deploy_on_glassfish   (Ensure that GlassFish is running as this requires the admin server to be running in order to set the jvm option required by the Portlet Container).
   
8. This deploys the Portlet Container on GlassFish, copies the jar files to the server classpath for domain1 and stops the GlassFish server.
9. Start the GlassFish server. Check the server logs at $GLASSFISH_HOME/domains/domain1/logs/server.log to see that portletcontainerdriver is deployed.
   

    That's it really! So get that code and rock on :)