efileman installation

last changed : 01/24/10

Perl version 5.004 and higher
Perl Modul CGI
Perl Modul File::Copy
Perl Compress::Zlib version 1.06 and higher
Perl Modul Archive::Zip version 1.01 and higher
CGI enviroment varibale SCRIPT_FILE_NAME must supply a valid value

The script will run, even if not all required modules installed. Some of the efileman functions won't work in this case, the debug modus of efileman will show the respective information.

Step 1

Download and unzip the archive. Open every cgi file and validate the path info in the first line of the script!
In most cases the path is "#!/usr/bin/perl".

If you don't work with a Unix System, and if you have trouble while reading the files with unix styled new line characters, test a text editor like proton or NoteTab Light.

Step 2

Open "efileman_config.cgi" and set or change the variables as described below. You can set the other variables later via the efileman admin page.

$file_lock	If your web server platform does not support the perl flock() function set this variable to "0". For Unix, Windows NT/2000/XP set to "1", for Windows95/98/Me to "0". By the way, it's not recommended to run a webserver with Windows95/98/Me!
$image_path	This is the full path of the directory where you upload the content of the "images" folder. For example "/data1/www.volume4u.de/public_html/images/efileman" ( No trailing slash for every path value). It's recommended to create an extra directory for the efileman images in your image directory.
$image_url	This is the URL equivalent of the "$image_path" variable. For example "http://www.volume4u.de/images/efileman".
$enable_upload $enable_mail $enable_admin	Set "0" to hide or "1" to show the links to efileman features upload, mail and admin. The corresponding tags in a well designed manager skin will don't be displayed. If a feature is disabled by these variables you can remove the corresponding cgi-script from the server. You should set $enable_admin to "1" to finish the configuraion of efileman.
$user_path[0]	This is the full path of the directory which you want to be the base directory for the listing. For example "/data1/www.volume4u.de/public_html/data"
$user_url[0]	This is the URL equivalent of the "$user_path" variable. For example "http://www.volume4u.de/data"
$user_name[0]	Username of the first user. Here are no special characters or space allowed, use only A-Z a-z 0-9 and _.
$user_password[0]	The required password of the first user. Use at this time only alphanummeric characters or notice the following rule: Write the character "$","@","\" and """ as "\$", "\@", "\\" and "\"" e.g. "364\$.\\dfg" instead of "364$.\dfg". You won't need that in the admin page while running the script, only if you type in the config file.
$user_is_admin[0]	Set to "1" to enjoy the full admin page as supervisor.
$file_space[0]	The filespace or diskquota in MB for the first User.

That's it as first. Save and close the file.

Step 3

Start now a FTP Client and connect to your domain. Change into the cgi-bin directory (Sometimes it's only named cgi). Create a directory for efileman, e.g. efileman. Change into that directory and create the directories "skins" and "lang". Change into skins directory and create at least a directory "default". Create for every skin you want to use an additional directory.

cgi-bin
	efileman
		lang
		skins
			default

Upload now at least into the cgi-bin/efileman directory: (Upload all of the cgi files in ASCII mode.)

efileman.cgi
efileman_config.cgi
efileman_subs.cgi
efileman_admin.cgi
efileman_help.cgi (admin online help)

Depend from your config (upload, mail enabled) upload the following:

efileman_upload.cgi
efileman_mail.cgi

If you need to have access to files/directories outside the html root:

efileman_download.cgi

Change into lang directory and upload:

efileman_english.cgi
efileman_german.cgi

Change into skins/default directory and upload all skin files.

admin.skin
edit.skin
error.skin
login.skin
mail.skin
manager.skin
upload.skin
useradmin.skin

The script efileman_createaccount.cgi can be used to create an new account automatically. efileman_createaccount.cgi is an extra script part which is using default values from efileman_config.cgi. This script isn't required to run efileman.

Now you may have the following:

cgi-bin
	efileman
		efileman.cgi
		efileman_config.cgi
		efileman_subs.cgi
		efileman_upload.cgi
		efileman_mail.cgi
		efileman_admin.cgi
		efileman_help.cgi
		efileman_download.cgi
		lang
			efileman_english.cgi
			efileman_german.cgi
		skins
			default
				admin.skin
				edit.skin
				...skin

Step 4

Make the cgi files executable by changing the permissions to 755. It's sufficient to do that for :

efileman.cgi
efileman_admin.cgi
efileman_mail.cgi
efileman_upload.cgi
efileman_createaccount.cgi
efileman_download.cgi
efileman_help.cgi

Step 5

Remember the "$image_path" variable and create the path you specified there.

HTML
	images
		efileman

Upload the efileman image files into this directory.

Step 6

Open your browser (Internet Explorer, Netscape, Opera ..) and start the script with http://<yourdomain>/cgi-bin/efileman/efileman.cgi.
You should use SSL (secure socket layer) for using this script in a public enviroment, because if not your login data and all administration data will send without encryption by the script. It's necessary to meet some requirements to can use SSL, ask your webspace administrator for more information. Basically it works if you start the script with https://<yourdomain>/cgi-bin/efileman.cgi.

See administration section here to learn more about the admin page and the respective variables of efileman.
See skins section here to learn more about how to use and create skins.