Benutzer-Werkzeuge

Webseiten-Werkzeuge


quick_install

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu der Vergleichsansicht

Beide Seiten, vorherige Überarbeitung Vorherige Überarbeitung
Nächste Überarbeitung
Vorherige Überarbeitung
quick_install [2025/01/26 17:17]
smg [Vorbereitende Schritte]
quick_install [2025/02/07 20:32] (aktuell)
smg [Installation von Java]
Zeile 20: Zeile 20:
  
 ===== Exklusiver Betrieb auf einem Rechner (mit efaLive) ===== ===== Exklusiver Betrieb auf einem Rechner (mit efaLive) =====
-Soll ausschließlich efa auf einem Rechner laufen (z.B. im Bootshaus), so kann hierfür [[http://efa.nmichael.de/download.html.de#efaLive|efaLive]] benutzt werden. [[http://efa.nmichael.de/download.html.de#efaLive|efaLive]] ist verfügbar für+Soll ausschließlich efa auf einem Rechner laufen (z.B. im Bootshaus), so kann hierfür [[https://www.hannay.de/en/efalive/|efaLive]] benutzt werden. [[https://www.hannay.de/en/efalive/|efaLive]] ist verfügbar für
   * Raspberry PI (ab Raspi 3)   * Raspberry PI (ab Raspi 3)
   * Intel/AMD X86 Rechner   * Intel/AMD X86 Rechner
Zeile 33: Zeile 33:
  
 ==== Die "richtige" Linux-Distribution ==== ==== Die "richtige" Linux-Distribution ====
-Efa läuft grundsätzlich auf allen Linux-Distributionen.+Efa läuft grundsätzlich auf allen Linux-Distributionen, sofern Java 8 oder höher vorhanden ist.
  
-Es ist empfehlenswert, eine LTS-Version zu verwenden, da diese ohne Neuinstallation sehr lange mit Updates und Security-Patches unterstützt wird.+  * Es ist für den Bootshaus-Betrieb empfehlenswert, eine LTS-Version (Long Term Service) der gewünschten Linux-Distribution zu verwenden, da diese ohne Neuinstallation sehr lange mit Updates und Security-Patches unterstützt wird.
  
-Spezialfall Ubuntu Linux: Hier wird mit+  * Eine Besonderheit bei Ubuntu Linux:\\ Ubuntu nutzt standardmäßig Unity für die Desktop-Oberfläche, und zeigt in einer Seitenleiste (Dock) die laufenden Programme oder Schnellstart-Icons an. Wird diese Seitenleiste auf "automatisch ausblenden" gesetzt (was auf einem Kiosk-System für das Bootshaus durchaus sinnvoll sein kann), dann ist dies nur eingeschränkt möglich.\\ \\ Efa wird bei jedem Einblenden eines Popup-Fensters z.B. bei der Erfassung neuer Fahrten dafür sorgen, dass die Seitenleiste wieder eingeblendet wird. Das kann für die Anwender verwirrend sein.\\ Eine Anpassung von efa zur Vermeidung des Einblendens der Seitenleiste ist derzeit nicht geplant.\\ \\ Aus diesem Grund ist Ubuntu mit Unity als Oberfläche für efa im Bootshausbetrieb eher //nicht// zu empfehlen.
 ==== Installation von Java ==== ==== Installation von Java ====
   * **efaLive (Raspberry, oder auch i386)**\\ Hier gibt es nichts zu tun, es ist alles fertig vorkonfiguriert.\\ \\    * **efaLive (Raspberry, oder auch i386)**\\ Hier gibt es nichts zu tun, es ist alles fertig vorkonfiguriert.\\ \\ 
-  * **Raspberry PI**\\ Raspian kommt standardmäßig mit einer installierten Java-Version.\\ Dies ist bei älteren Raspian Versionen das java 11 openjdk. Dieses funktioniert, ist aber nicht so schnell wie java 17.\\ Es ist zu empfehlen, java17 oder höher einzusetzen, da sich efaBootshaus damit in der Bedienung etwas flüssiger anfühlt.+  * **Raspberry PI mit Raspian**\\ Raspian kommt standardmäßig mit einer installierten Java-Version.\\ Dies ist bei älteren Raspian Versionen das java 11 openjdk. Dieses funktioniert, ist aber nicht so schnell wie java 17.\\ Es ist zu empfehlen, java17 oder höher einzusetzen, da sich efaBootshaus damit in der Bedienung etwas flüssiger anfühlt.
     * Welche Java-Version setzt der Raspi ein?\\ auf der Kommandozeile (Terminal-Fenster) eingeben:\\ ''java --version''      * Welche Java-Version setzt der Raspi ein?\\ auf der Kommandozeile (Terminal-Fenster) eingeben:\\ ''java --version'' 
     * Upgrade auf java17: Zunächst ein neues Java installieren:\\ ''sudo apt-get update''\\ ''sudo apt-get install openjdk-17-jre''\\      * Upgrade auf java17: Zunächst ein neues Java installieren:\\ ''sudo apt-get update''\\ ''sudo apt-get install openjdk-17-jre''\\ 
Zeile 52: Zeile 52:
     * Danach die alte Java-Version entfernen:\\ ''sudo apt-get remove openjdk-11-*''     * Danach die alte Java-Version entfernen:\\ ''sudo apt-get remove openjdk-11-*''
  
-  * **Windows**\\ Windows kommt standardmäßig ohne eine Java-Installation.\\ Auch hier kann man die [[https://openjdk.org/|OpenJDK-Version]] installieren. Dies bedingt aber nacher noch die manuelle Anpassung der Umgebungsvariablen von Windows.\\ \\ Alternativ kann man auch die [[https://learn.microsoft.com/de-de/java/openjdk/download|Microsoft-Version von openJDK]] nutzen, die mit einem Installer (MSI) ausgestattet ist.  Dieser ist in der Lage, die Windows-Umgebungsvariablen automatisch zu setzen.\\ \\ Auf der [[https://learn.microsoft.com/de-de/java/openjdk/download|Microsoft-Seite]] ist bei der Auswahl des Download-Pakets darauf zu achten, das mit ''msi'' markierte Windows-Paket herunterzuladen!\\ \\ Mit den folgenden Optionen werden die benötigten Einträge im System erstellt:\\ \\ {{ :msiinstaller_optionen.png?direct&300 |}}+  * **Windows**\\ Windows kommt standardmäßig ohne eine Java-Installation.\\ Auch hier kann man die [[https://openjdk.org/|OpenJDK-Version]] installieren. Dies bedingt aber nacher noch die manuelle Anpassung der Umgebungsvariablen von Windows.\\ \\ Alternativ kann man auch die [[https://learn.microsoft.com/de-de/java/openjdk/download|Microsoft-Version von openJDK]] nutzen, die mit einem Installer (MSI) ausgestattet ist.  Dieser ist in der Lage, die Windows-Umgebungsvariablen automatisch zu setzen.\\ \\ Auf der [[https://learn.microsoft.com/de-de/java/openjdk/download|Microsoft-Seite]] ist bei der Auswahl des Download-Pakets darauf zu achten, das mit ''msi'' markierte Windows-Paket herunterzuladen!\\ Mit den folgenden Optionen im Installer werden die benötigten Einträge im System erstellt:\\ \\ {{ :msiinstaller_optionen.png?direct&300 |}}
  
-==== Optional: Installation von Schriften (Linux) ====+==== Optional: Installation von Schriften ====
  
 Das Aussehen von efa wird maßgeblich von der verwendeten Bildschirmschrift beeinflusst.\\ Ab efa 2.4.0 sucht sich efa bei dem ersten Start aus den im System verfügbaren Schriftarten eine heraus, die eine gute Lesbarkeit unterstützt. ((Die Schriftart kann später auch in der Konfiguration in den Registerkarten "Erscheinungsbild" geändert werden)) Das Aussehen von efa wird maßgeblich von der verwendeten Bildschirmschrift beeinflusst.\\ Ab efa 2.4.0 sucht sich efa bei dem ersten Start aus den im System verfügbaren Schriftarten eine heraus, die eine gute Lesbarkeit unterstützt. ((Die Schriftart kann später auch in der Konfiguration in den Registerkarten "Erscheinungsbild" geändert werden))
  
-  * Windows-Systeme sind hier im Vorteil, weil das System mit standardmäßig gut lesbaren Bildschirmschriften ausgeliefert werden. Es sind keine Anpassungen erforderlich.+  * **Windows-Systeme** sind hier im Vorteil, weil das System mit standardmäßig gut lesbaren Bildschirmschriften ausgeliefert werden. Es sind keine Anpassungen erforderlich.
  
-  * Bei Linux-Systemen hängt die Menge der verfügbaren Schriften stark von der verwendeten Distribution ab.\\ Daher kann man vor der Installation von efa dafür sorgen, dass die von efa gut nutzbaren Schriften im System installiert sind. Dies funktioniert über folgenden Befehl in der Kommandozeile (Terminal-Programm):\\ ''sudo apt-get install fonts-liberation fonts-noto-core fonts-roboto-hinted''\\ \\ Ob die Schriften zur Installation verfügbar sind, hängt von der jeweiligen Distribution ab. Wenn Fehlermeldungen ausgegeben werden, dass eine Schrift nicht installiert werden konnte, ist das nicht schlimm. Jede Distribution kennt mindestens eine dieser Schriften, und alle sind auf dem Bildschirm gut lesbar.+  * Bei **Linux-Systemen** hängt die Menge der verfügbaren Schriften stark von der verwendeten Distribution ab.\\ Daher kann man vor der Installation von efa dafür sorgen, dass die von efa gut nutzbaren Schriften im System installiert sind. Dies funktioniert über folgenden Befehl in der Kommandozeile (Terminal-Programm):\\ ''sudo apt-get install fonts-liberation fonts-noto-core fonts-roboto-hinted''\\ \\ Ob die Schriften zur Installation verfügbar sind, hängt von der jeweiligen Distribution ab. Wenn Fehlermeldungen ausgegeben werden, dass eine Schrift nicht installiert werden konnte, ist das nicht schlimm. Jede Distribution kennt mindestens eine dieser Schriften, und alle sind auf dem Bildschirm gut lesbar.
  
-  * efaLive\\ efaLive hat ab Version 2.10.4 bereits alle genannten Schriften installiert. Es gibt dort kein To-Do.\\ Für frühere efalive-Versionen können die Schriften mit folgendem Befehl in einem Kommandozeilenprogramm installiert werden, wenn eine Online-Verbindung ins Internet besteht:\\ \\ ''su root''\\ ''apt-get install fonts-liberation fonts-noto-core fonts-roboto-hinted fonts-piboto''\\ \\ Wenn Fehlermeldungen ausgegeben werden, dass eine Schrift nicht installiert werden konnte, ist das nicht schlimm. Jede Distribution kennt mindestens eine dieser Schriften, und alle sind auf dem Bildschirm gut lesbar.+  * **efaLive**\\ efaLive hat ab Version 2.10.4 bereits alle genannten Schriften installiert. Es gibt dort kein To-Do.\\ Für frühere efalive-Versionen können die Schriften mit folgendem Befehl in einem Kommandozeilenprogramm installiert werden, wenn eine Online-Verbindung ins Internet besteht:\\ \\ ''su root''\\ ''apt-get install fonts-liberation fonts-noto-core fonts-roboto-hinted fonts-piboto''\\ \\ Wenn Fehlermeldungen ausgegeben werden, dass eine Schrift nicht installiert werden konnte, ist das nicht schlimm. Jede Distribution kennt mindestens eine dieser Schriften, und alle sind auf dem Bildschirm gut lesbar.
  
 ===== Installation dieser Version (Version 2.x) ===== ===== Installation dieser Version (Version 2.x) =====
Zeile 74: Zeile 74:
  
 Der Vorteil des Installers ist, dass er im Startmenü von Windows automatisch Einträge für efaBase (Efa-Administrationsprogramm) und efaBootshaus anlegt. Bei der Installation über das ZIP-Archiv muss man diese Einträge selbst anlegen. Der Vorteil des Installers ist, dass er im Startmenü von Windows automatisch Einträge für efaBase (Efa-Administrationsprogramm) und efaBootshaus anlegt. Bei der Installation über das ZIP-Archiv muss man diese Einträge selbst anlegen.
 +
 +**Hinweis:** Unter Windows würde das Programm sinnvoll unter ''c:\programme\efa2'' abgelegt. Dieses Verzeichnis ist aber grundsätzlich für Benutzer ohne administrative Rechte schreibgeschützt. Das spätere automatische Update von efa wird hierdurch fehlschlagen, weil der Standard-Nutzer keine Schreibrechte in ''c:\programme'' hat, und auch die Ausführung von efa mit Administrationsrechten aus anderen Gründen nicht zum Erfolg führt.((Bei der Ausführung mit Administrationsrechten ändert sich für efa der Benutzer, mit dem das Programm ausgeführt wird. Da efa beim jeweiligen Benutzer eine spezielle Datei im Home-Verzeichnis anlegt, wo es seine Datenbestände findet, wird beim Starten mit Administratorrechten efa sein Datenverzeichnis nicht finden.))
 +
 +Daher bietet es sich unter Windows an, ein anderes Verzeichnis für die efa-Installation zu nutzen, z.B. ''c:\efa2''.
  
 ==== Installation des ZIP-Archivs ==== ==== Installation des ZIP-Archivs ====
Zeile 80: Zeile 84:
  
 Unter Linux wäre ein sinnvolles Verzeichnis ''/opt/efa2''. Unter Linux wäre ein sinnvolles Verzeichnis ''/opt/efa2''.
- 
-Unter Windows würde das Programm sinnvoll unter ''c:\programme\efa2'' abgelegt. Dieses Verzeichnis ist aber grundsätzlich für Benutzer ohne administrative Rechte schreibgeschützt. Daher gibt es auch den Windows Installer für efa, der in dieses Verzeichnis schreiben darf.  
  
 Wenn Du unter Windows lieber über die Installation des ZIP-Archivs arbeiten möchtest, kein Problem: Grundsätzlich lässt sich efa aus jedem beliebigen Verzeichnis heraus starten. Z.B. auch aus "Dokumente" des angemeldeten Benutzers, dem Desktop, oder auch aus ''c:\efa2'', wenn ein solches Verzeichnis angelegt wurde. Wenn Du unter Windows lieber über die Installation des ZIP-Archivs arbeiten möchtest, kein Problem: Grundsätzlich lässt sich efa aus jedem beliebigen Verzeichnis heraus starten. Z.B. auch aus "Dokumente" des angemeldeten Benutzers, dem Desktop, oder auch aus ''c:\efa2'', wenn ein solches Verzeichnis angelegt wurde.
 +Die Icons im Programm-Menü oder auf dem Desktop musst Du dann aber selbst erstellen.
 ===== Starten und Einrichten von efa ===== ===== Starten und Einrichten von efa =====
  
-===== Starten von efa =====+==== Starten von efa ====
  
 Je nach Einsatzzweck bietet efa zwei verschiedene Versionen (Modi) an, in denen efa betrieben werden kann: Je nach Einsatzzweck bietet efa zwei verschiedene Versionen (Modi) an, in denen efa betrieben werden kann:
Zeile 108: Zeile 111:
 Falls efa mit dem Hinweis //Aus Gründen der Sicherheit verweigert efa den Dienst// nicht mehr starten sollte, so lösche in dem Benutzerverzeichnis Deines Computers (unter Windows z.B. ''C:\Dokumente & Einstellungen\benutzername'', unter Linux/UNIX z.B. ''/home/benutzername'') die Datei mit dem Namen ''.efa_installationspfad'', wobei //installationspfad// der Ort Deiner efa-Installation ist.\\ \\ Falls efa mit dem Hinweis //Aus Gründen der Sicherheit verweigert efa den Dienst// nicht mehr starten sollte, so lösche in dem Benutzerverzeichnis Deines Computers (unter Windows z.B. ''C:\Dokumente & Einstellungen\benutzername'', unter Linux/UNIX z.B. ''/home/benutzername'') die Datei mit dem Namen ''.efa_installationspfad'', wobei //installationspfad// der Ort Deiner efa-Installation ist.\\ \\
 Beispiel: Wenn efa unter Windows im Ordner ''C:\Programme\efa2'' efa installiert ist, dann lösche in ''C:\Dokumente & Einstellungen\benutzername'' die Datei ''.efa_CProgrammeefa2''. Beispiel: Wenn efa unter Windows im Ordner ''C:\Programme\efa2'' efa installiert ist, dann lösche in ''C:\Dokumente & Einstellungen\benutzername'' die Datei ''.efa_CProgrammeefa2''.
-Wenn unter Linux im Verzeichnis ''/opt/efa2'' efa installiert ist, dann lösche in ''/home/benutzername'' die **Datei ''.efa_optefa2''. +Wenn unter Linux im Verzeichnis ''/opt/efa2'' efa installiert ist, dann lösche in ''/home/benutzername'' die Datei ''.efa_optefa2''.
-Achtung:** Wenn mehrere Versionen von efa installiert sind, kann es mehrere, sehr ähnlich lautende Dateien geben. Achte darauf, die richtige zu löschen!+
  
-===== Einrichten von efa =====+**Achtung:** Wenn mehrere Versionen von efa installiert sind, kann es mehrere, sehr ähnlich lautende Dateien geben. Achte darauf, die richtige zu löschen! 
 + 
 +==== Einrichten von efa ====
  
 Hinweis:\\  Hinweis:\\ 
Zeile 118: Zeile 122:
 In efa 2.x sind alle Daten in einem //Projekt// organisiert. Üblicherweise wirst Du für Deinen Verein genau ein Projekt anlegen, in dem sich alle Daten befinden. In efa 2.x sind alle Daten in einem //Projekt// organisiert. Üblicherweise wirst Du für Deinen Verein genau ein Projekt anlegen, in dem sich alle Daten befinden.
  
-Um mit efa 2.x zu beginnen,  +Die wichtigsten Schritte zum Einrichten und Konfigurieren von efa sind beschrieben in  
- +  * [[quick_config|Konfigurieren und Einrichten]]  
-  * Lege als erstes im Administrations-Modus in neues Projekt an. +  * [[quick_project|Lokaler Betrieb von efa]] 
-    Prüfe, ob es mehrere Bootshäuser gibt. Die Konfiguration von Systemen mit mehreren Bootshäusern ist bei [[quick_efa1_update|Umstieg von efa 1.x]] +  * [[access_cloud|Betrieb von efa im Kontext von efaCloud]] 
-  * Erstelle anschließend ein neues, leeres Fahrtenbuch.  +  * [[config_mehrere_bootshaeuser|Betrieb von efa mit mehreren Bootshäusern]]
-    * Der Zeitraum eines Fahrtenbuchs ist bei Kanufahren in Deutschland wichtig: Hier ist die Paddelsaison jeweils 01.10. - 30.09. des Folgejahres. +
- +
-  * Konfiguration: Bezeichnungen\\ [[config_bezeichnungen|Bezeichnungen]] +
- +
-  * Boote, Personen, Ziele und sonstige Daten können entweder manuell erfaßt werden, oder über die jeweiligen Import-Funktionen im Admin-Modus importiert werden.\\ \\ *Import von Daten*\\ Die Daten haben untereinander einige Abhängigkeiten, z.B. benötigen Ziele die Gewässerdaten, oder bei Personen kann ein Standardboot eingetragen werden.\\ Daher ist beim Import folgende Reihenfolge empfehlenswert.\\ Der Import sollte über Dateien im XML-Format erfolgen. CSV-Formate können (bis Version 2.4.1) keine Gruppen-Angaben wiederherstellen. +
- +
-    - Gewässer +
-    - Ziele +
-    - Status +
-    - Personen +
-    - Gruppen +
-    - Mannschaften +
-    - Fahrtenabzeichen +
-    - Boote +
-    - Bootsschäden +
-    - Bootsreservierungen +
-    - Vereinsarbeit +
-    - Erneut importieren: Personen +
-      - hierdurch werden bei den Personen hinterlegte Standardboote korrekt gesetzt. +
- +
-    - Werden die Funktionen für Gruppen zum Einsatz, sollte nach dem Import der Daten nochmals importiert werden: +
-      - Personen +
-      - Boote +
- +
-Die wichtigsten Schritte zum Einrichten und Konfigurieren von efa sind in [[quick_config|Konfigurieren und Einrichten]] beschrieben.+
  
  
  
quick_install.1737908261.txt.gz · Zuletzt geändert: 2025/01/26 17:17 von smg