report/render: fixes from xrg branch
[odoo/odoo.git] / doc / INSTALL
1 OpenERP Quick Installation Guide
2 ---------------------------------
3
4 This file contains a quick guide to configure and install the OpenERP server.
5
6 Required dependencies:
7 ---------------------
8
9 You need the following software installed:
10
11     * Python 2.5 or 2.6
12     * Postgresql 8.2 or above
13     * Psycopg2 python module 
14     * Reportlab pdf generation library for python
15     * lxml python module
16     * pytz python module
17
18 Some dependencies are only required for specific purposes:
19
20 for rendering workflows graphs, you need:
21     * graphviz
22     * pyparsing
23
24 For Luxembourg localization, you also need:
25     * pdftk (http://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/)
26
27 for generating reports using non .jpg images, you need:
28     * Python Imaging Library for python
29
30 For Debian-based distributions, the required packages can be installed with the 
31 following command:
32
33   #> apt-get install -y postgresql graphviz python-psycopg2 python-lxml python-tz python-imaging
34
35 For Fedora 
36 if they are not installed, install:
37 python and postgresql
38
39 uses yum or you can recover required packages on fedora web site in "core" or "extra" repository :
40 postgresql-python
41 python-lxml
42 python-imaging
43 python-psycopg2
44 python-reportlab
45 graphviz
46 You can find pyparsing at http://pyparsing.sourceforge.net/ 
47
48 1. Check that all the required dependencies are installed.
49
50 2. Launch the program "python ./bin/openerp-server.py -r db_user -w db_password --db_host 127.0.0.1".
51 See the man page for more information about options.
52
53 3. Connect to the server using the GUI client. And follow the instructions to create a new database.
54