Archive
The archive command archives a single file, selected files, or all files in a directory and its subdirectories on a server.
Archive files that you want to preserve in their current condition. To release storage space on your workstation, delete files as you archive them using the deletefiles option. Retrieve the archived files to your workstation whenever you need them again.
Use the snapshotroot option with the archive command along with an independent software vendor application that provides a snapshot of a logical volume to associate the data on the local snapshot with the real file space data that is stored on the Tivoli® Storage Manager server. The snapshotroot option does not provide any facilities to take a volume snapshot, only to manage data that is created by a volume snapshot.
AIX® only: You can enable snapshot-based file archive by using the option snapshotproviderfs=JFS2.
Supported Clients
This command is valid for all clients.
Syntax
.-----------------. V | >>-Archive------ --filespec---+--+------------+---------------->< '- --options-'
Parameters
- filespec
- Specifies the path and name of the file you want to archive. Use wildcard characters to include a group of files or to include all files in a directory.
- To include multiple file specifications, separate eachfilespec parameter with a space character. If multiple
file specifications are included, and two or more of the specifications
have common parent directories, then it is possible for the common
directory objects to be archived more than once. The conditions under
which this behavior occurs are runtime-dependent, but the behavior
itself has no adverse effects.
For example, if the filespec is /home/amr/ice.doc /home/amr/fire.doc, then /home and /home/amr might be archived twice. The file objects ice.doc, and fire.doc, are archived only once.
For example, if the filespec is C:\proposals\drafts\ice.doc C:\proposals\drafts\fire.doc, then C:\proposals and C:\proposals\drafts might be archived twice. The file objects ice.doc and fire.doc are archived only once.
- If you want to avoid including the shared parent directory more than once, use separate, non-overlapping archive commands to archive each file specification.
- If you archive a file system, include a trailing slash (/home/).
- There is a limit of 20 operands. This limit prevents excessive sessions that are caused when wildcards are expanded by the UNIX shell command processor. You can prevent shell expansion from causing you to go over the 20-operand limit by placing quotation marks around file specifications that contain wildcards ("home/docs/*").
- You can use the removeoperandlimit option to specify that Tivoli Storage Manager removes
the 20-operand limit. If you specify the removeoperandlimit option, the 20-operand limit is not enforced and is restricted only
by available resources or other operating system limits. For example,
remove the 20 operand limit to archive 21 file specifications:
selective -removeoperandlimit filespec1 filespec2 ... filespec21
- If you archive a file system, include a trailing slash (C:\).
- You can specify as many file specifications as available resources or other operating system limits allow.
- You can use the filelist option, instead of file specifications, to identify which files to include in this operation. However, these two methods are mutually exclusive. You cannot include file specification parameters and use the filelist option. If the filelist option is specified, any file specifications that are included are ignored.
Option | Where to use |
---|---|
archmc | Command line only. |
archsymlinkasfile | Client user-options file (dsm.opt) or command line. |
autofsrename | Client options file (dsm.opt) only. |
changingretries | Client options file (dsm.opt) or command line. |
changingretries | Client system options file or command line. |
compressalways | Client options file (dsm.opt) or command line. |
compressalways | Client user-options file (dsm.opt) or command line. |
compression | Client options file (dsm.opt) or command line. |
compression | dsm.sys file within a server stanza or command line. |
deletefiles | Command line only. |
description | Command line only. |
dirsonly | Command line only. |
encryptiontype | dsm.sys file within a server stanza. |
encryptiontype | Client options file (dsm.opt). |
encryptkey | dsm.sys file within a server stanza. |
encryptkey | Client options file (dsm.opt). |
filelist | Command line only. |
filesonly | Command line only. |
postsnapshotcmd | Client options file (dsm.opt) or with the include.fs option. |
preservelastaccessdate | Client user-options file (dsm.opt) or command line. |
preservelastaccessdate | Client options file (dsm.opt) or command line. |
presnapshotcmd | Client options file (dsm.opt) or with the include.fs option. |
removeoperandlimit | Command line only. |
skipntpermissions | Client options file (dsm.opt) or command line. |
skipntsecuritycrc | Client options file (dsm.opt) or command line. |
snapshotcachesize | Client options file (dsm.opt) or include.fs option. |
snapshotroot | Command line only. |
subdir | Client options file (dsm.opt) or command line. |
tapeprompt | Client options file (dsm.opt) or command line. |
v2archive | Command line only. |
Examples
- Task
- Archive a single file that is named budget in the /home/proj1
directory.
Command: archive /home/proj1/budget
- Task
- Archive a single file that is named budget.jan in the
c:\plan\proj1 directory.
Command: archive c:\plan\proj1\budget.jan
- Task
- Archive all files in the /home/proj1 directory with a file extension of
.txt.
Command: archive "/home/proj1/*.txt"
- Task
- Archive all files in the c:\plan\proj1 directory with a file extension of
.txt.
Command: archive c:\plan\proj1\*.txt
- Task
- Archive all files in the directory tree that is headed by the /home directory.
Command: archive -subdir=yes "/home/*"
- Task
- Archive all files in the c:\ drive.
Command: archive -subdir=yes c:\*.*
- Task
- Archive all files in the Microsoft Dfs volume,
MyDfsVolume. You must specify subdir=yes to archive all files in the
volume.
Command: archive \\myserver\mydfsroot\mydfsvolume\*.* -subdir=yes
- Task
- Assuming that you initiated a snapshot of the /usr file system and mounted the
snapshot as /snapshot/day1, archive the /usr/dir1/sub1 directory
tree from the local snapshot and manage it on the Tivoli Storage Manager server under the file space name
/usr.
Command: dsmc archive /usr/dir1/sub1/ -subdir=yes -snapshotroot=/snapshot/day1
- Task
- Assuming that you initiated a snapshot of the C:\ drive and mounted the
snapshot as \\florence\c$\snapshots\snapshot.0, archive the
c:\dir1\sub1 directory tree from the local snapshot and manage it on the Tivoli Storage Manager server under the file space name
C:.
Command: dsmc archive c:\dir1\sub1\* -subdir=yes -snapshotroot=\\florence\c$\snapshots\snapshot.0