// DM Commands

Files managed under DMF can be in one of several states.

State Description
UNM are in the process of moving from tape to disk, also known as "unmigrating".
REG are not managed by DMF. Directories fall in this category.
OFL are offline, they are on tape only.
MIG are in the process of migrating from disk to tape.
DUL are in dual state, that is, they are available on disk and tape.

DM Commands

Command Description Usage
dmls The dmls command on dirac lets you know the state of a file. $ dmls -l $ARCHIVE/results
dmdu The dmdu command gives you a reasonable estimate of how much space is used in a directory by all files, those on disk and offline on tape. In contrast, du accounts for files only on disk and has no idea about the tapes. $ cd $ARCHIVE
$ dmdu -sk ./data
dmfind The normal find command will find all files whether they are offline or not, because the directory structure itself is always on disk, only the actual files are migrated to tape. Therefore, we suggest using the DMF aware dmfind command, which works similarly to the find command, but can tell the difference between DMF states. $ dmfind $ARCHIVE -type f -state OFL
# this command prints all files that are offline
dmget The dmget command is used to recall a file from tape to the disk cache. This could take a while. After completion the state of affected file changes from offline (OFL) to dual (DUL). Copying offline files to your $NOBACKUP is allowed, but you will endure the additional wait time caused by the implicit unmigration process to complete. $ dmget data2.tar
dmtag The dmtag command is used to check or set the sitetag of a file. More information $ dmtag -t 2 list-of-archive-files

If you need to recall more than a few hundred files at a time, consider asking us to organize your list by tape, so that you can recall the list in groups without overloading the tape system. Also, please be cognizant of the amount of data you recall at once. If you need to recall multiple terabytes of data, please request our help.