Benutzer-Werkzeuge

Webseiten-Werkzeuge


installation:linux_macos

Installation unter Linux und macOS

Die Installation unter Linux und macOS wird derzeit erprobt. Thera-Pi sollte als Java-Anwendung überall laufen. Da die Anwendung bisher nur unter Windows benutzt und getestet wurde, kann es aber noch „Stolpersteine“ geben. Installationspakete für Linux und macOS wird es dann geben, wenn die Lösung unter diesen Systemen besser getestet ist.

Bis dahin können Interessierte, die Thera-Pi „ohne Garantie“ ausprobieren (und idealerweise Rückmeldungen geben) wollen, sich an folgende Hinweise halten.

Hinweise für Linux

  • Wegen der Java-Basis spielt es keine Rolle, welche Distribution genutzt wird.
  • MariaDB Version 10.6.x installieren und konfigurieren
    • keine Sonderzeichen, Umlaute oder Leerzeichen beim Namen der Datenbank, dem Benutzernamen und Passwort des DB-Benutzers
    • Einstellungen in der my.cnf wie unter Windows:
      • sql_mode = '' (zwei Hochkommata)
      • max_allowed_packet = 32M
    • Unter Debian 12 (und Derivaten) kann es Schwierigkeiten geben, MariaDB in der Version 10.6 zu installieren (Hinweise dazu). Wer das nicht erzwingen will, sollte auf Debian 11 oder eine andere Distribution ausweichen. Wir werden das Programm noch an MariaDB 10.11 anpassen, aber das wird etwas dauern.
  • Datenbank aus Windows exportieren und in MariaDB unter Linux importieren.
  • Java installieren
    • Thera-Pi benötigt ein 64-bit OpenJDK mit JavaFX. Daher nehmen wir Bellsoft Liberica 8.0 Full JRE (64-bit).
    • Am sinnvollsten ist, ein Repository von der Seite Liberica Package Repositories einzubinden. Hier gibt es Varianten für APT, YUM, YaST / Zypper und Alpine Linux. Das benötigte Paket für Anwender heißt bellsoft-java8-runtime-full, Entwickler nehmen bellsoft-java8-full.
    • Bei manueller Installation die Installationsvariante von „Standard JDK“ auf „Full JRE“ ändern. Als Formate werden RPM, DEB und .tar.gz angeboten.
    • Nach der Installation vom Desktop abmelden / anmelden (oder rebooten).
    • Test auf der Konsole: java -version muss die Java-Version korrekt anzeigen
  • OpenOffice 64-bit installieren
    • Der Hinweis auf 32-bit gilt nur für Windows, weil es unter Windows keine 64-bit-Version von OpenOffice gibt.
    • die Anpassung an LibreOffice ist für den Sommer 2024 geplant.
  • Die Programmdateien und Einstellungen übernimmt man zunächst aus Windows. Die TheraPi-Version sollte aktuell sein.
    • Das Installationsverzeichnis ist beliebig.
    • Anschließend spielt man JAR-Dateien für Linux ein (im Forum an den User „Logopädie“ wenden).
    • Pfade in der rehajava.ini anpassen (ein Beispiel gibt es per Mail). Das DB-Passwort entweder so lassen (wie es in Windows war), oder löschen, damit es neu abgefragt wird.
    • nebraska_windows.conf im Programmverzeichnis in nebraska_linux.conf umbenennen, Pfade in der Datei anpassen.
  • Wenn man die Fehlermeldungen sehen möchte: Start auf der Konsole mit java -jar TheraPi.jar
  • Aktueller Stand
    • Pi funktioniert unter Linux, auch mit der aktuellen Version.
    • Nach Anpassungen in Pi lässt sich auch OpenOffice direkt (aus Thera-Pi heraus) starten. Wer es testen will, wendet sich bitte an den Forenuser „Logopädie“.
    • Bei Rugl ist der linke Teil des Dialogs (Patientenname und Rezeptnummer) verdeckt.
      • Lösung: Neuere Versionen der drei JGoodies-Libs integrieren und Pi daran anpassen. Danach wurde der Dialog richtig dargestellt. Die Anpassungen müssen noch in den wip-Branch übernommen werden.
    • Abrechnung > Barkasse abrechnen: aus unerfindlichen Gründen wurde die Vorlagendatei BarKasse.ott genannt, obwohl im Programmcode „Barkasse.ott“ steht. Die Vorlage entsprechend umbenennen, und gut ist.
    • Drag-and-Drop funktioniert bisher nicht unter Linux, das ist aber nicht essentiell.

Hinweise für macOS

  • Thera-Pi sollte auf macOS (x86) laufen, Tests stehen noch aus.
  • MariaDB Version 10.6.x installieren und konfigurieren
    • keine Sonderzeichen, Umlaute oder Leerzeichen beim Namen der Datenbank, dem Benutzernamen und Passwort des DB-Benutzers
    • sql_mode = '' (zwei Hochkommata)
  • OpenOffice 64-bit installieren
    • OpenOffice gibt es nur für macOS (x86). Auf ARM-Prozessoren kann es mit Rosetta 2 verwendet werden.
    • Der Hinweis auf 32-bit gilt nur für Windows, weil es unter Windows keine 64-bit-Version von OpenOffice gibt.
    • die Anpassung an LibreOffice ist für den Sommer 2024 geplant.
  • Java 8 64-bit installieren: Liberica Full JRE 8.0.xx x86-64 for macOS von Bellsoft
  • Die Installationsdateien übernimmt man am besten aus Windows. Sollte das nicht möglich sein, bitte im Forum anfragen.
    • Das Installationsverzeichnis ist beliebig.
    • Pi am besten einmal starten, damit das Datenbank-Passwort abgefragt und Datenbank-Updates eingespielt werden.
  • Datenbank aus Windows exportieren und in MariaDB unter macOS importieren.

Troubleshooting

  • Die Schrift im Installer oder im Programm ist so groß, dass der Inhalt nicht mehr in das Fenster passt?
    • Stellen Sie die Bildschirmauflösung auf FullHD (1920 x 1080 Pixel), die Schriftskalierung auf 100 %
    • Von einem Parallels-Anwender wurde berichtet, dass die Schriftskalierung sich bei ihm nicht auf 100 % setzen ließ. Durch die (erzwungene) Einstellung auf 200 % sind die Schriften natürlich doppelt so groß, sodass der Text nicht mehr vollständig ins Fenster passt. In diesem Fall hilft es, in den Einstellungen der VM die Option Hardware > Grafiken > Auflösung auf Skaliert zu setzen.
installation/linux_macos.txt · Zuletzt geändert: 2024/06/19 17:18 von wikijh