################################################################################### # # # PerlDesk - Customer Help Desk Software # # # ################################################################################### # # # Author: John Bennett # # Email: j.bennett@perldesk.com # # Web: http://www.perldesk.com # # Release: 1.5.5 # # # ################################################################################### # Please direct bug reports,suggestions or feedback to the perldesk forums. # # www.perldesk.com/board # # # # PerlDesk is free for both commercial and non-commercial use providing that the # # copyright headers remain intact and the links remain on the html pages. # # Re-distribution of this script without prior consent is strictly prohibited. # # # ################################################################################### # Please see the README/INSTALL files if you have any problems with this software # ################################################################################### PERLDESK REQUIREMENT 1.01 - Perl / MySQL - The following Perl modules: DBI DBD::MySQL MIME::Tools Do I have these modules?! A nice little script is included with perldesk to do this check for you, simply go to the scheck.pl file in your browser and it will tell you. INSTALLATION ------------------------------------------------------- [*] Untar the compressed file 'tar zxvf filename.tar.gz' Or use a utility such as WinRAR/WinZip By default, there are two directories in the file cgi-bin images The files inside the 'cgi-bin' can be placed anywhere where you have .cgi files enabled on your server, but if you put them in the actual cgi-bin you will likely need to store the images outside of the cgi-bin due to permissions. [*] Upload files in ASCII, and images in BINARY [*] Chmod all .cgi files to 755, if you plan to edit the templates via the admin section, you will also need to make the template files writable. 777. (include/tpl) cd /path/to/perldesk chmod -R 755 *.cgi [*] Set the mysql connection settings in the conf.pl file [*] You will then need to run install.cgi to setup the sql structure [*] Log in to the /admin.cgi file, 'admin/demo' HAVING PROBLEMS? VISIT THE PD FORUMS www.perldesk.com/board EMAIL INSTALLATION ------------------------------------------------------ [*] PerlDesk comes with the added ability to manage your email communications with customers. Please follow these steps to set this up. [*] Install the Perl module MIME::Tools [*] Open up the include/email.pl and edit the path to the config file. And the second path to the lang folder [*] You must setup your mail software (e.g. sendmail) so that emails sent to the address(es) of your choice are piped through to email.pl [*] If you are using SENDMAIL you must edit your /etc/aliases file, and add a line similar to the following: support: "|/path/to/perldesk/email.pl" Repeat that line for each address you want perl desk to control. [*] If you are using EXIM, pico /etc/valiases/domain you will need to add the following line: support@domain.com: |/path/to/perldesk/email.pl As with sendmail, repeat that line for each address you want perldesk to manage. [*] BEFORE starting to use your email addresses, you need to log in to the admin section of perldesk and go to 'Settings > Email Settings' at the bottom you need to assign each address you would like to use. [*] Now perldesk is setup to control your email address(es) :)