Project Installation

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