Bug 1100114 - Wrong description to the content of "setenv.bat" in chapter 2.3.2.1
Summary: Wrong description to the content of "setenv.bat" in chapter 2.3.2.1
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss BPMS Platform 6
Classification: Retired
Component: Documentation
Version: 6.0.2
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: CR1
: 6.0.2
Assignee: Vikram Goyal
QA Contact: Marek Baluch
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2014-05-22 04:03 UTC by Lyle Wang
Modified: 2018-12-05 18:39 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-01-14 22:15:46 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

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.


Note You need to log in before you can comment on or make changes to this bug.