Configuring the Transfer Server (Command Line)

To configure the Aspera Central transfer server in a Terminal, you can run asconfigurator commands with the following syntax:

# asconfigurator -x "set_central_server_data;parameter,value"

The Aspera Central transfer server's configuration parameters include:

asconfigurator and aspera.conf parameter Description Values Default
address This is the network interface address on which the transfer server listens. The default value 127.0.0.1 enables the transfer server to accept transfer requests from the local computer; The value 0.0.0.0 allows the transfer server to accept requests on all network interfaces for this node. Alternatively, a specific network interface address may be specified. Valid IPv4 address 127.0.0.1
port The port at which the transfer server accepts transfer requests. Positive integer between 1 and 65535 40001
persistent_store Retain data that is stored in the database between reboots of Aspera Central.
  • Enable
  • Disable
 Enable
files_per_session The maximum number of files that can be retained for persistent storage. Positive integer 1000
persistent_store_path

Path to store data between reboots of Aspera Central. If the path is currently a directory, then a file is created with the default name central-store.db. Otherwise, the file will be named as specified in the path.

Valid system path /opt/aspera/var/

(assuming the product is installed in the default location)
persistent_store_max_age Maximum allowable age (in seconds) of data to be retained in the database. Positive integer 86400
persistent_store_on_error Terminate the Aspera Central server if an error writing to the database occurs.
  • Ignore
  • Exit
 Ignore
compact_on_startup Enable or disable compacting (vacuuming) the database when the transfer server starts.
  • Enable
  • Disable
 Enable

For more information on running asconfigurator commands to configure the Central Server, see Central Server Configurations. Running asconfigurator commands for the parameters in the table above creates text similar to the following in aspera.conf:

<CONF version="2">
	...
<central_server>
  <address>127.0.0.1</address>                          <!-- Address -->
  <port>40001</port>                                    <!-- Port -->
  <persistent_store>enable</persistent_store>           <!-- Persistent store -->
  <files_per_session>1000</files_per_session>           <!-- Files per session -->
  <persistent_store_path>blank</persistent_store_path>  <!-- Persistent store path -->
  <persistent_store_max_age>86400</persistent_store_max_age> <!-- Max Age (sec) -->
  <persistent_store_on_error>ignore</persistent_store_on_error> <!-- Ignore on error -->	
  <compact_on_startup>enable</compact_on_startup>       <!-- Compact on startup-->
</central_server>
</CONF>

You can edit aspera.conf manually, rather than running asconfigurator commands, by opening the file with write permissions from the following location:

/opt/aspera/etc/aspera.conf

Validate the aspera.conf file using the asuserdata utility:
# /opt/aspera/bin/asuserdata -v