Revision e46798b5 docs/source/adminguide.rst
b/docs/source/adminguide.rst | ||
---|---|---|
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 |
Also available in: Unified diff