Installing FileUp for ASP

Upgrading to a New Version of FileUp

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

Automatic Installation

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

Manual Installation

FileUp includes two sets of dll files in the folders COM and DotNet. The dlls in COM work only with ASP. The dlls in DotNet work with both ASP and ASP.NET, and cannot be installed on a server that does not have the ASP.NET Framework. If you are installing FileUp for ASP only and do not have the ASP.NET Framework, register the dlls in the COM folder. For instructions on installing the ASP/ASP.NET version of FileUp, see Installing FileUp for ASP.NET.

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):

  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. Enter regsvr32 SAFUpps.dll. A dialog box will inform you that SAFUpps.dll registered successfully; click Ok.


  4. Enter regsvr32 SAPrgres.dll. A dialog box will inform you that SAPrgres.dll registered successfully; click Ok.


  5. Enter iisreset to reset IIS.


The following table lists all .dll files included with FileUp. 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 Required.
SAFupmon.dll Optional. SAFupmon.dll contains FileUp's Performance Monitor counters.
SAPrgres.dll Optional. SAPrgres.dll is FileUp's progress indicator.
SAArch.dll Optional. SAArch.dll contains SoftArtisans Archive, a tool for creating and extracting ZIP and CAB archives.
SAFilmgr.dll Optional. SAFilmgr.dll contains SoftArtisans FileManager, a file management tool.
SASmtp.DLL Optional. SASmtp.DLL contains SoftArtisans SMTPMail, a full-featured SMTP e-mail client.

Top

Installing the ISAPI Filter

For security reasons, FileUp's automatic installation does not automatically install the ISAPI filter in IIS. To install the filter in IIS:

  1. Open IIS, right-click the machine name icon, and select Properties.

    FileUp's ISAPI filter must be installed at the machine level, not the Web site or Web application level.

  2. Select the Internet Information Services tab.


  3. From the Master Properties drop-down list, select WWW Service, and click Edit.


  4. Select the ISAPI Filters tab.


  5. Click Add.


  6. In the Filter Properties dialog box, enter the filter name FileUp, browse to FileUpIsapi.dll, and click Ok.


  7. Restart IIS to load the filter: right-click the machine name icon, select Restart IIS..., select Restart Internet Services from the drop-down list, and click Ok.

Top

Allowing ASP to Process Files with the .upl Extension

FileUp's ISAPI filter will intercept requests to files with the extension .upl. After the filter handles a request to a .upl file, the request is forwarded to ASP. To allow ASP to process files with the extension .upl, you must add a script map to IIS (for security reasons, FileUp's automatic installation does not add the script map automatically).

In the Windows XP IIS console, the Web Sites and Default Web Site nodes have identical properties dialogs. The script maps can be installed in the Web Sites properties, but they will be ignored by IIS. The script maps must be installed from the Default Web Site node.

Top

The ISAPI Filter Temp Directory

The ISAPI filter caches request data before it is processed by ASP.NET. The location of the cache files can be configured in the Windows registry. By default, the cache location is the system's default directory for cached files, which is determined by the system environment variable TEMP. To set a different ISAPI filter temp directory:

  1. Open the Start menu, and select Run.
  2. Enter regedit and click Ok.
  3. Open HKEY_LOCAL_MACHINE\SOFTWARE\Software Artisans\SA-FileUp\Parameters.
  4. Right-click IsapiTempDir and select Modify.
  5. In Value Data, enter the path and folder name.
  6. To reset IIS, at the command prompt enter iisreset. Note: The new IsapiTempDir setting will not take effect until you reset IIS.
To change the system's default directory for cached files, reset the TEMP environment variable, as follows:
  • Open the Control Panel.
  • Select System.
  • Select the Advanced tab.
  • Click Environment variables...
  • Select TEMP from the System Variables list.
  • Click Edit.
  • Enter a new Variable Value, and click Ok.

Top

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. Open a command prompt window and run SAFileUpTXInstall.vbs, listing the path to SAFileUpTX.pak. For example, enter:

    CSCRIPT "C:\Program Files\Software Artisans\FileUp\SAFileUpTXInstall.vbs" "C:\Program Files\Software Artisans\FileUp"

Top

Copyright © 2003 SoftArtisans, Inc. All rights reserved.