ectool

You can use the /opt/mapr/server/tools/ectool utility to dump or check the validity of the stripelets in the backend volume that is associated with the volume configured for warm tiering.

Pre-Requirements

Before you run the utility, you must ensure that the node on which you plan to run this utility meets the following requirements:

Set the path to the library (libjvm.so) in the LD_LIBRARY_PATH environment variable. If the path is not already set, use the export command to set the environment variable. For example:
```
export LD_LIBRARY_PATH=/opt/jdk1.8.0_141/jre/lib/amd64/server/
```

Syntax

/opt/mapr/server/tools/ectool <cmd> <params>

Commands

Command	Description
`dumpStripelet`	Dumps the content of a stripelet to the given file.
`listStripes`	Lists all the stripes in a given container.
`validateStripe`	Validates if the given parity stripelet is valid and matches with other stripelets of the stripe.
`validateCG`	Iterates over all the stripes of the Container Group and checks the validity using the rebuild operation.
`getFid`	Returns the fid for a Virtual Cluster Descriptor (VCD) ID.

Parameters

Parameter	Description
`cid`	The ID of the container.
`fid`	The ID of the file.
`file`	The path to the file.
`volid`	The ID of the (backend) volume, referred to as `ecstorevolume` in the CLI output, associated with the tier. The ID can be retrieved using the `volume info` command. For example: `/opt/mapr/bin/maprcli volume info -name a4 -json \| grep ecstorevolume "ecstorevolume":"mapr.internal.ec.a4.87379483", /opt/mapr/bin/maprcli volume info -name mapr.internal.ec.a4.87379483 -json \| grep volumeid "volumeid":105118862,`
vcdid	The ID of the Virtual Cluster Descriptor (VCD).

Usage

/opt/mapr/server/tools/ectool dumpStripelet volid fid file 
/opt/mapr/server/tools/ectool listStripes volid cid
/opt/mapr/server/tools/ectool validateStripe volid fid
/opt/mapr/server/tools/ectool validateCG volid cid
/opt/mapr/server/tools/ectool getFid cid vcdid

Examples

Dump the stripelet content to the file /tmp/t for the file specified by ID 2271.160.131606 in the volume specified by ID 116581327:

# /opt/mapr/server/tools/ectool dump 116581327 2271.160.131606 /tmp/t
Stripelet Read done!

List all the stripes in the container specified by ID 2271 for the volume specified by ID 116581327:

# /opt/mapr/server/tools/ectool list 116581327 2271
Inum:160 Uniq:131606 Size:4194304 
Inum:161 Uniq:131608 Size:4194304 
Inum:162 Uniq:131610 Size:4194304

Validates if the given stripelet matches with other stripelets of the stripe for the file specified by ID 2271.160.131606 in the volume specified by ID 116581327

# /opt/mapr/server/tools/ectool validateStripe 116581327 2271.160.131606
Valid Stripe

For the container specified by ID 2271, validate if all stripelets match with other stripelets of the corresponding stripe:

# /opt/mapr/server/tools/ectool validateCG 116581327 2271
Inum:160 Valid Stripe
Inum:161 Valid Stripe
Inum:162 Valid Stripe