10.2.3. Service THL Endpoints

A few endpoints are provided to get information about the service THL or to manipulate it, these are as follows:

  • index

  • info

  • encryption

  • compression

  • genkey

  • inflight-protocol

These GET requests provide information about THL, for example to view THL Metadata (Equivalent to isssuing thl info, the following GET call can be used. An example of the output follows:

info : THL metadata

GET 'https://127.0.0.1:8097/api/v8/replicator/services/west/thl/info'
{
    "payloadType": "THLInfoPayload",
    "payloadVersion": "1",
    "payload": {
        "logDirectory": "/opt/continuent/thl/europe/",
        "logFiles": 1,
        "logSizeinMB": 10.775296,
        "minSeqno": 0,
        "maxSeqno": 3600,
        "events": 3600,
        "oldestFile": {
            "name": "thl.data.0000000001",
            "lastModified": 1742995271000,
            "sizeInMB": 10.775296
        },
        "newestFile": {
            "name": "thl.data.0000000001",
            "lastModified": 1742995271000,
            "sizeInMB": 10.775296
        }
    }
}

Other valid GET calls are as follows:

index : THL files index

GET 'https://127.0.0.1:8097/api/v8/replicator/services/west/thl/index'

encryption : encryption state of THL (enabled or not)

GET 'https://127.0.0.1:8097/api/v8/replicator/services/west/thl/encryption'

compression : compression state of THL (enabled or not)

GET 'https://127.0.0.1:8097/api/v8/replicator/services/west/thl/compression'

For more detail please refer to the Replicator Developer Documentation.

10.2.3.1. compression / encryption

When used with a PUT request, this will turn on or off either compression or encryption.

PUT 'https://127.0.0.1:8097/api/v8/replicator/services/west/thl/encryption'

Here is an example to turn encryption on :

{
  "payloadType": "BooleanPayload",
  "payloadVersion": "1",
  "payload": {
    "value": true
  }
}

The service has to be offline to turn compression / encryption on or off.

10.2.3.2. genkey

This is a POST request that will ask the replicator to generate a new encryption key for the THL.

The service has to be online to generate a new THL key.