JBoss Enterprise Application Platform 6.4 Handbuch zum Einstieg

Transkript

1 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 Costi Russell Dickenson Sande Gilda Vikram Goyal Eamon Logue Darrin Mison Scott Mumford David Ryan Misty Stanley-Jones Keerat Verma Tom Wells

2

3 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 Costi Russell Dickenso n Sande Gilda Vikram Go yal Eamon Logue Darrin Miso n Scott Mumford David Ryan Misty Stanley- Jo nes Keerat Verma Tom Wells

4 Rechtlicher Hinweis Copyright 2015 Red Hat, Inc.. This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n- ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be remo ved. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other co untries. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark o f Oracle and/o r its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/o r o ther co untries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and o ther co untries. Node.js is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack Wo rd Mark and OpenStack Lo go are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not 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 JBoss EAP 6.

5 Inhalt sverzeichnis Inhaltsverzeichnis. Vorwort Do kumentko nventio nen Typ o g rafische Ko nventio nen Ko nventio nen für Seitenansp rachen Anmerkung en und Warnung en 5 2. Hilfe und Feed b ack Brauchen Sie Hilfe? Wir freuen uns auf Ihr Feed b ack 6. Kapit.... el Einführung Üb er d ie Red Hat JBo ss Enterp rise Ap p licatio n Platfo rm Üb er d as Red Hat Kund enp o rtal Üb er d as Red Hat JBo ss Develo p er Pro g ram Üb er d as Full Red Hat JBo ss Co mmercial Pro g ram Weitere Info rmatio nen 8. Kapit.... el Vorausset zungen JBo ss EAP 6 Installatio nsvo raussetzung en 9. Kapit.... el Download und.... Inst... allat.... ion... des.... Produkt s JBo ss EAP Installatio nsüb ersicht Do wnlo ad und Installatio n d er JBo ss EAP mit d em g rafischen Installatio nsp ro g ramm Herunterlad en d es JBo ss EAP 6 Installatio nsp ro g ramms Ausführen d es JBo ss EAP Installatio nsp ro g ramms Do wnlo ad und Installatio n d er JBo ss EAP mit d er ZIP-Datei Herunterlad en vo n JBo ss EAP 6 (ZIP-Installatio n) Installieren d er JBo ss EAP 6 (ZIP-Installatio n) Do wnlo ad d er Q uickstart Co d e-beisp iele Die Q uickstarts herunterlad en 14. Kapit.... el Anweisungen nach..... der... Inst... allat.... ion Einrichten d er Entwicklung sumg eb ung Üb ersicht d er Red Hat JBo ss Develo p er Stud io Installatio n Herunterlad en d es Red Hat JBo ss Develo p er Stud io Installieren d es Red Hat JBo ss Develo p er Stud io Starten d es Red Hat JBo ss Develo p er Stud io Den JBo ss EAP Server mittels Define New Server hinzufüg en Ko nfig urieren Sie Maven Üb er Maven Ko nfig urieren d er Maven-Einstellung en Ko nfig urieren Sie Maven zur Verwend ung mit Red Hat JBo ss Develo p er Stud io Ko nfig urieren vo n Maven zur Verwend ung mit Red Hat JBo ss Develo p er Stud io Ko nfig urieren Sie Maven zur Verwend ung mit Befehlszeile Do wnlo ad und Installatio n vo n Maven Ko nfig urieren d er Maven-Einstellung en zur Verwend ung mit Befehlszeile 29. Kapit.... el Probieren Sie... es... aus Führen Sie d ie Q uickstarts aus Ausführen d er Q uickstarts in Red Hat JBo ss Develo p er Stud io Ausführen d er Q uickstarts mittels einer Befehlszeile 40. Anhang A... Bildschirmfot o.. Inst... allat.... ionsprogramm A.1. Auswahl d er Sp rache 41 A.2. Die End nutzervereinb arung 41 1

6 Handbuch zum Einst ieg A.2. Die End nutzervereinb arung A.3. Installatio nsp fad A.4. Auswahl d er zu installierend en Pakete A.5. Erstellen eines ad ministrativen Benutzers A.6. Q uickstart Installatio n A.7. Einrichten d es Maven-Rep o sito ry A.8. Einrichten vo n So cket-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 Laufzeitumg eb ung A.12. Üb erp rüfen d er Installatio nsko mp o nenten A.13. Installatio nsfo rtschritt A.14. Installatio nsvo rg ang ab g eschlo ssen A.15. Erstellen vo n Sho rtcuts A.16. G enerieren eines Installatio nsskrip ts Anhang B... Versionsgeschicht e

7 Vorwort 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 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 Datei 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: Drücken Sie die Ei ng abetaste, um den Befehl auszuführen. Drücken Sie Strg +Al t+f2, um zu einem virtuellen Terminal zu wechseln. Das erste Beispiel hebt die zu drückende Taste hervor. Das 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. Zum Beispiel: Zu dateiverwandten Klassen zählen fi l esystem für Dateisysteme, fi l e für Dateien und d i r für Verzeichnisse. Jede Klasse hat ihren eigenen Satz an Berechtigungen. Proportional Fett 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 System Einstellungen Maus in der Hauptmenüleiste aus, um die Mauseinstellungen 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 gedit-datei einzufügen, wählen Sie Anwendungen 3

8 Handbuch zum Einst ieg Zubehör Zeichentabelle aus der Hauptmenüleiste. Wählen Sie als Nächstes Suchen Suchen aus der Menüleiste der Zeichentabelle, geben Sie im Feld Suchbeg ri ff den Namen des Zeichens ein und klicken Sie auf Wei tersuchen. Das gesuchte Zeichen wird daraufhin in der Zei chentabel l e hervorgehoben. Doppelklicken Sie auf dieses hervorgehobene Zeichen, 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 Dokument und wählen Sie Bearbeiten Einfügen aus der gedit-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 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 Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs 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

9 Vorwort { 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

10 Handbuch zum 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 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 Klicken Sie auf den Namen einer Liste für weitere Einzelheiten zum Abonnieren dieser Liste oder um auf deren Archiv zuzugreifen 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 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

11 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. Die JBoss EAP 6 enthält eine neue, modulare Struktur, die es ermöglicht, Dienste 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 Ü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: Ü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 Über das Full Red Hat JBoss Commercial Program 7

12 Handbuch zum 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 einrichten. Weitere Informationen über dieses Programm finden Sie unter Abschnitt 1.2,» Über das Red Hat Kundenportal« 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 zur Verfügung. 8

13 Kapit el 2. Vorausset zungen Kapitel 2. Voraussetzungen 2.1. JBoss EAP 6 Inst allat ionsvorausset z ungen Zusammenfassung 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. Allgemeine Voraussetz ungen Überprüfen Sie die unterstützten Konfigurationen und vergewissern Sie sich, dass Ihr System unterstützt wird: 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. ZIP-/Installer-Voraussetz ungen 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. 9

14 Handbuch zum 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 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 ZIP-Datei. Folgen Sie den Anweisungen zu Ihrer bevorzugten Installationsmethode Download und Inst allat ion der JBoss EAP mit dem grafischen Inst allat ionsprogramm Herunt erladen des JBoss EAP 6 Inst allat ionsprogramms Zusammenfassung Die 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. Proz edur 3.1. Herunterladen des JBoss EAP Installationsprogramms vom Kundenportal unter dem Full Red Hat JBoss Commercial Program 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 an. 2. Klicken Sie auf Downloads. 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

15 Kapit el 3. Download und Inst allat ion des Produkt s Proz edur 3.2. Herunterladen des JBoss EAP Installationsprogramms von jboss.org unter dem Red Hat JBoss Developer Program 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: 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. Ergebnis D ie JAR-D atei für das JBoss EAP 6 Installationsprogramm wurde erfolgreich auf den Z ielrechner heruntergeladen 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 Proz edur 3.3. Ausführen des JBoss EAP Installationsprogramms 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. Tabelle 3.1. Bildschirme des JBoss EAP Installationsprogramms 11

16 Handbuch zum Einst ieg Bildschirmname Wann angez eigt Beschreibung Abschnitt A.1,» Auswahl der Sprache«Abschnitt A.2,»Die Endnutzervereinbarun g«abschnitt A.3,» Installationspfad«Abschnitt A.4,»Auswahl der zu installierenden Pakete«Abschnitt A.5,» Erstellen eines administrativen Benutzers«Abschnitt A.6,» Quickstart Installation«Abschnitt A.7,» Einrichten des Maven-Repository«Abschnitt A.8,» Einrichten von Socket-Bindings«Abschnitt A.9,» Server- Start«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 Immer Immer Immer Immer Immer Falls Sie die Quickstart-Beispiele installieren möchten Immer Immer Immer Immer Immer Immer Wählen Sie die gewünschte Sprache für das Installationsprogramm und klicken Sie auf O K. D ie Endnutzervereinbarung für Red Hat JBoss Middleware. 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. Erstellen Sie einen administrativen Benutzer und weisen Sie ein Passwort zu. Klicken Sie anschließ end auf Next. 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 Maven- Einstellungen 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. Sobald der Installationsvorgang abgeschlossen ist, klicken Sie auf Next. 12

17 Kapit el 3. Download und Inst allat ion des Produkt s Bildschirmname Wann angez eigt Beschreibung Abschnitt A.14,» Installationsvorgang abgeschlossen«abschnitt A.15,» Erstellen von Shortcuts«Abschnitt A.16,» Generieren eines Installationsskripts«Immer Immer Immer Wenn der Vorgang abgeschlossen ist, klicken Sie auf Next. Belassen Sie die Standardeinstellungen und klicken Sie auf Next. Klicken Sie auf D o ne. D ie Installation ist nun abgeschlossen. Ergebnis D ie Installation ist beendet und JBoss EAP 6 ist auf Ihrem Z ielrechner installiert Download und Inst allat ion der JBoss EAP mit der ZIP-Dat ei Herunt erladen von JBoss EAP 6 (ZIP-Inst allat ion) Zusammenfassung 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. Proz edur 3.4. Laden Sie vom Kundenportal die ZIP-Datei unter dem Full Red Hat JBoss Commercial Program herunter 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 an. 2. Klicken Sie auf Downloads. 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. Proz edur 3.5. Laden Sie die ZIP-Datei von jboss.org unter dem Red Hat JBoss Developer Program herunter. 13

18 Handbuch zum 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: 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. Ergebnis Die JBoss EAP 6 ZIP-Datei wurde erfolgreich auf den Zielrechner heruntergeladen Inst allieren der JBoss EAP 6 (ZIP-Inst allat ion) Zusammenfassung D ieses Thema behandelt die Installationsschritte der JBoss EAP 6 unter Verwendung der heruntergeladenen Z IP-D atei. Proz edur 3.6. ZIP-Dateiinstallation 1. Verschieben Sie das ZIP-Archiv an den gewünschten Speicherort. Verschieben Sie die ZIP-Datei 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. Verwenden Sie eine geeignete Applikation z ur Extraktion des ZIP-Archivs in den gewünschten Speicherort. Ergebnis 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 Datei 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. 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 Download der Quickst art Code-Beispiele 14

19 Kapit el 3. Download und Inst allat ion des Produkt s Die Quickst art s herunt erladen Zusammenfassung 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. Proz edur 3.7. Laden Sie die Q uickstarts unter dem Full Red Hat JBoss Commercial Program herunter 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 an. 2. Klicken Sie auf Downloads. 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. Proz edur 3.8. Laden Sie die Q uickstarts unter dem Red Hat JBoss Developer Program herunter 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: 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 ZIP-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. 15

20 Handbuch zum Einst ieg Kapitel 4. Anweisungen nach der Installation 4.1. Einricht en der Ent wicklungsumgebung Ü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 US/Red_Hat_JBoss_D eveloper_studio/ Herunt erladen des Red Hat JBoss Developer St udio 1. Gehen Sie zur Seite 2. Klicken Sie auf die D o wnl o ad -Schaltfläche. Sie werden dazu aufgefordert, die ZIP-Datei in ein Verzeichnis Ihrer Wahl zu speichern 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

21 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 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. Proz edur 4.1. Befehl z um Starten von Red Hat JBoss Developer Studio 1. Öffnen Sie ein Terminal und wechseln Sie in das Red Hat JBoss Developer 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 Den JBoss EAP Server mit t els Define New Server hinzufügen Diese Anleitung geht davon aus, dass dies Ihre erste Einführung in das Red Hat JBoss Developer 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 Server- Assistent hinzu. Proz edur 4.2. Den Server hinz ufügen 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 Window Show View O ther... 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 New Server. 17

22 Handbuch zum Einst ieg Abbildung 4.1. Neuen Server hinz ufügen - Keine Server verfügbar 3. Klappen Sie JBo ss Enterpri se Mi d d l eware aus und wählen Sie JBoss Enterprise Application Platform 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

23 Kapit el 4. Anweisungen nach der Inst allat ion Abbildung 4.2. Einen neuen Server definieren 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

24 Handbuch zum Einst ieg Abbildung 4.3. Neuen Server-Adapter erstellen 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

25 Kapit el 4. Anweisungen nach der Inst allat ion Abbildung 4.4. Hinz ufügen einer neuen Server Runtime Umgebung 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

26 Handbuch zum 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. Abbildung 4.5. Bearbeiten Sie die Ressourcen für den neuen JBoss Server Ergebnis D er JBoss EAP Runtime Server ist im Servers-Reiter gelistet. 22

27 Kapit el 4. Anweisungen nach der Inst allat ion Abbildung 4.6. Server erscheint in der Serverliste 4.2. Konfigurieren Sie Maven Über Maven Apache Maven ist ein distribuiertes Automatisierungstool bei der Entwicklung von Java- Applikationen zum Erstellen, Verwalten und den Build von Software-Projekten. Maven verwendet Standardkonfigurationsdateien namens Project Object Model oder POM, D ateien die den Build- Prozess 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 Konfigurieren der Maven-Einst ellungen Die für den Build und das Deployment 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 Developer Studio für den Build und das 23

28 Handbuch zum Einst ieg D eployment Ihrer Applikationen zu verwenden, folgen Sie den hier aufgeführten Anweisungen zur Konfiguration der Maven-Einstellungen: Abschnitt ,» 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 ,» D ownload und Installation von Maven«. Anschließ end befolgen Sie diese zur Konfiguration der Maven-Einstellungen: Abschnitt ,» Konfigurieren der Maven- Einstellungen zur Verwendung mit Befehlszeile« Konfigurieren Sie Maven z ur Verwendung mit Red Hat JBoss Developer St udio Ko nfigurieren vo n Maven zur Verwendung mit Red Hat JBo ss Develo per St udio Die für den Build und das Deployment 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 Developer Studio für den Build und das Deployment 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 ,» 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. Proz edur 4.3. Konfigurieren von Maven in Red Hat JBoss Developer Studio 1. Klicken Sie auf Window Preferences, klappen Sie JBo ss T o o l s aus und wählen Sie JBo ss Maven Integ rati o n. 24

29 Kapit el 4. Anweisungen nach der Inst allat ion Abbildung 4.7. JBoss Maven Integrationspanel im Bildschirm Preferences 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 Name- Werte 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

30 Handbuch zum Einst ieg Abbildung 4.8. Hinz ufügen von Maven Repository - JBoss Tech-Vorschau 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 Name- Werte 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

31 Kapit el 4. Anweisungen nach der Inst allat ion Abbildung 4.9. Hinz ufügen von Maven Repository - JBoss Early Access 5. Überprüfen Sie die Repositories und klicken Sie Fi ni sh. 27

32 Handbuch zum Einst ieg Abbildung Überprüfen der Maven Repositories 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 Dialog zu schließen. Das JBoss EAP Maven Repository ist jetzt für die Verwendung mit Red Hat JBoss Developer Studio konfiguriert Konfigurieren Sie Maven zur Verwendung mit Befehlszeile Do wnlo ad und Inst allat io n vo n Maven 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 Developer Studio für den Build und das Deployment Ihrer Applikationen zu verwenden, sokönnen Sie diese Prozedur überspringen, da Maven mit Red Hat JBoss D eveloper Studio geliefert wird. 28

33 Kapit el 4. Anweisungen nach der Inst allat ion 1. Gehen Sie auf Apache Maven Project - Download 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 Ko nfigurieren der Maven-Einst ellungen zur Verwendung mit Befehlszeile Die für den Build und das Deployment von Applikationen auf der JBoss EAP 6 erforderlichen Artifakte und Abhängigkeiten werden auf einem öffentlichen Repository gehostet. Falls Sie vorhaben, Red Hat JBoss Developer Studio für den Build und das Deployment Ihrer Applikationen zu verwenden, können Sie dieses Thema überspringen. Befolgen Sie stattdessen die Anweisungen hier: Abschnitt ,» 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 Maven- Einstellungen 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 -Datei 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. Voraussetz ungen Sie müssen Maven installieren, ehe Sie die Einstellungen konfigurieren. Weitere Informationen finden Sie unter: Abschnitt ,» D ownload und Installation von Maven«Proz edur 4.4. Konfigurieren von Maven unter Verwendung der mit den Q uickstart- Beispielen gelieferten Einstellungen 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

34 Handbuch zum 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 -Datei bearbeiten, während Red Hat JBoss Developer Studio läuft, so folgen Sie der Vorgehensweise am Ende dieses Themas mit dem Titel Erneuern der Benutzereinstellungen von Red Hat JBoss Developer Studio. Proz edur 4.5. Manuelles Bearbeiten und Konfigurieren von Maven-Einstellungen z ur Verwendung mit dem O nline JBoss EAP Maven Repository 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 -Datei finden, kopieren Sie die setti ng s. xml -Datei 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 Datei. <!-- Configure the JBoss GA Maven repository --> <profile> <id>jboss-ga-repository</id> <repositories> <repository> <id>jboss-ga-repository</id> <url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginrepositories> <pluginrepository> <id>jboss-ga-plugin-repository</id> <url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginrepository> </pluginrepositories> </profile> 30

35 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> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginrepositories> <pluginrepository> <id>jboss-earlyaccess-plugin-repository</id> <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 - Datei. <activeprofile>jboss-ga-repository</activeprofile> <activeprofile>jboss-earlyaccess-repository</activeprofile> 4. Wenn Sie die setti ng s. xml -Datei bearbeiten, während Red Hat JBoss Developer Studio läuft, so folgen Sie der Vorgehensweise am Ende dieses Themas mit dem Titel Erneuern der Benutzereinstellungen von Red Hat JBoss Developer Studio. Proz edur 4.6. Red Hat JBoss Developer Studio Benutz ereinstellungen neu laden Wenn Sie die setti ng s. xml -Datei bearbeiten, während Red Hat JBoss Developer Studio läuft, so müssen Sie die Benutzereinstellungen neu laden. 1. Wählen Sie aus dem Menü Window Preferences. 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 Developer Studio neu zu laden. 31

36 Handbuch zum Einst ieg Abbildung Aktualisieren der Maven-Benutz ereinstellungen 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. 32

37 Kapit el 5. Probieren Sie es aus Kapitel 5. Probieren Sie es aus 5.1. Führen Sie die Quickst art s aus 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. Proz edur 5.1. Importieren Sie die Q uickstarts in Red Hat JBoss Developer Studio 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 ,» Konfigurieren der Maven- Einstellungen zur Verwendung mit Befehlszeile«. 2. Starten Sie Red Hat JBoss D eveloper Studio. 3. Wählen Sie aus dem Menü File Import. 4. Wählen Sie in der Auswahlliste Maven Existing Maven Projects, klicken Sie dann auf Next. 33

38 Handbuch zum Einst ieg Abbildung 5.1. Import bestehender Maven-Projekte 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. Die P ro jects-listenbox wird mit der po m. xml -D atei des gewählten Quickstart-Projekts aufgefüllt. 34

39 Kapit el 5. Probieren Sie es aus Abbildung 5.2. Auswahl von Maven-Projekten 6. Klicken Sie auf Fi ni sh (Beenden). Proz edur 5.2. Build und Deployment des hel l o wo rl d -Q uickstarts Der 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,»Den JBoss EAP Server mittels Define 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-Runtime- Umgebung 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 Run As. Sie erhalten eine Auswahlliste. Wählen Sie Run on Server. 35

40 Handbuch zum Einst ieg Abbildung 5.3. Ausführen als - Ausführen auf Server 3. Wählen Sie JBo ss EAP R unti me Server aus der Serverliste und klicken Sie auf Next. Abbildung 5.4. Ausführen auf Server 4. Der nächste Bildschirm zeigt die Ressourcen an, die auf dem Server konfiguriert sind. Der jbo ss-hel l o wo rl d -Quickstart ist für Sie konfiguriert. Klicken Sie Fi ni sh, um den Quickstart bereitzustellen. 36

41 Kapit el 5. Probieren Sie es aus Abbildung 5.5. Bearbeiten von am Server konfigurierten Ressourcen 5. Überprüfen Sie die Ergebnisse. Im Server-Reiter wechselt der JBoss EAP 6.x Runtime Server Status zu [Started, R epubl i sh]. Der 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 und den Text " Hello World!" anzeigt. Die folgende Nachricht in der C o nso l e bestätigt das Deployment der jbo sshel l o wo rl d. war-datei: 37

42 Handbuch zum Einst ieg JBAS018210: Register web context: /jboss-helloworld JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war") Der registrierte Webkontext wird http: //l o cal ho st: 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: Proz edur 5.3. Führen Sie die bean-val i d ati o n-q uickstart Arquillian-Tests aus 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 Start, 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 Run As. Sie erhalten eine Auswahlliste. Wählen Sie Maven Build. 4. Geben Sie im G o al s-eingabefeld des Ed i t C o nfi g urati o n-dialogs ein: cl ean test - P arq -jbo ssas-remo te Klicken Sie dann auf R un. 38

43 Kapit el 5. Probieren Sie es aus Abbildung 5.6. Konfiguration bearbeiten 5. Überprüfen Sie die Ergebnisse. Der 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: sec Results : Tests run: 5, Failures: 0, Errors: 0, Skipped: 0 39

44 Handbuch zum Einst ieg [INFO] [INFO] BUILD SUCCESS [INFO] Ausführen der Quickst art s mit t els einer Befehlszeile Proz edur 5.4. Build und Bereitstellung der Q uickstarts mittels einer Befehlsz 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 ,» Konfigurieren der Maven- Einstellungen zur Verwendung mit Befehlszeile«. 2. Sehen Sie sich die R EAD ME. html -Datei 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. Der 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 -Datei 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. 4 0

45 Anhang A. Bildschirmfot o Inst allat ionsprogramm Anhang A. Bildschirmfoto Installationsprogramm A.1. Auswahl der Sprache Abbildung A.1. JBoss EAP Installationsprogramm: Sprachauswahl A.2. Die Endnut z ervereinbarung 4 1

46 Handbuch zum Einst ieg Abbildung A.2. JBoss EAP Installationsprogramm: Endnutz ervereinbarung A.3. Inst allat ionspfad 4 2

47 Anhang A. Bildschirmfot o Inst allat ionsprogramm Abbildung A.3. JBoss EAP Installationsprogramm: Installationspfad 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. 4 3

48 Handbuch zum Einst ieg Abbildung A.4. JBoss EAP Installationsprogramm: Auswahl der z u installierenden Paket e A.5. Erst ellen eines administ rat iven Benut z ers 4 4

49 Anhang A. Bildschirmfot o Inst allat ionsprogramm Abbildung A.5. JBoss EAP Installationsprogramm: Erstellen eines administrativen Benutz ers A.6. Quickst art Inst allat ion 4 5

50 Handbuch zum Einst ieg Abbildung A.6. JBoss EAP Installationsprogramm: Q uickstart-einstellung A.7. Einricht en des Maven-Reposit ory 4 6

51 Anhang A. Bildschirmfot o Inst allat ionsprogramm Abbildung A.7. JBoss EAP Installationsprogramm: Einrichten des Maven-Repository A.8. Einricht en von Socket -Bindings Bestimmen Sie, ob die Standard-Bindings verwendet werden sollen oder konfigurieren Sie benutzerdefinierte Bindings. 4 7

52 Handbuch zum Einst ieg Abbildung A.8. JBoss EAP Installationsprogramm: Standardmäßige Socket-Bindings A.9. Server-St art 4 8

53 Anhang A. Bildschirmfot o Inst allat ionsprogramm Abbildung A.9. JBoss EAP Installationsprogramm: Server-Start A.10. Konfigurieren von Prot okollebenen 4 9

54 Handbuch zum Einst ieg Abbildung A.10. JBoss EAP Installationsprogramm: Überspringen der Konfiguration von Protokollebenen A.11. Konfigurieren der Laufz eit umgebung 50

55 Anhang A. Bildschirmfot o Inst allat ionsprogramm Abbildung A.11. JBoss EAP Installationsprogramm: Konfiguration der Laufz eitumgebung (Standard) A.12. Überprüfen der Inst allat ionskomponent en 51

56 Handbuch zum Einst ieg Abbildung A.12. JBoss EAP Installationsprogramm: Überprüfen der ausgewählten Komponenten A.13. Inst allat ionsfort schrit t 52