---
title: changelogstat
description: changelogstat — debug changelog and changenumber files
component: pingds
version: 8.1
page_id: pingds:tools-reference:changelogstat
canonical_url: https://docs.pingidentity.com/pingds/8.1/tools-reference/changelogstat.html
section_ids:
  synopsis: Synopsis
  changelogstat-description: Description
  changelogstat-options: Options
  changelogstat-subcommands: Subcommands
  changelogstat_dump_change_number_db: changelogstat dump-change-number-db
  options: Options
  changelogstat_dump_replica_db: changelogstat dump-replica-db
  options_2: Options
  changelogstat_dump_replica_db_file: changelogstat dump-replica-db-file
  options_3: Options
  exit_codes: Exit codes
  changelogstat-examples: Examples
---

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