Skip to content

Hard reset

This API removes all messages from the RT stream to allow RT to be restarted with an empty stream.

Info

The hard 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 of any sequencer nodes.

bash-4.4$ cd /opt/kx/app/rt/replicator/clib/
bash-4,4$ ./rest_proxy --endpoint $ENDPOINT --target hard-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/hard-reset

Note

This query can be called directly on a sequencer node.

bash-4.4$ curl http://0:6000/hard-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 hard-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/hard-reset
{"hostname":"kxi-mystream-1","status":"Resetting"}

Note

First, you must connect to a sequencer node.

bash-4.4$ curl http://0:6000/hard-reset
{"hostname":"kxi-mystream-1","status":"Resetting"}