aspera.conf - Transfer Server Configuration

The settings in the <central_server> section of aspera.conf include the network and port that asperacentral uses to process transfer requests and how to manage the asperacentral database.

# /opt/aspera/bin/asuserdata -+

1. Open aspera.conf from the following location:

   /opt/aspera/etc/aspera.conf

2. Add or locate the <central_server/> section, as shown in the following example:

   <central_server>
     <address>127.0.0.1</address>                                  <!-- Address -->
     <port>40001</port>                                            <!-- Port -->
     <persistent_store>enable</persistent_store>                   <!-- Persistent Storage -->
     <files_per_session>1000</files_per_session>                   <!-- Files Per Session -->
     <persistent_store_path></persistent_store_path>               <!-- Persistent Storage Path -->
     <persistent_store_max_age>86400</persistent_store_max_age>    <!-- Maximum Age -->
     <persistent_store_on_error>ignore</persistent_store_on_error> <!-- Exit Central on Storage Error -->	
     <compact_on_startup>enable</compact_on_startup>               <!-- Compact Database on Startup -->
     <ignore_empty_files>true</ignore_empty_files>                 <!-- Ignore Empty Files -->
     <ignore_no_transfer_files>true</ignore_no_transfer_files>     <!-- Ignore No-transfer Files -->
     <validation_timeout>300</validation_timeout>                  <!-- Post-Transfer Validation Timeout -->
   </central_server>

3. Edit settings as needed.
   Central Server Settings Reference

   Setting	Description	Values	Default
   Address	The network interface address on which the transfer server listens. The default value of 127.0.0.1 enables the transfer server to accept transfer requests from the local computer. If you set the address to 0.0.0.0, the transfer server can accept requests on all network interfaces. Alternatively, a specific network interface address may be specified.	Valid IPv4 address	127.0.0.1
   Port	The port on which the transfer server accepts transfer requests.	Positive integer 1 - 65535	40001
   Persistent Storage	Enable to retain data that is stored in the database between reboots of asperacentral.	Enable or Disable	Enable
   Files Per Session	The maximum number of files that can be retained for persistent storage.	Positive integer	1000
   Persistent Storage Path	The location in which to store data between reboots of asperacentral. If the path is a directory, then a file is created with the default name central-store.db. Otherwise, the file is named as specified in the path.	Valid system path	If the application is installed in the default location, then the path is the following: /opt/aspera/var/
   Maximum Age (seconds)	Maximum allowable age (in seconds) of data to be retained in the database.	Positive integer	86400
   Exit Central on Storage Error	The behavior of the asperacentral server if a database write error occurs.	Ignore or Exit	Ignore
   Compact Database on Startup	Enable or disable compacting (vacuuming) the database when the transfer server starts.	Enable or Disable	Enable
   Ignore Empty Files	Set to true to block the logging of zero-byte files.	true or false	true
   Ignore No-transfer Files	Set to true to block the logging of files that were not transferred because they exist at the destination.	true or false	true
   Post-Transfer Validation Timeout	How many seconds to wait for a post-transfer validator to update the status of a file before the file is released from the validator and its status is changed back to "to_be_validated". This allows a file to be validated by a different validator if the first validator stops working. For more information, see Out-of-Transfer File Validation.	Positive integer	300

4. Save and validate aspera.conf.
   Run the following command to confirm that the XML is correctly formatted and the parameter settings are valid:

   # /opt/aspera/bin/asuserdata -v