13.5. The (Non-transactional) CarMart Quickstart in Remote Client-Server Mode (JBoss EAP)

The Carmart (non-transactional) quickstart is supported for JBoss Data Grid's Remote Client-Server Mode with the JBoss Enterprise Application Platform container.

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

This quickstart accesses Red Hat JBoss Data Grid via Hot Rod. This feature is not available for the Transactional CarMart quickstart.

Important

This quickstart deploys to JBoss Enterprise Application Platform. The application cannot be deployed to JBoss Data Grid because it does not support application deployment.
Prerequisites

Prerequisites for this procedure are as follows:

  1. Obtain the most recent supported JBoss Data Grid Remote Client-Server Mode distribution files from Red Hat.
  2. Ensure that the JBoss Data Grid and JBoss Enterprise Application Platform Maven repositories are installed and configured. For details, see Chapter 3, Install and Use the Maven Repositories
  3. Select a JBoss server to use (JBoss Enterprise Application Platform 6 (or better). 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

Procedure 13.7. 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.
    1. Add the following configuration within the infinispan subsystem tags:
      <local-cache name="carcache" 
      	     start="EAGER" 
      	     batching="false"
      	     statistics="true">
      	<eviction strategy="LIRS" 
      		  max-entries="4"/>
      </local-cache>

      Note

      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/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. Build and Deploy the Application

    Use the following command to build and deploy your application in the relevant directory:
    $ mvn clean package jboss-as:deploy -Premote-jbossas

13.5.2. View the CarMart Quickstart in Remote Client-Server Mode

The following procedure outlines how to view the CarMart quickstart in Red Hat JBoss Data Grid's Remote Client-Server Mode:
Prerequisite

The CarMart quickstart must be built and deployed be viewed.

Procedure 13.8. View the CarMart Quickstart in Remote Client-Server Mode

  • Visit the following link in a browser window to view the application:
    http://localhost:8080/jboss-carmart

13.5.3. Remove the CarMart Quickstart in Remote Client-Server Mode

The following procedure provides directions to remove an already deployed application in Red Hat JBoss Data Grid's Remote Client-Server mode.

Procedure 13.9. Remove an Application in Remote Client-Server Mode

  • To remove an application, use the following command:
    $ mvn jboss-as:undeploy -Premote-jbossas