第16章 The CarMart Quickstarts

1. Obtain the supported JBoss Data Grid Library Mode distribution files.
2. Ensure that the JBoss Data Grid and JBoss Enterprise Application Platform Maven repositories are installed and configured. For details, see Install and Use the Maven Repositories
3. Select a JBoss server to use (JBoss Enterprise Application Platform6 (or better) or JBoss EAP6 (or better).

Build and Deploy CarMart to JBoss EAP

1. Start JBoss EAP

   Depending on your operating system, use the appropriate command from the following to start the first instance of your selected application server:

   For Linux users:

   $JBOSS_HOME/bin/standalone.sh

   For Windows users:

   $JBOSS_HOME\bin\standalone.bat

2. Navigate to the Root Directory

   Open a command line and navigate to the root directory of this quickstart.

3. Build and Deploy the Application

   Use the following command to build and deploy the application to the running instance of JBoss EAP using Maven:

   $ mvn clean package jboss-as:deploy

View the CarMart Quickstart on JBoss EAP

1. To view the application, use your browser to navigate to the following link:

   http://localhost:8080/jboss-carmart

Remove an Application from JBoss EAP

1. To remove an application, use the following from the root directory of this quickstart:

   $ mvn jboss-as:undeploy

1. Ensure that the JBoss Data Grid and JBoss Enterprise Application Platform Maven repositories are installed and configured. For details, see Install and Use the Maven Repositories
2. Select JBoss Enterprise Web Server 2 (or better) for your application and install it.

Build the CarMart Quickstart to the Server (Library Mode)

1. Start the Server

   Depending on your operating system, use the appropriate command from the following to start the first instance of your selected application server:

   For Linux users:

   $JBOSS_EWS_HOME/tomcat7/bin/catalina.sh run

   For Windows users:

   $JBOSS_EWS_HOME\tomcat7\bin\catalina.bat run

2. Navigate to the Root Directory

   Open a command line and navigate to the root directory of this quickstart.

3. Build and Deploy Your Application

   Use the following command to build and deploy your application to the running instance of the selected server using Maven:

   $ mvn -Plibrary-tomcat clean package tomcat:deploy

View the CarMart Quickstart

1. To view the application, use your browser to navigate to the following link:

   http://localhost:8080/jboss-carmart

Remove an Application from JBoss Enterprise Web Server

1. To remove an application, use the following command from the root directory of this quickstart:

   $ mvn tomcat:undeploy -Plibrary-tomcat

1. Obtain the most recent supported JBoss Data Grid Remote Client-Server Mode distribution files from RedHat.
2. Ensure that the JBoss Data Grid and JBoss Enterprise Application Platform Maven repositories are installed and configured. For details, see Install and Use the Maven Repositories

3. Select a JBoss server to use (JBoss Enterprise Application Platform 6 or later). Navigate to the root of the JBoss server directory in a terminal window and enter the following command:

   For Linux users:

   $JBOSS_HOME/bin/standalone.sh

   For Windows users:

   $JBOSS_HOME\bin\standalone.bat

Build and Deploy the CarMart Quickstart in Remote Client-Server Mode

1. Configure the Standalone File

   Add the following configuration to the standalone.xml file located in the $JDG_HOME/standalone/configuration/ directory.

   • Add the following configuration within the infinispan subsystem tags:

     <local-cache name="carcache"
     	     statistics="true">
     	<eviction strategy="LIRS"
     		  max-entries="4"/>
     </local-cache>

     注記

     If the carcache element already exists in your configuration, replace it with the provided configuration.

2. Start the JBoss Data Grid Server

   Run the following script to start the JBoss Data Grid Server:

   $JDG_HOME/bin/standalone.sh -Djboss.socket.binding.port-offset=100

3. Start the JBoss Server

   Run the following script to start the JBoss server instance where your application will deploy:

   $JBOSS_HOME/bin/standalone.sh

4. Optional: Specify the Host and Port Address

   The application uses the values in the jboss-datagrid-{VERSION}-quickstarts/carmart/src/main/resources/META-INF/[path]datagrid.properties file to locate the JBoss Data Grid server. If your JBoss Data Grid server is not running using the default host and port values, edit the file and insert the correct host and port values, as follows:

   datagrid.host=localhost
   datagrid.hotrod.port=11322

5. Navigate to the Root Directory

   Open a command line and navigate to the root directory of this quickstart.

6. Build and Deploy the Application

   Use the following command to build and deploy your application using Maven:

   $ mvn clean package jboss-as:deploy -Premote-jbossas

View the CarMart Quickstart in Remote Client-Server Mode

1. Visit the following link in a browser window to view the application:

   http://localhost:8080/jboss-carmart

Remove an Application in Remote Client-Server Mode

1. To remove an application, use the following command from the root directory of this quickstart:

   $ mvn jboss-as:undeploy -Premote-jbossas

1. Obtain the most recent supported JBoss Data Grid Remote Client-Server Mode distribution files from RedHat.
2. Ensure that the JBoss Data Grid and JBoss Enterprise Application Platform Maven repositories are installed and configured. For details, see Install and Use the Maven Repositories

3. Add a server element to the Maven settings.xml file. In the id elements within server, add the appropriate tomcat credentials.

   <server>
       <id>tomcat</id>
       <username>admin</username>
       <password>admin</password>
   </server>

Build and Deploy the CarMart Quickstart in Remote Client-Server Mode

1. Configure the Standalone File

   Add the following configuration to the standalone.xml file located in the $JDG_HOME/standalone/configuration/ directory.

   • Add the following configuration within the infinispan subsystem tags:

     <local-cache name="carcache"
     	     statistics="true">
     	<eviction strategy="LIRS"
     		  max-entries="4"/>
     </local-cache>

     注記

     If the carcache element already exists in your configuration, replace it with the provided configuration.

2. Start the Container

   Start the JBoss server instance where your application will deploy.

   For Linux:

   $JBOSS_EWS_HOME/tomcat7/bin/catalina.sh run

   For Windows:

   $JBOSS_EWS_HOME\tomcat7\bin\catalina.bat run

3. Build the Application

   Use the following command to build your application in the relevant directory:

   $ mvn clean package -Premote-tomcat

4. Deploy the Application

   Use the following command to deploy the application in the relevant directory:

   mvn tomcat:deploy -Premote-tomcat

View the CarMart Quickstart in Remote Client-Server Mode

1. Visit the following link in a browser window to view the application:

   http://localhost:8080/jboss-carmart

Remove an Application in Remote Client-Server Mode

1. To remove an application, use the following command from the root directory of this quickstart:

   $ mvn tomcat:undeploy -Premote-tomcat

1. Configure Maven (See Quickstart Prerequisites)

2. Start JBoss Enterprise Application Platform:

   1. In a command line terminal, navigate to the root of the JBoss EAP server directory.

   2. Use one of the following commands to start the server with a web profile:

      For Linux:

      $JBOSS_HOME/bin/standalone.sh

      For Windows:

      %JBOSS_HOME%\bin\standalone.bat

Build and Deploy the Transactional Quickstart

1. Open a command line and navigate to the root directory of this quickstart.

2. Enter the following command to build and deploy the archive:

   mvn clean package jboss-as:deploy

3. The target/jboss-carmart-tx.war file is deployed to the running instance of the server.

View the CarMart Quickstart

1. To view the application, use your browser to navigate to the following link:

   http://localhost:8080/jboss-carmart-tx

1. In a command line terminal, navigate to the root directory of the quickstart.

2. Undeploy the archive as follows:

   mvn jboss-as:undeploy

1. Stop JBoss EAP, if it is running.
2. In a command line terminal, navigate to root directory for the quickstart.

3. Build the quickstarts as follows:

   mvn clean package

4. Run the tests as follows:

   mvn test -Puitests-jbossas -Das7home=/path/to/server

1. Configure Maven (See 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

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.

View the CarMart Quickstart

1. To view the application, use your browser to navigate to the following link:

   http://localhost:8080/jboss-carmart-tx

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

1. Undeploy the archive (see 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