README: EasyTax AG/BL für GNU/Linux ----------------------------------- Januar 2020 BEZUGSQUELLE ------------ AG: https://www.ag.ch/de/dfr/steuern/natuerliche_personen/steuererklaerung__easytax/steuererklaerung_easytax1.jsp BL: https://www.baselland.ch/politik-und-behorden/direktionen/finanz-und-kirchendirektion/steuerverwaltung/privatperson/easytax Die aktuelle Version von EasyTax kann auch auf https://www.msg-easytax.ch/ bezogen werden. VORRAUSSETZUNGEN ---------------- - Ein funktionstüchtiges Betriebssystem. Empfohlen wird eine aktuelle Distribution (z.B. Ubuntu, Fedora usw.) mit grafischer Desktop-Umgebung (Unity, KDE, GNOME, LXDE usw.). Getestet wurden Ubuntu 19.10 und Fedora 31. Live-Systeme sind auch möglich. - Ein lauffähiges Java Runtime Environment (kurz JRE) der Oracle Corporation. 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. - Kanton Basel-Landschaft: Für ausfüllbare Formulare benötigen Sie den Snapform Viewer. Dieser kann unter http://www.snapform.com/de/download/ bezogen werden. Weitere Infos dazu weiter unten. INSTALLATION ------------ Hinweis: Folgende Anleitung bezieht sich auf EasyTax AG. Die Installation von EasyTax BL verläuft jedoch genau gleich. Zur Installation muss das passende Paket (RPM oder DEB) runtergeladen und ausgeführt werden. RPM : RPM Package Management für Red-Hat-basierende System (Fedora, Mageia, SuSE usw.) DEB: Debian-Paket für Debian-basierende Systeme (Ubuntu, Linux Mint usw.) Das Paket lässt sich in der Regel durch Doppelklick auf die Datei öffnen, dann wird die Installation angeboten. Falls keine Softwareverwaltung gestartet wird, wenden Sie sich an die Bedienungsanleitung Ihres Betriebssystems. Sie werden nach Ihrem User-Passwort oder dem Root-Passwort gefragt, welches Sie eingeben müssen, damit das Paket installiert wird. Standardmässig wird EasyTax unter /opt/EasyTax2019AG/ installiert. 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. Dazu lesen Sie weiter unten die Hinweise zum Thema «Alternative Installation». Es werden nun alle zur Installation benötigten Dateien entpackt. Falls dies nicht funktioniert sollte die Datei erneut heruntergeladen werden. Ausserdem wird ein Desktop-Starter registriert, so dass Sie das Programm starten können. Üblicherweise kann die Applikation auch in der Konsole oder mit Alt-F2 gestartet werden: $ EasyTax-Programm_2019_AG DEINSTALLATION -------------- Verwenden Sie die Softwareverwaltung des Systems, um das Paket zu entfernen. 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 Environment (JRE) ### EasyTax benötigt die Java-Laufzeitumgebung (JRE). Die nötige Software kann von http://java.com/de/ bezogen werden. Es wird empfohlen das JRE von Sun/Oracle oder OpenJDK zu verwenden. Es muss zwingend Java Version 1.8.x («Java 8»: java-1.8.0-openjdk oder openjdk-8-jre) installiert sein. Java 9, 10 und 11 werden nicht unterstützt. Alternative Software wie Kaffe oder IcedTea wurde nicht getestet. Ein Vorhandensein des JRE kann in der Konsole getestet werden: $ java -version Die Ausgabe eines gültigen JRE sieht etwa so aus: openjdk version "1.8.0_222" OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~19.04.1-b10) OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode) Red Hat: Da das Paket keine Anhängigkeit definiert hat, muss das JRE manuell installiert werden. Auf java.com wird ein RPM-Paket angeboten. So verläuft die Installation gleich wie bei EasyTax. Fedora hat zwar bereits ein JRE installiert, aber nur ein sogenanntes «Java Headless», ohne Komponenten für Bildschirmausgabe. Wird das Paket «java-1.8.0» installiert (sudo dnf install java-1.8.0), so werden die benötigten Komponenten nachgeladen. Falls dies nicht ausreicht, installieren Sie Java von java.com oder wenden Sie sich an den Anbieter Ihres Systems. Das EasyTax-Paket ist nicht signiert. Falls das System das Paket verifizieren will, kann dies per Command Line mit «--nodigest"» vermieden werden. Eine Prüfsumme ist auf msg-easytax.ch verfügbar und kann zur Verifikation verwendet werden. Debian: Das Paket hat eine Abhängigkeit zu Java, so dass ein JRE automatisch mitinstalliert wird. Ubuntu wird zum Beispiel automatisch «openjdk-8-jre» installieren. Bei Java-Problemen lohnt es sich die Java-Implementation von Oracle zu testen. Für Ubuntu existiert folgende Anleitung: https://wiki.ubuntuusers.de/Java/Installation/Oracle_Java/Java_8/ EasyTax sucht automatisch ein passendes JRE. Falls Java nicht gefunden wird, kann durch das Setzen der Umgebungsvariable JAVA_HOME das gewünschte JRE gewählt werden. Im Verzeichnis des JRE muss sich die Datei ./bin/java befinden. Start von EasyTax mit manuell installiertem JRE: $ JAVA_HOME=/opt/java-8/ EasyTax-Programm_2019_AG Siehe auch «Alternative Installation» weiter unten zur Registration eines Desktop-Starters. ### Hilfsformulare (*.qdf) ### Die Hilfsformulare im Quick Document Format (QDF) füllen Sie mit dem Snapform Viewer aus. http://www.snapform.com/ Zur Installation laden Sie Snapform Viewer für Linux herunter: http://www.snapform.com/de/download/ ### Installation per Command Line ### Falls die Installation mit dem vom Betriebssystem zur Verfügung gestellten Paket-Manager mit Bedienoberfläche fehlschlägt, kann stattdessen das Paket per Kommandozeile installiert werden. - Ubuntu (basiert auf Debian): $ sudo apt-get install ~/Downloads/EasyTax2019AG_linux*.deb Oder: $ sudo dpkg -i ~/Downloads/EasyTax2019AG_linux*.deb - Fedora (basiert auf Red Hat): $ sudo dnf install ~/Downloads/EasyTax2019AG_linux*.rpm Oder: $ sudo rpm -i --nodigest ~/Downloads/EasyTax2019AG_linux*.rpm Wenn auch dies nicht gelingt, steht noch das «tar.gz»-Archiv zur Verfügung (siehe nächster Punkt). ### Alternative Installation ### Statt der Installation kann EasyTax als Archiv (tar.gz) heruntergeladen werden. Der Download steht unter https://www.msg-easytax.ch/ zur Verfügung. Auf https://java.com/de/ kann auch ein JRE als Archiv (tar.gz) heruntergeladen werden. Die komplette Installation sieht folgendermassen aus. Dabei müssen "XX" jeweils in den URLs und Pfaden angepasst werden. $ cd /opt $ sudo wget https://msg-easytax.ch/XX/2019/EasyTax2019XX_unix_1_X.tar.gz $ sudo tar -xvzf EasyTax2019XX_unix_1_X.tar.gz $ sudo wget -O java.tar.gz http://javadl.oracle.com/webapps/download/XXXXXXXXXXXXXX $ sudo tar –xvzf java.tar.gz $ sudo rm -i *.tar.gz $ env JAVA_HOME=/opt/jre1.8.XXXX/ /opt/EasyTax2019XX/EasyTax-Programm_2019_XX Es wird nun davon ausgegangen, dass EasyTax in /opt/EasyTax2019AG/ installiert wurde und ein JRE installiert ist. Für EasyTax BL muss "AG" durch "BL" ersetzt werden. Normalerweise wird ein Desktop-Starter automatisch erzeugt unter "/opt/EasyTax2019AG/EasyTax-Programm_2019_AG.desktop". Bei einer manuellen Installation muss der Desktop-Starter auch manuell erzeugt werden: --- Dateiname: /opt/EasyTax2019AG/EasyTax-Programm_2019_AG.desktop --- #!/usr/bin/env xdg-open [Desktop Entry] Type=Application Name=EasyTax 2019 AG Exec=/bin/sh "/opt/EasyTax2019AG/EasyTax-Programm_2019_AG" Categories=Office; ------------------------------------------------------------ Falls JAVA_HOME direkt in der Datei angegeben werden soll, muss eine Zeile ersetzt werden: Exec=env JAVA_HOME=/opt/jre1.8.XXXX/ /bin/sh "/opt/EasyTax2019AG/EasyTax-Programm_2019_AG" Nun kann der Desktop-Starter registriert werden: $ sudo desktop-file-install /opt/EasyTax2019AG/EasyTax-Programm_2019_AG.desktop Falls dieser Befehl (desktop-file-install) nicht existiert, kann stattdessen XDG verwendet werden: $ sudo xdg-desktop-menu install --novendor /opt/EasyTax2019AG/EasyTax-Programm_2019_AG.desktop $ sudo xdg-desktop-menu forceupdate Die manuelle Deinstallation geschieht durch das Entfernen von /opt/EasyTax2019AG/ und aller enthaltener Dateien. Ausserdem kann der Ordner ~/.easytax/ und enthaltene Dateien entfernt werden. Entfernung des Desktop-Starters: $ sudo xdg-desktop-menu uninstall --novendor EasyTax-Programm_2019_AG.desktop Falls dies fehlschlägt: $ sudo rm -f "/usr/share/applications/EasyTax-Programm_2019_AG.desktop" ### 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 ETAG19.jar --laf ? «Motiv» als LAF verwenden (falls vorhanden): $ java -jar ETAG19.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 (z.B. /opt), kann dieses Problem umgangen werden. Hilfe/Wegleitung online: AG: https://www.ag.ch/de/dfr/steuern/natuerliche_personen/steuererklaerung__easytax/steuererklaerung_easytax1.jsp BL: https://www.baselland.ch/politik-und-behorden/direktionen/finanz-und-kirchendirektion/steuerverwaltung/formulare/formulardownload#top ### Druck: ### Bei manchen Systemen kann mit EasyTax nicht direkt gedruckt werden. Lösung: Steuererklärung als PDF-Datei speichern und mit beliebigem PDF-Viewer (Evince, Okular usw.) ausdrucken. ### Update: ### Beim Update wird die aktuelle Version der Software (inkl. Kursliste) aus dem Internet geladen und zur Installation bereit gestellt. Das eigentliche Update unterscheidet sich nicht von der Installation. Falls aber der automatische Download fehlschlägt, können Sie die Datei auch im Web herunterladen. 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. ### «EasyTax 2019 AG/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_2019_AG.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, durch Verwendung des Parameters '--verbose'. Die Ausgabe in Dateien ist auch möglich: $ EasyTax-Programm_2019_AG --verbose > stdout.txt 2> errout.txt