Project Installation
Version 251 (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 | 250 | Jeremy Barneron | 2) Mark the src directory and simulators directory as source root directories |
669 | 250 | Jeremy Barneron | |
670 | 250 | Jeremy Barneron | 3) 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 | 250 | Jeremy Barneron | 4) 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> |