ectools

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
dump Dumps the content of a stripelet to the given file.
list Lists all the stripes in a given container.
validate Validates if the given parity stripelet is valid and matches with other stripelets of the stripe.
validateall For a given container, validates if all the stripelets are valid and matches with other stripelets of the stripe.
testECLocal

This parameter is internal-only.
testreadfull

This parameter is internal-only.

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,

Usage

/opt/mapr/server/tools/ectools dump volid fid file 
/opt/mapr/server/tools/ectools list volid cid
/opt/mapr/server/tools/ectools validate volid fid
/opt/mapr/server/tools/ectools validateall volid cid

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 validate 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 validateall 116581327 2271
Inum:160 Valid Stripe
Inum:161 Valid Stripe
Inum:162 Valid Stripe