Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste ÜberarbeitungBeide Seiten der Revision | ||
de:shibidp3prepare-tomcat [2017/02/10 09:49] – [Tomcat Restart] Raoul Gunnar Borenius | de:shibidp3prepare-tomcat [2019/08/15 15:04] – [Tomcat Restart] Silke Meyer | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ===== IdP 3.x Vorarbeiten: | + | ===== IdP 3.x Vorarbeiten: |
==== Installation ==== | ==== Installation ==== | ||
- | ===Debian | + | === Debian |
- | + | ||
- | Die Tomcat-Version 8.0.14 in Debian 8 hat diverse Bugs die erst in späteren Tomcat-Versionen gefixt wurden. Aufgrund der strikten Debian-Policy sind die neueren Versionen nur über das [[https:// | + | |
<code bash> | <code bash> | ||
- | root@idp:~# apt-get install | + | root@idp:~# apt install |
- | | + | |
</ | </ | ||
- | ===CentOS 7=== | + | === Debian 8/9 === |
- | Siehe https:// | + | |
+ | <code bash> | ||
+ | root@idp:~# apt-get | ||
+ | </code> | ||
- | ===RHEL=== | + | === CentOS 7 === |
- | EPEL installieren | + | CentOS 7 bringt über das Repository noch Tomcat 7 mit. Neuere Versionen können Sie manuell |
- | RHEL/CentOS 6 32-Bit | ||
<code bash> | <code bash> | ||
- | wget http:// | + | root@idp:~# yum -y install tomcat |
- | rpm -ivh epel-release-6-8.noarch.rpm | + | |
- | </ | + | |
- | RHEL/CentOS 6 64-Bit | + | |
- | <code bash> | + | |
- | wget http:// | + | |
- | rpm -ivh epel-release-6-8.noarch.rpm | + | |
- | </ | + | |
- | EPEL verifizieren | + | |
- | <code bash> | + | |
- | yum repolist | + | |
- | </ | + | |
- | EPEL aktivieren | + | |
- | <code bash> | + | |
- | yum-config-manager --enable epel | + | |
- | </ | + | |
- | <code bash> | + | |
- | yum install tomcat | + | |
</ | </ | ||
- | Der IdP läuft als Teil von Tomcat natürlich auch mit der Unix-ID des Tomcat-Users. Sofern Sie SSL-Credentials (RSA-Private- und Public-Key) - wie unter Debian/ | + | === OpenSUSE Leap 15.1 === |
+ | |||
+ | OpenSUSE Leap 15 kommt mit Tomcat | ||
<code bash> | <code bash> | ||
- | root@idp: | + | root@idp: |
</ | </ | ||
- | ==== Java-Konfiguration ==== | + | ==== Startup-Konfiguration ==== |
- | Einige globale Java-Parameter müssen beim Tomcat-Start festgelegt werden. Das IdP-Servlet benötigt mehr Speicher, als gemäß den Voreinstellungen vorgesehen ist und Zugriff auf das Filesystem. | + | Einige globale Java-Parameter müssen beim Tomcat-Start festgelegt werden. Das IdP-Servlet benötigt mehr Speicher, als gemäß den Voreinstellungen vorgesehen ist und Zugriff auf das Filesystem: |
- | Durch Angabe von / | + | |
- | === Debian | + | === Debian |
- | <file bash / | + | <file bash / |
# den Tomcat mit genug Speicher starten: | # den Tomcat mit genug Speicher starten: | ||
- | JAVA_OPTS=" | + | JAVA_OPTS=" |
+ | </ | ||
+ | |||
+ | <file ini / | ||
+ | [Service] | ||
+ | ReadWritePaths=/ | ||
+ | ReadWritePaths=/ | ||
+ | </file> | ||
+ | |||
+ | === Debian 8/9 === | ||
+ | |||
+ | <file bash /etc/ | ||
+ | # den Tomcat mit genug Speicher starten: | ||
+ | JAVA_OPTS=" | ||
# Zugriff auf das File-System: | # Zugriff auf das File-System: | ||
TOMCAT8_SECURITY=no | TOMCAT8_SECURITY=no | ||
</ | </ | ||
- | === CentOS/RHEL === | + | === CentOS |
- | Die Tomcat-Start-Optionen werden in /etc/tomcat8/tomcat8.conf festegelegt. | + | Die Tomcat-Start-Optionen werden in '' |
==== Port-Konfigurtion ==== | ==== Port-Konfigurtion ==== | ||
Zeile 72: | Zeile 68: | ||
* auf Port 8009 der AJP-Connector aktiviert über den der vorgelagerte Webserver Anfragen an Tomcat weiterleitet | * auf Port 8009 der AJP-Connector aktiviert über den der vorgelagerte Webserver Anfragen an Tomcat weiterleitet | ||
- | <file xml /etc/tomcat8/server.xml> | + | <file xml /etc/tomcatX/ |
- | <Server port=" | + | |
< | < | ||
<Service name=" | <Service name=" | ||
Zeile 92: | Zeile 87: | ||
| | ||
<!-- ... --> | <!-- ... --> | ||
- | </ | + | </ |
<!-- ... --> | <!-- ... --> | ||
- | </ | + | </ |
- | </ | + | |
- | Um das IdP-Servlet im Tomcat zu aktivieren, erstellen | + | IdP-Sessions gehen bei einem Tomcat-Neustart in jedem Fall verloren. Daher ergibt es keinen Sinn (bzw. führt nur zu unnötigen IdP-Fehlermeldungen), einzustellen, |
- | <code xml /etc/tomcat8/Catalina/ | + | |
- | <Context docBase="/opt/shibboleth-idp/war/idp.war" | + | <file xml /etc/tomcatX/context.xml> |
- | privileged="true" | + | <?xml version="1.0" encoding=" |
- | unpackWAR=" | + | <!-- |
- | antiResourceLocking=" | + | ... |
- | swallowOutput=" | + | --> |
+ | <!-- The contents of this file will be loaded for each web application --> | ||
+ | < | ||
+ | |||
+ | <!-- Default set of monitored resources. If one of these changes, the --> | ||
+ | <!-- web application will be reloaded. | ||
+ | < | ||
+ | < | ||
+ | |||
+ | <!-- Uncomment this to disable session persistence across Tomcat restarts --> | ||
+ | |||
+ | <!-- siehe https://wiki.shibboleth.net/ | ||
+ | < | ||
+ | |||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ==== Java Standard Tag Library (JSTL) ==== | ||
+ | === Debian 10 === | ||
+ | Unter Debian 10 kann die JSTL aus dem Debian-Repository installiert werden: | ||
+ | <code bash> | ||
+ | root@idp:~# apt install libtaglibs-standard-impl-java | ||
</ | </ | ||
- | ====Java Server Tag Library (JSTL)==== | + | Anschließend muss der Pfad zur .jar-Datei noch ''/ |
- | Als letztes | + | <file xml / |
+ | common.loader=" | ||
+ | </ | ||
+ | |||
+ | === Debian 8/9 === | ||
+ | Unter Debian 8 und 9 muss die fehlerfreie Version der Java Standard | ||
<code bash> | <code bash> | ||
- | root@idp:~# cd / | ||
root@idp:~# wget https:// | root@idp:~# wget https:// | ||
-O / | -O / | ||
+ | </ | ||
+ | |||
+ | === OpenSUSE Leap 15.1 === | ||
+ | |||
+ | <code bash> | ||
+ | root@idp:~# zypper install jakarta-taglibs-standard | ||
</ | </ | ||
Zeile 121: | Zeile 146: | ||
<code bash> | <code bash> | ||
- | root@idp:~# systemctl restart | + | root@idp:~# systemctl restart |
</ | </ | ||
- | Lassen | + | Behalten |
- | ob es beim Start Probleme gibt: | + | |
<code bash> | <code bash> | ||
- | root@idp:~# tail -f /var/log/tomcat8/catalina.out | + | root@idp:~# tail -f /var/log/tomcatX/catalina.DATUM.log |
+ | # oder | ||
+ | root@idp:~# journalctl -u tomcat -f | ||
</ | </ | ||
- | Sofern der Tomcat nicht fehlerfrei startet sollten Sie dem erst nachgehen bevor Sie mit dieser Anleitung weiter machen. Wenn im Log die Meldung " | + | Sofern der Tomcat nicht fehlerfrei startet sollten Sie dem erst nachgehen, bevor Sie mit dieser Anleitung weiter machen. Wenn im Log die Meldung " |
<code bash> | <code bash> | ||
- | root@idp:~# netstat -tlpen | grep java | + | root@idp:~# netstat -tlpn | grep java |
- | tcp6 | + | (tcp6 |
- | tcp6 | + | |
</ | </ | ||
+ | ==== Konfiguration für das IdP-Servlet vorbereiten ==== | ||
+ | Um das IdP-Servlet im Tomcat zu aktivieren, erstellen Sie folgende Datei im Tomcat-localhost-Context: | ||
+ | |||
+ | <file xml / | ||
+ | <Context docBase="/ | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | |||
+ | **Achtung: | ||
- | ====Tomcat | + | Solange nichts unter / |
- | Wir empfehlen Tomcat8, siehe oben. Falls Sie noch Tomcat7 einsetzen ist das folgende vielleicht hilfreich: | + | Weiter geht es mit [[:de: |
- | Sollte es beim Neustart nach Installation und Konfiguration des IdP folgender Fehlermeldung kommen:\\ | ||
- | > " | ||
- | ... so muss die Tomcat-eigene web.xml angepasst werden. Siehe hierzu http:// | ||
- | Bei Debian/ | ||