Cheap VPS & Xen Server

Residential Proxy Network - Hourly & Monthly Packages

Installation Of OpenERP Server 5.0, OpenERP GTK Client 5.0 And OpenERP Web Client 5.0.1 On Ubuntu Server 9.0.4 & Desktop 9.04

This article will show you how to set up openerp-server 5.0.0-3-1 + openerp-client 5.0.0-3-1 + openerp-web 5.0.1 on Ubuntu Server 9.04 & Desktop 9.0.4


Open ERP (formerly named Tiny ERP) is the leader open-source ERP/CRM system written mostly in Python and initiated in Belgium. It offers a three-tier web architecture, ease of use and flexibility.

With more than 1000 downloads per day, Open ERP is the most admired and the world’s fastest growing and used free open source management software solution in the world. Small and medium sized companies are now encouraged to use ERP.

Open ERP is very modular, each adoption produces new modules. So they can be installed optionally or not, depending on the need of each enterprise. More than 350 modules of different kinds are available: accounting, finance, stock management, manufacturing, services management, customer relations, sales, project management, document management, internal organization, human resources, direct marketing, e-commerce, point of sale, payroll,… And about 10-20 modules are produced monthly!

For Open Source software, experience has shown that there’s no need to train users for several months on the system, because they can just download it and use it directly. To make this process of learning fast and effective, Open ERP has taken several steps with its large partner network and community e.g. Forum and IRC which are platforms to discuss common topics among community and get help, Open ERP Planet is used to announce new developments in Open ERP, Launchpad is a unique collaboration and Bazaar code hosting platform for software projects. Other then these, detail Documentation is available which serve as a guide to understand and get started with Open ERP.

The latest version of OpenERP (5.0) was released inFebruary 10th 2009. Canonical’s Ubuntu 9.0.4 is the first Linux distribution that provides this release. We will probably have to wait a few months until other distributions (Fedora 12, OpenSuSE 11.3, CentOS, etc) ease the latest updates of OpenERP 5.x. Nevertheless, all these major distributions already offer tinyerp-server and client release 4.2.3 (without including openerp-web).

Major troubles during the setup

The most complicated part is with openerp-web 5.0.1 because of its dependency on TurboGears 1.0.8 . TurboGears 1.0.8 is not supported with the default Ubuntu 9.04 python version (python2.6)

OpenERP Web client 5.0.2 is still under development. This release is being migrated to CherryPy3 dropping the TurboGears framework as a major step to make the Web Client much more faster and easier to deploy. This will greatly reduce the pain of getting started with and deploying of OpenERP Web client. The number of third party dependencies will be reduced to 3-4 pure Python libraries. The initial test results offer almost 3-5 time speed improvement.

The default openerp-server and openerp-web INIT scripts cannot launch their corresponding services as non-root without fixing some technical issues. I will detail what configuration files and scripts have to be modified to avoid this.

Technical procedure. Initial installation and configuration

Upgrade of Ubuntu packages and installation of openerp and pgadmin:

$ sudo apt-get update

$ sudo apt-get upgrade

$ sudo apt-get install openerp-server openerp-client pgadmin3

To avoid having some of the labels untranslated in the GTK client, install the language-pack-gnome-YOURLANG-base package. The following command installs the spanish language pack:

$ sudo apt-get install language-pack-gnome-es-base

Postgres Database configuration:

$ sudo vi /etc/postgresql/8.3/main/pg_hba.conf

Replace the following line:

# “local” is for Unix domain socket connections only
local all all ident sameuser


#”local” is for Unix domain socket connections only
local all all md5

Restart Postgres:

$ sudo /etc/init.d/postgresql-8.3 restart

* Restarting PostgreSQL 8.3 database server [ OK ]

The following two commands will avoid problems with /etc/init.d/openerp-web INIT script:

$ sudo mkdir /home/openerp

$ sudo chown openerp.nogroup /home/openerp

Create a user account called openerp with password “openerp” and with privileges to create Postgres databases:

$ sudo su postgres

$ createuser openerp -P

Enter password for new role: (openerp)

Enter it again:

Shall the new role be a superuser? (y/n) n

Shall the new role be allowed to create databases? (y/n) y

Shall the new role be allowed to create more new roles? (y/n) n

Quit from user postgres:

$ exit


Edit OpenERP configuration file:

$ sudo vi /etc/openerp-server.conf

Replace the following two lines (we don’t force to use a specific database and we add the required password to gain access to postgres):

db_name =
db_user = openerp
db_password = openerp

Troubles with Python releases: Python 2.6 is not yet supported by OpenERP 5.0, but it is the default Python release on Ubuntu 9.0.4. We need to launch OpenERP 5.0 with Python 2.5 or earlier. There’s also a problem with python-xml package in Ubuntu so we will reinstall it.

Python 2.5 setup:

$ sudo apt-get install python2.5 python2.5-dev python-profiler

Reinstall python-xml:

$ wget

$ tar xvzf PyXML-0.8.4.tar.gz

$ cd PyXML-0.8.4/

$ sudo python2.5 install

Make the following symbolic link:

$ sudo ln -s /usr/lib/python2.6/dist-packages/oldxml/_xmlplus/utils/ /usr/lib/python2.5/site-packages/oldxml/_xmlplus/utils/

Force openerp-server to be launched with Python2.5:

$ cd /usr/bin/

$ sudo cp openerp-server openerp-server.ORIG

$ sudo vi openerp-server

Replace the following line:

exec /usr/bin/python ./ $@


exec /usr/bin/python2.5 ./ $@

We can now restart openerp-server:

$ sudo /etc/init.d/openerp-server restart

Restarting openerp-server: openerp-server.

Check out the logs:

$ sudo cat /var/log/openerp.log

[2009-06-14 21:06:39,314] INFO:server:version – 5.0.0

[2009-06-14 21:06:39,314] INFO:server:addons_path – /usr/lib/openerp-server/addons

[2009-06-14 21:06:39,314] INFO:server:database hostname – localhost

[2009-06-14 21:06:39,315] INFO:server:database port – 5432

[2009-06-14 21:06:39,315] INFO:server:database user – openerp

[2009-06-14 21:06:39,315] INFO:objects:initialising distributed objects services

[2009-06-14 21:06:39,502] INFO:web-services:starting XML-RPC services, port 8069

[2009-06-14 21:06:39,502] INFO:web-services:starting NET-RPC service, port 8070

[2009-06-14 21:06:39,502] INFO:web-services:the server is running, waiting for connections…

OpenERP is now up and running, connected to Postgres database on port 5432 and listening on ports 8069 and 8070.

$ ps uaxww | grep -i openerp

root   2276  0.0  2.3 185576 23708 ?        Sl   13:09   0:00 /usr/bin/python2.5 ./ –config=/etc/openerp-server.conf

$ sudo lsof -i :8069


python2.5 2276 openerp 3u IPv4 6515 TCP localhost:8069 (LISTEN)

$ sudo lsof -i :8070


python2.5 2276 openerp 5u IPv4 6520 TCP *:8070 (LISTEN)

Creation of a new database for OpenERP Server with OpenERP GTK Client (Optional)

Launch openerp-client and create a new database for openerp-server:

$ openerp-client

File/Archivo -> Databases/Bases de Datos -> New Database/Nueva Base de Datos




Super-administrator password: “admin”

New database name: “openerp”

Administrator password: “openerp”

Confirm password: “openerp”



HTTPS with Apache

$ sudo apt-get install apache2

$ sudo a2enmod ssl

$ sudo a2ensite default-ssl

$ sudo /etc/init.d/apache2 restart


Forcing Apache to redirect HTTP traffic to HTTPS

Choose a ServerName/URL for your OpenERP Web service, like

$ sudo vi /etc/apache2/sites-available/default

<VirtualHost *:80>
 Redirect /

$ sudo a2enmod proxy

$ sudo a2enmod proxy_http

$ sudo a2enmod proxy_connect

$ sudo a2enmod proxy_ftp

Add your server’s IP address and URL in /etc/hosts:

$ sudo vi /etc/hosts

Replace       localhost       yourhostname

With     localhost
192.168.x.x yourhostname

$ sudo vi /etc/apache2/sites-available/default-ssl

<VirtualHost *:443>
 ServerAdmin webmaster@localhost
<Proxy *>
 Order deny,allow
 Allow from all
 ProxyRequests Off
 ProxyPass        /
 ProxyPassReverse /

Restart Apache:

$ sudo /etc/init.d/apache2 restart

Check out your URL with a browser:


Block OpenERP Web server port 8080 with a firewall

Do it locally as the first command will close all the existing ssh connections:

$ sudo ufw enable

$ sudo ufw allow ssh

$ sudo ufw allow http

$ sudo ufw allow https

Add the following lines:

Ubuntu Server 9.0.4:

$ sudo vi /etc/openerp-web.cfg

Ubuntu Desktop 9.0.4:

$ sudo vi /usr/lib/python2.5/site-packages/openerp_web-5.0.1_0-py2.5.egg/config/default.cfg

base_url_filter.on = True
base_url_filter.use_x_forwarded_host = False
base_url_filter.base_url = ""

!Be careful with the quotation marks in config files like the last one! if you copy and paste, be sure the text you copy from is preformatted or you might not be able to start openerp-web INIT script (/etc/init.d/openerp-web start). The previous three lines have been preformatted. Type the quotation marks if you encounter problems or you want to be sure.

Restart openerp-web:

$ sudo /etc/init.d/openerp-web restart

Check out again your server’s URL

Administrator: admin / openerp

Demo user: demo / demo

Restart the server with “sudo init 6” and make sure that all the openerp processes are started automatically as non-root.


References & Demo Server

OpenERP Video guides can be found at

Demonstrations (Login: demo / Password: demo):

Open Object is an open source Rapid Application Development framework in Python:

Another demo server can be found at , with the following users and passwords:


Open ERP Spain:

Open ERP Site (Spanish)

Open ERP modules for Spain (a must read):

How to download modules and latest versions from Launchpad (in Spanish)

Install extra modules:

Global Module Index:

Another real budget (in Spanish, a must read):

Useful advices (in Spanish, a must read):

Original article written by the author can be found at


A Shell script written by the author eases and automates the installation of openerp-server 5.0 with openerp-web 5.0.1 for Ubuntu 9.0.4:


1. start-openerp-web fails with the following error:

$ sudo -u openerp start-openerp-web


$ start-openerp-web
Traceback (most recent call last):
File “/usr/bin/start-openerp-web”, line 8, in <module>
load_entry_point(‘openerp-web==5.0.1-0’, ‘console_scripts’, ‘start-openerp-web’)()
File “/usr/lib/python2.5/site-packages/openerp_web-5.0.1_0-py2.5.egg/openerp/”, line 58, in start
turbogears.update_config(configfile=configfile, modulename=”openerp.config”)
File “/usr/lib/python2.5/site-packages/TurboGears-1.0.8-py2.5.egg/turbogears/”, line 207, in update_config
configdict = config_obj(configfile, modulename).dict()
File “/usr/lib/python2.5/site-packages/TurboGears-1.0.8-py2.5.egg/turbogears/”, line 193, in config_obj
configdata2 = ConfigObj(configfile, unrepr=True)
File “build/bdist.linux-x86_64/egg/”, line 1219, in __init__
File “build/bdist.linux-x86_64/egg/”, line 1302, in _load
configobj.UnreprError: Parse error in value at line 27.

Workaround: This could happen once openerp-web has already been run for first time through the INIT script. As this means that the INIT script works, just launch openerp-web with “sudo /etc/init.d/openerp-web start”

2. start-openerp-web fails with the error: Can’t extract file(s) to egg cache

$ start-openerp-web

File “/usr/lib/python2.5/site-packages/”, line 887, in extraction_error                                                                                 raise err
pkg_resources.ExtractionError: Can’t extract file(s) to egg cache
The following error occurred while trying to extract file(s) to the Python egg cache:
[Errno 13] Permission denied: ‘/home/user/.python-eggs’
The Python egg cache directory is currently set to:
Perhaps your account does not have write access to this directory? You can change the cache directory by setting the PYTHON_EGG_CACHE environment variable to point to an accessible directory.


$ sudo -u openerp PYTHON_EGG_CACHE=/home/openerp/.python-eggs/ start-openerp-web