Red Hat Bugzilla – Bug 888669
Add jbpmDS datasource instruction for deployable - EAP6
Last modified: 2015-06-01 21:35:12 EDT
Description of problem:
If you follow the steps in "2.3. Installing the Deployable Package" for EAP6, EAP boot will fail with
16:21:33,577 INFO [org.jboss.as.controller] (Controller Boot Thread) JBAS014774: Service status report
JBAS014775: New missing/unsatisfied dependencies:
service jboss.naming.context.java.jboss.datasources.jbpmDS (missing) dependents: [service jboss.persistenceunit."jbpm-human-task.war#org.jbpm.task", service jboss.persistenceunit."business-central-server.war#org.jbpm.persistence.jpa"]
because persistence.xml files in brms-p-5.3.1.GA-deployable-ee6.zip use 'jbpmDS' but it's not configured by default. (note: persistence.xml in brms-p-5.3.1.GA-deployable.zip use DefaultDS so no problem with EAP5)
Administrator Guide has some instruction.
But Getting Started Guide should include complete steps for startup. So please add an instruction like:
Add the following entry in jboss-eap-6.0/standalone/configuration/standalone.xml
<datasource jndi-name="java:jboss/datasources/jbpmDS" pool-name="jbpmDS" enabled="true" use-java-context="true">
I've updated the database configuration instructions in the admin guide and will post a link as soon as they are live on the internal docstage for review.
I think that Toshiya wanted to fix getting started guide, because steps there are not complete. I have looked at it:
but unfortunately the code snippet for DS configuration has not been added there. So you can add there the necessary steps for eap6 or provide a link to an example data source configuration in Administrator guide.
Also it would be good idea to add additional information about data sources to the administrator guide. Something like
"Here are is the example how to set up data source and JDBC driver, for more details regarding EAP 6 data source configuration take a look into its documentation: https://access.redhat.com/knowledge/docs/en-US/JBoss_Enterprise_Application_Platform/6/html/Administration_and_Configuration_Guide/chap-Datasource_Management.html"
Setting back to assigned.
(In reply to comment #3)
> Hello Lee,
> I think that Toshiya wanted to fix getting started guide, because steps
> there are not complete. I have looked at it:
> but unfortunately the code snippet for DS configuration has not been added
Yes, the instructions are in the admin guide, which users are instructed to refer to for database config. We may reorganize the getting started guide to include this information but for now we just need to make sure the right information is in the guide, i.e., jbpmDS, not brmsDS.
> So you can add there the necessary steps for eap6 or provide a link
> to an example data source configuration in Administrator guide.
> Also it would be good idea to add additional information about data sources
> to the administrator guide. Something like
> "Here are is the example how to set up data source and JDBC driver, for more
> details regarding EAP 6 data source configuration take a look into its
> Setting back to assigned.
> We may reorganize the getting started guide to include this information
Please fix/reorganize the getting started guide in this BZ as well. We already got 3 customers who stumbled over this.
*** Bug 889910 has been marked as a duplicate of this bug. ***
Thanks Lee. Verified.
*** Bug 878300 has been marked as a duplicate of this bug. ***