##########################################################################
#                                                                        #
#	Cyclonic Web-Mail Engine V4.0    				 #
#                                                                        #
#	Copyright (c) 1998-2001 STALLION Networking.                     #
#       All Rights Reserved.                                             #
#                                                                        #
#	Version Information:	4.0                                      #
#                                                                        #
##########################################################################

INSTALLING:


 1) Start by making sure the entire Cyclonic Directory structure is owned
    by the user that your Web Server runs under (eg. nobody or http) 

 2) Enter the /libs directory and untar each Library, and install it.
    These are standard Perl Libraries and install in the standard manner.

 3) You will now need to copy the images contained in the /images
    directory onto your Web Server so that the Web Server has access to
    the images. (eg. /home/apache/htdocs/cyclonic4)

 4) You will also need to move all of the help pages in the help directory
    onto your Web Server. (eg. /home/apache/htdocs/cyclonic4/help)

 5) Once all of the libraries are installed, and you have moved the images
    onto your Web Server -  open the Cyclonic Configuration File
    (cyclonic.conf) and go through it  - entering all of the correct
    settings, directory paths, and addresses for your installation.
 
 6) At this stage it should be possible to run the Cyclonic Perl script in
    your browser by typing in the address to the script on the Web Server.
    (eg. http://www.foo.com/cgi-bin/cyclonic4/cyclonic.pl)

 7) Now that Cyclonic is running you can now look at modifying the
    look of the pages by editing the templates found in the /require
    directory. Further information about customization of the Cyclonic
    Templates can be found in the Modify.txt Document. This Document also
    includes information about use of the language dictionaries.


TROUBLESHOOTING:

 1) If you have any problems installing the Cyclonic Software please do
    not hesitate to contact our Support Department who are more than happy
    to help you to install the Cyclonic Software.

 2) When running the script I get "Cannot open Directory" errors.

    - make sure that the entire Cyclonic Directory path is owned by the
      same user that the Web Server runs under.

 3) When running Cyclonic I cannot download the attachments.

    - make sure you have set the two attachment directory paths correctly,
      remembering one should be the path on the server and the other
      should be the path via the Web Server.

 4) Cyclonic errors when I try and run it - giving a Server Error Message.

    - make sure that you have installed all of the required Libraries
      under the /libs directory and that you are running the correct Perl
      Version or higher. It might be an idea to try installing all of the
      libraries again - this time making sure to check for any errors when
      installing each library.


Another way of tracking down problems that you encounter is to run the
Cyclonic Script from the command line. Simply go into the Cyclonic
Directory and execute the script using the following command:

#>> perl cyclonic.pl

If the script is succesfully installed it should return:
 
    (offline mode: enter name=value pairs on standard input)

If it does not return this successfully then you will need to check to
make sure you have followed the installation steps correctly, in most
instances it will output errors which should tell you where the error has
occured. These will either be related to incorrect paths or permissions.

Please contact our Support Department should you not be able to resolve 
the problems. Our Support Department will be happy to help you with the
installation.

Support: support@stallion.au.com