@@ -32,14 +32,11 @@ Roundup scripts
3232Prerequisites
3333=============
3434
35- Roundup requires Python 2.1.3 or newer with a functioning anydbm or
36- bsddb module. Download the latest version from http://www.python.org/.
35+ Roundup requires Python 2.1.3 or newer with a functioning anydbm
36+ module. Download the latest version from http://www.python.org/.
3737It is highly recommended that users install the latest patch version
3838of python as these contain many fixes to serious bugs.
3939
40- If you want to use Berkeley DB bsddb3 with Roundup, use version 3.3.0 or
41- later. Download the latest version from http://pybsddb.sourceforge.net/.
42-
4340If you're on windows, you will either need to be using the ActiveState python
4441distribution (at http://www.activestate.com/Products/ActivePython/), or you'll
4542have to install the win32all package separately (get it from
@@ -199,9 +196,13 @@ Configuring your first tracker
199196 Enter tracker home: /opt/roundup/trackers/support
200197 Templates: classic
201198 Select template [classic]: classic
202- Back ends: anydbm, bsddb
199+ Back ends: anydbm, mysql, sqlite
203200 Select backend [anydbm]: anydbm
204201
202+ Note: "Back ends" selection list depends on availability of
203+ third-party database modules. Standard python distribution
204+ includes anydbm module only.
205+
205206 The "support" part of the tracker name can be anything you want - it
206207 is going to be used as the directory that the tracker information
207208 will be stored in.
@@ -283,8 +284,6 @@ There's several to choose from, each with benefits and limitations:
283284Name Speed Users Support
284285========== =========== ===== ==============================
285286anydbm Slowest Few Always available
286- bsddb Slow Few Usually available
287- bsddb3 Slow Few Needs install (pybsddb_)
288287sqlite Fastest(*) Few Needs install (PySQLite_)
289288metakit Fastest(*) Few Needs install (metakit_)
290289postgresql Fast Many Needs install/admin (psycopg_)
@@ -294,7 +293,9 @@ mysql Fast Many Needs install/admin (MySQLdb_)
294293**sqlite** and **metakit**
295294 These use the embedded database engines PySQLite_ and metakit_ to provide
296295 very fast backends. They are not suitable for trackers which will have
297- many simultaneous users.
296+ many simultaneous users, but require much less installation and
297+ maintenance effort than more scalable postgresql and mysql backends.
298+ If you are choosing from these two, please select sqlite.
298299**postgresql**
299300 Backend for popular RDBMS PostgreSQL. You must read doc/postgresql.txt for
300301 additional installation steps and requirements.
@@ -768,5 +769,4 @@ Next: `User Guide`_
768769.. _mod_python: http://www.modpython.org/
769770.. _MySQLdb: http://sourceforge.net/projects/mysql-python
770771.. _Psycopg: http://initd.org/software/initd/psycopg
771- .. _pybsddb: http://pybsddb.sourceforge.net/
772772.. _pysqlite: http://pysqlite.sourceforge.net/
0 commit comments