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. In der Konfiguration des Apache WebServers müssen keine weiteren Parameter Einstellungen vorgenommen 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. [1]User handling for web access Die Änderung der Konfiguration Die Konfiguration wird über den Menüpunkt „Edit configuration“ geändert. 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. In der Konfiguration des Certs und Certs_dehydrated Pakets müssen keine Parameter Einstellungen vorgenommen werden. 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. 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 nur local erlaubt. Hinweis Diese Einstellung lässt sich nicht mit anderen Methoden kombinieren. 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' __________________________________________________________________