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 theLD_LIBRARY_PATH
environment variable. If the path is not already set, use theexport
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:
|
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