easydb-Installation

Installation easydb

Im aktuellen Beispiel installieren wir eine easydb in einem frisch aufgesetzen Debian-Linux-Server.

Den Schritt Betriebssystem-Installation führen Sie bitte zuerst durch.

Wir setzen Grundkenntnisse im Umgang mit Linux und der Kommandozeile voraus.

Ersetzen Sie in allen folgenden Kommandos <INSTANCE> durch den Namen Ihrer Instanz. Andere Variablen (<SERVER-IP>, etc.) ersetzen Sie sinngemäß.

Vorbereitungen

Die Installation der easydb erfolgt mittels dem Paketmanagement von Debian. Die easydb hängt von einigen Paketen aus dem non-free repository ab, daher müssen in /etc/apt/sources.list mindestens folgende Einträge stehen:

deb http://ftp.de.debian.org/debian <releasename> main contrib non-free
deb http://security.debian.org/  <releasename>/updates  main contrib non-free

<releasename> muss natürlich durch den entsprechenden Code-Namen des Releases ersetzt werden.

Programmfabrik Repositories hinzufügen

Lesen sie diesen Schritt bitte unter Paketquellen nach.

Pakete installieren

apt-get install easydb-asset-server easydb-instance-<INSTANCE>

Die Nachfrage, ob installiert werden soll, beantworten Sie mit "y"(es).

Datenbank Installation

Die Datenbank postgresql wurde beim vorherigen Schritt automatisch installiert. Zum Einrichten der Datenbank sind noch die folgenden Schritte nötig:

Zugriffsrechte

Editieren Sie /etc/postgresql/<VERSIONS_NUMMER>/main/pg_hba.conf. Ändern Sie die Zeile

local   all         postgres                          ident

bzw. bei neuen PostgreSQL-Versionen:

local   all         postgres                          peer

indem Sie das letzte Wort durch "trust" ersetzen.

local   all         postgres                          trust

Starten Sie den PostgreSQL Daemon neu.

pg_ctlcluster 9.1 main restart

Dieser Schritt schaltet die Passwort-Kontrolle für lokale Verbindungen vom selben System aus! Für ausführlichere PostgreSQL-Konfiguration und der Einrichtung eines Passwortes konsultieren Sie bitte www.postgresql.org.

Datenbank anlegen

createdb -U postgres <INSTANCE>

Sie haben jetzt eine Datenbank mit dem Namen easydb eingerichtet. Diese easydb kann über den User "postgres" ohne Passwortschutz angesprochen werden.

Config-Dateien einrichten

Die Paketinstallation kümmert sich um die meiste Installation, so dass nur noch 2 Dateien angefasst werden müssen:

  • easydb-Konfiguration in /etc/opt/easydb/easydb.conf
  • Apache-Konfiguration in /etc/apache2/sites-available/easydb

Starten Sie den easydb-Service mit:

Basis easydb-config

Legen Sie die Datei /etc/opt/easydb/<INSTANCE>.conf mit dem folgenden Inhalt an:

PDO_DATA_DSN=pgsql:dbname=<INSTANCE> user=postgres
EAS_INTERNAL_URL=http://localhost/eas
EAS_EXTERNAL_URL=/eas
ADMIN_EMAIL=<EMAILADRESSE>

EMAILADRESSE ersetzen Sie mit der E-Mail-Adresse des Systemadministrators.

Maintenance-config

Editieren Sie die Datei /etc/opt/easydb/instances.d/default.conf und fügen Sie folgende Zeile ein:

url=http://<benutzer>:<passwort>@<domainname>/

Der Benutzer und das Passwort müssen zu einem easydb-Benutzer gehören, der Dommainname muss der sein, unter der die easydb lokal erreichbar ist. Weitere Details finden Sie unter Wartungsprozess der easydb.

Apache-Host einrichten

Legen Sie die Datei /etc/apache2/sites-available/easydb mit dem folgenden Inhalt an:

Include /etc/opt/easydb/eas/apache-easydb-asset-server.inc
Include /opt/easydb/4.0/conf/apache-fastcgi.inc

<VirtualHost *:80>
        ServerName <DOMAIN_DES_SERVERS>
        DocumentRoot /opt/easydb/4.0/docroot
        SetEnv EASYDB_ROOT /opt/easydb/4.0/docroot
        SetEnv EASYDB_CONF %ENVIRONMENT%,/etc/opt/easydb/<INSTANCE>.conf
        SetEnv EASYDB_INSTANCE <INSTANCE>

        Include /opt/easydb/4.0/conf/apache-easydb.inc

        Use EasydbAssetServer /opt/easydb/eas /var/opt/easydb/lib/eas/partitions /var/run/easydb/fcgi-socket
        Use EasydbAssetServerAllowedHost "127.0.0.1 ::1 <SERVER-IP>"
        Use EasydbFastcgi easydb /opt/easydb/4.0 /var/run/easydb/easydb-4.0-spawn-fcgi.sock
</VirtualHost>

Ersetzen Sie INSTANCE durch den Namen Ihrer Instanz. SERVER-IP ersetzen Sie mit der IP Ihres Servers. Seit Version 4.0.241 kann die easydb auch unter Benutzung von FastCGI installiert werden. Die notwendigen Änderungen erfahren Sie auf der Hilfeseite zur Apache-Konfiguration.

Aktivieren Sie diese Instanz, in dem Sie die Standardinstanz de-aktivieren und die easydb-Instanz aktivieren:

a2dissite default
a2ensite easydb
apache2ctl reload

Diese Befehle aktivieren den easydb-Virtual-Host.

Upload-Limit hochsetzen

Setzen Sie in /etc/php5/cgi/php.ini folgende Parameter hoch:

max_input_vars = 10000
upload_max_filesize = 100M
post_max_size = 100M

Starten Sie danach mit /etc/init.d/easydb-4.0 restart den FastCGI-Dienst neu.

Diese beiden Werte begrenzen, wie groß ein hochgeladenen Datei maximal sein darf. Standardmäßig ist das Limit auf 2 MB gesetzt, was für viele Anwendungsfälle zu niedrig ist.

Dienste starten

/etc/init.d/apache2 restart
/etc/init.d/easydb-asset-server start

Jetzt sollte Ihre easydb im Grundsatz installiert sein. Alles weitere erledigen Sie nun direkt in der easydb.

easydb initialisieren

Öffnen Sie SERVER-HOST in Ihrem Web-Browser. Sie sollten jetzt eine Ausgabe der easydb sehen, welche Sie darüber informiert, dass sich easydb im Service-Mode befindet.

Klicken Sie auf Go to the easydb service tool. Es öffnet sich ezadmin, das easydb-Servicecenter.

Klicken Sie auf Jetzt initialisieren, um die initialen easydb Tabellen in die Datenbank zu spielen.

Klicken Sie auf Daten-Tabellen initialisieren, um die Daten-Tabellen in die Datenbank zu spielen. Klicken Sie dann auf Ok.

Jetzt hat easydb auch einen ersten Benutzer eingespielt. Der Benutzer hat das Login admin und das Passwort admin. Loggen Sie sich jetzt damit ein, wenn der Browser Sie um ein Passwort bittet.

Klicken Sie auf Service-Mode aufheben, um den Service-Mode zu beenden. Klicken Sie dann auf Ok.

Sie sind nun fertig mit der Basis-Installation der easydb. Lesen Sie hier, wie Sie ein erstes Asset in die easydb laden.

Klicken Sie auf Zur easydb…, um zum Startbildschirm der easydb zu gelangen.