FileManager Copyright 2002, Horsburgh.com.
Author: Steve Horsburgh, shorsburgh@horsburgh.com
Version: 0.972


---------
Overview
---------

FileManager is a web-based file, directory, and remote command manager
for Linux and Unix-like operating systems. It displays directory information,
allows file viewing and editing, assists in directory navigation, and
can execute any command that the user account has privilege. 
FileManager is written in Perl and comes with its own SSL web server
for extra security. 


------------------
Required Software
------------------

Linux/Unix Version 2.1 or greater  (http://www.redhat.com/)
Perl       Version 5.005 or later  (http://www.cpan.org/)


--------------------------
Installation Instructions
--------------------------

1. Unpack the distribution into a directory of choice, preferably one
   owned by root and not visible to other users.

   CMD: tar -zxf filemanager-0.972.tar.gz
   or
   CMD: gunzip filemanager-0.972.tar.gz
        tar -xf filemanager-0.972.tar

   (If you are reading this, then you probably have already done so. :)

2. Change to the new subdirectory.

   CMD: cd filemanager-0.972

3. Execute the setup file as root.

   CMD: ./setup.sh

4. Follow the instructions.

5. That's it. (Advanced users might want to tweak the preferences file.)


--------------
Documentation
--------------

Sorry, I've not had the time yet...

Just go to the home page and click things. It should all be fairly
intuitive.

There is some additional 'User Help' information the the HELP file.

REMEMBER: The commands allowed are controlled by the privileges of the
user account. All users must be defined as valid accounts on the system
the web server is running on.


--------------
Security
--------------

If you want to create a new security certificate (and have OpenSSL installed)
try the following as root (in the root home directory).

1. Locate the CA.pl file on your system. Likely places are /usr/local/ssl/misc
   or /usr/share/ssl/misc.  (The following examples assume /usr/share/ssl/misc):

2. Issue the following shell commands:
   # /usr/share/ssl/misc/CA.pl -newca
   # /usr/share/ssl/misc/CA.pl -newreq
   # /usr/share/ssl/misc/CA.pl -signreq
   # openssl rsa -in newreq.pem -out req.pem
   # cat newcert.pem req.pem > fm.pem
   # rm newcert.pem newreq.pem req.pem
   # cp fm.pem /usr/local/fm/etc/filemanager.pem
   # /usr/local/fm/etc/restart

On the first command, enter <return> to create a new CA and use a simple pass phrase.
Answer all of the questions.

On the second command, enter the previous pass phrase and answer all of the questions
the same as the first command. Leave the "challenge" and "optional company" blank.

On the third command, enter the previous pass phrase and sign and commit the certificate.

The fourth command deletes the pass phrase.

The fifth command creates the full ".pem" file. (fm.pem)

The sixth command deletes the temporary files.

The seventh command updates FileManager.

The last command restarts FileManager.

------------
Bug Reports
------------

Please send all bug reports (and solutions if you have them :) to
fmbug@horsburgh.com


-------
Testing
-------

FileManager has been tested on the following platforms:
(if you have tested others, please let me know and I'll include them)

   - Redhat Linux 6.1, 6.2, 7.0, 7.1, 7.2, 7.3   by author
   - SGI Irix 6.3, 6.4, 6.5    by author
   - Solaris 8                 by <hederson.ramos at edb.ericsson.se>
   - Slackware 8.0             by <nickt at powys.gov.uk>
   - Slackware 7.1             by <lucas.pang at home.com>
   - SuSE 7.0                  by <phil at yatta-it.com>
   - MacOS X 10.1              by <dieter at fiebelkorn.net>
   - OpenBSD 2.6 2.8, 2.9      by <stv at mail.mi.is>

FileManager has been 'view' tested with the following browsers:
(if you have tested others, please let me know and I'll include them)

   - Windows    Internet Explorer       4.72, 5.0, 5.5, 6.0
   - Windows    Netscape Navigator      4.5, 4.7, 6.2
   - Macintosh  Internet Explorer       5.0
   - Macintosh  Netscape Navigator      4.5, 6.0
   - Linux      Netscape Navigator      4.72


---------
Copyright
---------
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  
02111-1307, USA.

See the file COPYING for additional information.



FileManager Copyright 2002, Horsburgh.com. All Rights Reserved.