Das Redis-Paket Die Einleitung Der Name `Redis' leitet sich aus dem englischen Begriff `Remote Dictionary Server' her, welcher schon darauf hindeutet wozu dieser Server hauptsaechlich verwendet wird. Die einfache Struktur der Datenbank eignet sich weniger fuer komplexe Datenstrukturen, welche ueberwiegend in der originaeren Datenbank selbst abgebildet werden sollten, als um einfache Datenstrukturen auf die extrem schnell zugegriffen werden soll. `Redis' ist schneller als relationale Datenbanken, wie z.B. MySQL. Bis zu ca. 100.000 Schreibvorgaenge und ca. 80.000 Lesevorgaenge pro Sekunde sind dabei auf herkoemmlicher Hardware durchaus moeglich. `Redis' bietet darueber hinaus Persistenz durch automatisiertes regelmaessiges Abspeichern oder per Protokolldatei, wodurch bei entsprechender Konfiguration auch eine ACID-konforme Dauerhaftigkeit erreichbar ist. (Siehe [1]http://redis.io/topics/persistence) Die Funktionen Das Redis-Paket besteht aus folgenden Komponenten: * Redis in-Memory Datenbank - Programmdateien fuer den Betrieb des Datenbank-Servers. ([2]http://redis.io/) Die Voraussetzungen Dieses Paket benoetigt keine weiteren Pakete um funktionieren zu koennen. Die Installation Das Redis-Paket wird ueber das Setup-Menue installiert. Wird eine aeltere Paketversion vorgefunden, so wird diese deinstalliert bevor die neuen Programmdateien installiert werden. Das Menue im Setup-Programm Das Menue im Setup-Programm ist wie folgt aufgebaut: * Redis administration + View documentation: Anzeigen der Dokumentation + Edit configuration: Bearbeiten der Konfiguration + Advanced configuration file handling: Konfigurationen verwalten + Show status: Status der Redis-Servers anzeigen + Start service: Starten des Redis-Servers + Stop service: Stoppen des Redis-Servers + Restart service: Neustarten des Redis-Servers + Start Redis Client: Starten des Redis-Klienten + Check database files: Die Datenbankdateien pruefen + View log file: Die Logmeldungen anzeigen + Exit: Untermenue verlassen Die Menuepunkte duerften selbsterklaerend sein, da sie keinerlei weitere Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter eingegangen. Die Aenderung der Konfiguration Die Konfiguration kann ueber den Menuepunkt 'Edit configuration' geaendert werden. Standardmaessig wird der Editor aufgerufen, der in der Environment-Konfiguration ueber die Variable 'EDITOR' festgelegt wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden soll. Wird dies bestaetigt, werden ueber ein Skript die Anpassungen umgehend wirksam gemacht. Die Konfigurationsdatei In der Konfigurationsdatei, die ueber das Menue zugaenglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will findet sie unter /etc/config.d/redis. Die Parameter START_REDIS Fuer die Aktivierung des Redis-Paketes muss diese Variable lediglich auf den Wert `yes' gestellt werden. Die Einstellung 'no' deaktiviert das Redis-Paket. Gueltige Werte: yes, no Standardeinstellung: START_REDIS='no' REDIS_LISTEN_ADDRESSES (Optionaler Parameter) Ueber diesen Parameter wird die IP-Adresse bzw. werden die IP-Adressen festgelegt, auf welchen der Redis-Server Verbindungsanfragen entgegen nehmen soll. Hinweis Standardmaessig wird nur die IP-Adresse 127.0.0.1 verwendet. Gueltige Werte: IP-Adresse bzw. Adressen Beispiel: REDIS_LISTEN_ADDRESSES='127.0.0.1 192.168.6.10' REDIS_DB_PASS (Optionaler Parameter) Ueber diesen Parameter kann ein Kennwort fuer den Zugriff auf die Redis-Datenbank festgelegt werden. Hinweis Standardmaessig wird kein Kennwort fuer den Datenbankzugriff gesetzt. Gueltige Werte: Kennwort Beispiel: REDIS_DB_PASS='GeheimesPW' REDIS_MAX_CLIENTS (Optionaler Parameter) Ueber diesen Parameter kann die maximale Anzahl gleichzeitiger Verbindungen zum Server festgelegt werden. Wird der gesetzte Grenzwert erreicht, lehnt der Redis-Server alle neuen Verbindungsanfragen mit der Fehlermeldung `max number of clients reached' ab. Gueltige Werte: Zahl Standardeinstellung: REDIS_MAX_CLIENTS='100' REDIS_MAX_MEMORY (Optionaler Parameter) Ueber diesen Parameter kann der vom Redis-Server maximal nutzbare Arbeitsspeicher festgelegt werden. Wenn der gesetzte Grenzwert erreicht wird, versucht Redis, gemaess den eingestellten Vorgaben, Schluessel aus der Datenbank zu entfernen. Gueltige Werte: Speichergroesse (zulaessige Einheiten: k,KB,m,MB,g,GB) Standardeinstellung: REDIS_MAX_MEMORY='256MB' REDIS_SET_OVERCOMMIT_MEMORY (Optionaler Parameter) Ueber diesen Parameter kann die Ueberpruefung und das Setzen des Systemparameters `vm.overcommit_memory` deaktiviert werden, welcher standardmaessig auf den Wert `1' gesetzt wird um eventuellen Problemen bei der Speicherung der Datenbank vorzubeugen. Weitergehende Informationen findet man hierzu in der Redis FAQ [3]http://redis.io/topics/faq unter dem Punkt ` Background saving is failing with a fork() error under Linux even if I've a lot of free RAM'. Gueltige Werte: yes, no Standardeinstellung: REDIS_SET_OVERCOMMIT_MEMORY='yes' REDIS_THP_DISABLED (Optionaler Parameter) Ueber diesen Parameter kann der Transparent Hugepage Support (THP) abgeschaltet werden, welcher die Redis-Latenz negativ beeinflussen und zu Problemen bei der Speichernutzung fuehren kann. Gueltige Werte: yes, no Standardeinstellung: REDIS_THP_DISABLED='yes' REDIS_HOUSE_KEEPING_CRON_SCHEDULE (Optionaler Parameter) Ueber diesen Parameter wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall das Redis-House-Keeping, z.B. die Konsolidierung der AOF-Datei, durchgefuehrt werden soll. Die fuenf Teilparameter haben dabei folgende Bedeutung: 1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag D.h. wird dieser Parameter nicht gesetzt, so wird standardmaessig jeden Tag um 02:05h dieser Prozess angestossen. Wer naeheres ueber die verwendete Befehlssyntax erfahren moechte, sollte ueber eine Internet- Suchmaschine nach 'man' und 'crontab' suchen. Gueltige Werte: Crontab-spezifischer Parametereintrag Standardeinstellung: REDIS_HOUSE_KEEPING_CRON_SCHEDULE='' REDIS_LOG_COUNT Ueber diesen Parameter wird eingestellt, wie viele Logdateien vorgehalten werden sollen. Wird dieser Wert ueberschritten, so wird die aelteste Logdatei geloescht. Gueltige Werte: Zahl Standardeinstellung: REDIS_LOG_COUNT='10' REDIS_LOG_INTERVAL Ueber diesen Parameter wird eingestellt, in welchen Intervallen die Logdateien archiviert werden sollen. Zur Auswahl stehen die Schluesselwoerter `daily' - taeglich, `weekly' - woechentlich und `monthly - monatlich. Gueltige Werte: daily, weekly, monthly Standardeinstellung: REDIS_LOG_INTERVAL='weekly' REDIS_LOG_LEVEL (Optionaler Parameter) Ueber diesen Parameter wird eingestellt, in welchem Detailgrad Informationen in die Logdatei geschrieben werden sollen. Wird der Parameter nicht gesetzt, so wird standardmaessig `notice' angenommen: Gueltige Werte: debug, verbose, notice, warning Standardeinstellung: REDIS_LOG_LEVEL='' __________________________________________________________________ Juergen Edner 2018-11-23