communicate operation timeouts
[oweals/gnunet.git] / doc / README.postgres
1 How to setup the Postgres database for GNUnet.
2
3 NOTE: This db module was developed for Postgres 8.3.  I have no
4 idea what the minimum version that we require is exactly.
5
6 HIGHLIGHTS
7
8 Pros
9  + Easier to setup than MySQL
10  + Real database
11 Cons 
12  - Quite slow
13  - Still some setup
14
15 MANUAL SETUP INSTRUCTIONS
16
17  1) in /etc/gnunet.conf, set
18     DATABASE = postgres
19
20  2) Then access postgres to create a user; I had to do this to get 
21     access and create a user:
22     # su - postgres
23     $ createuser
24     At this point, use the name of the user running gnunet
25     for the role, do not set it to superuser, allow the creation
26     of databases.
27
28  3) As that user, create a database (or two):
29     $ createdb gnunet
30     $ createdb gnunetcheck # this way you can run "make check"
31
32  Thats it. 
33
34  4) Still, perhaps you should briefly try if the DB connection 
35     works. First, login as the user who will run gnunetd. Then use,
36
37     $ psql gnunet # or gnunetcheck
38     gnunet=> \dt
39    
40     If, after you have started gnunetd at least once, you get a
41     gn090 table here, it probably works.
42  
43 PROBLEMS?
44
45 If you have problems related to the postgres module, your best friend
46 is probably the postgres manual. The first thing to check is that
47 postgres is basically operational, that you can connect to it, create
48 tables, issue queries etc. (see step 4 above for details).
49