WS_FTP Server Web Transfer Module Web.config Settings

The WS_FTP Server Web Transfer Module Web.config file sets the browser configuration to optimize file transfer. In most cases, you will not need to change the default settings in this file. You'll find the file on the computer on which you've installed the WS_FTP Server Web Transfer Module, in the specified installation folder. The default installation folder is:

C:\Program Files\Ipswitch\WebClients\ThinClient\Web.config

Before changing settings in this file, we recommend that you create a backup of the file, so that you can retain the original file with the default settings.

When you save changes to the Web.config file, all active WS_FTP Server Web Transfer Client sessions will be reset, which means that any user logged on via the Web Transfer Client will be returned to the Logon page, and will have to log on again.

File Upload Settings

Some key settings that you might want to change are in the <appSettings> section:

• <add key="NUMBEROFUPLOAD" value="5"></add>

  Sets the maximum number of files that can be transferred in one upload.

• Both WS_FTP Server Web Transfer Module and Internet Information Services (IIS) have limits on the size of file that can be uploaded. When a user tries to upload a file that is larger than the Web Transfer Client's maximum upload size, the Web Transfer Client displays an error message at the top of the main page (Transfer.aspx).

  If the upload exceeds the IIS maximum upload size, the browser displays a page error and does not return to the Web Transfer Client page.

  Though we cannot change the browser behavior, both of these upload values can be set in the web.config file.

  • Web Transfer Client maximum upload size is set in the <appSettings> section:

    <add key="MaxUploadSize" value="50"/>

  The value is in MB, so the maximum upload size for the Web Transfer Client is 50 MB. The limit set here is displayed to the Web Client user on the Uploads page, for example: "You can attach files up to a total size of 50 MB."

  The maximum upload file size you can set is 2 GB. This limit is enforced by the browser.

  • IIS maximum upload size is set in the <httpRuntime> section:

    <httpRuntime maxRequestLength="1048576"/>

    The value is in KB, so the maximum upload size is 1 GB.

The IIS limit can also be set in other locations, namely machine.config, and IIS metabase, though we recommend using the web.config settings.

Large Directory Listings

Also, if you need to accommodate a very large directory listing, you may want to change the value of the maxReceivedMessageSize in the <bindings> section of the Web.config file. We have displayed a listing with 1000 files using the default setting. The setting is in the following section:

<bindings>
<wsHttpBinding>

<binding name="WSHttpBinding_IFileOperation" closeTimeout="00:02:00"

openTimeout="00:02:00" receiveTimeout="00:20:00" sendTimeout="00:20:00"

bypassProxyOnLocal="false" transactionFlow="false"

hostNameComparisonMode="StrongWildcard" maxBufferPoolSize="1024000"

maxReceivedMessageSize="409600" messageEncoding="Mtom" textEncoding="utf-8"

useDefaultWebProxy="true" allowCookies="false">

...

</binding>

</wsHttpBinding>

</bindings>

Themes

You can change the look and feel of the WS_FTP Server Web Transfer Client by changing the theme specified in the <pages> section of the web.config file. Change "DefaultTheme" to any of the available themes. To see the available themes, open Windows Explorer on the computer on which you've installed the WS_FTP Server Web Transfer Module, and go to:

C:\Program Files\Ipswitch\WebClients\ThinClient\App_Themes

The names of the subfolders identify each theme: BlueTheme, DefaultTheme, GrayTheme, TPPTheme

To change the theme, enter the theme name in place of "DefaultTheme" in the following code in web.config:

<pages theme="DefaultTheme"></pages>