The system#symbolic link component type represents a single symbolic link that is taken from a target server. The provisioning system deploys a symbolic link by creating a new link on the target server. The file that the symbolic link points to is taken from the value of the symlinkTarget variable. Any file that exists in the install location of the link is removed before the new symbolic link is created.
The system#symbolic link component type includes installation, uninstallation, and snapshot procedures. The uninstallation procedure removes the symbolic link, not the file to which it links. The snapshot procedure also captures the name of the file to which the symbolic link points, not to the file itself.
The system#symbolic link component type defines the following variables:
installName – The name to use for the resource when it is installed. The default value is the name of the component.
installPath – The path in which to install the resource. The default value is the value of the installPath variable of the container component.
symlinkTarget – The absolute path of the file to be linked to by this link. The default value is the file that was originally linked to by the file.
The following procedures are defined for the system#symbolic link component type:
defaultinstall block – Removes any file that previously existed in the install path and replaces it with a symbolic link that links to the value of the symlinkTarget variable. No snapshots are captured.
defaultuninstall block – Removes the deployed link without removing the file to which that it links.
default snapshot block – Captures a snapshot of the deployed link. Because the default install block does not capture the file by default, container components must call this routine explicitly if you want a snapshot. If you request a snapshot of a symbolic link, the path pointed to by the symbolic link is captured.
|
UNIX Systems |
Microsoft Windows Systems |
---|---|---|
Root Path |
/ |
List of physical drives on the host or network are mapped to a drive letter. Removable media is not shown. |
Delimiter |
/ |
\ |
Ordering |
Alphabetical with directories appearing first |
|
Selection Type |
User can select a file for check-in. Double click a directory to view its contents. Only symbolic link type files can be selected for check-in. |
|
Sample Path |
/foo/foo.txt |
C:\foo\foo.txt |
Special |
Links display their local name and the location pointed to: foo->/usr/bar |
|
Symbolic links contain a resource that serves as a symbolic placeholder. Symbolic link data is stored as a set of variables, one for each name and location, in the component.