Using nearline storage: Difference between revisions

From Alliance Doc
Jump to navigation Jump to search
Line 10: Line 10:


== How to use ==
== How to use ==
To use Nearline, just put files into your <code>~/nearline/PROJECT</code> directory. After a period of time (currently 24 hours), they'll be copied onto tape.  If the file remains unchanged for another period (also 24h), the copy on disk will be removed, making the file virtualized on tape.   
To use Nearline, just put files into your <tt>~/nearline/PROJECT</tt> directory. After a period of time (currently 24 hours), they'll be copied onto tape.  If the file remains unchanged for another period (also 24h), the copy on disk will be removed, making the file virtualized on tape.   


Like most HPC storage, it's bad practice to have lots of small files.  In fact, files smaller than a certain threshold size may not be moved to tape at all.  So if you have large collections of small files, it's wise to bundle them using a tool like [[Archiving and compressing files|tar]].  
Like most HPC storage, it's bad practice to have lots of small files.  In fact, files smaller than a certain threshold size may not be moved to tape at all.  So if you have large collections of small files, it's wise to bundle them using a tool like [[Archiving and compressing files|tar]].  


If you remove a file in <code>~/nearline</code>, the tape copy will be retained for up to 60 days. To restore such a file, contact [[technical support]] with the full path for the file(s) and desired version (by date), just as you would for [[Storage and file management#Filesystem Quotas and Policies|backup]] restoration.
If you remove a file in <tt>~/nearline</tt>, the tape copy will be retained for up to 60 days. To restore such a file, contact [[technical support]] with the full path for the file(s) and desired version (by date), just as you would for [[Storage and file management#Filesystem Quotas and Policies|backup]] restoration. Note that since you will need the full path for the file, it is important for you to retain a copy of the complete directory structure of your Nearline space. For example, you can run the command <tt>ls -R > ~/nearline_contents.txt</tt> from the <tt>~/nearline/PROJECT</tt> directory so that you have a copy of the location of all the files in your Nearline space.

Revision as of 18:25, 25 September 2018


This article is a draft

This is not a complete article: This is a draft, a work in progress that is intended to be published into an article, which may or may not be ready for inclusion in the main wiki. It should not necessarily be considered factual or authoritative.




Nearline is a filesystem virtualized onto tape

Nearline storage is like Project, except that files can be "virtualized" by moving them to tape. This is a way to manage less-used files. On tape they do not consume your disk quota, but they can still be accessed, albeit more slowly.

This is useful because the capacity of our tape libraries is both large and expandable. When a file has been moved to tape (that is, "virtualized"), it will still appear in the directory listing. If the virtual file is read, the reading process will block for some period, probably a few minutes, while the file contents are read from tape to disk. Then IO to the file will behave like any other disk-based file.

Expected use

Because of the delay in reading from tape, Nearline is not intended to be used by jobs, where the delay would waste allocated time. It is only accessible from login and DTN nodes.

How to use

To use Nearline, just put files into your ~/nearline/PROJECT directory. After a period of time (currently 24 hours), they'll be copied onto tape. If the file remains unchanged for another period (also 24h), the copy on disk will be removed, making the file virtualized on tape.

Like most HPC storage, it's bad practice to have lots of small files. In fact, files smaller than a certain threshold size may not be moved to tape at all. So if you have large collections of small files, it's wise to bundle them using a tool like tar.

If you remove a file in ~/nearline, the tape copy will be retained for up to 60 days. To restore such a file, contact technical support with the full path for the file(s) and desired version (by date), just as you would for backup restoration. Note that since you will need the full path for the file, it is important for you to retain a copy of the complete directory structure of your Nearline space. For example, you can run the command ls -R > ~/nearline_contents.txt from the ~/nearline/PROJECT directory so that you have a copy of the location of all the files in your Nearline space.