############################################################ # Chatologica Software Installation; Author: Daniel Dinev; # All rights reserved (c) 2004; http://www.chatologica.com/ ############################################################ REQUIREMENTS: ------------ Perl 5, Web Server QUICK INSTALL: (for the most impatient users) ------------- transfer the archive file to a directory on your server % tar xzf archive.tar.gz ( or: unzip -a archive.zip) % cd the_decompressed_directory % mv cgi some_dir_under_cgi-bin % mv html some_dir_under_htdocs % cd some_dir_under_cgi-bin % perl set-permissions.pl % cd some_dir_under_htdocs % perl set-permissions.pl call Admin Panel: http://.../some_dir_under_cgi-bin/admin/admin-t.cgi or http://.../some_dir_under_cgi-bin/admin/admin.cgi DETAILED INSTALLATION INSTRUCTIONS: ---------------------------------- 1. EXTRACT THE FILES FROM ARCHIVE: You can use any decompress tool available for your platform. For example on the Windows platform you can use WinZip (http://www.winzip.com). Usually on Unix platforms we use shell commands: - if ZIP archive: % unzip -a archive.zip The -a switch is important to force automated recognition of which files are in ASCII format and which are binaries. - if GZIP TAR archive: % tar xzf archive.tar.gz or if you have the older version of the tar program try: % gzip -cd archive.tar.gz | tar xf - 2. SETTING THE RIGHT PERL PATH: If your Perl version 5 in not in /usr/bin/perl you have to modify the first lines of some script files. Simply replace /usr/bin/perl with the real path to your Perl5. For example Hypermart.com users usually use the following first line: #!/usr/local/bin/perl In more than 90% of the cases you do not have to change anything, so if you are not sure where your Perl is, just skip this section and proceed. However if you wish to be sure where perl version 5 is installed try some of the following: - ask your system admin or read through the web hosting provider's support pages - test from the shell the following commands: % whereis perl % perl -v % /usr/bin/perl -v % /usr/local/bin/perl -v The scripts you have to modify are in the cgi directory: x.cgi nph-x.cgi x.fcgi admin/admin.cgi admin/nph-admin.cgi ... and all other files ending with .pl .mpl .cgi or .fcgi in the main cgi and cgi/admin directories 3. TRANSFER THE SOFTWARE TO YOUR WEB SERVER'S MACHINE: If the web server is running on a remote machine you have to FTP the software there. The network transfer mode must be ASCII for the text files, those which names end with: .cgi .fcgi .pm .pl .mpl .txt .htm .html .php .htaccess .nsconfig All other files should be transferred via binary mode. This software product consists of two parts. The first part are the files in the html directory and it should be transferred to a subdirectory of your htdocs, public_html, www or whatever your Web Documents Root is. The second part are the files in your cgi directory and they have to be saved in a subdirectory of cgi-bin or a directory where cgi scripts execution is allowed. 4. SETTING THE RIGHT FILE/DIRECTORY PERMISSIONS: AUTOMATICLY: ----------- If you have shell access simply execute set-permissions.pl scripts in both of the cgi and html directories. This will set the proper permissions for all of the files in the corresponding part of the software. % cd cgi % perl set-permissions.pl % cd html % perl set-permissions.pl MANUALLY: -------- Additionally, you can set permission through FTP if your server in based on a Unix platform. You can use WSFTP - ftp client for Windows which has the ability to set file permissions just through mouse clicks. Also you can use the standard command line FTP client to set permissions issuing commands like this: ftp> quote SITE CHMOD 6755 some-script.cgi We have to set the following permissions: 755 - for all script files ending with .cgi .fcgi .mpl or .pl 755 - for the cgi/ and admin/ directories 666 - for .../STD/Parameters.pm cgi/chatologica.txt html/chatologica.txt cgi/admin/.htaccess cgi/admin/.htpasswd cgi/admin/.nsconfig all modules under cgi/MTS4/MODULES/ directory any file under cgi/data/ and its subdirectories 777 - for cgi/MTS4/MODULES/, cgi/data and any of its subdirectories On Windows with NTFS file system with shell access try: % cacls cgi/data /T /E /C /P Everyone:C On Unix-type machine with shell access we can use commands like: % chmod -R 755 *.cgi *.fcgi *.mpl *.pl % chmod -R 755 cgi/ cgi/admin/ % chmod -R 777 cgi/data/* cgi/MTS4/MODULES % chmod -R 666 cgi/data/*.* cgi/admin/.ht* cgi/admin/.n* % chmod 666 cgi/*/*/Parameters.pm cgi/chatologica.txt html/chatologica.txt \ cgi/MTS4/MODULES/*.pm UNIX style file/directory permission descriptions: 755 (rwxr-xr-x): Read+Write+eXecute by user, Read+eXecute by group members and all other users 777 (rwxrwxrwx): Read+Write+eXecute by user, by group members and others 666 (rw-rw-rw-): Read+Write by user, by group members and others 5. CONFIGURATION: Point your browser to http://yourdomain/yourpath/admin/admin-t.cgi script to access your Admin Panel. Configure the software as needed (via Admin Panel) and access the main script at http://..../x-t.cgi, http://..../x.cgi etc ... If the Admin Panel does not appear properly, producing 'Internal Server Error' message, try some of the other admin scripts: admin.cgi admin.pl admin-t.pl .... TROUBLESHOOTING: --------------- You can look at cgi/admin/FAQs.htm file and/or try the Chatologica Automated Installer at http://www.chatologica.com/ if enabled for this product. GOOD LUCK!