JBTM-2498 Incomplete BlackTie quickstart documentation

    - Update to initialize the settings related to the blacktie from the narayna codebase rather than the local copy
    - Reference to narayana/blacktie/blacktie README with install blacktie subsystem and admin services

blacktie/integration1/README

@@ -40,9 +40,8 @@ On Windows:
 You MUST use an environment configured with the VC++ development tools, e.g. launch:
 C:\Program Files\Microsoft Visual Studio 9.0\VC\vcvarsall.bat
 
-2. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+2. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 3. RUN THE APPLICATION SERVER
 Make sure that the naming, messaging and transaction services are running, by running the JBoss server:

blacktie/jatmibroker-xatmi/mdb-xatmi-service/README

@@ -32,11 +32,14 @@ On Windows:
 	%BLACKTIE_HOME%\setenv.bat
 Then, execute the script setenv
 
-2. RUN JBOSS
+2. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in https://github.com/jbosstm/narayana/blob/master/blacktie/blacktie/README
+
+3. RUN JBOSS
 NOTE: Make sure you have blacktie-admin-services installed
 <JBOSS_HOME>/bin/standalone.sh|bat -c standalone-blacktie.xml -Djboss.bind.address=$JBOSSAS_IP_ADDR -Djboss.bind.address.unsecure=$JBOSSAS_IP_ADDR
 
-3. RUN THE EXAMPLE
+4. RUN THE EXAMPLE
 This quickstart makes use of maven to build, deploy and test an XATMI service deployed 
 as an MDB.
 

blacktie/nbf/README

@@ -65,9 +65,8 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 generate_client -Dclient.includes=client.c
 
 
-4. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+4. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 5. RUN THE APPLICATION SERVER

blacktie/test/blacktie-linux.sh

@@ -49,6 +49,9 @@ fi
 # INITIALIZE JBOSS and CREATE BLACKTIE DISTRIBUTION
 ant -f $WORKSPACE/blacktie/test/initializeBlackTie.xml -Dbasedir=.. -DJBOSS_HOME=$JBOSS_HOME -DBT_HOME=$WORKSPACE/blacktie/target/dist/ -DVERSION=5.2.9.Final-SNAPSHOT -DMACHINE_ADDR=`hostname` -DJBOSSAS_IP_ADDR=$JBOSSAS_IP_ADDR -DBLACKTIE_DIST_HOME=$BLACKTIE_DIST_HOME initializeJBoss -debug
 
+# INITIALIZE JBOSS
+ant -f $WORKSPACE/narayana/blacktie/scripts/hudson/initializeJBoss.xml -DJBOSS_HOME=$WORKSPACE/jboss-as initializeJBoss
+
 if [ "$?" != "0" ]; then
 	ps -f
 	for i in `ps -eaf | grep java | grep "standalone.*xml" | grep -v grep | cut -c10-15`; do kill -9 $i; done

blacktie/test/blacktie-vc9x32.bat

@@ -19,6 +19,8 @@ rem INITIALIZE JBOSS and CREATE BLACKTIE DISTRIBUTION
 for /f "delims=" %%a in ('hostname') do @set MACHINE_ADDR=%%a
 call ant -f %WORKSPACE%/blacktie/test/initializeBlackTie.xml -DJBOSS_HOME=%JBOSS_HOME% -DBT_HOME=%WORKSPACE%\blacktie\target\dist\ -DVERSION=5.2.9.Final-SNAPSHOT -DMACHINE_ADDR=%MACHINE_ADDR% -DJBOSSAS_IP_ADDR=%JBOSSAS_IP_ADDR% -DBLACKTIE_DIST_HOME=%BLACKTIE_DIST_HOME%  -Dbasedir=%WORKSPACE% initializeDatabase initializeJBoss -debug
 IF %ERRORLEVEL% NEQ 0 echo "Failing build 3" & tasklist & call jboss-as\bin\jboss-cli.bat --connect command=:shutdown & @ping 127.0.0.1 -n 10 -w 1000 > nul & exit -1
+# INITIALIZE JBOSS
+call ant -f %WORKSPACE%/narayana/blacktie/scripts/hudson/initializeJBoss.xml -DJBOSS_HOME=%WORKSPACE%\jboss-as initializeJBoss
 set JBOSS_HOME=
 
 rem START JBOSS

blacktie/test/initializeBlackTie.xml

@@ -51,30 +51,8 @@
           </fileset>
         </unzip>
         <echo message="2"/>
-
-	<!-- ENABLE THE NAME_SERVICE for TM -->
-        <copy file="jboss-as/docs/examples/configs/standalone-blacktie.xml" tofile="jboss-as/standalone/configuration/standalone-blacktie.xml" overwrite="true" />
-        <echo file="jboss-as/bin/standalone.conf.bat" append="true">set "JAVA_OPTS=%JAVA_OPTS% -DOrbPortabilityEnvironmentBean.resolveService=NAME_SERVICE"</echo>
-	<echo file="jboss-as/bin/standalone.conf" append="true">JAVA_OPTS="$JAVA_OPTS -DOrbPortabilityEnvironmentBean.resolveService=NAME_SERVICE"</echo>
-	<!-- Enable transactions for the orb -->
-        <replaceregexp byline="true" match="&quot;spec&quot;" replace="&quot;full&quot;" file="jboss-as/standalone/configuration/standalone-blacktie.xml"/>
-	<!-- Enable JTS -->
-        <replaceregexp byline="true" match="&quot;txn-status-manager&quot;/&gt;" replace="&quot;txn-status-manager&quot;/&gt;&#10;            &lt;jts/&gt;" file="jboss-as/standalone/configuration/standalone-blacktie.xml"/>
-	<!-- Enable log4j categories -->
-        <replaceregexp byline="true" match="&lt;root-logger&gt;" replace="&lt;logger category=&quot;org.jboss.ejb.client&quot;&gt;&#10;                &lt;level name=&quot;ALL&quot;/&gt;&#10;            &lt;/logger&gt;&#10;            &lt;logger category=&quot;org.jboss.as.ejb3&quot;&gt;&#10;                &lt;level name=&quot;ALL&quot;/&gt;&#10;            &lt;/logger&gt;&#10;            &lt;logger category=&quot;org.jboss.narayana.blacktie&quot;&gt;&#10;                &lt;level name=&quot;ALL&quot;/&gt;&#10;            &lt;/logger&gt;&#10;            &lt;logger category=&quot;org.codehaus.stomp&quot;&gt;&#10;                &lt;level name=&quot;ALL&quot;/&gt;&#10;            &lt;/logger&gt;&#10;            &lt;logger category=&quot;org.apache.activemq&quot;&gt;&#10;                &lt;level name=&quot;ALL&quot;/&gt;&#10;            &lt;/logger&gt;&#10;            &lt;root-logger&gt;" file="jboss-as/standalone/configuration/standalone-blacktie.xml"/>
-	<!-- Add some jms-destinations for BlackTie to use -->
-        <replaceregexp byline="true" match="DLQ&quot;/&gt;" replace="DLQ&quot;/&gt;&#10;                &lt;jms-queue name=&quot;BTR_TestOne&quot; entries=&quot;queue/BTR_TestOne java:/jms/queue/BTR_TestOne&quot;/&gt;&#10;                &lt;jms-queue name=&quot;BTR_TestTwo&quot; entries=&quot;queue/BTR_TestTwo java:/jms/queue/BTR_TestTwo&quot;/&gt;&#10;                &lt;jms-queue name=&quot;BTC_ConvService&quot; entries=&quot;queue/BTC_ConvService java:/jms/queue/BTC_ConvService&quot;/&gt;&#10;                &lt;jms-queue name=&quot;BTR_JAVA_Converse&quot; entries=&quot;queue/BTR_JAVA_Converse java:/jms/queue/BTR_JAVA_Converse&quot;/&gt;&#10;                &lt;jms-topic name=&quot;BTR_JAVA_Topic&quot; entries=&quot;topic/BTR_JAVA_Topic java:/jms/topic/BTR_JAVA_Topic&quot;/&gt;" file="jboss-as/standalone/configuration/standalone-blacktie.xml"/>
-	<!-- Configure security settings for the queues -->
-        <replaceregexp byline="true" match="&lt;/security-setting&gt;" replace="&lt;/security-setting&gt;&#10;                &lt;security-setting name=&quot;jms.queue.BTR_BTDomainAdmin&quot;&gt;&#10;                    &lt;role name=&quot;blacktie&quot; send=&quot;true&quot; consume=&quot;true&quot;/&gt;&#10;                &lt;/security-setting&gt;&#10;                &lt;security-setting name=&quot;jms.queue.BTR_BTStompAdmin&quot;&gt;&#10;                    &lt;role name=&quot;blacktie&quot; send=&quot;true&quot; consume=&quot;true&quot;/&gt;&#10;                &lt;/security-setting&gt;&#10;                &lt;security-setting name=&quot;jms.queue.BTR_SECURE&quot;&gt;&#10;                    &lt;role name=&quot;dynsub&quot; send=&quot;true&quot; consume=&quot;true&quot;/&gt;&#10;                &lt;/security-setting&gt;" file="jboss-as/standalone/configuration/standalone-blacktie.xml"/>
-	<!-- Allow the role blacktie for access -->
-        <replaceregexp byline="true" match="#guest=guest" replace="guest=guest,blacktie&#10;
-dynsub=guest,blacktie,dynsub" file="jboss-as/standalone/configuration/application-roles.properties"/>
-	<!-- Disable dead connection testing for the invm connection factory -->
-        <replaceregexp byline="true" match="connection-factory name=&quot;InVmConnectionFactory&quot;" replace="connection-factory name=&quot;InVmConnectionFactory&quot; connection-ttl=&quot;-1&quot; client-failure-check-period=&quot;86400000&quot;" file="jboss-as/standalone/configuration/standalone-blacktie.xml"/>
-	<!-- Disable dead connection testing for the activemq-ra connection factory -->
-        <replaceregexp byline="true" match="connection-factory name=&quot;activemq-ra&quot;" replace="connection-factory name=&quot;activemq-ra&quot; connection-ttl=&quot;-1&quot; client-failure-check-period=&quot;86400000&quot;" file="jboss-as/standalone/configuration/standalone-blacktie.xml"/>
         <copy todir="jboss-as/" overwrite="true">
-            <fileset dir="blacktie/test/config/"/>
+            <fileset dir="narayana/blacktie/scripts/hudson/config/"/>
         </copy>
         <copy todir="jboss-as/standalone/deployments">
             <fileset dir="${ESC_BT_HOME}blacktie-${VERSION}/">

blacktie/xatmi/fooapp/README

@@ -65,9 +65,8 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 generate_client -Dclient.includes=client.c
 
 
-4. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+4. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 5. RUN THE APPLICATION SERVER

blacktie/xatmi/library/README

@@ -67,9 +67,8 @@ generate_library -Dlibrary.includes=BarService.c
 generate_client -Dclient.includes=client.c
 
 
-4. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+4. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 5. RUN THE APPLICATION SERVER

blacktie/xatmi/mappedNames/README

@@ -66,9 +66,8 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 generate_client -Dclient.includes=client.c
 
 
-4. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+4. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 5. RUN THE APPLICATION SERVER

blacktie/xatmi/queues/README

@@ -39,9 +39,8 @@ On Windows:
 	generate_client -Dclient.includes=txsender.c -Dclient.output.file=txsender -Dx.define=WIN32
 
 
-3. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+3. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 4. RUN THE APPLICATION SERVER

blacktie/xatmi/replyTo/README

@@ -65,9 +65,8 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 generate_client -Dclient.includes=client.c
 
 
-4. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+4. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 5. RUN THE APPLICATION SERVER

blacktie/xatmi/security/README

@@ -74,9 +74,8 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 generate_client -Dclient.includes=client.c
 
 
-5. DEPLOY THE STOMPCONNECTSERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+5. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 6. RUN AND CONFIGURE THE APPLICATION SERVER

blacktie/xatmi/svrInitDoneFunctions/README

@@ -61,9 +61,8 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 \blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\quickstarts\xatmi\fooapp\target\classes"): CreateProcess error=2, The system cannot find the file specified
 
 
-3. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+3. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 4. RUN THE APPLICATION SERVER

blacktie/xatmi/topics/README

@@ -65,9 +65,8 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 generate_client -Dclient.includes=client.c
 
 
-4. DEPLOY THE BLACKTIE ADMIN SERVICE
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+4. INSTALL THE BLACKTIE SUBSYSTEM AND DEPLOY THE ADMIN SERVICE
+Follow the instructions in $BLACKTIE_HOME/README
 
 
 5. RUN THE APPLICATION SERVER

blacktie/xatmi/txfooapp/README

@@ -203,8 +203,7 @@ C:\blacktie\dist\blacktie-5.2.9.Final-SNAPSHOT\bin\generate-executables.xml:144:
 
 3. RUNNING THE EXAMPLE
 ======================
-Undeploy any older versions of the blacktie admin service
-Copy the file $BLACKTIE_HOME/blacktie-admin-services/blacktie-admin-services-<VERSION>.ear into $JBOSS_HOME/standalone/deployments
+Follow the instructions in $BLACKTIE_HOME/README
 Start the JBoss server
 <JBOSS_HOME>/bin/standalone.sh|bat -c standalone-blacktie.xml -Djboss.bind.address=$JBOSSAS_IP_ADDR -Djboss.bind.address.unsecure=$JBOSSAS_IP_ADDR