aspera.conf for Nodes

Editing aspera.conf for your Enterprise Server node configuration.

Print this page

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:

OS Version File Location
32-bit Windows C:\Program Files\Aspera\Enterprise Server\etc\aspera.conf
64-bit Windows C:\Program Files (x86)\Aspera\Enterprise Server\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 -->
        C:\Program Files (x86)\Aspera\Enterprise Server\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 -->
        C:\Program Files (x86)\Aspera\Enterprise Server\var
    </db_dir>
    <db_port>                 <!-- integer (1 - 65535) -->
        31415
    </db_port>

</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). C:\ Program Files [(x86)]\Aspera\Enterprise Server\bin\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. C:\Program Files [ (x86)]\Aspera\Enterprise Server\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: Executing the commands below requires admin privileges.

Restarting the Node Service

> sc stop asperanoded
> sc start asperanoded

Reloading the Node Configuration

> asnodeadmin.exe --reload

Restarting the Node and DB Services

> sc stop asperanoded
> asnodeadmin.exe --db-shutdown
> sc start asperanoded
Note: The DB service is started automatically when you restart the node service.