PowerWEB File Upload for ASP.NET
Deployment
Send comments on this topic.



Glossary Item Box

Deploying a Web application that uses the PowerWEB File Upload for ASP.NET controls is easy. Visual Studio users can simply Rebuild the Project (to insert the license) on the development machine (the licensed machine), and then XCOPY or FTP the application to the server.

While developing the following steps should have already been taken.

  1. If you are instantiating the component dynamically, be sure to include a licenses.licx file.
  2. If using Visual Studio, the following text is automatically added to Web.config. In other development environments you need to add this text to support dynamic script generation. This section should be placed in the configuration:system.web node in the Web.config file. 
    <httpHandlers>
            <add verb="*" path="Dart.FileUpload.GetResource.aspx" 
            type="Dart.FileUpload.ResourceHttpHandler,Dart.FileUpload" />
    </httpHandlers>
    
  3. If using Visual Studio, the following text is automatically added to Web.config. In other development environments you need to add this text to support PowerWEB CallbackManager Viewstate management:
    <httpModules>
            <add name="FileUploadModule" type="Dart.FileUpload.FileUploadModule,Dart.FileUpload" />
            <add name="CallbackManager" type="Dart.FileUpload.CallbackManager,Dart.FileUpload" />
    </httpModules>
    

    NOTE: When using other 3rd party HttpModules, or custom HttpModules, be sure to place the FileUpload and CallbackManager registrations first in the list and in the order seen above, otherwise file uploads may be interrupted or fail.

  4. A "\bin" subdirectory should be in your project's directory (many development environments create this automatically). For example, if the project is called LiveTest, you should have a directory structure with "LiveTest\bin".
  5. Check for "Dart.FileUpload.dll" in the "\Bin" directory. Your development environment may have already put a copy there when you added FileUpload as a reference.

 To deploy a licensed ASP.NET Web Application or Web Service, follow these steps.

  1. Compile the ASP.NET application on a licensed development machine.
  2. Copy the contents of the bin folder and the ASP.NET source files (such as .aspx files) to the server that will be hosting the application.
  3. Create a virtual directory pointing to the folder containing the Web Application or Web Service. Of course, you can always install directly to the "wwwroot" structure.

Note: It is not necessary for the deployment server to be licensed or to contain a copy of a license in its registry.

Using External Script Files

In some cases where security settings or application URL rewriting may interfere with script access (e.g. within a DotNetNuke module), you need to physically supply the script resources and/or unique security settings. In your File Upload installation directory you will find a Scripts directory. Place the contents of this directory anywhere on your web server and add the following to your application’s Web.config within the appSettings node, replacing ### with the relative location of the directory containing the scripts:

<add key="Dart.FileUpload.ScriptsDirectory" value="###" />

Setting the value of this node to "" will be interpreted as the current directory, relative to the page being executed. It is recommended that you place these files in their own directory and provide a value that is relative to the root of the web such as "/myApplication/FileUpload_Scripts"

Documentation Version 4.0.3
© 2012 Dart Communications. All Rights Reserved.