HOWTO: Recommend downloading, update index stats, point to step 10 in step 7

[electrum-server.git] / README.leveldb

diff --git a/README.leveldb b/README.leveldb
index 249350b..78d86a3 100644 (file)
--- a/README.leveldb
+++ b/README.leveldb
@@ -9,18 +9,31 @@ __________________________________________________________
 1. patch and compile bitcoind.
 
 Install version 0.8 or equivalent.
+Patch it with the patch distributed with Electrum.
 
 Note: Even though Electrum's database uses pruning, you cannot use it
-with a pruning bitcoind. A full bitcoin node is required in order to
-know for each address if it has been used. Pruning occurs only at the
-level of the Electrum database.
+with a ultra-pruning bitcoind (forthcoming in 0.9 or later).
+A full bitcoin node is required in order to know for each address 
+if it has been used. Pruning occurs only at the level of the Electrum database.
+txindex=1 however is *not* needed!
 
 __________________________________________________________
 
 2. Install python-leveldb: 
 
+Starting at Ubuntu 12.10 you can use apt to install leveldb. If you 
+rather stay on 12.04 LTS you can use the backport and add 
+"deb http://archive.ubuntu.com/ubuntu precise-backports main restricted universe"
+to your sources file. Install the package with: 
+
 sudo apt-get install python-leveldb
 
+alternatively build yourself, see
+http://code.google.com/p/py-leveldb/ 
+and
+http://peter-hoffmann.com/2011/installation-leveldb-ubuntu-python.html
+make sure you have libtool, automake and pkg-config
+
 __________________________________________________________
 
 3. edit /etc/electrum.conf : 
@@ -30,6 +43,7 @@ backend = leveldb
 
 [leveldb]
 path = /path/to/your/database
+pruning_limit = 10
 
 ______________________________________________________________
 
@@ -38,7 +52,7 @@ ______________________________________________________________
 In order to speed up the initial catch_up phase, it is recommended to
 locate your database in shared memory:
 
- dbpath = /run/shm/electrum_db
+ path = /run/shm/electrum_db
 
 Once your server has finished catching up, copy your database to disk
 and update the path in /etc/electrum.conf
@@ -59,4 +73,13 @@ Other commands are available:
 ./server load   : view the size of the queue
 
 
+______________________
+Troubleshooting:
+
+* if your server or bitcoind is killed because is uses too much
+memory, configure bitcoind to limit the number of connections
+
+* if you see "Too many open files" errors, you may need to increase
+your user's File Descriptors limit. For this, see
+http://www.cyberciti.biz/faq/linux-increase-the-maximum-number-of-open-files/