xrstart

In a multi-region setup, you must start the XRegion service in each region using the xrstart command providing the complete path to the JSON config file. As this service is a long-running process, it is recommended to invoke it as a background process by appending the & at the end of the command. You use the Linux nohup command (short for no hang up) to keep the processes running even after exiting the shell or terminal.

Note:

The local KVStore must be started before starting the XRegion Service. If the KVStore in the local region has not started or is not reachable, the XRegion Service will not start.

nohup java -Xms256m -Xmx2048m -jar $KVHOME/lib/kvstore.jar xrstart \
-config <complete path to the json.config file> > \
<complete path to the home directory for the XRegion Service>/nohup.out &

Table 7-7 Parameters used in xrstart command

Parameter	Description
-config	Specifies the complete path where the json.config file is placed.
>	Instructs to redirect the output to the file specified next to it.
nohup.out	Specifies the file to be used for logging the status messages.

Optionally, you can view the status of the xrstart command execution by reading the contents of nohup.out.

cat <complete path to the home directory for the XRegion Service>/nohup.out

You can even check the detailed logs in the service log, that is available in the XRegion Service home directory specified in the XRegion Service configuration file (json.config) earlier.