Difference between revisions of "De/Installation"

Revision as of 15:28, 22 September 2019

Zurück zur Hauptseite

GnuCash-Installation

GnuCash ist für mehrere Plattformen verfügbar, darunter - in historischer Folge - Linux, FreeBSD, MacOS X, Windows.

Da sich das Vorgehen für die Installation zwischen den verschiedenen Betriebssystemen und Distributionen unterscheidet, soll es dort erläutert werden.

Optionales Zubehör

Für bestimmte Merkmale ist optionales Zubehör aus eigenständigen Projekten erforderlich, deren Entwickler mehr oder weniger eng mit den GnuCash-Entwicklern zusammenarbeiten:

• Online-Banking via HBCI kann GnuCash über die zusätzliche Installation von Aqbanking bewerkstelligen. Bei einigen Distributionen wird es automatisch mit installiert. Ein Teil der Programme und Libraries von Aqbanking sind unabhängig von GnuCash, sie können auch von anderen Programmen wie zum Beispiel QBankManager verwendet werden.

• Für Online-Börsenkursabfragen ist das Perl-Modul Finance::Quote zuständig, welches wiederum die Installation einer Perl-Umgebung erfordert.

• Seit Version 2.3 können GnuCash-Daten neben dem traditionellen XML-Dateiformat auch in verschiedenen SQL-DBMS gespeichert werden, was eine Auswertung erleichtern kann. Dafür ist die Installation folgender Pakete zusätzlich erforderlich:
  • mindestens ein SQL-Programm
    • für Einsteiger geeignet SQLite,
    • für erfahrene Datenbank-Administratoren das schnelle MySQL oder das mächtige PostgreSQL
  • libdbi
  • der zum jeweiligen SQL-Programm gehörige libdbi-* Treiber. Die Namensgebung variiert leider zwischen den verschiedenen Distributionen. Häufig enthalten sie ein dbd, was wohl für data base driver steht, im Namen.

Da sich das Vorgehen für die Installation zwischen den verschiedenen Betriebssystemen und Distributionen unterscheidet, soll es unten in jeweils eigenen Abschnitten erläutert werden.

Daneben gibt es noch einige nützliche Hilfsmittel von unabhängigen Dritten, die in einem eigenen Abschnitt erläutert werden.

Vorab sollen aber ein paar Sicherheitsaspekte angerissen werden.

Sicherheitsaspekte

Die Entwickler sind der Meinung, dass man eine so kritische Anwendung, der man etwa beim Einsatz von HBCI sein Geld anvertraut, aus Sicherheitsgründen grundsätzlich selbst kompilieren sollte, um nicht etwa einen Keylogger untergeschoben zu bekommen. Wer das nicht kann oder will, sollte sich also etwa die folgenden Fragen stellen:

• Kann ich dem Ersteller des "binären" Paketes soweit vertrauen, dass er mir nicht an mein Konto geht?
• Sind sein Server und eventuelle Spiegelserver so gut gesichert, dass dort niemand drittes gefälschte Pakete unterschieben kann?

Damit soll jetzt keinem Paketbauer irgendetwas unterstellt werde, sondern lediglich auf eine grundsätzliche Problematik hingewiesen werden. Im Gegenteil sei ihnen einmal ausdrücklich gedankt, da es ohne ihre Arbeit für viele Anwender sehr schwierig wäre, das Programm korrekt zu installieren.

Linux

Die Linux-Versionen werden derzeit am besten unterstützt. Die Installation des Paketes und seiner Abhängigkeiten erfolgt üblicherweise über die jeweils verfügbare Paketverwaltung (wie Synaptic, PackageKit, u.a.).

Der "normale" Benutzer sollte sich zunächst einmal mit der meist

• mitgelieferten Version seiner Distribution vertraut machen. Falls man dann feststellt, dass darin ein Merkmal unzureichend ist, sollte man recherchieren, ob es
• für die jeweilige Distribution nicht schon fertige, von Freiwilligen aktualisierte Pakete gibt.
• Für Linux-Nutzer, deren Distribution zu alt ist, gibt es seit 2019 auch Flatpaks.
• Erst, wenn das nicht zum Erfolg führt, sollte man sich daran begeben, das Programm selbst zu bauen.

Hinweis

Pakete, die für andere Distributionen gepackt wurden, funktionieren in der Regel nicht, da es trotz Normierungsbestrebungen wie im File Hierarchy Standard (FHS) u.a. teils erhebliche Unterschiede gibt.

DEB-basierte Distributionen

Notiz: Während der vergangenen 7 Jahre war die englische Installationsanleitung stets umfangreicher und aktueller als die deutsche Version, ggf. lohnt sich ein Blick darauf: Debian. Dort ist auch beschrieben, wie man GnuCash samt Abhängigkeiten aus den Quellen selbst kompilieren kann.

Noch eine Notiz: Vor mehreren Jahren gab es aufgrund von lizenzrechtlichen Problemen einmal GnuCash-Versionen ohne Onlinebankingfunktionalität. Dies ist nicht mehr der Fall. Sie finden in allen aktuellen Paketquellen ein "ganz normales" GnuCash.

Aktuell ist diese (deutsche) Dokumentation auf dem Stand 12/2014.

Debian

Betreffend die Aktualität der Debian-Versionen sei auf die Wikipedia-Seite von Debian verwiesen (12/2014: Stable = Debian 7 Wheezy). Welche GnuCash Version in welcher Debian-Distribution erhältlich ist kann auf der gnucash-Paketseite nachgesehen werden.

Debian 7 Wheezy

Alle benötigten Pakete sind vorhanden; die Installation von GnuCash 2.4.10 (inkl. Dokumentation und Abhängigkeiten) erfolgt über den Befehl:

aptitude install gnucash

Fertig.

Allerdings sind die Pakete nicht besonders aktuell. Es empfiehlt sich daher, die Version aus dem wheezy-backports repository zu installieren. Dazu muss in der Datei /etc/apt/sources.list der folgende Eintrag stehen (oder äquivalent):

deb ftp://ftp.de.debian.org/debian/ wheezy-backports main

Dann lässt sich die GnuCash-Version 2.6.4 mit folgenden Befehlen installieren:

aptitude update
aptitude -t wheezy-backports install gnucash

Achtung! Dadurch wird auch eine aktuellere Version von AqBanking installiert. Wenn AqBanking bereits mit anderen Programmen genutzt wird, werden diese danach wahrscheinlich nicht mehr funktionieren. Benutzen Sie in diesem Fall lieber das etwas veraltete GnuCash.

Ubuntu

Unter Ubuntu kann GnuCash durch einen Klick auf den folgenden Link installiert werden, wenn apturl aktiviert ist: apt://gnucash.

Ansonsten findet sich hier eine Ubuntu-spezifische Anleitung: [1], deren Kurzfassung lautet: Führe folgenden Befehl aus:

sudo aptitude install gnucash

Welche Version von Ubuntu aktuell ist, findet man im Wikipedia-Artikel zu Ubuntu. Welche GnuCash-Version mit welcher Ubuntu-Version ausgeliefert wird, findet man auf der gnucash-Paketseite.

RPM-basierte Distributionen

Hierunter fallen etwa

• ALTLinux,
• Fedora/RedHat,
• Mandriva/Mandrake,
• [Open|Novell-|]SuSE,
• PCLinuxOS.

mit yum

Um GnuCash mit allen Abhängigkeiten aus den jeweiligen Repositorien zu installieren, genügt meist ein beherztes:

yum install gnucash

Sofern der Distributor kein (halbwegs aktuelles) Paket mitliefert, kann man danach mit der Suche von http://rpm.pbone.net/ recherchieren, indem man etwa "gnucash-2.4" als Suchtext eingibt.

mit yast

• siehe GnuCash in openSUSE

Seit Sommer 2012 klappt die Kommunikation mit dem Maintainer, wodurch es aktuelle Pakete in die Release und den openSUSE BuildService - GNOME:Anwendungen schaffen. Beim Einbinden als Repositorium sollte das Unterverzeichnis der eigenen Release in dem Link ausgewählt werden.

Zuvor gab es häufig deutlich aktuellere Pakete im Factory-Repositorium von J. Engel sind. Falls die eigene Distribution nicht zu alt ist, könnte es klappen, nach Einbinden des Repos, GnuCash und etwa AqBanking daraus zu aktualisieren, ohne daß es zu unauflösbaren Abhängigkeitskonflikten kommt. Daumendrück!

Ansonsten kann man auch eine Ebene höher nachsehen, ob nicht in den versionsspezifischen Verzeichnissen was passendes ist.

Weitere Distributionen

GnuCash ist auf folgenden Distributionen ebenfalls verfügbar

• Foresight Linux (2.2.3)
• Gentoo Linux Gentoo Homepage, GnuCash Paket in Gentoo

MacOS X

Laut https://lists.gnucash.org/pipermail/gnucash-devel/2008-January/021942.html gab es zu der Zeit keine selbstständigen vorkompilierten Pakete für MacOS X, was sich jedoch inzwischen geändert hat, siehe #Quartz (GTK-OSX).

Unter Fink oder MacPorts findet man die notwendige Infrastruktur, um Gnucash und alle zum Bau benötigten Pakete herunterzuladen und zu installieren. Allerdings dauert es eine Weile, da alles kompiliert wird, inklusive der benötigten Pakete. Und man braucht das Developer-Paket für den Mac.

• englische Seite
• schrittweise Anleitung von David T.

Fink

Die wesentlichen Schritte der Installation, nach den beiden o.g. Seiten kann man als Quick-Anleitung so zusammenfassen:

1) Installiere X11 & Developer Tools von Apple zusätzlich auf deinen Mac. Diese sind auf der Installations-CD/DVD drauf.

2) Downloade FINK, das ist das Programm, dass dann vom Code ein Programm macht.

• Downloadseite von Fink

3) Dann noch Fink Commander installieren: Downloadseite Finkcommander

3b) Bei dem Finkcommander gibt es noch ein kleines Path-Tool. Das solltest man einmal starten.

4) Fink Commander: Ist eine Art Download Center für "portierte Programme aus der Linux-Welt", die unter OSX installierbar sind. Dieses Tool erst einmal mit den Menu Befehlen selfupdate und update all auf den Stand bringen.

4b) In den Preferences von Fink Commander einstellen, dass

• a) Bei Fragen immer Vorschlag von Fink als Antwort verwenden,
• b) Pakete aus Unstable verwenden und
• c) Cyrpot Pakete aus Unstable verwenden.

5) Gnucash in die Suchbox eingeben, neueste Version anklicken und install (oben links Icon mit dem h) drücken.. das dauert dann etwas... (darunter sollte man schon verstehen, dass die komplette Installation schon ein paar Stunden (mal über Nacht laufenlassen auf meinem Mac Mini (1.83 Ghz Intel Core Duo) gedauert hat. Das hängt halt auch davon ab, wieviel GNU-Elemente man z.B. schon aus anderen Installation hat.

6) X11 starten

7) gnucash eingeben und das Ding startet...

Mac Installation mit Fink auf Englisch.

Da sind die Prozesse noch mal beschrieben.

Darwin-/MacPorts

DarwinPorts ist eine Alternative zu Fink ...

• MacPorts Anleitung auf Englisch.

Um Erfahrungsberichte, Übersetzung oder Ergänzungen wird gebeten.

Quartz (GTK-OSX)

Seit 2009 gibt es auch .DMGs für Quartz (GTK-OSX)

• englische Anleitungen zu MacOSX/Quartz.

Dies enthält [in neueren Versionen] auch UpdateFinanceQuote, um Finance::Quote zu installieren oder aktualisieren. In dem davon aufgerufenen CPAN kann man nach Auswahl der Region, um einen nahegelegenen Mirror-Server einzustellen, bei allen weiteren Fragen einfach die Vorgabe bestätigen, um zu einer brauchbaren Installation zu kommen.

Um Erfahrungsberichte, Übersetzung oder Ergänzungen wird gebeten.

Windows

Seit der Version 2.2.0 gibt es auch eine Windows-Variante von GnuCash. Dazu gibt es im Windows-Artikel (auf englisch) bzw. FAQ.

Installation des kompilierten Pakets

Das Installationsprogramm steht auf Sourceforge zum downloaden bereit.

Neben diesem offiziellen gibt es wohl auch noch ein Paket von portableapps.com, welches speziell dafür ausgelegt ist, in der gleichnamigen Suite vom USB-Stick zu laufen.

Installation aus den Quellen

Auf der englischen Wiki-Seite befindet sich eine Installationsanleitung, in der beschrieben wird, wie man GnuCash mit Online-Banking selbst kompiliert, also praktisch von null anfängt. Das Verfahren funktioniert (wenn alles gut geht) bis auf ein oder zwei Benutzereingaben automatisch.

Kurzer Überblick:

1. Download des Installationsverzeichnis aus dem SVN. Das Verzeichnis win32 sollte nicht unterhalb des Standard-Installationsverzeichnis C:\soft\ abgelegt werden
2. README lesen, bei Bedarf custom.sh anlegen und editieren (den oberen Kommentarblock aus defaults.sh einkleben)
3. MSys installieren nach C:\soft\msys. Die Frage Postinstall mit N beantworten.
4. Wget ablegen unter C:\soft\downloads
5. Entweder Qt herunterladen, installieren und die QTDIR in custom.sh setzen oder in custom.sh "AQBANKING_WITH_QT=no" setzen. Im letzteren Fall baut man ohne HBCI-Unterstützung
6. Msys starten (Achtung: In der Umgebungsvariable PATH sollten keine weiteren GNU-Portierungen wie cygwin stehen!)
7. install.sh im win32-Verzeichnis ausführen (Tipp: Mit install.sh 2>&1|tee install.log kann man die Bildschirmausgaben mitschneiden)
8. Alle benötigten Pakete werden automatisch heruntergeladen, sofern notwendig kompiliert und installiert. Wenn man dabei zwischendurch nach Pfadangaben gefragt wird, sollte man den im Msys-Fenster angegebenen Wert eingeben.
9. Wenn alles glatt ging, kann nach einigen Stunden /c/soft/gnucash/bin/gnucash im Msys-Fenster gestartet werden

Weitere Hinweise und eine vollständige Anleitung findet man auf der englischen Windows Seite.

Installation des optionalen Zubehörs

Um die im folgenden beschriebenen Komponenten braucht man sich nur zu kümmern, wenn man sie auch verwenden will.

Online-Kursabfrage Finance::Quote

Man benötigt dazu ActivePerl (Version z.Zt. 5.16.3), welches hier heruntergeladen werden kann. (GnuCash 2.2.x benötigte ausdrücklich ActivePerl 5.8.) ActivePerl-Versionen vor 5.16.3 liefern unter Umständen auch frühere Versionen von Finance::Quote (F::Q). Die aktuelle Version z. Zt. ist 1.18.

Danach Start->Programme->GnuCash->"Online-Kursabruf installieren" anklicken. Oft erscheint folgender Fehler:

 Check Perl
 Install DateManip
 Downloading ActiveState Package Repository packlist...not found
 ppm install failed: Can't find any package that provide DateManip

Lösung: Gnucash\bin\install-fq-mods.bat editieren und das Wort "DateManip" durch "Date-Manip" ersetzen (Bindestrich!!, es gab eine Namensänderung!)

(aus: https://lists.gnucash.org/pipermail/gnucash-user/2008-September/026638.html)

Einrichtungsassistent für Online Banking (AqBanking)

Lediglich bei GnuCash 2.2.0 war es erforderlich, zuvor die Qt-Bibliothek in Form von qt-win-opensource-4.x.y-mingw.exe von TrollTech herunterzuladen und zu installieren. Für GnuCash 2.2.1 und folgende ist das aber nicht mehr nötig, da nun bereits entsprechende Bibliotheken enthalten sind.

Gegebenenfalls muß der Pfad zum Binärverzeichnis, etwa "C:\Qt\4.2.3\bin", noch der Umgebungsvariable PATH hinzugefügt werden.

Weitere nützliche Software für GnuCash von Drittanbietern

Bei der Verarbeitung der Daten nach GnuCash und aus GnuCash habe ich folgende Programme als hilfreich empfunden:

- Import von OpenOffice/Excel: Hier hilft Calc2QIF unter http://xl2qif.chez-alice.fr/calc2qif_en.php - das OpenOffice Makro exportiert die im Calc markierten Daten in das QIF Format. Dieses wiederum kann einfach ins GnuCash importiert werden. Ich nutze dies beispielsweise, um meine in CSV vorliegenden Kreditkartenabrechnungen hochzuladen.

- Export von GnuCash nach OpenOffice/Excel: GnuC2000 von Knut Gerwens unter http://www.alice-dsl.net/gnuc2ooo/save/gnuc2ooo_de/intro.html - das Makro exportiert die GnuCash Daten in eine OpenOffice Datenbank und damit kann man dann im OpenOffice Calc entsprechende Auswertungen basteln.

- Export der Kundenliste: in [2] hat Timo Ollech ein Python-Script dafür veröffentlicht. Durch Ersetzen von "gnc:GncCustomer" in Zeile 36 durch "gnc:GncVendor" sollte es auch möglich sein, die Lieferantenliste zu exportieren oder mit "gnc:GncEmployee" die Mitarbeiter-Liste. Eventuell ist aber noch die Feldliste anzupassen. Um Erfahrungsberichte wird gebeten.

GnuCash Update

Dazu gibt es bislang keine Doku. Wenn du etwas dazu beitragen möchtest, kannst du das Kapitel gerne erweitern. Auch wenns es nur stichpunktartig ist.

Grundsätzliches

Grundsätzlich sind die Entwickler bemüht, die Kontendatei abwärts-kompatibel zu halten. Das bedeutet, nach einem Update werden die Einstellungen automatisch übernommen. Der Anwender muss keine Anpassungen vornehmen.

Sicherheitsbewußte werden aber trotzdem spätestens jetzt ihre Daten sichern. Was dazu gehören kann, ist in De/Referenz#Welche Einstellungen GnuCash verwendet und wo sie gespeichert werden beschrieben.

GnuCash verfügt im Gegensatz zu vielen modernen Windowsprogrammen über keine integrierte Update-Funktionalität, da man das in der Linuxwelt dem jeweiligen Paketmanager überläßt. Diese Paketmanager sind grundsätzlich in der Lage ein Programm sauber durch eine neue Version zu ersetzen. Falls man keinen Paketmanager verwendet ist erst die alte Version - ggf. auch der optionalen Komponenten - zu deinstallieren, bevor die neue installiert werden kann - sonst gibt das Kuddelmuddel!

Zunächst teilt man dem Paketmanager die neue Installationsquelle (DVD, Online-Repositorium, ...) mit. Dann kann man loslegen, wobei man ggf. wieder der spezifischen Anleitung oben folgt.

Von Version zu Version

Hier sollen zu beachtende Besonderheiten zwischen verschiedenen Versionen erläutert werden.

Zwischen Hauptversionen, z.B. 1.x auf 2.x

Hier hat sich die interne Repräsentation grundlegend geändert. Dadurch sind keine großen Versionssprünge möglich - es sind also ggf. Zwischenschritte erforderlich. Also eine 1.x-Datei zunächst mit 2.0 [? noch mal in der Mailingliste recherchieren] öffnen und ggf. unter neuem Namen speichern, dann mit einer aktuellen Version öffnen und wieder speichern.

2.2.x auf 2.3.x/2.4.x

Migration von AqBanking 2 nach AqBanking 4

Die Konfigurationsdateien für das Online-Banking mit AqBanking haben sich geändert. Diese können auf der Befehlszeile mit

aqbanking-cli updateconf

konvertiert werden. Dabei ist sicherzustellen, dass noch keine Konfigurationsdateien für AqBanking 4 vorliegen, da das Update-Tool keine bestehenden Dateien überschreibt oder ergänzt.

Auf WinVista sind die Konfigurationsdateien für AqBanking 4 (enthalten ab 2.3.x) in dem Ordner "~\user\aqbanking" abgelegt, diejenigen für AqBanking 2 (enthalten in 2.2.9) in dem Ordner "~\user\.aqbanking". Diese Ordner können unsichtbar sein.

Hier die Antwortzeilen nach erfolgreicher Migration der Konfigurationsdateien von AqBanking 2 nach AqBanking 4 auf WinVista:

C:\Programme\gnucash-unstable\bin>aqbanking-cli updateconf

Config for AqBanking 4 not found, update needed (-55)
Config for AqBanking 3 not found (-51)
Config for AqBanking 2 found, importing
Your configuration seems to be ok. 

(Bem.: Ergänzung wenn die Migrationsfunktionalität zu der Installation hinzugefügt wird.)

Die nächsten Schritte

Wenn nun die Installation geschafft ist, und man ein zwar noch leeres, aber funktionsfähiges GnuCash vor sich hat, beginnt man mit der Konfiguration.

Zurück zur Hauptseite