1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
|
===============================================================================
OpenERP Web - the Web Client of OpenERP, the Enterprise Management Software
===============================================================================
1. Introduction
2. Linux Installation
3. Run as service (Linux)
4. Windows Installation
5. Configure over HTTPS
6. Web browser compatibilities
7. Support
-------------------------------------------------------------------------------
1. INTRODUCTION
-------------------------------------------------------------------------------
OpenERP Web is the official web client of OpenERP developed by Tiny and Axelor.
Features:
- High Performance
- Light weight
- Easy deployment
- Clean & Ergonomic
- Ajax enabled
OpenERP Web is known to work with all major web browsers available today,
including Firefox, IE6, IE7, Safari3 and Opera9.
-------------------------------------------------------------------------------
2. LINUX INSTALLATION
-------------------------------------------------------------------------------
Here is the installation instructions for Debian based Linux distributions.
Tested on Debian Etch and Ubuntu Hardy. The procedure might work with other
Linux or similar distributions. See the docs on how to install the specified
Packages on your favourite distro.
Prerequisites:
1. Python >= 2.4
2. CherryPy >= 3.1.2
3. Mako >= 0.2.4
4. Babel >= 0.9.4
5. FormEncode >= 1.2.2
6. simplejson >= 2.0.9
8. pyparsing >= 1.5.0
Remember, this version requires CherryPy3 which is conflicting with
CherryPy2 (used by TurboGears), so you can't install both in system area.
To overcome with the issue, we added support for local library installation
for OpenERP Web. In that case, just download the source package and do the
following...
$ cd /path/to/openerp-web/lib
$ ./populate.sh
$ cd ..
This will install all required dependencies in private lib directory, and you
don't need to install anything...
The rest will describe how to install the client in system area...
Python:
$ sudo apt-get install python python-dev build-essential
$ sudo apt-get install python-setuptools
OpenERP Web:
$ sudo easy_install -U openerp-web
all other dependencies will be installed automatically by setuptools...
Configuration:
Locate the `config/openerp-web.cfg` in the installed `EGG`, and make
appropriate changes, especially:
[openerp]
server = "localhost"
port = 8070
protocol = "socket"
where:
server is the OpenERP server host...
port is the OpenERP server port...
protocol is the protocol to be used (socket, http or https)
Now start the web server with `openerp-web` command:
$ openerp-web
If you see message showing `IOError: Port 8080 not free on '0.0.0.0'` make
sure no other application is running on the specified port (8080 is default).
You can change port by changing `server.socket_port` value in
`config/openerp-web.cfg`.
If everything is fine, open your favourite web browser and type
http://localhost:8080/, and your can see welcome page with login screen.
Please make sure cookies are enabled in your browser.
Of course, OpenERP Server must be running at that time. You should create a
database from the DBAdmin interface by clicking on Database button that you can
see on the login screen. After creating a new database login with the
admin/admin or demo/demo to see OpenERP in action...
-------------------------------------------------------------------------------
3. Run as service (Linux):
-------------------------------------------------------------------------------
This has been tested on `ubuntu` only.
$ sudo cp /path/to/openerp_web-5.0.2-py2.5.egg/scripts/openerp-web /etc/init.d/
$ sudo cp /path/to/openerp_web-5.0.2-py2.5.egg/config/openerp-web.cfg /etc/
edit `/etc/init.d/openerp-web`:
USER="openerp"
and `/etc/openerp-web.cfg`:
log.access_file = "/var/log/openerp-web/access.log"
log.error_file = "/var/log/openerp-web/error.log"
Now run following command to start the OpenERP Web automatically on system startup.
$ sudo mkdir /var/log/openerp-web
$ sudo chown -R openerp /var/log/openerp-web
$ sudo update-rc.d openerp-web
Start the deamon:
$ sudo /etc/init.d/openerp-web start
-------------------------------------------------------------------------------
4. WINDOWS INSTALLATION
-------------------------------------------------------------------------------
Prerequisites
1. Python >= 2.4
2. CherryPy >= 3.1.2
3. Mako >= 0.2.4
4. Babel >= 0.9.4
5. FormEncode >= 1.2.2
6. simplejson >= 2.0.9
8. pyparsing >= 1.5.0
Python:
Download and Install Python 2.5 and make sure that the dirs
`C:\Python25;C:\Python25\Script` are in PATH environment.
Setuptools:
Install setuptools package from http://cheeseshop.python.org/packages/2.5/s/setuptools/setuptools-0.6c9.win32-py2.5.exe
> easy_install "TurboGears==1.0.8"
OpenERP Web:
> easy_install -U openerp-web
Configuration:
Please see Linux installation doc for configuration/startup...
-------------------------------------------------------------------------------
5. Configure HTTPS (Linux)
-------------------------------------------------------------------------------
The following text describes how to configure OpenERP Web for production
environment over HTTPS with Apache2.
mod_proxy + mod_headers + mod_ssl (Apache2)
See Apache manual for more information.
Apache configuration:
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/apache.pem
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
ProxyRequests Off
ProxyPass / http://127.0.0.1:8080
ProxyPassReverse / http://127.0.0.1:8080
RequestHeader set "X-Forwarded-Proto" "https"
# Fix IE problem (http error 408/409)
SetEnv proxy-nokeepalive 1
</VirtualHost>
OpenERP Web configuration:
tools.proxy.on = True
Block the OpenERP Web server port (firewall):
On Linux do this:
$ iptables -A INPUT -i lo -j ACCEPT
$ iptables -A INPUT -p tcp --dport 8080 -j REJECT
IMP: Don't block the localhost/127.0.0.1 (the first rule)
Notes:
This method only works if you want your OpenERP Web application at the
root of your server (https://www.example.com). OpenERP Web currently can't
be deployed under a subdirectory, e.g. http://www.example.com/openerp.
To overcome with the issue you can go with `subdomain`, like:
https://openerp.example.com
See: http://openerp.org/wiki/index.php/InstallationManual/WebClientHTTPS
-------------------------------------------------------------------------------
6. WEB BROWSER COMPATIBILITIES
-------------------------------------------------------------------------------
`OpenERP Web` is known to work best with `Mozilla` based web browsers.
Here is the list of supported browsers.
1. Firefox >= 1.5
2. Internet Explorer >= 6.0
3. Google Chrome >= 1.0
4. Safari >= 3.0
5. Opera >= 9.0
-------------------------------------------------------------------------------
7. SUPPORT
-------------------------------------------------------------------------------
1. http://openerp.com
2. http://axelor.com
-------------------------------------------------------------------------------
Copyright (C) 2007-TODAY Tiny ERP Pvt. Ltd. All Rights Reserved.
|