Installation & Configuration |
Many parameters of Sync can be configured by using the asconfigurator tool from the command line or by editing the file_system and default sections of aspera.conf. To configure Sync using asconfigurator, use this general syntax:
# /opt/aspera/bin/asconfigurator -x "set_node_data;option,value"
Possible options and values are described below.
To manually edit aspera.conf, open it in a text editor with administrative privileges.
/opt/aspera/etc/aspera.conf
See an example of the asperawatchd configuration in aspera.conf below.
You must validate aspera.conf after manually editing it to confirm that your configuration is correct. Run the following command:
# /opt/aspera/bin/asuserdata -v
To view the current settings, run the following command:
# /opt/aspera/bin/asuserdata -a
The table below provides a reference of many of the configuration options for use with Sync.
asconfigurator option |
Description and Value Options |
---|---|
directory_create_mode |
Specify the directory creation mode (permissions). If specified, create directories
with these permissions irrespective of <directory_create_grant_mask>
and permissions of the directory on the source computer. This option is applied only
when the server is a Unix-based receiver. Value is a positive integer (octal). (Default: undefined) |
directory_create_grant_mask |
Specify the mode for newly created directories if
directory_create_mode is not specified. If specified, directory modes
are set to their original modes plus the grant mask values. This option is applied only
when the server is a Unix-based receiver and when directory_create_mode
is not specified. Value is a positive integer (octal). (Default: 755) |
preserve_acls |
Specify if the ACL access data (acls) or extended attributes
(xattrs) from Windows or Mac OS X files are preserved. Three modes
are supported. (Default: none) native: acls or xattrs are preserved by using the native capabilities of the file system. If the destination does not support acls or xattrs, async generates an error and exits. metafile: acls or xattrs are preserved in a separate file. The file is in the same location and has same name, but has the added extension .aspera-meta. The .aspera-meta files are platform-independent, and files can be reverted to native form if they are synced with a compatible system. none: No acls or xattrs data is preserved. This mode is supported on all file systems. ACL preservation is only meaningful if both hosts are in the same domain. If a SID (security ID) in a source file does not exist at a destination, the sync proceeds but no ACL data is saved and the log records that the ACL was not applied. The aspera.conf settings for acls or xattrs can be overwritten by using the --preserve-acls or --preserve-xattrs options, respectively, in a command-line async session. |
async_db_spec |
Value has the syntax
sqlite:lock_style:storage_style.
(Default: undefined) lock_style: Specify how async interfaces with the operating system. Values depend on operating system. Unix-based systems have the following
options:
storage_style: Specify where Sync stores a local database that traces each directory and file. Three values can be used:
|
async_connection_timeout |
The number of seconds async waits for a connection to be established
before it terminates. Value is a positive integer. (Default: 20) |
async_session_timeout |
The number of seconds async waits for a non-responsive session to
resume before it terminates. Value is a positive integer. (Default: 20) |
async_log_dir |
Specify an alternative location for the async server's log files. If unspecified, log files are saved in the default location or the location that is specified by the client with the -R option. For information on the default log file location, see Logging. |
async_log_level |
Set the amount of detail in the async server activity log. Valid values are disable, log (default), dbg1, or dbg2. |
<file_system> ... <directory_create_mode> </directory_create_mode> <directory_create_grant_mask>755</directory_create_grant_mask> <preserve_acls>none</preserve_acls> <preserve_xattrs>none</preserve_xattrs> ... </file_system> ... <default> ... <async_db_spec> </async_db_spec> <async_connection_timeout>20</async_connection_timeout> <async_session_timeout>20</async_session_timeout> <async_log_dir>AS_NULL</async_log_dir> <async_log_level>log</async_log_level> ... </default>