When you select
Settings on your TFS™ on Sawtooth deployment you are presented
with this screen:
There are five tabs each of which is described in detail below.
This tab provides you with the docker command you can use to spin up a TFS™ client that lets you interact with your deployment using the TFS™ CLI.
Note that the docker command works correctly only if you connect to Sextant via a load balancer otherwise the TFS_URL is malformed.
This tab lets you create TFS™ keys for use when creating encrypted TFS™ volumes:
You need to save the key locally as this is generated by Sextant but not retained by it.
This tab lets you create TFS™ volumes. Here we are creating
encrypting it using
Having encrypted this volume we will need the key we saved earlier to read from or write to it but it is now listed:
This tab also lets us interact with the volumes. We can either
Create a Snapshot or
Edit each volume using the three icons.
Edit lets you change the name of a volume:
Create a Snapshot switches the context to the
TFS™ Snapshots pane
and lets you create a snapshot of your volume.
Here we are creating a second snapshot
Which now appears in the snapshot list:
Before taking a closer look at the explorer, let's run a TFS™ CLI session using our docker command to spin up a tfs-client container:
[email protected]:/$ tfs-cli volume list VOLUME NAME VOLUME UUID COMPRESSION ENCRYPTION vol002 caa56fc3-2206-4d52-8c7e-81b600bab5bf NONE NONE vol001 102f91d4-aeaa-4e40-b60b-f036f2844790 LZ4 AES_GCM [email protected]:/$ ls /mnt/tfs [email protected]:/$ tfs-fuse -v vol002 -m /mnt/tfs [email protected]:/$ cd /mnt/tfs [email protected]:/mnt/tfs$ ls [email protected]:/mnt/tfs$ echo "hello world" > hello-world.txt [email protected]78df5774:/mnt/tfs$ cat hello-world.txt hello world [email protected]:/mnt/tfs$ ls hello-world.txt [email protected]:/mnt/tfs$
The explorer lets you drill down on individual volumes such as
vol002 and, as
you can see, this lists the file
hello-world.txt created in that session:
At this point you can
Open or request
Info on this file.
Opening it shows that the content mirrors the CLI session above:
Requesting its information provides you with the following readout:
Next we create (not shown) a snapshot
vol002 which is reflected
in the explorer:
Next we return to our TFS™ CLI session where we can list the snapshot then
create a second file
[email protected]:/mnt/tfs$ tfs-cli volume snapshot list vol002 SNAPSHOT NAME snap001 [email protected]:/mnt/tfs$ echo "I think therefore I am" > descartes.txt [email protected]:/mnt/tfs$ cat descartes.txt I think therefore I am [email protected]:/mnt/tfs$ [email protected]:/mnt/tfs$ ls descartes.txt hello-world.txt
Returning to the explorer and looking at
latest we can see the new file:
The snapshots are stored in a hidden read-only directory
you can see if you switch back to the TFS™ CLI session:
[email protected]:/mnt/tfs$ ls -ltr total 0 -rw-r--r-- 1 user user 12 Dec 7 21:44 hello-world.txt -rw-r--r-- 1 user user 23 Dec 7 22:22 descartes.txt [email protected]:/mnt/tfs$ ls -ltr .snapshots/ total 0 dr--r--r-- 1 root root 0 Dec 7 21:07 snap001 [email protected]:/mnt/tfs$ ls -ltr .snapshots/snap001/ total 0 -rw-r--r-- 1 user user 12 Dec 7 21:44 hello-world.txt [email protected]:/mnt/tfs$
SXT-867 TFS™ Explorer doesn't support encrypted volumes at present.