Cowtacular Installation Instructions
====================================
Version 0.50

The instructions below are for your typical linux installation (Ubuntu
in my case).  They may need to be adjusted to fit your needs and system
configuration.

After the general installation instructions are some distribution
specific notes that might help you.


-------------
Requirements:
-------------
  - A web server
  - PHP v5.2 or later w/ the following options compiled / installed
        --with-openssl
	--enable-sqlite-utf8
	--with-imap 
	--with-imap-ssl
	--enable-sysvsem
	--with-pear
	--with-curl
	--with-pcre
  - SQLite PDO PHP libraries and modules
  - Mail PEAR module
  - Net_SMTP PEAR module
  - A location on your webserver that is read/writeable by the web
    server process.


-----------------------------------------------
Installation Steps: - New installations only!!!
-----------------------------------------------
Step1 - Unpack the archive into a folder that is accessible via http://
        on your web server.  For example, on many linux systems this is
        /var/www

	# mkdir /var/www/cowtacular
        # cd /var/www/cowtacular
	# tar -vxzof /tmp/cowtacular-0.50.tar.gz
	
	You may addiitionally need to adjust the permissions on this
	folder if they are not set properly by default.  Usually 
	the following works.  You should not do this unless you are
	receviving access/forbidden errors.

	# chmod 755 -R /var/www/cowtacular

Step2 - Create a location to store the database data.  This location
        should not be in the webroot, but should be read/writeable
        by the web server user (often www-data on many linux systems).
	I suggest /var/local/cowtacular

        # mkdir /var/local/cowtacular

	Next copy the default/empty databases included to this location

	# cp /var/www/cowtacular/dbase/* /var/local/cowtacular/.

	Finally, adjust the permissions on the folder and files in this
        location

	# chmod 775 -R /var/local/cowtacular
	# chown www-data -R /var/local/cowtacular
	# chgrp www-data -R /var/local/cowtacular


Step3 - Edit the cow-config.php file where you unpacked cowtacular to.
        You'll need to set the database location within this file.	

	# vi /var/www/cowtacular/cow-config.php

	Change the variable $datalocation to relect where you placed
        your data files in step2.  In our example, this would be changed
        to:

        $datalocation = "/var/local/cowtacular/";

        There are some other variables here you may want to consider 
        changing.  The $templocation should work for most linux systems.


Step4 - Point your browser to the cowtacular system you just setup.  If
        all goes will you should be greeted with a picture of a cow and
        two options.  Select the "Rep Interface" option.  Login with
        these default credentials:

        username: admin@admin
        password: blahpw

Step5 - Minimal configuration needs to be done before you should start
        using the system.  Pull down the Admin menu and select System.
        Set the following settings at a minimum.

        "http:// address to system" - This should be set to the web
        address you used in step4.  For example:
        http://www.mywebserver.com/cowtacular

        "Timezone" - Please set this to your timezone so that dates
        and times are displayed properly.

        There is an Update button at the bottom you need to hit to save
        these settings

Step6 - Change the admin@admin account password from blahpw to something
	else.  You can do this by clicking on Preferences.  Typing in 
	your new password twice and clicking update.

That's it.  You are minimally setup.  Of course there is much additional 
configuration you'll probably want to make.


-----------------------
 Ubuntu 8.04 notes
-----------------------
The development of Cowtacular is mostly done on Ubuntu and Debian based 
systems.  The following commands (run as root via sudo) are typically
all that is needed to install the components that are required.  

apt-get update
apt-get upgrade
apt-get install apache2 sqlite3 libcurl3
apt-get install php5 php5-sqlite php5-sqlite3 php5-cli php5-imap php-pear
pear install Mail 
pear install Net_SMTP
/etc/init.d/apache2 restart


-----------------------
 Ubuntu 10.04 notes
-----------------------
The development of Cowtacular is mostly done on Ubuntu and Debian based
systems.  The following commands (run as root via sudo) are typically
all that is needed to install the components that are required.

apt-get update
apt-get upgrade
apt-get install apache2 sqlite3 libcurl3
apt-get install php5 php5-sqlite php5-curl php5-cli php5-imap php-pear
pear install Mail
pear install Net_SMTP
/etc/init.d/apache2 restart

© 2009 Cowtacular LLC