1 |
1 |
Administrator Guide
|
2 |
2 |
===================
|
3 |
3 |
|
|
4 |
Simple Setup
|
|
5 |
------------
|
|
6 |
|
|
7 |
Assuming a clean debian squeeze (stable) installation, use the following steps to run the software.
|
|
8 |
|
4 |
9 |
Install packages::
|
5 |
10 |
|
6 |
11 |
apt-get install git python-django python-setuptools python-sphinx
|
... | ... | |
11 |
16 |
cd /
|
12 |
17 |
git clone https://code.grnet.gr/git/pithos
|
13 |
18 |
|
14 |
|
Setup the files::
|
|
19 |
Setup the files (choose where to store data in ``settings.py``)::
|
15 |
20 |
|
16 |
21 |
cd /pithos/pithos
|
17 |
22 |
cp settings.py.dist settings.py
|
18 |
23 |
cd /pithos
|
19 |
24 |
python setup.py build_sphinx
|
20 |
25 |
|
21 |
|
Edit ``/etc/apache2/sites-available/pithos``::
|
|
26 |
Edit ``/etc/apache2/sites-available/pithos`` (change the ``ServerName`` directive)::
|
22 |
27 |
|
23 |
28 |
<VirtualHost *:80>
|
24 |
29 |
ServerAdmin webmaster@pithos.dev.grnet.gr
|
... | ... | |
65 |
70 |
|
66 |
71 |
</VirtualHost>
|
67 |
72 |
|
68 |
|
Edit ``/etc/apache2/sites-available/pithos-ssl`` (assuming files in ``/etc/ssl/private/pithos.dev.key`` and ``/etc/ssl/certs/pithos.dev.crt``)::
|
|
73 |
Edit ``/etc/apache2/sites-available/pithos-ssl`` (assuming files in ``/etc/ssl/private/pithos.dev.key`` and ``/etc/ssl/certs/pithos.dev.crt`` - change the ``ServerName`` directive)::
|
69 |
74 |
|
70 |
75 |
<IfModule mod_ssl.c>
|
71 |
76 |
<VirtualHost _default_:443>
|
... | ... | |
250 |
255 |
mkdir /var/www/pithos
|
251 |
256 |
mkdir /var/www/pithos_web_client
|
252 |
257 |
/etc/init.d/apache2 restart
|
|
258 |
|
|
259 |
Useful alias to add in ``~/.bashrc``::
|
|
260 |
|
|
261 |
alias pithos-sync='cd /pithos && git pull && python setup.py build_sphinx'
|
|
262 |
|
|
263 |
MySQL Setup
|
|
264 |
-----------
|
|
265 |
|
|
266 |
If using MySQL instead of SQLite for the database engine, consider the following.
|
|
267 |
|
|
268 |
Server side::
|
|
269 |
|
|
270 |
apt-get install mysql-server
|
|
271 |
|
|
272 |
Edit ``/etc/mysql/my.cnf`` to allow network connections and restart the server.
|
|
273 |
|
|
274 |
Create database and user::
|
|
275 |
|
|
276 |
CREATE DATABASE pithos;
|
|
277 |
GRANT ALL ON pithos.* TO pithos@localhost IDENTIFIED BY 'password';
|
|
278 |
GRANT ALL ON pithos.* TO pithos@'%' IDENTIFIED BY 'password';
|
|
279 |
|
|
280 |
Client side::
|
|
281 |
|
|
282 |
apt-get install mysql-client
|
|
283 |
|
|
284 |
It helps to create a ``~/.my.cnf`` file, for automatically connecting to the server::
|
|
285 |
|
|
286 |
[client]
|
|
287 |
user = pithos
|
|
288 |
password = 'password'
|
|
289 |
host = pithos-storage.dev.grnet.gr
|
|
290 |
|
|
291 |
[mysql]
|
|
292 |
database = pithos
|