Legt fest, ob der nginx Server gestartet wird.

Gültige Werte: yes, no

Standardeinstellung: START_NGINX='no' Konfiguriere nginx manuell 'yes' oder 'no'. Wenn hier der Wert 'yes' gesetzt wird, so wird die nginx Konfigurationdatei /etc/nginx/nginx.conf nicht generiert. Der Anwender ist selbst dafür verantwortlich eine korrekte Konfiguration zu erstellen.

Gültige Werte: yes, no

Standardeinstellung: NGINX_MAN_CONFIG='no' Server Typ:


reverse_proxy nginx arbeitet als Reverse Proxy
load_balancer nginx arbeitet als Load Balancer

Eine Konfiguration für den Typ Web-Server wird möglichweise in der Zukunft möglich sein. Man muss NGINX_MAN_CONFIG='yes' benutzen, um einen Web-Server konfigurieren zu können. Will man saubere Ergebnisse erhalten, wenn eine Reihe von Hosts beim Load Balancing genutzt werden, so muss darauf geachtet werden, dass alle Hosts einen identischen Web-Inhalt (web content) haben.

Gültige Werte: reverse_proxy, load_balancer

Standardeinstellung: NGINX_SERVER_TYPE='reverse_proxy' Definiert die Anzahl der sog. Worker Prozesse. Die optimale Anzahl wird bestimmt durch mehrere Faktoren. Die Anzahl der CPUs spielt eine Rolle, stellt aber nicht das Limit dar. Die Anzahl der genutzten Festplatten ist ebenfalls mit entscheidend. Die Anzahl der Worker Prozesse auf die Anzahl der verfügbaren CPUs zu setzen ist ein guter Startwert (der Wert 'auto' versucht die Anzahl eigenständig zu ermitteln).

Gültige Werte: Zahl oder 'auto'

Standardeinstellung: NGINX_WORKER_PROCESSES='auto' Dieser Parameter bestimmt die Anzahl gleichzeitiger Verbindungen, die ein Worker Prozess öffnen soll. Bitte beachten Sie, dass diese Zahl alle Verbindungen beinhaltet, also auch die Verbindungen mit anderen Servern (proxied server) nicht nur die Anzahl Verbindungen mit Clients. Eine wichtige Randbedingung ist, dass die Anzahl der gleichzeitigen Verbindungen die Anzahl der möglichen offenen Dateien nicht überschreiten darf (Siehe auch die Variable worker_rlimit_nofile. Diese wird aber derzeit nicht von der Eisfair-1 Konfigurationsschicht unterstützt.)

Gültige Werte: Zahl

Standardeinstellung: NGINX_WORKER_CONNECTIONS='1024' Anzahl der zu erzeugenden listen directiven.

Gültige Werte: Zahl

Standardeinstellung: NGINX_SERVER_LISTEN_N='1' Hier wird die Adresse und der IP-Port oder aber der UNIX-Domain Socket angegeben, auf dem der Server Anfragen entgegennimmt. Sowohl Adresse und Port oder nur eine Adresse können angegeben werden. Die Adresse kann auch ein Hostname sein.

Beispiele:


   127.0.0.1:8000
   127.0.0.1
   8000
   *:8000
   localhost:8000

IPv6 Addressen können in eckigen Klammern angegegeben werden:


   [::]:8000
   [::1]

Ein UNIX-domain socket wird wie folgt angegeben:

unix:/run/nginx_sock

Standardeinstellung: NGINX_SERVER_LISTEN_='80' Name eines virtuellen Servers. Bitte die angegebene nginx Dokumentation für weitere Informationen nutzen.

Standardeinstellung: NGINX_SERVER_NAME='localhost' Name des Fehler-Logfiles und Loglevel. Ein relativer Dateiname wird als Dateiname relativ zu /var/log/nginx/. interpretiert. Einen Syslog Server kann man über syslog:server=address konfigurieren. Es ist NICHT möglich das Error Logging über NGINX_ERROR_LOG='off' auszuschalten.

Standardeinstellung: NGINX_ERROR_LOG='error.log' Name des Zugriffs-Logfiles und Format des Logs. Ein relativer Dateiname wird als Dateiname relativ zu /var/log/nginx/. interpretiert. Einen Syslog Server kann man über syslog:server=address konfigurieren.

Über NGINX_ACCESS_LOG='off' kann das Logging ausgeschaltet werden.

Standardeinstellung: NGINX_ACCESS_LOG='access.log' Hier wird festgelegt, ob die IP-Adressen im Zugriffs-Logfile anonymisiert werden sollen. Gültige Werte: yes, no

Standardeinstellung: NGINX_LOGANON='no'
Diese Konfigrationsvariable wirkt nur auf IPv4 Adressen.
16Bit : erhalte 16 der 32 Bits
Beispiel 192.168.4.16 wird zu 192.168.0.0
24Bit : erhalte 24 der 32 Bits
Beispiel 192.168.4.16 wird zu 192.168.4.0 Gültige Werte: 16Bit, 24Bit

Standardeinstellung: NGINX_LOGANON_MODE='16Bit' Definiert, ob die Funktionalität logrotate benutzt werden soll, um Error Log und Access Log rotieren zu lassen. NGINX_ROTATE_LOGS sollte auf 'no' stehen, wenn NGINX_MAN_CONFIG='yes' genutzt wird.

Standardeinstellung: NGINX_ROTATE_LOGS='yes' Definiert das logrotate Intervall. Intervall: daily, weekly, monthly

Standardeinstellung: NGINX_LOGROTATE_INTERVAL='daily' Soll das Stub Status Modul geladen werden 'yes' oder 'no'.

Das Stub Status Modul liefert auf einer Webseite Informationen über den nginx Server aus.

Standardeinstellung: NGINX_STUB_STATUS_LOAD='no' Ort des Stub Status. Man kann den Status über http://servername oder serverip/NGINX_STUB_STATUS_LOCATION erreichen. Z.B. http://eisgcc.ap.de/basic_status

Standardeinstellung: NGINX_STUB_STATUS_LOCATION='/basic_status' Freigeben oder Sperren der Nutzung von Puffern für Antworten der via Proxy angesprochenen Server. Werte 'on' oder 'off'.

Standardeinstellung: NGINX_PROXY_BUFFERING='off' Setzt das Protokoll und die Adresse des/der via Proxy angesprochenen Server.

Standardeinstellung: NGINX_PROXY_PASS_URL='http://mydestination:80' Name der sog. Upstream Definition. Hiermit wird einer Gruppe von Server, die als Ziele für das Load Balancing zur Verfügung stehen, benannt.

Standardeinstellung: NGINX_UPSTREAM_NAME='myupstream' Anzahl der Server in der Upstream Definition.

Standardeinstellung: NGINX_LB_SERVER_N='0' Adresse des x-ten Servers.

Angaben wie bei NGINX_SERVER_LISTEN sind möglich. „Gewicht“ des x-ten Servers. Die Server, die als Ziele für das Load Balancing zur Verfügung stehen, werden in der sog. weighted round-robin balancing Methode angesprochen. Ein Gewicht ungleich 1 bedeutet, dass ein Server x-mal pro Durchgang angesprochen wird. Hiermit kann die Last ungleichmäßig verteilt werden.

Gültige Werte: Zahl

Standardeinstellung: NGINX_LB_SERVER_%_WEIGHT='1' Maximale Anzahl Fehler des x-ten Servers. Anwortet der x-te Server NGINX_LB_SERVER_%_MAX_FAILS nicht, so wird er als fehlerhaft markiert und NGINX_LB_SERVER_%_FAIL_TIMEOUT Sekunden nicht mehr benutzt.

Standardeinstellung: NGINX_LB_SERVER_%_MAX_FAILS='1' Fehler Timeout des x-ten Servers in Sekunden. Siehe NGINX_LB_SERVER_%_MAX_FAILS.

Standardeinstellung: NGINX_LB_SERVER_%_FAIL_TIMEOUT='10' Soll der x-te Server als Backup Server genutzt werden 'yes' or 'no'. Ein Backup Server wird für das Load Balancing nur dann genutzt, wenn alle anderen Server der Server Gruppe nicht (mehr) antworten.

Standardeinstellung: NGINX_LB_SERVER_%_BACKUP='no'