Installing AppletFile

Installation Topics

Running the Windows 32-bit setup program
Manually installing AppletFile


Running the Windows 32-bit setup program

To start the installation run the self-extracting executable that you downloaded from the Internet. If you received AppletFile on CD-ROM or floppy disk media, run the program file setup.exe located on the first disk.

Once the installation has finished initializing, a setup wizard will prompt you for a valid serial number. If you are evaluating AppletFile and have not yet purchased a license, simply enter the word 'demo' as the serial number. If you have purchased a license, your serial number can be found on your sales receipt.

! The evaluation version of AppletFile is a fully functional version of the product. However, certain dialogs contain notices that the software is for evaluation purposes only.

You will then be prompted for the installation directory, a Start Menu folder name, and other options. Once completed, the AppletFile applets will be ready to use.


Manually installing AppletFile

Overview

If you need to install AppletFile at a remote location or on to non-Windows or non-IIS system, you might not be able to use the Windows setup program. In this case, AppletFile can be manually installed using the contents of the AppletFile package provided in ZIP format. If you do not have the ZIP file, you can download it from http://www.infomentum.com/appletfile/download/.

Unzipping the Installation Files

The first step is to extract the installation files onto the server. This can be accomplished by unzipping the contents of the AppletFile package into an install directory.

! Be sure to use a version of UNZIP that supports long file names.

Once completed your install directory should contain the following contents:

classes AppletFile classes folder
doc AppletFile documentation folder
samples AppletFile sample applications folder
license.txt AppletFile Software License Agreement

If the directory tree is missing, you probably did not specify the correct UNZIP options.

Before continuing on with the installation, read the contents of the license.txt file carefully. If you do not agree with the terms of this license agreement, you must remove the installation files from the server.

To complete the installation follow the manual steps outlined in the sections below.

Core Runtime Components

At a minimum, the entire contents for the classes folder needs to be copied to the server.

Registering your Serial ID

Once you have purchase AppletFile, you will be issued an 18 digit serial id that must be registered with the software in order to disable the evaluation banner from the dialogs. If you are evaluating AppletFile you can skip this step until you make your purchase.

You can register your serial id by performing the following manual steps:

  1. Start your favorite text editor

  2. Enter the serial id as the first line of the file. It should look something like:

    xxxx-xxxx-xxxx-xxxxxx

    where each X is a number from 0-9.

  3. Save the file as serial.id (all in lower case) in the classes folder of your AppletFile installation.

  4. The file must be saved as plain text.

Creating the AppletFile Virtual Root

To access the AppletFile Applets, documentation and sample applications you will need to create a virtual root that maps URLs that start with /AppletFile to the directory that you installed AppletFile in. Refer to the administrator's documentation for your web server for instructions on how to define virtual roots. Once defined properly you will be able to access the AppletFile sample applications using the following URL:

http://<hostname>/AppletFile/samples/default.htm.