This topic discusses how to deploy ASP.NET demo applications on your server.

NoteNote

To find information about how specific application works, see the Samples by Application topic.

Installation Steps

  1. Copy all files from the Samples/ASPNET_CS or Samples/ASPNET_VB (for C# and VB.NET respectively) subfolder of the Image Uploader SDK installation folder into some directory on your web server.
  2. Make sure that the Gallery folder have enough permissions:
    • On Windows NT/2000/XP you should grant the modify permission to the internet guest user (IUSR_<machinename>).
    • On Windows 2003 you should grant the modify permission to the NETWORK SERVICE group.
  3. Run the browser and type the URL of the demo applications start page (default.aspx in the root of the ASPNET_CS or ASPNET_VB folder).
NoteNote

These demo applications also can be run on Mono platform (C# version only).

Troubleshooting

Problem with ../ Path

If you get the error that says that ../ (a parent path) is disallowed in the Server.MapPath method, go to the Internet Information Services -> Web Site Properties -> Home Directory -> Configuration... -> Options and set the Enable Parent Path checkbox.

Cannot Upload More Than N Megabytes

Most typical reason of this problem is server-side limitation for maximum POST request length. As usual it is specified to reduce risk of DoS attacks. If the request size exceeds specific value, it is considered as malicious and the upload is broken. As usual Image Uploader displays the following error message:

Upload failed (the connection was interrupted).

Each ASP.NET application has the web.config file which stores different application settings, including upload restrictions. Also, these settings can be defined globally, for the entire server using the machine.config file.

To resolve the problem, follow these steps:

  1. Open the web.config file, which can be found in the root folder of your application.
    — or —
    open the machine.config file, which is located in the <windows folder>\Microsoft.NET\Framework\<framework version>\config folder).
    NoteFor Mono users

    For Mono, the machine.config file is located at the following folder:

    • Windows: C:\Program Files\Mono-<version of Mono>\etc\mono\<1.0 or 2.0 (depending on emulated .NET version)>
    • Linux: /etc/mono/<1.0 or 2.0 (depending on emulated .NET version)>
  2. Find the system.web section.
  3. Find the httpRuntime key.
  4. Modify the maxRequestLength attribute of this key. Note, you should specify a value in kilobytes. The default value is 4096 KB (the same as 4 MB).
Upload Still Fails

If modifying server-side upload restrictions do not help, it is possible the server script works longer than allowed with timeout settings. It can also be adjusted with the httpRuntime parameters of the web.config (or machine.config):

  1. Open the web.config file, which can be found in the root folder of your application.
    — or —
    open the machine.config file, which is located in the <windows folder>\Microsoft.NET\Framework\<framework version>\config folder).
    NoteFor Mono users

    For Mono, the machine.config file is located at the following folder:

    • Windows: C:\Program Files\Mono-<version of Mono>\etc\mono\<1.0 or 2.0 (depending on emulated .NET version)>
    • Linux: /etc/mono/<1.0 or 2.0 (depending on emulated .NET version)>
  2. Find the <system.web> section.
  3. Find the httpRuntime key.
  4. Modify the executionTimeout attribute of this key. Note, you should specify a value in seconds.
Other Problems

If you still experience problems with running demo applications, check out the Troubleshooting section. It contains information which may be helpful to resolve or diagnose them. Also, you can create support caseLeave site or post a message on Image Uploader forumLeave site.

See Also

Manual

Writing Server-Side Upload Code