Difference between revisions of "Install latest BSDDB"

From Gramps
Jump to: navigation, search
m (BSDDB core from Sleepycat (Oracle))
m (Python BSDDB interface)
Line 26: Line 26:
  
 
=== Python BSDDB interface ===
 
=== Python BSDDB interface ===
Next, go to http://pybsddb.sourceforge.net  
+
Next, go to [http://www.jcea.es/programacion/pybsddb.htm pybsddb] ([http://pybsddb.sourceforge.net ]).
Download <code>bsddb3-4.5.0.tar.gz</code> (version at the time of writing), unpack and go in the created directory. Run <code>python setup.py</code>, this should find your installed bsddb3 returning something like:
+
Download the version compatible with the downloaded bsddb version, eg [http://pypi.python.org/pypi/bsddb3/5.1.1 bsddb3 5.1.1] is tested with 4.2 and 5.1. Unpack and go in the created directory. Run <code>python setup.py</code>, this should find your installed bsddb3 returning something like:
  
 
  Found BerkeleyDB 4.5 installation.
 
  Found BerkeleyDB 4.5 installation.

Revision as of 07:26, 23 January 2011

Some people have encountered bugs in GRAMPS which are due to the database not working well.

Installing the latest version of the BSDDB database tends to solve the problem.

Why install latest version ?

Some errors have happened in the past outside of GRAMPS, with the BSDDB database format GRAMPS uses. See eg: Bug # 110, Bug # 814

It can be expected that recompiling BSDDB could solve the problem. However, if BSDDB needs to be recompiled, one can as well install the latest version.

Furthermore, the people of pybsddb recommend doing a local compile if the use of BSDDB is critical.

For genealogists needing GRAMPS this could be considered true.

Before you begin: BACKUP

Take a backup of your genealogical data before you do this. Remember, you should backup data of GRAMPS in .gramps format, and keep that somewhere save (GRDB format is NOT a good backup format!).

Obtaining latest BSDDB version

BSDDB core from Sleepycat (Oracle)

Go to http://www.oracle.com/technology/software/products/berkeley-db/db/index.html and download latest libdb code without encryption (eg Berkeley DB 5.1.19.NC.tar.gz ), unpack. You need to create an Oracle ID for this, but it is OSS software. Read in the downloaded code the file docs/index.html on how to configure and make the code. For Linux:

cd build_unix
../dist/configure
make
sudo make install

Python BSDDB interface

Next, go to pybsddb ([1]). Download the version compatible with the downloaded bsddb version, eg bsddb3 5.1.1 is tested with 4.2 and 5.1. Unpack and go in the created directory. Run python setup.py, this should find your installed bsddb3 returning something like:

Found BerkeleyDB 4.5 installation.
  include files in /usr/local/BerkeleyDB.4.5/include
  library files in /usr/local/BerkeleyDB.4.5/lib
  library name is libdb-4.5
Now run python setup.py build to make the package, and lastly install it with
sudo python setup.py install
which installs bsddb3.

Note: you need libpython2.5-devel to build. You can test with python test.py, but that does not work on my AMD64

Remove old BSDDB and replace with new in GRAMPS

  • Go into the GRAMPS directory
  • Open the following files:
/gramps-2.2.8/src/DbLoader.py
/gramps-2.2.8/src/Editors/_EditFamily.py
/gramps-2.2.8/src/GrampsDb/_GrampsBSDDB.py
/gramps-2.2.8/src/GrampsDb/_GrampsDbBase.py
/gramps-2.2.8/src/GrampsDb/_GrampsDBCallback.py
/gramps-2.2.8/src/GrampsDb/_ReadGedcom.py
/gramps-2.2.8/src/GrampsLogger/_ErrorReportAssistant.py
/gramps-2.2.8/src/plugins/Leak.py
  • In these files, look up the line
import bsddb
Change this line into
import bsddb3

The above requires further testing!!!

Test

You should now have GRAMPS use the latest BSDDB version. Test if all works

External Link

Information on BSDDB (Python "bindings" for Oracle Berkeley DB)