The HECToR Service is now closed and has been superceded by ARCHER.

The HECToR Archiver is now Read Only. Please use the UK Research Data Facility (UK-RDF) for long term data storage. Instructions are provided below to help you list and retrieve data from the Archiver.

This section outlines how you can query the archiver using the creslist command.

Listing Archived Content

The creslist command allows you to query the archiver to list currently archived data.

Command Usage

The creslist command takes the following form:

creslist [-s mm/dd/yyyy [HH:MM:SS]] [-e mm/dd/yyyy [HH:MM:SS]] \
         [-u user|ALL] [-k "keyword"] file|directory|-a|-A

with options:

-s, -e
Only show data archived between these dates.
-k
Only show data archived with this keyword.
-a
List all archived data that has an associated keyword.
-A
Show all archives (even those with no keyword).
-u user
List archives created by specified user. The special keyword "ALL" lists archives created by all users who have granted you archive access.

Note: file|directory should be an absolute path in your "work" filesystem. If file|directory is omitted then a list of all the archived data (matching other options) will be displayed.

Examples

List all archived data which have associated keywords

user@nid00012:/work/x01/x01/user> creslist -a

Archive Time      Keyword
----------------  -----------------------
10/21/2009 14:38  first production run
10/21/2009 14:36  with a space
10/13/2009 13:42  oct14.1
10/06/2009 19:22  oct6.4
10/06/2009 19:21  oct6.4

List all archived data with a specific keyword

Once you have identified the keyword you are interested in then you can list all the archived data associated with a particular keyword with the -k option. For example:

user@nid00012:/work/x01/x01/user> creslist -k 'first production run'

Archive Time      Keyword                  Mod Time         Path
----------------  -----------------------  ---------------  --
10/21/2009 14:38  first production run     Oct 21 14:35:18  /work/x01/x01/user/my_results

Note: wildcards can be used in the keyword. For example:

user@nid00012:/work/x01/x01/user> creslist -k with*

Archive Time      Keyword       Mod Time         Path
----------------  ------------  ---------------  -------------
10/21/2009 14:36  with a space  Oct 21 14:35:18  /work/x01/x01/user/more_data

List all data archived in a date/time range

You can also list data that was archived in a specifed date/time range using the -s and -e options to creslist. For example:

user@nid00012:/work/x01/x01/user> creslist -s 10/21/2009 -e 10/21/2009

Archive Time      Keyword                  Mod Time         Path
----------------  ----------------------   ---------------  ------------
10/21/2009 14:36  with a space             Oct 21 14:35:18  /work/x01/x01/user/more_data
10/21/2009 14:38  first production run     Oct 21 14:35:18  /work/x01/x01/user/my_results

List all archived data with a specific path

If you give a specific path to the creslist command then it will return a list of all archived data that was archived from below that path in the filesystem tree.

user@nid00012:/work/x01/x01/user> creslist /work/x01/x01/user/folder

Archive Time      Keyword                  Mod Time         Path
----------------  -----------------------  ---------------  ------------
10/21/2009 14:34                           Sep 26 12:18:58  /work/x01/x01/user/folder/4
10/21/2009 14:34                           Sep 26 12:19:10  /work/x01/x01/user/folder/5
10/21/2009 14:34                           Sep 15 10:21:42  /work/x01/x01/user/folder/6/sub/7

List all archived data by using a wildcard in the path

You can also include wildcards in the specific path that you want to list.

user@nid00012:/work/x01/x01/user> creslist "/work/x01/x01/user/m*"

Archive Time      Keyword                  Mod Time         Path
----------------  ----------------------   ---------------  ------------
10/21/2009 14:36  with a space             Oct 21 14:35:18  /work/x01/x01/user/more_data
10/21/2009 14:38  first production run     Oct 21 14:35:18  /work/x01/x01/user/my_results

Note that the quotes are required to prevent the shell from expanding the wildcard.

List Files archived by another user who has granted you access

user@nid00012:/work/x01/x01/user> creslist -u auser  urand


Archive Time      Keyword   Mod Time         Path
----------------  --------  ---------------  ----------------
01/14/2011 11:40            Nov 27 18:47:03 /work/y09/y09/auser/folder/urand
03/18/2010 13:54            Nov 27 18:47:03 /work/y09/y09/auser/folder/urand
user@nid00012:/work/x01/x01/user> creslist -u ALL -A


User            Archive Time      Copies  Keyword
--------        ----------------  ------  -------
user            12/09/2009 15:04     1
auser           01/14/2011 11:40     1
auser           10/14/2010 13:26     1
auser           03/13/2010 13:54     1

creslist Error Messages

If you enter an invalid date then you will see the following message:

user@nid00012:/work/x01/x01/user> creslist -s 10/21/2009 -e 10/21

End date '10/21' not in correct format
List failed - Invalid Request.

If you enter a username of a user who has not granted you access:

user@nid00012:/work/x01/x01/user> creslist -u auser -a


Sorry, you are not allowed to view that user's archives.
List failed - Permission denied.

If nobody has granted you access to their archives:

user@nid00012:/work/x01/x01/user> creslist -u ALL -a


No one has granted you access to view their archives.
List failed - Permission denied.