Configuring your Web UI Settings

Configure Connect Server's Web UI transfer settings by updating aspera.conf

1. Locate and open aspera.conf

   To configure Connect Server's Web UI transfer settings, locate aspera.conf and open it with a text editor:

   /opt/aspera/etc/aspera.conf

2. Additionally, open Aspera's sample Web UI configuration file

   Locate and open Aspera's sample Web UI configuration file, which can be found in the following directory:

   /opt/aspera/etc/samples/aspera-web-sample.conf

3. Modify the <WEB ...> section inside the sample Web UI configuration file and copy it into aspera.conf

   Locate the <WEB ...> section and modify it based on your requirements. Then, copy the <WEB ...> section into aspera.conf.

   <CONF version="2">
   ...
   <WEB
      SshPort = "33001"
      UdpPort = "33001"
      PathMTU = "0"
      HttpFallback = "no"
      HttpFallbackPort = "8080"
      HttpsFallbackPort = "8443"
      EnableDelete = "yes"
      EnableCreateFolder = "yes"
      AsperaServer = ""
      EnableUserSwitching = "no"
      FollowSymbolicLinks = "yes"
      EnableSortByName = "false"
      EnableConnectUpdates = "yes"
   />
   </CONF>

   Important: Although the industry-standard SSH port is TCP/22, we recommend changing it to TCP/33001 (as described in the topic "Securing your SSH Server"). The default configuration example, above, assumes your SSH port is set to TCP/33001.

   The table below provides descriptions of all Web UI configuration options.

   Field	Description	Values	Default
   SshPort	The TCP port for SSH transfer communication.	integer between 1 and 65535	22
   UdpPort	The UDP port for fasp file transfer.	integer between 1 and 65535	33001
   PathMTU	Sets the maximum packet size for file transmission. When using the value "0", fasp will automatically set the appropriate value for the network within this value.	integer between 296 and 10000	0
   HttpFallback	Use HTTP Fallback transfer when UDP-port transfer fails.	yes / no	no
   HttpFallbackPort	The TCP port for HTTP Fallback transfer.	integer between 1 and 65535	8080
   HttpsFallbackPort	The TCP port for HTTPS Fallback transfer.	integer between 1 and 65535	8443
   EnableDelete	When set to "yes" (default), users with the appropriate permissions can delete files and folders within the Web UI.	yes / no	yes
   EnableCreateFolder	When set to "yes" (default), users with the appropriate permissions can create new folders using the "New Folder" button within the Web UI. Note: Please note that the user can still upload a new folder even if "EnableCreateFolder" is set to "no."	yes / no	yes
   AsperaServer	To use this computer solely for the Connect Server Web UI (and not for file transfers), enter the IP address or host name of the transfer server machine in this field. In the case of a high-availability or clustered setup, this value should be the IP address or host name of the VIP (where the VIP/cluster service/load balancer will manage the transfer servers). Once added, Connect Server will allow the user to transfer to and from the file system on the indicated transfer server machine.	The IP address or host name of the transfer server machine	unspecified (transfer using local machine)
   MinimumConnectVersion	Specifies the minimum version of Connect that must be installed in order for users to be able to use Connect Server. If the minimum version is not installed, a message is displayed that indicates the minimum version required and provides a download link. This option takes the value in the format of the Aspera Connect version, for example, "3.0.0.12345". Note: The default value for this setting is also the lowest allowable value. If the value specified is below the default value, the Web UI enforces the default value.	Version number	2.8.0.0
   EnableUserSwitching	This option enables a feature that allows a user to switch to a different user account. Note that it doesn't allow logging in with the user account that you just logged out. This is currently an experimental feature.	yes / no	no
   FollowSymbolicLinks	Support the symbolic link in the Connect Server. The secure permission feature should be configured to enable this option.	yes / no	yes
   EnableSortByName	When value is "true," files are sorted into a given order to be displayed in before being listed on the Connect Server Web UI. Important: We recommend that you keep the default setting of "false." If you browse a directory that contains numerous files, then browsing performance may be impacted due to the extra sorting that needs to occur.	true / false	false
   EnableConnectUpdates	When the value is "yes," the Connect Server Web UI will display a prompt to upgrade the Connect browser plugin when an upgrade is available. When set to "no," this prompt will no longer appear, except for mandatory upgrades when the minimum version requirement for Connect is not met. This setting does not affect the installation message that appears when Connect is not installed.	yes / no	yes

4. Restart Aspera HTTPD

   To restart Aspera HTTPD, run the following command(s) in a Terminal window:

   $ /etc/init.d/asperahttpd restart