Difference between revisions of "De/Installation"

From GnuCash
Jump to: navigation, search
(Online-Kursabfrage Finance::Quote)
m (Hilfe->Handbuch)
 
(34 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
[[Category:De|Installation]]
 
[[De/GnuCash | Zurück zur Hauptseite]]
 
[[De/GnuCash | Zurück zur Hauptseite]]
 
  
 
== GnuCash-Installation ==
 
== GnuCash-Installation ==
 
+
GnuCash ist für mehrere Plattformen verfügbar, darunter - in historischer Folge - Linux, FreeBSD, {{Mac}}, Windows.
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.
 
Da sich das Vorgehen für die Installation zwischen den verschiedenen Betriebssystemen und Distributionen unterscheidet, soll es dort erläutert werden.
  
 
=== Optionales Zubehör ===
 
=== 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:
 
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 [http://www.aquamaniac.de/aqbanking/qbanking.html QBankManager] verwendet werden.  
+
* '''Online-Banking''' via [[De/Online-Banking#FinTS|FinTs]] 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 [{{URL:AB}}rdm/projects/aqfinance/files AqFinance] verwendet werden.  
  
* Für '''Online-Börsenkursabfragen''' ist das Perl-Modul '''Finance::Quote''' zuständig, welches wiederum die Installation einer Perl-Umgebung erfordert.
+
* Für '''Online-Börsenkursabfragen''' ist das Perl-Modul '''Finance::Quote''' zuständig, welches wiederum die Installation einer Perl-Umgebung erfordert. Die Installation können Sie im [{{URL:docs}}de/gnucash-manual/finance-quote.html GnuCash-Handbuch] nachlesen.
  
 
* Seit Version 2.3 ''können'' GnuCash-Daten neben dem traditionellen [[De/Glossar#X|XML]]-Dateiformat auch in verschiedenen [[De/Glossar#S|SQL]]-[[De/Glossar#D|DBMS]] gespeichert werden, was eine Auswertung erleichtern kann. Dafür ist die Installation folgender Pakete zusätzlich erforderlich:
 
* Seit Version 2.3 ''können'' GnuCash-Daten neben dem traditionellen [[De/Glossar#X|XML]]-Dateiformat auch in verschiedenen [[De/Glossar#S|SQL]]-[[De/Glossar#D|DBMS]] gespeichert werden, was eine Auswertung erleichtern kann. Dafür ist die Installation folgender Pakete zusätzlich erforderlich:
 
** mindestens ein SQL-Programm
 
** mindestens ein SQL-Programm
 
*** für Einsteiger geeignet '''SQLite''',
 
*** für Einsteiger geeignet '''SQLite''',
*** für erfahrene Datenbank-Administratoren das schnelle '''MySQL''' oder das mächtige '''PostgreSQL'''
+
*** für erfahrene Datenbank-Administratoren das schnelle '''MySQL''', sein freier Fork '''MariaBD''' oder das mächtige '''PostgreSQL'''
 
** '''libdbi'''
 
** '''libdbi'''
 
** der zum jeweiligen SQL-Programm gehörige [http://libdbi-drivers.sourceforge.net/ '''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.
 
** der zum jeweiligen SQL-Programm gehörige [http://libdbi-drivers.sourceforge.net/ '''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.
Line 30: Line 28:
  
 
=== Sicherheitsaspekte ===
 
=== Sicherheitsaspekte ===
 
+
Die Entwickler sind der Meinung, dass man eine so kritische Anwendung, der man etwa beim Einsatz von HBCI sein Geld anvertraut, aus [{{URL:wp-de}}Homebanking_Computer_Interface#Verbesserungen_der_Sicherheit_durch_Nutzung_von_Chipkartenlesern Sicherheitsgründen] grundsätzlich selbst kompilieren sollte, um nicht etwa einen [{{URL:wp-de}}Keylogger Keylogger] untergeschoben zu bekommen. Wer das nicht kann oder will, sollte sich also etwa die folgenden Fragen stellen:
Die Entwickler sind der Meinung, dass man eine so kritische Anwendung, der man etwa beim Einsatz von HBCI sein Geld anvertraut, aus [http://de.wikipedia.org/wiki/Homebanking_Computer_Interface#Verbesserungen_der_Sicherheit_durch_Nutzung_von_Chipkartenlesern 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?
 
* 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?
 
* Sind sein Server und eventuelle Spiegelserver so gut gesichert, dass dort niemand drittes gefälschte Pakete unterschieben kann?
Line 38: Line 35:
  
 
=== Linux ===
 
=== 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.).
 
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. Erst, wenn das nicht zum Erfolg führt, sollte man sich daran begeben, das Programm selbst zu bauen.  
+
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. Häufig gibt es dafür auch separate Repositorien, die <tt>Update</tt> oder <tt>Backport</tt> heißen.
 +
* Für Linux-Nutzer, deren Distribution zu alt ist, gibt es seit 2019 auch [[De/Flatpak|Flatpak]]s.
 +
* Erst, wenn das nicht zum Erfolg führt, sollte man sich daran begeben, das Programm selbst zu bauen.  
  
Pakete, die für andere Distributionen gepackt wurden, funktionieren in der Regel nicht, da es trotz Normierungsbestrebungen wie im [[Metawikipedia:de:Filesystem_Hierarchy_Standard | File Hierarchy Standard (FHS)]] u.a. teils erhebliche Unterschiede gibt.
+
;Hinweis: Pakete, die für andere Distributionen gepackt wurden, funktionieren in der Regel nicht, da es trotz Normierungsbestrebungen wie im [[Metawikipedia:de:Filesystem_Hierarchy_Standard | File Hierarchy Standard (FHS)]] u.a. teils erhebliche Unterschiede gibt.
  
 
==== DEB-basierte Distributionen ====
 
==== 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.
  
''Bitte an die Spezialisten:'' Ergänzt doch mal in diesem Kapitel die Decknamen mindestens mit ''Versionsnummern'', besser noch zusätzlich dem ''Support-Zeitraum'', damit auch weniger Eingeweihte erkennen können, wie (ver-)alt(-et) ein Absatz ist und ob er ins Archiv verschoben werden kann. Anschließend sollte dieser Absatz wieder entfernt werden.
+
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 =====
 
===== Debian =====
 +
Betreffend die Aktualität der Debian-Versionen sei auf die [{{URL:wp-de}}Debian#Versionsgeschichte Wikipedia-Seite von Debian] verwiesen (12/2014: Stable = Debian 7 ''Wheezy''). Welche GnuCash Version in welcher Debian-Distribution erhältlich ist kann auf der [https://packages.debian.org/search?keywords=gnucash gnucash]-Paketseite nachgesehen werden.
  
Da sich mit gnucash-1.8.10 die HBCI-Bibliothek geändert hat, erfordert das Paket gnucash-hbci nun seinerseits die neuen Pakete der AqBanking-Familie. Diese haben es nicht in die Sarge-Veröffentlichung geschafft, in debian/unstable sind die Pakete (mit aqbanking 2.x) vorhanden (Stand: Juli 2006).
+
====== 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:
Die aktuelle Version Debian 5.0 (Lenny) enthält GnuCash 2.2.6
+
<pre>aptitude install gnucash</pre>
 
+
Fertig.
GnuCash-HBCI kann leider im Augenblick aus Gründen der Debian-Lizenzpolitik (GPL+OpenSSL - nicht für AqBanking, sondern alle GnuCash-Dependencies)  NICHT in das offizielle Debian-Archiv aufgenommen werden. Inoffizielle Pakete gibt es aber (siehe unten). Wer mit überschüssigen Programmierressourcen ein GnuTLS/GCrypt-Verschlüsselungs-Plugin für Gwenhywfar implementieren will, würde dieses Lizenzdilemma lösen.
 
 
 
====== Debian 3.1 (Sarge) ======
 
 
 
Alle benötigten Pakete gibt es mit dem sources.list Eintrag:
 
  deb http://aqbanking.alioth.debian.org/debian/ stable/
 
Damit kann per  aptitude install gnucash-hbci  das Paket mitsamt den Abhängigkeiten installiert werden.
 
 
 
Zur Unterstützung von HBCI-Chipkarten braucht man noch LibChipCard:
 
 
 
# Die Plugins für gwenhywfar (libchipcard2-libgwenhywfar38-plugins)
 
# Einen erreichbaren chipcard deamon (libchipcard2-tools).
 
# Auf dem Rechner mit dem chipcardd einen Hardwaretreiber des ChipcardTerminals.
 
 
 
====== Debian 5.0 (Lenny) ======
 
 
 
Im aktuellen Stable release gibt es:
 
 
 
gnucash - Version 2.2.6
 
aqbanking - Version 3.6.2
 
aqbanking-tools
 
libaqhbci13 -Version 3.6.2
 
 
 
gnucash-hbci wird nach meiner Erkenntnis durch Aqhbci ersetzt
 
 
 
(Stand Juli 2009)
 
 
 
====== Unstable (Sid) ======
 
  
Bis auf gnucash-hbci selbst sind in debian/unstable alle benötigten Pakete vorhanden. Ersteres gibt es auf
+
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): <pre>
  deb http://aqbanking.alioth.debian.org/debian/ unstable/
+
deb ftp://ftp.de.debian.org/debian/ wheezy-backports main
 
 
Sollte dieses nicht installierbar sein, freut sich der Packbandausroller über einen Hinweis an die einschlägigen Listen. Für die zu installierenden Pakete gilt das gleiche wie für debian/stable.
 
 
 
aqbanking-tool ist in unstable nun (01.01.2008) durch aqbanking-tools abgelöst, welches aqbanking3 repräsentiert. Aqbanking3 wird noch nicht von gnucash [-hbci] unterstützt.
 
 
 
====== Downgrade aqbanking in sid ======
 
 
 
folgende Zeilen in die /etc/apt/sources.list eintragen:
 
<pre>    
 
  #gnucash hbci                                                                                                                           
 
                                                                                                                                           
 
  # downgrade aqbanking --> check /etc/preferences                                                                                       
 
  deb http://snapshot.debian.net/archive/2007/12/01/debian unstable main contrib non-free                                                 
 
                                                                                                                                           
 
  # prebuild gnucash-hbci                                                                                                                 
 
  deb http://aqbanking.alioth.debian.org/debian/ unstable/                                                                               
 
  #deb-src http://aqbanking.alioth.debian.org/debian/ unstable/ 
 
 
</pre>
 
</pre>
 
+
Dann lässt sich die GnuCash-Version 2.6.4 mit folgenden Befehlen installieren: <syntaxhighlight lang="sh">
folgendes in /etc/apt/prefences eintragen:
+
aptitude update
<pre>   
+
aptitude -t wheezy-backports install gnucash
          Package: aqbanking-tools
+
</syntaxhighlight>
          Pin: version 2.3.*
+
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.
          Pin-Priority: 1001
 
         
 
          Package: aqbanking-tool
 
          Pin: version 2.3.*
 
          Pin-Priority: 1001
 
         
 
          Package: aqbanking16-qt-wizard
 
          Pin: version 2.3.*
 
          Pin-Priority: 1001
 
         
 
          Package: libaqbanking-data
 
          Pin: version 2.3.*
 
          Pin-Priority: 1001
 
         
 
          Package: libaqbanking-plugins-libgwenhywfar38
 
          Pin: version 2.3.*
 
          Pin-Priority: 1001
 
         
 
          Package: libaqbanking16
 
          Pin: version 2.3.*
 
          Pin-Priority: 1001
 
         
 
          Package: libaqbanking16-dev
 
          Pin: version 2.3.*
 
          Pin-Priority: 1001
 
         
 
          Package: libaqbanking-plugins-libgwenhywfar38
 
          Pin: version 2.3.*
 
          Pin-Priority: 1001
 
         
 
          Package: libchipcard2-libgwenhywfar38-plugins
 
          Pin: version 2.1.*
 
          Pin-Priority: 1001
 
         
 
          Package: libchipcard3-libgwenhywfar38-plugins
 
          Pin: version 3.0.*
 
          Pin-Priority: 1001
 
         
 
          Package: libgwenhywfar-data
 
          Pin: version 2.6.*
 
          Pin-Priority: 1001
 
         
 
          Package: libgwenhywfar38
 
          Pin: version 2.6.*
 
          Pin-Priority: 1001
 
         
 
          Package: libgwenhywfar38-dev
 
          Pin: version 2.6.*
 
          Pin-Priority: 1001
 
</pre>
 
         
 
dann
 
<pre>
 
  aptitude update
 
  dann aptitude aufrufen und die Pakete aktualisieren (downgraden)
 
  oder apt-get upgrade
 
</pre>
 
 
 
(ja, natürlich machst Du das auf Dein Risiko)
 
  
 
===== Ubuntu =====
 
===== Ubuntu =====
 +
Unter Ubuntu kann GnuCash durch einen Klick auf den folgenden Link installiert werden, wenn [https://wiki.ubuntuusers.de/apturl apturl] aktiviert ist: [[apt://gnucash]].
  
* [http://wiki.ubuntuusers.de/GnuCash GnuCash auf Ubuntu]
+
Ansonsten findet sich hier eine Ubuntu-spezifische Anleitung: [https://wiki.ubuntuusers.de/GnuCash], deren Kurzfassung lautet: Führe folgenden Befehl aus: <syntaxhighlight lang="sh">
 
+
sudo aptitude install gnucash
''Bitte an Experten:'' der folgende Punkt ist wohl langsam überholt. Kann da mal jemand die Version recherieren, wann das gelöst wurde, unten ergänzen und dann diesen Absatz entfernen.
+
</syntaxhighlight>
 
 
* Unter Ubuntu gibt es zwei Varianten. Die offizielle ist einfach das GnuCash - Paket zu installieren, das enthält aber kein Online-Banking (HBCI bzw AqBanking). Wenn man sein Repository ('''''/etc/apt/sources.list''''') aber erweitert, kann man GnuCash mit dem dazu passenden Aqbanking installieren. Inzwischen gibt es auf den Ubuntu-Seiten auch eine gute Beschreibung, wie man GnuCash mit Online-Banking installiert.
 
 
 
====== kubuntu 9.04 Jaunty Jackalope 2009/12 ======
 
 
 
''Installation von 'aqbanking 4.2.0''
 
 
 
sudo aptitude install aqbanking-tools libaqbanking-dev
 
sudo aptitude install libgcrypt11-dev pkg-config gnutls-dev libgmp3-dev kde-devel qt3-dev-tools
 
 
 
Im Internet unter:
 
 
 
  http://www2.aquamaniac.de/sites/download/packages.php?package=03&showall=1
 
 
 
das Paket:  <tt>aqbanking-4.2.0.tar.gz</tt> herunterladen und auspacken:
 
<pre>
 
# nicht alls root!!
 
 
 
tar xvzf aqbanking-4.2.0.tar.gz
 
cd aqbanking-4.2.0
 
./configure
 
</pre>
 
 
 
Am Ende des configure sollte das folgende erscheinen:
 
<pre>
 
Summary
 
----------------------------------------------------
 
AqBanking version      : 4.2.0.0stable
 
Local Installation Mode : no
 
Supported frontends    : qbanking
 
Cfg Search Folder      : $(sysconfdir)
 
Data Search Folder      : $(datadir)
 
Locale Search Folder    : $(localedir)
 
Symbol Visibility      : yes, gcc-4.3.3
 
Use KtoBlzCheck        : yes
 
Use AqFinance          : no
 
Build AqBanking-CLI    : yes
 
CLI Version String      : 4.2.0
 
 
 
Plugins
 
----------------------------------------------------
 
  Backends              : aqhbci aqnone aqofxconnect
 
  Im-/Exporters        : csv dtaus eri2 ofx openhbci1 swift xmldb yellownet sepa ctxfile
 
  Parsers              : dtaus swift
 
  Bank Infos            : at ca ch de us
 
</pre>
 
 
 
Danach kann man den aqbanking-wizard aufrufen:
 
 
 
  /usr/lib/aqbanking/plugins/29/wizards/qt3-wizard
 
 
 
Zum überprüfen der Version bitte auf den Tab "Module" klicken. Hier sollte jetzt 4.2.2 erscheinen.
 
 
 
 
 
'' Installation von gnucash 2.3.7 ''
 
 
 
* Download und auspacken mit
 
<pre>
 
wget http://downloads.sourceforge.net/sourceforge/gnucash/gnucash-2.3.7.tar.bz2
 
tar xvjf gnucash-2.3.7.tar.bz2
 
</pre>
 
 
 
* Erst einige Pakete installieren
 
<pre>
 
sudo aptitude install intltool guile guile-1.6-dev slib guile-1.6-slib libgconf2-dev libgtk2.0-dev
 
sudo aptitude install libgnomeui-dev libglade2-dev libgoffice-0-6-dev  libgtkhtml3.14-dev  gtkhtml3.8
 
</pre>
 
   
 
* configure
 
<pre>
 
cd gnucash-2.3.7
 
./configure --enable-aqbanking
 
</pre>
 
 
 
* das ergebnis:
 
<pre>
 
  Options detected/selected
 
  -------------------------
 
  gnucash version ...... : 2.3.7
 
  Build for host ....... : i686-pc-linux-gnu
 
  Optional components... :  aqbanking
 
  HTML engine .......... : gtkhtml
 
  Extra Warnings ....... :  -Wdeclaration-after-statement -Wno-pointer-sign -D_FORTIFY_SOURCE=2
 
  CPPFLAGS ............. :
 
  CFLAGS ............... :  -Wdeclaration-after-statement -Wno-pointer-sign -D_FORTIFY_SOURCE=2 -g -O2 -Wall -Wunused -Wmissing-prototypes -Wmissing-declarations -Wno-unused
 
  LDFLAGS .............. :
 
  prefix................ : /usr/local
 
  QOF support .......... : internal
 
  QOF location ......... : internal
 
  QOF library dir ...... :
 
  QOF backend config ... : /usr/local/gnucash/xml/qsf
 
</pre>
 
 
 
* jetzt ein make
 
<pre>
 
  make
 
</pre>
 
 
 
* make install als user root
 
<pre>
 
su -
 
cd /in/den/gleichen/pfad
 
make install
 
</pre>
 
 
 
* gnucash aufrufen:
 
<pre>
 
  /usr/local/bin/gnucash
 
</pre>
 
 
 
======  Kubuntu 9.10 Karmic Koala 2009/12 ======
 
 
 
'''Wichtig: Es geht hierbei nicht um die Installation einer '''stable''' Version von GnuCash. Die hier hier beschriebene Anleitung bezieht sich auf gnucash Version 2.3.3, die noch nicht ausreichend getestet ist, und es ist mit Abstürzen zu rechnen!'''
 
 
 
Ich habe heute gnucash mit hbci unter Ubuntu 9.10 kompiliert. Grund ist, dass in den derzeitigen ubuntu-paketen (aqbanking) noch kein RDH10 integriert ist, wie es zum Beispiel von der Volksbank Darmstadt und Bergstraße seit Oktober 2009 gefordert wird. Einzige Möglichkeit ist aqbanking 4.2.2 zusammen mit gnucash 2.3.3 zu installieren.
 
 
 
Es ist ein erster Versuch hier etwas zu dem neuen Release '''gnucash 2.3.3''' und '''aqbanking 4.2.2'''  mit dem neueren Verschlüsselungs-Protokoll '''RDH10''' beizusteuern.
 
 
 
Verbesserungen sind willkommen.
 
 
 
''Installation von  aqbanking 4.2.0''
 
 
 
Wichtig: gnucash mit HBCI benötigt ein installiertes aqbanking
 
 
 
* Packet von dieser Seite hier downloaden: 
 
** http://www2.aquamaniac.de/sites/download/packages.php?package=03&showall=1
 
 
 
* Als user root oder mit sudo das vorhergende aqbanking installieren.
 
<pre>
 
sudo aptitude install aqbanking-tools libaqbanking-dev
 
sudo aptitude install lib32gmp3-dev lib32gmpxx4 libgmp3-dev
 
sudo aptitude install kde-devel
 
sudo aptitude install qt3-dev-tools
 
</pre>
 
 
 
* Nun zum kompilieren von aqbanking
 
<pre>
 
# (Wichtig: nicht als root)
 
cd aqbanking-4.2.0
 
./configure
 
make
 
sudo make install
 
</pre>
 
 
 
 
 
* Überprüfen mit
 
<pre>
 
ls -la /usr/bin/aqhbci-tool4
 
ls -la /usr/bin/aqbanking-cli
 
ls -la /usr/bin/aqbanking-config
 
</pre>
 
 
 
 
 
''Installation von  gnucash 2.3.7''
 
 
 
* Download und auspacken mit
 
<pre>
 
wget http://downloads.sourceforge.net/sourceforge/gnucash/gnucash-2.3.7.tar.bz2
 
tar xvjf gnucash-2.3.7.tar.bz2
 
</pre>
 
 
 
 
 
* Als user root oder mit sudo wichtige libraries installieren.
 
<pre>
 
sudo aptitude install intltool guile guile-1.6-dev  guile-1.6-slib
 
 
 
sudo aptitude install libgtkhtml2-dev gtkhtml3.8
 
sudo aptitude install guile guile-1.6-dev slib libgoffice-0-8-dev libgoffice-0-8-common libgtkhtml3.8-dev
 
sudo aptitude install guile-1.6-slib libgconf2-dev libglade2-dev
 
sudo aptitude install libxml2-dev libpopt-dev libgtk2.0-dev libgnomeui-dev
 
sudo aptitude install libgtkhtml3.14-dev swig1.3
 
</pre>
 
 
 
 
 
* Gnucash Kompilieren:
 
<pre>
 
cd gnucash-2.3.7
 
./configure --enable-aqbanking
 
make
 
 
 
# als root anmelden
 
su -
 
cd ..../gnucash-2.3.7
 
make install
 
 
 
</pre>
 
 
 
====== Testing und Ubuntu ======
 
  
Es gibt keine eigenen Bemühungen, ubuntu jenseits der Debian-üblichen testing-Updates zu versorgen. Es ist damit zu rechnen, dass (die meiste Zeit) bei den fehlenden Paketen ohne Probleme auf die Versionen in debian/unstable zurückgegriffen werden kann.
+
Welche Version von Ubuntu aktuell ist, findet man im [{{URL:wp-de}}Ubuntu#Versionstabelle Wikipedia-Artikel zu Ubuntu].
 
+
Welche GnuCash-Version mit welcher Ubuntu-Version ausgeliefert wird, findet man auf der [https://packages.ubuntu.com/search?keywords=gnucash gnucash]-Paketseite.
Ubuntu hat seit Dapper AqBanking-Pakete. Allerdings hat die LibChipcard einen Bug bei der Erkennung von USB-Kartenlesern, und derzeit ist kein gnucash-hbci verfügbar, obwohl sich vermutlich die Pakete aus Debian/unstable relativ problemlos neu-übersetzen lassen.
 
 
 
===== Wenn man sein eigenes Paket aus den Debian-Quellen bauen möchte =====
 
 
 
Erstmal alle zum Kompilieren von GnuCash nötigen Programme (Abhängigkeiten) installieren, die in Ubuntu fertig zur Verfügung stehen:
 
  apt-get build-dep gnucash
 
Dann das aqbanking.alioth.debian.og unstable Repository in die /etc/apt/sources.list ergänzen:
 
  deb-src http://aqbanking.alioth.debian.org/debian/ unstable/
 
 
 
Jetzt die Abhängigkeiten, die zum Kompilieren von GnuCash mit HBCI benötigt werden, lokal aus den Quellpaketen kompilieren und installieren. Das geht in drei Schritten je Quellpaket:
 
 
 
Als user root jeweils:
 
#apt-get build-dep <Quellpaketname>
 
#apt-get -b source <Quellpaketname>
 
#dpkg -i <erzeugte Binärpakete>
 
 
 
Dies für folgende Quellpakete durchführen (in Klammern die erzeugten Binärpakete, die in Schritt 3 jeweils installiert werden müssen)
 
 
 
  libktoblzcheck (-2c, -bin, -dev)
 
  libgwenhywfar (38, -dev, -data)
 
  libchipcard2 (-0c2, -data, -dev, -libgwen-tools)
 
  libaqbanking (14_, 12-dev, -data, -plugins, aqhbci9, cbanking14, libqbanking4, libg2banking, ++0, libkbanking, libaqdtaus, libaqgeldkarte)
 
  libaqhbci-plugin-ddvcard (gleichlautend?)
 
 
 
Nun GnuCash wie folgt selbst kompilieren:
 
*Erstmal das normale GnuCash testweise kompilieren:
 
  $apt-get -b source gnucash
 
 
 
Das aktuelle gnucash tarball von alioth holen (Hier: gnucash-1.8.12.tar.gz) und dann in orig.tar.gz umbenennen:
 
  mv gnucash-1.8.12.tar.gz gnucash_1.8.12.orig.tar.gz
 
Quellen holen:
 
  dpkg-source -x gnucash*.dsc
 
Dann das kompilieren manuell anstossen:
 
  cd gnucash*
 
  dpkg-buildpackage -us -uc -d -rfakeroot
 
  cd ..
 
 
 
Noch ein paar fehlende Abhängigkeiten installieren:
 
  aptitude install psfontmgr libdate-manip-perl
 
Zum Schluss die erzeugten Pakete installieren:
 
  dpkg -i gnucash-hbci*.deb gnucash_1.8.12*.deb gnucash-common*.deb
 
 
 
(Falls nur noch eine zu neue slib Version in ubuntu bemängelt wird, kann einfach mit --force-depends die Installation erzwungen werden)
 
 
 
* Die Paketreihen libchipcard/libopenhbci/-plugin-ddvcard/aqmoney und libchipcard2/libaqhbci2/-qt-tools/-plugin-ddvcard/qbankmanager sind komplett parallel installierbar, allerdings muss man den alten chipcardd beenden (/etc/init.d/chipcard-tools stop), um mit QBankManager oder dem neuen GnuCash-HBCI zu arbeiten.
 
  
 
==== RPM-basierte Distributionen ====
 
==== RPM-basierte Distributionen ====
 
 
 
Hierunter fallen etwa  
 
Hierunter fallen etwa  
 
* ALTLinux,  
 
* ALTLinux,  
Line 422: Line 88:
  
 
===== mit yum =====
 
===== mit yum =====
 
 
Um GnuCash mit allen Abhängigkeiten aus den jeweiligen Repositorien zu installieren, genügt meist ein beherztes:  
 
Um GnuCash mit allen Abhängigkeiten aus den jeweiligen Repositorien zu installieren, genügt meist ein beherztes:  
 
  yum install gnucash
 
  yum install gnucash
Line 429: Line 94:
  
 
===== mit yast =====
 
===== mit yast =====
 
 
* siehe [http://de.opensuse.org/GnuCash GnuCash in openSUSE]
 
* siehe [http://de.opensuse.org/GnuCash GnuCash in openSUSE]
  
Line 439: Line 103:
  
 
==== Weitere Distributionen ====
 
==== Weitere Distributionen ====
GnuCash ist auf folgenden Distributionen ebenfalls verfügbar
+
Eine gute Übersicht über Distributionen bzw. Repositories mit GnuCash bietet Repology:  
 
 
* Foresight Linux (2.2.3)
 
* Gentoo Linux [http://www.gentoo.org/ Gentoo Homepage], [http://packages.gentoo.org/package/app-office/gnucash GnuCash Paket in Gentoo]
 
  
=== MacOS X ===
+
* [https://repology.org/project/gnucash/versions Letzte verfügbare Versionen von GnuCash]
  
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)]].
+
=== {{Mac}} ===
 +
Laut https://lists.gnucash.org/pipermail/gnucash-devel/2008-January/021942.html gab es zu der Zeit keine selbstständigen vorkompilierten Pakete für {{Mac}}, was sich jedoch inzwischen geändert hat, siehe [[#Quartz (GTK-OSX)]].
  
 
Unter [http://finkproject.org/ Fink] oder [http://www.macports.org/ 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.
 
Unter [http://finkproject.org/ Fink] oder [http://www.macports.org/ 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.
  
* [http://wiki.gnucash.org/wiki/MacOSXInstallation englische Seite]
+
* [[{{mac}}Installation]] in Englisch
 
* [http://article.gmane.org/gmane.os.apple.fink.beginners/20926 schrittweise Anleitung von David T.]
 
* [http://article.gmane.org/gmane.os.apple.fink.beginners/20926 schrittweise Anleitung von David T.]
  
 
==== Fink ====
 
==== Fink ====
 
 
Die wesentlichen Schritte der Installation, nach den beiden o.g. Seiten kann man als Quick-Anleitung so zusammenfassen:
 
Die wesentlichen Schritte der Installation, nach den beiden o.g. Seiten kann man als Quick-Anleitung so zusammenfassen:
  
Line 466: Line 127:
 
3b) Bei dem Finkcommander gibt es noch ein kleines '''Path-Tool'''. Das solltest man einmal starten.
 
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.
+
4) Fink Commander: Ist eine Art Download Center für "portierte Programme aus der Linux-Welt", die unter {{Mac}} 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  
 
4b) In den Preferences von Fink Commander einstellen, dass  
Line 482: Line 143:
  
 
Da sind die Prozesse noch mal beschrieben.
 
Da sind die Prozesse noch mal beschrieben.
 
  
 
==== Darwin-/MacPorts ====
 
==== Darwin-/MacPorts ====
 
 
DarwinPorts ist eine Alternative zu Fink ...
 
DarwinPorts ist eine Alternative zu Fink ...
* [[MacOSX/MacPortsDetail | MacPorts Anleitung auf Englisch]].
+
* [[{{mac}}/MacPortsDetail | MacPorts Anleitung auf Englisch]].
  
 
Um Erfahrungsberichte, Übersetzung oder Ergänzungen wird gebeten.
 
Um Erfahrungsberichte, Übersetzung oder Ergänzungen wird gebeten.
  
 
==== Quartz (GTK-OSX) ====
 
==== Quartz (GTK-OSX) ====
 
 
Seit 2009 gibt es auch .DMGs für Quartz (GTK-OSX)
 
Seit 2009 gibt es auch .DMGs für Quartz (GTK-OSX)
* [[MacOSX/Quartz | englische Anleitungen zu MacOSX/Quartz]].
+
* [[{{mac}}/Quartz | englische Anleitungen zu {{mac}}/Quartz]].
  
 
Dies enthält [in neueren Versionen] auch <code>UpdateFinanceQuote</code>, um [[De/Aktienhandel|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.
 
Dies enthält [in neueren Versionen] auch <code>UpdateFinanceQuote</code>, um [[De/Aktienhandel|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.
Line 501: Line 159:
  
 
=== Windows ===
 
=== Windows ===
 
 
Seit der Version 2.2.0 gibt es auch eine Windows-Variante von GnuCash.
 
Seit der Version 2.2.0 gibt es auch eine Windows-Variante von GnuCash.
 
Dazu gibt es im [[Windows]]-Artikel (auf englisch) bzw. FAQ.  
 
Dazu gibt es im [[Windows]]-Artikel (auf englisch) bzw. FAQ.  
 
  
 
==== Installation des kompilierten Pakets ====
 
==== Installation des kompilierten Pakets ====
 
 
Das '''Installationsprogramm''' steht auf Sourceforge zum [https://sourceforge.net/project/showfiles.php?group_id=192  downloaden] bereit.
 
Das '''Installationsprogramm''' steht auf Sourceforge zum [https://sourceforge.net/project/showfiles.php?group_id=192  downloaden] bereit.
  
Line 513: Line 168:
  
 
==== Installation aus den Quellen ====
 
==== Installation aus den Quellen ====
 
 
Auf der englischen Wiki-Seite befindet sich eine [http://wiki.gnucash.org/wiki/Windows#Instructions_for_an_.28almost.29_automated_build 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.
 
Auf der englischen Wiki-Seite befindet sich eine [http://wiki.gnucash.org/wiki/Windows#Instructions_for_an_.28almost.29_automated_build 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.
  
Line 528: Line 182:
  
 
Weitere Hinweise und eine vollständige Anleitung findet man auf der englischen [[Windows]] Seite.
 
Weitere Hinweise und eine vollständige Anleitung findet man auf der englischen [[Windows]] Seite.
 
  
 
==== Installation des optionalen Zubehörs ====
 
==== Installation des optionalen Zubehörs ====
 
 
Um die im folgenden beschriebenen Komponenten braucht man sich nur zu kümmern, wenn man sie auch verwenden will.
 
Um die im folgenden beschriebenen Komponenten braucht man sich nur zu kümmern, wenn man sie auch verwenden will.
  
 
===== Online-Kursabfrage Finance::Quote =====
 
===== Online-Kursabfrage Finance::Quote =====
 
+
Die Installation von Finance::Quote können Sie im [{{URL:docs}}de/gnucash-manual/finance-quote-install.html GnuCash-Handbuch] nachlesen.
Man benötigt dazu ActivePerl (Version z.Zt. 5.16.3), welches [http://www.activestate.com/activeperl/downloads 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 [http://finance-quote.sourceforge.net/ 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) =====
 
===== 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 [http://www.trolltech.com/developer/downloads/qt/windows TrollTech]
 
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 [http://www.trolltech.com/developer/downloads/qt/windows 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.  
 
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.  
Line 561: Line 198:
 
== Weitere nützliche Software für GnuCash von Drittanbietern ==
 
== 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:
+
Bei der Verarbeitung der Daten nach GnuCash und aus GnuCash raus können die folgende Tools auf der Seite [[De/Im-Export]] hilfreich sein.
 
 
- '''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 [https://lists.gnucash.org/pipermail/gnucash-de/2010-January/007177.html] hat Timo Ollech ein [http://de.wikipedia.org/wiki/Python_%28Programmiersprache%29 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.
 
  
 +
== GnuCash Up- und Downgrate ==
 
=== Grundsätzliches ===
 
=== Grundsätzliches ===
 +
;Update-Mechanismus: GnuCash verfügt im Gegensatz zu vielen Windowsprogrammen über keine integrierte Update-Funktion, 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.
 +
:;Löschen der alten Version: Falls man keinen Paketmanager oder das Windows-Installationsprogramm verwendet ist erst die alte Version - ggf. auch der optionalen Komponenten - zu deinstallieren, bevor die neue installiert werden kann - sonst gibt das Kuddelmuddel! ''Bitte ergänzen:'' Verhalten bei {{Mac}}?
  
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.  
+
;Versionsschema:
 
+
:;Seit GnuCash 3.0
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.
+
:: '''x.y''' mit x: ''Hauptversion'', y: ''Unterversion'' und
 
+
::: y < 900 ''Release'', sonst Vorschau der nächsten Hauptversion (= ''Beta''-Version)
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!
+
:;Bis GnuCash 2.6.x
 +
:: '''x.y.z''' mit x: Fundamentalversion, y: ''Hauptversion'', z: ''Unterversion'' und
 +
:::y gerade: ''Release'' und y ungerade: ''Beta''
 +
:;Hauptversionen: bringen grundlegende neue Merkmal, aber es können sich auch Abhängigkeiten, Speicherorte oder -formate, … ändern.
 +
::;Empfehlung: Vorher ''Datensicherung'', nachher ''Integritäts-Check'' durchführen.
 +
:;Unterversionen: enthalten im wesentlichen Fehlerbehebungen und Verbesserungen ohne strukturelle Änderungen.
 +
;Aktionen:
 +
:;Downgrading: Grundsätzlich ist nur bei der ''letzte Unterversion'' einer alten Hauptversion gewährleistet, daß sie alle Merkmale der nächsten Hauptversion fehlerfrei lesen kann. Speichern wird sie aber nur die alten Merkmale, wodurch diese Datei dann von älteren Versionen "verstanden" wird.
 +
:;Datensicherung: Was dazu gehören kann, ist in [[De/Referenz#Welche Einstellungen GnuCash verwendet und wo sie gespeichert werden]] beschrieben.
 +
:;Integritäts-Check: Überprüfung der Daten-Integrität für die aktuelle Programm-Version:
 +
::# In jedem GnuCash-Buch einmal <tt>Aktionen->Überprüfen->Alle überprüfen</tt> durchlaufen lassen, was sehr zeitaufwendig sein kann. Beim Abbruch muß man das nächste mal leider wieder von vorn beginnen.
 +
::# Anschließend <tt>Datei speichern</tt>.
  
 
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.
 
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 ===
 
=== Von Version zu Version ===
 
 
Hier sollen zu beachtende Besonderheiten zwischen verschiedenen Versionen erläutert werden.
 
Hier sollen zu beachtende Besonderheiten zwischen verschiedenen Versionen erläutert werden.
  
==== Zwischen Hauptversionen, z.B. 1.x auf 2.x ====
+
==== 2.2.x auf 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 <Syntaxhighlight lang ="sh">
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.
+
aqbanking-cli updateconf
 
+
</Syntaxhighlight>
==== 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.  
 
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.
+
Auf WinVista sind die Konfigurationsdateien für AqBanking 4 (enthalten ab 2.3.x) in dem Ordner <tt>~\user\aqbanking</tt> abgelegt, diejenigen für AqBanking 2 (enthalten in 2.2.9) in dem Ordner <tt>~\user\.aqbanking</tt>. Diese Ordner können unsichtbar sein.
  
Hier die Antwortzeilen nach erfolgreicher Migration der Konfigurationsdateien von AqBanking 2 nach AqBanking 4 auf WinVista:
+
Hier die Antwortzeilen nach erfolgreicher Migration der Konfigurationsdateien von AqBanking 2 nach AqBanking 4 auf WinVista: <Syntaxhighlight lang ="console">
 +
$ 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.
 +
</Syntaxhighlight>
  
C:\Programme\gnucash-unstable\bin>aqbanking-cli updateconf
+
==== Migration von 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.
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 ==
 
== 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 [[De/Konfiguration | Konfiguration]].  
 
Wenn nun die Installation geschafft ist, und man ein zwar noch leeres, aber funktionsfähiges GnuCash vor sich hat, beginnt man mit der [[De/Konfiguration | Konfiguration]].  
 
  
 
----
 
----
  
 
[[De/GnuCash | Zurück zur Hauptseite]]
 
[[De/GnuCash | Zurück zur Hauptseite]]
 
[[Category:De]]
 

Latest revision as of 03:16, 11 April 2023

Zurück zur Hauptseite

GnuCash-Installation

GnuCash ist für mehrere Plattformen verfügbar, darunter - in historischer Folge - Linux, FreeBSD, macOS, 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 FinTs 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 AqFinance verwendet werden.
  • Für Online-Börsenkursabfragen ist das Perl-Modul Finance::Quote zuständig, welches wiederum die Installation einer Perl-Umgebung erfordert. Die Installation können Sie im GnuCash-Handbuch nachlesen.
  • 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, sein freier Fork MariaBD 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. Häufig gibt es dafür auch separate Repositorien, die Update oder Backport heißen.
  • 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

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

Eine gute Übersicht über Distributionen bzw. Repositories mit GnuCash bietet Repology:

macOS

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, 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.

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.

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 macOS 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 ...

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

Quartz (GTK-OSX)

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

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

Die Installation von Finance::Quote können Sie im GnuCash-Handbuch nachlesen.

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 raus können die folgende Tools auf der Seite De/Im-Export hilfreich sein.

GnuCash Up- und Downgrate

Grundsätzliches

Update-Mechanismus
GnuCash verfügt im Gegensatz zu vielen Windowsprogrammen über keine integrierte Update-Funktion, 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.
Löschen der alten Version
Falls man keinen Paketmanager oder das Windows-Installationsprogramm verwendet ist erst die alte Version - ggf. auch der optionalen Komponenten - zu deinstallieren, bevor die neue installiert werden kann - sonst gibt das Kuddelmuddel! Bitte ergänzen: Verhalten bei macOS?
Versionsschema
Seit GnuCash 3.0
x.y mit x: Hauptversion, y: Unterversion und
y < 900 Release, sonst Vorschau der nächsten Hauptversion (= Beta-Version)
Bis GnuCash 2.6.x
x.y.z mit x: Fundamentalversion, y: Hauptversion, z: Unterversion und
y gerade: Release und y ungerade: Beta
Hauptversionen
bringen grundlegende neue Merkmal, aber es können sich auch Abhängigkeiten, Speicherorte oder -formate, … ändern.
Empfehlung
Vorher Datensicherung, nachher Integritäts-Check durchführen.
Unterversionen
enthalten im wesentlichen Fehlerbehebungen und Verbesserungen ohne strukturelle Änderungen.
Aktionen
Downgrading
Grundsätzlich ist nur bei der letzte Unterversion einer alten Hauptversion gewährleistet, daß sie alle Merkmale der nächsten Hauptversion fehlerfrei lesen kann. Speichern wird sie aber nur die alten Merkmale, wodurch diese Datei dann von älteren Versionen "verstanden" wird.
Datensicherung
Was dazu gehören kann, ist in De/Referenz#Welche Einstellungen GnuCash verwendet und wo sie gespeichert werden beschrieben.
Integritäts-Check
Überprüfung der Daten-Integrität für die aktuelle Programm-Version:
  1. In jedem GnuCash-Buch einmal Aktionen->Überprüfen->Alle überprüfen durchlaufen lassen, was sehr zeitaufwendig sein kann. Beim Abbruch muß man das nächste mal leider wieder von vorn beginnen.
  2. Anschließend Datei speichern.

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.

2.2.x auf 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:
$ 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.

Migration von 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.

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