IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive ...

Use the archsymlinkasfile option to specify whether Tivoli Storage Managerarchives the symbolic link and the file or directory it points to, or the symbolic linkonly. See “Archsymlinkasfile” on page 196 for more information.Table 44 shows symbolic link archive and retrieve functions and the action taken:Table 44. Symbolic link management table for archive and retrieveFunction Action takenArchive of a file link. Archives the file to which the symbolic linkpoints.Archive of a directory link. Archives the directory and its contents.Archive of a file with subdir=yes. Archives the file, directory path and alllike-named files in the subtree.Archive of a directory with subdir=yes. Archives the directory, its contents, andcontents of subdirectories.Archive of a symbolic link that points to afile or directory that does not exist.Retrieve a symbolic link that points to file;the file and link exist.Retrieve a symbolic link that points to file;the symbolic link no longer exists.Retrieve a symbolic link that points to adirectory; the symbolic link and directory nolonger exist.Retrieve a symbolic link that points to adirectory; the symbolic link and directorystill exist.Archives the symbolic link.Replaces the file if replace=y is set.Retrieves the file replacing the file name withthe symbolic link name and places it in thedirectory where the symbolic link resided.A directory is created in the directory wherethe symbolic link resides, and all files andsubdirectories are restored to that directory.The symbolic link name is used as the newdirectory name.Tivoli Storage Manager will not retrieve aslong as the symbolic link exists.Understanding how hard links are handledWhen you archive files that are hard-linked, Tivoli Storage Manager archives eachinstance of the linked file. For example, if you archive two files that arehard-linked, Tivoli Storage Manager will archive the file data twice.When you retrieve hard-linked files, Tivoli Storage Manager attempts to reestablishthe links. For example, if you had a hard-linked pair of files, and only one of thehard-linked files is on your workstation, when you retrieve both files, they will behard-linked. The one exception to this procedure occurs if you archive two filesthat are hard-linked and then break the connection between them on yourworkstation. If you retrieve the two files from the server, Tivoli Storage Managerwill respect the current file system and not retrieve the hard link.If you do not archive and retrieve all files that are hard-linked at the same time,problems will occur. To ensure that hard-linked files remain synchronized, archiveall hard links at the same time and retrieve those same files together.RetrievingarchivesRetrieve a file when you want to return an archive copy from the server to yourworkstation.148 IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide