README: EasyTax für Linux ------------------------- Januar 2010 BEZUGSQUELLE ------------ Das Installtions-Script befindet sich auf der EasyTax-CD. Die aktuelle Version von EasyTax kann auf http://hwis.ch/ bezogen werden. EasyTax für Linux wird für die Kantone AG und BL angeboten. Der Download befindet sich unter: AG: http://hwis.ch/easytax_ag.html BL: http://hwis.ch/easytax_bl.html VORRAUSSETZUNGEN ---------------- - Ein funktionstüchtiges Betriebssystem. Empfohlen wird eine aktuelle Distribution (Mandriva, openSuse, Ubuntu, Gentoo etc) mit grafischer Desktop-Umgebung (KDE, GNOME etc). Live-Systeme sind auch möglich. - Ein lauffähiges Java Runtime Envirenment (JRE) von Sun Microsystems Dies kann unter http://java.com/de/ bezogen werden. Weitere Infos dazu weiter unten. - Schreibrechte und genügend freier Speicher. Bei einem Live-System ist die Installation auf einen externen Datenträger (USB-Stick) möglich. INSTALLATION ------------ Hinweis: Folgende Anleitung bezieht sich auf EasyTax BL. Die Installation von EasyTax AG verläuft jedoch genau gleich. Zur Installation muss das Script (z.B. EasyTax2009BL_unix_1_0.sh) runtergeladen und ausgeführt werden. Eventuell müssen erst die Zugriffsrechte der Datei angepasst werden, damit es ausgeführt werden kann. Damit mehrere User das Programm starten können, muss es als Superuser installiert werden. Die Installation ist aber auch mit den Rechten eines beliebigen Users möglich, solange er Schreibrechte auf ein Medium mit genügend freiem Speicher hat. Je nach Distribution und Einstellungen kann der Benutzer mit su gewechselt werden oder es besteht die Möglichkeit den Befehl sudo zu verwenden. Installation als Superuser mithilfe von su (Normalerweise wird dabei das root-Passwort verlangt.): $ su # sh ./EasyTax2009BL_unix_1_0.sh Installation als Superuser mithilfe von sudo: $ sudo sh ./EasyTax2009BL_unix_1_0.sh Installation als aktueller User: $ sh ./EasyTax2009BL_unix_1_0.sh Als erstes werden die zur Installation benötigten Dateien entpackt. Falls dies nicht funktioniert sollte die Datei erneut heruntergeladen werden. Danach wird nach einer gültigen Java-Installation gesucht. Der Installationsassistent führt Sie durch den Rest der Installation. Bei der Installation als Superuser kann die Applikation direkt auf der Konsole oder mit Alt-F2 gestartet werden: $ EasyTax2009_BL Bei der Installation als User kann EasyTax anhand der Verknüpfung auf dem Desktop gestartet werden. DEINSTALLATION -------------- Das Skript zur Deinstallation muss aus dem Installationsverzeichnis (z.B. /usr/local/EasyTax2009BL/) und von dem selben User bzw von root ausgeführt werden. Falls das Installationsverzeichnis nicht mehr bekannt ist hilft dies vielleicht weiter: # file `which EasyTax2009_BL` Deinstallation: # cd /usr/local/EasyTax2009BL/ # sh ./uninstall Der Assistent leitet Sie durch den Rest der Deinstallation. Die EasyTax-Dateien mit den erfassten Daten sowie gespeicherte PDF-Dokumente bleiben dabei bestehen. Das Verzeichnis ~/.easytax und sich darin befindliche Dateien können gelöscht werden. HINWEISE UND PROBLEMBEHANDLUNG ------------------------------ ### Java Runtime Envirenment (JRE) ### Die nötige Software kann von http://java.com/de/ bezogen werden. Bei gewissen Distributionen ist sie bereits vorinstalliert oder es kann durch den Paketmanager installiert werden. Es wird empfohlen die neuste Version der Java Runtime Environment von Sun zu verwenden. Alternative Software wie Kaffe oder IcedTea wurde nicht getestet. Ein Vorhandensein der JRE kann in der Konsole getestet werden: $ java -version Die Ausgabe einer gültigen JRE sieht etwa so aus: java version "1.6.0_17" Java(TM) SE Runtime Environment (build 1.6.0_17-b04) Java HotSpot(TM) Client VM (build 14.3-b01, mixed mode) Durch setzen der Umgebungsvariable INSTALL4J_JAVA_HOME_OVERRIDE kann die gewünschte JRE gewählt werden. Dies gilt sowohl für den Installer als auch für EasyTax. Die verfügbaren JREs befinden sich meist in /usr/lib/jvm/. Im Verzeichnis der JRE muss sich die Datei ./bin/java befinden. Installation mit Java 6 von Sun als JRE: $ INSTALL4J_JAVA_HOME_OVERRIDE=/usr/lib/jvm/java-sun/ sh ./EasyTax2009BL_unix_1_0.sh Start von EasyTax mit Java 6 von Sun: $ INSTALL4J_JAVA_HOME_OVERRIDE=/usr/lib/jvm/java-sun/ EasyTax2009_BL Siehe auch "Alternative Installation" weiter unten zur Erstellung eines eigenen Starters. ### Alternative Installation (nicht-x86) ### Auf Systemen die vom Installer nicht unterstützt werden kann die Installation mit dem Parameter -c in der Konsole durchgeführt werden. # sh ./EasyTax2009BL_unix_1_0.sh -c Es wird nun davon ausgegangen, dass EasyTax in /usr/local/EasyTax2009BL/ installiert wurde und Java in /usr/lib/jvm/java-sun/ zu finden ist. Eventuell funktioniert EasyTax nun bereits über den installierten Starter: $ EasyTax2009_BL Falls nicht, muss ein Starter erstellt werden. Dieser könnte in /usr/local/bin/ sein (rm löscht einen bestehenden Starter): # cd /usr/local/bin/ # rm ./EasyTax2009_BL # touch ./EasyTax2009_BL # chmod a+x ./EasyTax2009_BL # gedit ./EasyTax2009_BL An Stelle von gedit tut es jeder beliebige Editor. Dies kann auch kwrite, mcedit, ex oder vi sein. Inhalt der Datei sind folgende zwei Zeilen: #!/bin/sh /usr/lib/jvm/java-sun/bin/java -Xmx128m -jar /usr/local/EasyTax2009BL/lib/ETBL09.jar Der Parameter "-Xmx128m" lässt Java bis zu 128 MB Arbeitsspeicher verwenden. EasyTax kann nun mit dem Befehl EasyTax2009_BL gestartet werden. Falls auf dem Desktop oder im Anwendungs-Menu ein Programmstarter erstellt wurde, muss dieser entsprechend angepasst werden. Die manuelle Deinstallation geschieht durch das entfernen aller Dateien welche in EasyTax2009BL/.install4j/files.log aufgelistet sind. Dies ist in erster Linie alles innerhalb von EasyTax2009BL/ und eventuell die Starter in /usr/local/bin/, ~/Desktop/ und ~/.local/share/applications/. Ausserdem kann der Ordner ~/.easytax/ und enthaltene Dateien entfernt werden. ### Probleme mit GUI-Elementen: ### Probleme treten auf, wenn das "Look and Feel" gewisse Funktionen nicht unterstützt oder fehlerhaft implementiert. Es könnte jedoch auch an der JRE (siehe oben) liegen, welche Inkompatibilitäten aufweist. Wenn möglich wird "MetalLookAndFeel" verwendet. Sie können ein anderes "Look and Feels" (laf) wählen, um das Problem zu umgehen: Auflisten der verfügbaren LAFs (nur in der Konsole sichtbar, EasyTax wird nicht gestartet): $ java -jar ETBL09.jar --laf ? "Motiv" als LAF verwenden (falls vorhanden): $ java -jar ETBL09.jar --laf com.sun.java.swing.plaf.motif.MotifLookAndFeel ### Hilfe/Wegleitung: ### Beim Klick auf einen Hilfe-Knopf in der Anwendung sollte ein Webbrowser starten und die gewünschten Informationen anzeigen. Es können folgende Probleme auftreten: - Es wird kein Browser gestartet (bzw. ein Konsolenbrowser der nicht sichtbar ist) - Es wird nicht der gewünschte Browser gestartet Im Menü unter "Optionen->Browser wählen..." kann ein Befehl zum Starten des gewünschten Programms gewählt werden. Einige Vorgaben stehen zur Verfügung, um die Auswahl zu erleichtern. Die Option "auto" wird nach einem Browser suchen und den Erstbesten verwenden. PDF-Dateien können entweder von EasyTax oder im externen Browser geöffnet werden. Falls das Installationsverzeichnis Sonderzeichen enthält, kann es vorkommen, dass die URL falsch generiert wird. Durch die Installation in ein Verzeichnis ohne Sonderzeichen kann dieses Problem umgangen werden. Hilfe/Wegleitung online: http://www.baselland.ch/fileadmin/baselland/files/docs/fkd/steuern/form/pdf/2009/2009_wegleitung.pdf http://www.ag.ch/steueramt/de/pub/angebote/steuererklaerungen.php ### Druck: ### Bei manchen Systemen kann mit EasyTax nicht direkt gedruckt werden. Lösung: Steuererklärung als PDF-Datei speichern und mit beliebigem PDF-Viewer ausdrucken. ### Update: ### Beim Update werden die aktuellen Versionen der Software und der Kursliste aus dem Internet geladen und die alten Dateien ersetzt. Dazu werden Schreibrechte im Installationsverzeichnis benötigt. Falls die Installation als Root durchgeführt wurde, kann EasyTax als Root gestartet und das Update durchgeführt werden, ansonsten gelingt dies mit dem normalen User. Das Autoupdate (Suche nach Updates beim Start von EasyTax) ist standardmässig aktiviert und kann über das Menü ("Datei->Beim Start nach Updates suchen") deaktiviert werden. Der aktuelle Installer auf http://hwis.ch/ enthält die jeweils neuste Version von EasyTax, jedoch nicht immer die neuste Kursliste. ### "EasyTax 2009 BL ist bereits gestartet." ### Diese Meldung sollte nur erscheinen, wenn EasyTax bereits läuft. Es wird dringend davon abgeraten EasyTax ein zweites mal zu starten. Es besteht die Möglichkeit EasyTax mit dem Parameter --nolock zu starten oder die Lockdatei (normalerweise /tmp/EasyTax_2009_BL.lock) zu löschen. Ein Neustart des Systems ist jedoch vorzuziehen. ### Sonstige Probleme: ### Bei sämtlichen Problemen lohnt sich ein Blick auf die Ausgabe in der Konsole. Die Ausgabe in Dateien ist auch möglich: $ EasyTax2009_BL > stdout.txt 2> errout.txt Support bei technischen Fragen: Tel. 0900 654321 (Fr. 1.90/Min.)