Beyond Linux From Scratch - Version 6.2.0

Chapter 34. Individual Office Programs

GnuCash-1.8.12

Introduction to GnuCash

GnuCash is a personal finance manager.

Package Information

Additional Downloads

GnuCash Dependencies

Required

GtkHTML-1.1.7, libghttp-1.0.9, G-Wrap-1.3.4, and XML::Parser-2.34

Optional

PostgreSQL-8.1.3, Guppi-0.40.3, ScrollKeeper-0.3.14, Doxygen-1.4.6, Graphviz-2.8, Guile-www, and Electric Fence

Optional (for On-Line Banking)

LibOFX (requires OpenSP-1.5.2 and cURL-7.15.3), KtoBlzCheck, and AqBanking (requires Gwenhywfar and also see libchipcard2)

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/gnucash

Installation of GnuCash

Install GnuCash by running the following commands: 

sed -i 's/^host_os=.*$/&-gnu/' configure &&
./configure --prefix=/opt/gnome-1.4 \
            --sysconfdir=/etc \
            --disable-guppi \
            --disable-error-on-warning &&
make

To test the results, issue make check. All tests should pass. An easy way to look at the results of the tests is to issue grep -A1 ============== check.log (this is assuming you redirected the output from the tests to the aforementioned filename).

Now, as the root user: 

make install

If desired, create a symbolic link from the GnuCash documentation directory to the system-wide documentation directory using the following command as the root user: 

ln -v -s /opt/gnome-1.4/share/gnucash/doc \
         /usr/share/doc/gnucash-1.8.12

If desired, create symbolic links to the GnuCash .desktop and icon files in the system-wide directories using the following commands as the root user: 

install -v -m755 -d /usr/share/pixmaps/gnucash &&
ln -v -s /opt/gnome-1.4/share/pixmaps/gnucash/gnucash-icon.png \
         /usr/share/pixmaps/gnucash &&
ln -v -s /opt/gnome-1.4/share/gnome/apps/Applications/gnucash.desktop \
         /usr/share/applications

If you want to install the Help documentation (requires ScrollKeeper-0.3.14 to be installed), unpack the additional tarball, change into the gnucash-docs-1.8.5 source directory and issue the following commands as an unprivileged user: 

./configure --prefix=/opt/gnome-1.4 \
            --localstatedir=/var/lib &&
make

Now, as the root user: 

make install

Command Explanations

sed -i 's/^\(host_os=.*\)$/\1-gnu/' configure: This command is used to fix a broken configure script. Without it, no shared libraries are built, and the program will not function properly.

--prefix=/opt/gnome-1.4: GnuCash-1.8.12 is a GNOME-1.4 application.

--sysconfdir=/etc: This installs configuration files in /etc/gnucash instead of /opt/gnome-1.4/etc/gnucash.

--localstatedir=/var/lib: This parameter is used so that all ScrollKeeper files are installed in, and the ScrollKeeper database is properly updated in /var/lib/scrollkeeper instead of some files being installed in $GNOME_PREFIX/var/scrollkeeper.

--disable-guppi: This compiles GnuCash without support for creating GUI graphs and plots. Remove this option if you have Guppi installed.

-disable-error-on-warning: Without this parameter the build will fail because a warning is generated. This option forces the build to ignore the warning.

--enable-sql: This parameter is required if you want to build in SQL support using PostgreSQL.

--enable-ofx: This parameter is required if you want to build in on-line banking support using LibOFX.

--enable-hbci: This parameter is required if you want to build in on-line banking support using AqBanking. See doc/README.HBCI in the GnuCash source tree for complete information.

Configuring GnuCash

Configuration Information

If you wish to use GnuCash to retrieve stock price quotes and stock historical information, you'll need to install the following Perl modules: libwww-perl-5.805, Date::Manip-5.44, HTML::Parser-3.54, Finance::Quote-1.11 and Finance::QuoteHist-1.07.

Contents

Installed Programs: dump-finance-quote, gnc-prices, gnc-test-env, gnucash, gnucash-config, gnucash-env, gnucash-make-guids, gnucash-run-script and update-finance-quote
Installed Libraries: libcore-utils.so, libgnc-app-file-gnome.so, libgncgnome.so, libgncmodule.so, libgw-core-utils.so, libgw-gnc.so and numerous support libraries installed in /opt/gnome-1.4/lib/gnucash
Installed Directories: /etc/gnucash, /opt/gnome-1.4/include/gnucash, /opt/gnome-1.4/lib/gnucash, /opt/gnome-1.4/libexec/gnucash, /opt/gnome-1.4/share/gnome/apps/Applications, /opt/gnome-1.4/share/gnome/help/gnucash, /opt/gnome-1.4/share/gnucash, /opt/gnome-1.4/share/omf/gnucash-docs and /opt/gnome-1.4/share/pixmaps/gnucash

Short Descriptions

gnucash

is a personal finance manager.

Last updated on 2006-06-26 10:45:37 -0500