### FileMan Installation

Always refer to the FileMan site for the latest information! Read the FAQ for important recommendations and common questions.
Installation
Server requirements: Windows NT4, Windows 2000 or Windows XP Pro (Not XP Home!) running IIS, MDAC 2.5+ and VBScript 5.1+ (Recommended: MDAC 2.7 and VBScript 5.6)
Client requirements: FileMan has been tested with Internet Explorer 5.0 and higher with javascript and cookies enabled (IE6 or higher is recommended).
- Download and unzip FileMan to a folder in your Webroot, for example /FileMan.
- Important! Create an "Application" for the FileMan virtual folder in IIS (see the FAQ for help). Without an application, Fileman will not work!
- Important! Revoke "Read" permissions in IIS (not NTFS!) from the /Database folder to prevent downloading of the account database, or move the database outside the web root and modify the database path in the DBConnection setting in global.asa (or create a DSN).
- Load the diagnostics page http://yourserver/FileMan/diags.asp for a final requirements check. Rename or remove it after you are done!
- Check out the settings in global.asa and modify them to fit your needs
- Start http://yourserver/FileMan and login as administrator (Default user=admin, pass=pass)
- Click on the Account Manager icon on the menu bar to add or modify accounts
  Optional
- For email support: Install Jmail or ASPMail (MS CDONTS is installed by default on most IIS systems)
- Need faster and more efficient uploads than the default ASP upload method? Use any of these 3rd party upload components: ABCUpload, ASPUpload and SA-FileUp and modify "UploadPage" in global.asa.
- Register the supplied DLL's in the /Controls folder with Regsvr32 (For example: Regsvr32 c:\winnt\system32\fathzip.dll)
- To use integrated NT Authentication (Basic or NTLM): remove "Anonymous" permission on the FileMan folder in IIS and enable "UseNTAuthentication" in the "NT Integration" section of global.asa. Also check the other variables in that section. Make sure to set the proper NTFS permissions on the fileman install and rootfolders. When using UseNTAuthentication, you can configure FM to use the users NT profile Home directory as RootFolder by defining the proper variables in the Group's rootfolder setting. Make sure that the option "Allow users to map drives" is only turned on if you want all users to be able to access any drive they have NT permissions to, because this will disable RootFolder checking, what normally confines a user to his/her RootFolder(s)!
- To use FM as a web based storage system: check out the "User Subscriptions settings" section in global.asa.
- Want to use FM user validation on your own ASP pages? Include the following statement on your ASP pages (the goto parameter defines the page you want to send users to after login):
  If Session("User")="" Then Response.redirect "login.asp?goto=mypage.asp"
  Installation tips
- Use a difficult to guess folder name for your FileMan installation
- Rename the default admin account and change the password
- Users need NTFS "Change" permission in the /Database folder
- Rename or move diags.asp so users can't run it
- Choose another name for the logfile, or set logging level to 0 to prevent users from downloading and viewing it.
- If you have problems using UNC paths (\\server\share): see FAQ article KB161 "I get Permission Denied errors on files, folders or UNC paths!"
  Upgrading FileMan
- Always use all files in a distribution. Copying parts of it may result in errors.
- Registered users: Always copy the trial first, and copy the source files over that installation
- Always make a backup of the entire Fileman folder before any upgrade.
- It is recommended to set it up in a test site first
  Easy
- Obviously the most simple way is to login as Admin and recreate accounts and groups from scratch.
  Advanced
- Copy existing relevant settings in your existing global.asa to the new global.asa
- If the new database still contains the same fields as the existing one you can copy the old database over the new one.
- Open the new and old database and compare the fields in Design view (Select Table - Rightclick: Design view).
- Want to keep your database settings? You should add any new fields to the existing database (repeat for all new fields):
  - Select new database - Select Table - Rightclick: Design view - Select the new field - Rightclick: Copy
  - Select existing database - Select Table - Rightclick: Design view - Select the new field - Rightclick: Paste
  Known bugs & limitations
- Memory usage of the IIS service will increase greatly (possible even to 100s MB's) when manipulating large files and listings (1000's of items), because for some functions temporary transfer buffers are used. Although this is only temporary, it should be taken into account when determining server requirements, especially in multi-user environments. Up- and download speeds depend strongly on the CPU speed of the server, and it will be slower for large files. In tests, files of 75MB could be up- and downloaded successfully using the pure asp upload method on a LAN. The supported 3rd party upload components perform much better for big files.
- FileMan has only been tested with Internet Explorer 5.01 and higher. JScript should be enabled, and session state (temporary) cookies should be accepted by your browser.
- In IE5.5, saving some files after editing may hang the client browser. In other browser versions this problem does not occur.
  - ©2002 iisworks.com -