PingDS 8.0.0

changelogstat

changelogstat — debug changelog and changenumber files

Synopsis

changelogstat {subcommand} {options}

Description

This utility can be used to debug changelog and changenumber files.

Options

The changelogstat command takes the following options:

-V | --version

Display Directory Server version information. Default: false

-H | --help

Display this usage information. Default: false

Subcommands

The changelogstat command supports the following subcommands:

changelogstat dump-change-number-db

changelogstat dump-change-number-db {options}

Dump the change number DB.

Options

In addition to the global changelogstat options, the changelogstat dump-change-number-db subcommand takes the following options:

--from {change number}

The lower bound of the range of change numbers to dump.

--outputDir {directory}

The output directory for the dump files.

--to {change number}

The upper bound of the range of change numbers to dump.

changelogstat dump-replica-db

changelogstat dump-replica-db {options} baseDN replicaID

Dump the replica DB for a given domain and replica.

Options

In addition to the global changelogstat options, the changelogstat dump-replica-db subcommand takes the following options:

--from {csn}

The lower bound of the range of changes to dump.

--outputDir {directory}

The output directory for the dump files.

--to {csn}

The upper bound of the range of changes to dump.

changelogstat dump-replica-db-file

changelogstat dump-replica-db-file {options} file

Dump a replica DB file.

Options

In addition to the global changelogstat options, the changelogstat dump-replica-db-file subcommand takes the following options:

--baseDn {base dn}

The base-dn of the changes contained in the provided replica DB file. Default:

--from {csn}

The lower bound of the range of changes to dump.

--to {csn}

The upper bound of the range of changes to dump.

Exit codes

0

The command completed successfully.

1

An error occurred.

Examples

To dump the records for change numbers 10 to 15:

$ changelogstat dump-change-number-db --from 10 --to 15
{ "changeNumber": 10, "baseDn": "dc=example,dc=com", "csn": { "value": "010f017f87c4135d00025abdevaluation-only", "serverId": "evaluation-only", "timestamp": "...", "seqnum": 154301 } }
{ "changeNumber": 11, "baseDn": "dc=example,dc=com", "csn": { "value": "010f017f87c4135d00025abeevaluation-only", "serverId": "evaluation-only", "timestamp": "...", "seqnum": 154302 } }
{ "changeNumber": 12, "baseDn": "dc=example,dc=com", "csn": { "value": "010f017f87c4135d00025abfevaluation-only", "serverId": "evaluation-only", "timestamp": "...", "seqnum": 154303 } }
{ "changeNumber": 13, "baseDn": "dc=example,dc=com", "csn": { "value": "010f017f87c4135d00025ac0evaluation-only", "serverId": "evaluation-only", "timestamp": "...", "seqnum": 154304 } }
{ "changeNumber": 14, "baseDn": "dc=example,dc=com", "csn": { "value": "010f017f87c4135d00025ac1evaluation-only", "serverId": "evaluation-only", "timestamp": "...", "seqnum": 154305 } }
{ "changeNumber": 15, "baseDn": "dc=example,dc=com", "csn": { "value": "010f017f87c4135d00025ac2evaluation-only", "serverId": "evaluation-only", "timestamp": "...", "seqnum": 154306 } }

To dump the replica DB for the domain dc=example,dc=com and the server with ID ds-1 :

$ changelogstat dump-replica-db --outputDir myOutputDir dc=example,dc=com ds-1
$ cat myOutputDir/010d018fdcbb887700000086ds-1.cdb.txt
{ "msgType": "AddMsg", "dn": "uid=newuser,ou=People,dc=example,dc=com", "csn": { "value": "010d018fdcbb887700000086ds-1", "serverId": "ds-1", "...": "time", "seqnum": 134 }, "uniqueId": "477f0607-ba42-4d8f-93a2-639c668b8d83" }
{ "msgType": "DeleteMsg", "dn": "uid=newuser,ou=People,dc=example,dc=com", "csn": { "value": "010d018fdcbb998800000097ds-1", "serverId": "ds-1", "timestamp": "...", "seqnum": 151 }, "uniqueId": "477f0607-ba42-4d8f-93a2-639c668b8d83" }
{ "msgType": "ReplicaOfflineMsg", "csn": { "value": "010d018fdcbc45400000011bds-1", "serverId": "ds-1", "timestamp": "...", "seqnum": 283 } }

To dump a specific replica DB file:

$ changelogstat dump-replica-db-file changelogDb/2.dom/1.server/01010166aaf2a3e3000002bd1.cdb

{ "msgType": "ModifyMsg", "dn": "uid=user.84614,ou=people", "csn": "010f017f87c42baa0002f04fevaluation-only", "uniqueId": "83719220-5de4-3271-a2a1-49f719778533" }
{ "msgType": "ModifyMsg", "dn": "uid=user.67749,ou=people", "csn": "010f017f87c42baa0002f050evaluation-only", "uniqueId": "981f226e-5dff-35b3-b95f-6cfd582633ab" }
{ "msgType": "ModifyMsg", "dn": "uid=user.15128,ou=people", "csn": "010f017f87c42baa0002f051evaluation-only", "uniqueId": "d0146ad4-ae04-3c93-b0e1-92c627f0bdae" }
{ "msgType": "ModifyMsg", "dn": "uid=user.56721,ou=people", "csn": "010f017f87c42baa0002f052evaluation-only", "uniqueId": "3a578584-5e9d-3835-a7d4-1f5c78e41325" }
...
{ "msgType": "ModifyMsg", "dn": "uid=user.58621,ou=people", "csn": "010f017f87c439c900035566evaluation-only", "uniqueId": "0281f279-b441-3018-9036-f6f97bf3903a" }
{ "msgType": "ModifyMsg", "dn": "uid=user.6745,ou=people", "csn": "010f017f87c439c900035567evaluation-only", "uniqueId": "90853018-3abb-3e88-9fb2-0477919c067d" }
{ "msgType": "ModifyMsg", "dn": "uid=user.28215,ou=people", "csn": "010f017f87c439c900035568evaluation-only", "uniqueId": "abfe1a55-5c64-36e8-8714-7d6e1f6d67aa" }
{ "msgType": "ModifyMsg", "dn": "uid=user.86811,ou=people", "csn": "010f017f87c439c900035569evaluation-only", "uniqueId": "0810f7af-94ea-3f34-a455-c22432ad9429" }