Allowing the Agent to Follow Links
You can configure the Agent to follow links, allowing it to access folders that are outside of its configured root
folder.
Links should only be used when you need the Agent to access locations that are outside of the root
folder. If you want the Agent to access a network location directly, you can specify the path to the network location for the root
setting in the configuration file.
To enable this option, update the configuration file to include "follow_links": true
and then restart the Agent.
Within the Agent root
folder, or subfolder, you can create symlinks that point to folders outside of the root
folder, including any network attached or mounted folders. Symlinks can point to any valid and accessible NFS, CIFS, or UNC path.
Windows
To create a symlink on a Windows based system, run the following commands from a Command/DOS (CMD) terminal window:
cd C:\PATH\TO\AGENT\ROOT_FOLDER
mklink /D LINK_NAME \\SERVERNAME\C$\PATH\TO\TARGET_FOLDER
When linking to network locations, Microsoft recommends the use of UNC paths rather than using mounted drive letters.
Ensure that the Windows user account, or service account, that is running the Agent has the correct access permissions for the target of the link.
Linux/Mac
To create a symlink on a Linux or Mac based system, run the following commands from a terminal window:
cd /path/to/agent/root_folder
ln -s /path/to/target_folder link_name
Ensure that the user account, or service account, that is running the Agent has the correct access permissions to the target of the link.