[Summary view] [Print] [Text view]

   1  README 
   2  
   3  CRM [ http://www.crm-ctt.com - hidde AT it DASH combine DOT com ]
   4  
   5  Current version is 3.4.2 - Current database version is 3.4.2
   6  
   7  -> You need at least MySQL version 4.1 to use CRM-CTT!
   8  
   9  INSTALLATION INSTRUCTIONS (for upgrading see the UPGRADING file)
  10  
  11  1. Copy all files to a webserver-accessible directory, e.g. http://yoursite.com/crm/.
  12  
  13  1a. (optional) For easy installation, typ "chmod 777 config.inc.php" in your installation directory.
  14  
  15  2. Point your browser to the installation directory and follow the installation instructions.
  16  
  17  2a. (if you did 1a) do a "chmod 755 config.inc.php" in your installation directory. (and a chown if you like)
  18  
  19  3. Add a cron job to some machine (could be local, but also remote) to start the email-notifier for entities:
  20  
  21      An example from my cron file: (the cron user doesn't need to be root)
  22      
  23      # CRM Alarm date manager
  24      0 8 * * *       wget http://yoursite.com/crm/duedate-notify-cron.php?password=yourCRONpwd\&reposnr=XXX 1> /dev/null 2> /dev/null
  25      0 15 * * *      wget http://yoursite.com/crm/duedate-notify-cron.php?password=yourCRONpwd\&reposnr=XXX 1> /dev/null 2> /dev/null
  26  
  27      This will send an e-mail notification at 8 AM and 3 PM. Entities wich will be mentioned are entities which have
  28      an alarm date set to `today`.
  29  
  30      The reposnr=XXX part resembles the repository number you'd like to send notifications for. reposnr=0 for the first, 
  31      reposnr=1 for the second and so on (equal to the values in your config file).
  32  
  33      Skip the "1> /dev/null 2> /dev/null" part if you'd like reports mailed to the user under which the crond job runs.
  34  
  35      You can edit the cron script password using the administration interface (change system values, cronpassword). It is 
  36      recommended you change this password regularly for it is transmitted in plain text.
  37  
  38      Try the wget (or lynx --source) command first from the command line! It'll give nice output so you'll see if it all works.
  39  
  40  6. Use the 'Change system values' option to set a global admin password (admpassword)
  41  
  42  7. READ THE ADMINISTRATION MANUAL! There are some variables which you must set!
  43  
  44  8. If the directory webdav_fs/ is not writeable by the webserver (the installation procedure mentions this)
  45     you will have to change the owner of the directory, e.g. "chown apache.apache webdav_fs/" and, to prevent
  46     other users from accessing it, issue a "chmod 700 webdav_fs/". I have no clue how to do this on Windows,
  47     but on the other hand, knowing Windows security is not that good, it will probably work out of the box.
  48  
  49  9. Done. All settings can be modified using the 'administration' page.
  50  
  51  TROUBLESHOOTING / FAQ
  52  
  53  There are a few known troubles which you can take a shot at:
  54  
  55  - I see warnings like "Notice: Undefined variable: step in ..." 
  56  
  57      The notices about undefined variables are there because you have a rather new version of PHP, which has a 
  58      high verbosity level by default, which in your case is probably set to 'notice' instead of 'error'. If you modify your 
  59      php.ini and set the notify level to 'errors only' (or something like that) this problem is gone. PHP 
  60      can handle undefined variables very well, and I don't get why the latest versions they released have set 
  61      the notification standard to such a verbose level.
  62  
  63  - When I click the "Go to step 1" button it seems to just refresh the install.php browser screen and go no further.
  64  
  65      This issue is due to another PHP (php.ini) related problem when using one of the latest releases of PHP. 
  66      Just set the REGISTER_GLOBALS variable in your php.ini to 'yes' and this problem is solved.
  67  
  68  KNOWN ISSUES
  69  
  70  - This application does not work correctly when using Konquerer as your browser. Tested are IE and Netscape 6+.
  71  - The administraton section is not multi-lingual
  72  - The "Alarm Settings" dialog box is not multi-lingual
  73  - The manual is only available in English