From Bibus

Contents 1 Windows 1.1 Installing the compiled distribution (standalone version) 1.2 Installing the source distribution with OpenOffice.org (2.x and 3.x) 1.3 Installing the cvs version 2 GNU/Linux 2.1 Debian 2.2 Ubuntu 2.3 Other GNU/Linux 2.3.1 First method 2.3.2 Second method with Checkinstall

Windows

There are two Bibus distributions for Windows:

• The "source" distribution. It is a bit more tricky to install but it is more flexible since you can modify the source and see the result immediately.
• The "compiled" distribution. This is easier to install since all the required extensions are included.

If in doubt, first try the "source" distribution. It is important to run the Bibus installer after everything else has been installed.

You must run at least bibus 1.4.3.1 to be able to use Bibus with OpenOffice.org 3.x.

Installing the compiled distribution (standalone version)

• Optional: If you want to use Bibus with OpenOffice.org
  • Install OpenOffice.org (2.x or 3.x)
• Install Bibus using the file bibus-1.x.y-Win32-Full-Setup.exe

Installing the source distribution with OpenOffice.org (2.x and 3.x)

You have to install additional libraries/softwares before to install bibus source distribution. Required libraries/softwares are summarized in the following table. Please install the dependencies (first column) in the row order depending on your bibus usage (bibus 1.5 or 1.4 with OOo and/or Word)

	Installing Bibus 1.5 with			Installing Bibus 1.4 with
required	OOo	Word	OOo and word	OOo	Word	OOo and Word
1. python	2.6	2.6	2.6	2.3	2.3	2.3
2. pyWin		2.14py2.6	2.14py2.6		2.07py2.3	2.07py2.3
3. wxPython	2.8py2.6	2.8py2.6	2.8py2.6	2.6py2.3	2.6py2.3	2.6py2.3
4. python-sqlite	Included in python >= 2.5	Included in python >= 2.5	Included in python >= 2.5	2.2.2py2.3	2.2.2py2.3	2.2.2py2.3
5. python mysql	Optional 1.2.2py2.6 if you want to use MySQL	Optional 1.2.2py2.6 if you want to use MySQL	Optional 1.2.2py2.6 if you want to use MySQL	Optional 1.2.1py2.3 if you want to use MySQL	Optional 1.2.1py2.3 if you want to use MySQL	Optional 1.2.1py2.3 if you want to use MySQL
6. mysql	Optional 4.1 if you want to use MySQL	Optional 4.1 if you want to use MySQL	Optional 4.1 if you want to use MySQL	Optional 4.1 if you want to use MySQL	Optional 4.1 if you want to use MySQL	Optional 4.1 if you want to use MySQL
7. openoffice (can be done earlier)	OOo		OOo	OOo		OOo
8. bibus	1.5.0	1.5.0	1.5.0	1.4.3.1	1.4.3.1	1.4.3.1

Installing the cvs version

The cvs version contains the development version of the software. You should be aware that this version may be unstable. Before installing this version, you must be aware that it is a development version and therefore may be unstable. Here is an example using totoisecvs but you can use an other cvs client.

• you first have to install python, pywin, wxPython and pysqlite required by the last bibus source version
• download and install tortoisecvs
• open a dos command prompt
• type:

 cd "c:\"

• type:

 "c:\Program Files\TortoiseCVS\cvs.exe" -z3 -d:pserver:anonymous@bibus-biblio.cvs.sourceforge.net:/cvsroot/bibus-biblio co -P bibus 

or

 "c:\Program Files\cvsnt\cvs.exe" -z3 -d:pserver:anonymous@bibus-biblio.cvs.sourceforge.net:/cvsroot/bibus-biblio co -P bibus

• open: "c:\bibus\bibus.cfg"
• change:

 python = C:\Pythonx\pythonw.exe @rem replace x by the correct value

• change:

 oopath = C:\Program Files\OpenOffice.org x\program @rem replace x by the correct value

• save the file. You wan now run bibus by launching bibusstart.py in c:\bibus

GNU/Linux

Debian

• Bibus is now available from the official Debian archives! At the moment, it is available in unstable (sid) and testing (squeeze). Simply run

sudo aptitude install bibus

and start using it... ;-)

For reference, here is the "old" way of installing the .debs provided by the author:

• You must run debian testing or unstable to get OpenOffice.org connection
• Add the following lines to your /etc/apt/sources.list

deb http://switch.dl.sourceforge.net/sourceforge/bibus-biblio ./
deb-src http://switch.dl.sourceforge.net/sourceforge/bibus-biblio ./

• you must install the author gpg key:
  • wget -q http://switch.dl.sourceforge.net/sourceforge/bibus-biblio/pmartino.gpgkey -O- | sudo apt-key add -
• If it did not work because of a closed port download the key "pmartino.gpgkey" from the debian directory:
  • https://sourceforge.net/project/showfiles.php?group_id=110943
  • sudo apt-key add pmartino.gpgkey
• apt-get update
• apt-get install python-pysqlite2 bibus bibus-doc-en
• optional:
  • debian: apt-get openoffice.org
  • apt-get mysql-server mysql-common mysql-client python-mysqldb

Ubuntu

Bibus is/will be available in the official Ubuntu repository starting with release 9.10. Until then, follow these instruction. This paragraph is a brief translation of a frech tutorial written by oswald-p [1]

• Ubuntu must be breezy release or later
• Add the following lines to your /etc/apt/sources.list

## Bibus
deb http://switch.dl.sourceforge.net/sourceforge/bibus-biblio ./
deb-src http://switch.dl.sourceforge.net/sourceforge/bibus-biblio ./

• Download the public key with the following command:

wget -q http://switch.dl.sourceforge.net/sourceforge/bibus-biblio/pmartino.gpgkey -O- | sudo apt-key add -

• sudo apt-get update
• sudo apt-get install bibus libsqliteodbc python-pysqlite2 python-wxgtk2.6 python-uno
• if you run Gutsy, there is a problem with "LD_LIBRARY_PATH", to solve it

- gedit bibus

- copy the following lines in the editor

#! /bin/sh
export LD_LIBRARY_PATH="/usr/lib/openoffice/program"
exec /usr/share/bibus/bibus.py

- sudo rm /usr/bin/bibus

- sudo cp bibus /usr/bin

- sudo chmod +x /usr/bin/bibus

• make bibus and openoffice communicate (not required since Dapper):

- sudo ln -s /usr/lib/openoffice2 /usr/lib/openoffice

- sudo ln -s /usr/lib/openoffice2/share /usr/lib/openoffice2/user

• optional:
  • apt-get install openoffice.org2
  • apt-get install mysql-server mysql-common mysql-client python-mysqldb

Other GNU/Linux

All the software below are presumably part of your favorite distribution. Look for them using your favorite tool.

• install python (presumably already installed)
• install wxpython2.6
  • The package name is usually something like wxpython* or python-wx* or wxgtk
    • Mandriva: wxPythonGTK-2.6
    • Fedora: wxPythonGTK2 ?
    • SUSE: python-wxgtk-2.6
• install python-sqlite (if possible use version 2 but other versions should work)
• Install the OpenOffice.org2 from your distribution. Don't use the version from www.openoffice.org since it will not work with your system python that bibus requires
• Download bibus-1.x.y.tgz
• Uncompress it:
  • tar -zxf bibus-1.x.y.tgz
• Open a console inside the bibus-1.x.y directory
  • cd bibus-1.x.y
• Bibus installation will depend on 3 paths that you may have to adjust:
  • DESTDIR: The destination directory where you want to install bibus (Default = /usr/local)
    • For many systems, /usr/local is not a full-time citizen and shortcuts won't appear in your menu. In such a case, use DESTDIR=/usr
  • python: The python path (Default = /usr/bin/python)
  • oopath: The OpenOffice.org2/program directory
    • Default = /usr/lib/openoffice/program
    • Mandriva = /usr/lib/ooo-1.9/program
    • Fedora = ?
    • SUSE = /usr/lib/ooo-2.0/program

First method

prompt> su
prompt> Enter root password
prompt> export DESTDIR=/usr/local
prompt> export python=/usr/bin/python
prompt> export oopath=/usr/lib/openoffice/program
prompt> make -f Setup/Makefile DESTDIR=$DESTDIR python=$python oopath=$oopath install

• Start bibus
  • By choosing the menu item (Applications/Office/Bibus)
  • prompt> $DESTDIR/bibus (/usr/local/bibus)
• Uninstalling. Run as root:
  • prompt> $DESTDIR/share/bibus/Setup/uninstall.sh

Second method with Checkinstall

• If you prefer, you can use the utility checkinstall to create a package for your distribution. The procedure is the same except for the last command
• Install checkinstall from your distribution or from Checkinstall site

prompt> su
prompt> Enter root password
prompt> export DESTDIR=/usr/local
prompt> export python=/usr/bin/python
prompt> export oopath=/usr/lib/openoffice/program
prompt> checkinstall make -f Setup/Makefile DESTDIR=$DESTDIR python=$python oopath=$oopath install

• A package will be created (rpm, deb, tgz) and installed
• You can now remove bibus using your package manager