WildFly Application Server Administration Seminarunterlage Version: 1.04

Copyright ORDIX AG

Version 1.04 vom 18. Januar 2017

Dieses Dokument wird durch die ORDIX AG veröffentlicht. Copyright ORDIX AG. Alle Rechte vorbehalten. Alle Produkt- und Dienstleistungs-Bezeichnungen sind Warenzeichen oder eingetragene Warenzeichen der jeweiligen Firmen und beziehen sich auf Eintragungen in den USA oder USA-Warenzeichen. Weitere Logos und Produkt- oder Handelsnamen sind eingetragene Warenzeichen oder Warenzeichen der jeweiligen Unternehmen. Kein Teil dieser Dokumentation darf ohne vorherige schriftliche Genehmigung der ORDIX AG weitergegeben oder benutzt werden.

Adressen der ORDIX AG Die ORDIX AG besitzt folgende Geschäftsstellen

ORDIX AG Karl-Schurz-Straße 19a D-33100 Paderborn Tel.: (+49) 0 52 51 / 10 63 - 0 Fax.: (+49) 01 80 / 1 67 34 90

ORDIX AG Kreuzberger Ring 13 D-65205 Wiesbaden Tel.: (+49) 06 11 / 7 78 40 – 00 Fax.: (+49) 01 80 / 1 67 34 90

ORDIX AG An der alten Ziegelei 5 D-48157 Münster Tel.: (+49) 02 51 / 9 24 35 – 00 Fax.: (+49) 01 80 / 1 67 34 90

ORDIX AG Wikingerstraße 18-20 D-51107 Köln Tel.: (+49) 02 21 / 8 70 61 – 0 Fax.: (+49) 01 80 / 1 67 34 90

ORDIX AG Welser Straße 9 D-86368 Gersthofen Tel.: (+49) 08 21 / 507 492 – 0 Fax.: (+49) 01 80 / 1 67 34 90

Internet: https://www.ordix.de Email: [email protected]

Seite 2 WildFly Application Server Administration

Version: 1.04 Copyright ORDIX AG

Inhaltsverzeichnis

Inhaltsverzeichnis 1

Einführung in Java EE: Grundlagen und Begriffsdefinitionen............................................ 7 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 1.22 1.23 1.24

2

Einführung WildFly........................................................................................................... 33 2.1 2.2 2.3

3

Installation – Vorbereitung ......................................................................................... 38 Installation – Vorbereitung des Systems (Unix) ........................................................... 39 Installation der Soft ware ............................................................................................ 40 Verzeichnisstruktur ................................................................................................... 41 Verzeichnisstruktur im Standalone-Modus .................................................................. 42 Start des Servers im Standalone-Modus .................................................................... 43 Standard-Konfigurationsdateien................................................................................. 44 Stopp des Servers .................................................................................................... 45 JVM-Konfiguration für den Start des WildFly ............................................................... 46

Kernkomponenten............................................................................................................ 47 4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8

5

Der WildFly Application Server im Überblick ............................................................... 34 Projekte rund um den WildFly (Auszug)...................................................................... 35 WildFly im Web ........................................................................................................ 36

Installation........................................................................................................................ 37 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9

4

Grundlagen und Begriffsdefinitionen ............................................................................ 8 Komponenten von JSE / Java EE ................................................................................ 9 Was ist Java EE? ..................................................................................................... 10 Aufgaben eines Java EE Servers ............................................................................... 12 Java EE-Arc hitektur .................................................................................................. 13 Java EE Server Bestandteile ..................................................................................... 14 EJB – Enterprise Java Beans .................................................................................... 15 Servlets.................................................................................................................... 16 Was ist ein Servlet? .................................................................................................. 17 Funktionsweise von Servlets ..................................................................................... 18 Was ist ein Servlet-Container?................................................................................... 19 Java Server Pages (JSP) .......................................................................................... 20 JSP Motivation ......................................................................................................... 21 Funktionsweise von JSPs.......................................................................................... 22 Vergleich JSP Servlets .............................................................................................. 23 Typische Java EE Architektur .................................................................................... 24 HTTP - HyperText Trans fer Protocol .......................................................................... 25 HTTP Request / Response ........................................................................................ 26 HTTP-Methoden (Auswahl) ....................................................................................... 27 HTTP Statuscodes (Aus wahl) .................................................................................... 28 Was ist HTML? ......................................................................................................... 29 HTML – Eigenschaften.............................................................................................. 30 Dynamische HTML-Seiten......................................................................................... 31 Dynamische HTML-Seiten erzeugen .......................................................................... 32

Konfiguration – Übersicht .......................................................................................... 48 Paths ....................................................................................................................... 49 Extensions ............................................................................................................... 50 Subsystems ............................................................................................................. 51 Interfaces ................................................................................................................. 52 Interfaces – Weitere Definitionsmöglichkeit en ............................................................. 53 Socket Binding Groups.............................................................................................. 54 System Properties .................................................................................................... 55

Deployment ...................................................................................................................... 56 5.1 5.2 5.3 5.4

Deployment Deployment Deployment Deployment

Version: 1.04 Copyright ORDIX AG

– Übersicht ............................................................................................ 57 – Paket formen ....................................................................................... 58 –Scanner............................................................................................... 59 – Marker Files ....................................................................................... 60 Seite 3 WildFly Application Server Administration

Inhaltsverzeichnis 5.5 5.6 5.7 5.8 6

Logging ............................................................................................................................ 65 6.1 6.2 6.3 6.4 6.5 6.6 6.7 6.8 6.9 6.10

7

Administrations-Schnittstellen .................................................................................... 77 Management Schnittstelle des WildFly ....................................................................... 78 Management Interface Konfiguration.......................................................................... 79 Management Interface Zugriffssteuerung ................................................................... 80 Aufruf des CLI .......................................................................................................... 81 Standard CLI-Kommandos ........................................................................................ 82 Weitere CLI Kommandos .......................................................................................... 83 Operationen im CLI................................................................................................... 84 Beispiel - Intervall für den Deployment Scanner ändern............................................... 85 Batch Mode .............................................................................................................. 86 Nicht interaktiver Modus ............................................................................................ 87 Snapshots und automatische Sicherungen ................................................................. 88

Datasource s ..................................................................................................................... 89 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 8.10 8.11 8.12 8.13

9

Logging im WildFly ................................................................................................... 66 Handler – Überblick .................................................................................................. 67 LogLevel – Überblick ................................................................................................ 68 Cons ole Handler ....................................................................................................... 69 File Handler (periodic-rotating-file) ............................................................................. 70 Syslog Handler ......................................................................................................... 71 Pattern ..................................................................................................................... 72 Logger ..................................................................................................................... 73 Audit Logging ........................................................................................................... 74 Audit Logging – Beispielkonfiguration lokale Datei ...................................................... 75

Admin-Interface s .............................................................................................................. 76 7.1 7.2 7.3 7.4 7.5 7.6 7.7 7.8 7.9 7.10 7.11 7.12

8

Parameter für den Deployment-Scanner .................................................................... 61 Manuelles Deployment .............................................................................................. 62 Status aktueller Deployments prüfen .......................................................................... 63 Redeployment .......................................................................................................... 64

Datasource – Überblick ............................................................................................. 90 Datasource – Beispielcode ........................................................................................ 91 Datasource - Konfiguration im WildFly........................................................................ 92 Installation des JDB C Treibers als Modul ................................................................... 93 Registrierung des Treibers im datasource subsystem.................................................. 94 Anzeige der installierten Treiber................................................................................. 95 Konfiguration der Datas ourc e im Subsystem .............................................................. 96 Konfiguration der Datas ourc e über das CLI ................................................................ 97 Konfiguration des Connection Pools für eine DS ......................................................... 98 Konfiguration des Connection Pools – Beispiel ........................................................... 99 Test der DB Connection über das CLI .......................................................................100 Automatische Überwac hung und Reconnect..............................................................101 Alternative Installation des Treibers als Deployment ...................................................102

Messaging (JMS) .............................................................................................................103 9.1 9.2 9.3

JMS Allgemein ........................................................................................................104 HornetQ – JMS Provider im WildFly ..........................................................................107 Konfiguration HornetQ – Acceptors und Connectors ..................................................108 9.3.1 Konfiguration HornetQ - Acceptors .............................................................. 109 9.3.2 Konfiguration HornetQ - Connectors ............................................................ 110 9.4 Konfiguration HornetQ – Connection Factories ..........................................................111 9.5 Konfiguration HornetQ – JMS -Destinations ................................................................112 9.6 Konfiguration HornetQ – Address Settings.................................................................113 9.7 HornetQ Sec urity Settings ........................................................................................114 9.8 HornetQ Sec urity Settings – Permissions ..................................................................115 9.9 HornetQ Konfiguration via CLI ..................................................................................116 9.10 HornetQ Steuerung via CLI ......................................................................................117 Seite 4 WildFly Application Server Administration

Version: 1.04 Copyright ORDIX AG

Inhaltsverzeichnis 10

Undertow .........................................................................................................................118 10.1 10.2 10.3 10.4 10.5 10.6 10.7 10.8 10.9 10.10 10.11 10.12 10.13 10.14 10.15 10.16 10.17 10.18 10.19 10.20 10.21 10.22

11

Security ...........................................................................................................................141 11.1 11.2 11.3 11.4 11.5 11.6 11.7 11.8 11.9 11.10 11.11 11.12 11.13 11.14 11.15 11.16 11.17 11.18 11.19 11.20 11.21 11.22

12

Web Server Undert ow – Übersicht ............................................................................119 Konfiguration / Schema ............................................................................................120 Server .....................................................................................................................121 Listener ...................................................................................................................122 HTTP Listener Konfiguration.....................................................................................123 Host Konfiguration ...................................................................................................124 Access Log Konfiguration .........................................................................................125 Undertow Filter ........................................................................................................126 Undertow Filter – Beispiele .......................................................................................127 Handler und Locations .............................................................................................128 Buffer Cache ...........................................................................................................129 Servlet Container Konfiguration ................................................................................130 Servlet Container Konfiguration – Beispiel .................................................................131 JSP Konfiguration ....................................................................................................132 JSP Konfiguration – Beispiel.....................................................................................133 Session Cookie Konfiguration ...................................................................................134 Session Cookie Konfiguration – Beispiel ...................................................................135 Persistente Sessions ...............................................................................................136 HTTPS Konfiguration ..............................................................................................137 HTTPS Konfiguration - Zertifikat generieren ..............................................................138 HTTPS Konfiguration - Security Realm......................................................................139 HTTPS Konfiguration – Listener................................................................................140

Security Subsystem im WildFly .................................................................................142 Security Domains ....................................................................................................143 Security Cont raints auf Anwendungsseite..................................................................144 Auswahl der Sec urity Domain auf Anwendungsseite ..................................................145 Konfiguration der Security Domain im WildFly............................................................146 Security Domain - Login Module zur Authentifizierung ................................................147 Beispiel Login Module Users Roles ............................................................................148 Beispiel Login Module LdapExtended........................................................................149 Security Realms ......................................................................................................150 Security Realms - Schematischer Aufbau ..................................................................151 Security Realms - Authentication Varianten ...............................................................152 Security Realms - Authentication ...................................................................153 Security Realms - Authentication ...........................................................154 Security Realms - Management Realm .....................................................................155 Security Realms - Application Realm.........................................................................156 Security Realms - add_user Utility ............................................................................157 Security Realms - Authentication ...................................................................158 LDAP Outbound Connection.....................................................................................159 Komplexere LDAP Security Realms ..........................................................................160 Role Bas ed Access Control – RBAC .........................................................................161 RBAC – Rollen ........................................................................................................162 RBAC - Aktivierung des rbac Providers über das CLI .................................................163

Loadbalancing.................................................................................................................164 12.1 12.2 12.3 12.4 12.5 12.6 12.7 12.8 12.9 12.10

Loadbalancing – Übersicht .......................................................................................165 Loadbalancing – Schaubild.......................................................................................166 Loadbalancing mit WildFly und Apache .....................................................................167 Loadbalancing mit Apache Tomcat Connector / mod_jk.............................................168 Loadbalancing mit mod_jk / Übersicht .......................................................................169 Loadbalancing mit mod_jk / Vorgehensweise ............................................................170 Loadbalancing mit mod_jk / AJP Listener im Undertow...............................................171 Loadbalancing mit mod_jk / Installation .....................................................................172 Loadbalancing mit mod_jk / workers.properties ..........................................................173 Loadbalancing mit mod_jk / Apache Konfiguration .....................................................174

Version: 1.04 Copyright ORDIX AG

Seite 5 WildFly Application Server Administration

Inhaltsverzeichnis 12.11 12.12 12.13 12.14 12.15 12.16 12.17 12.18 12.19 12.20 12.21 12.22 12.23 12.24 12.25 13

mod_jk / Hinweise........................................................................175 mod_jk / Monitoring......................................................................176 mod_jk / Session Persistence .......................................................177 mod_proxy_balancer / Übersicht...................................................178 mod_proxy_balancer / Schaubild ..................................................179 mod_proxy_balancer / Apache-K onfiguration.................................180 mod_proxy_balancer / Status .......................................................181 mod_cluster / Übersicht................................................................182 mod_cluster / Installation..............................................................183 mod_cluster / Apache Konfiguration ..............................................184 mod_cluster / WildFly Konfiguration ..............................................186 mod_cluster / CLI ........................................................................188 mod_cluster / Load Metriken.........................................................189 mod_cluster / Standard Load Metriken ..........................................190 mod_cluster / Load Metrik Beispiel................................................191

Clustering........................................................................................................................192 13.1 13.2 13.3 13.4 13.5 13.6 13.7 13.8 13.9 13.10

14

Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit Loadbalancing mit

Clustering – Übersicht ..............................................................................................193 Clustering - Komponent en im WildFly........................................................................194 Clustering - Beispiel Replikation von HTTP Sessions .................................................195 Clustering - Vorbereitung der WildFly Instanzen.........................................................196 Clustering - JGroups Übersicht .................................................................................197 Clustering - JGroups Konfiguration / Beispiel UDP Stack ............................................198 Clustering - JGroups Konfiguration / Socket Bindings .................................................199 Clustering - Infinispan Übersicht ...............................................................................200 Clustering - Infinispan Konfiguration Beispiel .............................................................201 Clustering - Konfiguration der Webanwendungen.......................................................202

Domain Mode ..................................................................................................................203 14.1 14.2 14.3 14.4 14.5 14.6 14.7 14.8 14.9 14.10 14.11 14.12 14.13 14.14 14.15 14.16

Domain Mode – Übersicht ........................................................................................204 Domain Mode - Schaubild / Beispiel ..........................................................................205 Domain Mode - Konfiguration / Start und Stopp .........................................................206 Domain Mode - domain.xml ......................................................................................207 Domain Mode - Server Groups .................................................................................208 Domain Mode - host.xml ..........................................................................................209 Domain Mode - host.xml / Definition host name .........................................................210 Domain Mode - host.xml / Domain Controller .............................................................211 Domain Mode - Master-Slave Konfiguration...............................................................212 Domain Mode - host.xml - JVM Einstellungen ............................................................214 Domain Mode - host.xml - Server Instanzen ..............................................................215 Domain Mode - host.xml - Server Parameter .............................................................216 Domain Mode - Administration per CLI ......................................................................217 Domain Mode - Start und Stopp der Server ...............................................................218 Domain Mode – Deployment ....................................................................................219 Domain Mode - Vorteile und Nachteile ......................................................................220

Seite 6 WildFly Application Server Administration

Version: 1.04 Copyright ORDIX AG