Content
Dateianzeige für redis (1.5.2)
usr/share/doc/redis/redis.txt
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