aspera.conf for Nodes

Editing aspera.conf for your Enterprise Server node configuration.

In your aspera.conf file, use the <server> section (shown below) to configure your node machines. The aspera.conf file is found in the following location:

/opt/aspera/etc/aspera.conf

Note: Each of the settings below requires certain services to be restarted in order for any changes to take effect. The services to restart are noted in the To Activate Changes column in the table below, and the commands to restart these services are given at the end of this topic.

<server>
    <server_name>             <!-- hostname or IP address -->
        your_hostname
    </server_name>
    <http_port>               <!-- integer (1 - 65535) -->
        9091
    </http_port>
    <https_port>              <!-- integer (1 - 65535) -->
        9092
    </https_port>
    <enable_http>             <!-- true | false -->
        false
    </enable_http>
    <enable_https>            <!-- true | false -->
        true
    </enable_https>
    <cert_file>               <!-- full path; .chain file same /path/filename -->
        /opt/aspera/etc/aspera_server_cert.pem
    </cert_file>
    <max_response_entries>    <!-- max # of entries to return in a response -->
        1000
    </max_response_entries>
    <max_response_time_sec>   <!-- max time to wait for long-running operation -->
        10
    </max_response_time_sec>
    <db_dir>                  <!-- path to dir where DB file will be saved -->
        /opt/aspera/var
    </db_dir>
    <db_port>                 <!-- integer (1 - 65535) -->
        31415
    </db_port>
    <proxy>
       ...
    </proxy>
</server>

Setting	Description	Default Value	To Activate Changes...
Server name	Hostname or IP address.	hostname	Restart node service
HTTP Port	HTTP service port.	9091	Restart node service
HTTPS Port	HTTPS service port.	9092	Restart node service
Enable HTTP	Enable HTTP for the Node API services.	false	Restart node service
Enable HTTPS	Enable HTTPS for the Node API services.	true	Restart node service
Cert File	Full pathname of SSL certificate (.pem and existing support for .chain).	/opt/aspera/etc/aspera_server_cert.pem	Restart node service
Maximum response entries	Maximum number of entries to return in a response..	1000	Reload node configuration
Maximum response time in seconds	Maximum amount of time to wait for a long-running operation.	10	Reload node configuration
DB directory	Path to the directory where the database file is saved. Before changing this value, you should back up your database. See Redis DB Backup/Restore.	/opt/aspera/var	Restart the node and DB services.
DB port	Database service port. Before changing this value, you should back up your database. See Redis DB Backup/Restore.	31415	Restart the node and DB services.

Note: The commands below must be run as root.

Restarting the Node Service

# /etc/init.d/asperanoded restart

Reloading the Node Configuration

# asnodeadmin --reload

Restarting the Node and DB Services

# /etc/init.d/asperanoded stop 
# /opt/aspera/bin/asnodeadmin --db-shutdown
# /etc/init.d/asperanoded start

Note: The DB service is started automatically when you restart the node service.