cb2Bib Installation

Last updated on

Section Contents

 

Installing on Unix systems (tarball)

The following is the general, platform independent install procedure.

  • Unpack the distribution file:

    tar -xzvf cb2bib-2.0.3.tar.gz

  • Move to cb2Bib directory:

    cd cb2bib-2.0.3

  • Type the following commands:

    ./configure –prefix /usr/local
    make
    make install

Installation is now complete.

To uninstall type make uninstall from within the cb2Bib compilation directory.

Note: If the ./configure step would fail while having the appropriate Qt libraries and utilities installed, try qmake instead of ./configure, and configure manually the required file directories once cb2Bib first starts.

Note: Use the ./configure –help command for a detailed list of configuration options. Among them, choosing an appropriate compression library, LZ4, LZO, or SSE4 based LZSSE, and setting instruction set to AVX2 on capable CPUs, will improve cb2Bib search performance.

 

Installing on Unix systems (RPM)

To build an appropriate RPM for your platform, type, e. g.,

rpm –rebuild –target=i686 cb2bib-2.0.3-0.src.rpm

or a distro-dependend, equivalent command (perhaps rpmbuild). This will compile cb2Bib and build the required binary RPM (often placed at the /usr/src/packages/RPMS/i686 directory). See also Release Note cb2Bib 0.6.90 regarding QTDIR environment if having compilation problems. Once the binary RPM is build, installation is as follows.

To install your RPM binary, simply type

rpm -Uhv cb2bib-2.0.3-0.i686.rpm

To uninstall, type

rpm -e cb2bib-2.0.3

 

Installing on Debian systems (deb)

To install cb2Bib, first make sure that you are actually using the packages for the proper Debian suite, as configured in the /etc/apt/sources.list file.

Next, issue the following commands as root,

apt-get update

apt-get install cb2bib

to resolve all required dependencies and install the program.

 

Installing on Windows systems

On Windows platforms installation is simple. Just launch the Windows Installer

cb2bib-2.0.3-install.exe

and follow the installation wizard indications. To uninstall, click the ‘Unistall’ icon.

 

Installing on Mac OS X

To install cb2Bib from its sources, make sure you have the following build tools on your system:

  • Qt toolkit version 5.7.0 or later from www.qt.io/download-dev

  • Apple’s XCode from developer.apple.com/xcode/

  • bin-utils via darwinports

  • Buiding with make/Makefile:
    Type on a shell window:

    tar -xzvf cb2bib-2.0.3.tar.gz
    cd cb2bib-2.0.3
    ./configure –prefix /Applications/cb2Bib –qmakepath /Developer/Tools/Qt/qmake
    make
    make install

  • Buiding with make/Makefile (no configure and no external compression):
    Type on a shell window if configure fails:

    tar -xzvf cb2bib-2.0.3.tar.gz
    cd cb2bib-2.0.3
    /Developer/Tools/Qt/qmake -config use_qt_zlib
    make

  • Buiding with XCode:
    Type on a shell window:

    tar -xzvf cb2bib-2.0.3.tar.gz
    cd cb2bib-2.0.3
    /Developer/Tools/Qt/qmake cb2bib.pro -spec macx-xcode

    Open cb2bib.xcodeproj with XCode and build from there.

Note: It has been reported that qmake does not make usable XCode projects from subdir qmake projects. It is possible to produce one-single .pro file for the whole project, by typing qmake -project -r to create a base .pro file. An example and detailed instructions can be found at ./qmake/cb2bib-osx.pro.

See also Configuration.