The operations of uploading files to pithos as objects, and downloading objects from pithos as files are presented in this section.
Enter file context
$ kamaki
[kamaki]: file
[file]:
First, check the files at the current directory
[file]: ! ls -F
file2upload.txt
dir2upload/
[file]: list
pithos (36MB, 5 objects)
trash (0B, 0 objects)
Note
the ! symbol is used to run host shell commands
Upload file2upload.txt to remote container pithos
[file]: upload file2upload.txt pithos
Uploading /home/someuser/file2upload.txt --> pithos:file2upload.txt
Done
Check remote container pithos to confirm
[file]: list pithos
2 KB file2upload.txt
2KB info.txt
D video/
11MB video/tk1.mpg
12MB video/tk2.mpg
13MB video/tk3.mpg
[file]:
Attempt to upload a whole directory, fail and retry with correct arguments
[file]: upload dir2upload pithos
/home/someuser/dir2upload is a directory
| Use -R to upload directory contents
[file]: upload -R dirupload pithos
mkdir pithos:dir2upload
Uploading /home/someuser/dir2upload/large.mov --> pithos:dir2upload/large.mov
Uploading /home/someuser/dir2upload/small.mov --> pithos:dir2upload/small.mov
Done
[file]: list pithos
D dir2upload/
1GB dir2upload/large.mov
1MB dir2upload/small.mov
2 KB file2upload.txt
2KB info.txt
D video/
11MB video/tk1.mpg
12MB video/tk2.mpg
13MB video/tk3.mpg
[file]:
Note
Try to reupload the files (use the -f option to override) and notice how much faster is the uploading now. Pithos can determine what parts (blocks) of the file are already uploaded. Kamaki will, then, upload only the missing pars, if any.
Download object info.txt as a local file of the same name
[file]: download pithos:info.txt
Downloading pithos:info.txt --> /home/someuser/info.txt
Donw
[file]:
Download directory video as a local directory with its contents. We will suppose that a power failure causes the operation to stop unexpectingly before it’s completed.
[file]: download -R pithos:video
mkdir video
Downloading pithos:video/tk1.mpg --> /home/someuser/video/tk1.mpg
Done
Downloading pithos:video/tk2.mpg --> /home/someuser/video/tk2.mpg
<POWER FAILURE>
After we recover the terminal and load kamaki in file context, we find out that tk1.mpg had been downloaded while tk2.mpg download is incomplete.
$ ls -F video
tk1.mpg 11MB
tk2.mpg 4MB
$
Let’s resume the download (use -r)
[file]: download -R pithos:video
Directory video already exists
| Use -r to resume
[file]: download -R -r pithos:video
Resuming pithos:video/tk2.mpg --> /home/someuser/video/tk2.mpg
Downloading pithos:video/tk3.mpg --> /home/someuser/video/tk3.mpg
Done
[file]:
[file]: upload -R -f . pithos
Done
[file]:
Note
In this case, all files were already uploaded, so kamaki didn’t have to upload anything. If a file was modified, kamaki would sync it with its remote counterpart.
[file]: download -R -r pithos
Done
[file]:
Note
Kamaki determined that all remote objects already exist as local files too, so there is nothing to be done. If a new remote object was created or an old one was modified, kamaki would have sync it with a local file.
[file]: exit
[kamaki]: