Red Hat Summit13.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.
13.8.1. Quickstart Prerequisites
Copy linkLink copied to clipboard!
The prerequisites for this quickstart are as follows:
- Java 6.0 (Java SDK 1.6) or better
- JBoss Enterprise Application Platform 6.x or JBoss Enterprise Web Server 2.x
- Maven 3.0 or better
- Configure the Maven Repository. For details, see Chapter 3, Install and Use the Maven Repositories
13.8.2. Build and Deploy the Transactional CarMart Quickstart
Copy linkLink copied to clipboard!
Prerequisites
Ensure that the following prerequisites are met before building and deploying the CarMart quickstart.
- Configure Maven (See Section 13.8.1, “Quickstart Prerequisites”)
- To configure JBoss Enterprise Web Server, add the following lines to the
conf/tomcat-users.xmlfile:<role rolename="manager-script"/> <user username="admin" password="admin" roles="manager-script"/><role rolename="manager-script"/> <user username="admin" password="admin" roles="manager-script"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Configure Maven by adding the following configuration information to the Maven
settings.xmlfile with the appropriate credentials:<server> <id>tomcat</id> <username>admin</username> <password>admin</password> </server>
<server> <id>tomcat</id> <username>admin</username> <password>admin</password> </server>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Start JBoss Enterprise Web Server:
- In a command line terminal, navigate to the root of the JBoss Enterprise Web Server directory.
- Use one of the following commands to start the server with a web profile:For Linux:
$TOMCAT_HOME/bin/catalina.sh run
$TOMCAT_HOME/bin/catalina.sh runCopy to Clipboard Copied! Toggle word wrap Toggle overflow For Windows:%TOMCAT_HOME%\bin\catalina.bat run
%TOMCAT_HOME%\bin\catalina.bat runCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Procedure 13.15. Build and Deploy the Transactional CarMart Quickstart
- In a command line terminal, navigate to the root directory for the quickstart.
- Enter the following command to build and deploy archive:
mvn -Plibrary-tomcat clean package tomcat:deploy
mvn -Plibrary-tomcat clean package tomcat:deployCopy to Clipboard Copied! Toggle word wrap Toggle overflow - The
target/jboss-carmart-tx.warfile is deployed to the running instance of JBoss Enterprise Web Server.
13.8.3. View the Transactional CarMart Quickstart
Copy linkLink copied to clipboard!
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
http://localhost:8080/jboss-carmart-txCopy to Clipboard Copied! Toggle word wrap Toggle overflow
13.8.4. Undeploy The Transactional CarMart Quickstart
Copy linkLink copied to clipboard!
Undeploy the transactional CarMart quickstart as follows:
- In a command line terminal, navigate to the root directory of the quickstart.
- Undeploy the archive as follows:
mvn -Plibrary-tomcat tomcat:undeploy
mvn -Plibrary-tomcat tomcat:undeployCopy to Clipboard Copied! Toggle word wrap Toggle overflow
13.8.5. Test the Transactional CarMart Quickstart
Copy linkLink copied to clipboard!
The JBoss Data Grid quickstarts include Arquillian Selenium tests. To run these tests:
- Undeploy the archive (see Section 13.8.4, “Undeploy The Transactional CarMart Quickstart”)
- Stop JBoss Enterprise Web Server, if it is running.
- In a command line terminal, navigate to root directory for the quickstart.
- Build the quickstarts as follows:
mvn clean package
mvn clean packageCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Run the tests as follows:
mvn test -Puitests-jbossas -Das7home=/path/to/server
mvn test -Puitests-jbossas -Das7home=/path/to/serverCopy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}