Project Installation

Version 263 (Etienne Pallier, 03/10/2017 10:13 am)

1 1 Etienne Pallier
h1. Project Installation
2 1 Etienne Pallier
3 6 Etienne Pallier
4 189 Etienne Pallier
This page describes the installation phase of the Pyros software
5 189 Etienne Pallier
6 189 Etienne Pallier
7 11 Etienne Pallier
Project Development page : [[Project Development]]
8 11 Etienne Pallier
9 6 Etienne Pallier
HOWTO Format Redmine Wiki : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting
10 6 Etienne Pallier
11 193 Etienne Pallier
{{toc}}
12 6 Etienne Pallier
13 6 Etienne Pallier
14 3 Etienne Pallier
---
15 3 Etienne Pallier
16 170 Etienne Pallier
---
17 170 Etienne Pallier
18 221 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}DATABASE SCHEMA (v0.2.2)%
19 4 Etienne Pallier
20 4 Etienne Pallier
21 222 Etienne Pallier
{{thumbnail(PYROS_DBM_V0_2_2.png, size=2000, title=Pyros data model)}}
22 4 Etienne Pallier
23 4 Etienne Pallier
24 4 Etienne Pallier
---
25 5 Etienne Pallier
26 170 Etienne Pallier
---
27 170 Etienne Pallier
28 226 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}COMPATIBLE PLATFORMS (TESTED)%
29 226 Etienne Pallier
30 253 Jeremy Barneron
This software is targetted first for Linux CentOS 7 (+ Fedora and Ubuntu), but also for Mac OS X and Windows.
31 231 Etienne Pallier
All these systems should run Python 3 (3.5+)
32 226 Etienne Pallier
33 227 Etienne Pallier
Pyros has been tested on these platforms:
34 226 Etienne Pallier
35 232 Etienne Pallier
* CentOS 7.1 (with Python 3.4)
36 235 Paul Carensac
* Linux Mint 17.2 ( == Ubuntu 14.04.3) (with Python 3.5)
37 254 Jeremy Barneron
* Ubuntu 16.04 (with python 3.5.2)
38 232 Etienne Pallier
* Mac OS 10.11.6 (with Python 3.5)
39 232 Etienne Pallier
* Windows 10 (with Python 3.5)
40 226 Etienne Pallier
41 177 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}I - PREREQUISITES%
42 177 Etienne Pallier
43 181 Paul Carensac
Pyros needs some prerequisites : 
44 177 Etienne Pallier
45 229 Etienne Pallier
* Python 3.5+
46 181 Paul Carensac
* RabbitMQ
47 220 Etienne Pallier
* [optional] a Mysql Database server (but you can use Sqlite instead, with no installation)
48 177 Etienne Pallier
49 177 Etienne Pallier
50 177 Etienne Pallier
---
51 177 Etienne Pallier
52 255 Jeremy Barneron
h3. Install Python3 (3.5+) + pip + virtualenv
53 177 Etienne Pallier
54 177 Etienne Pallier
_If Python 3 is already installed on your computer, skip this section_
55 177 Etienne Pallier
56 177 Etienne Pallier
57 177 Etienne Pallier
 * Linux (CentOS 7.1, main target): (python35 not yet available as rpm)
58 177 Etienne Pallier
<pre>
59 177 Etienne Pallier
$ sudo yum update yum
60 177 Etienne Pallier
$ sudo yum update kernel
61 177 Etienne Pallier
$ sudo yum update
62 1 Etienne Pallier
63 1 Etienne Pallier
$ sudo yum install python34
64 1 Etienne Pallier
$ python3.4 -V
65 1 Etienne Pallier
Python 3.4.3
66 1 Etienne Pallier
67 1 Etienne Pallier
$ sudo yum install python34-devel
68 1 Etienne Pallier
(needed for python package mysqlclient)
69 1 Etienne Pallier
70 1 Etienne Pallier
$ sudo yum update python-setuptools
71 1 Etienne Pallier
$ easy_install --version
72 1 Etienne Pallier
setuptools 0.9.8
73 1 Etienne Pallier
$ sudo easy_install pip
74 1 Etienne Pallier
$ pip --version
75 1 Etienne Pallier
pip 8.1.1 from /usr/lib/python2.7/site-packages/pip-8.1.1-py2.7.egg (python 2.7)
76 1 Etienne Pallier
77 1 Etienne Pallier
$ sudo pip install virtualenv
78 1 Etienne Pallier
$ virtualenv --version
79 1 Etienne Pallier
15.0.1
80 1 Etienne Pallier
81 1 Etienne Pallier
Necessary for "lxml" python package:
82 1 Etienne Pallier
$ sudo yum install libxml2 libxml2-devel
83 1 Etienne Pallier
$ sudo yum install libxslt libxslt-devel
84 1 Etienne Pallier
85 1 Etienne Pallier
</pre>
86 1 Etienne Pallier
87 1 Etienne Pallier
88 1 Etienne Pallier
 * Linux (Ubuntu) :
89 1 Etienne Pallier
<pre>
90 1 Etienne Pallier
$ sudo add-apt-repository ppa:fkrull/deadsnakes
91 1 Etienne Pallier
$ sudo apt-get update
92 1 Etienne Pallier
$ sudo apt-get install python3.5
93 237 Jeremy Barneron
$ sudo apt-get install libxml2-dev
94 237 Jeremy Barneron
$ sudo apt-get install libxslt-dev
95 249 Jeremy Barneron
$ sudo apt-get install python-pip
96 1 Etienne Pallier
97 1 Etienne Pallier
$ sudo apt-get install python3.5-dev
98 1 Etienne Pallier
(needed for python package mysqlclient)
99 1 Etienne Pallier
100 1 Etienne Pallier
$ sudo pip install virtualenv
101 1 Etienne Pallier
</pre>
102 1 Etienne Pallier
103 1 Etienne Pallier
104 1 Etienne Pallier
 * Mac OS X :
105 1 Etienne Pallier
106 1 Etienne Pallier
  * From binary (Mac OS native application)
107 1 Etienne Pallier
(TODO:)
108 1 Etienne Pallier
109 1 Etienne Pallier
  * From MacPort
110 1 Etienne Pallier
111 1 Etienne Pallier
   * a) install macport
112 208 Etienne Pallier
cf https://www.macports.org/install.php
113 1 Etienne Pallier
114 260 Etienne Pallier
   * b) install the "port" python36
115 1 Etienne Pallier
<pre>
116 260 Etienne Pallier
$ sudo port install python36
117 260 Etienne Pallier
$ sudo port select --set python3 python36
118 260 Etienne Pallier
$ sudo port install py36-readline
119 260 Etienne Pallier
$ sudo port install py36-pip
120 260 Etienne Pallier
$ port select --set pip pip36
121 1 Etienne Pallier
</pre>
122 1 Etienne Pallier
123 1 Etienne Pallier
124 202 Paul Carensac
 * Windows (tested with Windows 7 & 10) :
125 1 Etienne Pallier
<pre>
126 1 Etienne Pallier
Go to https://www.python.org/downloads/windows/ , choose the wanted version
127 1 Etienne Pallier
On the wanted version’s page, download Windows x86 executable installer
128 1 Etienne Pallier
129 1 Etienne Pallier
Run the executable
130 1 Etienne Pallier
    * On the first page, check "Add python3.5 to PATH"
131 1 Etienne Pallier
    * Choose "Install now" option
132 1 Etienne Pallier
133 1 Etienne Pallier
Open cmd (windows + R, cmd) :
134 1 Etienne Pallier
 $ python -m pip install --upgrade pip
135 1 Etienne Pallier
 $ pip install virtualenv
136 1 Etienne Pallier
</pre>
137 200 Paul Carensac
138 200 Paul Carensac
---
139 200 Paul Carensac
140 200 Paul Carensac
h3. Install a database server (only if necessary)
141 200 Paul Carensac
142 200 Paul Carensac
_If the MySql database server is already installed on your computer, skip this section_
143 200 Paul Carensac
144 200 Paul Carensac
By default, Pyros uses Mysql, but this implies that you have to install the Mysql database server...
145 200 Paul Carensac
146 200 Paul Carensac
Thus, to make things easier, avoid Mysql installation by using Sqlite instead as the database server (which will need no installation at all) :
147 200 Paul Carensac
148 200 Paul Carensac
=> *For this, just edit the file PYROS/src/pyros/settings.py and set MYSQL variable to False, and that's it. You can go to next section*
149 200 Paul Carensac
150 200 Paul Carensac
Now, if you really want to use Mysql (which is the default), you will need to install it (only if not already installed), so keep reading.
151 200 Paul Carensac
152 200 Paul Carensac
_(Skip this if you are using Sqlite instead of MySql)_
153 200 Paul Carensac
154 200 Paul Carensac
 * Linux Ubuntu
155 200 Paul Carensac
<pre>
156 200 Paul Carensac
First, update your system:
157 200 Paul Carensac
$ sudo apt-get update
158 200 Paul Carensac
159 200 Paul Carensac
$ sudo apt-get install mysql-server
160 200 Paul Carensac
$ sudo apt-get install mysql-client
161 200 Paul Carensac
162 200 Paul Carensac
$ sudo apt-get install libmysqlclient-dev
163 200 Paul Carensac
(needed for python package mysqlclient)
164 200 Paul Carensac
</pre>
165 200 Paul Carensac
166 200 Paul Carensac
 * Linux CentOS : cf https://www.howtoforge.com/apache_php_mysql_on_centos_7_lamp#-installing-mysql-
167 200 Paul Carensac
<pre>
168 200 Paul Carensac
First, update your system:
169 200 Paul Carensac
$ sudo yum update yum
170 200 Paul Carensac
$ sudo yum update kernel
171 200 Paul Carensac
$ sudo yum update
172 200 Paul Carensac
173 200 Paul Carensac
$ sudo yum install mariadb-server 
174 200 Paul Carensac
$ sudo yum install mariadb
175 200 Paul Carensac
176 200 Paul Carensac
$ sudo yum install mariadb-devel
177 200 Paul Carensac
(needed for python package mysqlclient)
178 200 Paul Carensac
179 200 Paul Carensac
$ sudo systemctl start mariadb.service
180 200 Paul Carensac
181 200 Paul Carensac
$ sudo systemctl enable mariadb.service
182 200 Paul Carensac
=> Created symlink from /etc/systemd/system/multi-user.target.wants/mariadb.service to /usr/lib/systemd/system/mariadb.service.
183 200 Paul Carensac
184 200 Paul Carensac
$ sudo mysql_secure_installation
185 200 Paul Carensac
</pre>
186 200 Paul Carensac
187 200 Paul Carensac
 * Mac OS X
188 200 Paul Carensac
Install XAMPP
189 200 Paul Carensac
(but you could also use the pre-installed Mac OS MySql, or install MySql from macport)
190 209 Etienne Pallier
cf https://www.apachefriends.org/fr/index.html
191 209 Etienne Pallier
192 200 Paul Carensac
193 201 Paul Carensac
 * Windows (tested with Windows 7 & 10)
194 200 Paul Carensac
195 200 Paul Carensac
<pre>
196 200 Paul Carensac
Download and install the newest version on https://dev.mysql.com/downloads/installer/
197 200 Paul Carensac
198 200 Paul Carensac
Once installed, launch MySQL Installer. Clic on 'Add...' on the right.
199 200 Paul Carensac
In MySQLServers section, choose the newest, then clic on next.
200 200 Paul Carensac
Install and configure the server (just follow the installation guide).
201 200 Paul Carensac
202 200 Paul Carensac
Then launch mysql (via the Windows menu).
203 200 Paul Carensac
</pre>
204 200 Paul Carensac
205 177 Etienne Pallier
206 1 Etienne Pallier
---
207 181 Paul Carensac
208 181 Paul Carensac
h3. Install RabbitMQ
209 181 Paul Carensac
210 181 Paul Carensac
RabbitMQ is a message queue server used by Celery to handle tasks queues.
211 248 Etienne Pallier
It uses the amqp protocol to manage queue messages.
212 181 Paul Carensac
213 181 Paul Carensac
 * Ubuntu (the server is automatically started) :
214 181 Paul Carensac
<pre>
215 181 Paul Carensac
$ sudo apt-get install rabbitmq-server
216 245 Etienne Pallier
217 245 Etienne Pallier
Get status:
218 245 Etienne Pallier
$ sudo invoke-rc.d rabbitmq-server status
219 245 Etienne Pallier
220 245 Etienne Pallier
Stop:
221 245 Etienne Pallier
$ sudo invoke-rc.d rabbitmq-server stop
222 245 Etienne Pallier
223 245 Etienne Pallier
Start:
224 245 Etienne Pallier
$ sudo invoke-rc.d rabbitmq-server start
225 245 Etienne Pallier
226 181 Paul Carensac
</pre>
227 245 Etienne Pallier
228 245 Etienne Pallier
229 183 Paul Carensac
230 195 Etienne Pallier
 * CentOS :
231 195 Etienne Pallier
<pre>
232 195 Etienne Pallier
$ sudo yum install rabbitmq-server
233 196 Etienne Pallier
234 196 Etienne Pallier
Installation :
235 196 Etienne Pallier
 rabbitmq-server                                                           noarch                          3.3.5-17.el7
236 196 Etienne Pallier
Installation pour dépendances :
237 196 Etienne Pallier
 erlang-asn1                                                               x86_64                          R16B-03.16.el7
238 246 Etienne Pallier
239 246 Etienne Pallier
Get status:
240 247 Etienne Pallier
(CentOS7) $ sudo rabbitmqctl status
241 247 Etienne Pallier
(older CentOS) $ sudo /sbin/service rabbitmq-server status
242 1 Etienne Pallier
243 1 Etienne Pallier
Stop:
244 247 Etienne Pallier
(CentOS7) $ sudo systemctl stop rabbitmq-server
245 247 Etienne Pallier
(older CentOS) $ sudo /sbin/service rabbitmq-server stop
246 1 Etienne Pallier
247 246 Etienne Pallier
Start:
248 247 Etienne Pallier
(CentOS7) $ sudo systemctl start rabbitmq-server
249 247 Etienne Pallier
(older CentOS) $ sudo /sbin/service rabbitmq-server start
250 195 Etienne Pallier
</pre>
251 195 Etienne Pallier
252 183 Paul Carensac
 * MacOS :
253 183 Paul Carensac
<pre>
254 194 Etienne Pallier
With MacPort:
255 194 Etienne Pallier
$ sudo port install rabbitmq-server
256 194 Etienne Pallier
--->  Installing erlang @18.2.1_1+hipe+ssl
257 194 Etienne Pallier
...
258 1 Etienne Pallier
--->  Installing rabbitmq-server @3.5.7_0
259 1 Etienne Pallier
--->  Activating rabbitmq-server @3.5.7_0
260 1 Etienne Pallier
...
261 247 Etienne Pallier
262 1 Etienne Pallier
To start rabbitmq : 
263 1 Etienne Pallier
$ sudo rabbitmq-server
264 261 Etienne Pallier
265 261 Etienne Pallier
Get status:
266 261 Etienne Pallier
$ sudo rabbitmqctl status
267 244 Etienne Pallier
268 244 Etienne Pallier
To stop rabbitmq : 
269 244 Etienne Pallier
$ sudo rabbitmqctl stop
270 240 Etienne Pallier
</pre>
271 244 Etienne Pallier
272 240 Etienne Pallier
273 240 Etienne Pallier
274 183 Paul Carensac
 * Windows :
275 191 Paul Carensac
276 191 Paul Carensac
  * Take the wanted Erlang version at http://www.erlang.org/downloads and install it (required)
277 191 Paul Carensac
  * Take the wanted RabbitMQ version at https://www.rabbitmq.com/install-windows.html and install it. Then the server will run automatically
278 191 Paul Carensac
279 191 Paul Carensac
280 177 Etienne Pallier
281 177 Etienne Pallier
---
282 177 Etienne Pallier
283 179 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}II - GET THE PYROS SOFTWARE%
284 5 Etienne Pallier
285 125 Etienne Pallier
h3. Authenticate to https://gitlab.irap.omp.eu/epallier/pyros
286 125 Etienne Pallier
287 125 Etienne Pallier
In order to get this software, you must first authenticate on the IRAP gitlab.
288 125 Etienne Pallier
289 125 Etienne Pallier
For this, just go to https://gitlab.irap.omp.eu/epallier/pyros
290 125 Etienne Pallier
and either sign in with your LDAP account (if you are from IRAP),
291 125 Etienne Pallier
or register via the "Sign up" form.
292 5 Etienne Pallier
293 113 Etienne Pallier
h3. Software structure
294 5 Etienne Pallier
295 207 Paul Carensac
See [[Project_structure|Project Structure]] page.
296 1 Etienne Pallier
297 112 Etienne Pallier
h3. Browse the code (from gitlab)
298 111 Etienne Pallier
299 111 Etienne Pallier
https://gitlab.irap.omp.eu/epallier/pyros/tree/master
300 111 Etienne Pallier
301 203 Paul Carensac
h3. You can download it (static version, not synchronized)
302 111 Etienne Pallier
303 114 Etienne Pallier
You can download the current version of the software.
304 114 Etienne Pallier
305 115 Etienne Pallier
Go to https://gitlab.irap.omp.eu/epallier/pyros/tree/master
306 115 Etienne Pallier
307 115 Etienne Pallier
Click on "Download zip" on the up right hand corner.
308 115 Etienne Pallier
309 115 Etienne Pallier
Double-click on it to unzip it.
310 115 Etienne Pallier
311 115 Etienne Pallier
You should get a "pyros.git" folder.
312 115 Etienne Pallier
313 116 Etienne Pallier
In this documentation, this software folder will be referenced as "PYROS".
314 115 Etienne Pallier
315 118 Etienne Pallier
(you can rename "pyros.git" as "PYROS" if you want : "mv pyros.git PYROS")
316 114 Etienne Pallier
317 203 Paul Carensac
h3. (Windows developers only) : Get git for Windows
318 1 Etienne Pallier
319 203 Paul Carensac
 * Download git at https://git-scm.com/download/win
320 203 Paul Carensac
 * Run setup (keep default configurations)
321 203 Paul Carensac
 * Once installed, open cmd
322 203 Paul Carensac
<pre>
323 203 Paul Carensac
$ git config --global http.sslVerify false
324 203 Paul Carensac
</pre>
325 203 Paul Carensac
326 203 Paul Carensac
You can now use your git from the cmd or the graphic client !
327 203 Paul Carensac
328 203 Paul Carensac
h3. (Developers only) Get it from GIT (dynamic version, synchronized)
329 203 Paul Carensac
330 122 Etienne Pallier
(If you are using Windows, you must first get the git software, see below "Get git for Windows")
331 122 Etienne Pallier
332 114 Etienne Pallier
By getting the software from git, you will get a dynamically synchronized version,
333 114 Etienne Pallier
which means that you will be able to update your version as soon as a new version is available
334 114 Etienne Pallier
(with the command : "git pull").
335 111 Etienne Pallier
336 111 Etienne Pallier
* From Eclipse : See below, section "NOTES FOR ECLIPSE USERS"
337 111 Etienne Pallier
338 111 Etienne Pallier
* From the terminal
339 5 Etienne Pallier
340 5 Etienne Pallier
<pre>
341 5 Etienne Pallier
git clone https://gitlab.irap.omp.eu/epallier/pyros.git PYROS
342 1 Etienne Pallier
</pre>
343 86 Etienne Pallier
344 86 Etienne Pallier
_(or also : git clone git@gitlab.irap.omp.eu:epallier/pyros.git PYROS)_
345 5 Etienne Pallier
346 5 Etienne Pallier
If you ever get this error message :
347 1 Etienne Pallier
<pre>
348 1 Etienne Pallier
fatal: unable to access 'https://gitlab.irap.omp.eu/epallier/pyros.git/': Peer's certificate issuer has been marked as not trusted by the user.
349 122 Etienne Pallier
</pre>
350 122 Etienne Pallier
351 122 Etienne Pallier
Then, type this command (and then run again the git clone command):
352 121 Paul Carensac
<pre>
353 121 Paul Carensac
$ git config --global http.sslVerify false
354 121 Paul Carensac
</pre>
355 121 Paul Carensac
356 1 Etienne Pallier
(Also, the first time you get the project, it will ask you for a login and password)
357 121 Paul Carensac
358 168 Etienne Pallier
This creates a PYROS/ folder containing the project (with a .git/ subfolder for synchronization with the git repository)
359 168 Etienne Pallier
360 168 Etienne Pallier
361 169 Etienne Pallier
362 169 Etienne Pallier
363 169 Etienne Pallier
---
364 169 Etienne Pallier
365 169 Etienne Pallier
---
366 169 Etienne Pallier
367 186 Paul Carensac
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}III - INSTALLATION OF NEEDED PROJECT DEPENDENCIES%
368 166 Etienne Pallier
369 186 Paul Carensac
---
370 186 Paul Carensac
371 186 Paul Carensac
h3. Install Comet
372 186 Paul Carensac
373 214 Etienne Pallier
Comet is needed as a broker to receive and send VOEvents (https://github.com/jdswinbank/Comet/tree/py3)
374 213 Etienne Pallier
*You MUST have your virtualenv activated (source venv_py3_pyros/bin/activate in your 'private/' directory)*
375 1 Etienne Pallier
Documentation is available here : http://comet.readthedocs.io/en/stable/installation.html
376 213 Etienne Pallier
(see also http://voevent.readthedocs.io/en/latest/setup.html)
377 186 Paul Carensac
378 212 Etienne Pallier
* Ubuntu :
379 186 Paul Carensac
380 186 Paul Carensac
<pre>
381 186 Paul Carensac
# You can do this anywhere on your computer
382 1 Etienne Pallier
$ git clone https://github.com/jdswinbank/Comet.git
383 1 Etienne Pallier
$ cd Comet
384 1 Etienne Pallier
$ (sudo ?) python setup.py install
385 236 Jeremy Barneron
$ sudo apt-get install python-lxml
386 1 Etienne Pallier
387 1 Etienne Pallier
# Now you can test it, no failure are expected, please contact the dev team for help
388 213 Etienne Pallier
$ twistd comet --help
389 1 Etienne Pallier
$ trial comet
390 213 Etienne Pallier
All tests should pass
391 1 Etienne Pallier
</pre>
392 1 Etienne Pallier
393 212 Etienne Pallier
394 1 Etienne Pallier
* MacOS :
395 1 Etienne Pallier
<pre>
396 213 Etienne Pallier
Idem Ubuntu
397 1 Etienne Pallier
</pre>
398 1 Etienne Pallier
399 212 Etienne Pallier
* Windows :
400 1 Etienne Pallier
<pre>
401 212 Etienne Pallier
TODO:
402 212 Etienne Pallier
</pre>
403 212 Etienne Pallier
404 212 Etienne Pallier
405 212 Etienne Pallier
406 212 Etienne Pallier
407 212 Etienne Pallier
408 190 Paul Carensac
409 190 Paul Carensac
---
410 190 Paul Carensac
411 211 Etienne Pallier
h3. Install the other project dependencies and the database (within a Python virtual environment)
412 190 Paul Carensac
413 256 Jeremy Barneron
Go into the PYROS/install/ folder and Run the install.py script with the parameter install.
414 190 Paul Carensac
415 190 Paul Carensac
(You will be prompted to enter a username, an email, and a password for the superuser)
416 190 Paul Carensac
417 256 Jeremy Barneron
* Mac, Linux and Windows:
418 190 Paul Carensac
<pre>
419 256 Jeremy Barneron
python3 install.py install
420 190 Paul Carensac
</pre>
421 190 Paul Carensac
422 262 Etienne Pallier
*TODO: update "create user if exists" => does not work with mysql 5.6 (only with 5.7)*
423 262 Etienne Pallier
424 263 Etienne Pallier
NB: you might need to drop your pyros database (and pyros_test ?) before running the install script (if migrations are too big)
425 263 Etienne Pallier
426 190 Paul Carensac
_If something goes wrong, install manually each package (see section "MANUAL INSTALLATION OF PYTHON PACKAGES, ONE BY ONE")_
427 186 Paul Carensac
428 98 Etienne Pallier
429 9 Etienne Pallier
---
430 9 Etienne Pallier
431 9 Etienne Pallier
h3. (Eclipse only) Set the Python3 virtual environment as the project interpreter
432 9 Etienne Pallier
433 65 Etienne Pallier
See below, in section "NOTES FOR ECLIPSE USERS"
434 9 Etienne Pallier
435 1 Etienne Pallier
---
436 1 Etienne Pallier
437 170 Etienne Pallier
---
438 170 Etienne Pallier
439 17 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}IV - TEST%
440 17 Etienne Pallier
441 108 Etienne Pallier
442 90 Etienne Pallier
(Tests are classes declared in all apps' test.py file. The test classes inherit from django.test.TestCase)
443 17 Etienne Pallier
444 17 Etienne Pallier
You can run the tests suite, just to be sure that the software is well installed.
445 17 Etienne Pallier
446 19 Etienne Pallier
h3. From Terminal
447 19 Etienne Pallier
448 19 Etienne Pallier
449 1 Etienne Pallier
<pre>
450 1 Etienne Pallier
451 219 Paul Carensac
$ cd PYROS/
452 94 Etienne Pallier
453 243 Etienne Pallier
Be sure that at least unit tests pass:
454 257 Jeremy Barneron
$ python3 pyros.py unittest
455 243 Etienne Pallier
456 243 Etienne Pallier
If unit tests pass, then run ALL tests:
457 257 Jeremy Barneron
$ python3 pyros.py test_all
458 242 Etienne Pallier
459 242 Etienne Pallier
NB: if tests do not pass, be sure that Rabbitmq is launched:
460 242 Etienne Pallier
To start rabbitmq on MacOS : 
461 242 Etienne Pallier
$ sudo rabbitmq-server
462 242 Etienne Pallier
463 17 Etienne Pallier
</pre>
464 19 Etienne Pallier
465 160 Paul Carensac
h3. From Eclipse
466 1 Etienne Pallier
467 216 Etienne Pallier
Right-clic on the project / Django / Run Django tests
468 1 Etienne Pallier
469 216 Etienne Pallier
(for more information, see below, in section "NOTES FOR ECLIPSE USERS")
470 25 Paul Carensac
471 160 Paul Carensac
h3. Custom commands
472 27 Paul Carensac
473 25 Paul Carensac
$ [./manage.py] test app.tests                           # Run tests for the application 'app'
474 25 Paul Carensac
$ [./manage.py] test app.tests.ModelTests                # Run test methods declared in the class app.tests.ModelTests
475 25 Paul Carensac
$ [./manage.py] test app.tests.ModelTests.test_method    # Only run the method test_method declared in app.tests.ModelTests
476 33 Etienne Pallier
477 33 Etienne Pallier
478 1 Etienne Pallier
---
479 1 Etienne Pallier
480 170 Etienne Pallier
---
481 170 Etienne Pallier
482 92 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}V - RUN%
483 75 Etienne Pallier
484 109 Etienne Pallier
485 223 Etienne Pallier
Before launching Pyros, check that all the pre-requisites are running :
486 223 Etienne Pallier
487 223 Etienne Pallier
 * RabbitMQ: 
488 223 Etienne Pallier
<pre>
489 223 Etienne Pallier
$ systemctl status rabbitmq-server
490 223 Etienne Pallier
491 223 Etienne Pallier
If inactive, start it:
492 223 Etienne Pallier
$ sudo systemctl start rabbitmq-server
493 223 Etienne Pallier
494 224 Etienne Pallier
(To stop it, use "stop" instead of "start")
495 223 Etienne Pallier
496 223 Etienne Pallier
</pre>
497 223 Etienne Pallier
498 223 Etienne Pallier
 * Mysql (only if you are not using Sqlite):
499 225 Etienne Pallier
<pre>
500 225 Etienne Pallier
$ systemctl status mysqld
501 225 Etienne Pallier
502 225 Etienne Pallier
If inactive, start it:
503 225 Etienne Pallier
$ sudo systemctl start mysqld
504 225 Etienne Pallier
505 225 Etienne Pallier
(To stop it, use "stop" instead of "start")
506 225 Etienne Pallier
</pre>
507 223 Etienne Pallier
508 75 Etienne Pallier
* From the terminal
509 75 Etienne Pallier
510 75 Etienne Pallier
<pre>
511 75 Etienne Pallier
512 95 Etienne Pallier
$ cd PYROS/
513 1 Etienne Pallier
514 259 Jeremy Barneron
$ python3 pyros.py start
515 217 Etienne Pallier
516 217 Etienne Pallier
(To check that this service is actually running, type "$ netstat -an |grep 8000" and you should get "tcp        0      0 127.0.0.1:8000          0.0.0.0:*               LISTEN")
517 217 Etienne Pallier
518 218 Etienne Pallier
(Use instead "python manage.py runserver YOUR_IP_ADDRESS:8000" if you want to access the website from another pc with http://YOUR_IP_ADDRESS:8000) (from within a virtual env, and from src/)
519 217 Etienne Pallier
520 93 Paul Carensac
</pre>
521 75 Etienne Pallier
522 158 Paul Carensac
Now, go to "http://localhost:8000/admin" in your browser
523 91 Etienne Pallier
524 158 Paul Carensac
(and login as "pyros" with the password 'DjangoPyros')
525 105 Etienne Pallier
526 91 Etienne Pallier
(Ctrl-c to stop)
527 91 Etienne Pallier
528 91 Etienne Pallier
529 75 Etienne Pallier
530 106 Etienne Pallier
* From Eclipse : see below, in section "NOTES FOR ECLIPSE USERS"
531 75 Etienne Pallier
532 75 Etienne Pallier
533 1 Etienne Pallier
---
534 1 Etienne Pallier
535 170 Etienne Pallier
---
536 170 Etienne Pallier
537 33 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}NOTES FOR ECLIPSE USERS%
538 35 Etienne Pallier
539 35 Etienne Pallier
0) Install Eclipse (if necessary)
540 35 Etienne Pallier
541 35 Etienne Pallier
Get the Eclipse version for Php
542 35 Etienne Pallier
543 35 Etienne Pallier
Install the plug-in pydev (via install new software, add http://pydev.org/updates)
544 35 Etienne Pallier
545 35 Etienne Pallier
Install the django template editor (via install new software, add http://eclipse.kacprzak.org/updates)
546 35 Etienne Pallier
547 35 Etienne Pallier
1) Deactivate CA certificate verification
548 35 Etienne Pallier
549 35 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
550 35 Etienne Pallier
551 35 Etienne Pallier
Key = http.sslVerify
552 35 Etienne Pallier
Value = false
553 35 Etienne Pallier
554 35 Etienne Pallier
2) Fetch the project
555 35 Etienne Pallier
556 35 Etienne Pallier
File/Import project from git
557 35 Etienne Pallier
558 35 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/pyros.git
559 35 Etienne Pallier
560 35 Etienne Pallier
Directory: 
561 35 Etienne Pallier
par défaut, il propose : /Users/epallier/git/pyros
562 35 Etienne Pallier
mais on peut le mettre ailleurs (c'est ce que j'ai fait)
563 35 Etienne Pallier
564 35 Etienne Pallier
initial branch: master
565 35 Etienne Pallier
remote name: origin
566 35 Etienne Pallier
567 35 Etienne Pallier
Import as general project
568 35 Etienne Pallier
569 35 Etienne Pallier
Project name: PYROS
570 35 Etienne Pallier
571 35 Etienne Pallier
572 35 Etienne Pallier
3) Configure the project
573 35 Etienne Pallier
574 35 Etienne Pallier
The project is created. Now, you have to set it as a «PyDev » and a « Django » project.
575 35 Etienne Pallier
576 35 Etienne Pallier
clic droit sur le projet / PyDev / set as a PyDev project
577 35 Etienne Pallier
578 35 Etienne Pallier
clic droit sur le projet / PyDev / set as a Django project
579 35 Etienne Pallier
580 35 Etienne Pallier
clic droit sur le projet : on doit maintenant avoir un sous-menu Django
581 35 Etienne Pallier
582 35 Etienne Pallier
clic droit sur le dossier src / PyDev / set as source folder (add to PYTHONPATH)
583 35 Etienne Pallier
584 35 Etienne Pallier
clic droit sur projet / Properties / Pydev-Django :
585 215 Etienne Pallier
  - *Django manage.py : src/manage.py*
586 215 Etienne Pallier
  - *Django settings module : pyros.settings*
587 35 Etienne Pallier
588 35 Etienne Pallier
589 35 Etienne Pallier
4) Set Code style
590 35 Etienne Pallier
591 35 Etienne Pallier
Window/Preferences : Pydev / Editor
592 35 Etienne Pallier
- Auto Imports : uncheck « Do auto import »
593 35 Etienne Pallier
- Code style:
594 35 Etienne Pallier
	- Locals … : camelCase
595 35 Etienne Pallier
	- Methods : camelCase() with first lower
596 35 Etienne Pallier
- Code style / Code Formatter: activer « use autopep8.py for code formatting »
597 35 Etienne Pallier
- Tabs : Tab length : 4
598 35 Etienne Pallier
599 67 Etienne Pallier
5) Now, once the Python3 virtual environment is installed (see above),
600 66 Etienne Pallier
set it in Eclipse as the project interpreter:
601 66 Etienne Pallier
602 68 Etienne Pallier
Right clic on the project / Properties / PyDev - Interpreter/Grammar :
603 66 Etienne Pallier
Grammar version : 3
604 66 Etienne Pallier
605 66 Etienne Pallier
Interpreter : click on « click here to configure an interpreter not listed »
606 66 Etienne Pallier
607 66 Etienne Pallier
click on « New... » :
608 66 Etienne Pallier
- Interpreter name : venv_py35_pyros
609 66 Etienne Pallier
- Interpreter executable : click on « Browse »
610 66 Etienne Pallier
	Select your virtualenv python35 executable (private/venv_py35_pyros/bin/python3.5)
611 66 Etienne Pallier
	click OK
612 66 Etienne Pallier
613 66 Etienne Pallier
*Now, a last thing to do so that Pydev finds Django:*
614 66 Etienne Pallier
615 66 Etienne Pallier
In the Python interpreters list, select your virtual env (venv_py35_pyros)
616 66 Etienne Pallier
617 66 Etienne Pallier
Click on the tab "Libraries"
618 66 Etienne Pallier
619 66 Etienne Pallier
clic on 'New folder', then select your virtualenv's lib/python3.5/site-packages folder
620 66 Etienne Pallier
621 66 Etienne Pallier
OK
622 66 Etienne Pallier
623 66 Etienne Pallier
Interpreter: select now venv_py35_pyros from the list
624 66 Etienne Pallier
625 66 Etienne Pallier
OK
626 62 Etienne Pallier
627 78 Etienne Pallier
6) Test
628 1 Etienne Pallier
629 78 Etienne Pallier
* Right-clic on the project / Django / Run Django tests
630 78 Etienne Pallier
631 78 Etienne Pallier
* Right-clic on the project / Django / Custom command / ...
632 78 Etienne Pallier
633 78 Etienne Pallier
634 78 Etienne Pallier
7) Run
635 70 Etienne Pallier
636 70 Etienne Pallier
Right clic on project -> Django/Custom command/runserver
637 70 Etienne Pallier
638 70 Etienne Pallier
Error on Ubuntu :
639 70 Etienne Pallier
640 70 Etienne Pallier
<pre>
641 70 Etienne Pallier
642 70 Etienne Pallier
Traceback (most recent call last):
643 70 Etienne Pallier
  File "/home/carens_p/git/pyros/src/manage.py", line 8, in <module>
644 70 Etienne Pallier
    from django.core.management import execute_from_command_line
645 70 Etienne Pallier
ImportError: No module named 'django'
646 70 Etienne Pallier
647 70 Etienne Pallier
</pre>
648 70 Etienne Pallier
649 70 Etienne Pallier
Project -> Properties -> Pydev interpreter -> Clic here to configure an interpreter not listed
650 70 Etienne Pallier
651 70 Etienne Pallier
select venv_py35_pyros
652 70 Etienne Pallier
653 70 Etienne Pallier
In Libraries, clic on 'New folder', then select your virtualenv's lib/python3.5/site-packages folder.
654 70 Etienne Pallier
655 70 Etienne Pallier
OK -> re-select venv_py35_pyros in 'Interpreter' dropdown menu
656 70 Etienne Pallier
657 70 Etienne Pallier
Then right clic on project -> Django/Custom command/runserver
658 70 Etienne Pallier
659 70 Etienne Pallier
check http://localhost:8000/
660 70 Etienne Pallier
661 70 Etienne Pallier
662 62 Etienne Pallier
---
663 62 Etienne Pallier
664 62 Etienne Pallier
---
665 62 Etienne Pallier
666 250 Jeremy Barneron
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}NOTES FOR PYCHARM USERS%
667 250 Jeremy Barneron
668 250 Jeremy Barneron
1) Install Pycharm
669 250 Jeremy Barneron
670 251 Jeremy Barneron
2) import pyros project
671 251 Jeremy Barneron
672 252 Jeremy Barneron
3) Mark the src directory and simulators directory as source root directories
673 250 Jeremy Barneron
674 252 Jeremy Barneron
4) Go in file -> settings (CTRL + ALT + S) -> Project : Pyros -> Project Interpreter
675 258 Jeremy Barneron
   Add an interpreter which is the one from your virtual environment : Add Local -> find the python 3 binary in your virtualenv
676 250 Jeremy Barneron
677 252 Jeremy Barneron
5) Go in Language & Frameworks -> Django and set the django project root / Settings (pyros/settings.py) / Manage script
678 250 Jeremy Barneron
679 250 Jeremy Barneron
680 250 Jeremy Barneron
---
681 250 Jeremy Barneron
682 250 Jeremy Barneron
---
683 250 Jeremy Barneron
684 81 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}MANUAL INSTALLATION OF PYTHON PACKAGES ONE BY ONE%
685 81 Etienne Pallier
686 172 Etienne Pallier
*Follow these steps only if the previous guided and nearly automatic installation did not work for you*
687 100 Etienne Pallier
688 172 Etienne Pallier
689 174 Etienne Pallier
h3. (Only if using Mysql) Create the database "pyros" and the pyros user
690 174 Etienne Pallier
691 174 Etienne Pallier
Only if you are using Mysql, you need to create an empty database "pyros"
692 174 Etienne Pallier
(which will be filled automatically by django)
693 174 Etienne Pallier
694 174 Etienne Pallier
<pre>
695 174 Etienne Pallier
$ mysql -u root -p
696 174 Etienne Pallier
(enter your root password)
697 174 Etienne Pallier
698 174 Etienne Pallier
$ mysql> create database if not exists pyros;
699 174 Etienne Pallier
</pre>
700 174 Etienne Pallier
701 174 Etienne Pallier
The user creation depends on your MySQL version :
702 174 Etienne Pallier
703 174 Etienne Pallier
 * 5.7 and above :
704 174 Etienne Pallier
<pre>
705 174 Etienne Pallier
$ mysql> DROP USER IF EXISTS pyros;
706 174 Etienne Pallier
$ mysql> CREATE USER 'pyros' IDENTIFIED BY 'DjangoPyros';
707 174 Etienne Pallier
$ mysql> GRANT ALL PRIVILEGES ON pyros.* TO pyros;
708 174 Etienne Pallier
</pre>
709 174 Etienne Pallier
710 174 Etienne Pallier
 * under 5.7 :
711 174 Etienne Pallier
<pre>
712 174 Etienne Pallier
$ mysql> GRANT USAGE ON *.* TO 'pyros';
713 174 Etienne Pallier
$ mysql> DROP USER 'pyros';
714 174 Etienne Pallier
$ mysql> CREATE USER 'pyros' IDENTIFIED BY 'DjangoPyros';
715 174 Etienne Pallier
$ mysql> GRANT ALL PRIVILEGES ON pyros.* TO pyros;
716 174 Etienne Pallier
</pre>
717 174 Etienne Pallier
718 174 Etienne Pallier
If none of these solution work, check on the internet to create a user named pyros with the password DjangoPyros.
719 174 Etienne Pallier
720 100 Etienne Pallier
h3. Create a Python3 virtual environment dedicated to the project (inside the project folder)
721 100 Etienne Pallier
722 100 Etienne Pallier
<pre>
723 100 Etienne Pallier
724 100 Etienne Pallier
$ mkdir private/
725 100 Etienne Pallier
726 100 Etienne Pallier
$ cd private/
727 100 Etienne Pallier
728 100 Etienne Pallier
$ which python3.5 ("where python" for windows)
729 100 Etienne Pallier
/opt/local/bin/python3.5
730 100 Etienne Pallier
731 100 Etienne Pallier
$ virtualenv venv_py35_pyros -p /opt/local/bin/python3.5
732 100 Etienne Pallier
=> creates a venv_py35_pyros/ folder inside PYROS/private/
733 100 Etienne Pallier
734 100 Etienne Pallier
</pre>
735 100 Etienne Pallier
736 100 Etienne Pallier
737 100 Etienne Pallier
---
738 100 Etienne Pallier
739 100 Etienne Pallier
h3. Activate the python virtual environment (from inside the project)
740 100 Etienne Pallier
741 100 Etienne Pallier
<pre>
742 100 Etienne Pallier
743 100 Etienne Pallier
$ pwd
744 100 Etienne Pallier
.../PYROS/private
745 100 Etienne Pallier
746 100 Etienne Pallier
$ source ./venv_py35_pyros/bin/activate (venv_py35_pyros/Scripts/activate on Windows)
747 100 Etienne Pallier
748 100 Etienne Pallier
</pre>
749 100 Etienne Pallier
750 100 Etienne Pallier
---
751 100 Etienne Pallier
752 100 Etienne Pallier
h3. Install needed python packages
753 100 Etienne Pallier
754 81 Etienne Pallier
Check that the virtual environment is activated
755 81 Etienne Pallier
<pre>
756 81 Etienne Pallier
$ python -V
757 81 Etienne Pallier
Python 3...
758 81 Etienne Pallier
759 81 Etienne Pallier
$ which pip
760 81 Etienne Pallier
.../PYROS/venv_py35_pyros/bin/pip
761 81 Etienne Pallier
</pre>
762 81 Etienne Pallier
763 81 Etienne Pallier
764 81 Etienne Pallier
Upgrade pip to last version available:
765 81 Etienne Pallier
<pre>
766 81 Etienne Pallier
$ pip install --upgrade pip
767 81 Etienne Pallier
Collecting pip
768 81 Etienne Pallier
  Downloading pip-8.1.1-py2.py3-none-any.whl (1.2MB)
769 81 Etienne Pallier
Installing collected packages: pip
770 81 Etienne Pallier
  Found existing installation: pip 7.1.2
771 81 Etienne Pallier
    Uninstalling pip-7.1.2:
772 81 Etienne Pallier
      Successfully uninstalled pip-7.1.2
773 81 Etienne Pallier
Successfully installed pip-8.1.1
774 81 Etienne Pallier
775 81 Etienne Pallier
Upgrade wheel to last version available:
776 81 Etienne Pallier
$ pip install --upgrade wheel
777 81 Etienne Pallier
Collecting wheel
778 81 Etienne Pallier
  Downloading wheel-0.29.0-py2.py3-none-any.whl (66kB)
779 81 Etienne Pallier
Installing collected packages: wheel
780 81 Etienne Pallier
  Found existing installation: wheel 0.24.0
781 81 Etienne Pallier
    Uninstalling wheel-0.24.0:
782 81 Etienne Pallier
      Successfully uninstalled wheel-0.24.0
783 81 Etienne Pallier
Successfully installed wheel-0.29.0
784 81 Etienne Pallier
785 81 Etienne Pallier
</pre>
786 81 Etienne Pallier
787 81 Etienne Pallier
Go into the install/ folder:
788 81 Etienne Pallier
<pre>
789 81 Etienne Pallier
$ cd .../PYROS/install/
790 81 Etienne Pallier
</pre>
791 81 Etienne Pallier
792 84 Etienne Pallier
Install all the needed python packages at once:
793 85 Etienne Pallier
<pre>
794 1 Etienne Pallier
$ pip install -r REQUIREMENTS.txt
795 85 Etienne Pallier
</pre>
796 84 Etienne Pallier
797 84 Etienne Pallier
If something goes wrong, install them one by one:
798 62 Etienne Pallier
799 62 Etienne Pallier
  * *Install Django* :
800 62 Etienne Pallier
<pre>
801 62 Etienne Pallier
$ pip install django
802 62 Etienne Pallier
Collecting django
803 62 Etienne Pallier
  Downloading Django-1.9.4-py2.py3-none-any.whl (6.6MB)
804 62 Etienne Pallier
Installing collected packages: django
805 62 Etienne Pallier
Successfully installed django-1.9.4
806 62 Etienne Pallier
807 62 Etienne Pallier
$ pip install django-admin-tools
808 62 Etienne Pallier
Collecting django-admin-tools
809 62 Etienne Pallier
  Downloading django_admin_tools-0.7.2-py2.py3-none-any.whl (289kB)
810 62 Etienne Pallier
Installing collected packages: django-admin-tools
811 62 Etienne Pallier
Successfully installed django-admin-tools-0.7.2
812 62 Etienne Pallier
813 62 Etienne Pallier
$ pip install django-debug-toolbar
814 62 Etienne Pallier
Collecting django-debug-toolbar
815 62 Etienne Pallier
  Downloading django_debug_toolbar-1.4-py2.py3-none-any.whl (212kB)
816 62 Etienne Pallier
Requirement already satisfied (use --upgrade to upgrade): Django>=1.7 in ./venv_py35_pyros/lib/python3.5/site-packages (from django-debug-toolbar)
817 62 Etienne Pallier
Collecting sqlparse (from django-debug-toolbar)
818 62 Etienne Pallier
  Downloading sqlparse-0.1.19.tar.gz (58kB)
819 62 Etienne Pallier
Building wheels for collected packages: sqlparse
820 62 Etienne Pallier
  Running setup.py bdist_wheel for sqlparse ... done
821 62 Etienne Pallier
  Stored in directory: /Users/epallier/Library/Caches/pip/wheels/7b/d4/72/6011bb100dd5fc213164e4bbee13d4e03261dd54ce6a5de6b8
822 62 Etienne Pallier
Successfully built sqlparse
823 62 Etienne Pallier
Installing collected packages: sqlparse, django-debug-toolbar
824 62 Etienne Pallier
Successfully installed django-debug-toolbar-1.4 sqlparse-0.1.19
825 62 Etienne Pallier
826 62 Etienne Pallier
$ pip install django-extensions
827 62 Etienne Pallier
Collecting django-extensions
828 62 Etienne Pallier
  Downloading django_extensions-1.6.1-py2.py3-none-any.whl (202kB)
829 62 Etienne Pallier
Collecting six>=1.2 (from django-extensions)
830 62 Etienne Pallier
  Downloading six-1.10.0-py2.py3-none-any.whl
831 62 Etienne Pallier
Installing collected packages: six, django-extensions
832 62 Etienne Pallier
Successfully installed django-extensions-1.6.1 six-1.10.0
833 62 Etienne Pallier
834 62 Etienne Pallier
$ pip install django-suit
835 62 Etienne Pallier
Collecting django-suit
836 62 Etienne Pallier
  Downloading django-suit-0.2.18.tar.gz (587kB)
837 62 Etienne Pallier
Building wheels for collected packages: django-suit
838 62 Etienne Pallier
  Running setup.py bdist_wheel for django-suit ... done
839 62 Etienne Pallier
  Stored in directory: /Users/epallier/Library/Caches/pip/wheels/12/8b/9a/e02ab0ad9229881638aa040d47d77c8f562999533811927d41
840 62 Etienne Pallier
Successfully built django-suit
841 62 Etienne Pallier
Installing collected packages: django-suit
842 62 Etienne Pallier
Successfully installed django-suit-0.2.18
843 62 Etienne Pallier
844 62 Etienne Pallier
</pre>
845 62 Etienne Pallier
846 62 Etienne Pallier
  * *Install the django boostrap css package* :
847 62 Etienne Pallier
<pre>
848 62 Etienne Pallier
$ pip install django-bootstrap3
849 62 Etienne Pallier
</pre>
850 62 Etienne Pallier
(==> 'bootstrap3' is then to be added as an application in settings.py -> INSTALLED_APPS)
851 62 Etienne Pallier
852 62 Etienne Pallier
  * *Install the web application server gunicorn (will be used in production instead of the dev django web server)* :
853 62 Etienne Pallier
<pre>
854 62 Etienne Pallier
$ pip install gunicorn
855 62 Etienne Pallier
Collecting gunicorn
856 62 Etienne Pallier
  Downloading gunicorn-19.4.5-py2.py3-none-any.whl (112kB)
857 62 Etienne Pallier
Installing collected packages: gunicorn
858 62 Etienne Pallier
Successfully installed gunicorn-19.4.5
859 62 Etienne Pallier
</pre>
860 62 Etienne Pallier
861 62 Etienne Pallier
  * *Install the python mysql client* (not needed if you want to use sqlite):
862 62 Etienne Pallier
<pre>
863 62 Etienne Pallier
$ pip install mysqlclient
864 62 Etienne Pallier
...
865 62 Etienne Pallier
</pre>
866 62 Etienne Pallier
867 146 Etienne Pallier
   * => If issue under Mac OS X:
868 62 Etienne Pallier
<pre>
869 62 Etienne Pallier
$ pip install mysqlclient
870 62 Etienne Pallier
Collecting mysqlclient
871 62 Etienne Pallier
  Downloading mysqlclient-1.3.7.tar.gz (79kB)
872 62 Etienne Pallier
Building wheels for collected packages: mysqlclient
873 62 Etienne Pallier
  Running setup.py bdist_wheel for mysqlclient ... error
874 62 Etienne Pallier
875 62 Etienne Pallier
  ----------------------------------------
876 62 Etienne Pallier
  Failed building wheel for mysqlclient
877 62 Etienne Pallier
  Running setup.py clean for mysqlclient
878 62 Etienne Pallier
Failed to build mysqlclient
879 62 Etienne Pallier
Installing collected packages: mysqlclient
880 62 Etienne Pallier
  Running setup.py install for mysqlclient ... done
881 62 Etienne Pallier
Successfully installed mysqlclient-1.3.7
882 62 Etienne Pallier
883 62 Etienne Pallier
BOUH !!!
884 1 Etienne Pallier
885 152 Etienne Pallier
=> Need to upgrade wheel:
886 146 Etienne Pallier
887 62 Etienne Pallier
$ pip install --upgrade wheel
888 62 Etienne Pallier
Collecting wheel
889 62 Etienne Pallier
  Downloading wheel-0.29.0-py2.py3-none-any.whl (66kB)
890 62 Etienne Pallier
Installing collected packages: wheel
891 62 Etienne Pallier
  Found existing installation: wheel 0.24.0
892 62 Etienne Pallier
    Uninstalling wheel-0.24.0:
893 62 Etienne Pallier
      Successfully uninstalled wheel-0.24.0
894 62 Etienne Pallier
Successfully installed wheel-0.29.0
895 62 Etienne Pallier
896 153 Etienne Pallier
YES !!!
897 1 Etienne Pallier
898 154 Etienne Pallier
Only if necessary, you can reinstall mysqlclient:
899 153 Etienne Pallier
$ pip uninstall mysqlclient
900 62 Etienne Pallier
$ pip install mysqlclient
901 62 Etienne Pallier
Collecting mysqlclient
902 62 Etienne Pallier
  Using cached mysqlclient-1.3.7.tar.gz
903 62 Etienne Pallier
Building wheels for collected packages: mysqlclient
904 62 Etienne Pallier
  Running setup.py bdist_wheel for mysqlclient ... done
905 62 Etienne Pallier
  Stored in directory: /Users/epallier/Library/Caches/pip/wheels/9b/06/50/d11418c26cf8f2156b13d4363b5afde8e7e75ebb8540d0228d
906 62 Etienne Pallier
Successfully built mysqlclient
907 62 Etienne Pallier
Installing collected packages: mysqlclient
908 62 Etienne Pallier
Successfully installed mysqlclient-1.3.7
909 62 Etienne Pallier
910 1 Etienne Pallier
</pre>
911 62 Etienne Pallier
912 146 Etienne Pallier
   * => If issue under Windows
913 62 Etienne Pallier
<pre>
914 62 Etienne Pallier
Same message as the issue for Mac.
915 146 Etienne Pallier
916 204 Paul Carensac
=> Need to install wheel manually :
917 62 Etienne Pallier
918 62 Etienne Pallier
Go to http://www.lfd.uci.edu/~gohlke/pythonlibs/#mysqlclient to download the newest mysqlclient wheel
919 62 Etienne Pallier
920 62 Etienne Pallier
$ pip install path\to\mysqlclient\wheel
921 62 Etienne Pallier
922 154 Etienne Pallier
(No need to redo "pip install mysqlclient")
923 62 Etienne Pallier
</pre>
924 163 Paul Carensac
925 163 Paul Carensac
  * *Install the julian day converter* :
926 163 Paul Carensac
<pre>
927 163 Paul Carensac
$ pip install jdcal
928 163 Paul Carensac
</pre>
929 182 Paul Carensac
930 188 Paul Carensac
  * *Install Celery and dependencies* :
931 182 Paul Carensac
<pre>
932 182 Paul Carensac
$ pip install celery
933 1 Etienne Pallier
$ pip install django-celery
934 188 Paul Carensac
$ pip install Twisted==16.0.0
935 188 Paul Carensac
</pre>
936 188 Paul Carensac
937 188 Paul Carensac
  * *Install django test without migrations (compulsory to use the prod DB for tests)* :
938 188 Paul Carensac
<pre>
939 188 Paul Carensac
$ pip install django-test-without-migrations==0.4
940 188 Paul Carensac
</pre>
941 188 Paul Carensac
942 188 Paul Carensac
  * *Install voevent parser* :
943 188 Paul Carensac
<pre>
944 188 Paul Carensac
$ pip install voevent-parse==0.9.5
945 188 Paul Carensac
</pre>
946 188 Paul Carensac
947 188 Paul Carensac
948 188 Paul Carensac
  * *Install other dependencies (useful ? TBC)* :
949 188 Paul Carensac
<pre>
950 188 Paul Carensac
$ pip install amqplib==1.0.2
951 188 Paul Carensac
$ pip install pluggy==0.3.1
952 188 Paul Carensac
$ pip install py==1.4.31
953 182 Paul Carensac
</pre>