/dev/trunk

To get this branch, use:
bzr branch http://darksoft.org/webbzr/dev/trunk

« back to all changes in this revision

Viewing changes to docs/INSTALL

  • Committer: Suren A. Chilingaryan
  • Date: 2008-04-02 10:23:22 UTC
  • Revision ID: csa@dside.dyndns.org-20080402102322-okib92sicg2dx3o3
Initial import

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/INSTALL
 
1
REQUIREMENTS
 
2
============
 
3
 - Any WEB server with PhP support (i.e. Apache)
 
4
 - MySQL 5.0 (or later)
 
5
 - PhP 5.2.5 (or later)
 
6
    PhP modules: zlib, zip, mysql, pdo, json, nls, xml, session
 
7
    PEAR modules: Spreadsheet_Excel_Writer
 
8
    PhP applications: jpgraph
 
9
    
 
10
 - READER requirements
 
11
    MSSQL reader: FreeTDS library, ODBC php module
 
12
 
 
13
 - ROOT 5.17.05 (or later) is needed for ROOT export [ Actually the earlier 
 
14
 versions will work if "TAxis::SetRangeUser" fix will be applied. The patch
 
15
 is available at http://dside.dyndns.org/projects/ ]
 
16
    
 
17
 - Hardware:
 
18
    + Ticks time class is only working on 64bit platforms
 
19
    
 
20
 Apache CONFIGURATION
 
21
 --------------------
 
22
 - It is good idea to allow overriding apache configuration in .htaccess files.
 
23
 You will need to set 'AllowOverride' directive within apache2 configuration
 
24
 for the ADEI directory.
 
25
    AllowOverride All
 
26
 
 
27
 PhP CONFIGURATION
 
28
 -----------------
 
29
 - The configuration of both mod_php (normally in /etc/php/apache2-php5/php.ini)
 
30
 and command line client (/etc/php/cli-php5/php.ini) should be set.
 
31
 
 
32
 - The php should ignore E_NOTICE (default behaviour). The E_NOTICE reporting
 
33
 could be enabled in php.ini by "error_reporting = ..." statment. Set it to
 
34
    error_reporting = E_ALL & ~E_NOTICE
 
35
 
 
36
 - The short open tag "<?" should be enabled. Add
 
37
    short_open_tag = On
 
38
    
 
39
 - If application is working with big amounts of data, you probably need to
 
40
 increase maximal execution time of scripts (afterwards they are killed), and
 
41
 maximum amount of memory script can utilize.
 
42
    max_execution_time = 300
 
43
    memory_limit = 1024M
 
44
    
 
45
 - Alternatively it is possible to set this values in .htaccess file. To do
 
46
 so, the 'AllowOverride' directive within apache configuration should be set 
 
47
 to 'Options' or 'All'.
 
48
 
 
49
 JpGraph CONFIGURATION
 
50
 ---------------------
 
51
 - JpGraph requires 'arial.ttf' and other MS true type fonts for it operation.
 
52
 By default it looks them in '/usr/X11R6/lib/X11/fonts/truetype'. 
 
53
 The location could be adjusted in 'jpg-config.inc.php', 'TTF_DIR' variable�
 
54
 
 
55
 - JpGraph sometimes reports errors (for example, arial.ttf not found error)
 
56
 in a very strange manner: It prints incomplete PNG on standart output (even
 
57
 if it is not asked for a graph yet or it should create a graph in a file).
 
58
 
 
59
 FreeTDS CONFIGURATION
 
60
 ---------------------
 
61
 - The FreeTDS should be compiled with unixODBC and MSDBLib support. The TDS
 
62
 version should be set to 7.0. The following configure line will do the job
 
63
    ./configure --with-unixodbc=/usr --enable-msdblib --with-tdsver=7.0
 
64
 a) You may need to correct the path where unixODBC is actually installed.
 
65
 b) The FreeTDS version should mandatory set. You will get very strange effects
 
66
 while it configured to other value (4.2 for example)
 
67
 
 
68
 ODBC CONFIGURATION
 
69
 ------------------
 
70
  - For MSSQL Support:
 
71
    a) create 'tds.driver.template' with following content
 
72
        [FreeTDS]
 
73
        Description     = v0.64 with protocol v8.0
 
74
        Driver          = /usr/lib64/libtdsodbc.so.0
 
75
    b) you may need alter driver path, to place libtdsodbc.so is actually
 
76
    residing.
 
77
    c) register driver in odbc
 
78
        odbcinst -i -d -f tds.driver.template
 
79
    
 
80
 ADEI CONFIGURATION
 
81
 ------------------
 
82
  - 'tmp' directory should be writable by apache