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 -bg at the end of the command.

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.

java -Xms256m -Xmx2048m -jar $KVHOME/lib/kvstore.jar xrstart \
-config <complete path to the json.config file> -bg

Table 7-7 Parameters used in xrstart command

Parameter	Description
-config	Specifies the complete path where the json.config file is placed.

Once you run the xrstart command, a status.<number of agents>.<agentId>.txt is generated with the process ID of a successfully started agent.

You can view the status of the xrstart command execution by reading the contents of status.<number of agents>.<agentId>.txt.

cat <complete path to the home directory for the XRegion Service>/status.<number of agents>.<agentId>.txt

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.