Syntax and usage
General syntax
$ asconfigurator -x "command[;parameter,value;parameter,value]"
The command is either a set command for setting a configuration or a delete command for removing a configuration. For any command you might enter one or more sets of parameters and values that are separated by semicolons.
Note: The user that runs asconfigurator commands must meet the following
requirements:
- Have write access to aspera.conf..
- Not be configured to use a shell that restricts command usage (aspshell does not allow the use of asconfigurator).
Commands for setting parameter values
Command | Description |
---|---|
set_user_data |
Sets data in the user section. For parameters and values, see User, group, and default configurations. |
set_group_data |
Sets data in the group section. For parameters and values, see User, group, and default configurations. |
set_trunk_data |
Sets data in the trunk section, which contains Vlink settings. For parameters and values, see Trunk (Vlink) configurations. |
set_central_server_data |
Sets data in the central server section, which contains Aspera Central and SOAP settings. For parameters and values, see Central server configurations. |
set_database_data |
Sets data in the database section, which contains settings for use with Aspera Console (earlier than 3.0). For parameters and values, see Database configurations. |
set_server_data |
Sets data in the server section, which contains transfer server feature settings for use with the Node API. For parameters and values, see Server configurations. |
set_http_server_data |
Sets data in the HTTP fallback server section. For parameters and values, see HTTP server configurations. |
set_client_data |
Sets data from the client section, which holds client transfer settings. For parameters and values, see Client configurations. |
set_node_data |
Sets data in the default section, which holds the "global" node settings. For parameters and values, see User, group, and default configurations. |
Note: To reset a parameter to its default value, you can use a set command for
the parameter with a value of AS_NULL.
Commands for deleting configurations
Delete commands can be used for removing a user, group, or Vlink configuration.Command | Description |
---|---|
delete_user |
Deletes a user's configurations. |
delete_group |
Deletes a group's configurations. |
delete_trunk |
Deletes a Vlink's configurations. |
Modifying files other than aspera.conf
The general syntax modifies the default aspera.conf. You can also run asconfigurator to modify an XML file of your choice instead of aspera.conf.This command takes a path to a file to modify. If the file does not exist, it is created.
$ asconfigurator -x "command[;parameter,value;parameter,value]" /path/to/file
This command takes paths to two files. The first file is used as a base, and the modifications are written to the second file.
$ asconfigurator -x "command[;parameter,value;parameter,value]" /path/to/file /path/to/file1
Using fitness rules
With fitness rules, you can apply configuration settings conditionally when specified rules
are met. Fitness rules are added to aspera.conf configurations as attributes
within XML tags, such as the following
tags:
<value fitness="peer_ip"(192.168.15.81)>allow</value>
In the example, the parameter is set to allow
if the peer IP address is
192.168.15.81
.
Fitness rule syntax:
$ asconfigurator -x "command;parameter,value,fitness,fitness_rule(fitness_template)"
Fitness rule | Example | Description |
---|---|---|
cookie() |
cookie(wilcard_template) |
The parameter value is applied if the cookie passed from the application matches the specified template. |
peer_ip() |
peer_ip(ip_address/netmask) |
The parameter value is applied if the IP address of the peer (the client) matches the specified IP address and optionally, its netmask. |
peer_domain() |
peer_domain(wilcard_template) |
The parameter value is applied if the domain of the peer (the client) matches the specified template. |
For example, to set a peer_ip fitness rule on the
authorization_transfer_in_value configuration so that incoming transfers from
192.168.16.70
are denied, run the following command:
$ asconfigurator -x "set_node_data;authorization_transfer_in_value,deny,fitness,peer_ip(192.168.16.70)"