Die Konfigurationsdatei des easydb-Asset-Servers liegt unter /etc/opt/easydb/eas/easydb-asset-server.conf.
Einstellungen für den Start und die Umgebung des EAS sind in /etc/default/easydb-asset-server.
Der EAS kann gleichzeitig mehrere sogenannte Worker-Prozesse starten, um die verfügbaren Ressourcen gut auszunutzen. Es sollten jedoch nicht mehr Worker gestartet werden, als der Server Prozessorkerne hat, besser noch weniger, um dem EAS-Service und der easydb genug Ressourcen zu lassen.
Worker-Prozesse sind für die eigentliche Berechnung der Vorschauversionen und anderer potentiell zeitintensiver Arbeiten wie dem Erstellen von ZIPs und PowerPoint-Präsentationen zuständig.
EAS_NUM_WORKERS=1
Die Variable "EAS_NUM_SOFFICE" (unten) muss immer auf einen höheren Wert gesetzt werden als EAS_NUM_WORKERS.
Die Service-Prozesse nehmen Anfragen von der easydb entgegen und beantworten diese entweder direkt oder legen Arbeitsaufträge für die Worker-Prozesse in die Warteschlange. Es sollten immer ausreichend Service-Prozesse zur Verfügung stehen, da sonst die auch die Interaktion mit der easydb blockiert wird. Für viele Installation ist der Vorgabewert von 5 ausreichend, zumal Verbindungen erst abgelehnt werden, wenn die Anzahl der gleichzeitigen Verbindungen eine gewisse Grenze überschreitet (3 × n + 10).
EAS_NUM_SERVICES=5
EAS_FCGI_SOCKET=/var/run/easydb/fcgi-socket
EAS_NUM_SOFFICE=2
EAS_SOFFICE_BASEPORT=2002
Der EAS-Worker ändert beim Starten seinen Nutzer und seine Gruppe, um die Aufgaben mit weniger Rechten zu erfüllen. Momentan muss das der gleiche Nutzer sein, mit dem auch der EAS-Service, also der Apache-Webserver läuft. Unter Debian ist das der Nutzer www-data mit der Gruppe www-data, UID und GID sind 33.
EAS_EUID=33
EAS_EGID=33
Der DSN bestimmt die Verbindung zur PostgreSQL-Datenbank. Folgende Werte sind (leerzeichengetrennt) möglich:
host: Hostname des Datenbank-Servers oder lokales Socket-Verzeichnisport: Port des DB-Servers, auch für Socket-Verbindung notwendiguser: Benutzernamedbname: Name der Datenbankpassword: (optional) Passwort bei entsprechender Konfiguration des DB-ServersEAS_PG_DSN=host=/var/run/postgresql port=5432 user=postgres dbname=easydb
Hier kann eingeschränkt werden, aus welchen Verzeichnissen der EAS Assets vereinnahmen darf. Aus Sicherheitsgründen sollte diese Einstellung natürlich möglichst restriktiv sein, muss aber auf jeden Fall das Upload-Verzeichnis der easydb (eine PHP-Einstellung) umfassen.
EAS_SAFE_PATHS=/var:/home:/tmp
Alle Meldungen des EAS werden in diesem Verzeichnis abgelegt. Sollten sehr früh Warnmeldungen und Fehler auszugeben sein, können diese auch in /tmp liegen.
EAS_LOG_DIR=/var/opt/easydb/log/eas
In dieses Verzeichnis legt der EAS-Worker Statusinformationen und PID-Dateien ab.
EAS_VAR_DIR=/var/run/easydb
Unterhalb dieses Verzeichnisses werden temporäre Dateien, die bei der Erstellung von Versionen notwendig sind, abgelegt. Die Vorgabe ist /tmp, es wird jeweils ein Verzeichnis für jede Aufgabe angelegt und nach Abschluss wieder gelöscht.
# EAS_TMP_DIR=/tmp
Der easydb-Zoomer legt unkomprimierte Bilder für den schnellen Zugriff temporär ab. Dies geschieht normalerweise in einem Verzeichnis namens "zoomer" im temporären Verzeichnis ("/tmp" bzw. EAS_TMP_DIR). In diesem Verzeichnis wird bei aktiviertem Janitor automatisch aufgeräumt, es sollte also ausschließlich für diesen Zweck verwendet werden.
EAS_ZOOMER_TMP_DIR=/var/tmp/zoomer-eas
Dieses Verzeichnis enthält symbolische Links auf die eigentlichen EAS-Partitionsverzeichnisse. Die Links werden durch die Datenbank-ID der Partition bestimmt und vom EAS-Worker selbst verwaltet. Ein gemeinsames Verzeichnis ist notwendig, um den Konfigurationsaufwand in Grenzen zu halten, da der Apache die Dateien in den einzelnen Partitionen ausliefern muss und diese dem Webserver nicht einzeln bekannt sind.
EAS_PARTITION_BASE_DIR=/var/opt/easydb/lib/eas/partitions
Stellt der EAS fest, dass die Mindestgröße in Bytes auf einer EAS-Partition unterschritten wird, wird diese deaktiviert. Der Standardwert beträgt 1 Gigabyte.
# EAS_PARTITION_MIN_FREE=1073741824
Der Code aus diesem Verzeichnis wird ausgeführt. Im Normalfall sollte diese Einstellung nicht geändert werden.
EAS_EXEC_DIR=/opt/easydb/eas
Der EAS kann Assets vom alten, dateibasierten Typ während des Zugriffs in die Datenbank migrieren. Damit ist eine schrittweise Umstellung auf das neue System möglich. Standardmäßig ist dieses Verhalten aber deaktiviert, da es bei vielen Anfragen auf nicht vorhandene Assets zu Leistungseinbußen kommen kann.
# EAS_MIGRATE_ASSETS=1
# EAS_ORIGINAL_STORE=/home/eas40/orig
# EAS_VERSIONS_STORE=/home/eas40/dest
Zum E-Mail-Versand von Assets ist ein funktionierender SMTP-Server nötig. Momentan können der Servername und die From:-Adresse der ausgehenden E-Mails konfiguriert werden.
EAS_EMAIL_SMTP_SERVER=localhost
EAS_EMAIL_FROM_ADDRESS=root@localhost
Zusätzlich kann ab EAS 4.2.30 noch die Envelope-Sender-Adresse angegeben werden. Ist diese nicht gesetzt, wird auf EAS_EMAIL_FROM_ADDRESS zurückgegriffen.
EAS_EMAIL_ENVELOPE_SENDER=admin@example.com
Der EAS enthält ab Version 4.2.36 eine neue Implementierung für den Zoomer.
Der EAS-Janitor räumt regelmäßig die temporären Dateien des Zoomers auf (siehe dazu auch EAS_ZOOMER_TMP_DIR). Einige Parameter können an die zur Verfügung stehenden Ressourcen angepasst werden:
Das maximale Alter der temporären Dateien, die Vorgabe ist hier eine Stunde.
EAS_ZOOMER_MAX_CACHE_TIME=2D
Es können folgende Suffixe für Zeiteinheiten verwendet werden: s (Sekunden), m (Minuten), h (Stunden), D (Tage).
Zusätzlich werden die ältesten temporären Dateien gelöscht, bis der verfügbare Platz auf dem Laufwerk wieder einen gewissen Wert erreicht, sofern notwendig. Die Vorgabe ist hier ein GB.
EAS_ZOOMER_MIN_FREE_SPACE=24G
Verfügbare Suffixe sind K, M, G, T für die entsprechenden Multiplikatoren für Bytes (1K steht für 1024 Bytes).
Da der Janitor standardmäßig nur alle 60 Minuten läuft, kann es trotzdem sein, dass der verfügbare Platz unterschritten wird, der temporäre Platz und der Speicher-Grenzwert sollten also großzügig dimensioniert werden.
Der Aufräum-Prozess des EAS kann deaktiviert werden, standardmäßig ist dieser aktiv. Dazu ist folgende Option zu setzen:
EAS_JANITOR=false
Das Datenaustauschformat des EAS ist hauptsächlich JSON. Ist diese Option aktiv (die Voreinstellung), so werden die Daten in formatierter, besser lesbarer Form ausgeben.
EAS_JSON_INDENT=1
Exiftool wird als zentraler Bestandteil für die Metadatenbehandlung benötigt. Da die Distributionsversion dieser Software teilweise zu alt ist, liefert die easydb eine neuere Version aus, deren Pfad hier konfiguriert ist. Normalerweise sollte diese Einstellung nicht geändert werden.
EAS_EXIFTOOL_PATH=/opt/easydb/common/exiftool/exiftool
Für ImageMagick-Aufrufe können mit EAS_CONVERT_LIMIT_* diverse Beschränkungen angegeben werden (siehe ImageMagick-Documentation zu -limit), z.B.:
EAS_CONVERT_LIMIT_THREAD=1
EAS_CONVERT_LIMIT_MAP=512MB
Maximale Wartezeit auf Office-Prozesse in Sekunden. Die Vorgabe sind 30 Minuten. Ist die Zeit abgelaufen, werden alle Office-Prozesse abgebrochen und neugestartet.
EAS_SOFFICE_MAX_WAIT=900