Skip to main content
A newer version of this page is available. .

File Uploading Support in a Web Farm and Web Garden

  • 3 minutes to read

This topic describes how to implement file upload functionality in a clustered web environment (also known as a Web Farm or a Web Garden).

Web Farm and Web Garden technologies allow you to run a web application on multiple web servers (Web Farm) or on the same server but in different processes. Each process is executed using its own processor (Web Garden). This is specified by the Internet Information Services (IIS) settings of the server host on which you deploy your web application.

To implement file upload on a Web Farm or a Web Garden, customize the following settings.

Website Settings

The machineKey element in the web.config file should have the same settings for all websites in a Web Farm or Web Garden. Refer to the How To: Configure MachineKey in ASP.NET 2.0 topic for more information.

Web Control Settings

If an instance of each website on a Web Farm/Web Garden uses an individual file system, utilize the following options to specify the parts of a file system that are shared for all instances of a website in a clustered web environment.

  1. Configure a temporary folder to store uploaded files via the settings listed below.

    Web Control

    Settings

    ASPxUploadControl

    The ASPxUploadControl.AdvancedModeSettings.TemporaryFolder property is not used by default. It is used when the ASPxUploadControl.UploadMode property value is set to “Advanced” or “Auto” and the ASPxUploadControl.UploadStorage property value is set to “NotSet” or “FileSystem”.

    The following code snippets illustrates how to specify the ASPxUploadControl.AdvancedModeSettings.TemporaryFolder property.

    
    ...
    ASPxUploadControl.AdvancedModeSettings.TemporaryFolder = "//folder1"
    
    ...
    //The "z" drive refers to a network folder. 
    ASPxUploadControl.AdvancedModeSettings.TemporaryFolder = "z:\folder"
    

    ASPxFileManager

    The ASPxFileManager.SettingsUpload.AdvancedModeSettings.TemporaryFolder property is used by default when the FileManagerSettingsUpload.UseAdvancedUploadMode property is set to “true”.

    ASPxHtmlEditor

    The properties listed below are used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property of a specific selector is set to “true”:

    The following properties are used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property of a specific dialog is set to “true”:

    ASPxSpreadsheet

    The ASPxSpreadsheet.SettingsDocumentSelector.UploadSettings.AdvancedModeSettings.TemporaryFolder property is used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property is set to “true”.

    ASPxRichEdit

    The ASPxRichEdit.SettingsDocumentSelector.UploadSettings.AdvancedModeSettings.TemporaryFolder property is used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property is set to “true”.

    ASPxBinaryImage

    The ASPxBinaryImage.EditingSettings.UploadSettings.TemporaryFolder property is used by default when the BinaryImageUploadSettings.UploadMode property is set to “Auto”.

  2. Use the following settings to configure a folder that is used to store files saved to the server after upload.

    Web Control

    Settings

    ASPxUploadControl

    The UploadControlFileSystemSettings.UploadFolder property is not used by default. It is in effect, however, when the ASPxUploadControl.UploadStorage property is set to “FileSystem”.

    ASPxHtmlEditor

    Customize the following properties if the ASPxHtmlEditorUploadSettingsBase.UploadStorage property is set to “FileSystem” for a specific dialog.