Chapter 7. Run Red Hat JBoss Data Grid in Remote Client-Server Mode

7.1. Prerequisites

The following is a list of prerequisites to run Red Hat JBoss Data Grid in Remote Client-Server mode for the first time:

7.2. Run Red Hat JBoss Data Grid in Standalone Mode

Standalone mode refers to a single instance of Red Hat JBoss Data Grid operating in local mode. In local mode, JBoss Data Grid operates as a simple single node in-memory data cache.

Run the following script to start JBoss Data Grid in standalone mode:

$JDG_HOME/bin/standalone.sh

This command starts JBoss Data Grid using the default configuration information provided in the $JDG_HOME/standalone/configuration/standalone.xml file.

7.3. Run Red Hat JBoss Data Grid in Clustered Mode

Clustered mode refers to a cluster made up of two or more Red Hat JBoss Data Grid standalone instances.

Run the following script to start JBoss Data Grid in clustered mode:

$JDG_HOME/bin/standalone.sh -c clustered.xml

This command starts JBoss Data Grid using the default configuration information provided in the $JDG_HOME/standalone/configuration/clustered.xml file.

7.4. Run Red Hat JBoss Data Grid in a Managed Domain

A managed domain allows multiple server instances and groups to be centrally managed from the Administration Console of the domain controller.

Run the following script to start JBoss Data Grid in a managed domain:

$JDG_HOME/bin/domain.sh

This command starts JBoss Data Grid using the default configuration information provided in the $JDG_HOME/domain/configuration/domain.xml and $JDG_HOME/domain/configuration/host.xml files.

7.5. Run Red Hat JBoss Data Grid with a Custom Configuration

To run Red Hat JBoss Data Grid with a custom configuration, add a configuration file to the $JDG_HOME/standalone/configuration directory.

Use the following command to specify the created custom configuration file for standalone mode:

$JDG_HOME/bin/standalone.sh -c ${FILENAME}

The -c used for this script does not allow absolute paths, therefore the specified file must be available in the $JDG_HOME/standalone/configuration directory.

If the command is run without the -c parameter, JBoss Data Grid uses the default configuration.

As a managed domain is configured with two separate files, domain.xml and host.xml by default, there are two separate flags for specifying custom configuration files.

To define the custom configuration file for the server group profiles, use the -c parameter as described above, and demonstrated in the following command:

$JDG_HOME/bin/domain.sh -c ${FILENAME}

To define the custom configuration file for the servers use the --host-config parameter, as demonstrated in the following command:

$JDG_HOME/bin/domain.sh --host-config=${FILENAME}

7.6. Set an IP Address to Run Red Hat JBoss Data Grid

For production use, the Red Hat JBoss Data Grid server must be bound to a specified IP address rather than to 127.0.0.1/localhost. Use the -b parameter with the script to specify an IP address.

For standalone mode, set the IP address as follows:

$JDG_HOME/bin/standalone.sh -b ${IP_ADDRESS}

For domain mode, set the IP address for the host controller and any servers as follows:

$JDG_HOME/bin/domain.sh -b ${IP_ADDRESS}