Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- tachtler:apache_tomcat_manager_und_monitor_-_psi-probe [2015/05/13 13:43] – klaus
+++ tachtler:apache_tomcat_manager_und_monitor_-_psi-probe [2015/05/13 15:24] (aktuell) – [Tomcat starten] klaus
@@ Zeile 1969: / Zeile 1969: @@
   * Lauffähiger Applikations-Server z.B. [[http://tomcat.apache.org/|Apache Tomcat]] **ab Version 7.0.x**
     * Siehe auch den internen Link: [[tachtler:apache_tomcat_7|Apache Tomcat 7]]
+    * Siehe auch **__insbesondere__** den internen Link: [[tachtler:apache_tomcat_7#etc_tomcat_tomcat-usersxml|Apache Tomcat 7 - Konfiguration - /etc/tomcat/tomcat-users.xml]]
 Nachfolgende Voraussetzungen sind **optional**:
-    * Siege auch den internen Link: [[tachtler:apache_tomcat_7_-_ldap-authentifizierung_jndirealm|Apache Tomcat 7 - LDAP-Authentifizierung JNDIRealm]]
   * Lauffähiger LDAP-Server z.B. [[http://www.openldap.org|OpenLDAP]]
     * Siehe auch den internen Link: [[tachtler:ldap_centos_7|LDAP CentOS 7]]
+    * Siehe auch den internen Link: [[tachtler:apache_tomcat_7_-_ldap-authentifizierung_jndirealm|Apache Tomcat 7 - LDAP-Authentifizierung JNDIRealm]]
+    * Siehe auch den internen Link: [[tachtler:apache_tomcat_7_-_logging_-_log4j|Apache Tomcat 7 - Logging - log4j]]
+:!: **WICHTIG** - **Es ist erforderlich, dass ein Benutzer mit Passwort für die Rolle __manager_gui__ definiert ist und der Benutzername und das Passwort bekannt sind!**
+:!: **HINWEIS** - **Von der Definition weiterer nachfolgender __möglicher__ Rollen, soll nachfolgend abgesehen werden!**
+<code xml>
+<role rolename="probeuser" />
+<role rolename="poweruser" />
+<role rolename="poweruserplus" />
+</code>
+==== /etc/tomcat/tomcat.conf ====
+[[https://github.com/psi-probe|psi-probe]] benötigt **"Remote JMX"** um sich mit dem [[http://tomcat.apache.org|Apache Tomcat]]-Applikation-Server entsprechend verbinden zu können um verschiedene Informationen wie z.B. (Speicherverbrauch, Cluster Datenverkehr, Verbindungs-Pools und Aktive "threads") ermitteln und anzeigen zu können. Die ist **optional**, aber jedoch **__ohne__** **"Remote JMX"** sind die erweiterten Abfrage- und Anzeigemöglichkeiten Möglichkeiten **__nicht__ nutzbar**.
+Um **"Remote JMX"** aktivieren zu können, ist das Hinzufügen nachfolgender Zeile in die Konfigurationsdatei
+  * ''etc/tomcat/tomcat.conf''
+an entsprechenden Stelle notwendig
+<code xml>
+-Dcom.sun.management.jmxremote=true
+</code>
+Hier die **komplette Konfigurationsdatei** mit allen Änderungen bzw. Ergänzungen, welche ebenfalls nachfolgend erklärt werden:
+<code ini>
+# System-wide configuration file for tomcat services
+# This will be loaded by systemd as an environment file,
+# so please keep the syntax.
+#
+# There are 2 "classes" of startup behavior in this package.
+# The old one, the default service named tomcat.service.
+# The new named instances are called tomcat@instance.service.
+#
+# Use this file to change default values for all services.
+# Change the service specific ones to affect only one service.
+# For tomcat.service it's /etc/sysconfig/tomcat, for
+# tomcat@instance it's /etc/sysconfig/tomcat@instance.
+# This variable is used to figure out if config is loaded or not.
+TOMCAT_CFG_LOADED="1"
+# In new-style instances, if CATALINA_BASE isn't specified, it will
+# be constructed by joining TOMCATS_BASE and NAME.
+TOMCATS_BASE="/var/lib/tomcats/"
+# Where your java installation lives
+JAVA_HOME="/usr/lib/jvm/jre"
+# Where your tomcat installation lives
+CATALINA_HOME="/usr/share/tomcat"
+# System-wide tmp
+CATALINA_TMPDIR="/var/cache/tomcat/temp"
+# You can pass some parameters to java here if you wish to
+#JAVA_OPTS="-Xminf0.1 -Xmaxf0.3"
+# Use JAVA_OPTS to set java.library.path for libtcnative.so
+# Tachtler
+# default: #JAVA_OPTS="-Djava.library.path=/usr/lib"
+JAVA_OPTS="-Dcom.sun.management.jmxremote=true -Djava.security.egd=file:/dev/./urandom -Djava.library.path=/usr/lib64 -server -Xms128m -Xmx512m"
+# You can change your tomcat locale here
+#LANG="en_US"
+# Run tomcat under the Java Security Manager
+SECURITY_MANAGER="false"
+# Time to wait in seconds, before killing process
+# TODO(stingray): does nothing, fix.
+# Tachtler
+# default: # SHUTDOWN_WAIT="30"
+SHUTDOWN_WAIT="300"
+# If you wish to further customize your tomcat environment,
+# put your own definitions here
+# (i.e. LD_LIBRARY_PATH for some jdbc drivers)
+</code>
+**Nachfolgend die Erklärungen zu den gemachten Änderungen bzw. Ergänzungen:**
+=== JAVA_OPTS ===
+Ergänzungen zu den Java-Optionen:
+<code ini>
+# Use JAVA_OPTS to set java.library.path for libtcnative.so
+# Tachtler
+# default: #JAVA_OPTS="-Djava.library.path=/usr/lib"
+JAVA_OPTS="-Dcom.sun.management.jmxremote=true -Djava.security.egd=file:/dev/./urandom -Djava.library.path=/usr/lib64 -server -Xms128m -Xmx512m"
+</code>
+*1 //''-Dcom.sun.management.jmxremote=true'' = Aktivieren von "Remote JMX"\\ //
+*2 //''-Djava.security.egd=file:/dev/./urandom'' = Setzen einer alternativen Entropien-Quelle\\ //
+*3 //''-Djava.library.path=/usr/lib64'' = Setzen des Pfades zur Native Laufzeit Bibliothek [[http://tomcat.apache.org/native-doc/|The Apache Tomcat Native]] - libtcnative-1.so\\ //
+*4 //''-server'' = Betrieb im Server-Modus// \\
+*5 //''-Xms128m'' = minimaler RAM-Speicher welche beim Start des [[http://tomcat.apache.org/|Apache Tomcat]] Application Servers reserviert werden soll// \\
+*6 //''-Xmx512m'' = maximaler RAM-Speicher welche durch den [[http://tomcat.apache.org/|Apache Tomcat]] Application Servers belegt werden kann//
+:!: **HINWEIS** - Die Angabe einer Option zu ''MaxPermSize'' ist nicht mehr erforderlich. Siehe auch nachfolgenden Hinweis, falls doch eine Angabe wie
+  * ''-XX:MaxPermSize=256m''
+als **JAVA_OPTS** unter JAVA **ab Version 1.8.0** angegeben wird:
+<code xml>
+OpenJDK 64-Bit Server VM warning: ignoring option MaxPermSize=256m; support was removed in 8.0
+</code>
+==== Tomcat stoppen ====
+Mit nachfolgenden Befehl, kann der [[http://tomcat.apache.org/|Apache Tomcat]] gestoppt werden:
+<code>
+# systemctl stop tomcat.service
+</code>
+==== Kopieren probe.war ====
+Mit nachfoglendem Befehl kann nun die Web-Applikation - ''probe.war''-Datei in das [[http://tomcat.apache.org/|Apache Tomcat]]-Web-Applikations-Verzeichnis
+  * ''/var/lib/tomcat/webapps''
+kopiert werden:
+**__Variante 1__: probe.war "stable" (stabile) Version:**
+<code>
+# cp /tmp/probe.war /var/lib/tomcat/webapps
+</code>
+**__Variante 1__: probe.war "eigene" (letzten Entwicklungsstand) Version:**
+<code>
+# cp /tmp/psi-probe/web/target/probe.war /var/lib/tomcat/webapps
+</code>
+Abschließend können noch mit nachfolgendem Befehl die **Besitz**rechte an der ''probe.war''-Datei auf den [[http://tomcat.apache.org/|Apache Tomcat]]-Benutzer - ''tomcat'' gesetzt werden:
+<code>
+# chown tomcat:tomcat /var/lib/tomcat/webapps/probe.war
+</code>
+Mit nachfolgendem Befehl kann anschließend das Verzeichnis
+  * ''/var/lib/tomcat/webapps''
+aufgelistet werden:
+<code>
+# ls -l /var/lib/tomcat/webapps
+total 12676
+drwxr-xr-x 14 root   root       4096 May  7 18:03 docs
+drwxr-xr-x  5 root   tomcat       82 May  5 14:54 host-manager
+drwxr-xr-x  5 root   tomcat       97 May  5 14:54 manager
+-rw-r--r--  1 tomcat tomcat 12966158 May 13 14:34 probe.war
+drwxr-xr-x  3 tomcat tomcat     4096 May 12 15:10 ROOT
+drwxr-xr-x  3 tomcat tomcat     4096 May 11 13:19 standard
+</code>
+==== Tomcat starten ====
+Mit nachfolgenden Befehl, kann der [[http://tomcat.apache.org/|Apache Tomcat]] gestartet werden:
+<code>
+# systemctl start tomcat.service
+</code>
+Nachfolgende Ausgabe sollte dann in der LOG-Datei
+  * ''/var/log/tomcat/catalina.out''
+des [[http://tomcat.apache.org/|Apache Tomcat]] zu finden sein:
+(**Nur relevanter Ausschnitt**)
+<code>
+-05-13 14:36:21,841 [localhost-startStop-1] INFO  org.apache.catalina.startup.HostConfig- Deploying web application archive /var/lib/tomcat/webapps/probe.war
+-05-13 14:36:25,801 [localhost-startStop-1] INFO  org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/probe]- Initializing Spring root WebApplicationContext
+-05-13 14:36:26,770 [localhost-startStop-1] INFO  org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/probe]- Initializing Spring FrameworkServlet 'probe'
+-05-13 14:36:28,297 [localhost-startStop-1] INFO  org.apache.catalina.startup.HostConfig- Deployment of web application archive /var/lib/tomcat/webapps/probe.war has finished in 6,454 ms
+</code>
+===== Aufruf psi-probe =====
+Nach der erfolgreichen Installation, kann die Web-Applikation z.B. unter nachfolgender URL aufgerufen werden:
+  * [[http://127.0.0.1:8088]]
+und sollte eine Ausgabe wie nachfolgend dargestellt zum Vorschein bringen:
+{{:tachtler:tomcat:tomcat_psi-probe_start.png|Apache Tomcat - psi-probe - Startseite}}