README: EasyTax AG für Linux ----------------------------- Januar 2017 BEZUGSQUELLE ------------ Die aktuelle Version von EasyTax AG kann auf https://www.msg-easytax.ch/easytax bezogen werden. Für EasyTax BL existiert ein eigenes README. 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 16.04 und Fedora 24. 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. Dies kann unter http://www.snapform.com/de/download/ bezogen werden. Weitere Infos dazu weiter unten. INSTALLATION ------------ Hinweis: Folgende Anleitung bezieht sich auf EasyTax AG. 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 etc) DEB: Debian-Paket für Debian-basierende Systeme (Ubuntu, Linux Mint etc.) Das Paket lässt sich 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/EasyTax2016AG/ 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 Installation benötigten Dateien entpackt. Falls dies nicht funktioniert sollte die Datei erneut heruntergeladen werden. Ausserdem es wird ein Desktop-Sterter registriert, so dass Sie das Programm starten können. Üblicherweise kann die Applikation auch auf der Konsole oder mit Alt-F2 gestartet werden: $ EasyTax2016_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 Version 1.8.x ("Java 8") der Java Runtime Environment von Sun/Oracle zu verwenden. Alternative Software wie Kaffe, OpenJDK 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.8.0_102" Java(TM) SE Runtime Environment (build 1.8.0_102-b12) Java HotSpot(TM) 64-Bit Server VM (build 25.12-b12, mixed mode) Wenn kein Java installiert ist, kann dies von java.com heruntergeladen werden. 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. Installieren Sie Java von java.com oder wenden Sie sich an den Anbieter Ihres Systems. Debian: Das Paket hat eine Abhängigkeit zu Java, so dass ein JRE automatisch mitinstalliert wird. Ubuntu wird zum Beispiel automatisch «default-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/ Durch das Setzen der Umgebungsvariable INSTALL4J_JAVA_HOME_OVERRIDE kann die gewünschte JRE gewählt werden. Die verfügbaren JREs befinden sich meist in /usr/lib/jvm/. Im Verzeichnis der JRE muss sich die Datei ./bin/java befinden. Start von EasyTax mit Java 8 von Sun/Oracle: $ INSTALL4J_JAVA_HOME_OVERRIDE=/usr/lib/jvm/jre1.8.0_102/ EasyTax2016_AG Siehe auch «Alternative Installation» weiter unten zur Erstellung eines eigenen 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/EasyTax2016AG_linux*.deb Oder: $ sudo dpkg -i ~/Downloads/EasyTax2016AG_linux*.deb - Fedora (basiert auf Red Hat): $ sudo dnf install ~/Downloads/EasyTax2016AG_linux*.rpm Oder: $ sudo rpm -i ~/Downloads/EasyTax2016AG_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. Es wird nun davon ausgegangen, dass EasyTax in /opt/EasyTax2016AG/ installiert wurde und ein JRE installiert ist. Nun kann der enthaltene Desktop-Starter registiert werden: $ sudo desktop-file-install /opt/EasyTax2016AG/EasyTax2016_AG.desktop Falls dieser Befehl (desktop-file-install) nicht existiert, kann stattdessen XDG verwendet werden: $ sudo xdg-desktop-menu install --novendor /opt/EasyTax2016AG/EasyTax2016_AG.desktop $ sudo xdg-desktop-menu forceupdate Die manuelle Deinstallation geschieht durch das entfernen von /opt/EasyTax2016AG/ und aller enthaltener Dateien. Ausserdem kann der Ordner ~/.easytax/ und enthaltene Dateien entfernt werden. Entfernung des Desktop-Starters: $ sudo xdg-desktop-menu uninstall --novendor EasyTax2016_AG.desktop Falls dies fehlschlägt: $ sudo rm -f "/usr/share/applications/EasyTax2016_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 ETAG16.jar --laf ? «Motiv» als LAF verwenden (falls vorhanden): $ java -jar ETAG16.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: https://www.ag.ch/de/dfr/steuern/natuerliche_personen/steuererklaerung__easytax/steuererklaerung_easytax1.jsp ### 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 werden die aktuellen Versionen der Software (inkl. Kursliste) aus dem Internet geladen und die alten Dateien ersetzt. Das eigentliche Update unterschiedet 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 2016 AG 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_2016_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: $ EasyTax2016_AG --verbose > stdout.txt 2> errout.txt