Genealogie: Installation
Installation der Version 1.2.2 (bzw. V1.2.1, V1.2.0, V1.1.0, V1.0.0):

1. Download Genealogie. Der Download erfolg als ZIP-Datei, das alle notwendigen Files enthält.
 
2. Entpacken Sie das ZIP-File an gewünschten Stelle. Danach befinden sich alle benötigten Dateien unter dem Verzeichnis Genealogie in der folgenden Ordnerstrukture:

 Genealogie   PHP's der Darstellungsschicht (und styles.css) 
 Application   PHP's der Applicationsschicht 
 DB   PHP's der Datenbankschicht 
 Documentation   ...   Diese WEB-Dokumentaion 
 Documents   Uploaded Documents ... 
 images   *.gif 
 Install   DataModel   Datenmodell (PowerDesigner) 
 Log   Logfiles Install ... 
 Scripts   Installationsscripts für mySQL (V4.0.12 oder höher) 
 Photos   Uploaded Photos ... 
 Structure   PHP's der Daten-Structureschicht 

Eine ausführliche Aufstellung aller Dateien finden Sie hier.
 
3. Rufen Sie die Install-Site Install.php im Verzeichnis Genealogie\Install über Ihren WEB-Server auf:

Install
 
4. Geben Sie hier als erstes die Login-Parameter für die mySQL-Datenbank an. Der hier angegebene Account muß ein gültiger Datenbank-Account mit den notwendigen Rechten für das Anlegen von Datenbank-Objekten sein.

Die Installation ist nur möglich, wenn sich der angegebene Account gegen die mySQL-Datenbank authentifizieren kann. Dadürch wird eine mißbräuchliche Installation (z.B. wenn "zufällig" jemand diese Seite aufrufen sollte) verhindert.
 
5. Wählen Sie nun die notwendigen Installationsschritte aus. Diese werden bei Aktivierung nacheinander von oben nach unten ausgeführt:

CreateDBConnect  Als einzige Konfigrations-Parameter außerhalb der mySQL-Datenbank werden die in dieser Site angegebenen Login-Parameter benötigt. Diese müssen in der Datei Connect.inc.php hinterlegt werden:

 
<?php
  DBServer = localhost
  DBDatabase = Datenbank
  DBLogin = User
  DBPassword = Password
?>
 

Ist dieser Konfigurationsschritt aktiviert, werden die gegen die mySQL-Datenbank authentifizieren Login-Parameter automatisch in dieser Datei gespeichert.

Durch die Datei-Endung .php und die Klammerung der Parameter in den Blöcken <?php und ?> werden die Parameter vom WEB-Server als PHP-Script interpretiert. Wird diese Datei über den WEB-Server aufgerufen, so wird lediglch eine Fehlermeldung angezeigt, nicht jedoch die Parameterwerte!

Werden die Login-Parameter geändert, dann kann durch alleiniges Ausführen dieses Installationsschrittes eine neue Konfigurations-Datei Connect.inc.php angelegt werden.
 
SQL: Drop Tables  Tabellen, die sich noch durch vorherige Installationen auf der mySQL-Datenbank befinden, werden mit diesem SQL-Script entfernt. Wird bei der Erstinstallation nicht benötigt.
 
SQL: Create Tables  Dieses SQL-Script legt die für Genealogie benötigten Tabellen auf der mySQL-Datenbank an.
 
SQL: Alter Tables  Optional: Unterstützt die zum Einsatz kommende mySQL-Version referenzielle Integrität, so können mit diesem SQL-Script die entsprechenden Foreign Keys angelegt werden. Die Ausführung ist rein optional! Genealogie läuft auch ohne Ausführung dieses Scripts ohne Einschränkungen.
 
SQL: Values  Mit diesem SQL-Script werden die notwendigen Initalisierungs- und Start-Werte in die mySQL-Datenbank eingefügt.

Der Installationsvorgang kann jederzeit wiederholt werden und damit die Datenbank neu initalisiert werden. Beachten Sie jedoch, daß dadurch alle Daten in der Datenbank gelöscht werden (außer die in das Verzeichnis Documents hochgeladenen Dokumente). Sichern Sie sie daher vorher alle Daten. Benutzen Sie dazu die Genealogie-Funktion Backup oder die mySQL-Dump Funktionalität.
 
6. Optional: Für die Erzeugung von PDF-Dokumenten:

Zum Erzeugen von PDF-Dokumenten wird eine Installation der FPDF-Library benötigt. Die FPDF-Library ist ein Open-Source Projekt. Es ist vollständig in PHP geschrieben und stellt ein Objekt zur Verfügung, mit dem aus PHP heraus PDF-Dokumente erzeugt werden können. Der Funktionsumfang der FPDF-Library ist nicht ganz so umfangreich wie der der PDFlib. Dafür kann die FPDF-Library kostenfrei ohne technische Einschränkungen eingesetzt werden.

Die Installation der FPDF-Library ist nicht zwingend erforderlich. Genealogie ist auch ohne die Installation von FPDF-Library voll funktionsfähig. Ist keine FPDF-Library installiert sind lediglich die Buttons für die Erzeugung der PDF-Dokumente ausgeblendet.

1. Download der FPDF-Library (Version v1.53)
 
2. Installation der FPDF-Library: Dazu wird unter dem Document-Root (Apache: ../htdocs) das Verzeichnis fpdf erzeugt. Die Files der FPDF-Library werden darin entpackt.
 
3. Genealogie benötigt jetzt noch die relative Pfadangabe zum "Objekt-File" fpdf.php ausgehend vom Document-Root. In dieser Beispiel-Installation wäre das: fpdf/. Diese Pfadangabe wird unter dem Menupunkt: Administration/Edit Parameters eingetragen:

FPDF-Parameter


Upgrade von Version 1.0.0 nach Version 1.1.0:

1. Download des Upgrade. Der Download erfolg als ZIP-Datei, das alle geänderten und zusätzlichen Files enthält. Der Inhalt braucht daher einfach nur über das bestehende Verzeichnis Genealogie kopiert werden.
 
2. Das Script V100-v110.sql im Verzeichnis Genealogie/Install/Scripts ist gegen die Datenbank auszuführen:

 
# cat < Genealogie/Install/Scripts/V100-V110.sql | mysql -u user -p password -D database

 


Upgrade von Version 1.1.0 nach Version 1.2.0:

1. Download des Upgrade. Der Download erfolg als ZIP-Datei, das alle geänderten und zusätzlichen Files enthält. Der Inhalt braucht daher einfach nur über das bestehende Verzeichnis Genealogie kopiert werden.
 
2. Das Script V110-v120.sql im Verzeichnis Genealogie/Install/Scripts ist gegen die Datenbank auszuführen:

 
# cat < Genealogie/Install/Scripts/V110-V120.sql | mysql -u user -p password -D database

 


Upgrade von Version 1.2.0 nach Version 1.2.1:

1. Download des Upgrade. Der Download erfolg als ZIP-Datei, das alle geänderten und zusätzlichen Files enthält. Der Inhalt braucht daher einfach nur über das bestehende Verzeichnis Genealogie kopiert werden.
 
2. Das Script V120-v121.sql im Verzeichnis Genealogie/Install/Scripts ist gegen die Datenbank auszuführen:

 
# cat < Genealogie/Install/Scripts/V120-V121.sql | mysql -u user -p password -D database

 


Upgrade von Version 1.2.1 nach Version 1.2.2:

1. Download des Upgrade. Der Download erfolg als ZIP-Datei, das alle geänderten und zusätzlichen Files enthält. Der Inhalt braucht daher einfach nur über das bestehende Verzeichnis Genealogie kopiert werden.
 
2. Das Script V121-v122.sql im Verzeichnis Genealogie/Install/Scripts ist gegen die Datenbank auszuführen:

 
# cat < Genealogie/Install/Scripts/V121-V122.sql | mysql -u user -p password -D database

 


Upgrade von Version 1.0.0 nach Version 1.2.2:

1. Anweisung entsprechend "Upgrade von Version 1.0.0 nach Version 1.1.0" ausführen.
 
2. Anweisung entsprechend "Upgrade von Version 1.1.0 nach Version 1.2.0" ausführen.
 
3. Anweisung entsprechend "Upgrade von Version 1.2.0 nach Version 1.2.1" ausführen.
 
4. Anweisung entsprechend "Upgrade von Version 1.2.1 nach Version 1.2.2" ausführen.
.:  :.