Understanding seam's persistence context configuration

Actually this post is a note for myself regarding how seam could be configured in the web application. The facts are:
- The application is running on JBoss 5.1
- Seam is used to manage the lifecycle of EntityManager instances

Here's the configuration:

1. Datasource configuration file placed in {server}/deploy
   JNDI name is Datasource
2. Persistence unit configuration in persistence.xml
   <persistence-unit name="PersistenceUnit" transaction-type="JTA">
   <provider>org.hibernate.ejb.HibernatePersistence</provider>
   <jta-data-source>Datasource</jta-data-source>
   ......
   <properties>
   ........
   <property name="jboss.entity.manager.factory.jndi.name" value="java:/EntityManagerFactory"/>
   </properties>
   
   
   
3. Declaration of persistence-unit-ref element in web.xml
   <persistence-unit-ref>
   <persistence-unit-ref-name>PersistenceUnit/pu</persistence-unit-ref-name>
   <persistence-unit-name>PersistenceUnit</persistence-unit-name>
   </persistence-unit-ref>
   
4. Configuration in component.properties
   seamBootstrapsPu=false
   seamEmfRef=#{null}
   puJndiName=java:comp/env/PersistenceUnit/pu
5. Configuration of persistence managed context in components.xml
   <persistence:managed-persistence-context name="entityManager" auto-create="true"
   entity-manager-factory="@seamEmfRef@"
   persistence-unit-jndi-name="@puJndiName@"/>
   
   

Here's the short explanation:

1. A new datasource is deployed (step 1)
2. The datasource is referred to in persistence.xml (step 2)
3. Add reference to the new persistence unit name in web.xml (step 3)
4. Add new property in component.properties which refers to the persistence-unit-ref-name declared in web.xml (step 4)
5. The values configured in component.properties is used to configure the managed-persistence-context (step 5)

Note: The entity manager factory is bound to the global JNDI thru "jboss.entity.manager.factory.jndi.name" property configured during step 2, however it is not used... yet :)