<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 TRANSITIONAL//EN">
<html>
<head>
<title>Kleiner Guide: GnuCash HBCI unter Mac OS X (mit Cyberjack Reader) installieren</title>
</head>
<body>
<h1>GnuCash HBCI unter Mac OS X (mit Cyberjack Reader) installieren</h1>
<h4>Niklas von Öhsen, 26.2.2005</h4>
Es muss eine ganzer Haufen Software installiert werden, gluecklicherweise uebernimmt Fink den Grossteil davon. Die Installationsanleitung bezieht sich auf folgende Versionen:
<code> <ul type="circle">
<li>gnucash-hbci 1.8.11-1
<li>aqhbci 1.0.2-1beta
<li>aqhbci-ddvcard 1.0.1beta
<li>aqbanking 1.0.4-1beta
<li>gwenhywfar 1.7.2-2
<li>libchipcard2 1.9.9beta
<li>CyberJack OS X 3.1 (Treiber fuer den Reader, von Reiner SCT)
</ul>
</code>
Also zuerst:
<ol type="1">
<li> <h4>Fink installieren und auf unstable konfigurieren</h4>
Wie gesagt fink installieren und dann <code>/sw/etc/fink.conf</code> editieren: In der Zeile "Trees" die Eintraege <code>unstable/main unstable/crypto</code> hinzufuegen. Dann ein "fink selfupdate-cvs" ausfuehren.
<li> <h4>Gnucash und ein paar andere Pakete installieren</h4>
<code>fink install gnucash-hbci aqbanking aqhbci libusb gwenhywfar</code> ausfuehren. Das installiert fuenf Pakete (evtl. muessen nicht alle angegeben werden, so funktionierts aber) und ein paar andere dazu.
<ol type="1">
<li> <code>gnucash-hbci</code>: GnuCash mit HBCI unterstuetzung.
<li> <code>aqbanking aqhbci aqhbci-wizard-kde</code>: Library fuer die HBCI Unterstuetzung und Konfigurations-utility fuer dieselbe.
<li> <code>libusb gwenhywfar</code>: Libraries die fuer die libchipcard2-Library spaeter benoetigt werden.
</ol>
<li> <h4>libchipcard2 installieren</h4>
libchipcard2 ist zur Zeit nicht ueber fink verfuegbar (das Paket sollte ein fachkundiger Entwickler allerdings relativ einfach machen koennen) und muss von Hand gebaut werden:
<ol type="1">
<li>libchipcard2 als source tar.gz downloaden und auspacken.
<li> In den entstandenen Ordner wechseln und folgende Befehle ausfuehren (libchipcard2 wird dann in den Ordner /sw installiert, wo auch fink alle Sachen installiert. Andere prefixes sind nicht empfehlenswert -> Probleme) </p>
<code>./configure --prefix=/sw LDFLAGS=-L/sw/lib CFLAGS=-I/sw/include CPPFLAGS=-I/sw/include</code>
<p></p><code>make</code>
<p></p><code>sudo make install</code>
<p></p>
Das setzen der flags im configure Kommando ist zumindest teilweise erforderlich, sonst meckert das nachfolgende make ueber fehlende includes.
</ol>
<li> <h4>aqhbci-ddvcard installieren</h4>
<ol type="1">
<li>aqhbci-ddvcard als source tar.gz downloaden und auspacken.
<li> In den entstandenen Ordner wechseln und folgende Befehle ausfuehren (ebenfalls in /sw installieren)</p>
<code>./configure --prefix=/sw</code>
<p></p><code>make</code>
<p></p><code>sudo make install</code>
</ol>
<li> <h4>Treiber fuer den Cardreader installieren (hier CyberJack)</h4>
Treiber von Reiner SCT fuer Mac OS X herunterladen und das Paket installieren. Damit verlaesst man die Linux-aehnliche Welt. Der Treiber wird in den Tiefen der Mac OS X System-Struktur vergraben. Die wichtige Datei heisst <code>CyberJack_CTAPI</code> und sollte nach erfolgreicher Installation unter <code>/Library/Frameworks/CyberJack_CTAPI.framework/Versions/Current</code> liegen.
<li> <h4>Konfiguration von libchipcard2</h4>
<ol type="1">
<li> libchipcard2 server konfigurieren: </p>
<code>cd /sw/etc/chipcard2-server </p>
cp chipcardd2.conf.minimal chipcardd2.conf
</code> </p>
<li> libchipcard2 client konfigurieren: </p>
<code>cd /sw/etc/chipcard2-client </p>
cp chipcardc2.conf.example chipcardc2.conf
</code> </p>
</ol>
<li> <h4>Patchen der libchipcard2 Konfiguration fuer CyberJack</h4>
Die Datei <code>/sw/etc/chipcard2-server/drivers/cyberjack_ctapi/driver.xml</code> editieren: <p/>
<ol type="1">
<li> Namen der Bibliothek ersetzen:
</p> <code>
<name>libctapi-cyberjack.so</name>
</code>
<p/>
muss ersetzt werden durch </p>
<code>
<name>CyberJack_CTAPI</name>
</code>
<p/>
<li>Location der Bibliothek hinzufuegen: Bei den Locations muss die Zeile
<p/>
<code>
<loc>/Library/Frameworks/CyberJack_CTAPI.framework/Versions/Current</loc>
</code>
<p/> hinzugefuegt werden.
<p/>
<li> USBSerial auf USB aendern. Der Eintrag
<p/><code>
<reader name="cyberjack" com="USBSerial" vendor="0x0c4b" product="0x0100">
</code><p/>
muss in
<p/><code>
<reader name="cyberjack" com="USB" vendor="0x0c4b" product="0x0100">
</code><p/>
geaendert werden (keine Ahnung warum, aber sonst funktionierts nicht).
</ol>
<li> <h1>Fertig!</h1> Jetzt nur noch evtl. /sw/sbin mit in den Path aufnehmen und den chipcard server starten:
<p/>
<code>sudo chipcardd2 --pidfile=/x.pid </code>
<p/>
(der server schreibt Details ueber alle Vorgaenge und evtl. Fehlermeldungen in das system.log). Jetzt kann man gnucash starten und die HBCI-einrichtung durchfuehren. Enjoy!
</ol>
</body>
</html>