Welcome to zenTrack!

  The following document describes everything you need to know to get a basic
  ZT install up and running.  Please read it line by line!  If you encounter
  problems then try the HELP doc in this same directory.
 
--------------------
REQUIREMENTS
--------------------
    PHP >= 4.3.9 (PHP > 5.2 recommended)
    Supported Servers: Apache 2, IIS
    Supported OS: Windows 2000/XP/Vista/Server, CentOS, Any Linux 
       User Tested OS: FreeBSD, NT, MacOS, Debian, Gentoo
    Supported DBs: Mysql, Oracle 8i/9i, SQLServer
       User Tested DBs: DB2, Postgres
       
  --------------
  PHP.INI CONFIGURATION NOTES
  --------------
    - Make sure you turn off notices in your php.ini file: 
        error_reporting = E_ALL & ~E_NOTICE
    - Insure that you have set session.save_path to a valid directory
    - Ensure that short_open_tag = On

  --------------
  INSTALL INSTRUCTIONS:
  --------------
     0. CVS Installs:
        - If you did not check this out from CVS (or don't know what that means)
          then skip this step!
        - You should have checked out a release tag and not the HEAD code.  If
          you don't know that that means, then download an install!
        - run ./setup_from_cvs (or setup_from_cvs.cmd)
          from the root directory

     1. Place files where you want them:
        - place www/ in the htdocs/wwwroot directory tree
        - place includes/ in a non-httpd directory (for maximum security)
     
     2. Configure the header file:
        - open www/header.php
        - look through this file carefully
        - you must configure $libDir, $rootWWW, and $rootUrl or nothing will work
        - you must set the database settings correctly

     3. Build the database:
        - create a database instance and a user with access to this DB
        - locate install/build_[yourdb].sql and run it in your SQL interface
          this will create your db tables
        - locate install/seed_[yourdb].sql and run it in your SQL interface
          this will populate your db
	
     4. Check permissions:
        - windows users can probably skip this step
        - chmod 777 includes/attachments (if using attachments)
        - chmod 777 includes/logs
        - chmod 777 includes/cache
        - chmod 777 includes/translations
        - for maximum security, you can chown/chgrp the files to the web process
          such as 'apache' and then chmod to 770 instead.
     
     5. Log in and configure:
        - log in as Administrator/Administrator and configure the system to taste.
        - a guest account exists as Guest/Guest, you may wish to delete/edit this account
        - a user account exists as User/User, you may wish to delete/edit this account

     6. If you intend to use the email gateway, please read the online docs
        which give a thorough overview of how to set this up:
        you must have some admin and smtp knowledge to do this (it is not trivial!)
        (you can find the docs through the home page:  http://www.zentrack.net)
 
     7. Speak Up!
        Let us know you are using zentrack, meet other users, 
        and send us feedback on your install: http://www.zentrack.net

     8. Consider a donation to the Open Source Community:
        The developers spend a lot of their lives developing this product.  If you like it,
        give something back to the open source community!  I would recommend starting here:
        http://sourceforge.net/project/project_donations.php?group_id=22724

  --------------
  TROUBLESHOOTING
  --------------

    Check the HELP file in this directory for more info about common errors
    and for obtaining support.