       INSTALLATION NOTES AND OPERATING CONSIDERATIONS FOR
  THE FUTUREWARE WEB LIBRARY FILEUPLOAD (FWLFU) WEB SERVER OBJECT


GENERAL
The FutureWare Web Library's FileUpload web server object is designed as a
server-side object that accepts a file upload from a web browser for selected
file types, and then saving them to the server's file system. For uploaded
image files (i.e., BMP, JPG, GIF and PNG) the object can abstract certain image
properties (e.g., height and width in pixels) for subsequent processing. For
JPG files, the object can additionally abstract the COMMENT and the 16
application-specific descriptions (i.e., the APPnn markers) that can be
imbedded within the binary image stream. The object does not allow any
modification to any uploaded file.

The FileUpload object's operating environment is any WinNT/2K server. It is
included in this FutureWare product distribution as a class object for
Microsoft's Active Server Pages that is added as a class to the server's
Registry as an installed DLL, and is being used successfully with Microsoft's
Internet Information Server, O'Reilly's WebSitePro server, and Omnicron
Technologies' OHTTPD server, and can be used with Chili!Soft's ASP products
that operate under WinNT/2K.

It is also available as a Delphi DCU (included in this FutureWare product
distribution) that can be included in any project that uses the TWebBroker
object, by including the object's DCU in the invoking Object Pascal source
file INTERFACE's USES section.

In addition to web browser uploads of image files, it can also handle
Microsoft's Access, Word and Excel documents, text and HTML files, and other
file types that have a defined MIME declaration.


INSTALLATION
This version of the FWL FileUpload web object is distributed as a ZIPed file,
using WinZip 8.0, and encapsulates an InstallShield wizard that can be started
by running the SETUP.EXE program, and includes a standard Windows UnInstall
utility. When unziping this program, the setup and supporting installation
files are placed in the TEMP folder by default, but the ZIPed file can be
placed in, and installed from, any folder. When the FWL FileUpload web object
is installed, these installation programs and files can be deleted from the
TEMP folder, but MUST NOT be deleted if they are in the same folder as the
installation folder, otherwise the UnInstall utility will not work properly.


DEFAULT INSTALLATION FOLDER
Unless otherwise specified during the installation process, the folder in
which the FWL FileUpload web object will be placed in the web server is:

       c:\Program Files\FutureWare\FWLFU

This folder will have one executable file, "fwlfuadmin.exe", an
administration program used to register/unregister the object with the system
Registry, and to get and apply the FutureWare license, described below. It
will also have the following files:

  FWLFU_REFERENCE.TXT
    A technical reference describing how to use the FileUpload object for ASP
    and ISAPI/NSAPI environments
  FWLFU_REMITTANCE.TXT
    A remittance form to purchase and register the object by regular mail
  FWLFU_LICENSE.TXT
    The software license agreement under which this object can be used
  FWLFU_README.TXT
    This document
  UNINSTLFWLFU.EXE
    An un-install utility program. The uninstall should only be done after the
    object is un-registered from the System's Registry using the Admin
    program.

Additionally, installation folder will have these sub-folders:

  \webobject
    Contains the object that must be registered with the system Registry
    using the "fwlfuadmin.exe" program, and a type library extension which
    must be present. The filename for the object is "fwlfuobj.dll".
    This directory and its contents MUST be immediately below the directory
    that contains the "fwlfuadmin.exe" administration program.
  \Delphi_Demo
    Contains the demo Delphi project and its associated HTML demo page named
    "fwlfu_delphi_demo.html" as a demonstration vehicle. The form's ACTION
    attribute must be changed as noted depending on the target of the page
    (e.g., the ISAPI/NSAPI DLL). The Delphi DCU object "uoFWLFU_Delphi.dcu"
    must be included in any Delphi project that uses the FWLFU object.
  \ASP_Demo
    Contains the demo HTML and ASP scripts. The form's ACTION attribute must
    be changed as noted depending on the target of the page.


GLOBAL UNIQUE IDENTIFIER
The GUID for this FutureWare WebLibrary object is:

                {CB847F11-BA41-11D4-BC5E-0050DAC01AEB}


SYSTEM REGISTRY
The FileUpload object must be registered in the system Registry's HKCR\CLSID
hive, with two entries: One for the object's name, and another keyed to the
object's GUID. The "fwlfuadmin.exe" administrative program has a control,
[RegisterObjectWithSystem], which will make the required Registry entries. The
admin program also has a control, [UnRegisterFromSystem], which removes the
entries in the Registry. DO NOT ATTEMPT TO MAKE THESE REGISTRY CHANGES
MANUALLY.


LICENSE PURCHASE AND REGISTRATION
A License for the FWL FileUpload web server object must be obtained and
registered before the evaluation period expires, afterwhich the application
program's administration and usage will be restricted until it is subsequently
registered. If the FWL FileUpload object is not registered after the evaluation
period expires, then the object will not function and will return the error
message "0: FWL Object Not Registered" each and every time an attempt is made
to use the object. This unlicensed state can be removed at any time by
entering valid "NameKey" "RegistrationKey" values obtained from FutureWare,
either on its secure eCommerce site (which requires a valid credit card), or
by filling out the included form (e.g., with NotePad) in the
FWLFU_REMITTANCE.TXT file (in the \Docs subfolder) file and mailing it with
payment to the address indicated. The procedures used for on-line License
purchase and registration (the "GetFutureWareLicense" and
"ApplyFutureWareLicense" Main Meni items) are described in the {Register} Main
Menu item.


ADMINISTERING THE FWL FILEUPLOAD OBJECT
The "fwlfuadmin.exe" program is used to administer the FWL FileUpload object.

The administrative program has a three minute inactivity timer. If no edit
or change operation is in effect, then the program will be automatically
closed if there has been no activity (e.g., mouse clicks) for three minutes.
The inactivity timer is disabled if the administrative program is minimized,
but is re-enabled when the program is restored.

The administrative program has five controls located as Main Menu items:

  [RegisterObjectWithSystem]
    Used to register the FWL FileUpload object to the system's Registry. This
    control works in toggle with the [Un-RegisterFromSystem] control, and is
    disabled if the FWL FileUpload object is already in the Registry.

  [GetFutureWareLicense]
    Used to get the FWL FileUpload object's "Registration Key", which must be
    done by submitting the "Installation Key" to FutureWare along with payment
    in order to register the object and obtain a License. The registration can
    be done on-line at FutureWare's secure eCommerce web site, which requires a
    valid credit card. Alternatively, the form in the FWLFU_REMITTANCE.TXT file
    (in the \Docs subdirectory) can be filled out, including the "Installation
    Key", and mailing it with payment to the address indicated. This control
    will be set invisible when the "Registration Key" obtained from FutureWare
    is applied. The administrative program will attempt to connect to the
    FutureWare registration and secure eCommerce web site. However, if another
    system is to be used for security purposes then save the FWL FileUpload
    object's "Installation Key", go to www.futurewaredc.com/register, and
    follow the instructions.

  [UnRegisterFromSystem]
    Used to remove the FWL FileUpload object from the system's Registry. This
    control works in toggle with the [RegisterObjectWithSystem] control, and
    is disabled if the FWL FileUpload object is not in the Registry.

  [ApplyFutureWareLicense]
    Applies the "nameKey" and "Registration Key" values obtained from
    FutureWare as a proof of License, and removes any restrictions on the use
    of the FWL FileUpload object. This control will be set invisible when the
    "Registration Key" obtained from FutureWare is applied.

  [Reference]
    Displays the FWLFU_REFERENCE.TXT file in Notepad.


UN-INSTALLING THE FWL FILEUPLOAD OBJECT
The distribution includes an Un-Install facility. To be doubly safe, we
recommend that the FileUpload object is first removed from the system's
Registry by using the Administrative program's [UnRegisterFromSystem] control
before the standard un-install is done (e.g., from the ControlPanel's
Add|RemoveProgram item).


THANK YOU!
Thank you for choosing this FutureWare product. We are always working to
improve our products, and welcome comments and suggestions for making this
one even better. Please share your ideas and critiques with us and the
FutureWare user community by emailing them to fwlfu@futurewaredc.com.
