Server-Side Symbolic Link Handling

The following section describes how Aspera handle symbolic links in ascp based on settings configured in the aspera.conf file. The aspera.conf is located in the following location:

/opt/aspera/etc/aspera.conf

Configuration Options

The following configuration options are set using the <file_system> section in the aspera.conf file:

  <file_system>
    <symbolic_links>LIST OF COMMA SEPARATED OPTIONS</symbolic_links>
  </file_system>

Note: If no option is specified, the configuration will default to "create, follow."

Option	Description	Client Behavior	Server Behavior
create	Create symbolic links with arbitrary targets. This is option set by default.	Skip if not configured.	Symbolic links are always copied to the server if the client requests.
follow	Follow symbolic links with targets inside docroot. If at any point the path goes outside the docroot, ascp will not complete the transfer. This is option set by default.	Symbolic links are always copied to the server if the client requests. Note: If the docroot is a symbolic link and is specified as the source or destination: As the receiver, follow the target widely (no docroot constraint) and unconditionally (regardless of symbolic link action(s) configured/requested).	Skip if not configured. Follow symbolic links with targets inside the docroot. Note: If the docroot is a symbolic link and is specified as the source or destination: As the sender, follow the target widely (no docroot constraint) and unconditionally (regardless of symbolic link action(s) configured/requested).
follow_wide	Follow symbolic links with arbitrary targets, even if the targets are outside the docroot.	Symbolic links are always copied to the server if the client requests. Note: If the docroot is a symbolic link and is specified as the source or destination: As the receiver, follow the target widely (no docroot constraint) and unconditionally (regardless of symbolic link action(s) configured/requested).
none	Take no action with the symbolic link.