-
Language:
English
-
Language:
English
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:
- Ensure an appropriate version of OpenJDK is installed. For more information, see Install OpenJDK on Red Hat Enterprise Linux.
- Download and install the latest version of JBoss Data Grid. For more information, see Download Red Hat JBoss Data Grid.
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}