efa DokuWiki

Diese Seite ist nicht editierbar. Du kannst den Quelltext sehen, jedoch nicht verändern. Kontaktiere den Administrator, wenn du glaubst, dass hier ein Fehler vorliegt.
====== Installation von efa - elektronisches Fahrtenbuch - Version 2 ======


Dises Dokument beschreibt die Installation von efa sowie den Umstieg von Version 1.x auf Version 2.x.

===== Hilfe und Support =====

Hilfe und Support bei Installationsproblemen und sonstigen Fragen zu efa erhälst Du im Support-Forum unter: [[http://forum.nmichael.de]].

===== Anforderungen der Version 2.x =====

  * Hardware:
    * Computer mit mindestens 256 MB RAM
    * Bildschirm mit einer Auflösung von mindestens 1024 x 768
  * Software:
    * Bis efa Version 2.3.2 : [[http://www.oracle.com/technetwork/java/javase/downloads/index.html|Java Runtime Environment (JRE) Version 6 oder neuer]]
    * Ab efa Version 2.4 : [[https://openjdk.org/|Java Runtime Version Version 8 oder neuer]]

===== Erläuterung zu den Versionsbezeichnungen =====

{{:efaversions.png?nolink|}}

**"Version 1.x"** bezieht sich auch alle efa1-Versionen bis einschließlich Version 1.8.3, sowie auf die ersten efa2-Vorab-Versionen mit der internen Versionsnummer 1.9.0.

**"Version 2.x"** bezieht sich auf die efa2-Vorab-Version efa2_beta (interne Versionsnummer 1.9.9) sowie die Version 2.0 und alle Folgeversionen 2.x.

Um die von Dir verwendete efa-Version in Erfahrung zu bringen, klicke bitte in efa auf das efa-Logo oder wähle aus dem Menü //Hilfe// die Option //Info//.

===== Installation dieser Version (Version 2.x) =====

Falls Du bereits eine frühere Version von efa (Version 1.x) verwendest, installiere (bzw. entpacke) diese Version in ein separates Verzeichnis und folge den Anweisungen im Abschnitt [[#Umstieg von efa Version 1.x auf Version 2.x]].

Falls dies eine Erstinstallation von efa ist, installiere (bzw. entpacke) efa bitte in ein leeres Verzeichnis und folge dann denn Anweisungen in [[#Starten und Einrichten von efa]].

Falls dies ein Update auf eine Version 2.x von efa ist, installiere (bzw. entpacke) diese Version bitte in dasselbe Verzeichnis der Installation, die Du aktualisieren möchtest. **Achtung:** Dies gilt nur, wenn die zuvor verwendete Version von efa eine Version 2.x ist (interne Versionsnummern 1.9.9, 2.0 oder neuer)!

==== Installation mittels Windows-Setup-Programm ====

Wenn Du efa als Windows-Setup-Programm heruntergeladen hast, so starte einfach das Setup-Programm und folge den Schritten durch die Installation.

==== Installation des ZIP-Archivs ====

Wenn Du efa als ZIP-Archiv heruntergeladen hast, so erstelle ein neues Verzeichnis für efa (z.B. ''c:\programme\efa2'' unter Windows oder ''/opt/efa2'' unter Linux) und entpacke den Inhalt des ZIP-Archivs in dieses Verzeichnis.

===== Starten und Einrichten von efa =====

===== Starten von efa =====

Je nach Einsatzzweck bietet efa zwei verschiedene Versionen (Modi) an, in denen efa betrieben werden kann:

  * Die Bootshaus-Version **efa-Bootshaus** startet mit einer vereinfachten Oberfläche, die für den Einsatz im Bootshaus gedacht ist, bei der Vereinsmitglieder ihre Fahrten direkt in efa eintragen und sämtliche Administrationsaufgaben nur paßwortgeschützt von einem Administrator durchgeführt werden können.
  * Die Basis-Version **efa-Basis** startet mit einer Administrations-Oberfläche mit vollem Zugriff auf alle Daten und ist für den Einsatz eines Bootswarts, Administrators oder einer Privatperson gedacht.

Bei Verwendung des Windows-Setup-Programms werden automatisch Einträge zum Starten von efa im Windows-Startmenü erzeugt.

Ansonsten kann efa durch folgende Batch-Dateien bzw. Skripte gestartet werden:

| ''efaBase.sh''	| efa Basis-Version (Linux/UNIX)             |
| ''efaBase.bat''	| efa Basis-Version (Windows)                |
| ''efaBths.sh''	| efa Bootshaus-Version (Linux/UNIX)         |
| ''efaBths.bat''	| efa Bootshaus-Version (Windows)            |
| ''efaCLI.sh''	        | efa Kommandozeilen-Programm (Linux/UNIX)   |
| ''efaCLI.bat''	| efa Kommandozeilen-Programm (Windows)      |

==== Startprobleme ====

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''.
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 =====

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, lege als erstes im Administrations-Modus in neues Projekt an. Falls Du Daten aus Version 1.x importieren möchtest, folge den Anweisungen im Abschnitt [[#Umstieg von efa Version 1.x auf Version 2.x]].

Ansonsten erstelle anschließend ein neues, leeres Fahrtenbuch. Boote, Personen, Ziele und sonstige Daten können entweder manuell erfaßt werden, oder über die jeweiligen Import-Funktionen im Admin-Modus importiert werden. Bei der Reihenfolge des Imports sind dabei unter Umständen gewisse Abhängigkeiten zu beachten (zum Beispiel müssen die Status, die eine Person haben kann, importiert oder angelegt werden, bevor die Personen importiert werden; die Gewässer vor den Zielen usw.). **Hinweis:** Dieser Import ist //nicht// für Daten der Version 1.x geeignet!

Die wichtigsten Schritte zum Einrichten und Konfigurieren von efa sind in [[quick_config|Konfigurieren und Einrichten]] beschrieben.

Zur Erläuterung der Versionsnummer, siehe Abschnitt [[#Erläuterung zu den Versionsbezeichnungen]].

==== Voraussetzungen für den Umstieg von Version 1.x auf Version 2.x ====

efa Version 2.x kann nur Daten aus den 1.x-Versionen 1.8.3 sowie 1.9.0 importieren. Falls Du eine ältere Version als 1.8.3 benutzt, so aktualisiere diese zuerst auf [[http://efa.nmichael.de/download.html.de#old|Version 1.8.3]].

==== Vorbereitungen in efa Version 1.x vor dem Import der Daten in die Version 2.x ====

Folgende Schritte sollten in Version 1.x vor dem Datenimport in die neue Version durchgeführt werden:

  - **Alle Daten der Version 1.x in efa 1.8.3 (oder 1.9.0) öffnen**\\ Damit alle Daten, auch alte Fahrtenbücher, Mitgliederlisten usw., in das Format der Version 1.8.3 (oder 1.9.0) konvertiert werden, müssen sie zumindest einmal von efa angefaßt werden. Um dies zu bewerkstelligen, erstelle in efa 1.x eine Statistik mit der Option fahrtenbuchübergreifend ohne Einschränkung auf einen bestimmten Zeitraum.
  - **Installationsverzeichnis von efa 1.x dokumentieren**\\ Bitte notiere das Installationsverzeichnis Deiner efa 1.x Installation. Diese Information wird beim Datenimport in die Version 2.x abgefragt.
  - **Bereinigung und Dokumentieren aller Fahrtenbücher, Mitgliederlisten usw.**\\ Für den Import in die Version 2.0 ist es wichtig, daß die Daten in efa 1.x fehlerfrei sind. Bitte öffne alle Fahrtenbücher, eins nach dem anderen, und prüfe, ob alle Fahrtenbücher sowie ihre Boots-, Mitglieder-und Ziellisten vollständig sind. Du findest diese Informationen unter //Administration - Fahrtenbuch - Einstellungen zum Fahrtenbuch//, bzw. in der Bootshaus-Version im //Admin-Modus - Fahrtenbuch-Vollzugriff - Administration - Fahrtenbuch - Einstellungen zum Fahrtenbuch//.\\ Durch die Verknüpfung von Fahrtenbüchern über //vorheriges Fahrtenbuch// und //nächstes Fahrtenbuch// ergibt sich eine Kette von Fahrtenbüchern, z.B. 2009 <-> 2010 <-> 2011. Stelle sicher, daß diese Kette vollständig und korrekt ist, d.h. z.B. wenn das Fahrtenbuch 2010 als vorheriges Fahrtenbuch auf 2009 verweist, dann muß auch das Fahrtenbuch 2009 als nächstes Fahrtenbuch auf 2010 verweisen usw.\\ Falls Du Test-Fahrtenbücher oder unvollständige Fahrtenbücher hast, die nicht importiert werden sollen, so notiere deren Namen separat.\\ Bitte notiere für alle Fahrtenbücher:
    * Name und Speicherort des Fahrtenbuchs
    * Name und Speicherort der Mitglieder-, Boots-, und Zielliste
    * Verknüpfung zur vorherigen und folgenden Fahrtenbuchdatei
  - **Synonyme in efa 1.x korrigieren oder erstellen**\\ Damit Daten beim Import in efa 2.x korrekt importiert werden, überprüfe bitte insbesondere im Fall von Kombibooten und Personen, deren Namen sich geändert haben, ob diese in efa 1.x mit entsprechenden Synonymen erfaßt sind. In efa 1.x sind zwei Boote, Personen oder Ziele gleich, wenn ihre Namen (bzw. Vor- und Nachnamen, und im Falle von Booten und Personen Vereinsnamen) gleich sind, oder für die unterschiedlichen Namen ein gemeinsames Synonym existiert.\\  Damit efa 1.x und 2.x erkennen, daß es sich beispielsweise bei den Booten Kombiboot - Skull und Kombiboot - Riemen um dasselbe Boot handelt, sollte in der Synonymliste für Boote ein Eintrag mit //Hauptnamen// Kombiboot und //Synonymen// Kombiboot - Skull und Kombiboot - Riemen existieren.\\ Falls sich der Name von //Manuela Musterfrau// in //Manuela Mustermann// geändert hat und beide Namen in den Mitgliederlisten vorkommen (z.B. ersterer in der 2010er und letzterer in der 2011er Mitgliederliste), muß in der Synonymliste für Mitglieder ein Eintrag mit //Hauptnamen// Manuela Mustermann und //Synonym// Manuela Musterfrau existieren. Nur so wird Manuela als eine Person (und nicht als zwei unterschiedliche Personen) importiert.
  - **Zeitraum eines Fahrtenbuchs**\\ In efa 1.x passiert es manchmal, daß eine Fahrt mit einem falschen Datum erfaßt wird, etwa 12.3.2021 anstatt 12.3.2011. Solche Einträge sollten unbedingt vor dem Import korrigiert werden. Am einfachsten findest Du diese fehlerhaften Einträge, indem Du für das Fahrtenbuch ohne die Option //fahrtenbuchübergreifend// eine Statistik erstellst (ohne Einschränkung auf einen Zeitraum) und bei der Auswertung darauf achtest, in welchem Zeitraum efa Fahrten gefunden hat.
  - **efa im Boothaus**\\  Falls Du efa im Bootshaus eingesetzt hast, beende vor dem Import alle noch offnen Fahrten.
  - **Erstellen von Statistiken**\\ Um später zu Überprüfen, ob die Daten vollständig und korrekt in efa 2.x importiert worden, solltest Du jetzt in efa 1.x Statistiken erstellen, und diese dann nach dem Import mit entsprechenden Statistiken in efa 2.x vergleichen.
  - **Datensicherung**\\ efa 2.x verändert oder löscht keine Daten der Version 1.x. Da aber Fehler und Fehlbedienungen nie ganz auszuschließen sind, solltest Du jetzt eine Sicherung aller Deiner Daten aus efa 1.x erstellen, und diese auf einem separaten Datenträger (z.B. USB-Stick) abspeichern.\\ Wenn Du alle Daten im daten-Verzeichnis gespeichert hast (siehe oben), genügt es, dieses Verzeichnis zu sichern.

==== efa Version 2.x installieren ====

Installiere oder entpacke efa 2.x in ein neues, leeres Verzeichnis, wie im Abschnitt [[#Installation dieser Version (Version 2.x)]] beschrieben.

==== Vorbereiten von Version 2.x für den Import ====

Wenn in efa 1.x eigene Bezeichnungen für Fahrtarten oder Bootstypen definiert wurden, dann müssen diese Bezeichnungen **vor** dem Import in efa 2.x eingetragen werden. Bitte gehe in diesem Fall in die efa-Konfiguration, aktiviere den //Expertenmodus//, und füge in den entsprechenden Rubriken unter //Bezeichnungen// die von Dir definierten Bezeichnungen durch Klicken auf das Plus-Symbol hinzu. Als Name der Bezeichnung (erscheint in rot auf der linken Seite) muß **exakt derselbe** Name (in identischer Schreibweise) wie in efa 1.x verwendet werden.

==== Import der Daten von Version 1.x in die Version 2.x ====

Nach der Installation, starte efa 2.x bitte wie in Abschnitt [[#Starten und Einrichten von efa]] beschrieben und erstelle ein neues Projekt. Unmittelbar nach dem Erstellen des Projekts erscheint eine Frage, ob Du Daten aus Version 1.x importieren möchtest. Wähle diese Option aus.
**Hinweis:** Dies ist die einzige Möglichkeit, Daten von Version 1.x in die Version 2.x zu importieren. Ein Import zu einem späteren Zeitpunkt ist nicht möglich!

**Achtung beim Import von efa1-Daten aus mehreren Bootshäusern oder separaten efa1-Installationen:** efa2 erstellt beim Import für jeden Datensatz (Person, Boot, usw.) eine weltweit eindeutige ID. Damit später efa2-Daten zwischen verschiedenen efa2-Installationen (etwa in mehreren Bootshäusern) ausgetauscht werden können, müssen die Daten **in einem Schritt in ein einziges Projekt** importiert werden. Es müssen also zunächst sämtliche efa1-Daten aus allen efa1-Installationen zusammengeführt werden. Ferner müssen die Mitglieder-, Boots-, und Ziellisten zwischen efa1-Fahrtenbüchern desselben Jahres identisch sein, d.h. alle Mitglieder, Boote und Ziele müssen in allen 2011er Fahrtenbüchern (aller Bootshäuser oder efa1-Installationen) identisch sein, ebenso alle Boote, Ziele usw. Anderenfalls kann es beim Import nach efa2 zu Fehlermeldungen kommen. Anschließend müssen alle efa1-Daten //in einem Rutsch// in ein einziges efa2-Projekt importiert werden. Dieses efa2-Projekt kann dann in verschiedenen efa2-Installationen (z.B. in mehreren Bootshäusern) verwendet werden.

Im ersten Dialog des Datenimports, wähle den Ort Deiner efa 1.x-Installation aus, den Du zuvor notiert hast.

efa durchsucht die ausgewählte efa 1.x-Installation nach Daten und bietet Dir eine Auswahl an zu importierenden Daten. Selektiere hier alle Daten, die Du importieren möchtest (normalerweise alle), und vergib für die Fahrtenbücher einen Namen sowie einen Zeitraum.
**Achtung:** In efa2 können Fahrtenbücher nur Fahrten aus dem konfiguierten Zeitraum aufnehmen. Alle Fahrten, die importiert werden sollen, müssen in dem hier angegebenen Zeitraum liegen (siehe Schritt [[#Vorbereitungen]]).

Beim Import wird eine Logdatei erstellt, in der Warnungen und Fehler verzeichnet werden. Falls viele Fehler auftreten, lösche das Projekt wieder, versuche diese in efa 1.x zu korrigieren, und importiere die Daten erneut. Falls einige wenige Fehler auftreten, können diese auch direkt in efa 2.x manuell korrigiert werden. Hilfe bei Fragen und Problemen erhälst Du im [[http://forum.nmichael.de/|Support-Forum]].

Nach erfolgtem Import, prüfe die Daten gründlich (z.B. durch das Vergleichen von Statistiken mit denen aus Version 1.x), und beginne den Produktiveinsatz von efa 2.x erst, wenn Du sicher bist, daß alle Daten korrekt importiert wurden und efa 2.x ordnungsgemäß damit arbeitet.

==== Limitierungen des Imports ====

  * nicht importiert werden:
    * Konfiguration, Administratoren, Bezeichnungen
    * Nachrichten und Logdateien
    * Statistikeinstellungen
  * nicht korrekt importiert werden:
    * Bootsstatus für Boote auf Fahrt (daher Fahrten vorher beenden!)
    * Gewässer für Mehrtagesfahrten (gehen verloren)
  * Daten sollten gründlich geprüft werden insbesondere bei Verwendung von:
    * Synonymen
    * Kombibooten
  * Häufige Ursache von Versionskonflikten beim Import sind mehrere Fahrtenbücher mit demselben Datum als Gültigkeitsbeginn
efa DokuWiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
