Customize BITS Server settings
Applies To: Windows Server 2008
Use the BITS Server page to customize BITS Server 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, when incomplete jobs are deleted, and whether existing files can 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 timeout is checked each time the cleanup process is scheduled to run. See Cleanup to configure the frequency with which the cleanup process should be run for this virtual directory. |
Allow files to be overwritten |
This setting defines if BITS Upload server allows existing files to be overwritten in the virtual directory. This setting is disabled by default to prevent unauthorized users from overwriting legitimately uploaded files by uploading a file with the same name. Attempts to overwrite a file result in the second upload job failing. If two upload jobs have the same destination file name, the second upload job fails, even if an overwriting attempt is not being made purposely. If you enable this setting, you allow files to be overwritten. Note that by enabling this setting, BITS Upload server is still not allowed to 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 via 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 type of notification to perform after the job is completed.
|
Notification URL |
Specifies the URL to which to pass the completed upload file 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
Every 12 hours the BITS Server checks for and deletes incomplete upload jobs that have timed out.This is the default behavior, however; you can configure BITS Server to scan at a different frequency.
If an incomplete upload is found, BITS Server checks the Delete incomplete jobs after setting. If the progress of the upload is delayed and subsequently exceeds the timeout period, 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 this virtual directory.
User interface name | Description |
---|---|
Use default schedule |
Configures BITS Server to scan every 12 hours and delete any incomplete jobs that are older than the time specified in the Delete incomplete jobs after setting. |
Use Custom Schedule |
Configures the type of notification to perform after the job is completed. |
Scan for incomplete jobs every |
Configures BITS Server to scan at the frequency selected and delete any incomplete jobs that are older than the time specified 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 exceeds 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 the IIS Manager Actions pane. This immediately starts a check for files that have had no progress since the timeout period. To remove all incomplete files for this virtual directory, set the Delete incomplete jobs after setting to 0 before running the cleanup.
Server farm support
If 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 allows 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 wish to use local storage, then this option will enable the client to reconnect to the same server machine in the server farm. Uploading to server farms and using local storage is not recommended without enabling and configuring this feature.
User interface name | Description | ||
---|---|---|---|
Enable Server Farm Support |
Enables BITS Server uploads support for server farms. |
||
Reconnect to IP address |
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. You should specify the outward-pointing IP address here.
|
||
Use original IP address after |
If a client cannot reconnect to the server at the Reconnect to IP address for this amount of time, then the clients will revert to the original DNS name they specified in the upload URL. |