ectool

Dumps or checks the validity of the stripelets in the backend volume that is associated with the volume configured for warm tiering.

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