When ascp starts it is able to establish a socket connection that it can use to send progress reports and accept commands.  This connection is called a management connection.  They are normally used to allow external parties to manage a transfer session and listen for transfer information and take action accordingly.  This page explains how the connection is established and how you can use it.

To establish the connection you can use two options. The Command Line Option or the Management Port File.  You should know that ascp can only establish a maximum of 32 management connections and only 31 started using the Command Line Option and the accepting endpoint of the TCP connection must be up and listening on the port when ascp starts.

  • Command Line Option - "-M" is the option used to specify a management connection address to ascp.  This address can be either host:port or just a port.  If you use this option and it fails to establish the connection ascp will terminate.
  • Management Port File - ascp can look for files that match the pattern "[name].port" or "[name].optport" in the /var/run/aspera directory in the installation folder.  Each of these files, if any, can contain an address to be used for establishing a management connection.  If you use this option and it fails to establish the connection the ascp process will continue.  If you have these files present, but do not wish to use management port files you can start ascp with the option "-no-mgmt-port-files" which will ignore any management port files.


Video player