3
single: Installation; Open ERP Web (Linux)
4
single: Open ERP Web; Installation (Linux)
7
.. _installation-linux-web-link:
9
===============================================================================
10
OpenERP Web Installation
11
===============================================================================
13
Here is the installation instructions for Debian based Linux distributions.
14
Tested on Debian Etch and Ubuntu Hardy. The procedure might work with other
15
Linux or similar distributions. See the docs on how to install the specified
16
Packages on your favourite distribution.
18
-------------------------------------------------------------------------------
20
-------------------------------------------------------------------------------
23
#. TurboGears >= 1.0.7, < 1.1b1
25
-------------------------------------------------------------------------------
27
-------------------------------------------------------------------------------
31
$ sudo apt-get install python-setuptools
32
$ sudo easy_install TurboGears==1.0.8
38
$ wget http://peak.telecommunity.com/dist/ez_setup.py
39
$ sudo python ez_setup.py
40
$ sudo easy_install TurboGears==1.0.8
42
Check whether TurboGears is properly installed or not...
48
You should see version information of TurboGears and related packages.
50
-------------------------------------------------------------------------------
52
-------------------------------------------------------------------------------
56
$ sudo easy_install -U openerp-web
58
-------------------------------------------------------------------------------
60
-------------------------------------------------------------------------------
62
Locate the *config/default.cfg* in the installed *EGG*, and make appropriate
74
| ``server`` is the OpenERP server host...
75
| ``port`` is the OpenERP server port...
76
| ``protocol`` is the protocol to be used (socket, http or https)
78
Now start the web server with ``start-openerp-web`` command:
84
If you see message showing ``cherrypy._cperror.NotReady: Port not free.`` then
85
make sure no other application is running on the specified port (8080 is default).
87
You can change port for by changing ``server.socket_port`` value in *config/default.cfg*.
89
If everything is fine, open your favourite web browser and type http://localhost:8080,
90
and your can see welcome page with login screen.
92
Please make sure cookies are enabled in your browser.
94
Of course, OpenERP Server must be running at that time. You should create a
95
database from the DBAdmin interface by clicking on Manage button that you can
96
see besides the Database selection box. After creating a new database login
97
with the admin/admin or demo/demo to see OpenERP in action...
101
Please make sure that the system time is properly set otherwise web browsers
102
might fail to establish sessions. We strongly recommend you to synchronize
103
system clock with NTP...
105
-------------------------------------------------------------------------------
106
Run as service (daemon)
107
-------------------------------------------------------------------------------
109
This has been tested on *ubuntu* only.
113
$ sudo cp /path/to/openerp_web-5.0-py2.5.egg/scripts/openerp-web /etc/init.d
114
$ sudo cp /path/to/openerp_web-5.0-py2.5.egg/config/default.cfg /etc/openerp-web.cfg
115
$ sudo chmod +x /etc/init.d/openerp-web
117
edit */etc/init.d/openerp-web*:
123
and */etc/openerp-web.cfg*:
127
args="('server.log',)" ==> args="('/var/log/openerp-web.log',)"
129
Create ``/var/log/openerp-web.log`` with proper ownership
133
$ sudo touch /var/log/openerp-web.log
134
$ sudo chown terp /var/log/openerp-web.log
136
Now run following command to start the OpenERP Web automatically on system
137
startup (Debian/Ubuntu).
141
$ sudo update-rc.d openerp-web defaults
147
$ sudo /etc/init.d/openerp-web start
151
The init script is compatible with all major Linux distributions. Please
152
check docs of your distribution on how to enable services.
154
-------------------------------------------------------------------------------
156
-------------------------------------------------------------------------------
158
The following text describes how to configure OpenERP Web for production
159
environment over HTTPS with Apache2.
161
**mod_proxy + mod_ssl (Apache2)**
163
See `Apache manual <http://httpd.apache.org/docs/>`_ for more information.
165
**Apache configuration**
167
.. code-block:: apache
172
SSLCertificateFile /etc/apache2/ssl/apache.pem
181
ProxyPass / http://127.0.0.1:8080/
182
ProxyPassReverse / http://127.0.0.1:8080/
186
**OpenERP Web configuration**
190
base_url_filter.on = True
191
base_url_filter.use_x_forwarded_host = False
192
base_url_filter.base_url = "https://www.example.com"
194
**Block the OpenERP Web server port (firewall)**
198
$ iptables -A INPUT -i lo -j ACCEPT
199
$ iptables -A INPUT -p tcp --dport 8080 -j REJECT
203
Don't block the localhost/121.0.0.1 (the first rule)
207
This method only works if you want your OpenERP Web application at the
208
root of your server (https://www.example.com) and can't be deployed under
209
a subdirectory, e.g. http://www.example.com/openerp.
211
To overcome with the issue you can go with `subdomain`, like:
213
https://openerp.example.com
215
-------------------------------------------------------------------------------
216
Web Browser Compatibilities
217
-------------------------------------------------------------------------------
222
*OpenERP Web* is known to work best with *Mozilla* based web browsers. Here is
223
the list of supported browsers.
226
#. Internet Explorer >= 6.0
228
#. Google Chrome >= 1.0
234
Your browser should have the Flash plugin installed because *OpenERP Web* uses
235
some Flash components.
237
Here is how to install the Flash plugin on an Ubuntu system:
241
$ sudo apt-get install flashplugin-nonfree
243
-------------------------------------------------------------------------------
245
-------------------------------------------------------------------------------
247
#. http://openerp.com