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:

rest-proxyport-forwardinglocalhost

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

rest-proxyport-forwardinglocalhost

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"}