Apcupsd-CGI - UPS Monitor

Die Einleitung

„Apcupsd-CGI“ stellt eine WebOberfläche für Apcupsd Monitoring bereit.

Erforderlich ist dafür das eisfair Paket Apache2.

Der Webzugriff

Das eisfair Apcupsd-CGI Paket lässt sich auf verschiedene Arten zur Benutzung konfigurieren.

Der Zugriff kann über eine Subdomain

http{s}://apcupsd.meine.de

oder in eine bestehende Domain

http{s}://www.meine.de/apcupsd

erfolgen. Es ist auch beides gleichzeitig möglich, also über die Subdomain und in der bestehenden Domain.

Der https Zugriff für die Subdomain wird über die eisfair Apcupsd-CGI Konfiguration eingestellt, für den https Zugriff in der bestehenden Domain muss das SSL Zertifikat von der Domain bereitgestellt werden.

Das Menü im Setup-Programm

Das Menü im Setup-Programm ist wie folgt aufgebaut:

x.

Service administration

x.

Apcupsd

x.

Apcupsd web monitoring

	1.	View documentation
	2.	Edit configuration
	3.	Advanced configuration file handling
	4.	Logfile view (hat nur Inhalt bei Subdomain)
	5.	User handling for web access (Optional)
	0.	Exit

Die Änderung der Konfiguration

Die Konfiguration kann über den Menüpunkt „Edit configuration“ geändert werden.

Ich empfehle zum Bearbeiten der Konfiguration den Editor „ece“.

Die Konfigurationsdatei

In der Konfigurationsdatei, die über das Menü zugänglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will, findet sie unter
/etc/config.d/apcupsd-cgi.

Allgemeine Einstellungen

START_APCUPSD_CGI

Für die Aktivierung des Apcupsd-CGI muss diese Variable lediglich auf den Wert „yes“ gestellt werden. Die Einstellung „no“ schaltet Apcupsd-CGI ab.

Gültige Werte: yes, no

Standardeinstellung: START_APCUPSD_CGI='no'

Einstellungen für eine Subdomain

APCUPSD_CGI_SUBDOMAIN

Hier wird angegeben, ob Apcupsd-CGI in einer Subdomain ausgeführt werden soll. (apcupsd.meine.de)

Gültige Werte: yes, no

Standardeinstellung: APCUPSD_CGI_SUBDOMAIN='no'

APCUPSD_CGI_SUBDOMAIN_NAME

Hier wird der Komplette Name der Domain eingegeben

Beispiel: ⇒ {http{s}://}apcupsd.meine.de

Gültige Werte: Qualifizierter Domain Name

Standardeinstellung: APCUPSD_CGI_SUBDOMAIN_NAME=”

APCUPSD_CGI_SUBDOMAIN_PORT

Hier wird der Port für die HTTP Verbindung eingegeben.

Gültige Werte: Port

Standardeinstellung: APCUPSD_CGI_SUBDOMAIN_PORT='80'

APCUPSD_CGI_SUBDOMAIN_ADMIN

Hier wir die Mail Adresse des Server Admin angegeben

Gültige Werte: Mail Adresse

Standardeinstellung: APCUPSD_CGI_SUBDOMAIN_ADMIN=”

APCUPSD_CGI_SUBDOMAIN_FORCE_SSL

Soll der Zugriff immer mit https erfolgen.

Gültige Werte: yes, no

Standardeinstellung: APCUPSD_CGI_SUBDOMAIN_FORCE_SSL='no'

APCUPSD_CGI_SUBDOMAIN_SSL_PORT

Hier wird der Port für die HTTPS Verbindung eingegeben.

Gültige Werte: Port

Standardeinstellung: APCUPSD_CGI_SUBDOMAIN_SSL_PORT='443'

APCUPSD_CGI_SUBDOMAIN_SSL_CERT

Hier wird das Server Zertifikat für die SSL Verbindung angegeben.

Gültige Werte: Zertifikat

Standardeinstellung: APCUPSD_CGI_SUBDOMAIN_SSL_CERT=”

Einstellungen für einen Host

APCUPSD_CGI_HOST

Hier wird angegeben, ob Apcupsd-CGI in einem Host ausgeführt werden soll.
(www.meine.de/apsupsd)

Gültige Werte: yes, no

Standardeinstellung: APCUPSD_CGI_HOST='yes'

APCUPSD_CGI_HOST_NAME

Hier wird der Host(Servername) angegeben, in dem Apsupsd-CGI ausgeführt werden soll. Im Normalfall ist dies der APACHE2_SERVER_NAME.

Gültige Werte: Servername

Standardeinstellung: APCUPSD_CGI_HOST_NAME='APACHE2_SERVER_NAME'

APCUPSD_CGI_HOST_ALIAS

Hier wird der Alias angegeben, über den Apcupsd-CGI angesprochen werden soll.

Beispiel: ⇒ {http{s}://}www.meine.de/apcupsd

Gültige Werte: jeder gültige Name

Standardeinstellung: APCUPSD_CGI_HOST_ALIAS='apcupsd'

APCUPSD_CGI_HOST_FORCE_SSL

Soll der Zugriff immer mit https erfolgen.

Gültige Werte: yes, no

Standardeinstellung: APCUPSD_CGI_HOST_FORCE_SSL='no'

Einstellungen für die Anmeldung

APCUPSD_CGI_ACCESS_ALL

Hier ist der Zugriff für alle erlaubt, Weltweit.

Gültige Werte: yes, no

Standardeinstellung: APCUPSD_CGI_ACCESS_ALL='no'

APCUPSD_CGI_ACCESS_AUTH

Hier ist der Zugriff mit Benutzername und Passwort erlaubt. Benutzer müssen dafür über den Menüpunkt „User handling for web access“ in der Apcupsd-CGI administration ein Passwort erhalten.
Dieser Menüpunkt ist nur sichtbar, bei APCUPSD_CGI_ACCESS_AUTH='yes'

Gültige Werte: yes, no

Standardeinstellung: APCUPSD_CGI_ACCESS_AUTH='no'

APCUPSD_CGI_ACCESS_AUTH_SEND_MAIL_FROM

Bei der Einstellung APCUPSD_CGI_ACCESS_AUTH muss hier eine Mail Adresse angeben werden, die als Absender benutzt werden soll. Bleibt sie leer wird keine Mail versandt

Gültige Werte: leer, Mail Adresse

Standardeinstellung: APCUPSD_CGI_ACCESS_AUTH_SEND_MAIL_FROM=”

APCUPSD_CGI_ACCESS_HOST

Hier ist der Zugriff mit Hostname erlaubt. Es dürfen mehrere durch ein Leerzeichen getrennt angegeben werden.

Gültige Werte: Hostname, Domain

Standardeinstellung: APCUPSD_CGI_ACCESS_HOST=”

APCUPSD_CGI_ACCESS_IP

Hier ist der Zugriff von der IP Adresse erlaubt. Es dürfen mehrere durch ein Leerzeichen getrennt angegeben werden.

Beispiel: 10 192.168.6 192.168.6.1 192.168.6.0/24

Gültige Werte: IP Adresse

Standardeinstellung: APCUPSD_CGI_ACCESS_IP=”

APCUPSD_CGI_ACCESS_LOCAL

Hier ist der Zugriff local erlaubt.

Gültige Werte: yes, no

Standardeinstellung: APCUPSD_CGI_ACCESS_LOCAL='yes'

Die Einstellungen für den überwachten Host

APCUPSD_CGI_HOST_N

Hier wird die Anzahl der per Apcupsd-CGI zu bedienenden Server eingestellt.

Gültige Werte: Zahl

Standardeinstellung: APCUPSD_CGI_HOST_N='1'

APCUPSD_CGI_HOST_x_ADDRESS

IP-Adresse oder Hostname des zu überwachenden Apcupsd Rechners.

Gültige Werte: keine Einschränkung

Standardeinstellung: APCUPSD_CGI_HOST_x_ADDRESS='127.0.0.1'

APCUPSD_CGI_HOST_x_DESCRIPTION

Eine Beschreibung für den Auswahl Dialog.

Gültige Werte: keine Einschränkung

Standardeinstellung: APCUPSD_CGI_HOST_x_DESCRIPTION='localhost'