Scientific Computing & Visualization
Help Contact
About Accounts Computation Visualization Documentation Services

Archive Usage:

 

Utility for archiving files and directories to the IBM Distributed Storage Manager.

COMMAND SUMMARY:
archive <file | directory> [-nosubdirs] [-description="description"]
archive -query [file | directory] [-nosubdirs] [-node=NODE] [-description="description"]
archive -queryall [slow]
archive -delete <file | directory> [-rmsubdirs] [-node=NODE] [-description="description"]
archive -retrieve <file | directory> [destination] [-nosubdirs] [-node=NODE] [-description="description"]
archive -access -add <file | directory> username [-nosubdirs] [-node=NODE]
archive -access [-del] [-node=NODE]
DESCRIPTION

Archive is a front end to the IBM dsmc command. It provides a simplified interface to archive and restoration operations. It also tries to hide some of the complexities and irregularities of dsmc.

The simplest operation is to archive a specific file or directory. The file or directory will be archived to tape and tagged with a datestamp. By default, all subdirectories will also be backed up if a directory is specified.

The file or directory can be restored by using the -retrieve switch. If multiple copies of a file exist in the archive, the desired one can be restored by using the -description flag. The user will be prompted if trying to restore over an existing file. To restore to a location other than the path originally archived, a destination directory or file can be used.

A default description will be added to all files and directories which are archived. This consists of the creation time and date of the form:

"USERNAME:Archive Date: MM/DD/YYYY Time: HH:MM:SS"

It is advisable to provide your own unique descriptions. Remember to enclose the description in quotes.

The -query option will display all the files and directories already archived by the user. If a file or directory isn't provided, the user will be prompted for the file system from which query should return results. A response such as "/usr" should be entered from the provided listing  as opposed to a number.

The -queryall option will display a complete list of all files archived by the user from all filesystems and nodes.

The -delete option will permanently remove archived files and directories. The default is to NOT remove all subdirectories. Use the -rmsubdirs flag if you really want to do this. You will be prompted before any final deletion is performed.

The -access option allows you to grant, view, and delete permissions for other users to retrieve your files. Unfortunately, it is inflexible in that you cannot specify groups of users. You must specify one user at a time using the -add flag. Used alone, it displays the existing access permissions. The -del flag will allow the user to choose which permission sets to delete. Once permission is granted to another user, they can access your files by adding the additional option --fromowner=<owner> in their -retrieve command.

[-node=NODE]:

The optional -node=NODE option can be used to access archives from decommissioned hosts. There are only two such hosts: LEGO and HAL. All new archives are associated with the default node TWISTER regardless of which host the archive command is executed on. When using the -node=NODE option with archive, the command is executed as if it were running on said NODE. This allows someone for example to access an old archive on host1 from host2 by using the -node=host1 option. One can also set up and delete access permissions on a remote hosts filespace. For example, if user1 wanted to give user2 access to something archived on host1 while logged into host2, user1 would do the following from host2:

archive -access -add [file|directory] user2 -node=host1 
Examples:

$ archive /usr1/scv/ejones/mysrc See results...
$ archive -query See results...
$ archive -retrieve /usr1/scv/ejones/mysrc/file3 /tmp See results...
$ archive -delete /usr1/scv/ejones/mysrc See results...


Boston University
Boston University
 
OIT | CCS | September 16, 2008  
Scientific Computing & Visualization Boston University home page Boston University home page