JBEAP-14084: Create shared content - Start the servers

README.adoc

@@ -52,7 +52,7 @@ NOTE: Some of these quickstarts use the H2 database included with {productName}.
 | link:batch-processing/README{outfilesuffix}[batch-processing]|CDI, Batch 1.0, JSF | The `batch-processing` quickstart shows how to use chunk oriented batch jobs to import a file to a database. | Intermediate | _none_
 | link:bean-validation/README{outfilesuffix}[bean-validation]|CDI, JPA, BV | The `bean-validation` quickstart provides Arquillian tests to demonstrate how to use CDI, JPA, and Bean Validation. | Beginner | _none_
 | link:bean-validation-custom-constraint/README{outfilesuffix}[bean-validation-custom-constraint]|CDI, JPA, BV | The `bean-validation-custom-constraint` quickstart demonstrates how to use the Bean Validation API to define custom constraints and validators. | Beginner | _none_
-| link:bmt/README{outfilesuffix}[bmt]|EJB, BMT | null | Intermediate | _none_
+| link:bmt/README{outfilesuffix}[bmt]|EJB, BMT | The `bmt` quickstart demonstrates Bean-Managed Transactions (BMT), showing how to manually manage transaction demarcation while accessing JPA entities. | Intermediate | _none_
 | link:cmt/README{outfilesuffix}[cmt]|EJB, CMT, JMS | The `cmt` quickstart demonstrates Container-Managed Transactions (CMT), showing how to use transactions managed by the container. | Intermediate | _none_
 | link:contacts-jquerymobile/README{outfilesuffix}[contacts-jquerymobile]|jQuery Mobile, jQuery, JavaScript, HTML5, REST | The `contacts-jquerymobile` quickstart demonstrates a Java EE 7 mobile database application using HTML5, jQuery Mobile, JAX-RS, JPA, and REST. | Beginner | _none_
 | link:deltaspike-authorization/README{outfilesuffix}[deltaspike-authorization]|JSF, CDI, Deltaspike | Demonstrate the creation of a custom authorization example using @SecurityBindingType from DeltaSpike | Beginner | _none_
@@ -97,7 +97,7 @@ NOTE: Some of these quickstarts use the H2 database included with {productName}.
 | link:jaxws-retail/README{outfilesuffix}[jaxws-retail]|JAX-WS | The `jaxws-retail` quickstart is a working example of a simple web service endpoint. | Beginner | _none_
 | link:jsonp/README{outfilesuffix}[jsonp]|CDI, JSF, JSON-P | The `jsonp` quickstart demonstrates how to use the JSON-P API to produce object-based structures and then parse and consume them as stream-based JSON strings. | Beginner | _none_
 | link:jta-crash-rec/README{outfilesuffix}[jta-crash-rec]|JTA, Crash Recovery | The `jta-crash-rec` quickstart uses JTA and Byteman to show how to code distributed (XA) transactions in order to preserve ACID properties on server crash. | Advanced | _none_
-| link:jts/README{outfilesuffix}[jts]|JTS, EJB, JMS | null | Intermediate | link:cmt/README{outfilesuffix}[cmt]
+| link:jts/README{outfilesuffix}[jts]|JTS, EJB, JMS | The `jts` quickstart shows how to use JTS to perform distributed transactions across multiple containers, fulfilling the properties of an ACID transaction. | Intermediate | link:cmt/README{outfilesuffix}[cmt]
 | link:jts-distributed-crash-rec/README{outfilesuffix}[jts-distributed-crash-rec]|JTS, Crash Recovery | The `jts-distributed-crash-rec` quickstart uses JTS and Byteman to demonstrate distributed crash recovery across multiple application servers. | Advanced | link:jts/README{outfilesuffix}[jts]
 | link:kitchensink/README{outfilesuffix}[kitchensink]|CDI, JSF, JPA, EJB, JAX-RS, BV | The `kitchensink` quickstart demonstrates a Java EE 7 web-enabled database application using JSF, CDI, EJB, JPA, and Bean Validation. | Intermediate | _none_
 | link:kitchensink-angularjs/README{outfilesuffix}[kitchensink-angularjs]|AngularJS, CDI, JPA, EJB, JPA, JAX-RS, BV | The `kitchensink-angularjs` quickstart demonstrates a Java EE 7 application using AngularJS with JAX-RS, CDI, EJB, JPA, and Bean Validation. | Intermediate | _none_
@@ -110,7 +110,7 @@ NOTE: Some of these quickstarts use the H2 database included with {productName}.
 | link:logging-tools/README{outfilesuffix}[logging-tools]|JBoss Logging Tools | The `logging-tools` quickstart shows how to use JBoss Logging Tools to create internationalized loggers, exceptions, and messages and localize them. | Beginner | _none_
 | link:mail/README{outfilesuffix}[mail]|JavaMail, CDI, JSF | The `mail` quickstart demonstrates how to send email using CDI and JSF and the default Mail provider that ships with {productName}. | Beginner | _none_
 | link:managed-executor-service/README{outfilesuffix}[managed-executor-service]|EE Concurrency Utilities, JAX-RS, JAX-RS Client API | The `managed-executor-service` quickstart demonstrates how Java EE applications can submit tasks for asynchronous execution. | Beginner | _none_
-| link:messaging-clustering/README{outfilesuffix}[messaging-clustering]|JMS, MDB | null | Intermediate | link:helloworld-mdb/README{outfilesuffix}[helloworld-mdb]
+| link:messaging-clustering/README{outfilesuffix}[messaging-clustering]|JMS, MDB | The `messaging-clustering` quickstart does not contain any code and instead uses the `helloworld-mdb` quickstart to demonstrate clustering using ActiveMQ Messaging. | Intermediate | link:helloworld-mdb/README{outfilesuffix}[helloworld-mdb]
 | link:messaging-clustering-singleton/README{outfilesuffix}[messaging-clustering-singleton]|JMS, MDB, Clustering | The `messaging-clustering-singleton` quickstart uses a JMS topic and a queue to demonstrate clustering using {productName} messaging with MDB singleton configuration where only one node in the cluster will be active. | Advanced | _none_
 | link:numberguess/README{outfilesuffix}[numberguess]|CDI, JSF | The `numberguess` quickstart demonstrates the use of CDI  (Contexts and Dependency Injection) and JSF (JavaServer Faces) in {productName}. | Beginner | _none_
 | link:payment-cdi-event/README{outfilesuffix}[payment-cdi-event]|CDI, JSF | The `payment-cdi-event` quickstart demonstrates how to create credit and debit CDI Events in {productName}, using a JSF front-end client. | Beginner | _none_
@@ -127,8 +127,8 @@ NOTE: Some of these quickstarts use the H2 database included with {productName}.
 | link:spring-petclinic/README{outfilesuffix}[spring-petclinic]|JPA, Junit, JMX, Spring MVC Annotations, AOP, Spring Data, JSP, webjars, Dandellion | The `spring-petclinic` quickstart shows how to run the Spring PetClinic Application in {productName} using the {productName} BOMs. | Advanced | _none_
 | link:spring-resteasy/README{outfilesuffix}[spring-resteasy]|Resteasy, Spring | The `spring-resteasy` quickstart demonstrates how to package and deploy a web application that includes resteasy-spring integration. | Beginner | _none_
 | link:tasks/README{outfilesuffix}[tasks]|JPA, Arquillian | The `tasks` quickstart includes a persistence unit and sample persistence code to demonstrate how to use JPA for database access in {productName}. | Intermediate | _none_
-| link:tasks-jsf/README{outfilesuffix}[tasks-jsf]|JSF, JPA | null | Intermediate | link:tasks/README{outfilesuffix}[tasks]
-| link:tasks-rs/README{outfilesuffix}[tasks-rs]|JPA, JAX-RS | null | Intermediate | link:tasks/README{outfilesuffix}[tasks]
+| link:tasks-jsf/README{outfilesuffix}[tasks-jsf]|JSF, JPA | The `tasks-jsf` quickstart demonstrates how to use JPA persistence with JSF as the view layer. | Intermediate | link:tasks/README{outfilesuffix}[tasks]
+| link:tasks-rs/README{outfilesuffix}[tasks-rs]|JPA, JAX-RS | The `tasks-rs` quickstart demonstrates how to implement a JAX-RS service that uses JPA persistence. | Intermediate | link:tasks/README{outfilesuffix}[tasks]
 | link:temperature-converter/README{outfilesuffix}[temperature-converter]|CDI, JSF, SLSB EJB | The `temperature-converter` quickstart does temperature conversion using an EJB Stateless Session Bean (SLSB), CDI, and a JSF front-end client. | Beginner | _none_
 | link:thread-racing/README{outfilesuffix}[thread-racing]|Batch, CDI, EE Concurrency, JAX-RS, JMS, JPA, JSON, Web Sockets | A thread racing web application that demonstrates technologies introduced or updated in the latest Java EE specification. | Beginner | _none_
 | link:websocket-client/README{outfilesuffix}[websocket-client]|Web Socket, CDI Events, JSON, SSL | Demonstrates use of a Javascript WebSocket client, WebSocket configuration, programmatic binding, and secure WebSocket. | Intermediate | _none_

app-client/README.adoc

@@ -40,11 +40,13 @@ The root `pom.xml` file builds each of the subprojects in the appropriate order.
 //*************************************************
 // Add System Requirements
 //*************************************************
+// == System Requirements
 include::../shared-doc/system-requirements.adoc[leveloffset=+1]
 
 //*************************************************
 // Add Use of JBoss Home Name
 //*************************************************
+// == Use of {jbossHomeName}
 include::../shared-doc/use-of-jboss-home-name.adoc[leveloffset=+1]
 
 [[add_the_application_users]]
@@ -72,17 +74,11 @@ NOTE: For Windows, use the `__{jbossHomeName}__\bin\add-user.bat` script.
 
 If you prefer, you can use the `add-user` utility interactively. For an example of how to use the add-user utility, see the instructions located here: link:{addApplicationUserDocUrl}[Add an Application User].
 
-== Start the Server
-
-. Open a terminal and navigate to the root of the {productName} directory.
-. Start the {productName} server with the default standalone profile by typing the following command.
-+
-[source,subs="+quotes,attributes+",options="nowrap"]
-----
-$ __{jbossHomeName}__/bin/standalone.sh
-----
-+
-NOTE: For Windows, use the `__{jbossHomeName}__\bin\standalone.bat` script.
+//*************************************************
+// Start the server with the default profile
+//*************************************************
+// == Start the Server with the Default Profile
+include::../shared-doc/start-server-default-profile.adoc[leveloffset=+1]
 
 == Build and Deploy the Quickstart
 

batch-processing/README.adoc

@@ -6,8 +6,6 @@
 :productVersion: 12
 :buildRequirements: Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later
 include::../shared-doc/attributes.adoc[]
-:uses-h2:
-:uses-ds-xml:
 
 :level: Intermediate
 :technologies: CDI, Batch 1.0, JSF
@@ -36,29 +34,28 @@ The database schema defines that the column for name is unique. For that reason,
 //*************************************************
 // Add notes about use in a production environment.
 //*************************************************
+// == Considerations for Use in a Production Environment
+:uses-h2:
+:uses-ds-xml:
 include::../shared-doc/development-shortcuts.adoc[leveloffset=+1]
 
 //*************************************************
 // Add System Requirements
 //*************************************************
+// == System Requirements
 include::../shared-doc/system-requirements.adoc[leveloffset=+1]
 
 //*************************************************
 // Add Use of JBoss Home Name
 //*************************************************
+// == Use of {jbossHomeName}
 include::../shared-doc/use-of-jboss-home-name.adoc[leveloffset=+1]
 
-== Start the Server
-
-. Open a terminal and navigate to the root of the {productName} directory.
-. Start the {productName} server with the default standalone profile by typing the following command.
-+
-[source,subs="+quotes,attributes+",options="nowrap"]
-----
-$ __{jbossHomeName}__/bin/standalone.sh
-----
-+
-NOTE: For Windows, use the `__{jbossHomeName}__\bin\standalone.bat` script.
+//*************************************************
+// Start the server with the default profile
+//*************************************************
+// == Start the Server with the Default Profile
+include::../shared-doc/start-server-default-profile.adoc[leveloffset=+1]
 
 == Build and Deploy the Quickstart
 

bean-validation-custom-constraint/README.adoc

@@ -6,8 +6,6 @@
 :productVersion: 12
 :buildRequirements: Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later
 include::../shared-doc/attributes.adoc[]
-:uses-h2:
-:uses-ds-xml:
 
 :level: Beginner
 :technologies: CDI, JPA, BV
@@ -25,29 +23,29 @@ This quickstart does not contain a user interface layer. The purpose of this pro
 //*************************************************
 // Add notes about use in a production environment.
 //*************************************************
+// == Considerations for Use in a Production Environment
+:uses-h2:
+:uses-ds-xml:
 include::../shared-doc/development-shortcuts.adoc[leveloffset=+1]
 
 //*************************************************
 // Add System Requirements
 //*************************************************
+// == System Requirements
 include::../shared-doc/system-requirements.adoc[leveloffset=+1]
 
 //*************************************************
 // Add Use of JBoss Home Name
 //*************************************************
+// == Use of {jbossHomeName}
 include::../shared-doc/use-of-jboss-home-name.adoc[leveloffset=+1]
 
-== Start the Server
+//*************************************************
+// Start the server with the default profile
+//*************************************************
+// == Start the Server with the Default Profile
+include::../shared-doc/start-server-default-profile.adoc[leveloffset=+1]
 
-. Open a terminal and navigate to the root of the {productName} directory.
-. Start the {productName} server with the default standalone profile by typing the following command.
-+
-[source,subs="+quotes,attributes+",options="nowrap"]
-----
-$ __{jbossHomeName}__/bin/standalone.sh
-----
-+
-NOTE: For Windows, use the `__{jbossHomeName}__\bin\standalone.bat` script.
 
 == Run the Arquillian Tests
 

bean-validation/README.adoc

@@ -6,8 +6,6 @@
 :productVersion: 12
 :buildRequirements: Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later
 include::../shared-doc/attributes.adoc[]
-:uses-h2:
-:uses-ds-xml:
 
 :level: Beginner
 :technologies: CDI, JPA, BV
@@ -27,30 +25,28 @@ This quickstart is a basic example of bean validation and is not localized. Beca
 //*************************************************
 // Add notes about use in a production environment.
 //*************************************************
+// == Considerations for Use in a Production Environment
+:uses-h2:
+:uses-ds-xml:
 include::../shared-doc/development-shortcuts.adoc[leveloffset=+1]
 
 //*************************************************
 // Add System Requirements
 //*************************************************
+// == System Requirements
 include::../shared-doc/system-requirements.adoc[leveloffset=+1]
 
 //*************************************************
 // Add Use of JBoss Home Name
 //*************************************************
+// == Use of {jbossHomeName}
 include::../shared-doc/use-of-jboss-home-name.adoc[leveloffset=+1]
 
-== Start the Server
-
-. Open a terminal and navigate to the root of the {productName} directory.
-. Start the {productName} server with the default standalone profile by typing the following command.
-+
-[source,subs="+quotes,attributes+",options="nowrap"]
-----
-$ __{jbossHomeName}__/bin/standalone.sh
-----
-+
-NOTE: For Windows, use the `__{jbossHomeName}__\bin\standalone.bat` script.
-
+//*************************************************
+// Start the server with the default profile
+//*************************************************
+// == Start the Server with the Default Profile
+include::../shared-doc/start-server-default-profile.adoc[leveloffset=+1]
 
 == Run the Arquillian Tests
 

bmt/README.adoc

@@ -6,9 +6,6 @@
 :productVersion: 12
 :buildRequirements: Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later
 include::../shared-doc/attributes.adoc[]
-:uses-h2:
-:uses-ds-xml:
-:performance-scalability:
 
 :level: Intermediate
 :technologies: EJB, BMT
@@ -30,32 +27,32 @@ When you run this example, you are presented with a *Use bean managed Entity Man
 
 This example shows how to transactionally insert key value pairs into the database and demonstrates the requirements on the developer with respect to the JPA Entity Manager.
 
-//***************************************
+//*************************************************
 // Add notes about use in a production environment.
-//***************************************
+//*************************************************
+// == Considerations for Use in a Production Environment
+:uses-h2:
+:uses-ds-xml:
+:performance-scalability:
 include::../shared-doc/development-shortcuts.adoc[leveloffset=+1]
 
 //*************************************************
 // Add System Requirements
 //*************************************************
+// == System Requirements
 include::../shared-doc/system-requirements.adoc[leveloffset=+1]
 
 //*************************************************
 // Add Use of JBoss Home Name
 //*************************************************
+// == Use of {jbossHomeName}
 include::../shared-doc/use-of-jboss-home-name.adoc[leveloffset=+1]
 
-== Start the Server
-
-. Open a terminal and navigate to the root of the {productName} directory.
-. Start the {productName} server with the default standalone profile by typing the following command.
-+
-[source,subs="+quotes,attributes+",options="nowrap"]
-----
-$ __{jbossHomeName}__/bin/standalone.sh
-----
-+
-NOTE: For Windows, use the `__{jbossHomeName}__\bin\standalone.bat` script.
+//*************************************************
+// Start the server with the default profile
+//*************************************************
+// == Start the Server with the Default Profile
+include::../shared-doc/start-server-default-profile.adoc[leveloffset=+1]
 
 == Build and Deploy the Quickstart
 

cmt/README.adoc

@@ -6,7 +6,6 @@
 :productVersion: 12
 :buildRequirements: Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later
 include::../shared-doc/attributes.adoc[]
-:uses-h2:
 
 :level: Intermediate
 :technologies: EJB, CMT, JMS
@@ -52,34 +51,28 @@ Never:: If the client has a transaction running and does not suspend it but call
 //***************************************
 // Add notes about use in a production environment.
 //***************************************
-include::../shared-doc/development-shortcuts.adoc[leveloffset=+1]
-
-//*************************************************
-// Add notes about use in a production environment.
-//*************************************************
+// == Considerations for Use in a Production Environment
+:uses-h2:
 include::../shared-doc/development-shortcuts.adoc[leveloffset=+1]
 
 //*************************************************
 // Add System Requirements
 //*************************************************
+// == System Requirements
 include::../shared-doc/system-requirements.adoc[leveloffset=+1]
 
 //*************************************************
 // Add Use of JBoss Home Name
 //*************************************************
+// == Use of {jbossHomeName}
 include::../shared-doc/use-of-jboss-home-name.adoc[leveloffset=+1]
 
-== Start the Server with the Full Profile
+//*************************************************
+// Start the server with the full profile
+//*************************************************
+// == Start the Server with the Full Profile
+include::../shared-doc/start-server-full-profile.adoc[leveloffset=+1]
 
-. Open a terminal and navigate to the root of the {productName} directory.
-. Start the {productName} server with the standalone full profile by typing the following command:
-+
-[source,subs="+quotes,attributes+",options="nowrap"]
-----
-$ __{jbossHomeName}__/bin/standalone.sh -c standalone-full.xml
-----
-+
-NOTE: For Windows, use the `__{jbossHomeName}__\bin\standalone.bat` script.
 
 == Build and Deploy the Quickstart