Exit Status

ledgerutil compare

• 0 if the snapshots are identical
• 2 if the snapshots are not identical
• 1 if an error occurs

ledgerutil identifytxs

• 0 if the block store was successfully searched for transactions
• 1 if an error occurs or the block range is invalid

Example Usage

ledgerutil compare example

Here is an example of the ledgerutil compare command.

• Compare snapshots from two different peers for mychannel at snapshot height 5.

  ledgerutil compare -o ./compare_output -f 10 ./peer0.org1.example.com/snapshots/completed/mychannel/5 ./peer1.org1.example.com/snapshots/completed/mychannel/5
  
  Both snapshot public state and private state hashes were the same. No results were generated.
  

  The response above indicates that the snapshots are identical. If the snapshots were not identical, the command results will indicate where the comparison output files are written, for example:

  Successfully compared snapshots. Results saved to compare_output/mychannel_5_comparison. Total differences found: 3
  

• Note that both snapshot locations must be accessible by the command, for example by mounting volumes from two different peers, or by copying the snapshots to a common location.

ledgerutil identifytxs example

Here is an example of the ledgerutil identifytxs command.

• Identify relevant transactions in mychannel from a block store within an allowed block range. The input JSON file contains a list of keys to search for in the block store. The block range is from the earliest block in the block store to the tallest block height for any key in the input JSON file. The block store must at least have a height equal to the height of the tallest key in the input JSON file to be considered a valid block range.

  ledgerutil identifytxs compare_output/mychannel_5_comparison/first_diffs_by_height.json -o identifytxs_output
  
  Successfully ran identify transactions tool. Transactions were checked between blocks 1 and 4.
  

  The response above indicates that the local block store was successfully searched. This means transactions within the block range that wrote to keys found in the output JSON of the compare command were identified. In the newly created directory identifytxs_output, a directory mychannel_identified_transactions was generated containing a JSON file of identified transactions for each key from the compare command JSON output.

This work is licensed under a Creative Commons Attribution 4.0 International License.