Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1130134

Summary: Addition note in datasource configuration quoting Oracle resource connection is misleading
Product: [Retired] JBoss BPMS Platform 6 Reporter: Josh West <jowest>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED NOTABUG QA Contact: Marek Baluch <mbaluch>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 6.0.2CC: brms-docs
Target Milestone: ---   
Target Release: One-off release   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Build Name: 22689, Installation Guide-6.0-1 Build Date: 30-06-2014 16:10:03 Topic ID: 22559-666597 [Latest]
Last Closed: 2015-05-07 06:31:27 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Deadline: 2015-05-07   

Description Josh West 2014-08-14 12:05:46 UTC 
Title: Setting up Dashbuilder for Red Hat JBoss Web Server 2.0 (Tomcat 7)

Within this section, some users/customers are following the note that some datasource types need special configuration.  The resource block that is quoted bypasses the lookup of the JNDI datasource configured by bitronix.  When this block is used the server will not start.  I recommend that this block is removed from the documentation, or clarified how it is applicable, and exactly when to use it.

```NOTE
Depending upon your database, you may need to define some other properties here as well. For example, in an Oracle environment, this entry may look like the following listing.

<Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container"  removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password"  driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />
```
Comment 2 Vikram Goyal 2015-05-07 06:31:27 UTC 
Josh - sorry for the tremendous delay in getting to this issue.

I am unsure if the point you have raised is still valid. The block that you mention is almost exactly as the block before it, except for specifying some Oracle specific db connection properties.

This block was added on the advice of GSS because customers complained that thre were no DB specific examples shown. 

If you think this is still an issue, please let me know why and reopen this bug.

Moving this to CLOSED --> NOTABUG.

[1] https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.1/html-single/Installation_Guide/index.html#Setting_up_Dashbuilder