Installing FileUp for ASP/ASP.NET

Step 1: Remove Prior Versions of FileUp

If you are upgrading to a new version of FileUp, before installing the new version, remove the old version.

Why do I need to remove the old version of FileUp?
FileUp is not a pure .NET assembly, so you cannot run differing versions side-by-side on the same webserver. Rather, FileUp is a COM component with an associated .NET interop assembly; therefore you can only have one version of the FileUp dlls installed (and registered in COM) on your webserver at any given time.
Step 2: Register the appropriate dlls in COM.
Option a: Automatic Installation

Before performing the automatic installation steps, please read the section Before You Install. This section will help you plan your responses to questions posed by the installer.

To run the automatic installation, double-click FileUp.exe, and follow the InstallShield instructions.

The auto-installer will register the appropriate dlls in COM, as described in the "Manual Installation" section below. It will also set up samples in IIS. After running the auto-installer, please proceed to the Tailoring Your Installation chapter.

Also, the auto-installer does not make FileUp available to .NET. You must follow additional instructions to make FileUp availabe to the .NET framework on an application or global level. Please see: Making FileUp Available to .NET Applications.

Option b: Manual Installation

To install FileUp the first time, run the automatic installation. Once InstallShield has unpacked the dll files that contain FileUp, you can re-install FileUp manually (if, for example, you are moving FileUp to a different server).

FileUp Specific dlls:

FileUp includes two sets of dll files in the folders COM and DotNet. The dlls in COM are only for direct use in ASP. The dlls in DotNet provide an interop assembly for use in ASP.NET and should not be installed on a server that does not have the .NET Framework. Most of FileUp's ASP.NET .dll files are not pure .NET assemblies; you must register the associated COM DLLs using regsvr32 before you can use them in .NET.

The following table lists all of the .dll files included with FileUp that require COM registration. To use an optional file, register the file with regsvr32(as explained above).

.dll File Description
SAFileUp.dll Required. SAFileUp.dll is the main component for uploading and downloading.
SAFupps.dll Optional. This dll is required for MTS/COM+ support only.
SAFupmon.dll Optional. SAFupmon.dll contains FileUp's Performance Monitor counters.
SAPrgres.dll Recommended. SAPrgres.dll is FileUp's progress indicator.

The following dll is included with FileUp and as a pure .NET assembly should notbe registered in COM. It should instead be copied to your webserver for use in the configuration step "Making FileUp Accessible to .NET applications"

.dll File Description
FileUpModule.dll Optional, but recommended for .NET support. FileUpModule.dll contains the HttpModule. It is used to provide .NET support by intercepting the upload request before .NET caches the request to memory. This allows the upload to instead be cached to disk, thereby enabling very large uploads, increased upload request traffic or the use of FileUp's progress indicator. The HttpModule is a .NET assembly and does not require COM registration.

To register the FileUp specific dlls in COM:

  1. Open a command prompt window and move to the directory FileUp\COM.
    For example, enter cd Program Files\SoftArtisans\FileUp\COM.

  2. Enter regsvr32 SAFileUp.dll. A dialog box will inform you that SAFileUp.dll registered successfully; click OK.

  3. (Optional). To provide support for Progress Indication;
    Enter regsvr32 SAPrgres.dll. A dialog box will inform you that SAPrgres.dll registered successfully; click OK.

  4. (Optional). To provide support for performance monitoring;
    Enter regsvr32 SAFupmon.dll. A dialog box will inform you that SAPrgres.dll registered successfully; click OK.
    Note: This dll does not provide any functionality that would be included in your application, but is only used through the Windows Performance Monitor. Therefore, there will be no further information on the dll regarding making it available to your application in .NET.

  5. Enter iisreset to reset IIS.

The following dlls are distributed with FileUp as accessory components. These include the products File Manager, Archive and SMTPmail. These are COM components and do not provide any built-in .NET support. To be used in .NET, they must first be registered in COM and then an interop assembly must be generated with a tool such as Visual Studio.NET or the Type Library Importer (Tlbimp.exe) provided by the .NET Framework SDK. Each of these products can also be purchased separately and therefore have their own documentation set. The API documentation for each of these products is also included in the Programmers Reference section of this documentation

.dll File Description Documentation
SAArch.dll Optional. SAArch.dll contains SoftArtisans Archive, a tool for creating and extracting ZIP and CAB archives. Archive Documentation
SAFilmgr.dll Optional. SAFilmgr.dll contains SoftArtisans FileManager, a file management tool. File Manager Documentation
SASmtp.dll Optional. SASmtp.DLL contains SoftArtisans SMTPMail, a full-featured SMTP e-mail client. SMTPmail Documentation

After registering the appropriate dlls, at a minimum, you will need to create the FileUpTempDir registry key to specify the caching directory for the HttpModule. This key, as well as all of the optional keys are listed in Tailoring Your Installation: FileUp Registry Keys .

Step 3: Proceed to "Making FileUp Accessible to .NET Applications"
Now that FileUp has been installed in COM, you should proceed to "Making FileUp Accessible to .NET applications" to understand where and how to make FileUp available to .NET, including necessary edits to .NET config files.

Install Transactional Processing (Optional)

To use transactional processing, run SAFileUpTXInstall.vbs:

  1. Copy SAFupps.dll, SAFileUpTXInstall.vbs, and SAFileUpTX.pak to any stable directory.

  2. From a command prompt window, navigate to the directory containing SAFupps.dll and register it by typing the command regsvr32 SAFupps.dll. You should see a dialog box telling you that SAFupps.dll registered successfully. Select OK to continue.

  3. Restart IIS by typing the iisreset command into the command prompt.

  4. From the command prompt window, run SAFileUpTXInstall.vbs, listing the path to SAFileUpTX.pak. For example, enter:

    CSCRIPT "C:\Program Files\SoftArtisans\FileUp\SAFileUpTXInstall.vbs" "C:\Program Files\SoftArtisans\FileUp"


Copyright © 2010 SoftArtisans, Inc. All rights reserved.