Installing: Step 1 - Uploading

At this point, you should have the zip archive "unzipped" and the contents similar to those shown in the structure and CHMOD guide. If you do not have a similar structure, check to make sure you have your zip program preferences set to allow creation of directories and to preserve case and long filenames.
  1. If you haven't done so already, create a new directory on your server named appropriately (if you wanted to access the program via http://www.domain.com/fileman/, create a directory called "fileman" in the "public_html" or "www" directory on your webserver.
  2. Using your FTP client, move into the directory you wish to upload to (if you followed the above advice, move into the newly created "fileman" directory)
  3. Now create the following directories "admin", "images", "images", "languages", "modules", "settings" and "templates".

    If your FTP client supports "Drag and Drop" which most modern clients do, you can save yourself some time and effort by simply selecting all the files from the "upload" folder of the "unzipped" zip archive and dragging them into your FTP client window, this will then copy all the files, creating the directories as it goes. If you choose to do this, you can safely ignore most of the following instruction, just remember to CHMOD as outlined in the stucture and CHMOD guide
  4. Once the directories have been created, CHMOD "images", "images", "languages", "settings" and "uploads" to 0777 (if you get errors later on, you can CHMOD these to 0755). Now, upload the contents of the files in your local folders (from the zip file) into the corresponding directories you've just created on your server. Some folders will contain other files and folders, upload them all - preserving the structure you have in your zip file (for example, upload the entire contents of the "settings" folder on your computer to the "settings" directory on the server).
  5. Once you have finished uploading into the directories, upload the rest of the files "chmod.php", "edit.php", "index.php", "install.php", "lock.php", "login.php", "move.php", "pwd.php", "source.php", "space.php", "sql.php" and "upload.php" to the same place as you created the directories earlier (into "fileman" for our example).
  6. CHMOD all files in the "languages", "settings" and "templates directories along with any sub directories to 0666 (if you get permission denied errors later on, you can CHMOD these to 0777).
  7. That's it, the hard work is now done! You can proceed to the next step.

Installing: Step 2 - Using the Installer
An installer is provided to assist you in getting your system up and running
  1. Run the "install.php" file through your web browser by entering the URL to it into your browser address bar (if you have followed our example, type in http://www.domain.com/fileman/install.php, naturally subsituting "domain.com" for your web address)
  2. You will be presented with a short screen reminding you to check CHMOD values, if you are sure if you followed the instructions then you may press the button to begin
  3. Your system will now be checked for compatability, if any alerts are shown you should follow the instructions, a brief description of the tests is shown below
    PHP Version - Although the script should run fine on any version of PHP after 4.0.4, it has only been tested extensively on PHP 4.1.0 and above. If you are running a version of PHP prior to 4.1.0 it recommended that you upgrade to a newer build due to security issues with uploading files

    ZLIB - ZLIB is a PHP extension used for compression purposes. It is used inManager to allow file compression and to reduce page download time, by compressing them. File Manager will run fine without this extension but some of the features will be disabled. ZLIB is included with most *nix servers and is included in the Windows release of PHP, so there is no reason why you shouldn't enable it

    GD - GD is an image creation extension for PHP. Manager uses it to draw pie charts/graphs on the Space usage page. The extension is not needed, but some functionality will be lost. GD is included with the Windows release of PHP and can be compiled into PHP on *nix

    Safe Mode - safe_mode is a "security" setting for PHP, but it can cause more problems than it solves, especially with File Management programs on *nix systems. Because of this you will not be able to run File Manager unless you disable safe mode. If you try to run File Manager with safe mode enabled you will not be entitled to support

    File Uploads - Another PHP setting, if file_uploads is disabled you will not be able to use Manager to upload files to your server, you will still be able to run other features, but parts of the script will not work
  4. File Permissions will now be checked to ensure that they can be read and written to, if you get any errors you will need to correct the permissions and then try again
  5. You will now be asked for some configuration values, these are described below
    Script Path - This is the absolute path to the install directory, it must be relative to the root directory, i.e. / or c:\, not relative to the web root. So if you have all your web sites in "c:\websites" and File Manager in "c:\websites\fileman" then the path must be that, not just "fileman"

    Script URL - This is the URL (including http:// or https://) to where File Manager is installed

    File Locking - This is the most "confusing" setting you are asked for, but it is also very important. If your server is running a *nix or Windows NT based system then you may ignore this, but if you are running on Windows 9x/ME you must disable this option, otherwise the script will not run. File Locking, also known as flock is a features designed to stop files becoming corrupt by making sure that only one process can write to a file at any given moment

    GZIP Compression - This option allows you to disable GZIP compression for the output, even if you don't have ZLIB installed you can leave this option enabled and it will start working if ZLIB is later installed

    HTTP Headers - Allows you to output "no cache" headers to stop browsers caching the file listings, if you get blank pages, ISE 500 errors or 404 file not found when using the actual File Manager this option needs to be disabled

    Password - This is the password that is used to access the Control Panel, it is not used to access the actual File Manager. The Control Panel can be found the install URL, for example http://www.domain.com/fileman/admin/. Note: This password is stored using an MD5 hash, and so if you forget the password you will have to edit the settings file manually in order to regain access

    Retype Password - This is simply the password retyped to ensure that you have entered the password you actually desire, and have not misspelt it
  6. If everything went to plan your installation is now complete and you should delete "install.php" along with "install.lock" from the installation directory

Installing: Step 3 - Running a Security Check

Before you open the system to the public it is recommended that you run a security check
  1. Launch your web browser and proceed to the Control Panel, for example http://www.domain.com/fileman/admin/
  2. Log in using the password you entered during installation
  3. You should now see a menu on the left hand side of the screen, the last section entitled Others contains the miscellaneous tools. Select the Security Check option from the menu
  4. The system will check to ensure that the settings file is secure, if not you will be told so and will also be told what to do in order to secure it. If you are running Apache you can disallow access to the file simply by creating a file named .htaccess in the settings folder with the following content
    <Files users.cgi>
    Deny from All
    </Files>

Installing: Step 4 - Creating a User

The final step involved in setting up File Manager is to create at least one user
  1. Launch your web browser and proceed to the Control Panel, for example http://www.domain.com/fileman/admin/
  2. Log in using the password you entered during installation
  3. You should now see a menu on the left hand side of the screen, the first section entitled User Manager contains the tools for managing users. Select the Add User option from the menu
  4. You will now be shown a fairly large form. Fill in the details as needed, these are described below.
    Access Details
    Username - This is the username which will be used to log into the File Manager

    Password - This is the password used to login into the File Manager, this password is stored as an MD5 hash

    Retype Password - This is simply the password retyped to ensure that you have entered the password correctly
    User Permissions
    "Lock" a directory? - Check this if you wish to allow the user to password protect a directory using .htaccess/.htpasswd, this only works on Apache running on *nix systems.

    Please Note: This does not stop users creating the files themselves, it simply stops them using File Manager's built in generator. If you wish to stop password protection you will need to edit the Apache httpd.conf file to disallow usage of .htaccess files

    CHMOD files or folders? - This option allows the user to run the chmod command on files or folders, it has no affect on Windows systems so can be ignored

    Create zip archives? - Requires the ZLIB extension, this option allows users to compress files and folders using File Manager

    All other permissions in this section are self explanatory, and so will not be explained further here
    MySQL Settings
    Allow access to MySQL? - Select this if you wish to give the user access to File Manager's built in MySQL Manager, if you select this option you must fill in the next 4 fields, otherwise they may be skipped

    Database Server - This is the IP address or domain name of the database server, typically 127.0.0.1 or localhost will do but some hosts use addresses such as db.domain.com

    Database Username - This is the username used to log onto the database server

    Database Password - This is the password used to log onto the database server

    Databases - This is a comma seperated list of databases to allow the user to access, for example database1,database2

    Please Note: This will not stop the user from dropping other databases if they have the correct MySQL permissions
    Other Settings
    Root Directory - This is the absolute path to the users directory, it must be relative to the root directory, i.e. / or c:\, not relative to the web root.

    Root URL - This is the URL to the users root directory, for example if c:\websites was accessed via http://www.domain.com/ and the users root directory was c:\websites\user then the URL would be http://www.domain.com/user

    Space Limit - This is the total amount of hard drive space which the user can take up. If you do not wish to impose a limit then simply set the value to the total hard drive space

    Please Note: This will not prevent users from "creating" files with their own scripts

    Default Language - This is the language to show when the user logs in. Currently you will see two options, System Default and English (British). If you select the first value the user will be assigned the default language, if you select the second option then the user will be assigned to the English language pack, even if you change the default language
  5. The users account will now be created, you should now ensure that their root directory is CHMOD to 0777
  6. Proceed to the install URL http://www.domain.com/fileman/ and log in to start using the system
Congratulations! You have installed and set up your new File Manager. If you ran into trouble, please click on the "Help!" link in the top menu bar for the FAQ and how to get support.

Thank you for supporting Invision Power File Manager from Invision Power Services Inc

Additional Task - Installing Language Packs

Now that you have File Manager up and running you may wish to download some additional language packs, this section explains how to do just that
  1. Launch your web browser and proceed to the Control Panel, for example http://www.domain.com/fileman/admin/
  2. Log in using the password you entered during installation
  3. You should now see a menu on the left hand side of the screen, the last section entitled Others contains the miscellaneous tools. Select the Resources option from the menu
  4. You should now see a list of additional language packs which you can download, download and extract any language packs you wish
  5. Select the Upload Languages tool from the Others menu
  6. Choose up to five different language files to upload and then press the button to proceed
  7. If the files uploaded successfully select the Import a Pack option from the Language Packs menu
  8. Enter suitable names for each language pack you wish to import and then press the button to proceed
  9. The language packs will be imported and can then be selected from the login screen and from the user management screens

Additional Task - Customisation

You may also wish to change the colour scheme or layout of your File Manager installation
  1. Launch your web browser and proceed to the Control Panel, for example http://www.domain.com/fileman/admin/
  2. Log in using the password you entered during installation
  3. You should now see a menu on the left hand side of the screen, the section entitled Settings contains tools for configuring the script. Select the System Templates option from the menu
  4. From here you can change the layout of the script by editing the templates or you can change the colours by editing the Cascading style sheet
  5. If you wish to edit the colours used by the Space Usage pie chart select the Visual Settings options under the Settings menu
Note: This is only a very basic guide, a more indepth guide to the templating system will be written before File Manager reaches final release


File Structure and CHMOD values
Below is a table showing the file structure and recommended CHMOD values for the file (and in the case of directories, the CHMOD values for the contents of the directories).
The CHMOD values are not needed for Windows based servers and can be safely ignored. The CHMOD values may vary from system to system, if in doubt, CHMOD everything to 0777.
  File/Folder Name Item CHMOD Value Contents CHMOD Value
Folder admin 0755 -
PHP File chmod.php - -
PHP File edit.php - -
Folder images 0777 0666
PHP File index.php - -
PHP File install.php - -
Folder languages 0777 0666
PHP File lock.php - -
PHP File login.php - -
Folder modules 0755 -
PHP File move.php - -
PHP File pwd.php - -
Folder settings 0777 0666
PHP File source.php - -
PHP File space.php - -
PHP File sql.php - -
Folder templates 0777 0666
PHP File upload.php - -


©2003 Invision Power Services Inc