Translations by Xavier (Open ERP)

Installation

This chapter contains the general installation procedure for deploying OpenERP on the main supported platforms.

For **OpenERP Online (SaaS mode)** the installation is as simple as creating a new account on https://www.openerp.com/online. The first section in this chapter provides the answer to Frequently Asked Questions for SaaS usage.

For **OpenERP on-site**, the installation mainly consists of installing PostgreSQL (the database engine used by OpenERP), Python (built-in on most platforms) and then installing OpenERP itself, as an all-in-one package.

For those familiar with earlier OpenERP versions, the 6.1 series has a different architecture, and only requires the installation of a single OpenERP package.

OpenERP GTK Client Installation

The native GTK client is available as a legacy interface for users who still require it, but the recommended way to access OpenERP 6.1 is the built-in web interface.

Installing the required packages

Python 2.6 or later is required for OpenERP 6.1. It is built-in in Ubuntu version 10.04 and above. A few Python libraries are also required, as listed below.

On a Debian-based Linux distribution you can install all required dependencies with this single command::

Any PDF viewer, properly registered in your system to automatically open PDF files (e.g. xpdf, kpdf, acroread, evince, etc..). See the :ref:`configure-pdf-viewer-link` section.

RedHat-based distributions

As an alternative to the above commands meant for Debian-based distributions, the following command should install the required dependencies for RedHat-based systems::

As an alternative to the above commands meant for Debian-based distributions, the following command should install the required dependencies for Mandriva::

Downloading the OpenERP Client

The OpenERP client can be downloaded from the `OpenERP website's download page <http://www.openerp.com/downloads>`_

Testing the OpenERP Client

If you only want to test the client, you do not need to install it. Just unpack the archive and start the openerp-client executable: ::

The list of available command line parameters can be obtained with the ``-h`` command-line switch: ::

Installing the OpenERP Client

The client can be installed very easily using the *setup.py* file: ::

You can now run the client using the following command: ::

Configuring a PDF Viewer

Alternatively, you may also specify explicitly the PDF command to use to display PDF files in the OpenERP configuration file, normally located in your HOME directory, and named ``'.openerprc'``. Find the ``[printer]`` section and edit the ``softpath`` parameter. For example: ::

OpenERP Installation on Linux

The installation procedure for OpenERP 6.1 under Linux is explained in this chapter. This procedure is well tested on Ubuntu version 10.04 LTS. For those familiar with earlier OpenERP versions, the 6.1 series has a different architecture:

The web client is now embedded in the main OpenERP Server, and does not require separate deployment

The native GTK client is preserved as a legacy component, but the recommended way to use OpenERP is the web interface, as for all modern applications. There is usually no need to install the GTK client at all.

For **Debian-based distributions**, OpenERP is available as an All-In-One application package (``.deb``), that can be installed with a simple click. The package is available on the `OpenERP website's download page <http://www.openerp.com/downloads>`_

For **other Linux distributions** and for those who prefer a **manual installation**, there are only two steps to deploy OpenERP under Linux: install PostgreSQL, the database engine used by OpenERP, then install OpenERP itself. These steps are described in the following sections:

PostgreSQL Server Installation and Configuration

The `PostgreSQL download page <http://www.postgresql.org/download/linux>`__ lists the available installation methods. Choose the one that best suits your needs.

Example on Ubuntu

Use the following command at your system's command prompt to install the **postgresql** package: ::

For a graphical user interface of **postgresql**, use the following command: ::

You can find the new menu item **pgAdmin III** in your Ubuntu system menu from :menuselection:`Applications --> Programming --> pgAdmin III`.

Setup a PostgreSQL user for OpenERP

When the installations of the required software are done, you must create a PostgreSQL user. This user must be the same as your system user. OpenERP will use this user to connect to PostgreSQL.

*Figure demonstrating how OpenERP uses the PostgreSQL user to interact with it*

Without creating and configuring a PostgreSQL user for OpenERP as described below, you cannot create a database using OpenERP Client.

First Method

The default superuser for PostgreSQL is called **postgres**. You may need to login as this user first. ::

Now create PostgreSQL user **openerp** using the following command: ::

Make this new user a superuser. Only then you can create a database using OpenERP Client. In short, **openerp** is the new user created in PostgreSQL for OpenERP. This user is the owner of all the tables created by OpenERP Client.

To apply access rights to the role **openerp** for the database which will be created from OpenERP Client, use the following command: ::

Second Method

Another option to create and configure a PostgreSQL user for OpenERP is shown below: ::

Password

Note that the password is *postgres*.

Option explanations: