
                                                   R E A D M E

==========================================================================================================

Ez4file is a web based file access system. Each Ez4file installation package, efx#-#-#.zip, includes 
several sub-folders and following 3 files:

  efx#-#-#.msi: an Ez4file installation file in Microsoft Installer format
  efx#-#-#.bat: a batch file to simplify the installation for both fresh and update installation
  readme.txt:   this file

Where:

  "x" is the edition mark of the installation package:

     "s" - standard edition
     "p" - personal edition
     "t" - trial edition

  "#-#-#" is major - minor - build.


----------------------------------------------------------------------------------------------------------

System requirement:

  Microsoft Windows 32-bit version, including 95 / 98 / ME, NT4, XP, and Windows 2003.

  NOTE: If the Msvbvm50.dll, and Msvbvm60.dll are not in the Windows\System for Windows 95, 98, ME, 
        or in the WINNT\System32 for NT4, you need to get these files from Microsoft and install in
        these directories.


----------------------------------------------------------------------------------------------------------

Installing Ez4file

  The Ez4file's license agreement allows one purchased copy of Ez4file to be installed on one, and 
  only one, computer, but there is no restriction on the total of instances installed on a computer 
  from one purchased Ez4file .


  Installing one instance of Ez4file on the computer:

    Unzip an efx#-#-#.zip into a folder. Then the files readme.txt, efx#-#-#.msi and efx#-#-#.bat 
    should be there.

    Double click on efx#-#-#.bat to launch the Microsoft Installer.

    For fresh installation (first time to install Ez4file on a computer):

      Click on Next button to get License Agreement window.

      Select "I accept the terms in the License Agreement" and click Next button.

      In Choose Setup Type window:

        Click on either Typical or Complete button to install Ez4file into default folder.

        Click on Custom button to install Ez4file into a folder you selected.

          Click Browse button to select a folder.

          Don't change features installation settings in this widow.

        Click on Install button in Ready to Install window to begin the installation.

        Click Finish button to exit the Setup Wizard.

        Last step for fresh installation is to write an IP Address of the Web Server into Ez4file 
        configuration file:

          Click on Windows Start button.

          Click on Programs -> Ez4file -> Ez4file Server IP Address, Notepad will be lauched with 
          file efsid.txt.

          Replace the second line, which is "0.0.0.0" now, with real Web Server IP Address.

          First line "ef.yourdomain.com" is not really needed to change.

          Save the file.

        Fresh installation is done.


    For update installation (including installing Standard Edition over Trial Edtion, Personal Edtion 
    upgrade to Standard Edtion, and version upgrade)

      Click on Next button to get Modify, Repair or remove installation window.

      in the "Modify, Repair or remove installation" window, select Repair. (DON'T SELECT OTHER CHOICES)

      Click on Repair button to start the full installation.

      Click Finish button to exit the Setup Wizard.

      Update installation is done.


  Installing multiple instances of Ez4file on the computer:

    Please send Email to support@dmfsys.com for help.


----------------------------------------------------------------------------------------------------------

Configuring the Web Server

  The Ez4file can be running as either a separate web site, such as ef.yourdomain.com, or a service of 
  existing web site, such as www.yourdomain.com/ef/.

  To configuring a web server for Ez4file (Assuming the Ez4file is installed in the directory 
  "C:\Program Files\Ez4file"):

    Make C:\Program Files\Ez4file\web-root as the virtual root of the web site or as the virtual folder 
    for the service of existing web site.

    Make C:\Program Files\Ez4file\bin as the virtual script directory, such as Scripts for IIS and cgi-bin 
    for Apache or other web servers.

    Make C:\Program Files\Ez4file\web-root\Default.htm, which redirect to Scripts\ef.exe, or 
    C:\Program Files\Ez4file\web-root\index.html, which redirect to cgi-bin\ef.exe, as the default html 
    page for web site or service of existing web site.

    Make sure the web access user has all the rights to write file in Ez4file directory and its 
    sub-directories.

    please send email to support@dmfsys.com for help on the procedures for configuring a web server to 
    run Ez4file as a servise of existing web site, such as www.yourdomain.com/ef/.


----------------------------------------------------------------------------------------------------------

Configuring IIS to run Ez4file as a separate web site

  Following procedures are based on IIS 5.0 running under Window 2000. Please replace "yourdomain" with 
  real domain name in "ef.yourdomain.com".

    Create a new web site for ef.yourdomain.com

      Launch the "Web Site Creation Wizard",

      Click Next button in the "Welcome to the Web Sote Creation Wizard,

      In "Web Site Description", Enter ef.yourcomain.com in the Description field, then click Next,

      In "IP Address and Port Settings", select ID addess from dropdown list, then click Next,

      In "Web Site Home Directory", click Browse..., and select "C:\Program Files\Ez4file\web-root", 
      click Next,

      In "Web Site Access Perminssions", select Read, Click Next,

      Click Finish.

    Create a virtual directory for running Ez4file's executalbes

      Launch the "Virtual Directory Creation Wizard",

      Click Next button in the "Welcome to the Virtual Directory Creation Wizard,

      In "Virtual Directory Alias", enter "Scripts" in the Alias field, click Next,

      In "Web Site Content Directory", click Browse..., and select "C:\Program Files\Ez4file\bin", 
      click Next,

      In "Access Permissions", select "Execute (such as ISAPI applications or CGI)", click Next,

      click Finish.

    Select a user account which has rights to write to local file for web access to allow Ez4file write 
    log, settings, etc.

      Select ef.yourdomain.com, then select menu Action -> Properties to bring up web site Properties 
      window,

      Select "Directory Security" tab,

      In "Directory Security", click Edit... in "Anonymous access and authentication control" frame, to 
      bring up "Authentication Methods" window,

      In "Authentication Methods" window, click Edit... in "Anonymous access" frame to bring up 
      "Anonymous User Account" window,

      in "Anonymous User Account" window, click Browse... and select a user account,

      in "Anonymous User Account" window, check "Allow IIS to control password,

      click OK on "Anonymous User Account" window, click OK on "Authentication Methods" window, and click 
      OK on web site Properties window

   Go to section "Testing the Configured Web Server running Ez4file as a separate web site" for details 
   on test the configured web site.


----------------------------------------------------------------------------------------------------------

Configuring Apache to run Ez4file as a separate web site

  Apche can be configured to run as signle or multipul domains/hostnames:

    Apche is configured to run as signle domain/hostname:

      Change following blocky in the httpd.conf

        <Directory "D:/Program Files/Apache Group/Apache2/htdocs">

      to

        <Directory "C:\Program Files\Ez4file\web-root">

      Change following block in the httpd.conf

        ScriptAlias /cgi-bin/ "D:/Program Files/Apache Group/Apache2/cgi-bin/"

      to

       ScriptAlias /cgi-bin/ "C:\Program Files\Ez4file\bin/"

    Apche is configured to run as multipul domains/hostnames:

      Add following virtual host block into the end of httpd.conf

        <VirtualHost *:80>
             ServerName ef.yourdomain.com
             ServerAdmin yourName@yourdomain.com
             DocumentRoot "C:\Program Files\Ez4file\web-root"
             ScriptAlias /cgi-bin/ "C:\Program Files\Ez4file\bin/"
        </VirtualHost> 

   Go to section "Testing the Configured Web Server running Ez4file as a separate web site" for details 
   on test the configured web site.


----------------------------------------------------------------------------------------------------------

Testing the Configured Web Server running Ez4file as a separate web site

  After the web server has been configured, from the computer running Ez4file to do the following test:

    In a browser typr in "http://ef.youdomain.com" and click Enter,

    Ez4file's entry page should be shown. If it is not shown, the web server configuration is not correct.

    A log file "ef00.log" should be in the "C:\Program Files\Ez4file\log" directory. If no such a file 
    there, it means the user account of web access has no righs to write file in Ez4file directory and its 
    sub-directory.

    If a log file "ef00.log" is in the "C:\Program Files\Ez4file\log" directory, and only contains entry 
    of "WARN 110306, EFERR110306, cmnCfgReadFileMain", the web server configuration is completed, go to 
    next section Configuring Ez4file.

    NOTE: "WARN 110306, EFERR110306, cmnCfgReadFileMain" means that there is no any account type, except 
           Built-in Adminitrator, granted the right to use Ez4file.


----------------------------------------------------------------------------------------------------------

Configuring Ez4file

  There is only one account, Built-in Administrator, granted the access right to Ez4file . This Built-in 
  Administrator can logon to Ez4file from the computer running a web server with Ez4file only.

  After the Ez4file has been installed and web server configured for Ez4file, a Built-in Administrator 
  account can be used to configure the Ez4file for remote access. This kind of configuration includes 
  that:

    Add a license key which is associated with your purchased Ez4file software, (it's not applicable to 
    Trial Edition and unregistered Personal Edition of Ez4file),

    Setup the Vritual Root(s),

    Setup a Upload Temp folder,

    Set up a User Home folder.

  All these settings, except license key, can only be configured by Built-in Administrator from local 
  access.

  To logon as a Built-in Administrator for the first time, use "123456" as the password.

  See following sections for details.


----------------------------------------------------------------------------------------------------------

Adding a license key

  The license key is needed for a Standard Edition, and a Personal Edition after 30-day trial. To add 
  license key:

    Logon as Built-in Administrator,

    In the configuration window, click on "License" on navigation bar in left pane,

    Entre license key in the License field, and click "OK".


----------------------------------------------------------------------------------------------------------

Setup the Virtual Root

  The Ez4file uses virtual root to protect server system. Only Built-in Administrator logged on from 
  local machine can see the real directories on the server.

  An Administrator, which is different from the Built-in Administrator, can see virtual directories only.

  To setup a virtual root:

    Logon as Built-in Administrator,

    In the configuration window, click on "Root" on navigation bar in left pane,

    Enter alias in the "Alias" field,

    Enter the full path name of a real directory in the "Full path name" field,

    check the checkbox if you want Ez4file to create a directory automatically if it's not exist,

    Click "OK".


----------------------------------------------------------------------------------------------------------

Setup the Upload Temp Folder

  The Upload Temp Folder is used for holding the uploaded file(s) temporarily during uploading process. 
  The temporary file(s) will deleted after uploading process completed.

  If no Upload Temp Folder has been defined, the \Ez4file\bin will hold the uploaded temporary file(s).

  It's strongly recommended to setup the Upload Temp Folder, and this directory should be outside the 
  Ez4file installation directory.

  To setup a upload temp folder:

    Logon as Built-in Administrator,

    In the configuration window, click on Folder -> Upload Temp on navigation bar in left pane,

    Enter the full path name of a real directory in the "Full path name" field,

    check the checkbox if you want Ez4file to create a directory automatically if it's not exist,

    Click "OK".


----------------------------------------------------------------------------------------------------------

Setup the User Home Folder

  A user of Ez4file may have a special directory called user's "Home" with full access rights, and it's 
  name is same as user's logon UserID.

  All user's Homes are the sub-directories of a special directory called "User Home Folder" with a name 
  and physical location defined by Built-in Administrator.

  To defined User Home Folder for holding all user's Home:

    Logon as Built-in Administrator,

    In the configuration window, click on Folder -> User Home on navigation bar in left pane,

    Enter the full path name of a real directory in the "Full path name" field,

    Check the checkbox if you want Ez4file to create a directory automatically if it's not exist,

    Click "OK".

  NOTE: User Home Folder is not required for Ez4file. If there is no plan to give home directory to any 
  user, just skip this step.


----------------------------------------------------------------------------------------------------------

Example

  In this example, a virtual root, a permission, an administrator, and a user will be created, then all 
  of these will be deleted (For Ez4file Standard Edition, the license key should be added before try this 
  example):

    Creating a virtual root:

      Logon as Built-in Administrator,

      In the configuration window, click on Root on the left pane, Root's default window is Root - New,

      Enter "efxmprt" in the Alias field,

      Enter "C:\efexample" in the Full path name field,

      Check the CheckBox to let Ez4file create the new directory automatically if it is not exist,

      Click on OK.

      On drive C, a directory "efexample" should be there.

    Creating an administrator:

      Logon as Built-in Administrator due to no any administrator exists now,

      In the configuration window, click on User on the left pane, User's default window is User - New,

      Enter "efadminxmp" in the UserID field,

      Enter "efpwxmpa" in the Password field and Confirm Password field,

      Check the RedioBox for Administrator,

      No Permission need to be select for administrator account (administrator account can access all 
      created roots),

      Click on OK.

      Administratot efadminxmp has been created.

    Granting access right to administrator account:

      Logon as Built-in Administrator due to no administrator account allowed to logon now,

      In the configuration window, click on Logon on the left pane,

      Check the CheckBox for Administrator,

      Click on OK.

      The administrator efadminxmp should be able to logon to Ez4file with password efpwxmpa now.

    Creating a permission:

      Logon as administrator or Built-in Administrator,

      In the configuration window, click on Permission on the left pane, Permission's default window is 
      Permission - New,

      Enter "efpmxmp" in the Alias field,

      Select "efxmprt" in the Root folder dropdown list,

      Enter "eftest\test1" in the Path name field,

      Check the CheckBox to let Ez4file create the new directory automatically if it is not exist,

      Check all CheckBoxes for Rights field.

      Click on OK.

      On drive C, a directory "efexample\eftest\test1" should be there.

    Creating a user:

      Logon as administrator or Built-in Administrator,

      In the configuration window, click on User on the left pane, User's default window is User - New,

      Enter "efuserxmp" in the UserID field,

      Enter "efpwxmpu" in the Password field and Confirm Password field,

      Check the RedioBox for User,

      In Permission dropdown list, select efpmxmp, if there is only one permission in the list, just leave 
      other dropdown lists are empty.

      Click on OK.

      User efuserxmp has been created.

    Granting access right to user account:

      Logon as administrator or Built-in Administrator,

      In the configuration window, click on Logon on the left pane,

      Check the CheckBox for User,

      Click on OK.

      The user efuserxmp should be able to logon to Ez4file with password efpwxmpu now.

    Deleting user efuserxmp:

      Logon as administrator or Built-in Administrator,

      In the configuration window, click on User -> Suspend on the left pane,

      Select "efuserxmp" in the UserID dropdown list,

      Click on OK.

      Click on OK in the User - Suspend window.

      In the configuration window, click on User -> Delete on the left pane,

      Select "efuserxmp" in the UserID dropdown list,

      Click on OK.

      Click on OK in the User - Delete window.

      User efuserxmp has been Deleted.

    Withdrawing access right to user account:

      Logon as administrator or Built-in Administrator,

      In the configuration window, click on Logon on the left pane,

      Uncheck the CheckBox for User,

      Click on OK.

      In Logon window, User should disappeared from left pane.

    Deleting a permission:

      Logon as administrator or Built-in Administrator,

      In the configuration window, click on Permission -> Delete on the left pane,

      Select "efpmxmp" in the Permission dropdown list,

      click on OK, and bring up Permission - Delete window,

      Check the CheckBox beside Delete the folder and sub-folders to let Ez4file delete the directory and 
      sib-directories automatically,

      Click on OK.

      On drive C, a directory "C:\efexample\eftest\test1" should be deleted.

    Deleting administrator efadminxmp:

      Logon as Built-in Administrator,

      In the configuration window, click on User -> Suspend -> on the left pane,

      Select "efadminxmp - Administrator" in the UserID dropdown list,

      Click on OK.

      Click on OK in the User - Suspend window.

      In the configuration window, click on User -> Delete -> on the left pane,

      Select "efadminxmp - Administrator" in the UserID dropdown list,

      Click on OK.

      Click on OK in the User - Delete window.

      Administrator efadminxmp has been Deleted.

    Withdrawing access right to user account:

      Logon as administrator or Built-in Administrator,

      In the configuration window, click on Logon on the left pane,

      Uncheck the CheckBox for Administrator,

      Click on OK.

      In Logon window, Administrator should disappeared from left pane.

    Deleting a virtual root:

      Logon as Built-in Administrator,

      In the configuration window, click on Root - > Delete on the left pane,

      Select "efxmprt" in the Root folder dropdown list,

      Click on OK to bring up Root - Delete window.

      Check the CheckBox beside Delete the folder and sub-folders to let Ez4file delete the directory and 
      its sub-directories automatically,

      Click on OK.

      On drive C, a directory "C:\efexample" and its sub-directories should be deleted.


==========================================================================================================

Copyright  2005   D.M.F. Systems, Corporation.   All rights reserved.
