# **************************************************************
# Copyright (c) Softerra LLC, 2000
# Description: Softerra TimeAssistant  installation instructions
# **************************************************************


Win32 installation rules for users with Internet Information Server (IIS)
or Personal Web Server (PWS) and MySql on local PC.
   
1. Install IIS or PWS.

2.  Install Time-Assistant.
2.1 Create new virtual directory "TimeAssistant" under your web server.
2.2 Uncompress the TimeAssistant distributive to this directory.
    The uncompressed distributive will consist of:
    TimeAssistant/          <- main root
    TimeAssistant/lib       <- location of all class and library files
    TimeAssistant/include   <- location of timesheet layout pages
    TimeAssistant/disp      <- location of timesheet pages
    TimeAssistant/images    <- location of timesheet images/banners
    TimeAssistant/css       <- location of timesheet CSS-file
    TimeAssistant/db        <- location of sql files for database creation
    TimeAssistant/scripts   <- location of common javascripts
    TimeAssistant/doc       <- location of documentation files
2.3 Create directory named "TimeAssistant" (you could create it anywhere at your hard disk).
   
3.  Install PHP4 under your web server.
3.1 Before installation carefully read the file Readme.txt from PHP4 distributive package and do 
    all necessary actions described in the file. For additional help visit the PHP site at         http://www.php.net.
    Don't forget to set the next parameters in php.ini file:
    -  extension_dir   =    directory with installed php
    -  browscap       =     path to your browscap.ini file
      (for WindowsNT it is c:\winnt\system32\inetsrv\browscap.ini).
3.2 After you have installed PHP, convince that it works. For this,
    in any virtual directory create file named test.php with one string:
    <? phpinfo(); ?> and start it in your browser.
    For example, http://localhost/TimeAssistant/test.php.
    If everything is correct you will see page with PHP variables on your screen.
3.3 Do the next changes in php.ini file:
    -  allow_call_time_pass_reference = On
    -  session.gc_maxlifetime    = 7200
    -  session.save_path         = any existing temporary folder on your PC 
    -  include_path    =     path to TimeAssistant virtual directory.
3.4  Add .php  extension for PHP files:    
    - if you use PWS:
     edit the enclosed PWS-php4.reg file to reflect the location of your
     php.exe.  Forward slashes should be escaped, for example:
     [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map]
     ".php"="C:\\Inetpub\\Webpub\\\php.exe" and run it.
    -if you use IIS:
     Under 'Home Directory', click on the 'Configuration' button.  Add a new
     entry to the Application Mappings;  Use the path the php.exe as the
     executable (for example C:\\Inetpub\\Webpub\\\php.exe),
     supply .php as the extension, leave 'Method exclusions', blank,
     and check the Script engine checkbox.
    
4. Install MySQL server.
4.1 Run setup.exe 
    For help visit the MySQL site at http://www.mysql.com.
    By default MySql will be installed in directory c:\mysql.
4.2 After MySql installation read carefully the file mysql/Readme and do all
    necessary actions described in it for MySql starting. 
    We advise you:
    - if you use Win95/98 - to add MySql to Startup folder.
    - if you use WinNT -  to add MySql to Services Control Manager.
    For example, on WinNT we have started in command line 
    "c:\mysql\bin\mysqld --install" and restarted our PC. 
    After this MySql started automatically every time PC restarted.
   
5. Create Time-Assistant database.
5.1 Verify that MySql is started.
5.2 Copy files Time-Assistant/db/create-db.bat and crebas.sql to mysql\bin. 
5.3 Run create-db.bat. 

6. Edit file database.inc.php  in TimeAssistant/include directory.
   You should set up  DB_host, DB_user, DB_password, DB_name. 
   and set your Currency ("$","FRF" or else). 

   By default, you must set: 
   define(DB_host,"localhost");        /* Your MySQL-Host */
   define(DB_user , "root");           /* Your MySQL-Username */
   define(DB_password , "");           /* Your MySQL-Password */
   define(DB_name , "timesheet2");      /* database */
      
7. Try to start a project.
   Your start login:    admin
   Your start password: admin 
