Aufsetzen des Apache-Servers: Unterschied zwischen den Versionen

Aus Lawsuit - Wiki
Wechseln zu: Navigation, Suche
(Anpassung der Firewall)
Zeile 45: Zeile 45:
 
  Network > Firewall > SuSEfirewall2
 
  Network > Firewall > SuSEfirewall2
  
=== Starting Server===
+
=== Aktivierung des Servers ===
Start the server and configure it to automatically start at boot time.  
+
Starten Sie den Server und setzen Sie ihn in ein Bootverzeichnis, damit er mit dem Rechner hochgefahren wird.
{{Shell|# rcapache2 start }}
+
{{Shell|# rcapache2 start<br>
 
{{Shell|# chkconfig -a apache2}}
 
{{Shell|# chkconfig -a apache2}}
  
=== Apache Modules===
+
=== Hinzufügen von Apache-Modulen===
To enable required Apache Modules we can edit '''APACHE_MODULES''' in <tt>/etc/sysconfig/apache2</tt>. Modules can also be enabled/disabled/listed with the commands below. Any such operation requires a restart of the service and of course needs root privileges.
+
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 jeder Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod php5}}
+
{{Shell|# a2enmod php5<br># a2enmod -l<br># rcapache2 restart}}
{{Shell|# a2enmod -l}}
 
{{Shell|# rcapache2 restart}}
 
  
 
== Virtual Hosts ==
 
== Virtual Hosts ==
The directory for virtual host configurations is <tt>/etc/apache2/vhosts.d/</tt>. As you can see there are two sample configuration files - one with ssl; one without ssl. We use the template without ssl. Only files ending with ".conf" are automatically included to the apache configuration.
+
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 Secure Socket Layer. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.
  
{{Intro|In the following instructions, please replace {DOMAINNAME} with an IP or an domain-name you want.}}
+
{{Intro|Wenn Sie eine anderes Verzeichnis als Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen ''Lawsuit'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse}}
  
* Plan your website infrastructure. It's helpful to use a directory (/srv/www/vhosts) including one subdirectory for each virtual host.
+
* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:  
:You have to decide which sort of virtual host you need, based on the following options:  
+
:* [http://httpd.apache.org/docs/2.2/vhosts/name-based.html namensbasiert]
:* [http://httpd.apache.org/docs/2.2/vhosts/name-based.html Name Based]
+
:* [http://httpd.apache.org/docs/2.2/vhosts/ip-based.html IP-basiert]
:* [http://httpd.apache.org/docs/2.2/vhosts/ip-based.html Port Based]
+
:* portbasiert
:* Port based
+
 
 +
* 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.
 +
 
 +
Für Lawsuit wird die Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/bin</tt> bereits fertig zur Verfügung gestellt. Sie müssen jedoch den Platzhalter durch den eigenen Nutzernamen ersetzen. Dies erfolgt durch die folgenden Befehle:
  
* Copy the sample configuration file '''vhost.template''' to '''{DOMAINNAME}.conf''' and create the subdirectory for this virtual host.
 
  
 
:{{Shell | # cd /etc/apache2/vhosts.d }}
 
:{{Shell | # cd /etc/apache2/vhosts.d }}

Version vom 7. März 2018, 17:41 Uhr

Kompatibilität mit openSUSE openSUSE-Themen Weiterführende Artikel Suse.png


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 DHCP darauf, dass weitere Rechner der Kanzlei von YaST tatsächlich im selben Nummernraum wie der Rechners 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 kann mit zypper installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:

> su

Geben Sie nach der Passwortbestätigung den folgenden Befehl ein:

# zypper in apache2


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 weiterhin als Root ausgeführt werden.

# 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 /etc/sysconfig/SuSEfirewall2 einsetzen. Diese Konfigurationsvariable findet sich unter:

Network > Firewall > SuSEfirewall2

Aktivierung des Servers

Starten Sie den Server und setzen Sie ihn in ein Bootverzeichnis, damit er mit dem Rechner hochgefahren wird. {{Shell|# rcapache2 start

# chkconfig -a apache2


Hinzufügen von Apache-Modulen

Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable APACHE_MODULES in /etc/sysconfig/apache2 editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach jeder Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.

# a2enmod php5
# a2enmod -l
# rcapache2 restart


Virtual Hosts

Das Verzeichnis für alle Virtual Host ist /etc/apache2/vhosts.d/. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne Secure Socket Layer. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

Vorabhinweis
Wenn Sie eine anderes Verzeichnis als Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen Lawsuit 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:
  • 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.

Für Lawsuit wird die Konfigurationsdatei im Unterverzeichnis lawsuit/bin bereits fertig zur Verfügung gestellt. Sie müssen jedoch den Platzhalter durch den eigenen Nutzernamen ersetzen. Dies erfolgt durch die folgenden Befehle:


# cd /etc/apache2/vhosts.d
# cp vhost.template {DOMAINNAME}.conf
# mkdir -p /srv/www/vhosts/{DOMAINNAME}/


  • Now edit the copied configuration file and adjust the following as needed:
  • Change the document root for your virtual host: DocumentRoot /srv/www/vhosts/{DOMAINNAME}
  • You also need to change corresponding directory directive: <Directory "/srv/www/vhosts/{DOMAINNAME}">
  • <VirtualHost *:80> It is possible to replace the "*" with an IP addess and "80" with a non standard http port. See Apache Documentation.
  • Restart Apache
# /etc/init.d/apache2 restart


Custom Configuration

Add/edit configuration for all virtual hosts to /etc/apache2/default-server.conf. Edit APACHE_CONF_INCLUDE_FILES in /etc/sysconfig/apache2 to include configurations from external files. To understand the hierarchy and layout of all include files, read the comments at the top of httpd.conf The old, single, 40K, monolithic configuration file is available in /usr/share/doc/packages/apache2/httpd-std.conf-prefork.

Trouble Shooting

Read any error messages when you start the service. Reproduce what is not working and see how it is reflected in the logs. The log files can be monitored in a root shell with the following command:

# tail -F /var/log/apache2/*


If you suspect a bug, please report it

See also

Related articles

  • SuSE Firewall
  • Package documentation and example configuration files in /usr/share/doc/packages/apache2/

External links