Description of problem: https://access.redhat.com/knowledge/docs/en-US/JBoss_Enterprise_BRMS_Platform/5/html-single/BRMS_Getting_Started_Guide/index.html#Installing_the_Deployable_Package1 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) - brms-p-5.3.1.GA-deployable-ee6.zip:jboss-jbpm-console-ee6/business-central-server.war/WEB-INF/classes/META-INF/persistence.xml - brms-p-5.3.1.GA-deployable-ee6.zip:jboss-jbpm-console-ee6/jbpm-human-task.war/WEB-INF/classes/META-INF/persistence.xml Administrator Guide has some instruction. https://access.redhat.com/knowledge/docs/en-US/JBoss_Enterprise_BRMS_Platform/5/html-single/BRMS_Administrator_Guide/index.html#Configuring_a_Datasource_for_JBoss_Enterprise_Application_Platform_6 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"> <connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1</connection-url> <driver>h2</driver> <security> <user-name>sa</user-name> <password>sa</password> </security> </datasource> ===== Thanks!
Thanks Toshiya, 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. Thanks Lee
http://documentation-devel.engineering.redhat.com/docs/en-US/JBoss_Enterprise_BRMS_Platform/5/html/BRMS_Administrator_Guide/Configuring_a_Datasource_for_JBoss_Enterprise_Application_Platform_6.html
Hello Lee, I think that Toshiya wanted to fix getting started guide, because steps there are not complete. I have looked at it: http://documentation-devel.engineering.redhat.com/docs/en-US/JBoss_Enterprise_BRMS_Platform/5/html/BRMS_Getting_Started_Guide/Installing_the_Deployable_Package1.html 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: > http://documentation-devel.engineering.redhat.com/docs/en-US/ > JBoss_Enterprise_BRMS_Platform/5/html/BRMS_Getting_Started_Guide/ > Installing_the_Deployable_Package1.html > but unfortunately the code snippet for DS configuration has not been added > there. Hi Petr, 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. Thanks Lee > 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.
Hi Lee, > 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. Cheers, Toshiya
*** 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. ***