PowerWEB LiveControls for ASP.NET
Deployment
Send comments on this topic.



Glossary Item Box

Deploying a Web application that uses PowerWEB LiveControls for ASP.NET 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 (see Licensing and Trial Operation for more information).
  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:
    <httpHandlers>
            <add verb="*" path="Dart.LiveControls.GetResource.aspx" 
            type="Dart.LiveControls.ResourceHttpHandler,Dart.LiveControls" />
    </httpHandlers>
    
    This section should be placed in the configuration:system.web node in the Web.config file.
  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="CallbackManager" type="Dart.LiveControls.CallbackManager,Dart.LiveControls" />
    </httpModules>
                                    
    

    If the Project includes other PowerWEB references, the CallbackManager from another PowerWEB product may alternatively be used.

    See the Managing ViewState section on the Optimizing Performance page for more information on the Callback Manager.

  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.LiveControls.dll" in the "\Bin" directory. Your development environment may have already put a copy there when you added LiveControls 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 LiveControls 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.LiveControls.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/LiveControls_Scripts"

 

Common Errors

"Error! LiveControls scripts not found" message when displaying a page containing LiveControls.  This message is shown when the Web.config for the application is not configured to use the LiveControls script as described above.

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