| Configure the Server from the Command Line |
72
Note:
When a directory is excluded, directories and files in it are also excluded and are not compared to any
following rules.
3.
If the file does not match, it is compared to the next rule and repeats the process for each rule until a match is
found or until all rules have been tried.
4.
If the file never matches any exclude rules, it is included in the transfer.
5.
The next file or directory in the transfer list is then compared to the filtering rules until all eligible files are
evaluated.
Rule Patterns
Rule patterns (globs) use standard globbing syntax that includes wildcards and special characters, as well as several
Aspera extensions to the standard.
•
Character case:
Case always matters, even if the file system does not enforce such a distinction. For example, on
Windows FAT or NTFS file systems and macOS HPFS+, a file system search for "DEBUG" returns files "Debug"
and "debug". In contrast, Ascp filter rules use exact comparison, such that "debug" does not match "Debug". To
match both, use "[Dd]ebug".
•
Partial matches:
With globs, unlike standard regular expressions, the entire filename or directory name must
match the pattern. For example, the pattern
abc*f
matches
abcdef
but not
abcdefg
.
For details on using wildcards and special characters to build rule patterns, see
Using Filters to Include and Exclude
on page 126.
Set Rules
Filter rules can be set in
aspera.conf
in the following ways:
• by modifying
aspera.conf
with the
asconfigurator
tool
• by modifying
aspera.conf
directly with a text editor
In order to run
asconfigurator
successfully, you must meet the following requirements:
1.
have write access to
aspera.conf
2.
not be restricted to
aspshell
, which does not allow running
asconfigurator
The set commands for user, group, and global filter settings use the following syntax:
asconfigurator -x
"set_user_data;user_name,
username
;file_filters,|
rule1
|
rule2
...|
ruleN
"
asconfigurator -x
"set_group_data;group_name,
groupname
;file_filters,|
rule1
|
rule2
...|
ruleN
"
asconfigurator -x "set_node_data;file_filters,|
rule1
|
rule2
...|
ruleN
"
Where:
• Each rule argument, including the first, must begin with a "
|
" character, which serves as the separator between
multiple rules.
• To clear rules, run
asconfigurator
by specifying "
file_filters,
" without rule arguments. Note that the
comma in "
file_filters,
" is still required. See the example below.
• Running
asconfigurator
replaces the specified settings; it does not add to them.
To edit
aspera.conf
, open it from the following location:
/opt/aspera/etc/aspera.conf
See the following examples for the correct syntax.
Examples
