Lawsuit - Wiki - Benutzerbeiträge [de]

Datensicherung

2021-11-03T14:35:45Z

93.239.195.115: /* Virtual Private Network (VPN) mithilfe der Fritz!Box spannen */

Aufsetzen des Apache-Servers

2021-11-03T10:40:05Z

93.239.195.115: /* Optional: Ein Zertifikat für localhost erstellen */

{{Knowledge|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Portal:Apache Portal:Apache]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Einstellungen hierzu können Sie mit ''YaST'' unter der Rubrik "Netzwerkeinestellungen" vornehmen. Achten Sie insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass weitere Rechner der Kanzlei von YaST tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein. Prüfen Sie diesen gegebenenfalls mit ''YaST'' in der Sektion '''Online update''' nach .

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''zypper'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> su}}
Geben Sie nach der Passwortbestätigung den folgenden Befehl ein:
{{Shell|# zypper in apache2 apache2-doc perl-Apache-DBI apache2-mod_perl apache2-mod_php5 apache2-mod_python firewalld-rpcbind-helper}}

=== Nutzung der Yast-Funktion ===

Die weiteren Einstellungen lassen sich zunächst vereinfachen, indem man die Yast-Funktionen für die Servereinrichtung nutzt. Laden Sie dafür das entsprechende Modul nach. Erfahrungsgemäß ist dieser Zwischenschritt jedoch nicht nötig, wenn man die Konfiguration in den nächsten Punkten sorgfältig durchführt.
{{Shell|# zypper in yast2-http-server apache2-mod_wsgi-python3}}
Unter ''yast2'' wählen Sie >HTTP-Server und klicken sich durch den Installationsprozess. Es müssen keine Anpassungen vorgenommen werden. Nach Abschluss der Installation verschieben Sie Ihre eigene Installation aus <tt>/ect/apache2/vhosts.d/YaSTsave</tt> wieder ins obere Verzeichnis <tt>/ect/apache2/vhosts.d</tt>.

Nach Abschluss der Einrichung kann das Hilfsprogramm ''yast2-http-server'' wieder entfernt werden.
{{Shell|# zypper rm yast2-http-server}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT http   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT https   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird:
{{Shell|# rcapache2 start   chkconfig -a apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod -l   rcapache2 restart}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Wenn Sie eine besonders sichere Verbindung für Mandantendaten wünschen, bietet sich die Erstellung eines lokalen Zertifikats für den lokalen Server ''localhost'' an:
{{Shell |# mkdir /etc/apache2/ssl   openssl req -new -x509 -days 3650 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem}}
Als '''Common Name''' geben Sie bitte "localhost" an.
Das Zertifikat wird anschließend wie folgt verlinkt und eingebunden:
{{Shell |# ln -sf /etc/apache2/ssl/apache.pem /etc/apache2/ssl/`/usr/bin/openssl x509 -noout -hash < /etc/apache2/ssl/apache.pem`.0   chmod 600 /etc/apache2/ssl/apache.pem   a2enmod ssl   service apache2 force-reload}}
Die Apache-Konfigurationsdatei in <tt>/etc/apache2/vhosts.d/lawsuit-httpd.conf</tt> muss dann folgende zusätzliche Zeichen erhalten:
<IfDefine SSL>
<IfDefine !NOSSL>
<Virtualhost *:443>
SSLEngine On
SSLCertificateFile /etc/apache2/ssl/apache.pem
DocumentRoot /home/IHRBENUTZERNAME/lawsuit/
</Virtualhost>
</IfDefine>
</IfDefine>

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers

2021-11-03T10:38:42Z

93.239.195.115: /* Anpassung der Firewall */

{{Knowledge|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Portal:Apache Portal:Apache]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Einstellungen hierzu können Sie mit ''YaST'' unter der Rubrik "Netzwerkeinestellungen" vornehmen. Achten Sie insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass weitere Rechner der Kanzlei von YaST tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein. Prüfen Sie diesen gegebenenfalls mit ''YaST'' in der Sektion '''Online update''' nach .

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''zypper'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> su}}
Geben Sie nach der Passwortbestätigung den folgenden Befehl ein:
{{Shell|# zypper in apache2 apache2-doc perl-Apache-DBI apache2-mod_perl apache2-mod_php5 apache2-mod_python firewalld-rpcbind-helper}}

=== Nutzung der Yast-Funktion ===

Die weiteren Einstellungen lassen sich zunächst vereinfachen, indem man die Yast-Funktionen für die Servereinrichtung nutzt. Laden Sie dafür das entsprechende Modul nach. Erfahrungsgemäß ist dieser Zwischenschritt jedoch nicht nötig, wenn man die Konfiguration in den nächsten Punkten sorgfältig durchführt.
{{Shell|# zypper in yast2-http-server apache2-mod_wsgi-python3}}
Unter ''yast2'' wählen Sie >HTTP-Server und klicken sich durch den Installationsprozess. Es müssen keine Anpassungen vorgenommen werden. Nach Abschluss der Installation verschieben Sie Ihre eigene Installation aus <tt>/ect/apache2/vhosts.d/YaSTsave</tt> wieder ins obere Verzeichnis <tt>/ect/apache2/vhosts.d</tt>.

Nach Abschluss der Einrichung kann das Hilfsprogramm ''yast2-http-server'' wieder entfernt werden.
{{Shell|# zypper rm yast2-http-server}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT http   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT https   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird:
{{Shell|# rcapache2 start   chkconfig -a apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod -l   rcapache2 restart}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Wenn Sie eine besonders sichere Verbindung für Mandantendaten wünschen, bietet sich die Erstellung eines lokalen Zertifikats für den lokalen Server ''localhost'' an:
{{Shell |# mkdir /etc/apache2/ssl   openssl req -new -x509 -days 3650 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem}}
Als '''Common Name''' geben Sie bitte "localhost" an.
Das Zertifikat wird anschließend wie folgt verlinkt und eingebunden:
{{Shell |# ln -sf /etc/apache2/ssl/apache.pem /etc/apache2/ssl/`/usr/bin/openssl x509 -noout -hash < /etc/apache2/ssl/apache.pem`.0   chmod 600 /etc/apache2/ssl/apache.pem   a2enmod ssl   service apache2 force-reload}}
Die Apache-Konfigurationsdatei in <tt>/etc/apache2/vhosts.d/</tt> muss dann folgende zusätzliche Zeichen erhalten:
<IfDefine SSL>
<IfDefine !NOSSL>
<Virtualhost *:443>
SSLEngine On
SSLCertificateFile /etc/apache2/ssl/apache.pem
DocumentRoot /home/IHRBENUTZERNAME/lawsuit/
</Virtualhost>
</IfDefine>
</IfDefine>

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers

2021-11-03T10:36:55Z

93.239.195.115: /* Nutzung der Yast-Funktion */

{{Knowledge|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Portal:Apache Portal:Apache]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Einstellungen hierzu können Sie mit ''YaST'' unter der Rubrik "Netzwerkeinestellungen" vornehmen. Achten Sie insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass weitere Rechner der Kanzlei von YaST tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein. Prüfen Sie diesen gegebenenfalls mit ''YaST'' in der Sektion '''Online update''' nach .

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''zypper'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> su}}
Geben Sie nach der Passwortbestätigung den folgenden Befehl ein:
{{Shell|# zypper in apache2 apache2-doc perl-Apache-DBI apache2-mod_perl apache2-mod_php5 apache2-mod_python firewalld-rpcbind-helper}}

=== Nutzung der Yast-Funktion ===

Die weiteren Einstellungen lassen sich zunächst vereinfachen, indem man die Yast-Funktionen für die Servereinrichtung nutzt. Laden Sie dafür das entsprechende Modul nach. Erfahrungsgemäß ist dieser Zwischenschritt jedoch nicht nötig, wenn man die Konfiguration in den nächsten Punkten sorgfältig durchführt.
{{Shell|# zypper in yast2-http-server apache2-mod_wsgi-python3}}
Unter ''yast2'' wählen Sie >HTTP-Server und klicken sich durch den Installationsprozess. Es müssen keine Anpassungen vorgenommen werden. Nach Abschluss der Installation verschieben Sie Ihre eigene Installation aus <tt>/ect/apache2/vhosts.d/YaSTsave</tt> wieder ins obere Verzeichnis <tt>/ect/apache2/vhosts.d</tt>.

Nach Abschluss der Einrichung kann das Hilfsprogramm ''yast2-http-server'' wieder entfernt werden.
{{Shell|# zypper rm yast2-http-server}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird:
{{Shell|# rcapache2 start   chkconfig -a apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod -l   rcapache2 restart}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Wenn Sie eine besonders sichere Verbindung für Mandantendaten wünschen, bietet sich die Erstellung eines lokalen Zertifikats für den lokalen Server ''localhost'' an:
{{Shell |# mkdir /etc/apache2/ssl   openssl req -new -x509 -days 3650 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem}}
Als '''Common Name''' geben Sie bitte "localhost" an.
Das Zertifikat wird anschließend wie folgt verlinkt und eingebunden:
{{Shell |# ln -sf /etc/apache2/ssl/apache.pem /etc/apache2/ssl/`/usr/bin/openssl x509 -noout -hash < /etc/apache2/ssl/apache.pem`.0   chmod 600 /etc/apache2/ssl/apache.pem   a2enmod ssl   service apache2 force-reload}}
Die Apache-Konfigurationsdatei in <tt>/etc/apache2/vhosts.d/</tt> muss dann folgende zusätzliche Zeichen erhalten:
<IfDefine SSL>
<IfDefine !NOSSL>
<Virtualhost *:443>
SSLEngine On
SSLCertificateFile /etc/apache2/ssl/apache.pem
DocumentRoot /home/IHRBENUTZERNAME/lawsuit/
</Virtualhost>
</IfDefine>
</IfDefine>

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers

2021-11-03T10:30:59Z

93.239.195.115: /* Anpassung der Firewall */

{{Knowledge|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Portal:Apache Portal:Apache]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Einstellungen hierzu können Sie mit ''YaST'' unter der Rubrik "Netzwerkeinestellungen" vornehmen. Achten Sie insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass weitere Rechner der Kanzlei von YaST tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein. Prüfen Sie diesen gegebenenfalls mit ''YaST'' in der Sektion '''Online update''' nach .

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''zypper'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> su}}
Geben Sie nach der Passwortbestätigung den folgenden Befehl ein:
{{Shell|# zypper in apache2 apache2-doc perl-Apache-DBI apache2-mod_perl apache2-mod_php5 apache2-mod_python firewalld-rpcbind-helper}}

=== Nutzung der Yast-Funktion ===

Die weiteren Einstellungen lassen sich zunächst vereinfachen, indem man die Yast-Funtionen für die Servereinrichtung nutzt. Laden Sie dafür das entsprechende Modul nach.
{{Shell|# zypper in yast2-http-server apache2-mod_wsgi-python3}}
Unter ''yast2'' wählen Sie >HTTP-Server und klicken sich durch den Installationsprozess. Es müssen keine Anpassungen vorgenommen werden. Nach Abschluss der Installation verschieben Sie Ihre eigene Installation aus <tt>/ect/apache2/vhosts.d/YaSTsave</tt> wieder ins obere Verzeichnis <tt>/ect/apache2/vhosts.d</tt>.

Nach Abschluss der Einrichung kann das Hilfsprogramm ''yast2-http-server'' wieder entfernt werden.
{{Shell|# zypper rm yast2-http-server}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird:
{{Shell|# rcapache2 start   chkconfig -a apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod -l   rcapache2 restart}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Wenn Sie eine besonders sichere Verbindung für Mandantendaten wünschen, bietet sich die Erstellung eines lokalen Zertifikats für den lokalen Server ''localhost'' an:
{{Shell |# mkdir /etc/apache2/ssl   openssl req -new -x509 -days 3650 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem}}
Als '''Common Name''' geben Sie bitte "localhost" an.
Das Zertifikat wird anschließend wie folgt verlinkt und eingebunden:
{{Shell |# ln -sf /etc/apache2/ssl/apache.pem /etc/apache2/ssl/`/usr/bin/openssl x509 -noout -hash < /etc/apache2/ssl/apache.pem`.0   chmod 600 /etc/apache2/ssl/apache.pem   a2enmod ssl   service apache2 force-reload}}
Die Apache-Konfigurationsdatei in <tt>/etc/apache2/vhosts.d/</tt> muss dann folgende zusätzliche Zeichen erhalten:
<IfDefine SSL>
<IfDefine !NOSSL>
<Virtualhost *:443>
SSLEngine On
SSLCertificateFile /etc/apache2/ssl/apache.pem
DocumentRoot /home/IHRBENUTZERNAME/lawsuit/
</Virtualhost>
</IfDefine>
</IfDefine>

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers

2021-11-03T09:44:51Z

93.239.195.115: /* Allgemeine Rechner-Konfiguration */

{{Knowledge|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Portal:Apache Portal:Apache]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Einstellungen hierzu können Sie mit ''YaST'' unter der Rubrik "Netzwerkeinestellungen" vornehmen. Achten Sie insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass weitere Rechner der Kanzlei von YaST tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein. Prüfen Sie diesen gegebenenfalls mit ''YaST'' in der Sektion '''Online update''' nach .

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''zypper'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> su}}
Geben Sie nach der Passwortbestätigung den folgenden Befehl ein:
{{Shell|# zypper in apache2 apache2-doc perl-Apache-DBI apache2-mod_perl apache2-mod_php5 apache2-mod_python firewalld-rpcbind-helper}}

=== Nutzung der Yast-Funktion ===

Die weiteren Einstellungen lassen sich zunächst vereinfachen, indem man die Yast-Funtionen für die Servereinrichtung nutzt. Laden Sie dafür das entsprechende Modul nach.
{{Shell|# zypper in yast2-http-server apache2-mod_wsgi-python3}}
Unter ''yast2'' wählen Sie >HTTP-Server und klicken sich durch den Installationsprozess. Es müssen keine Anpassungen vorgenommen werden. Nach Abschluss der Installation verschieben Sie Ihre eigene Installation aus <tt>/ect/apache2/vhosts.d/YaSTsave</tt> wieder ins obere Verzeichnis <tt>/ect/apache2/vhosts.d</tt>.

Nach Abschluss der Einrichung kann das Hilfsprogramm ''yast2-http-server'' wieder entfernt werden.
{{Shell|# zypper rm yast2-http-server}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird:
{{Shell|# rcapache2 start   chkconfig -a apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod -l   rcapache2 restart}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Wenn Sie eine besonders sichere Verbindung für Mandantendaten wünschen, bietet sich die Erstellung eines lokalen Zertifikats für den lokalen Server ''localhost'' an:
{{Shell |# mkdir /etc/apache2/ssl   openssl req -new -x509 -days 3650 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem}}
Als '''Common Name''' geben Sie bitte "localhost" an.
Das Zertifikat wird anschließend wie folgt verlinkt und eingebunden:
{{Shell |# ln -sf /etc/apache2/ssl/apache.pem /etc/apache2/ssl/`/usr/bin/openssl x509 -noout -hash < /etc/apache2/ssl/apache.pem`.0   chmod 600 /etc/apache2/ssl/apache.pem   a2enmod ssl   service apache2 force-reload}}
Die Apache-Konfigurationsdatei in <tt>/etc/apache2/vhosts.d/</tt> muss dann folgende zusätzliche Zeichen erhalten:
<IfDefine SSL>
<IfDefine !NOSSL>
<Virtualhost *:443>
SSLEngine On
SSLCertificateFile /etc/apache2/ssl/apache.pem
DocumentRoot /home/IHRBENUTZERNAME/lawsuit/
</Virtualhost>
</IfDefine>
</IfDefine>

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers

2021-11-03T09:32:24Z

93.239.195.115: /* Hinzufügen von Apache-Modulen */

{{Knowledge|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Portal:Apache Portal:Apache]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Einstellungen hierzu können Sie mit ''YaST'' unter der Rubrik "Netzwerkeinestellungen" vornehmen. Achten Sie insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass weitere Rechner der Kanzlei von YaST tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein. Prüfen Sie diesen gegebenenfalls mit ''YaST'' in der Sektion '''Online update''' nach .

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''zypper'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> su}}
Geben Sie nach der Passwortbestätigung den folgenden Befehl ein:
{{Shell|# zypper in apache2 apache2-doc perl-Apache-DBI apache2-mod_perl apache2-mod_php5 apache2-mod_python firewalld-rpcbind-helper}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird:
{{Shell|# rcapache2 start   chkconfig -a apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod -l   rcapache2 restart}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Wenn Sie eine besonders sichere Verbindung für Mandantendaten wünschen, bietet sich die Erstellung eines lokalen Zertifikats für den lokalen Server ''localhost'' an:
{{Shell |# mkdir /etc/apache2/ssl   openssl req -new -x509 -days 3650 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem}}
Als '''Common Name''' geben Sie bitte "localhost" an.
Das Zertifikat wird anschließend wie folgt verlinkt und eingebunden:
{{Shell |# ln -sf /etc/apache2/ssl/apache.pem /etc/apache2/ssl/`/usr/bin/openssl x509 -noout -hash < /etc/apache2/ssl/apache.pem`.0   chmod 600 /etc/apache2/ssl/apache.pem   a2enmod ssl   service apache2 force-reload}}
Die Apache-Konfigurationsdatei in <tt>/etc/apache2/vhosts.d/</tt> muss dann folgende zusätzliche Zeichen erhalten:
<IfDefine SSL>
<IfDefine !NOSSL>
<Virtualhost *:443>
SSLEngine On
SSLCertificateFile /etc/apache2/ssl/apache.pem
DocumentRoot /home/IHRBENUTZERNAME/lawsuit/
</Virtualhost>
</IfDefine>
</IfDefine>

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]