Prozedur 3.1. Herunterladen des JBoss EAP Installationsprogramms vom Kundenportal unter dem „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 Downloads.
3. Klicken Sie in der Liste Produkt-Downloads auf Red Hat JBoss Enterprise Application Platform.
4. Wählen Sie die korrekte JBoss EAP Version aus der Version-Auswahlliste.
5. Suchen Sie Red Hat JBoss Enterprise Application Platform 6.x.x Installer in der Liste und klicken Sie auf die Download-Option.
6. Sie werden dazu aufgefordert, die JAR-Datei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis, und speichern Sie die Datei.

Prozedur 3.2. Herunterladen des JBoss EAP Installationsprogramms von jboss.org unter dem „Red Hat JBoss Developer Program“

1. Öffnen Sie einen Browser und geben Sie diese URL ein: http://www.jboss.org/products/eap.
   • Um das Installationsprogramm für die aktuelle GA-Version des Produkts herunterzuladen, klicken Sie auf die Schaltfläche Download rechts auf der Seite.
   • Folgen Sie diesen Schritten, um eine alternative Version auszuwählen, darunter die neuesten Alpha- oder Beta-Releases, sowie ältere Versionen des Produkts.
     1. Klicken Sie auf den Link Download JBoss EAP links auf der Seite.
     2. Klicken Sie in der Download-Spalte auf den Link Installer für die richtige Produktversion.
2. Sie werden dazu aufgefordert, die JAR-Datei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis, und speichern Sie die Datei.

Prozedur 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.

Prozedur 3.4. Laden Sie vom Kundenportal die ZIP-Datei unter dem „Full Red Hat JBoss Commercial Program“ herunter

1. Öffnen Sie einen Browser und melden Sie sich beim Red Hat Kundenportal unter https://access.redhat.com an.
2. Klicken Sie auf Downloads.
3. Klicken Sie in der Liste Produkt-Downloads auf Red Hat JBoss Enterprise Application Platform.
4. Wählen Sie die korrekte JBoss EAP Version aus der Version-Auswahlliste.
5. Suchen Sie Red Hat JBoss Enterprise Application Platform 6.x.x in der Liste und klicken Sie auf die Download-Option.
6. Sie werden dazu aufgefordert, die ZIP-Datei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die Datei.

Prozedur 3.5. Laden Sie die ZIP-Datei von jboss.org unter dem Red Hat JBoss Developer Program herunter.

1. Öffnen Sie einen Webbrowser und geben Sie diese URL ein: http://www.jboss.org/products/eap/
2. Klicken Sie auf den Link Download JBoss EAP links auf der Seite.
3. Klicken Sie in der Download-Spalte auf den Link ZIP für die richtige Produktversion.
4. Sie werden dazu aufgefordert, die ZIP-Datei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die Datei.

Prozedur 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. Der Benutzer, der den Server startet und stoppt, benötigt Lese- und Schreibzugriff auf das Verzeichnis.

2. Verwenden Sie eine geeignete Applikation zur Extraktion des ZIP-Archivs in den gewünschten Speicherort.

   In einer Red Hat Enterprise Linux Umgebung verwenden Sie das unzip-Dienstprogramm, um die Inhalte des ZIP-Archivs zu extrahieren.
   In einer Microsoft Windows Umgebung rechts-klicken Sie auf die Datei und wählen Sie Extract All.
   In einer Hewlett-Packard HP-UX Umgebung verwenden Sie das unzip-Dienstprogramm, um die Inhalte des ZIP-Archivs zu extrahieren.

Prozedur 3.7. Laden Sie die Quickstarts unter dem Full Red Hat JBoss Commercial Program herunter

1. Öffnen Sie einen Browser und melden Sie sich beim Red Hat Kundenportal unter https://access.redhat.com an.
2. Klicken Sie auf Downloads.
3. Klicken Sie in der Liste Produkt-Downloads auf Red Hat JBoss Enterprise Application Platform.
4. Wählen Sie die korrekte JBoss EAP Version aus der Version-Auswahlliste.
5. Suchen Sie Red Hat JBoss Enterprise Application Platform 6.x.x Quickstarts in der Liste und klicken Sie auf die Download-Option.
6. Sie werden dazu aufgefordert, die ZIP-Datei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die Datei.
7. Entpacken Sie das Archiv im Verzeichnis Ihrer Wahl.

Prozedur 3.8. Laden Sie die Quickstarts unter dem Red Hat JBoss Developer Program herunter

1. Öffnen Sie einen Webbrowser und geben Sie diese URL ein: http://www.jboss.org/products/eap/
2. Klicken Sie auf das Link JBoss EAP herunterladen links auf der Seite, um Informationen zum Produkt-Download anzuzeigen.
3. Klicken Sie unter Download JBoss EAP auf das Quickstarts-Link, um ein ZIP-Archiv mit Beispielen herunterzuladen.
4. Sie werden dazu aufgefordert, die ZIP-Datei in ein Verzeichnis Ihrer Wahl zu speichern. Wählen Sie ein Verzeichnis und speichern Sie die Datei.
5. Entpacken Sie das Archiv im Verzeichnis Ihrer Wahl.

1. Gehen Sie zur Seite https://www.jboss.org/products/devstudio.html.
2. Klicken Sie auf die Download-Schaltfläche. Sie werden dazu aufgefordert, die ZIP-Datei in ein Verzeichnis Ihrer Wahl zu speichern.

1. Öffnen Sie ein Terminal und navigieren Sie zu dem Verzeichnis, das die .jar-Datei 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-Datei doppelklicken, um das Installationsprogramm zu starten.
3. Klicken Sie auf Next, um den Installationsvorgang zu starten.
4. Wählen Sie I accept the terms of this license agreement 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 Dialogfeld. Klicken Sie auf Ok, 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.
7. Red Hat JBoss Developer Studio umfasst die Red Hat JBoss Enterprise Application Platform. Falls diese bereits installiert ist, wählen Sie No. Wählen Sie andernfalls Yes, um sie zu installieren und zur Verwendung mit Red Hat JBoss Developer 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 Desktop-Verknüpfungen für Red Hat JBoss Developer Studio und klicken Sie auf Next.
11. Klicken Sie auf Done.

Prozedur 4.1. Befehl zum 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 Developer Studio zu starten:
   Für Linux:

   [localhost]$ ./jbdevstudio

   Für Microsoft Windows:

   C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

Prozedur 4.2. Den Server hinzufügen

1. Öffnen Sie den Servers-Reiter. Ist kein Servers-Reiter vorhanden, so fügen Sie diesen wie folgt dem Panel hinzu:
   1. Klicken Sie auf Window → Show View → Other....
   2. Wählen Sie Servers aus dem Server-Ordner und klicken Sie auf OK.
2. Klicken Sie auf No servers are available. Click this link to create a new server... oder klicken Sie - falls Ihnen dies lieber ist - in das leere Server-Panel und wählen Sie New → Server.
   

   Abbildung 4.1. Neuen Server hinzufügen - Keine Server verfügbar

3. Klappen Sie JBoss Enterprise Middleware aus und wählen Sie JBoss Enterprise Application Platform 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 Dialog eine Server runtime environment-Auswahl mit der neuen Runtime-Definition an.
   

   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.
   

   Abbildung 4.3. Neuen Server-Adapter erstellen

5. Geben Sie einen Namen, zum Beispiel "JBoss EAP 6.4 Runtime" ein. Klicken Sie unter Home Directory auf Browse und navigieren Sie zum Speicherort Ihrer JBoss EAP Installation. Klicken Sie dann auf Next.
   

   Abbildung 4.4. Hinzufü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 full Profil benötigt, müssen Sie einen neuen Server definieren und eine Server Runtime Environment definieren, die standalone-full.xml für die Configuration file festlegt. Stellen Sie außerdem sicher, dass Sie dem Server einen neuen deskriptiven Namen geben.
6. Konfigurieren Sie bestehende Projekte für den neuen Server. Da Sie an diesem Punkt keine Projekte haben, klicken Sie auf Finish.
   

   Abbildung 4.5. Bearbeiten Sie die Ressourcen für den neuen JBoss Server

Prozedur 5.1. Importieren Sie die Quickstarts in Red Hat JBoss Developer Studio

1. Falls Sie es noch nicht getan haben, Abschnitt 4.2.4.2, »Konfigurieren der Maven-Einstellungen zur Verwendung mit Befehlszeile«.

2. Starten Sie Red Hat JBoss Developer 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.
   

   Abbildung 5.1. Import bestehender Maven-Projekte

5. Gehen Sie in das Verzeichnis des Quickstarts, den Sie testen möchten, zum Beispiel den helloworld-Quickstart und klicken Sie auf OK. Die Projects-Listenbox wird mit der pom.xml-Datei des gewählten Quickstart-Projekts aufgefüllt.
   

   Abbildung 5.2. Auswahl von Maven-Projekten

6. Klicken Sie auf Finish (Beenden).

Prozedur 5.2. Build und Deployment des helloworld-Quickstarts

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 Deployment eines Quickstart planen, der das full-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 jboss-helloworld-Projekt im Project Explorer-Reiter und wählen Sie Run As. Sie erhalten eine Auswahlliste. Wählen Sie Run on Server.
   

   Abbildung 5.3. Ausführen als - Ausführen auf Server

3. Wählen Sie JBoss EAP 6.1+ Runtime 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 jboss-helloworld-Quickstart ist für Sie konfiguriert. Klicken Sie Finish, um den Quickstart bereitzustellen.
   

   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, Republish] .
   • Der Server Console-Reiter zeigt Nachrichten zum JBoss EAP 6.x Server-Start und der Bereitstellung des helloworld Quickstarts.
   • Ein helloworld-Reiter erscheint, der die URL http://localhost:8080/jboss-helloworld/HelloWorld und den Text "Hello World!" anzeigt.
   • Die folgende Nachricht in der Console bestätigt das Deployment der jboss-helloworld.war-Datei:

     JBAS018210: Register web context: /jboss-helloworld
     JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
     

     Der registrierte Webkontext wird http://localhost:8080 angehängt, um die URL zu liefern, die für den Zugriff auf die bereitgestellte Applikation verwendet wird.
6. Um zu verifizieren, dass der helloworld-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

Prozedur 5.3. Führen Sie die bean-validation-Quickstart Arquillian-Tests aus

1. Befolgen Sie die Vorgehensweise oben, um den bean-validation-Quickstart in Red Hat JBoss Developer 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, »Den JBoss EAP Server mittels Define New Server hinzufügen«.
3. Klicken Sie mit der rechten Maustaste auf das jboss-bean-validation-Projekt im Project Explorer-Reiter und wählen Sie Run As. Sie erhalten eine Auswahlliste. Wählen Sie Maven Build.
4. Geben Sie im Goals-Eingabefeld des Edit Configuration-Dialogs ein: clean test -Parq-jbossas-remote
   Klicken Sie dann auf Run.
   

   Abbildung 5.6. Konfiguration bearbeiten

5. Überprüfen Sie die Ergebnisse.
   Der Server Console-Reiter zeigt Nachrichten zum JBoss EAP-Serverstart und die Ausgabe der bean-validation-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
   
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   

Prozedur 5.4. Build und Bereitstellung der Quickstarts mittels einer Befehlszeile

1. Falls Sie es noch nicht getan haben, Abschnitt 4.2.4.2, »Konfigurieren der Maven-Einstellungen zur Verwendung mit Befehlszeile«.
2. Sehen Sie sich die README.html-Datei im root-Verzeichnis der Quickstarts an.
   Diese Datei 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. Die 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. Diese sind in der Prerequisites-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 helloworld-Quickstarts.
   Der helloworld-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 README.html-Datei im root des helloworld-Quickstarts. Sie enthält ausführliche Informationen dazu, wie der Build und das Deployment des Quickstart sowie der Zugriff auf die laufende Applikation erfolgen sollen.
4. Ausführen der anderen Quickstarts.
   Befolgen Sie die Anweisungen in der README.html-Datei im root-Ordner jedes Quickstarts, um das Beispiel auszuführen.