==================================================================== ########## PaKnPost Pro Installation Notes ########## ==================================================================== See README.txt for configuration and usage notes See FAQ.txt for frequently unasked questions. See LICENSE.txt for licensing provisions Steve Grasso steveg at nexus.iinet.net.au 20070111 ===================================================================== ########## Contents ########## ===================================================================== - Pre-requisites - If you have shell access to your server - If you don't have shell access to your server - Common to either of the above options - If you are upgrading an existing installation - Installing PaKnPosT Plugins - Troubleshooting notes ===================================================================== ########## Pre-requisites ########## ===================================================================== =================== Linux Environments: =================== Mandatory: ========== - Web server that honours htaccess directives and .cgi requests (tested with Apache) http://httpd.apache.org/download.cgi - Perl (Usually present) - crontab (Usually present) - A Mail Transfer Agent (MTA) which allows email relay from the PaKnPosT Pro server Optional: ========= - Clamscan for virus checking incoming files clamscan: part of Clam AntiVirus http://www.clamav.net/ http://clamav.elektrapro.com/ - Unzip for enabling zip archive inspection for allowed MIME types and virus checking http://www.info-zip.org/pub/infozip/ ===================== Windows Environments: ===================== PaKnPosT Pro Win32 does NOT require a Windows Server 2000/2003 environment, and has run quite happily on Windows 2000 Pro or Windows XP Pro for low impact installations. Mandatory: ========== - Web server that honours htaccess directives and .cgi requests (tested with Apache version 2.2 for Win32) http://httpd.apache.org/download.cgi - ActiveState Perl (tested on version 5.8) http://www.activestate.com/store/activeperl/download Perl needs to be available from c:\usr\bin so when installing ActiveState Perl, from the Custom installation screen, at Location click Browse and type C:\usr to install perl into the correct location - MS Services for Unix (version 3.5) http://www.microsoft.com/technet/interopmigration/unix/sfu/default.mspx - Pycron to provide crontab for periodic clean up of Holding Area files http://www.kalab.com/freeware/pycron/pycron.htm - A Mail Transfer Agent (MTA) which allows email relay from the PaKnPosT Pro server Optional: ========= - HKCPU32 for estimating CPU speed in MHz, used to estimate file encryption/decryption times http://web.inter.nl.net/hcc/J.Steunebrink/chkcpu.htm and CHKCPU32.EXE is in the %windir%\system32 folder Email: PaKnPosT Pro assumes we're using Bmail in a Windows environment http://www.beyondlogic.org/solutions/cmdlinemail/cmdlinemail.htm and that bmail is in the %windir%\system32 folder Bmail passes off to an MTA on localhost for delivery, so assumes a working MTA on localhost eg. Mercury Mail Transport System http://www.pmail.com/ - Clamwin for virus checking incoming files http://www.clamwin.com/ - Unzip for enabling zip archive inspection for allowed MIME types and virus checking, and Plugin installation: http://www.info-zip.org/pub/infozip/ ( Infozip Win32 commandline version self-extracting archive may also be obtained here: http://www.paknpost.org/extras/unz552xN.exe ) Ensure that unzip is placed in the %windir%\system32 folder ===================================================================== ########## If you have shell access to your server ########## ===================================================================== # 1 # Download or copy the latest distribution of the PaKnPost Pro to your home directory # 2 # Untar or unzip it eg. Tar: tar zxvf pnp-pro-1.10-20061123.tar.gz Unzip: unzip pnp-pro-1.10-20061123.zip # 3 # Change directory to the pnp distribution cd pnp110 # 4 # Run the setup script eg. Linux: ./setup.sh Windows: setup.bat # 5 # Set up a crontab entry to clear the Holding Area daily NOTE: Be sure that the path to the file holding area directory is correct eg. Linux: 0 23 * * * /usr/bin/perl /path/to/holding/area/directory/clear_efiles.pl > /dev/null 2>&1 Windows: C:\usr\bin\perl \path\to\holding\area\directory\clear_efiles.pl ===================================================================== ########## If you don't have shell access to your server ########## ===================================================================== NOTE: If you are upgrading an existing installation, read the notes in the section entitled "If you are upgrading an existing installation" BEFORE proceeding here # 1 # Download the latest distribution of the PaKnPost Pro # 2 # Untar or unzip it eg. Tar: tar zxvf pnp-pro-1.10-20061123.tar.gz Unzip: unzip pnp-pro-1.10-20061123.zip # 3 # Create required directories: HTML directories: NOTE: path-to-your-your-web-root could be something like /var/www/html or /home/yourusername/public_html or (Windows) C:\Program Files\Apache Software Foundation\Apache2.2\htdocs Base directory: path-to-your-your-web-root/pnp File Holding Area directory eg.: path-to-your-your-web-root/pnp/files Images directory: path-to-your-your-web-root/pnp/images CSS directory: path-to-your-your-web-root/pnp/css CGI-BIN directory: NOTE: path-to-your-your-cgi-bin-directory could be something like /var/www/cgi-bin or /home/yourusername/public_html/cgi-bin or (Windows) C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\cgi-bin Base directory: path-to-your-your-cgi-bin-directory/pnp # 4 # FTP the PaKnPost Pro html images directory and CSS directory to your server using FTP automatic mode eg. pnp-pro-1.10-20061123/images -> path-to-your-your-web-root/pnp/images pnp-pro-1.10-20061123/css -> path-to-your-your-web-root/pnp/css # 5 # FTP all the Holding Area directory files using FTP ASCII or automatic mode eg. pnp-pro-1.10-20061123/src/shell -> path-to-your-your-web-root/pnp/files # 6 # FTP the PaKnPost Pro cgi files iand sub-directories to the cgi-bin directory using FTP ASCII mode eg. pnp-pro-1.10-20061123/src/cgibin -> path-to-your-your-cgi-bin-directory/pnp # 7 # Rename path-to-your-your-cgi-bin/pnp/ht_pnp_pass.cgi to path-to-your-your-cgi-bin/pnp/.ht_pnp_pass.cgi # 8 # Rename path-to-your-your-cgi-bin/pnp/ht_change_the_password to path-to-your-your-cgi-bin/pnp/.ht_change_the_password # 9 # Holding Area periodic cleanup - Edit path-to-your-your-web-root/pnp/files/clear-efiles.pl so that the path to your Holding Area directory is correct. Be aware that the path you see in an FTP client will most likely have your user directory as the root, but this won't reflect the ACTUAL server path to your files directory eg. the path you may see in your FTP client might look something like /username/public_html/pnp/files but the server path might actually be something like /hsphere/home/username/public_html/pnp/files. You'll need to check with your hosting provider. - FTP the initial keepdays file to the Holding Area directory (using ASCII mode file transfer) eg. pnp-pro-1.10-20061123/src/shell/keepdays path-to-your-your-web-root/pnp/files/ You may need to relax file permissions on this file to allow your web server to write to it. Use your FTP client (or chmod from shell) to change the permissions to 774, or as a last resort 777. - FTP the initial clear_efiles.log file to the Holding Area directory (using ASCII mode file transfer) eg. pnp-pro-1.10-20061123/src/shell/clear_efiles.log path-to-your-your-web-root/pnp/files/ You may need to relax file permissions on this file to allow your web server to write to it. Use your FTP client (or chmod from shell) to change the permissions to 774, or as a last resort 777. - FTP the initial shared.log file to the Holding Area directory (using ASCII mode file transfer) eg. pnp-pro-1.10-20061123/src/shell/shared.log path-to-your-your-web-root/pnp/files/ You may need to relax file permissions on this file to allow your web server to write to it. Use your FTP client (or chmod from shell) to change the permissions to 774, or as a last resort 777. If you have access to cron: - Add something like the following to your crontab: Linux: 0 23 * * * /usr/bin/perl /hsphere/home/username/public_html/pnp/files/clear_efiles.pl > /dev/null 2>&1 Windows: C:\usr\bin\perl C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\pnp\files\clear_efiles.pl If you don't have access to cron: You'll have to manually delete old shared files from the Holding Area every now and again using your FTP client to prevent them from filling the file system # 10 # You may need to relax the file permissions on the directory you've chosen to house the Holding Area directories to allow your web server to write and delete files as required. If you need to, use your FTP client (or chmod from shell) to change the permissions of path-to-your-your-web-root/pnp/files to 775, or as a last resort 777 ===================================================================== ########## Common to either of the above options ########## ===================================================================== # 1 # Make sure file ownerships and file permissions are something like: path-to-your-your-web-root/pnp/files: drwxr-xr-x 2 wwwrun www 704 Nov 23 14:49 . drwxr-xr-x 3 wwwrun www 640 Nov 23 14:49 .. -rw-r--r-- 1 wwwrun www 0 Jul 22 17:00 clear_efiles.log -rw-r--r-- 1 wwwrun www 0 Feb 27 2003 index.html -rwxr-xr-x 1 wwwrun www 569 Jul 22 17:00 clear_efiles.pl -rw-r--r-- 1 wwwrun www 2 Jul 22 17:00 keepdays -rw-r--r-- 1 wwwrun www 0 Feb 27 2003 shared.log path-to-your-your-web-root/pnp/images: drwxr-xr-x 2 wwwrun www 704 Nov 23 14:49 . drwxr-xr-x 3 wwwrun www 640 Nov 23 14:49 .. -rw-r--r-- 1 wwwrun www 2078 Nov 23 14:59 back.png -rw-r--r-- 1 wwwrun www 2236 Nov 23 14:59 config.png -rw-r--r-- 1 wwwrun www 4563 Nov 23 14:59 file.png -rw-r--r-- 1 wwwrun www 5410 Nov 23 14:59 fileshare.jpg -rw-r--r-- 1 wwwrun www 815 Nov 23 14:59 fileshare.png -rw-r--r-- 1 wwwrun www 4840 Nov 23 14:59 fileshare_but.png -rw-r--r-- 1 wwwrun www 3064 Nov 23 14:59 fileshare_but_sm.png -rw-r--r-- 1 wwwrun www 7003 Nov 23 14:59 fileshare_shad.jpg -rw-r--r-- 1 wwwrun www 3916 Nov 23 14:59 help.jpg -rw-r--r-- 1 wwwrun www 2200 Nov 23 14:59 help.png -rw-r--r-- 1 wwwrun www 0 Nov 23 14:59 index.html -rw-r--r-- 1 wwwrun www 3553 Nov 23 14:59 info.jpg -rw-r--r-- 1 wwwrun www 2188 Nov 23 14:59 info.png drwxr-xr-x 2 wwwrun www 704 Nov 23 14:49 letters -rw-r--r-- 1 wwwrun www 856 Nov 23 14:59 logo.png -rw-r--r-- 1 wwwrun www 63823 Nov 23 14:59 prog_anim.gif -rw-r--r-- 1 wwwrun www 3223 Nov 23 14:59 side.png -rw-r--r-- 1 wwwrun www 3944 Nov 23 14:59 stats.jpg -rw-r--r-- 1 wwwrun www 2252 Nov 23 14:59 stats.png -rw-r--r-- 1 wwwrun www 37932 Nov 23 14:59 title.png path-to-your-your-web-root/pnp/images/letters: drwxr-xr-x 2 wwwrun www 704 Nov 23 14:49 . drwxr-xr-x 3 wwwrun www 640 Nov 23 14:49 .. -rw-r--r-- 1 wwwrun www 525 Nov 23 14:59 A.jpg -rw-r--r-- 1 wwwrun www 503 Nov 23 14:59 B.jpg -rw-r--r-- 1 wwwrun www 511 Nov 23 14:59 C.jpg -rw-r--r-- 1 wwwrun www 532 Nov 23 14:59 D.jpg -rw-r--r-- 1 wwwrun www 570 Nov 23 14:59 E.jpg -rw-r--r-- 1 wwwrun www 483 Nov 23 14:59 F.jpg -rw-r--r-- 1 wwwrun www 543 Nov 23 14:59 G.jpg -rw-r--r-- 1 wwwrun www 497 Nov 23 14:59 H.jpg -rw-r--r-- 1 wwwrun www 462 Nov 23 14:59 I.jpg -rw-r--r-- 1 wwwrun www 484 Nov 23 14:59 J.jpg -rw-r--r-- 1 wwwrun www 556 Nov 23 14:59 K.jpg -rw-r--r-- 1 wwwrun www 482 Nov 23 14:59 L.jpg -rw-r--r-- 1 wwwrun www 517 Nov 23 14:59 M.jpg -rw-r--r-- 1 wwwrun www 561 Nov 23 14:59 N.jpg -rw-r--r-- 1 wwwrun www 485 Nov 23 14:59 O.jpg -rw-r--r-- 1 wwwrun www 488 Nov 23 14:59 P.jpg -rw-r--r-- 1 wwwrun www 497 Nov 23 14:59 Q.jpg -rw-r--r-- 1 wwwrun www 523 Nov 23 14:59 R.jpg -rw-r--r-- 1 wwwrun www 482 Nov 23 14:59 S.jpg -rw-r--r-- 1 wwwrun www 441 Nov 23 14:59 T.jpg -rw-r--r-- 1 wwwrun www 537 Nov 23 14:59 U.jpg -rw-r--r-- 1 wwwrun www 525 Nov 23 14:59 V.jpg -rw-r--r-- 1 wwwrun www 510 Nov 23 14:59 W.jpg -rw-r--r-- 1 wwwrun www 590 Nov 23 14:59 X.jpg -rw-r--r-- 1 wwwrun www 495 Nov 23 14:59 Y.jpg -rw-r--r-- 1 wwwrun www 514 Nov 23 14:59 Z.jpg -rw-r--r-- 1 wwwrun www 0 Nov 23 14:59 index.html path-to-your-your-cgi-bin-directory/pnp: drwxr-xr-x 5 wwwrun www 1192 Nov 24 09:28 . drwxr-xr-x 6 wwwrun www 280 Nov 23 14:49 .. -rw-rw-rw- 1 wwwrun www 181 Nov 23 14:59 .ht_change_the_password -rw------- 1 wwwrun www 20 Nov 23 14:59 .ht_pnp_pass.cgi drwxr-xr-x 2 wwwrun www 80 Nov 29 08:52 Apache drwxr-xr-x 3 wwwrun www 120 Jan 3 18:23 Convert drwxr-xr-x 2 wwwrun www 144 Nov 29 08:59 Crypt drwxr-xr-x 4 wwwrun www 208 Nov 21 12:29 File drwxr-xr-x 2 wwwrun www 152 Nov 28 10:16 Math drwxr-xr-x 3 wwwrun www 168 Jan 5 14:23 Net -rw-r--r-- 1 wwwrun www 2201 Jan 8 13:19 config.current.cgi -rw-r----- 1 wwwrun www 2212 Jan 5 14:29 config.default.cgi -rwxr-xr-x 1 root root 24591 Jan 5 14:47 configldap.cgi -rwxr-xr-x 1 wwwrun www 95539 Jan 5 14:29 configure.cgi -rwxr-xr-x 1 wwwrun www 27406 Jan 5 14:47 contacts.cgi -rwxr-xr-x 1 wwwrun www 3123 Jan 5 14:29 cpuinfo.cgi -rw-r--r-- 1 wwwrun www 0 Jan 5 14:29 default.htm -rw-r--r-- 1 wwwrun www 70401 Jan 5 14:50 directory.current.cgi -rwxr-xr-x 1 wwwrun www 3905 Jan 5 14:29 enc_progress.cgi -rwxr-xr-x 1 wwwrun www 1140 Jan 5 14:29 encbar.cgi -rwxr-xr-x 1 wwwrun www 18889 Jan 5 14:29 faq.cgi -rwxr-xr-x 1 wwwrun www 9407 Jan 5 14:29 faststart.cgi -rwxr-xr-x 1 wwwrun www 12992 Jan 5 14:29 fetch.cgi -rwxr-xr-x 1 wwwrun www 6106 Jan 5 14:29 files.cgi -rw-r----- 1 wwwrun www 336 Jan 5 14:29 footer_css.current.cgi -rw-r----- 1 wwwrun www 336 Jan 5 14:29 footer_css.default.cgi -rw-r----- 1 wwwrun www 343 Jan 8 13:19 footer_html.current.cgi -rw-r----- 1 wwwrun www 262 Jan 5 14:29 footer_html.default.cgi -rw-r----- 1 wwwrun www 1476 Jan 5 14:29 header_css.current.cgi -rw-r----- 1 wwwrun www 1476 Jan 5 14:29 header_css.default.cgi -rw-r----- 1 wwwrun www 1610 Jan 8 13:19 header_html.current.cgi -rw-r----- 1 wwwrun www 1436 Jan 5 14:29 header_html.default.cgi -rwxr-xr-x 1 wwwrun www 2744 Jan 5 14:29 index.cgi -rw-r--r-- 1 wwwrun www 0 Jan 5 14:29 index.htm -rw-r--r-- 1 wwwrun www 0 Jan 5 14:29 index.html -rwxr-xr-x 1 wwwrun www 30568 Jan 8 13:30 notify.cgi -rwxr-xr-x 1 wwwrun www 25634 Jan 5 14:29 oldconfig.cgi -rwxr-xr-x 1 wwwrun www 1182 Jan 5 14:29 pgbar.cgi -rwxr-xr-x 1 wwwrun www 15782 Jan 10 15:01 plugin.cgi -rw-r----- 1 wwwrun www 23067 Jan 8 13:19 pnp_config.pl -rw-r--r-- 1 wwwrun www 2340 Jan 5 14:49 pnp_ldap.pl -rw-r----- 1 wwwrun www 11400 Jan 5 14:29 pnp_lib.pl -rwxr-xr-x 1 wwwrun www 11889 Jan 8 13:21 progress.cgi -rwxr-xr-x 1 wwwrun www 9397 Jan 5 14:29 select.cgi -rwxr-xr-x 1 wwwrun www 40528 Jan 8 13:13 select_.cgi -rwxr-xr-x 1 wwwrun www 1575 Jan 5 14:29 sponsor.cgi -rwxr-xr-x 1 wwwrun www 3879 Jan 5 14:29 stats.cgi -rwxr-xr-x 1 wwwrun www 1185 Jan 5 14:29 user_dir.cgi path-to-your-your-cgi-bin-directory/pnp/Apache: drwxr-xr-x 2 wwwrun www 80 Nov 29 08:52 . drwxr-xr-x 6 wwwrun www 1344 Nov 30 11:39 .. -rw-r--r-- 1 wwwrun www 19791 Nov 28 12:18 Htpasswd.pm path-to-your-your-cgi-bin-directory/pnp/Convert: drwxr-xr-x 3 wwwrun www 120 Jan 5 14:29 . drwxr-xr-x 8 wwwrun www 1552 Jan 8 13:35 .. drwxr-xr-x 2 wwwrun www 192 Jan 5 14:29 ASN1 -rw-r--r-- 1 wwwrun www 9407 Jan 5 14:29 ASN1.pm -rw-r--r-- 1 wwwrun www 9564 Jan 5 14:29 ASN1.pod path-to-your-your-cgi-bin-directory/pnp/File: drwxr-xr-x 4 wwwrun www 208 Nov 23 14:49 . drwxr-xr-x 5 wwwrun www 1192 Nov 24 09:28 .. drwxr-xr-x 2 wwwrun www 80 Nov 23 14:49 Copy -rw-r--r-- 1 wwwrun www 14187 Nov 23 14:59 Copy.pm -rw-r--r-- 1 wwwrun www 53521 Nov 23 14:59 MMagic.pm drwxr-xr-x 2 wwwrun www 128 Nov 23 14:49 Spec -rw-r--r-- 1 wwwrun www 10397 Nov 23 14:59 Spec.pm -rw-r--r-- 1 wwwrun www 0 Nov 23 14:59 index.html path-to-your-your-cgi-bin-directory/pnp/Crypt: drwxr-xr-x 2 wwwrun www 112 Nov 23 14:49 . drwxr-xr-x 5 wwwrun www 1192 Nov 24 09:28 .. -rw-r--r-- 1 wwwrun www 7312 Nov 23 14:59 CipherSaber.pm -rw-r--r-- 1 wwwrun www 6354 Nov 29 08:58 PasswdMD5.pm -rw-r--r-- 1 wwwrun www 0 Nov 23 14:59 index.html path-to-your-your-cgi-bin-directory/pnp/Math: drwxr-xr-x 2 wwwrun www 152 Nov 23 14:49 . drwxr-xr-x 5 wwwrun www 1192 Nov 24 09:28 .. -rw-r--r-- 1 wwwrun www 10457 Nov 23 14:59 Interpolate.pm -rw-r--r-- 1 wwwrun www 6873 Nov 23 14:59 IntervalSearch.pm -rw-r--r-- 1 wwwrun www 0 Nov 23 14:59 index.html path-to-your-your-cgi-bin-directory/pnp/Net: drwxr-xr-x 3 wwwrun www 168 Jan 5 14:29 . drwxr-xr-x 8 wwwrun www 1552 Jan 8 13:35 .. drwxr-xr-x 4 wwwrun www 856 Jan 5 14:29 LDAP -rw-r--r-- 1 wwwrun www 23802 Jan 5 14:29 LDAP.pm -rw-r--r-- 1 wwwrun www 24303 Jan 5 14:29 LDAP.pod -rw-r--r-- 1 wwwrun www 1488 Jan 5 14:29 LDAPI.pm -rw-r--r-- 1 wwwrun www 1878 Jan 5 14:29 LDAPS.pm # 2 # Open the PaKnPost Pro Configuration Manager with a Web browser to configure it eg. http://www.yourdomain.com/cgi-bin/pnp/configure.cgi The initial username is admin with password initial The first time you run the Configuration Manager, you will be prompted to change the password for the admin user. Change it IMMEDIATELY to prevent unauthorised people re-configuring your PaKnPost Pro installation ==================== * * *IMPORTANT * * * ==================== Read README.txt to understand the various configuration options. TAKE NOTE of any WARNINGS or configuration suggestions. If you've Updated a previous installation of PaKnPosT Pro, click on "View Old Configuration Settings" to check and and copy existing settings to your new config file Check then SAVE your new configuration settings. # 4 # Create/edit the Contacts Directory if you will be using one. You may create or refresh the Contacts Directory from an corporate Exchange address list (or other LDAP compliant directory) using the PaKnPosT Pro LDAP Plugin available from http://www.paknpost.com # 5 # Direct users of PaKnPost Pro to http://www.yourdomain.com/pnp or http://www.yourdomain.com/cgi-bin/pnp/index.cgi # 6 # If you have a secure Web server running, you may optionally direct users to https://www.mydomain.com/pnp so that transactions are encrypted. ===================================================================== ####### If you are upgrading an existing installation ####### ===================================================================== The PaKnPosT Pro installer script will automatically back up existing configuration settings if it detects a previous installation and you choose to upgrade rather than to re-install. In this case, when you run the Web configuration manager, you will be able to click "View Old Configuration Settings" to see your old settings in a new window. You may then check these settings and transfer them to your new configuration. If you are upgrading by hand and not using the installer script, you will need to do the following in order to back up your existing configuration BEFORE copying new files to the server: In the directory path-to-your-your-cgi-bin/pnp Delete the following files if they exist: header_css.old_default.cgi footer_css.old_default.cgi header_html.old_default.cgi footer_html.old_default.cgi header_css.old_current.cgi footer_css.old_current.cgi header_html.old_current.cgi footer_html.old_current.cgi config.old_current.cgi .ht_change_the_password Rename the following: config.current.cgi to config.old_current.cgi header_css.default.cgi to header_css.old_default.cgi footer_css.default.cgi to footer_css.old_default.cgi header_html.default.cgi to header_html.old_default.cgi footer_html.default.cgi to footer_html.old_default.cgi header_css.current.cgi to header_css.old_current.cgi footer_css.current.cgi to footer_css.old_current.cgi header_html.current.cgi to header_html.old_current.cgi footer_html.current.cgi to footer_html.old_current.cgi DO NOT: Rename ht_pnp_pass.cgi to .ht_pnp_pass.cgi If you do, your existing admin username and password will be replaced by the default ===================================================================== ####### Installing PaKnPosT Plugins ####### ===================================================================== # 1 # Ensure that PaKnPost Pro is properly installed, configured and operational # 2 # Ensure that unzip (from the Infozip package) is installed on your PaKnPosT Pro server # 3 # Ensure that you have a copy of the desired PaKnPosT Pro Plugin file on your local computer # 4 # From the front page of PaKnPosT Pro, click the Admin link to enter the Configuration Manager, click on Install PaKnPost Pro Plugin link. This will open the Installer in a new browser window # 5 # Transfer the Plugin from your local computer to the PaKnPosT server and the Installer will transfer the Plugin file to the server and install it # 6 # Installed Plugins are listed with the PaKnPosT Pro Revision Number in the Configuration Manager ===================================================================== ####### Troubleshooting notes ####### ===================================================================== ===> "Premature end of script headers" error, Server 500 error Things to check: - did you transfer script and configuration files using FTP ASCII mode? - are script and config file and directory file permissions correct? Check the file listings for typical permissions settings - are file paths configured correctly? (see "file write errors" below) - are there syntax errors in hand-edited config files? perl -c will usually point you in the right direction - are there entries in the web server error log which suggest a fix? - is the web server configured to run cgi files? - is perl installed in /usr/bin (Linux) C:\usr\bin (Windows)? ===> File write errors Things to check: - file path configuration Be aware that the path you see in an FTP client will most likely have your user directory as the root, but this won't reflect the ACTUAL server path to your directory eg. the path you may see in your FTP client might look something like /username/public_html/pnp/files but the server path might actually be something like /hsphere/home/username/public_html/pnp/files. You'll need to check with your hosting provider. - file or directory permissions errors You may need to relax file permissions to allow your web server to write to files or directories. Use your FTP client (or chmod from shell) to change the permissions to 774, or as a last resort 777 to check this. NOTE: gradually re-tighten permissions to the most secure you can while still retaining functionality - leaving files or directories with open permissions is inherantly insecure and a very bad idea. ===> Email doesn't get sent/delivered Sendmail Method ('Sendmail' may be any MTA eg. Sendmail, Postfix, Qmail) Things to check: - is 'Sendmail' configured to relay mail? - (Windows) is Bmail installed in the %windir%\system32 folder? Is Bmail passing the email off correctly to the local MTA? Is the local MTA configured to relay mail from localhost? - are there errors reported in system logs, MTA logs or 'Sendmail' logs? MTA Relay Method Things to check: - is the MTA configured to accept mail from the PaKnPost Pro server for relay? - is the PaKnPost Pro configuration for the IP address of the MTA correct? - is the PaKnPosT Pro configuration for the domain name for the HELO command correct? - is email being blocked by a spam filter? - is there a firewall or other network access control blocking email egress? ===> Files are not being automatically cleared from the system after the retention period has elapsed Things to check: - is clear_efiles.pl being called from cron once a day? - is the file path to the holding area directory correctly configured in clear_efiles.pl? ===> General things to check: - is the Mandatory and relevant Optional software for your platform installed, configured and running correctly? - is software visible to the system via environmental path settings? ===================================================================== ####### See README.txt for configuration and usage notes ####### =====================================================================