LoRS Command Line Tool Tutorial
The LoRS command line tools let you do three primary things:
They also give you the ability to see where the pieces of the file are stored (List) and to extend the allocations' expiration times (Refresh).
- Store a file into the wide-area network (Upload),
- Change where the file is located in the network (Augment or Trim), and
- Retrieve the file (Download).
The tools have built-in defaults which can be over-ridden by settings in the .xndrc preferences file.
TRIM (Remove Replicas)
If you are sending a large file to someone else, you want your upload time to be as short as possible, but you also want your recipient's download time to be as fast as possible as well. To satisfy both of you, you can upload to the closest depot, then augment the exNode to a depot near the recipient. If you need the space back on your local depot, you can then remove that replica. Removing a replica is called trim.
Let's use the above exNode foo.xnd which has 2 allocations (named 0 and 1). If we only want the allocation represented by 1, we can trim allocation 0 by:
lors_trim foo.xnd -f -m 0
This will take exNode foo.xnd, remove mapping (or block or allocation and its metadata) 0 and save the revised exNode as foo.xnd (because of the -f flag). You only removed the allocation from the exNode. The default behavior is to leave the allocation on the IBP depot and let it expire. You can explicitly free the IBP allocation by adding the -d flag (if you have the IBP Manage capability). Also, the -m argument can take list of space-separated numbers such as:
lors_trim bar.xnd -f -m 2 4 6 8 10