JBoss Enterprise Application Platform 6.4 Handbuch zum Einstieg
Transcrição
JBoss Enterprise Application Platform 6.4 Handbuch zum Einstieg
JBoss Enterprise Application Platform 6.4 Handbuch zum Einstieg Für den Gebrauch mit der Red Hat JBoss Enterprise Application Platform 6 Nidhi Chaudhary Sande Gilda Darrin Mison Misty Stanley-Jones Lucas Costi Vikram Goyal Scott Mumford Keerat Verma Russell Dickenson Eamon Logue David Ryan Tom Wells JBoss Enterprise Application Platform 6.4 Handbuch zum Einstieg Für den Gebrauch mit der Red Hat JBoss Enterprise Application Platform 6 Nidhi Chaudhary Lucas Co sti Russell Dickenso n Sande Gilda Vikram Go yal Eamo n Lo gue Darrin Miso n Sco tt Mumfo rd David Ryan Misty Stanley-Jo nes Keerat Verma To m Wells Rechtlicher Hinweis Co pyright © 20 15 Red Hat, Inc.. This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0 Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red Hat trademarks must be remo ved. Red Hat, as the licenso r o f this do cument, waives the right to enfo rce, and agrees no t to assert, Sectio n 4 d o f CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shado wman lo go , JBo ss, MetaMatrix, Fedo ra, the Infinity Lo go , and RHCE are trademarks o f Red Hat, Inc., registered in the United States and o ther co untries. Linux ® is the registered trademark o f Linus To rvalds in the United States and o ther co untries. Java ® is a registered trademark o f Oracle and/o r its affiliates. XFS ® is a trademark o f Silico n Graphics Internatio nal Co rp. o r its subsidiaries in the United States and/o r o ther co untries. MySQL ® is a registered trademark o f MySQL AB in the United States, the Euro pean Unio n and o ther co untries. No de.js ® is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally related to o r endo rsed by the o fficial Jo yent No de.js o pen so urce o r co mmercial pro ject. The OpenStack ® Wo rd Mark and OpenStack Lo go are either registered trademarks/service marks o r trademarks/service marks o f the OpenStack Fo undatio n, in the United States and o ther co untries and are used with the OpenStack Fo undatio n's permissio n. We are no t affiliated with, endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity. All o ther trademarks are the pro perty o f their respective o wners. Z usammenfassung Dieses Buch liefert die ersten Schritte zum Einstieg in die JBo ss EAP 6 . Inhalt sverz eichnis Inhaltsverzeichnis . .orwort V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . . 1. Do kumentko nventio nen 3 1.1. Typ o g rafis c he Ko nventio nen 3 1.2. Ko nventio nen für Seitenans p rac hen 4 1.3. Anmerkung en und Warnung en 5 2 . Hilfe und Feed b ac k 6 2 .1. Brauc hen Sie Hilfe? 6 2 .2. Wir freuen uns auf Ihr Feed b ac k 6 . .apit K . . . el . . 1. . Einführung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . . 1.1. Üb er d ie Red Hat JBo s s Enterp ris e Ap p lic atio n Platfo rm 6 7 1.2. Üb er d as Red Hat Kund enp o rtal 7 1.3. Üb er d as Red Hat JBo s s Develo p er Pro g ram 7 1.4. Üb er d as Full Red Hat JBo s s Co mmerc ial Pro g ram 1.5. Weitere Info rmatio nen 7 8 . .apit K . . . el . . 2. . Vorausset . . . . . . . . . z. ungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. . . . . . . . . . 2 .1. JBo s s EAP 6 Ins tallatio ns vo raus s etz ung en 9 . .apit K . . . el . . 3. . . Download . . . . . . . . . und . . . . Inst . . . .allat . . . .ion . . . des . . . .Produkt . . . . . . .s. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 0. . . . . . . . . . 3 .1. JBo s s EAP Ins tallatio ns üb ers ic ht 10 3 .2. Do wnlo ad und Ins tallatio n d er JBo s s EAP mit d em g rafis c hen Ins tallatio ns p ro g ramm 10 3 .2.1. Herunterlad en d es JBo s s EAP 6 Ins tallatio ns p ro g ramms 10 3 .2.2. Aus führen d es JBo s s EAP Ins tallatio ns p ro g ramms 11 3 .3. Do wnlo ad und Ins tallatio n d er JBo s s EAP mit d er ZIP-Datei. 13 3 .3.1. Herunterlad en vo n JBo s s EAP 6 (ZIP-Ins tallatio n) 13 3 .3.2. Ins tallieren d er JBo s s EAP 6 (ZIP-Ins tallatio n) 14 3 .4. Do wnlo ad d er Q uic ks tart Co d e-Beis p iele 14 3 .4.1. Die Q uic ks tarts herunterlad en 14 . .apit K . . . el . . 4. . Anweisungen . . . . . . . . . . . . .nach . . . . der . . . .Inst . . . allat . . . . ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 6. . . . . . . . . . 4 .1. Einric hten d er Entwic klung s umg eb ung 16 4 .1.1. Üb ers ic ht d er Red Hat JBo s s Develo p er Stud io Ins tallatio n 16 4 .1.2. Herunterlad en d es Red Hat JBo s s Develo p er Stud io 16 4 .1.3. Ins tallieren d es Red Hat JBo s s Develo p er Stud io 16 4 .1.4. Starten d es Red Hat JBo s s Develo p er Stud io 17 4 .1.5. Den JBo s s EAP Server mittels Define New Server hinz ufüg en 17 4 .2. Ko nfig urieren Sie Maven 23 4 .2.1. Üb er Maven 23 4 .2.2. Ko nfig urieren d er Maven-Eins tellung en 23 4 .2.3. Ko nfig urieren Sie Maven z ur Verwend ung mit Red Hat JBo s s Develo p er Stud io 24 4 .2.3.1. Ko nfig urieren vo n Maven z ur Verwend ung mit Red Hat JBo s s Develo p er Stud io 24 4 .2.4. Ko nfig urieren Sie Maven z ur Verwend ung mit Befehls z eile 28 4 .2.4.1. Do wnlo ad und Ins tallatio n vo n Maven 28 4 .2.4.2. Ko nfig urieren d er Maven-Eins tellung en z ur Verwend ung mit Befehls z eile 29 . .apit K . . . el . . 5. . . Probieren . . . . . . . . . Sie . . . es . . .aus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 ........... 5 .1. Führen Sie d ie Q uic ks tarts aus 33 5 .1.1. Aus führen d er Q uic ks tarts in Red Hat JBo s s Develo p er Stud io 33 5 .1.2. Aus führen d er Q uic ks tarts mittels einer Befehls z eile 40 . .nhang A . . . . . .A. . .Bildschirmfot . . . . . . . . . . . .o. .Inst . . . allat . . . .ionsprogramm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 1. . . . . . . . . . A .1. Aus wahl d er Sp rac he 41 A .2. Die End nutz ervereinb arung 41 1 Handbuch z um Einst ieg A .2. Die End nutz ervereinb arung 41 A .3. Ins tallatio ns p fad 42 A .4. Aus wahl d er z u ins tallierend en Pakete 43 A .5. Ers tellen eines ad minis trativen Benutz ers A .6 . Q uic ks tart Ins tallatio n 44 45 A .7. Einric hten d es Maven-Rep o s ito ry A .8 . Einric hten vo n So c ket-Bind ing s A .9 . Server-Start A .10 . Ko nfig urieren vo n Pro to ko lleb enen A .11. Ko nfig urieren d er Laufz eitumg eb ung A .12. Üb erp rüfen d er Ins tallatio ns ko mp o nenten A .13. Ins tallatio ns fo rts c hritt A .14. Ins tallatio ns vo rg ang ab g es c hlo s s en A .15. Ers tellen vo n Sho rtc uts A .16 . G enerieren eines Ins tallatio ns s krip ts 46 47 48 49 50 51 52 53 54 55 . .nhang A . . . . . .B. . . Versionsgeschicht . . . . . . . . . . . . . . . . .e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 ........... 2 V orwort Vorwort 1. Dokument konvent ionen D ieses Handbuch verwendet mehrere Konventionen, um bestimmte Wörter und Sätze hervorzuheben und Aufmerksamkeit auf bestimmte Informationen zu lenken. 1.1. T ypografische Konvent ionen Es werden vier typografische Konventionen verwendet, um Aufmerksamkeit auf bestimmte Wörter und Sätze zu lenken. D iese Konventionen und ihre jeweiligen Anwendungsfälle sind Folgende: Ni chtpro po rti o nal Fett D ies wird verwendet, um Systemeingaben hervorzuheben, einschließ lich Shell-Befehle, D ateinamen und -pfade. Es wird ebenfalls zum Hervorheben von Tasten und Tastenkombinationen verwendet. Z um Beispiel: Um den Inhalt der D atei my_next_bestsel l i ng _no vel in Ihrem aktuellen Arbeitsverzeichnis zu sehen, geben Sie den Befehl cat my_next_bestsel l i ng _no vel in den Shell-Prompt ein und drücken Sie die Ei ng abetaste, um den Befehl auszuführen. D as oben aufgeführte Beispiel beinhaltet einen D ateinamen, einen Shell-Befehl und eine Taste. Alle werden nichtproportional fett dargestellt und können anhand des Kontextes einfach voneinander unterschieden werden. Tastenkombinationen unterscheiden sich von einzelnen Tasten durch das Pluszeichen, das die einzelnen Teile einer Tastenkombination miteinander verbindet. Z um Beispiel: D rücken Sie die Ei ng abetaste, um den Befehl auszuführen. D rücken Sie Strg +Al t+F2, um zu einem virtuellen Terminal zu wechseln. D as erste Beispiel hebt die zu drückende Taste hervor. D as zweite Beispiel hebt eine Tastenkombination hervor: eine Gruppe von drei Tasten, die gleichzeitig gedrückt werden müssen. Falls Quellcode behandelt wird, werden Klassennamen, Methoden, Funktionen, Variablennamen und Rückgabewerte, die innerhalb eines Abschnitts erwähnt werden, wie oben gezeigt ni chtpro po rti o nal fett dargestellt. Z um Beispiel: Z u dateiverwandten Klassen zählen fi l esystem für D ateisysteme, fi l e für D ateien und d i r für Verzeichnisse. Jede Klasse hat ihren eigenen Satz an Berechtigungen. Pro p o rt io n al Fet t D ies kennzeichnet Wörter oder Sätze, die auf einem System vorkommen, darunter Applikationsnamen, Text in D ialogfeldern, beschriftete Schaltflächen, Bezeichnungen für Auswahlkästchen und Optionsfelder sowie Überschriften von Menüs und Untermenüs. Z um Beispiel: Wählen Sie Syst em → Ein st ellu n g en → Mau s in der Hauptmenüleiste aus, um die Mau sein st ellu n g en zu öffnen. Klicken Sie auf dem Reiter T asten auf das Auswahlkästchen Mi t l i nks bed i ente Maus und anschließ end auf Schl i eßen, um die primäre Maustaste von der linken auf die rechte Seite zu ändern (d. h., um die Maus auf Linkshänder anzupassen). Um ein Sonderzeichen in eine g ed it -D atei einzufügen, wählen Sie An wen d u n g en 3 Handbuch z um Einst ieg → Z u b eh ö r → Z eich en t ab elle aus der Hauptmenüleiste. Wählen Sie als Nächstes Su ch en → Su ch en aus der Menüleiste der Z eich en t ab elle, geben Sie im Feld Suchbeg ri ff den Namen des Z eichens ein und klicken Sie auf Wei tersuchen. D as gesuchte Z eichen wird daraufhin in der Zei chentabel l e hervorgehoben. D oppelklicken Sie auf dieses hervorgehobene Z eichen, um es in das Feld Zu ko pi erend er T ext zu übernehmen und klicken Sie anschließ end auf die Schaltfläche Ko pi eren. Gehen Sie nun zurück in Ihr D okument und wählen Sie B earb eit en → Ein f ü g en aus der g ed it -Menüleiste. D er oben aufgeführte Text enthält Applikationsnamen, systemweite Menünamen und -elemente, applikationsspezifische Menünamen sowie Schaltflächen und Text innerhalb einer grafischen Oberfläche. Alle werden proportional fett dargestellt und sind anhand des Kontextes unterscheidbar. Nichtproportional Fett Kursiv oder Proportional Fett Kursiv Sowohl bei nichtproportional fett als auch bei proportional fett weist ein zusätzlicher Kursivdruck auf einen ersetzbaren oder variablen Text hin. Kursivdruck kennzeichnet Text, der nicht wörtlich eingeben wird, oder angezeigten Text, der sich abhängig von den gegebenen Umständen unterscheiden kann. Z um Beispiel: Um sich mit einem Remote-Rechner über SSH zu verbinden, geben Sie an einem Shell-Prompt ssh username@ domain.name ein. Falls der Remote-Rechner exampl e. co m ist und Ihr Benutzername auf diesem Rechner John lautet, geben Sie also ssh jo hn@ exampl e. co m ein. D er Befehl mo unt -o remo unt file-system hängt das angegebene D ateisystem wieder ein. Um beispielsweise das D ateisystem /ho me wieder einzuhängen, verwenden Sie den Befehl mo unt -o remo unt /ho me. Um die Version des derzeit installierten Pakets zu sehen, verwenden Sie den Befehl rpm -q package. D ie Ausgabe sieht wie folgt aus: package-version-release. Beachten Sie die kursiv dargestellten Begriffe oben – username, domain.name, file-system, package, version und release. Jedes Wort ist ein Platzhalter entweder für Text, den Sie für einen Befehl eingeben, oder für Text, der vom System angezeigt wird. Neben des üblichen Anwendungsfalls zur D arstellung des Titels eines Werks zeigt der Kursivdruck auch die erstmalige Verwendung eines neuen und wichtigen Begriffs an. Z um Beispiel: Publican ist ein DocBook Publishing-System. 1.2. Konvent ionen für Seit enansprachen Ausgaben des Terminals und Auszüge aus dem Quellcode werden visuell vom umliegenden Text hervorgehoben durch sogenannte Seitenansprachen (engl.: pull-quotes). Eine an das Terminal gesendete Ausgabe wird in den Schrifttyp ni chtpro po rti o nal R o man gesetzt und wie folgt dargestellt: books books_tests Desktop Desktop1 documentation drafts mss downloads images notes photos scripts stuff svgs svn Auszüge aus dem Quellcode werden ebenfalls in den Schrifttyp ni chtpro po rti o nal R o man gesetzt und es wird zusätzlich noch die Syntax hervorgehoben: static int kvm_vm_ioctl_deassign_device(struct kvm *kvm, struct kvm_assigned_pci_dev *assigned_dev) 4 V orwort { int r = 0; struct kvm_assigned_dev_kernel *match; mutex_lock(& kvm->lock); match = kvm_find_assigned_dev(& kvm->arch.assigned_dev_head, assigned_dev->assigned_dev_id); if (!match) { printk(KERN_INFO "%s: device hasn't been assigned before, " "so cannot be deassigned\n", __func__); r = -EINVAL; goto out; } kvm_deassign_device(kvm, match); kvm_free_assigned_device(kvm, match); out: mutex_unlock(& kvm->lock); return r; } 1.3. Anmerkungen und Warnungen Neben den verschiedenen Schrifttypen werden drei visuelle Stile verwendet, um die Aufmerksamkeit auf Informationen zu lenken, die andernfalls vielleicht übersehen werden könnten. Anmerkung Eine Anmerkung ist ein Tipp, ein abgekürztes Verfahren oder ein alternativer Ansatz für die vorliegende Aufgabe. D as Ignorieren von Anmerkungen hat in der Regel keine negativen Auswirkungen, aber Sie verpassen so vielleicht einen Trick, der Ihnen die Arbeit erleichtern könnte. Wichtig D ie Wichtig-Schaukästen lenken die Aufmerksamkeit auf D inge, die sonst leicht übersehen werden können: Konfigurationsänderungen, die nur für die aktuelle Sitzung gelten oder D ienste, für die ein Neustart nötig ist, bevor eine Aktualisierung wirksam wird. D as Ignorieren von Wichtig-Schaukästen würde keinen D atenverlust verursachen, kann aber unter Umständen zu Ärgernissen und Frustration führen. 5 Handbuch z um Einst ieg Warnung Eine Warnung sollte nicht ignoriert werden. D as Ignorieren von Warnungen führt mit hoher Wahrscheinlichkeit zu D atenverlust. 2. Hilfe und Feedback 2.1. Brauchen Sie Hilfe? Falls Sie Schwierigkeiten mit einer der in diesem Handbuch beschriebenen Prozeduren haben, besuchen Sie das Red Hat Kundenportal unter http://access.redhat.com. Im Kundenportal können Sie: eine Knowledgebase bestehend aus Artikeln rund um technischen Support für Red Hat Produkte durchsuchen oder durchstöbern. ein Supportticket bei Red Hat Global Support Services (GSS) einreichen. auf weitere Produktdokumentationen zugreifen. Red Hat unterhält auß erdem eine Vielzahl von Mailing-Listen zur D iskussion über Red Hat Software und Technologie. Eine Übersicht der öffentlich verfügbaren Listen finden Sie unter https://www.redhat.com/mailman/listinfo. Klicken Sie auf den Namen einer Liste für weitere Einzelheiten zum Abonnieren dieser Liste oder um auf deren Archiv zuzugreifen. 2.2. Wir freuen uns auf Ihr Feedback Wenn Sie einen Fehler in diesem Handbuch finden oder eine Idee haben, wie dieses verbessert werden könnte, freuen wir uns über Ihr Feedback. Reichen Sie einen Fehlerbericht in Bugzilla unter http://bugzilla.redhat.com/ für das Produkt JBoss Enterprise Application Platform ein. Vergewissern Sie sich beim Einreichen eines Fehlerberichts, dass Sie die Kennung des Handbuchs mit angeben: Getting_Started_Guide Falls Sie uns einen Vorschlag zur Verbesserung der D okumentation senden möchten, sollten Sie hierzu möglichst genaue Angaben machen. Wenn Sie einen Fehler gefunden haben, geben Sie bitte die Nummer des Abschnitts und einen Ausschnitt des Textes an, damit wir diesen leicht finden können. 6 Kapit el 1 . Einführung Kapitel 1. Einführung 1.1. Über die Red Hat JBoss Ent erprise Applicat ion Plat form 6 D ie Red Hat JBoss Enterprise Application Platform 6 (JBoss EAP 6) ist eine Middleware-Plattform, die auf offenen Standards basiert und mit der Java Enterprise Edition 6 Spezifikation konform ist. Sie integriert den JBoss Application Server 7 mit High Availability Clustering, Messaging, verteiltem Caching und anderen Technologien. D ie JBoss EAP 6 enthält eine neue, modulare Struktur, die es ermöglicht, D ienste erst bei Bedarf zu aktivieren und so den Systemstart zu beschleunigen. D ie Management-Konsole und das Management Command Line Interface machen das Bearbeiten von XML-Konfigurationsdateien überflüssig und ermöglichen die Verwendung von Skripten und die Automatisierung von Aufgaben. D es Weiteren beinhaltet die JBoss EAP 6 APIs und D evelopment Frameworks zur schnellen Entwicklung sicherer und skalierbarer Java EE Anwendungen. Fehler melden 1.2. Über das Red Hat Kundenport al D as Red Hat Kundenportal ist die zentralisierte Plattform für Ressourcen rund um Red Hat Wissen und Subskriptionen. Nutzen Sie das Red Hat Kundenportal für die folgenden Aufgaben: Verwaltung und Wartung von Red Hat Berechtigungen und Support-Verträgen Herunterladen offiziell unterstützter Software Z ugriff auf Produktdokumentation und die Red Hat Knowledgebase Kontakt zu Global Support Services Einreichen von Fehlermeldungen zu Red Hat Produkten D as Kundenportal ist hier verfügbar: https://access.redhat.com. Fehler melden 1.3. Über das Red Hat JBoss Developer Program D as Red Hat JBoss Developer Program („ das Programm“ ) erlaubt Ihnen die kostenlose Nutzung bestimmter Red Hat Subskriptionen zu Entwicklungszwecken. D ie im Rahmen dieses Programms zur Verfügung gestellten Red Hat Subskriptionen erhalten keinen Support und werden bei der Behebung bekannter Sicherheitslücken unter Umständen nicht berücksichtigt. Sie dürfen ausschließ lich zu Entwicklungszwecken verwendet werden und sind nicht geeignet für andere Z wecke wie z. B. den Einsatz in Produktionsumgebungen oder zum Z ugriff auf Aktualisierungen ohne aktive Red Hat Subskription. Einzelheiten über das Red Hat JBoss D eveloper Program finden Sie unter http://www.jboss.org/developer-program/termsandconditions. Fehler melden 1.4 . Über das Full Red Hat JBoss Commercial Program 7 Handbuch z um Einst ieg D as Full Red Hat JBoss Commercial Program erlaubt Ihnen die Bereitstellung in Produktionsumgebungen. Es bietet zusätzliche Berechtigungen für Software-Updates und -Patches, Support-Services und Z ugriff auf die Red Hat Knowledgebase. Um an diesem Programm teilzunehmen, müssen Sie einen Account im Kundenportal unter https://access.redhat.com/ einrichten. Weitere Informationen über dieses Programm finden Sie unter Abschnitt 1.2, »Über das Red Hat Kundenportal«. Fehler melden 1.5. Weit ere Informat ionen D er Z weck dieses Handbuchs besteht darin, Ihnen möglichst schnell zum Einsatz der Red Hat JBoss Enterprise Application Platform zu verhelfen. Falls Sie weiterführende Informationen wünschen, steht Ihnen die gesamte D okumentationsreihe für JBoss EAP im Kundenportal unter https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform zur Verfügung. Fehler melden 8 Kapit el 2 . Vorausset z ungen Kapitel 2. Voraussetzungen 2.1. JBoss EAP 6 Inst allat ionsvorausset z ungen Z u sammen f assu n g JBoss EAP steht unter dem Red Hat JBoss Developer Program oder dem Full Red Hat JBoss Commercial Program zur Verfügung. Weitere Informationen über das Red Hat JBoss Developer Program finden Sie unter Abschnitt 1.3, »Über das Red Hat JBoss D eveloper Program«. Weitere Informationen über das Full Red Hat JBoss Commercial Program finden Sie unter Abschnitt 1.4, »Über das Full Red Hat JBoss Commercial Program«. D ie folgenden Schritte beschreiben die Voraussetzungen für beide Programme. Allg emein e Vo rau sset z u n g en Überprüfen Sie die unterstützten Konfigurationen und vergewissern Sie sich, dass Ihr System unterstützt wird: https://access.redhat.com/site/articles/111663. Wenn Sie einen Account beim Red Hat Kundenportal einrichten und am Full Red Hat JBoss Commercial Program teilnehmen, vergewissern Sie sich, dass auf Ihrem System alle aktuellen Updates und Errata von Red Hat angewendet sind. Z IP- /In st aller- Vo rau sset z u n g en Sie müssen Administratorberechtigungen für das Installationsverzeichnis gewähren. Vergewissern Sie sich, dass das gewählte JD K extrahiert (oder installiert wurde). Informationen dazu finden Sie in der JD K-D okumentation. Beim Microsoft Windows Server vergewissern Sie sich, dass die Umgebungsvariablen JAVA_HOME und PATH eingestellt sind, da Tastenkürzel sonst nicht funktionieren. Bei Hewlett-Packard HP-UX stellen Sie bitte sicher, dass das unzi p-D ienstprogramm installiert ist. Fehler melden 9 Handbuch z um Einst ieg Kapitel 3. Download und Installation des Produkts 3.1. JBoss EAP Inst allat ionsübersicht D ieses Handbuch bietet eine Anleitung zum einfachsten Installationsprozess für den schnellstmöglichen Einstieg in die JBoss. Informationen zu den kompletten Installationsprozeduren finden Sie im Installationshandbuch für die JBoss EAP. Nachdem Sie JBoss EAP installiert haben, können Sie den Server mittels des Management-CLI oder der Management-Konsole konfigurieren. Informationen zur Konfiguration der JBoss EAP finden Sie im Administrations- und Konfigurationshandbuch für die JBoss EAP. Beide Handbücher sind im Kundenportal verfügbar unter https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/. Sie können JBoss EAP auf eine der folgenden Arten installieren. Installation der JBoss EAP 6 mit dem grafischen Installationsprogramm. Installation der JBoss EAP 6 mit der Z IP-D atei. Folgen Sie den Anweisungen zu Ihrer bevorzugten Installationsmethode. Fehler melden 3.2. Download und Inst allat ion der JBoss EAP mit dem grafischen Inst allat ionsprogramm 3.2.1. Herunt erladen des JBoss EAP 6 Inst allat ionsprogramms Z u sammen f assu n g D ie JBoss EAP steht unter dem Red Hat JBoss Developer Program oder dem Full Red Hat JBoss Commercial Program zur Verfügung. Folgen Sie den nachstehenden Schritten je nach gewähltem Programm. Pro z ed u r 3.1. H eru n t erlad en d es JB o ss EAP In st allat io n sp ro g ramms vo m K u n d en p o rt al u n t er d em „Fu ll R ed H at JB o ss C o mmercial Pro g ram“ Folgen Sie diesen Schritten, wenn Sie an dem „ Full Red Hat JBoss Commercial Program“ teilnehmen. Informationen über dieses Programm finden Sie unter Abschnitt 1.4, »Über das Full Red Hat JBoss Commercial Program«. 1. Öffnen Sie einen Browser und melden Sie sich beim Kundenportal unter https://access.redhat.com an. 2. Klicken Sie auf D o wn lo ad s. 3. Klicken Sie in der Liste P ro d ukt-D o wnl o ad s auf R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm. 4. Wählen Sie die korrekte JBoss EAP Version aus der Versi o n-Auswahlliste. 5. Suchen Sie R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x Instal l er in der Liste und klicken Sie auf die D o wnl o ad -Option. 6. Sie werden dazu aufgefordert, die JAR-D atei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis, und speichern Sie die D atei. 10 Kapit el 3. Download und Inst allat ion des Produkt s Pro z ed u r 3.2. H eru n t erlad en d es JB o ss EAP In st allat io n sp ro g ramms vo n jb o ss.o rg u n t er d em „R ed H at JB o ss D evelo p er Pro g ram“ Folgen Sie diesen Schritten, wenn Sie an dem „ Red Hat JBoss D eveloper Program“ teilnehmen. Informationen über dieses Programm finden Sie unter Abschnitt 1.3, »Über das Red Hat JBoss D eveloper Program«. 1. Öffnen Sie einen Browser und geben Sie diese URL ein: http://www.jboss.org/products/eap. A. Um das Installationsprogramm für die aktuelle GA-Version des Produkts herunterzuladen, klicken Sie auf die Schaltfläche D o wnl o ad rechts auf der Seite. B. Folgen Sie diesen Schritten, um eine alternative Version auszuwählen, darunter die neuesten Alpha- oder Beta-Releases, sowie ältere Versionen des Produkts. a. Klicken Sie auf den Link D o wnl o ad JBo ss EAP links auf der Seite. b. Klicken Sie in der D o wnl o ad -Spalte auf den Link Instal l er für die richtige Produktversion. 2. Sie werden dazu aufgefordert, die JAR-D atei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis, und speichern Sie die D atei. Erg eb n is D ie JAR-D atei für das JBoss EAP 6 Installationsprogramm wurde erfolgreich auf den Z ielrechner heruntergeladen. Fehler melden 3.2.2. Ausführen des JBoss EAP Inst allat ionsprogramms D as JBoss EAP Installationsprogramm kann entweder im grafischen oder im textbasierten Modus ausgeführt werden. D ieses Thema behandelt den Befehl, der zur Ausführung des Installationsprogramms im grafischen Modus notwendig ist. Wenn Sie sich bei einer Option unsicher sind, wählen Sie einfach die Standardoption. Sie können die Konfiguration des Servers zu einem späteren Z eitpunkt einfach ändern. Weitere Informationen über die Konfiguration des JBoss EAP Servers finden Sie im Administration and Configuration Guide für die Red Hat JBoss Enterprise Application Platform 6, verfügbar im Kundenportal unter https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/. Pro z ed u r 3.3. Au sf ü h ren d es JB o ss EAP In st allat io n sp ro g ramms 1. Öffnen Sie ein Terminal und navigieren Sie zu dem Verzeichnis, welches das heruntergeladene Installationsprogramm-JAR enthält. 2. Geben Sie den folgenden Befehl ein: java -jar jboss-eap-6.x.x-installer.jar 3. Folgen Sie den Anweisungen in der nachstehenden Tabelle. T ab elle 3.1. B ild sch irme d es JB o ss EAP In st allat io n sp ro g ramms 11 Handbuch z um Einst ieg B ild sch irmn ame Wan n an g ez eig t B esch reib u n g Abschnitt A.1, »Auswahl der Sprache« Abschnitt A.2, »D ie Endnutzervereinbarun g« Immer Wählen Sie die gewünschte Sprache für das Installationsprogramm und klicken Sie auf O K. Immer D ie Endnutzervereinbarung für Red Hat JBoss Middleware. Abschnitt A.3, »Installationspfad« Immer Abschnitt A.4, »Auswahl der zu installierenden Pakete« Abschnitt A.5, »Erstellen eines administrativen Benutzers« Abschnitt A.6, »Quickstart Installation« Immer Abschnitt A.7, »Einrichten des Maven-Repository« Falls Sie die Quickstart-Beispiele installieren möchten Abschnitt A.8, »Einrichten von Socket-Bindings« Abschnitt A.9, »ServerStart« Immer Abschnitt A.10, »Konfigurieren von Protokollebenen« Abschnitt A.11, »Konfigurieren der Laufzeitumgebung« Abschnitt A.12, »Überprüfen der Installationskomponen ten« Abschnitt A.13, »Installationsfortschritt « Immer 12 Wählen Sie „ I accept the terms of this license agreement“ und klicken Sie auf Next. Wählen Sie den Installationspfad für JBoss EAP und klicken Sie auf Next. Sie werden dazu aufgefordert, das neue Verzeichnis anzulegen, oder, falls es bereits existiert, das genannte Verzeichnis zu ersetzen. Wählen Sie die zu installierenden Pakete. Erforderliche Pakete können nicht abgewählt werden. Immer Erstellen Sie einen administrativen Benutzer und weisen Sie ein Passwort zu. Klicken Sie anschließ end auf Next. Immer Installieren Sie die Quickstart-Beispiele. Klicken Sie auf Y es und wählen Sie einen Installationspfad. Klicken Sie anschließ end auf Next. Belassen Sie die Standardeinstellungen, um automatisch die standardmäß igen MavenEinstellungen zu konfigurieren und das öffentlich gehostete Maven-Repository zu verwenden. Klicken Sie anschließ end auf Next. Belassen Sie die standardmäß igen Port Bindings und klicken Sie anschließ end auf Next. Wählen Sie die bevorzugte Startoption, die nach Abschluss des Installationsvorgangs angewendet werden soll. Klicken Sie anschließ end auf Next. Klicken Sie auf No , um die Konfiguration von Protokollebenen zu überspringen. Klicken Sie anschließ end auf Next. Wählen Sie P erfo rm d efaul t co nfi g urati o n und klicken Sie auf Next, um fortzufahren. Überprüfen Sie Ihre Auswahl und klicken Sie auf Next. Immer Immer Immer Immer Sobald der Installationsvorgang abgeschlossen ist, klicken Sie auf Next. Kapit el 3. Download und Inst allat ion des Produkt s B ild sch irmn ame Wan n an g ez eig t B esch reib u n g Abschnitt A.14, »Installationsvorgang abgeschlossen« Abschnitt A.15, »Erstellen von Shortcuts« Abschnitt A.16, »Generieren eines Installationsskripts« Immer Wenn der Vorgang abgeschlossen ist, klicken Sie auf Next. Immer Belassen Sie die Standardeinstellungen und klicken Sie auf Next. Immer Klicken Sie auf D o ne. D ie Installation ist nun abgeschlossen. Erg eb n is D ie Installation ist beendet und JBoss EAP 6 ist auf Ihrem Z ielrechner installiert. Fehler melden 3.3. Download und Inst allat ion der JBoss EAP mit der ZIP-Dat ei. 3.3.1. Herunt erladen von JBoss EAP 6 (ZIP-Inst allat ion) Z u sammen f assu n g JBoss EAP steht unter dem Red Hat JBoss Developer Program oder dem Full Red Hat JBoss Commercial Program zur Verfügung. Folgen Sie den nachstehenden Schritten je nach gewähltem Programm. Pro z ed u r 3.4 . Lad en Sie vo m K u n d en p o rt al d ie Z IP- D at ei u n t er d em „Fu ll R ed H at JB o ss C o mmercial Pro g ram“ h eru n t er Folgen Sie diesen Schritten, wenn Sie an dem „ Full Red Hat JBoss Commercial Program“ teilnehmen. Informationen über dieses Programm finden Sie unter Abschnitt 1.4, »Über das Full Red Hat JBoss Commercial Program«. 1. Öffnen Sie einen Browser und melden Sie sich beim Red Hat Kundenportal unter https://access.redhat.com an. 2. Klicken Sie auf D o wn lo ad s. 3. Klicken Sie in der Liste P ro d ukt-D o wnl o ad s auf R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm. 4. Wählen Sie die korrekte JBoss EAP Version aus der Versi o n-Auswahlliste. 5. Suchen Sie R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x in der Liste und klicken Sie auf die D o wnl o ad -Option. 6. Sie werden dazu aufgefordert, die Z IP-D atei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die D atei. Pro z ed u r 3.5. Lad en Sie d ie Z IP- D at ei vo n jb o ss.o rg u n t er d em R ed H at JB o ss D evelo p er Pro g ram h eru n t er. 13 Handbuch z um Einst ieg Folgen Sie diesen Schritten, wenn Sie an dem „ Red Hat JBoss D eveloper Program“ teilnehmen. Informationen über dieses Programm finden Sie unter Abschnitt 1.3, »Über das Red Hat JBoss D eveloper Program«. 1. Öffnen Sie einen Webbrowser und geben Sie diese URL ein: http://www.jboss.org/products/eap/ 2. Klicken Sie auf den Link D o wnl o ad JBo ss EAP links auf der Seite. 3. Klicken Sie in der D o wnl o ad -Spalte auf den Link ZIP für die richtige Produktversion. 4. Sie werden dazu aufgefordert, die Z IP-D atei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die D atei. Erg eb n is D ie JBoss EAP 6 Z IP-D atei wurde erfolgreich auf den Z ielrechner heruntergeladen. Fehler melden 3.3.2. Inst allieren der JBoss EAP 6 (ZIP-Inst allat ion) Z u sammen f assu n g D ieses Thema behandelt die Installationsschritte der JBoss EAP 6 unter Verwendung der heruntergeladenen Z IP-D atei. Pro z ed u r 3.6 . Z IP- D at eiin st allat io n 1. Versch ieb en Sie d as Z IP- Arch iv an d en g ewü n sch t en Sp eich ero rt . Verschieben Sie die Z IP-D atei auf den Server und in das Verzeichnis, in dem Sie die JBoss EAP 6 installieren möchten. D er Benutzer, der den Server startet und stoppt, benötigt Leseund Schreibzugriff auf das Verzeichnis. 2. Verwen d en Sie ein e g eeig n et e Ap p likat io n z u r Ext rakt io n d es Z IP- Arch ivs in d en g ewü n sch t en Sp eich ero rt . In einer Red Hat Enterprise Linux Umgebung verwenden Sie das unzi p-D ienstprogramm, um die Inhalte des Z IP-Archivs zu extrahieren. In einer Microsoft Windows Umgebung rechts-klicken Sie auf die D atei und wählen Sie Extract Al l . In einer Hewlett-Packard HP-UX Umgebung verwenden Sie das unzi p-D ienstprogramm, um die Inhalte des Z IP-Archivs zu extrahieren. Erg eb n is D ie JBoss EAP 6 wurde erfolgreich installiert. D as durch Extraktion des Z IP-Archivs erstellte Verzeichnis ist das Verzeichnis der obersten Ebene für den Server. D ies ist EAP_HOME. Fehler melden 3.4 . Download der Quickst art Code-Beispiele 14 Kapit el 3. Download und Inst allat ion des Produkt s 3.4 .1. Die Quickst art s herunt erladen Z u sammen f assu n g D ie JBoss EAP 6 kommt mit einem umfassenden Satz an Quickstart-Codebeispielen, die Benutzern beim Schreiben von Applikationen mittels der Java EE 6 Technologien helfen sollen. Falls Sie bei der Installation der JBoss EAP die Installation der Quickstart-Beispiele gewählt haben, so können Sie dieses Kapitel überspringen. Andernfalls können Sie sie jetzt unter dem Red Hat JBoss Developer Program oder dem Full Red Hat JBoss Commercial Program herunterladen. Befolgen Sie nachfolgend die Vorgehensweise, die Ihrer Programmauswahl entspricht. Pro z ed u r 3.7. Lad en Sie d ie Q u ickst art s u n t er d em Fu ll R ed H at JB o ss C o mmercial Pro g ram h eru n t er Folgen Sie diesen Schritten, wenn Sie an dem „ Full Red Hat JBoss Commercial Program“ teilnehmen. Informationen über dieses Programm finden Sie unter Abschnitt 1.4, »Über das Full Red Hat JBoss Commercial Program«. 1. Öffnen Sie einen Browser und melden Sie sich beim Red Hat Kundenportal unter https://access.redhat.com an. 2. Klicken Sie auf D o wn lo ad s. 3. Klicken Sie in der Liste P ro d ukt-D o wnl o ad s auf R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm. 4. Wählen Sie die korrekte JBoss EAP Version aus der Versi o n-Auswahlliste. 5. Suchen Sie R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x Q ui ckstarts in der Liste und klicken Sie auf die D o wnl o ad -Option. 6. Sie werden dazu aufgefordert, die Z IP-D atei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die D atei. 7. Entpacken Sie das Archiv im Verzeichnis Ihrer Wahl. Pro z ed u r 3.8. Lad en Sie d ie Q u ickst art s u n t er d em R ed H at JB o ss D evelo p er Pro g ram h eru n t er Folgen Sie diesen Schritten, wenn Sie an dem „ Red Hat JBoss D eveloper Program“ teilnehmen. Informationen über dieses Programm finden Sie unter Abschnitt 1.3, »Über das Red Hat JBoss D eveloper Program«. 1. Öffnen Sie einen Webbrowser und geben Sie diese URL ein: http://www.jboss.org/products/eap/ 2. Klicken Sie auf das Link JBo ss EAP herunterl ad en links auf der Seite, um Informationen zum Produkt-D ownload anzuzeigen. 3. Klicken Sie unter D o wnl o ad JBo ss EAP auf das Q ui ckstarts-Link, um ein Z IP-Archiv mit Beispielen herunterzuladen. 4. Sie werden dazu aufgefordert, die Z IP-D atei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die D atei. 5. Entpacken Sie das Archiv im Verzeichnis Ihrer Wahl. Fehler melden 15 Handbuch z um Einst ieg Kapitel 4. Anweisungen nach der Installation 4 .1. Einricht en der Ent wicklungsumgebung 4 .1.1. Übersicht der Red Hat JBoss Developer St udio Inst allat ion D ieses Handbuch bietet eine Anleitung zum einfachsten Installationspfad für Red Hat JBoss D eveloper Studio. D ie vollständige Installationsprozedur finden Sie im Installationshandbuch für Red Hat JBoss D eveloper Studio auf https://access.redhat.com/site/documentation/enUS/Red_Hat_JBoss_D eveloper_Studio/. Fehler melden 4 .1.2. Herunt erladen des Red Hat JBoss Developer St udio 1. Gehen Sie zur Seite https://www.jboss.org/products/devstudio.html. 2. Klicken Sie auf die D o wnl o ad -Schaltfläche. Sie werden dazu aufgefordert, die Z IP-D atei in ein Verzeichnis Ihrer Wahl zu speichern. Fehler melden 4 .1.3. Inst allieren des Red Hat JBoss Developer St udio 1. Öffnen Sie ein Terminal und navigieren Sie zu dem Verzeichnis, das die . jar-D atei enthält. 2. Führen Sie den folgenden Befehl aus, um das grafische Installationsprogramm zu starten: java -jar jbdevstudio-build_version.jar Anmerkung Alternativ können Sie auf die . jar-D atei doppelklicken, um das Installationsprogramm zu starten. 3. Klicken Sie auf Next, um den Installationsvorgang zu starten. 4. Wählen Sie I accept the terms o f thi s l i cense ag reement und klicken Sie auf Next. 5. Passen Sie den Installationspfad an und klicken Sie auf Next. Anmerkung Falls das Verzeichnis auf dem Installationspfad nicht existiert, erscheint ein D ialogfeld. Klicken Sie auf O k, um das Verzeichnis zu erstellen. 6. Wählen Sie eine JVM oder lassen Sie die standardmäß ige JVM ausgewählt und klicken Sie anschließ end auf Next. 16 Kapit el 4 . Anweisungen nach der Inst allat ion 7. Red Hat JBoss D eveloper Studio umfasst die Red Hat JBoss Enterprise Application Platform. Falls diese bereits installiert ist, wählen Sie No . Wählen Sie andernfalls Y es, um sie zu installieren und zur Verwendung mit Red Hat JBoss D eveloper Studio zu konfigurieren. 8. Überprüfen Sie die Installationsdetails und klicken Sie auf Next. 9. Klicken Sie auf Next, sobald der Installationsvorgang abgeschlossen ist. 10. Konfigurieren Sie die D esktop-Verknüpfungen für Red Hat JBoss D eveloper Studio und klicken Sie auf Next. 11. Klicken Sie auf D o ne. Fehler melden 4 .1.4 . St art en des Red Hat JBoss Developer St udio D oppelklicken Sie auf die D esktop-Verknüpfung, die Sie während der Installation angelegt haben, oder verwenden Sie die Befehlszeile, um Red Hat JBoss D eveloper Studio zu starten. D ieser Abschnitt beschreibt das Starten von Red Hat JBoss D eveloper Studio mithilfe der Befehlszeile. Pro z ed u r 4 .1. B ef eh l z u m St art en vo n R ed H at JB o ss D evelo p er St u d io 1. Öffnen Sie ein Terminal und wechseln Sie in das Red Hat JBoss D eveloper Studio Installationsverzeichnis. 2. Führen Sie den folgenden Befehl aus, um Red Hat JBoss D eveloper Studio zu starten: Für Linux: [localhost]$ ./jbdevstudio Für Microsoft Windows: C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat Fehler melden 4 .1.5. Den JBoss EAP Server mit t els Define New Server hinz ufügen D iese Anleitung geht davon aus, dass dies Ihre erste Einführung in das Red Hat JBoss D eveloper Studio ist und Sie noch keinen Red Hat JBoss Enterprise Application Platform Server hinzugefügt haben. D ie nachfolgende Prozedur fügt den JBoss EAP Server mittels D efi ne New ServerAssistent hinzu. Pro z ed u r 4 .2. D en Server h in z u f ü g en 1. Öffnen Sie den Servers-Reiter. Ist kein Servers-Reiter vorhanden, so fügen Sie diesen wie folgt dem Panel hinzu: a. Klicken Sie auf Win d o w → Sh o w View → O t h er.... b. Wählen Sie Servers aus dem Server-Ordner und klicken Sie auf O K. 2. Klicken Sie auf No servers are avai l abl e. C l i ck thi s l i nk to create a new server. . . oder klicken Sie - falls Ihnen dies lieber ist - in das leere Server-Panel und wählen Sie N ew → Server. 17 Handbuch z um Einst ieg Ab b ild u n g 4 .1. N eu en Server h in z u f ü g en - K ein e Server verf ü g b ar 3. Klappen Sie JBo ss Enterpri se Mi d d l eware aus und wählen Sie JB o ss En t erp rise Ap p licat io n Plat f o rm 6 .1+ . Geben Sie einen Servernamen ein, zum Beispiel " JBoss Enterprise Application Platform 6.4" , klicken Sie dann auf Next, um die JBoss-Runtime zu erstellen und den Server zu definieren. Wenn Sie das nächste Mal einen neuen Server definieren, so zeigt dieser D ialog eine Server runti me envi ro nment-Auswahl mit der neuen Runtime-D efinition an. 18 Kapit el 4 . Anweisungen nach der Inst allat ion Ab b ild u n g 4 .2. Ein en n eu en Server d ef in ieren 4. Erstellen Sie einen Server-Adapter, um das Starten und das Stoppen des Servers zu verwalten. Behalten Sie die Standardeinstellungen und klicken Sie auf Next. 19 Handbuch z um Einst ieg Ab b ild u n g 4 .3. N eu en Server- Ad ap t er erst ellen 5. Geben Sie einen Namen, zum Beispiel " JBoss EAP 6.4 Runtime" ein. Klicken Sie unter Ho me D i recto ry auf Bro wse und navigieren Sie zum Speicherort Ihrer JBoss EAP Installation. Klicken Sie dann auf Next. 20 Kapit el 4 . Anweisungen nach der Inst allat ion Ab b ild u n g 4 .4 . H in z u f ü g en ein er n eu en Server R u n t ime U mg eb u n g Anmerkung Einige Quickstarts machen es erforderlich, dass Sie den Server mit einem anderen Profil oder zusätzlichen Argumenten ausführen. Um einen Quickstart bereitzustellen, der das ful l Profil benötigt, müssen Sie einen neuen Server definieren und eine Server R unti me Envi ro nment definieren, die stand al o ne-ful l . xml für die C o nfi g urati o n fi l e festlegt. Stellen Sie auß erdem sicher, dass Sie dem Server einen neuen deskriptiven Namen geben. 21 Handbuch z um Einst ieg 6. Konfigurieren Sie bestehende Projekte für den neuen Server. D a Sie an diesem Punkt keine Projekte haben, klicken Sie auf Fi ni sh. Ab b ild u n g 4 .5. B earb eit en Sie d ie R esso u rcen f ü r d en n eu en JB o ss Server Erg eb n is D er JBoss EAP Runtime Server ist im Servers-Reiter gelistet. 22 Kapit el 4 . Anweisungen nach der Inst allat ion Ab b ild u n g 4 .6 . Server ersch ein t in d er Serverlist e Fehler melden 4 .2. Konfigurieren Sie Maven 4 .2.1. Über Maven Apache Maven ist ein distribuiertes Automatisierungstool bei der Entwicklung von JavaApplikationen zum Erstellen, Verwalten und den Build von Software-Projekten. Maven verwendet Standardkonfigurationsdateien namens Project Object Model oder POM, D ateien die den BuildProzess definieren und verwalten. POMs beschreiben die Modul- und Komponentenabhängigkeiten, Build-Reihenfolge sowie die Z iele für das resultierende Projekt-Packaging und die Ausgabe unter Verwendung einer XML-datei. D ies stellt den korrekten und einheitlichen Build des Projekts sicher. Maven erreicht dies mittels eines Repository. Ein Maven Repository speichert Java-Bibliotheken, Plug-ins und andere Build-Artifakte. D as standardmäß ige öffentliche Repository ist das Maven 2 Central Repository, aber Repositories können innerhalb eines Unternehmens privat und intern sein, wobei gemeinsame Artifakte unter den Entwicklungsteams geteilt werden. Repositories sind auch von D rittanbietern verfügbar. D ie JBoss EAP beinhaltet ein Maven-Repository, das viele der Anforderungen umfasst, die Java EE Entwickler in der Regel für den Build von Applikationen auf der JBoss EAP verwenden. Weitere Informationen zu Maven finden Sie unter Welcome to Apache Maven. Weitere Informationen zu Maven Repositories finden Sie unter Apache Maven Project - Einführung in Repositories. Weitere Informationen zur Verwendung von Maven in der JBoss EAP finden Sie im Maven Guide im Development Guide für die Red Hat JBoss Enterprise Application Platform im Kundenportal unter https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/. Fehler melden 4 .2.2. Konfigurieren der Maven-Einst ellungen D ie für den Build und das D eployment von Applikationen auf der JBoss EAP 6 erforderlichen Artifakte und Abhängigkeiten werden auf einem öffentlichen Repository gehostet. Sie müssen Maven beim Build Ihrer Applikationen zur Verwendung dieses Repository anweisen. Wie Sie dies tun hängt davon ab, ob Sie vorhaben Red Hat JBoss D eveloper Studio oder die Maven-Befehlszeile für den Build und das D eployment Ihrer Applikationen zu verwenden. Red Hat JBoss D eveloper Studio beinhaltet Maven, es muss daher nicht separat heruntergeladen und installiert werden. Falls Sie planen Red Hat JBoss D eveloper Studio für den Build und das 23 Handbuch z um Einst ieg D eployment Ihrer Applikationen zu verwenden, folgen Sie den hier aufgeführten Anweisungen zur Konfiguration der Maven-Einstellungen: Abschnitt 4.2.3.1, »Konfigurieren von Maven zur Verwendung mit Red Hat JBoss D eveloper Studio« Falls Sie die Maven-Befehlszeile für den Build und das D eployment Ihrer Applikationen verwenden wollen, so müssen Sie Maven erst herunterladen und installieren. D ie Anweisungen dazu finden Sie hier: Abschnitt 4.2.4.1, »D ownload und Installation von Maven«. Anschließ end befolgen Sie diese zur Konfiguration der Maven-Einstellungen: Abschnitt 4.2.4.2, »Konfigurieren der MavenEinstellungen zur Verwendung mit Befehlszeile« Fehler melden 4 .2.3. Konfigurieren Sie Maven z ur Verwendung mit Red Hat JBoss Developer St udio 4 .2 .3.1 . Ko nfigurie re n vo n Mave n zur Ve rwe ndung m it Re d Hat JBo ss De ve lo pe r St udio D ie für den Build und das D eployment von Applikationen auf der Red Hat JBoss Enterprise Application Platform erforderlichen Artifakte und Abhängigkeiten werden auf einem öffentlichen Repository gehostet. Sie müssen Maven beim Build Ihrer Applikationen zur Verwendung dieses Repository anweisen. D ieses Thema behandelt die notwendigen Schritte zur Konfiguration von Maven, wenn Sie Red Hat JBoss D eveloper Studio für den Build und das D eployment Ihrer Applikationen verwenden wollen. Falls Sie die Maven-Befehlszeile für den Build und das D eployment Ihrer Applikationen verwenden wollen, so können Sie dieses Thema überspringen. Folgen Sie stattdessen den Anweisungen hier: Abschnitt 4.2.4.2, »Konfigurieren der Maven-Einstellungen zur Verwendung mit Befehlszeile«. Maven wird mit Red Hat JBoss D eveloper Studio distribuiert, daher ist es nicht notwendig, es separat zu installieren. Sie müssen Maven jedoch zur Verwendung durch den Java EE Web Project Assistenten für D eployments zu JBoss EAP konfigurieren. D ie nachfolgende Prozedur demonstriert, wie Maven für die Verwendung mit JBoss EAP konfiguriert wird, indem die Maven-Konfigurationsdatei von innerhalb Red Hat JBoss D eveloper Studio bearbeitet wird. Pro z ed u r 4 .3. K o n f ig u rieren vo n Maven in R ed H at JB o ss D evelo p er St u d io 1. Klicken Sie auf Win d o w→Pref eren ces, klappen Sie JBo ss T o o l s aus und wählen Sie JBo ss Maven Integ rati o n. 24 Kapit el 4 . Anweisungen nach der Inst allat ion Ab b ild u n g 4 .7. JB o ss Maven In t eg rat io n sp an el im B ild sch irm Pref eren ces 2. Klicken Sie auf C o nfi g ure Maven R epo si to ri es. 3. Klicken Sie auf Ad d R epo si to ry zur Konfiguration der JBoss GA Tech Vorschau des Maven Repository. Vervollständigen Sie den Ad d Maven R epo si to ry-D ialog wie folgt: a. Stellen Sie die P ro fi l e ID -, die R epo si to ry ID - und die R epo si to ry NameWerte auf jbo ss-g a-repo si to ry ein. b. Stellen Sie den R epo si to ry UR L-Wert auf http: //maven. repo si to ry. red hat. co m/techprevi ew/al l ein. c. Klicken Sie auf das Acti ve by d efaul t-Kästchen, um das Maven-Repository zu aktivieren. d. Klicken Sie O K 25 Handbuch z um Einst ieg Ab b ild u n g 4 .8. H in z u f ü g en vo n Maven R ep o sit o ry - JB o ss T ech - Vo rsch au 4. Klicken Sie auf Ad d R epo si to ry, um das JBoss Early Access Maven Repository zu konfigurieren. Vervollständigen Sie den Ad d Maven R epo si to ry-D ialog wie folgt: a. Stellen Sie die P ro fi l e ID -, die R epo si to ry ID - und die R epo si to ry NameWerte auf jbo ss-earl yaccess-repo si to ry ein. b. Stellen Sie den R epo si to ry UR L-Wert auf http: //maven. repo si to ry. red hat. co m/earl yaccess/al l / ein. c. Klicken Sie auf das Acti ve by d efaul t-Kästchen, um das Maven-Repository zu aktivieren. d. Klicken Sie O K 26 Kapit el 4 . Anweisungen nach der Inst allat ion Ab b ild u n g 4 .9 . H in z u f ü g en vo n Maven R ep o sit o ry - JB o ss Early Access 5. Überprüfen Sie die Repositories und klicken Sie Fi ni sh. 27 Handbuch z um Einst ieg Ab b ild u n g 4 .10. Ü b erp rü f en d er Maven R ep o sit o ries 6. Es erscheint eine Eingabeaufforderung mit der Nachricht " Are you sure you want to update the file 'MAVEN_HOME/settings.xml'?" . Klicken Sie Y es, um die Einstellungen zu aktualisieren. Klicken Sie O K, um den D ialog zu schließ en. D as JBoss EAP Maven Repository ist jetzt für die Verwendung mit Red Hat JBoss D eveloper Studio konfiguriert. Fehler melden 4 .2.4 . Konfigurieren Sie Maven z ur Verwendung mit Befehlsz eile 4 .2 .4 .1 . Do wnlo ad und Inst allat io n vo n Mave n Falls Sie die Maven-Befehlszeile für den Build und das D eployment von Applikationen auf die JBoss EAP verwenden wollen, so müssen Sie Maven erst herunterladen und installieren. Falls Sie planen, Red Hat JBoss D eveloper Studio für den Build und das D eployment Ihrer Applikationen zu verwenden, sokönnen Sie diese Prozedur überspringen, da Maven mit Red Hat JBoss D eveloper Studio geliefert wird. 28 Kapit el 4 . Anweisungen nach der Inst allat ion 1. Gehen Sie auf Apache Maven Project - D ownload Maven und laden Sie sich die aktuellste D istribution für Ihr Betriebssystem herunter. 2. D ie Maven-D okumentation liefert Informationen dazu, wie Apache Maven für Ihr Betriebssystem heruntergeladen und installiert wird. Fehler melden 4 .2 .4 .2 . Ko nfigurie re n de r Mave n-Einst e llunge n zur Ve rwe ndung m it Be fe hlsze ile D ie für den Build und das D eployment von Applikationen auf der JBoss EAP 6 erforderlichen Artifakte und Abhängigkeiten werden auf einem öffentlichen Repository gehostet. Falls Sie vorhaben, Red Hat JBoss D eveloper Studio für den Build und das D eployment Ihrer Applikationen zu verwenden, können Sie dieses Thema überspringen. Befolgen Sie stattdessen die Anweisungen hier: Abschnitt 4.2.3.1, »Konfigurieren von Maven zur Verwendung mit Red Hat JBoss D eveloper Studio«. Wenn Sie jedoch die Maven-Befehlszeile verwenden wollen, so müssen Sie Maven mittels der MavenEinstellungen anweisen, das JBoss EAP 6 Maven Repository über Ihre Projekte hinweg zu verwenden. D ie Konfiguration der Einstellungen zur Verwendung mit Maven-Befehlszeile kann auf zwei Arten erfolgen. Sie können die vorkonfigurierte setti ng s. xml -D atei kopieren, die mit den Quickstarts geliefert wird. Sie können die Maven setti ng s. xml -D atei manuell bearbeiten. D ieses Thema beschreibt beide Methoden. Falls Sie die Quickstarts heruntergeladen haben, so ist die erste Vorgehensweise der einfachste Weg, die Einstellungen zu konfigurieren. Vo rau sset z u n g en Sie müssen Maven installieren, ehe Sie die Einstellungen konfigurieren. Weitere Informationen finden Sie unter: Abschnitt 4.2.4.1, »D ownload und Installation von Maven« Pro z ed u r 4 .4 . K o n f ig u rieren vo n Maven u n t er Verwen d u n g d er mit d en Q u ickst art B eisp ielen g elief ert en Ein st ellu n g en D ie Red Hat JBoss Enterprise Application Platform Quickstarts werden mit einer setti ng s. xml D atei geliefert, die für die Verwendung des online JBoss EAP Maven Repository konfiguriert ist. Falls Sie die Quickstarts heruntergeladen haben, so ist dies die einfachste Weise, die Einstellungen zu konfigurieren. 1. D ieses Verfahren überschreibt die vorhandene D atei mit Maven-Einstellungen, Sie müssen also eine Sicherungskopie der vorhandenen Maven setti ng s. xml -D atei erstellen. a. Finden Sie das Maven-Installationsverzeichnis für Ihr Betriebssystem. Es ist in der Regel im USER_HOME/. m2/-Verzeichnis installiert. Für Linux oder Mac ist dies: ~ /. m2/ Für Windows ist dies: \D o cuments and Setti ng s\USER_NAME\. m2\ oder \Users\USER_NAME\. m2\ b. Falls Sie eine vorhandene USER_HOME/. m2/setti ng s. xml -D atei besitzen, benennen Sie diese um oder erstellen Sie eine Sicherungskopie, damit Sie diese später wiederherstellen können. 29 Handbuch z um Einst ieg 2. Falls Sie die Quickstarts noch nicht heruntergeladen haben, befolgen Sie die Anweisungen hier: Abschnitt 3.4.1, »D ie Quickstarts herunterladen«. 3. Kopieren Sie die QUICKSTART_HOME/setti ng s. xml -D atei in das USER_HOME/. m2/Verzeichnis. 4. Wenn Sie die setti ng s. xml -D atei bearbeiten, während Red Hat JBoss D eveloper Studio läuft, so folgen Sie der Vorgehensweise am Ende dieses Themas mit dem Titel Erneuern der Benutzereinstellungen von Red Hat JBoss Developer Studio. Pro z ed u r 4 .5. Man u elles B earb eit en u n d K o n f ig u rieren vo n Maven - Ein st ellu n g en z u r Verwen d u n g mit d em O n lin e JB o ss EAP Maven R ep o sit o ry Sie können die JBoss EAP-Profile manuell einer bestehenden Maven-Einstellungsdatei hinzufügen. 1. Finden Sie das Maven-Installationsverzeichnis für Ihr Betriebssystem. Es ist in der Regel im USER_HOME/. m2/-Verzeichnis installiert. Für Linux oder Mac ist dies ~ /. m2/ Für Windows ist dies \D o cuments and Setti ng s\USER_NAME\. m2\ oder \Users\USER_NAME\. m2\ 2. Falls Sie keine setti ng s. xml -D atei finden, kopieren Sie die setti ng s. xml -D atei aus dem USER_HOME/. m2/co nf/-Verzeichnis in das USER_HOME/. m2/-Verzeichnis. 3. Kopieren Sie die folgende XML in das <pro fi l es>-Element der D atei. <!-- Configure the JBoss GA Maven repository --> <profile> <id>jboss-ga-repository</id> <repositories> <repository> <id>jboss-ga-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-ga-plugin-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> 30 Kapit el 4 . Anweisungen nach der Inst allat ion <!-- Configure the JBoss Early Access Maven repository --> <profile> <id>jboss-earlyaccess-repository</id> <repositories> <repository> <id>jboss-earlyaccess-repository</id> <url>http://maven.repository.redhat.com/earlyaccess/all/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-earlyaccess-plugin-repository</id> <url>http://maven.repository.redhat.com/earlyaccess/all/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> Kopieren Sie die folgende XML in das <acti veP ro fi l es>-Element der setti ng s. xml D atei. <activeProfile>jboss-ga-repository</activeProfile> <activeProfile>jboss-earlyaccess-repository</activeProfile> 4. Wenn Sie die setti ng s. xml -D atei bearbeiten, während Red Hat JBoss D eveloper Studio läuft, so folgen Sie der Vorgehensweise am Ende dieses Themas mit dem Titel Erneuern der Benutzereinstellungen von Red Hat JBoss Developer Studio. Pro z ed u r 4 .6 . R ed H at JB o ss D evelo p er St u d io B en u t z erein st ellu n g en n eu lad en Wenn Sie die setti ng s. xml -D atei bearbeiten, während Red Hat JBoss D eveloper Studio läuft, so müssen Sie die Benutzereinstellungen neu laden. 1. Wählen Sie aus dem Menü Win d o w → Pref eren ces. 2. Klappen Sie im P references-Bildschirm Maven aus und wählen Sie User Setti ng s. 3. Klicken Sie auf die Upd ate Setti ng s-Schaltfläche, um die Maven-Benutzereinstellungen in Red Hat JBoss D eveloper Studio neu zu laden. 31 Handbuch z um Einst ieg Ab b ild u n g 4 .11. Akt u alisieren d er Maven - B en u t z erein st ellu n g en Wichtig Falls Ihr Maven-Repository veraltete Artifakte enthält, so können beim Build oder dem D eployment Ihres Projekts die folgenden Maven-Fehlermeldungen erscheinen: Missing artifact ARTIFACT_NAME [ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve dependencies for PROJECT_NAME Um dieses Problem zu lösen, löschen Sie die gecachte Version Ihres lokalen Repository, um den D ownload der aktuellsten Artifakte zu erzwingen. D as gecachte Repository befindet sich in Ihrem ~ /. m2/repo si to ry/-Unterverzeichnis bei Linux bzw. dem %SystemDrive%\Users\USERNAME\. m2\repo si to ry\-Unterverzeichnis bei Windows. Fehler melden 32 Kapit el 5. Probieren Sie es aus Kapitel 5. Probieren Sie es aus 5.1. Führen Sie die Quickst art s aus 5.1.1. Ausführen der Quickst art s in Red Hat JBoss Developer St udio D ieser Abschnitt beschreibt die Verwendung von Red Hat JBoss D eveloper Studio für das D eployment von Quickstarts und das Ausführen der Arquillian-Tests. Pro z ed u r 5.1. Imp o rt ieren Sie d ie Q u ickst art s in R ed H at JB o ss D evelo p er St u d io Jeder Quickstart wird mit einer POM (Project Object Model) D atei geliefert, die Projekt- und Konfigurationsinformationen für den Quickstart enthält. Unter Verwendung dieser POM-D atei können Sie den Quickstart auf einfache Weise in Red Hat JBoss D eveloper Studio importieren. Wichtig Befindet sich Ihr Quickstart-Projektordner innerhalb der ID E-Arbeitsfläche wenn Sie Red Hat JBoss D eveloper Studio importieren, so generiert die ID E einen ungültigen Projektnamen und WAR-Archivnamen. Stellen Sie sicher, dass sich Ihr Quickstart-Projektordner auß erhalb der ID E-Arbeitsfläche befindet, ehe Sie anfangen! 1. Falls Sie es noch nicht getan haben, Abschnitt 4.2.4.2, »Konfigurieren der MavenEinstellungen zur Verwendung mit Befehlszeile«. 2. Starten Sie Red Hat JBoss D eveloper Studio. 3. Wählen Sie aus dem Menü File → Imp o rt . 4. Wählen Sie in der Auswahlliste Maven → Exist in g Maven Pro ject s, klicken Sie dann auf Next. 33 Handbuch z um Einst ieg Ab b ild u n g 5.1. Imp o rt b est eh en d er Maven - Pro jekt e 5. Gehen Sie in das Verzeichnis des Quickstarts, den Sie testen möchten, zum Beispiel den hel l o wo rl d -Quickstart und klicken Sie auf O K. D ie P ro jects-Listenbox wird mit der po m. xml -D atei des gewählten Quickstart-Projekts aufgefüllt. 34 Kapit el 5. Probieren Sie es aus Ab b ild u n g 5.2. Au swah l vo n Maven - Pro jekt en 6. Klicken Sie auf Fi ni sh (Beenden). Pro z ed u r 5.2. B u ild u n d D ep lo ymen t d es hel l o wo rl d - Q u ickst art s D er hel l o wo rl d -Quickstart ist einer der einfachsten Quickstarts und eine gute Weise um zu verifizieren, dass der JBoss Server korrekt konfiguriert ist und ordnungsgemäß läuft. 1. Falls Sie keinen Servers-Reiter sehen oder noch keinen Server definiert haben, befolgen Sie die Anweisungen hier: Abschnitt 4.1.5, »D en JBoss EAP Server mittels D efine New Server hinzufügen«. Falls Sie das D eployment eines Quickstart planen, der das ful l -Profil oder zusätzliche Startup-Argumente erfordert, so stellen Sie sicher, dass die Server-RuntimeUmgebung erstellt ist, wie in der Quickstart-Anleitung angegeben. 2. Klicken Sie mit der rechten Maustaste auf das jbo ss-hel l o wo rl d -Projekt im P ro ject Expl o rer-Reiter und wählen Sie R u n As. Sie erhalten eine Auswahlliste. Wählen Sie R u n o n Server. 35 Handbuch z um Einst ieg Ab b ild u n g 5.3. Au sf ü h ren als - Au sf ü h ren au f Server 3. Wählen Sie JBo ss EAP 6 . 1+ R unti me Server aus der Serverliste und klicken Sie auf Next. Ab b ild u n g 5.4 . Au sf ü h ren au f Server 4. D er nächste Bildschirm zeigt die Ressourcen an, die auf dem Server konfiguriert sind. D er jbo ss-hel l o wo rl d -Quickstart ist für Sie konfiguriert. Klicken Sie Fi ni sh, um den Quickstart bereitzustellen. 36 Kapit el 5. Probieren Sie es aus Ab b ild u n g 5.5. B earb eit en vo n am Server ko n f ig u riert en R esso u rcen 5. Überprüfen Sie die Ergebnisse. Im Server-Reiter wechselt der JBoss EAP 6.x Runtime Server Status zu [Started , R epubl i sh] . D er Server C o nso l e-Reiter zeigt Nachrichten zum JBoss EAP 6.x Server-Start und der Bereitstellung des helloworld Quickstarts. Ein hel l o wo rl d -Reiter erscheint, der die URL http://localhost:8080/jbosshelloworld/HelloWorld und den Text " Hello World!" anzeigt. D ie folgende Nachricht in der C o nso l e bestätigt das D eployment der jbo sshel l o wo rl d . war-D atei: 37 Handbuch z um Einst ieg JBAS018210: Register web context: /jboss-helloworld JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war") D er registrierte Webkontext wird http: //l o cal ho st: 80 80 angehängt, um die URL zu liefern, die für den Z ugriff auf die bereitgestellte Applikation verwendet wird. 6. Um zu verifizieren, dass der hel l o wo rl d -Quickstart erfolgreich zum JBoss Server deployt wurde, öffnen Sie einen Webbrowser und greifen Sie auf die Applikation mittels der folgenden URL zu: http://localhost:8080/jboss-helloworld Pro z ed u r 5.3. Fü h ren Sie d ie bean-val i d ati o n- Q u ickst art Arq u illian - T est s au s Einige Quickstarts bieten keine Benutzer-Interface-Schicht und stellen stattdessen zur D emonstration der Code-Beispiele Arquillian-Tests bereit. D er bean-val i d ati o n-Quickstart ist ein Beispiel für einen Quickstart, der Arquillian-Tests liefert. 1. Befolgen Sie die Vorgehensweise oben, um den bean-val i d ati o n-Quickstart in Red Hat JBoss D eveloper Studio zu importieren. 2. Klicken Sie im Servers-Reiter mit der rechten Maustaste auf den Server und wählen Sie St art , um den JBoss EAP Server zu starten. Falls Sie keinen Servers-Reiter sehen oder noch keinen Server definiert haben, folgen Sie den Anweisungen hier: Abschnitt 4.1.5, »D en JBoss EAP Server mittels D efine New Server hinzufügen«. 3. Klicken Sie mit der rechten Maustaste auf das jbo ss-bean-val i d ati o n-Projekt im P ro ject Expl o rer-Reiter und wählen Sie R u n As. Sie erhalten eine Auswahlliste. Wählen Sie Maven B u ild . 4. Geben Sie im G o al s-Eingabefeld des Ed i t C o nfi g urati o n-D ialogs ein: cl ean test P arq -jbo ssas-remo te Klicken Sie dann auf R un. 38 Kapit el 5. Probieren Sie es aus Ab b ild u n g 5.6 . K o n f ig u rat io n b earb eit en 5. Überprüfen Sie die Ergebnisse. D er Server C o nso l e-Reiter zeigt Nachrichten zum JBoss EAP-Serverstart und die Ausgabe der bean-val i d ati o n-Quickstart Arquillian-Tests an. ------------------------------------------------------T E S T S ------------------------------------------------------Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec Results : Tests run: 5, Failures: 0, Errors: 0, Skipped: 0 39 Handbuch z um Einst ieg [INFO] ----------------------------------------------------------------------[INFO] BUILD SUCCESS [INFO] ----------------------------------------------------------------------Fehler melden 5.1.2. Ausführen der Quickst art s mit t els einer Befehlsz eile Pro z ed u r 5.4 . B u ild u n d B ereit st ellu n g d er Q u ickst art s mit t els ein er B ef eh lsz eile D er Build und die Bereitstellung von Quickstarts mittels einer Befehlszeile sind einfach. Seien Sie sich aber bewusst, dass bei Verwendung einer Befehlszeile Sie selbst bei Bedarf den JBoss Server starten müssen. 1. Falls Sie es noch nicht getan haben, Abschnitt 4.2.4.2, »Konfigurieren der MavenEinstellungen zur Verwendung mit Befehlszeile«. 2. Sehen Sie sich die R EAD ME. html -D atei im root-Verzeichnis der Quickstarts an. D iese D atei enthält allgemeine Informationen zu Systemanforderungen, zur Konfiguration von Maven, zum Hinzufügen von Benutzern und zur Ausführung der Quickstarts. Lesen Sie sich diese unbedingt durch, ehe Sie anfangen. Sie enthält auch eine Tabelle mit einer Liste der verfügbaren Quickstarts. D ie Tabelle listet den Namen jedes Quickstarts sowie die Technlogie, die dieser demonstriert. Sie liefert auß erdem eine kurze Beschreibung des Quickstarts und das Erfahrungsniveau, das zu dessen Einrichtung erforderlich ist. Ausführlichere Informationen zu einem Quickstart erhalten Sie, wenn Sie auf den Namen des Quickstart klicken. Einige Quickstarts wurden dazu entworfen andere Quickstarts zu verbessern oder zu erweitern. D iese sind in der P rereq ui si tes-Tabelle vermerkt. Falls ein Quickstart Voraussetzungen listet, so müssen Sie diese installieren, ehe Sie mit dem Quickstart arbeiten. Einige Quickstarts erfordern die Installation und Konfiguration von optionalen Komponenten. Installieren Sie diese Komponenten nur, wenn der Quickstart diese erfordert. 3. Ausführen des hel l o wo rl d -Quickstarts. D er hel l o wo rl d -Quickstart ist einer der einfachsten Quickstarts und eine gute Weise um zu verifizieren, dass der JBoss Server korrekt konfiguriert ist und ordnungsgemäß läuft. Öffnen Sie die R EAD ME. html -D atei im root des hel l o wo rl d -Quickstarts. Sie enthält ausführliche Informationen dazu, wie der Build und das D eployment des Quickstart sowie der Z ugriff auf die laufende Applikation erfolgen sollen. 4. Ausführen der anderen Quickstarts. Befolgen Sie die Anweisungen in der R EAD ME. html -D atei im root-Ordner jedes Quickstarts, um das Beispiel auszuführen. Fehler melden 40 Anhang A. Bildschirmfot o Inst allat ionsprogramm Anhang A. Bildschirmfoto Installationsprogramm A.1. Auswahl der Sprache Ab b ild u n g A.1. JB o ss EAP In st allat io n sp ro g ramm: Sp rach au swah l Fehler melden A.2. Die Endnut z ervereinbarung 41 Handbuch z um Einst ieg Ab b ild u n g A.2. JB o ss EAP In st allat io n sp ro g ramm: En d n u t z erverein b aru n g Fehler melden A.3. Inst allat ionspfad 42 Anhang A. Bildschirmfot o Inst allat ionsprogramm Ab b ild u n g A.3. JB o ss EAP In st allat io n sp ro g ramm: In st allat io n sp f ad Fehler melden A.4 . Auswahl der z u inst allierenden Paket e Wählen Sie die zu installierenden Pakete. Erforderliche Pakete können nicht abgewählt werden. 43 Handbuch z um Einst ieg Ab b ild u n g A.4 . JB o ss EAP In st allat io n sp ro g ramm: Au swah l d er z u in st allieren d en Paket e Fehler melden A.5. Erst ellen eines administ rat iven Benut z ers 44 Anhang A. Bildschirmfot o Inst allat ionsprogramm Ab b ild u n g A.5. JB o ss EAP In st allat io n sp ro g ramm: Erst ellen ein es ad min ist rat iven B en u t z ers Fehler melden A.6. Quickst art Inst allat ion 45 Handbuch z um Einst ieg Ab b ild u n g A.6 . JB o ss EAP In st allat io n sp ro g ramm: Q u ickst art - Ein st ellu n g Fehler melden A.7. Einricht en des Maven-Reposit ory 46 Anhang A. Bildschirmfot o Inst allat ionsprogramm Ab b ild u n g A.7. JB o ss EAP In st allat io n sp ro g ramm: Ein rich t en d es Maven - R ep o sit o ry Fehler melden A.8. Einricht en von Socket -Bindings Bestimmen Sie, ob die Standard-Bindings verwendet werden sollen oder konfigurieren Sie benutzerdefinierte Bindings. 47 Handbuch z um Einst ieg Ab b ild u n g A.8. JB o ss EAP In st allat io n sp ro g ramm: St an d ard mäßig e So cket - B in d in g s Fehler melden A.9. Server-St art 48 Anhang A. Bildschirmfot o Inst allat ionsprogramm Ab b ild u n g A.9 . JB o ss EAP In st allat io n sp ro g ramm: Server- St art Fehler melden A.10. Konfigurieren von Prot okollebenen 49 Handbuch z um Einst ieg Ab b ild u n g A.10. JB o ss EAP In st allat io n sp ro g ramm: Ü b ersp rin g en d er K o n f ig u rat io n vo n Pro t o ko lleb en en Fehler melden A.11. Konfigurieren der Laufz eit umgebung 50 Anhang A. Bildschirmfot o Inst allat ionsprogramm Ab b ild u n g A.11. JB o ss EAP In st allat io n sp ro g ramm: K o n f ig u rat io n d er Lau f z eit u mg eb u n g ( St an d ard ) Fehler melden A.12. Überprüfen der Inst allat ionskomponent en 51 Handbuch z um Einst ieg Ab b ild u n g A.12. JB o ss EAP In st allat io n sp ro g ramm: Ü b erp rü f en d er au sg ewäh lt en K o mp o n en t en Fehler melden A.13. Inst allat ionsfort schrit t 52 Anhang A. Bildschirmfot o Inst allat ionsprogramm Ab b ild u n g A.13. JB o ss EAP In st allat io n sp ro g ramm: In st allat io n sf o rt sch rit t d er K o mp o n en t en Fehler melden A.14 . Inst allat ionsvorgang abgeschlossen 53 Handbuch z um Einst ieg Ab b ild u n g A.14 . JB o ss EAP In st allat io n sp ro g ramm: Vo rg an g ab g esch lo ssen Fehler melden A.15. Erst ellen von Short cut s 54 Anhang A. Bildschirmfot o Inst allat ionsprogramm Ab b ild u n g A.15. JB o ss EAP In st allat io n sp ro g ramm: Erst ellen vo n Sh o rt cu t s Fehler melden A.16. Generieren eines Inst allat ionsskript s 55 Handbuch z um Einst ieg Ab b ild u n g A.16 . JB o ss EAP In st allat io n sp ro g ramm: G en erieren ein es In st allat io n sskrip t s Fehler melden 56 Anhang B. Versionsgeschicht e Anhang B. Versionsgeschichte Versio n 6 .4 .0- 10 T u esd ay Ap ril 14 2015 Red Hat JBoss Enterprise Application Platform 6.4.0.GA Lu cas C o st i 57