github.com/m3db/m3@v1.5.1-0.20231129193456-75a402aa583b/src/cmd/tools/verify_index_files/README.md (about)

     1  # verify_index_files
     2  
     3  `verify_index_files` is a utility to verify a set of index files to ensure that they are congruent with each other. Primarily, we sometimes use it as a final sanity test when making changes to the peer bootstrapping process. We can force a new node to join, and when its done we can verify that its index file matches that of its peers (they should have all the same series / checksums).
     4  
     5  # Usage
     6  
     7  ```bash
     8  $ git clone git@github.com:m3db/m3.git
     9  $ make verify_index_files
    10  $ ./bin/verify_index_files -h
    11  ```
    12  
    13  # Example usage
    14  
    15  ```bash
    16  ./verify_index_files \
    17    -path-prefix ./hosts-data \
    18    -namespace metrics \
    19    -blocks 1513756800,1513764000,1513771200 \
    20    -shards 0,1,2,3,4,5
    21  ```
    22  
    23  The directory that `path-prefix` points to must be a directory where each subdirectory is the name of the host and within each of those subdirectories is the "data" directory for that host, exactly as generated by M3DB itself.
    24  
    25  Example:
    26  
    27  ```
    28  /hosts-data
    29      /host1
    30        /data
    31          /metrics
    32            /0
    33              <all filset files for namespace "metrics", shard 0, and blocks: 1513756800,1513764000,1513771200>
    34            /1
    35              <all filset files for namespace "metrics", shard 1, and blocks: 1513756800,1513764000,1513771200>
    36          ...
    37      /host2
    38        <Same as host1>
    39      /host3
    40        <Same as host1>
    41  ```