Use the BITS Uploads page to customize BITS IIS Server Extension settings for a specific virtual directory. You can configure file size limitations, notifications, cleanup frequency, and server farm support.
Upload Job Settings
The settings in this section allow you to configure the maximum size of uploaded files, determine when incomplete jobs are deleted, and allow existing files to be overwritten by an upload job.
| User interface name | Description |
|---|---|
|
Maximum file size |
Defines the maximum size of a file that can be uploaded in a single BITS Server job. By default, there is no maximum file size. |
|
Delete incomplete jobs after |
Defines how long BITS Server will wait until cleaning up incomplete upload files. The time-out is checked every time that the cleanup process is scheduled to run. Use the options in the Cleanup section to configure the frequency with which the cleanup process should be run for this virtual directory. |
|
Allow files to be overwritten |
This setting defines whether BITS Upload server lets existing files be overwritten in the virtual directory. This setting is disabled by default.This prevents unauthorized users from overwriting legitimately uploaded files by uploading a file that has the same name. Attempts to overwrite a file result in the second upload job failing. When two upload jobs have the same destination file name, the second upload job fails, even if an overwriting attempt is unintentional. If you enable this setting, you let files be overwritten. Be aware that by enabling this setting, BITS Upload server still cannot write to files outside the virtual directory, and unauthorized users cannot overwrite the system’s files using BITS Upload server. |
Notifications
By enabling notifications, you can configure BITS Server to send a notification by way of an HTTP POST to a URL you specify when a file is uploaded to the virtual directory.
| User interface name | Description |
|---|---|
|
Enable notifications |
Enables notifications for this virtual directory. The Notification type and Notification URL settings are both required if this setting is enabled. |
|
Notification type |
Configures the kind of notification to perform after the job is finished.
|
|
Notification URL |
Specifies the URL to which you want to pass the completed upload file by using an HTTP POST request if the Notification type is Send the file contents or Send the file name. The URL may be absolute or relative. If the URL is relative, then the original request URL is used as the base. |
Cleanup
BITS Server checks for and deletes incomplete upload jobs that have timed out. If an upload exceeds the default setting of 12 hours, or the value you specify in the Scan for incomplete jobs every setting, BITS Server automatically cancels the upload and deletes any partial file contents. This setting is not affected by IIS property inheritance and applies only to the virtual directory.
| User interface name | Description |
|---|---|
|
Use default cleanup schedule |
Configures BITS Server to scan for incomplete uploads older than 12 hours. If an incomplete upload exceeds this setting, BITS Server automatically cancels the upload and deletes any partial file contents at the time you specify in the Delete incomplete jobs after setting. |
|
Use custom cleanup schedule |
Configures BITS Server to scan and delete at the interval you specify. |
|
Scan for incomplete jobs every |
Configures BITS Server to scan for incomplete uploads older than the interval you specify. If an incomplete upload exceeds this setting, BITS Server automatically cancels the upload and deletes any partial file contents at the time you specify in the Delete incomplete jobs after setting. |
|
Enable cleanup to limit the number of sessions per user |
Configures BITS Server to remove jobs uploaded by a user that exceed the value specified in Limit on the number of sessions per user. |
|
Limit on the number of sessions per user |
Specifies how many active upload jobs a user may submit to the BITS Server. |
 | Note |
|
You can manually run a cleanup task by clicking Run Cleanup from IIS Manager Actions pane. This immediately starts a check for files that have had no progress since the time-out period. To remove all incomplete files for this virtual directory, set the Delete incomplete jobs after setting to 0 before you run the cleanup. |
Server Farm Support
If it is enabled, this setting informs the client to try to reconnect to the same server instead of the original upload URL that was used by the client. This lets clients that are uploading to server farms to continue uploading to the same server where the upload started.
Server farms can be configured in one of two ways:
-
By using a shared volume for the upload virtual directory
-
By using server local storage for the uploaded files
If you want to use local storage, then this option will enable the client to reconnect to the same server computer in the server farm. We recommend that you enable and then configure this feature before you upload to server farms and use local storage.
| User interface name | Description | ||||
|---|---|---|---|---|---|
|
Enable server farm support |
Enables BITS Server uploads support for server farms. | ||||
|
Reconnect to server |
Specifies the public IP address to use for reconnecting to this server. A common configuration for a server will have two IP addresses: one that is outward pointing and that is reachable by client systems, and one that is part of the inner (protected) network. Specify the outward-pointing IP address here.
| ||||
|
Use original server after |
If a client cannot reconnect to the server at the Reconnect to server for this period of time, then the clients will revert to the original DNS name they specified in the upload URL. |