Soft reset
This API allows you to restart the sequencer without losing any messages because the soft reset ensures RT retains the knowledge of what has been replicated/merged from a publisher.
Note
The soft reset guide contains all the technical details.
To call the REST API, you can use:
Endpoint
The $ENDPOINT variable below is defined as an IPC connection to the rest proxy.
bash-4.4$ cd /opt/kx/app/rt/replicator/clib/
bash-4,4$ ./rest_proxy --endpoint $ENDPOINT --target soft-reset
Endpoint
The $ENDPOINT variable below is defined as an IPC connection to the rest process of any sequencer nodes.
bash-4.4$ curl http://$ENDPOINT/soft-reset
Note
This query can be called directly on a sequencer node.
bash-4.4$ curl http://0:6000/soft-reset
Response
The response includes a response header and a payload, where the payload members are:
|
member |
type |
description |
|---|---|---|
|
hostname |
string |
The name of the sequencer node to reset. |
|
status |
string |
Success/unsuccess status of the call. |
Example
Endpoint
An example of the $ENDPOINT variable is kxi-mystream-1:5002.
bash-4.4$ cd /opt/kx/app/rt/replicator/clib/
bash-4,4$ ./rest_proxy --endpoint $ENDPOINT --target soft-reset
{"hostname":"kxi-mystream-1","status":"Resetting"}
Endpoint
An example of the $ENDPOINT variable is kxi-mystream-1:6000.
bash-4.4$ curl http://$ENDPOINT/soft-reset
{"hostname":"kxi-mystream-1","status":"Resetting"}
Note
First, you must connect to a sequencer node.
bash-4.4$ curl http://0:6000/soft-reset
{"hostname":"kxi-mystream-1","status":"Resetting"}