Bug 1100114

Summary:	Wrong description to the content of "setenv.bat" in chapter 2.3.2.1
Product:	[Retired] JBoss BPMS Platform 6	Reporter:	Lyle Wang <lywang>
Component:	Documentation	Assignee:	Vikram Goyal <vigoyal>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Marek Baluch <mbaluch>
Severity:	unspecified	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	unspecified
Version:	6.0.2	CC:	brms-docs, mbaluch
Target Milestone:	CR1
Target Release:	6.0.2
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-01-14 22:15:46 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:

Description Lyle Wang 2014-05-22 04:03:01 UTC

Description of problem:

Doc URL: https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.0/html/Installation_Guide/sect-Installing_the_generic_deployable_package.html

Chapter "2.3.2.1. Setting up transaction manager for Red Hat JBoss Web Server 2.0 (Tomcat 7)"

Point 9. Define the btm.root system property and location where bitronix config file is placed: 

[
 In $TOMCAT_DIR/bin/, create the setenv.sh or setenv.bat file with the following content:

CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties"

......

On Microsoft Windows systems, replace the $CATALINA_HOME value in the content of the file with the equivalent environment variable name or use the absolute path. 
]

Actually, on Windows, I need to have a setenv.bat like this to get it working:

set "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties"



Note 2 points: 1) use "set" in front of CATALINA_OPTS; 2) the position of double quote ""


This is verified on Windows 7

Comment 2 Lyle Wang 2014-05-22 04:13:14 UTC

So finally it looks like:

set "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties"

Comment 3 Vikram Goyal 2014-05-22 05:44:46 UTC

Added note about setting the variables differently on Windows. The change can be verified here [1].

Moving this to ON_QA.

[1] http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.0/html-single/Installation_Guide/index.html#Setting_up_transaction_manager

Comment 4 Marek Baluch 2014-06-26 09:18:32 UTC

Verified using link in comment #3.

A warning explaining the differences between Linux and Windows is now present.