README: EasyTax für Linux ------------------------- 16. Januar 2009 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 ca. 20 MB 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. EasyTax2008BL_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 ca 20 MB 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 ./EasyTax2008BL_unix_1_0.sh Installation als Superuser mithilfe von sudo: $ sudo sh ./EasyTax2008BL_unix_1_0.sh Installation als aktueller User: $ sh ./EasyTax2008BL_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: $ EasyTax2008_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/EasyTax2008BL/) und von dem selben User bzw von root ausgeführt werden. Falls das Installationsverzeichnis nicht mehr bekannt ist hilft dies vielleicht weiter: # file `which EasyTax2008_BL` Deinstallation: # cd /usr/local/EasyTax2008BL/ # sh ./uninstall Der Assistent leitet Sie durch den Rest der Deinstallation. Die EasyTax-Dateien mit den erfassten Daten 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_11" Java(TM) SE Runtime Environment (build 1.6.0_11-b03) Java HotSpot(TM) Client VM (build 11.0-b16, mixed mode, sharing) Durch setzen der Umgebungsvariable INSTALL4J_JAVA_HOME_OVERRIDE dann 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-6-sun/ sh ./EasyTax2008BL_unix_1_0.sh Start von EasyTax mit Java 6 von Sun: $ INSTALL4J_JAVA_HOME_OVERRIDE=/usr/lib/jvm/java-6-sun/ EasyTax2008_BL ### 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 ETBL08.jar --laf ? "Motiv" als LAF verwenden (falls vorhanden): $ java -jar ETBL08.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/2008/2008_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. Das automatische Update der Kursliste steht momentan (Steuerperiode 2008) nur für den Kanton Aargau zur Verfügung. ### "EasyTax 2008 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_2008_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: $ EasyTax2008_BL > stdout.txt 2> errout.txt Support bei technischen Fragen: Tel. 0900 654321 (Fr. 1.90/Min.)