← Back to branch summary

~openerp-community/openobject-doc/6.1

« back to all changes in this revision

Viewing changes to source/install/windows/server/index.rst

  • Committer: TruongSinh Tran
  • Date: 2009-07-19 19:02:35 UTC
  • Revision ID: truongsinh@vipescoserver-20090719190235-fu3bxcrbpvwuk5h7
https://launchpad.net/bugs/401313
[FIX] build_i18n.py .. raw:: html

Show diffs side-by-side

added added

removed removed

Lines of Context:
source/install/windows/server/index.rst
 
1
 
 
2
.. index::
 
3
   single: Installation; Open ERP Server (Windows)
 
4
   single: Open ERP Server; Installation (Windows)
 
5
.. 
 
6
 
 
7
.. _installation-windows-server-link:
 
8
 
 
9
Open ERP Server Installation
 
10
============================
 
11
 
 
12
System Requirements
 
13
-------------------
 
14
 
 
15
The server installation works on:
 
16
 
 
17
 * Windows 2000
 
18
 * Windows XP
 
19
 * Windows Vista
 
20
 * Windows Server 2000
 
21
 * Windows Server 2003
 
22
 * Windows Server 2008
 
23
 
 
24
with disks formatted in NTFS (not a FAT or FAT32 partition).
 
25
 
 
26
.. note::
 
27
 
 
28
   Open ERP Server doesn't work on Windows 98 or ME;
 
29
   for obvious reasons -- these can't be formatted using NTFS.
 
30
 
 
31
You will also need a PostgreSQL server up and running. If it's not the case,
 
32
you can read the :ref:`windows_postgresql-server-installation` Section.
 
33
 
 
34
Downloading the Open ERP Server
 
35
-------------------------------
 
36
 
 
37
The server can be downloaded from
 
38
the `Open ERP website's download page <http://www.openerp.com/index.php?option=com_content&view=article&id=18&Itemid=28>`_
 
39
 
 
40
Choose **Standalone Server** if you want to install Open ERP Server standalone
 
41
and plan to install the Open ERP Client and the PostgreSQL Server separately.
 
42
 
 
43
Choose **All in One** if you want to install PostgreSQL Server, Open ERP Server
 
44
and OpenERP Client in one shot.
 
45
 
 
46
Installing the Open ERP Server
 
47
------------------------------
 
48
 
 
49
Click on the installer you've just downloaded.
 
50
 
 
51
The ERP server installs also as a Windows service. This means you don't have to start the
 
52
server each time you start the computer and it runs without the need of an open user
 
53
session.
 
54
 
 
55
At the end of the installation, the setup wizard proposes to open, Open ERP Prompt, from
 
56
where you can prepare your server, as described below.
 
57
 
 
58
.. image:: ../../img/Terp_server_finish_install.png
 
59
 
 
60
Preparing the server for the first time run
 
61
+++++++++++++++++++++++++++++++++++++++++++
 
62
 
 
63
The Windows service for Open ERP Server is installed during the installation and it's set up
 
64
to start the server automatically on system boot.
 
65
 
 
66
The configuration file is now automatically saved in the installation directory, in: ::
 
67
 
 
68
 C:\Program Files\OpenERP Server\openerp-server.conf
 
69
 
 
70
Open ERP Prompt
 
71
+++++++++++++++
 
72
 
 
73
At the end of installation, the setup wizard proposes to open an Open ERP Prompt.
 
74
 
 
75
To start the server manually, start the Windows Command prompt and navigate to the
 
76
installation directory in "C:\Program Files\OpenERP Server\":
 
77
 
 
78
You need to initialize the server and save its configuration for the service to be able
 
79
to start automatically.
 
80
 
 
81
You also need to specify a logfile to be able to read the output the server writes
 
82
during its execution.
 
83
 
 
84
When in the Server directory, type this command but don't execute it yet: ::
 
85
 
 
86
   openerp-server.exe -d <db_name> -r <db_user> -w <db_password> --db_host=localhost
 
87
   --db_port=5432 --logfile="<logfile>" -s --stop-after-init
 
88
 
 
89
The initialization of Open ERP Server provides the necessary informations for the connection
 
90
to the database PostgreSQL and indication of the choice of data to load. Here is the
 
91
explanation of used options:
 
92
 
 
93
 * -d <db_name> : Name of the database created for Open ERP Server.
 
94
 * -r <db_user> : Name of the [=PostgreSQL=] administrator.
 
95
 * -w <db_password> : Administrator's password.
 
96
 * --db_host=<postgresql_server_address> : Address of the server where [=PostgreSQL=]is, if
 
97
   you have installed [=PostgreSQL=] on the same computer as Open ERP Server, you can enter
 
98
   localhost, or the IP address or the name of the distant server.
 
99
 * --db_port=<port_no> : Port number where listens [=PostgreSQL=]. Default is 5432.
 
100
 * -s : This option allows you to save the options in configuration file of Open ERP Server.
 
101
 * --stop-after-init: This option stops the ERP server after initialization.
 
102
 * --logfile="<logfile>": specify a logfile where all the output of ERP Server will be
 
103
   saved.
 
104
 
 
105
Before execution of this command you have to decide what usage you want the Open ERP for:
 
106
see the next section! The command is on only one line, the other long commands as well.
 
107
 
 
108
Sample command: ::
 
109
 
 
110
 openerp-server.exe -d terp -r postgresadmin -w postgresadminpasswd
 
111
 --db_host=localhost --logfile="C:\Program Files\OpenERP Server\openerp-server.log"
 
112
 --db_port=5432 -s  --stop-after-init
 
113
 
 
114
Here you have to enter the username and password initialized in the Initialise database
 
115
cluster screen.
 
116
 
 
117
When you will execute the initialization command, if you specified a logfile, you will not
 
118
see any server output in the prompt window.
 
119
 
 
120
Everything is written to the logfile. You have only to wait until the prompt comes back.
 
121
 
 
122
Deciding what is the purpose of the server
 
123
++++++++++++++++++++++++++++++++++++++++++
 
124
 
 
125
You have three possibilities for the first launch. This section is really important because
 
126
the correct initialization can be crucial.
 
127
 
 
128
You can initialize the database with Open ERP Server to:
 
129
 
 
130
  #. You want to take a look on the system with demo data loaded
 
131
  #. You are installing a new clean installation (without demo data)
 
132
  #. You are upgrading an existing version.
 
133
 
 
134
First time run with demo data
 
135
+++++++++++++++++++++++++++++
 
136
 
 
137
To initialize Open ERP Server with the demo data, you need to add this option to the above
 
138
command: ::
 
139
 
 
140
 --init=all
 
141
 
 
142
Sample command: ::
 
143
 
 
144
 openerp-server.exe -d terp -r postgresadmin -w postgresadminpasswd
 
145
 --db_host=localhost --logfile="C:\Program Files\OpenERP Server\openerp-server.log"
 
146
 --db_port=5432 -s  --stop-after-init --init=all
 
147
 
 
148
This command will initialize the Open ERP Server and fill its PostgreSQL database with the
 
149
demo data.
 
150
 
 
151
First time run without demo data (or new clean version)
 
152
+++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
153
 
 
154
Execute the command with an option excluding the demo data: ::
 
155
 
 
156
 --without-demo=all
 
157
 
 
158
This will load all modules, but will not load the demo data.
 
159
 
 
160
Sample command usage: ::
 
161
 
 
162
 openerp-server.exe -d terp -r postgresadmin -w postgresadminpasswd
 
163
 --db_host=localhost --logfile="C:\Program Files\OpenERP Server\openerp-server.log"
 
164
 --db_port=5432 -s  --stop-after-init --without-demo=all
 
165
 
 
166
Recreate a new database:If you have more than one database , you may force the server to
 
167
initialize by using the "-i all" or "--init=all" command line option.
 
168
 
 
169
If you already initialized the database and you have the demo data loaded, you can recreate
 
170
a new database
 
171
 
 
172
First time run with an upgraded version of Open ERP Server
 
173
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
174
 
 
175
Execute the command with an option that updates the data structures: ::
 
176
 
 
177
 --update=all
 
178
 
 
179
Sample command usage: ::
 
180
 
 
181
 openerp-server.exe -d terp -r postgresadmin -w postgresadminpasswd
 
182
 --db_host=localhost --logfile="C:\Program Files\OpenERP Server\openerp-server.log"
 
183
 --db_port=5432 -s  --stop-after-init --update=all
 
184
 
 
185
Starting the server
 
186
-------------------
 
187
 
 
188
Now as the server is initialized and the settings are saved, you can finally start the Open
 
189
ERP Server service.
 
190
 
 
191
In the menus there is an icon that directly executes the Open ERP server, but it is only for
 
192
debugging or testing purposes.
 
193
 
 
194
From the command prompt
 
195
+++++++++++++++++++++++
 
196
 
 
197
You can now start the Open ERP Server service from the command prompt with a simple command: ::
 
198
 
 
199
  net start openerp-service
 
200
 
 
201
.. image:: ../../img/Terp_service_start.png
 
202
 
 
203
You can also stop it in a similar way, in case the service is running but you need to
 
204
reconfigure it: ::
 
205
 
 
206
 net stop openerp-service
 
207
 
 
208
.. image:: ../../img/Terp_service_stop.png
 
209
 
 
210
From the main program menu
 
211
++++++++++++++++++++++++++
 
212
 
 
213
You can also control the service from the Program menu:
 
214
 
 
215
.. image:: ../../img/Terps_menu_server_controls.png
 
216
 
 
217
From the service manager
 
218
++++++++++++++++++++++++
 
219
 
 
220
The service and some runtime information is also accessible in the Computer management in
 
221
Administration tools.
 
222
 
 
223
.. image:: ../../img/Terp_service_mmc_terp_service.png
 
224
 
 
225
.. 
 
226
 
 
227
.. image:: ../../img/Terp_service_mmc_logs.png
 
228
 
 
229
The logging service offers additional information about the execution of the Open ERP Server
 
230
service.
 
231
 
 
232
In the service manager you can define how the service should act in case of server failure.
 
233
 
 
234
.. image:: ../../img/Terp_service_mmc_control_actions.png
 
235
 
 
236
Monitoring Open ERP Server
 
237
--------------------------
 
238
 
 
239
You can find startup or shutdown information in the Computer Management logging service.
 
240
 
 
241
Open ERP Server runtime output can be found in the logfile you specified on the
 
242
initialization command line.
 
243
 
 
244
Given that the server is now running as a Windows service, it doesn't output any runtime
 
245
messages, for this the logfile is the only option.
 
246
 
 
247
You can find out whether Open ERP Server is running by opening the Windows Task Manager and
 
248
when you look at the Processes tab, you will see OpenERPServerService.exe and openerp-
 
249
server.exe and that these two processes are running as SYSTEM user.
 
250
 
 
251
.. image:: ../../img/Terp_service_running.png
 
252
 
 
253
Configuring Open ERP Server
 
254
---------------------------
 
255
 
 
256
Open ERP Server menu contains a direct link to the configuration file used by the service.
 
257
This way you can edit the configuration and then restart the service to load the new
 
258
configurations.
 
259
 
 
260
.. image:: ../../img/Terps_menu_editconf.png
 
261
 
 
262
.. image:: ../../img/Terp_server_conf.png
 
263
 
 
264
Be extremely cautious when editing the server configuration directly, you can crash the
 
265
entire system with inappropriate values.
 
266
 
 
267
Congratulations, you have successfully installed the Open ERP Server
 
268
--------------------------------------------------------------------
 
269
 
 
270
For more information, please take a look at
 
271
the :ref:`Additional Installation Information and
 
272
Troubleshooting <troubleshooting-and-windows-complementary-install-information>` page 
 
273
where you can find some troubleshooting examples.
 
274