Setup of Orbeon Forms with JBoss Portal

This is a quick note on how to get Orbeon Forms 3.7.0beta nightly running on JBoss Portal 2.7.1 bundled with JBoss AS. These instructions seems to missing in the Orbeon docs.

1. First setup and run the portal normally and check that you get the portal first page ok at http://localhost:8080/portal

2. Get the orbeon WAR (I got some nightly of January 2009 of the 3.7.0 version) and add the following files to WEB-INF:
- portlet-instances.xml

<?xml version="1.0" standalone="yes"?>
<!DOCTYPE deployments PUBLIC
   "-//JBoss Portal//DTD Portlet Instances 2.6//EN"
   "http://www.jboss.org/portal/dtd/portlet-instances_2_6.dtd">
<deployments>
   <deployment>
      <instance>
         <instance-id>OrbeonPortletInstance</instance-id>
         <portlet-ref>OrbeonFormsPortlet</portlet-ref>
      </instance>
   </deployment>
</deployments> 

- orbeon-object.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE deployments PUBLIC
   "-//JBoss Portal//DTD Portal Object 2.6//EN"
   "http://www.jboss.org/portal/dtd/portal-object_2_6.dtd">
<deployments>
   <deployment>
      <parent-ref>default.default</parent-ref>
      <if-exists>overwrite</if-exists>
      <window>
         <window-name>Orbeon Forms</window-name>
         <content>
          <content-type>portlet</content-type>
          <content-uri>OrbeonPortletInstance</content-uri>
         </content>
         <region>center</region>
         <height>1</height>
      </window>
   </deployment>
</deployments> 

- jboss-portlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app>
	<portlet>
		<portlet-name>OrbeonFormsPortlet</portlet-name>
	</portlet>
</portlet-app>

3. In my case I had to uncomment the following in the web.xml, since the resource was present in jboss-web.xml file:
    <!-- Uncomment this for the SQL examples -->
 
    <resource-ref>
        <description>DataSource</description>
        <res-ref-name>jdbc/db</res-ref-name>
        <res-type>javax.sql.DataSource</res-type>
        <res-auth>Container</res-auth>
    </resource-ref> 

4. Deploy modified WAR to $JBOSS_PORTAL_DIR/server/default/deploy

5. The deployer should automatically deploy the WAR and if you refresh the first page on the portal, you will see that the orbeon portlet view has appeared on the page. Check the terminal or logs for issues during deployment if you have some problems.

NOTE: This is just me testing if it Orbeon works on JBoss Portal so no guarantees are given. Hopefully this'll give someone a nudge at the right direction, though.

Post new comment

  • Web page addresses and e-mail addresses turn into links automatically.
  • Allowed HTML tags: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>
  • Lines and paragraphs break automatically.
  • You can enable syntax highlighting of source code with the following tags: <code>, <blockcode>. The supported tag styles are: <foo>, [foo].

More information about formatting options