13.8. The (Transactional) CarMart Quickstart Using JBoss Enterprise Web Server

This CarMart Transactional quickstart requires JBoss Data Grid's Library mode with the JBoss Enterprise Web Server container.
All th required libraries (jar files) are bundled with the application and deployed to the server. Caches are configured programatically and run in the same JVM as the web application for this quickstart.
Additionally, all operations are transactional. The standalone transaction manager from JBoss Transactions is used to run the application in JBoss Enterprise Web Server.
Only the library-tomcat profile can be used when running this quickstart with JBoss Enterprise Web Server because this profile enables library mode.
Report a bug

13.8.1. Quickstart Prerequisites

The prerequisites for this quickstart are as follows:
Report a bug

13.8.2. Build and Deploy the Transactional CarMart Quickstart

Prerequisites

Ensure that the following prerequisites are met before building and deploying the CarMart quickstart.

  1. Configure Maven (See Section 13.8.1, “Quickstart Prerequisites”)
  2. To configure JBoss Enterprise Web Server, add the following lines to the conf/tomcat-users.xml file: 
    <role rolename="manager-script"/>
    <user username="admin" password="admin" roles="manager-script"/>
  3. Configure Maven by adding the following configuration information to the Maven settings.xml file with the appropriate credentials: 
    <server>
	<id>tomcat</id>
	<username>admin</username>
	<password>admin</password>
</server>
  4. Start JBoss Enterprise Web Server:
    1. In a command line terminal, navigate to the root of the JBoss Enterprise Web Server directory.
    2. Use one of the following commands to start the server with a web profile:
      For Linux: 
      $TOMCAT_HOME/bin/catalina.sh run
      For Windows: 
      %TOMCAT_HOME%\bin\catalina.bat run

Procedure 13.15. Build and Deploy the Transactional CarMart Quickstart

  1. In a command line terminal, navigate to the root directory for the quickstart.
  2. Enter the following command to build and deploy archive: 
    mvn -Plibrary-tomcat clean package tomcat:deploy
  3. The target/jboss-carmart-tx.war file is deployed to the running instance of JBoss Enterprise Web Server.
Report a bug

13.8.3. View the Transactional CarMart Quickstart

The following procedure outlines how to view the CarMart quickstart:
Prerequisite

The CarMart quickstart must be built and deployed to be viewed.

Procedure 13.16. View the CarMart Quickstart

  • To view the application, use your browser to navigate to the following link: 
    http://localhost:8080/jboss-carmart-tx
Report a bug

13.8.4. Undeploy The Transactional CarMart Quickstart

Undeploy the transactional CarMart quickstart as follows:
  1. In a command line terminal, navigate to the root directory of the quickstart.
  2. Undeploy the archive as follows: 
    mvn -Plibrary-tomcat tomcat:undeploy
Report a bug

13.8.5. Test the Transactional CarMart Quickstart

The JBoss Data Grid quickstarts include Arquillian Selenium tests. To run these tests:
  1. Undeploy the archive (see Section 13.8.4, “Undeploy The Transactional CarMart Quickstart”)
  2. Stop JBoss Enterprise Web Server, if it is running.
  3. In a command line terminal, navigate to root directory for the quickstart.
  4. Build the quickstarts as follows: 
    mvn clean package
  5. Run the tests as follows: 
    mvn test -Puitests-jbossas -Das7home=/path/to/server
Report a bug