Handbuch zum Einstieg

Benutzer können auch nicht-interaktiv erstellt werden, indem Parameter an das add-user Skript übergeben werden. Dieser Ansatz wird für gemeinsam genutzte Systeme nicht empfohlen, weil die Passwörter in Protokoll- und Verlauf-Dateien sichtbar sind. Weitere Informationen finden Sie unter Nicht-interaktives Ausführen des Dienstprogramms Benutzer-Hinzufügen.

Sie können das add-user Skript nicht-interaktiv ausführen, indem Sie Argumente an der Befehlszeile übergeben. Es muss mindestens Benutzername und Passwort angegeben werden.

Erstellen eines neuen Benutzers, der zu mehreren Gruppen gehört

Der folgende Befehl fügt einen Verwaltungsbenutzer (mgmtuser1) hinzu mit guest und mgmtgroup Gruppen.

EAP_HOME/bin/add-user.sh -u 'mgmtuser1' -p 'password1!' -g 'guest,mgmtgroup'

$ EAP_HOME/bin/add-user.sh -u 'mgmtuser1' -p 'password1!' -g 'guest,mgmtgroup'

Geben Sie eine alternative Eigenschaften-Datei an

Standardmäßig sind Informationen zu Benutzern und Gruppen, die mittels des add-user Skripts erstellt wurden, in den Eigenschaften-Dateien gespeichert, die sich im Konfigurationsverzeichnis des Servers befinden.

Benutzerinformationen sind in den folgenden Eigenschaften-Dateien gespeichert:

Gruppeninformationen sind in den folgenden Eigenschaften-Dateien gespeichert:

Diese Standardverzeichnisse und Namen der Eigenschaften-Dateien können ersetzt werden. Der folgende Befehl fügt einen neuen Benutzer hinzu und gibt einen anderen Namen und Speicherort für die Eigenschaften-Dateien des Benutzers an.

EAP_HOME/bin/add-user.sh -u 'mgmtuser2' -p 'password1!' -sc '/path/to/standaloneconfig/' -dc '/path/to/domainconfig/' -up 'newname.properties'

$ EAP_HOME/bin/add-user.sh -u 'mgmtuser2' -p 'password1!' -sc '/path/to/standaloneconfig/' -dc '/path/to/domainconfig/' -up 'newname.properties'

Der neue Benutzer wurde zu den Eigenschaften-Dateien hinzugefügt, die jetzt unter /path/to/standaloneconfig/newname.properties und /path/to/domainconfig/newname.properties zu finden sind. Beachten Sie, dass diese Dateien bereits existieren müssen, ansonsten wird ein Fehler angezeigt.

Eine vollständige Liste aller verfügbaren add-user Argumente und ihrer Zwecke finden Sie im --help Argument oder im Abschnitt Argumente für das Dienstprogramm Benutzer-Hinzufügen.

Das Management Command-Line Interface (CLI) ist ein Befehlszeilen-Verwaltungstool für JBoss EAP.

Benutzen Sie das Management CLI zum Starten und Anhalten von Servern, zum Bereitstellen und Deinstallieren von Anwendungen, zum Konfigurieren von Systemeinstellungen und zum Ausführen weiterer administrativer Aufgaben. Das Ausführen von Vorgängen im Batch-Modus ermöglicht mehrere Aufgaben als Gruppe auszuführen.

Viele allgemeine Terminal-Befehle sind verfügbar, wie ls, cd und pwd. Das Management CLI unterstützt auch die Vervollständigung mit der Tab-Taste.

For detailed information on using the management CLI, including commands and operations, syntax, and running in batch mode, see the JBoss EAP Management CLI Guide.

Starten des Management CLI

EAP_HOME/bin/jboss-cli.sh

$ EAP_HOME/bin/jboss-cli.sh

Verbinden mit einem laufenden Server

verbinden

verbinden

Sie können auch das Management CLI starten und über den EAP_HOME/bin/jboss-cli.sh --connect Befehl in einem Schritt verbinden.

Hilfe anzeigen

Benutzen Sie folgenden Befehl für allgemeine Hilfe

Hilfe

Hilfe

Hilfe zu einem bestimmten Befehl bekommen Sie mit folgendem Befehl.

deploy --help

deploy --help

Management CLI beenden

Beenden

Beenden

Systemeinstellungen ansehen

Der folgende Befehl benutzt den read-attribute Vorgang um anzuzeigen, ob die Beispiel-Datenquelle aktiviert ist.

/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)
{
    "outcome" => "success",
    "result" => true
}

/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)
{
    "outcome" => "success",
    "result" => true
}

Bei der Ausführung in einer Managed Domain müssen Sie angeben, welches Profil aktualisiert werden soll, indem Sie dem Befehl /profile=PROFILE_NAME voranstellen.

/profile=default/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)

/profile=default/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)

Systemeinstellungen aktualisieren

Der folgende Befehl benutzt den write-attribute Vorgang um die Beispiel-Datenquelle zu deaktivieren.

/subsystem=datasources/data-source=ExampleDS:write-attribute(name=enabled,value=false)

/subsystem=datasources/data-source=ExampleDS:write-attribute(name=enabled,value=false)

Server starten

Das Management CLI kann auch benutzt werden um Server zu starten und anzuhalten, wenn sie in einer Managed Domain ausgeführt werden.

/host=HOST_NAME/server-config=server-one:start

/host=HOST_NAME/server-config=server-one:start

Die Management-Konsole ist ein Verwaltungs-Tool auf Web-Basis für die JBoss EAP.

Verwenden Sie die Management-Konsole für das Starten und Anhalten von Servern, zum Bereitstellen und De-Installieren von Anwendungen, für die Feinabstimmung von Systemeinstellungen und die Durchführung permanenter Modifikationen an der Server-Konfiguration. Die Management-Konsole kann auch für administrative Aufgaben wie Live-Benachrichtigungen eingesetzt werden, wenn Änderungen durch den aktuellen Benutzer einen Neustart oder ein erneutes Laden der Server-Instanz erfordern.

In einer Managed Domain können Server-Instanzen und Server-Gruppen in derselben Domain zentral von der Management-Konsole des Domain-Controllers aus verwaltet werden.

Für eine JBoss EAP Instanz, die auf einem Localhost ausgeführt wird und den standardmäßigen Management Port benutzt, kann über einen Web-Browser bei http://localhost:9990/console/App.html auf die Management-Konsole zugegriffen werden. Sie müssen sich mit einem Benutzer authentifizieren, der Zugriffsberechtigungen für die Management-Konsole hat.

Die Management-Konsole bietet folgende Tabs zur Navigation und Verwaltung Ihres JBoss EAP Standalone Servers oder Ihrer Managed Domain.

The standalone configuration files are located in the EAP_HOME/standalone/configuration/ directory. A separate file exists for each of the four predefined profiles (default, ha, full, full-ha).

Der Start der JBoss EAP als Standalone-Server benutzt standardmäßig die standalone.xml Datei. Um die JBoss EAP mit einer anderen Konfiguration zu starten, benutzen Sie das --server-config Argument. Zum Beispiel

EAP_HOME/bin/standalone.sh --server-config=standalone-full.xml

$ EAP_HOME/bin/standalone.sh --server-config=standalone-full.xml

Die Konfigurationsdateien der Managed Domain befinden sich im EAP_HOME/domain/configuration/ Verzeichnis.

Der Start der JBoss EAP in einer Managed Domain benutzt standardmäßig die host.xml Datei. Um die JBoss EAP mit einer anderen Konfiguration zu starten, benutzen Sie das --host-config Argument. Zum Beispiel

EAP_HOME/bin/domain.sh --host-config=host-master.xml

$ EAP_HOME/bin/domain.sh --host-config=host-master.xml

Um die JBoss EAP Serverkonfiguration später wieder herzustellen, sollten Elemente an den folgenden Speicherorten gesichert werden:

Um die Wartung und Verwaltung des Servers zu unterstützen erstellt die JBoss EAP zum Zeitpunkt der Inbetriebnahme eine mit Zeitstempel versehene Version der originalen Konfigurationsdatei. Durch Verwaltungs-Vorgänge erfolgte Konfigurations-Änderungen führen zum automatischen Backup der Ursprungs-Datei und zur Speicherung einer Arbeitskopie der Instanz für Referenz und Rollback. Zusätzlich können Konfigurations-Snapshots erstellt werden, welche Zeitpunkt-Kopien der Server-Konfiguration darstellen. Diese Snapshots können von Administratoren gespeichert und geladen werden.

Die folgenden Beispiele verwenden die standalone.xml Datei, aber derselbe Prozess gilt für domain.xml und host.xml Dateien.

Erstellen eines Snapshots

Benutzen Sie das Management CLI um einen Snapshot der aktuellen Konfigurationen zu erstellen.

:take-snapshot
{
    "outcome" => "success",
    "result" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20151022-133109702standalone.xml"
}

:take-snapshot
{
    "outcome" => "success",
    "result" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20151022-133109702standalone.xml"
}

Liste aller Snapshots

Verwenden Sie das Management CLI um alle erstellten Snapshots aufzulisten.

:list-snapshots
{
    "outcome" => "success",
    "result" => {
        "directory" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
        "names" => [
            "20151022-133109702standalone.xml",
            "20151022-132715958standalone.xml"
        ]
    }
}

:list-snapshots
{
    "outcome" => "success",
    "result" => {
        "directory" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
        "names" => [
            "20151022-133109702standalone.xml",
            "20151022-132715958standalone.xml"
        ]
    }
}

Löschen eines Snapshots

Verwenden Sie das Management CLI um einen Snapshot zu löschen.

:delete-snapshot(name=20151022-133109702standalone.xml)

:delete-snapshot(name=20151022-133109702standalone.xml)

Starten des Servers mit einem Snapshot

Der Server kann mithilfe eines Snapshots oder einer automatisch gespeicherten Version der Konfiguration gestartet werden.

JBoss EAP ermöglicht Ihnen den Gebrauch von Ausdrücken an Stelle von literalen Werten um austauschbare Eigenschaften in der Konfiguration festzulegen. Ausdrücke verwenden das Format ${PARAMETER:DEFAULT_VALUE}. Ist der festgelegte Parameter eingestellt, so wird der Wert des Parameters verwendet. Andernfalls wird der angegebene Standardwert verwendet.

Unterstützte Quellen zum Auflösen der Ausdrücke sind Systemeigenschaften, Umgebungsvariablen und der Tresor. Nur für Deployments kann die Quelle aus Eigenschaften bestehen, die in einer META-INF/jboss.properties Datei im Deployment-Archiv aufgelistet sind. Für Deployment-Typen, die Sub-Deployments unterstützen, ist die Auflösung auf den Geltungsbereich aller Sub-Deployments bezogen, sofern die Eigenschaften-Datei im äußeren Deployment (z.B. EAR) ist. Ist die Eigenschaften-Datei im Sub-Deployment, so ist die Auflösung nur auf den Geltungsbereich dieses Sub-Deployments bezogen.

Das unten angeführte Beispiel aus der standalone.xml Konfigurationsdatei setzt die inet-address für die public Schnittstelle auf 127.0.0.1, außer der jboss.bind.address Parameter ist festgelegt.

<interface name="public">
    <inet-address value="${jboss.bind.address:127.0.0.1}"/>
</interface>

<interface name="public">
    <inet-address value="${jboss.bind.address:127.0.0.1}"/>
</interface>

Der jboss.bind.address Parameter kann beim Start der EAP als Standalone-Server mit folgendem Befehl festgelegt werden:

EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS

$ EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS

Verschachtelte Ausdrücke

Man kann Ausdrücke verschachteln, wodurch ein fortgeschrittener Gebrauch von Ausdrücken an Stelle von festen Werten möglich ist. Das Format eines verschachtelten Ausdrucks ist wie das eines normalen Ausdrucks, aber ein Ausdruck ist in einem anderen eingebettet, zum Beispiel:

${SYSTEM_VALUE_1${SYSTEM_VALUE_2}}

${SYSTEM_VALUE_1${SYSTEM_VALUE_2}}

Verschachtelte Ausdrücke werden rekursiv ausgewertet, damit zuerst der innere Ausdruck ausgewertet wird, und dann der äußere Ausdruck. Ausdrücke können auch rekursiv sein, wenn sich ein Ausdruck in einen anderen Ausdruck auflöst, der dann aufgelöst wird. Verschachtelte Ausdrücke sind überall zugelassen, wo Ausdrücke zugelassen sind, mit Ausnahme des Management CLI Befehls.

Ein Beispiel für eine mögliche Verwendung eines verschachtelten Ausdrucks wäre, wenn das in einer Datenquellen-Definition verwendete Passwort maskiert ist. Die Konfiguration für die Datenquelle könnte folgende Zeile haben:

<password>${VAULT::ds_ExampleDS::password::1}</password>

<password>${VAULT::ds_ExampleDS::password::1}</password>

Der Wert von ds_ExampleDS könnte unter Verwendung eines verschachtelten Ausdrucks durch eine Systemeigenschaft (datasource_name) ersetzt werden. Die Konfiguration für die Datenquelle könnte stattdessen folgende Zeile haben:

<password>${VAULT::${datasource_name}::password::1}</password>

<password>${VAULT::${datasource_name}::password::1}</password>

Die JBoss EAP würde zuerst den Ausdruck ${datasource_name} auswerten, dies anschließend am größeren Ausdruck eingeben und den daraus entstehenden Ausdruck auswerten. Der Vorteil dieser Konfiguration ist, dass der Name der Datenquelle von der festen Konfiguration abgewandelt ist.

Eigenschaften-Austausch auf Deskriptor-Basis

Gewöhnlich variiert die Anwendungskonfiguration (z.B. Verbindungsparameter der Datenquelle) zwischen Entwicklung, Test und Produktionsumgebung. Diese Abweichung ist manchmal in Build-System Skripts gespeichert, da die Java EE Spezifikation keine Methode zum Externalisieren dieser Konfigurationen enthält. Mit der JBoss EAP können Sie Eigenschaften-Austausch auf Deskriptor-Basis verwenden um Konfigurationen extern zu verwalten.

Eigenschaften-Austausch auf Deskriptor-Basis ersetzt Eigenschaften aufgrund von Deskriptoren, wodurch Sie Annahmen über die Umgebung aus der Anwendung und der Build-Kette entfernen können. Umgebungs-spezifische Konfigurationen werden in den Deployment-Deskriptoren bestimmt, anstatt in Anmerkungen oder Build System Skripts. Sie können Konfigurationen in Dateien oder als Parameter an der Befehlszeile bereitstellen.

Es gibt mehrere Flags im ee Subsystem, die kontrollieren, ob Eigenschaften-Austausch angewendet wird.

JBoss-spezifischer Deskriptor-Austausch wird von der jboss-descriptor-property-replacement Flag kontrolliert und ist standardmäßig aktiviert. Wenn er aktiviert ist, können Eigenschaften in den folgenden Deployment-Deskriptoren ersetzt werden:

Der folgende Management CLI Befehl kann verwendet werden um Eigenschaften-Austausch in JBoss-spezifischen Deskriptoren zu aktivieren oder zu deaktivieren:

/subsystem=ee:write-attribute(name="jboss-descriptor-property-replacement",value=VALUE)

/subsystem=ee:write-attribute(name="jboss-descriptor-property-replacement",value=VALUE)

Java EE Deskriptor-Austausch wird vom spec-descriptor-property-replacement Flag kontrolliert und ist standardmäßig deaktiviert. Ist er aktiviert, so können Eigenschaften in den folgenden Deployment-Deskriptoren ersetzt werden:

Der folgende Management CLI Befehl kann verwendet werden um Eigenschaften-Austausch in Java EE Deskriptoren zu aktivieren oder zu deaktivieren:

/subsystem=ee:write-attribute(name="spec-descriptor-property-replacement",value=VALUE)

/subsystem=ee:write-attribute(name="spec-descriptor-property-replacement",value=VALUE)

<interfaces>
  <interface name="management">
    <inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
  </interface>
  <interface name="public">
    <inet-address value="${jboss.bind.address:127.0.0.1}"/>
  </interface>
  <interface name="private">
    <inet-address value="${jboss.bind.address.private:127.0.0.1}"/>
  </interface>
  <interface name="unsecure">
    <inet-address value="${jboss.bind.address.unsecure:127.0.0.1}"/>
  </interface>
</interfaces>

<interfaces>
  <interface name="management">
    <inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
  </interface>
  <interface name="public">
    <inet-address value="${jboss.bind.address:127.0.0.1}"/>
  </interface>
  <interface name="private">
    <inet-address value="${jboss.bind.address.private:127.0.0.1}"/>
  </interface>
  <interface name="unsecure">
    <inet-address value="${jboss.bind.address.unsecure:127.0.0.1}"/>
  </interface>
</interfaces>

Die JBoss EAP bindet diese Schnittstellen standardmäßig an 127.0.0.1, aber diese Werte können zur Runtime außer Kraft gesetzt werden, indem die entsprechende Eigenschaft eingestellt wird. Mit folgendem Befehl kann zum Beispiel die inet-address der public Schnittstelle beim Start der JBoss EAP als Standalone-Server festgelegt werden.

EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS

$ EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS

Alternativ können Sie den Switch -b in der Serverstart-Befehlszeile verwenden. Weitere Informationen zu Server-Startoptionen finden Sie unter Server-Runtime-Argumente.

Netzwerkschnittstellen werden deklariert, indem ein logischer Name und Auswahlkriterien für die physische Schnittstelle angegeben werden. Die Auswahlkriterien können auf eine Wildcard-Adresse verweisen oder einen Satz von einem oder mehreren Merkmalen angeben, die eine Schnittstelle oder Adresse haben muss um eine gültige Übereinstimmung darzustellen. Eine Liste aller verfügbaren Schnittstellen-Auswahlkriterien finden Sie im Abschnitt Schnittstellenattribute.

Schnittstellen können mittels der Management-Konsole oder dem Management CLI konfiguriert werden. Unten finden Sie einige Beispiele für das Hinzufügen und Aktualisieren von Schnittstellen. Zuerst wird der Management CLI Befehl angezeigt, gefolgt von der entsprechenden Konfiguration XML.

Hinzufügen einer Schnittstelle mit einem NIC Wert

Fügen Sie eine neue Schnittstelle mit einem NIC Wert von eth0 hinzu.

/interface=external:add(nic=eth0)

/interface=external:add(nic=eth0)

<interface name="external">
   <nic name="eth0"/>
</interface>

<interface name="external">
   <nic name="eth0"/>
</interface>

Hinzufügen einer Schnittstelle mit mehreren bedingten Werten

Neue Schnittstelle hinzufügen, die mit jeder Schnittstelle/Adresse auf dem korrekten Subnetz übereinstimmt, Multicast unterstützt und nicht Point-to-Point ist.

/interface=default:add(subnet-match=192.168.0.0/16,up=true,multicast=true,not={point-to-point=true})

/interface=default:add(subnet-match=192.168.0.0/16,up=true,multicast=true,not={point-to-point=true})

<interface name="default">
   <subnet-match value="192.168.0.0/16"/>
   <up/>
   <multicast/>
   <not>
      <point-to-point/>
   </not>
</interface>

<interface name="default">
   <subnet-match value="192.168.0.0/16"/>
   <up/>
   <multicast/>
   <not>
      <point-to-point/>
   </not>
</interface>

Aktualisieren eines Schnittstellenattributs

Aktualisieren Sie den Standard inet-address Wert der public Schnittstelle unter Erhalt der jboss.bind.address Eigenschaft, damit dieser Wert zur Runtime eingestellt werden kann.

/interface=public:write-attribute(name=inet-address,value="${jboss.bind.address:192.168.0.0}")

/interface=public:write-attribute(name=inet-address,value="${jboss.bind.address:192.168.0.0}")

<interface name="public">
    <inet-address value="${jboss.bind.address:192.168.0.0}"/>
</interface>

<interface name="public">
    <inet-address value="${jboss.bind.address:192.168.0.0}"/>
</interface>

Hinzufügen einer Schnittstelle zu einem Server in einer Managed Domain

/host=master/server-config=SERVER_NAME/interface=INTERFACE_NAME:add(inet-address=127.0.0.1)

/host=master/server-config=SERVER_NAME/interface=INTERFACE_NAME:add(inet-address=127.0.0.1)

<servers>
   <server name="SERVER_NAME" group="main-server-group">
      <interfaces>
         <interface name="INTERFACE_NAME">
            <inet-address value="127.0.0.1"/>
         </interface>
      </interfaces>
   </server>
</servers>

<servers>
   <server name="SERVER_NAME" group="main-server-group">
      <interfaces>
         <interface name="INTERFACE_NAME">
            <inet-address value="127.0.0.1"/>
         </interface>
      </interfaces>
   </server>
</servers>

Management Ports wurden in der JBoss EAP 7 konsolidiert. Standardmäßig benutzt die JBoss EAP 7 Port 9990 sowohl für systemeigenes Management (vom Management CLI verwendet) und für HTTP Management (von Management-Konsole auf Web-Basis verwendet). Port 9999, der als systemeigener Management Port in der JBoss EAP 6 benutzt wurde, wird nicht mehr verwendet, kann aber nach wie vor auf Wunsch aktiviert werden.

Ist HTTPS für die Management-Konsole aktiviert, so wird standardmäßig Port 9993 benutzt.

JBoss EAP ships with a socket binding group for each of the four predefined profiles (default, ha, full, full-ha).

Detaillierte Informationen zu den Socket-Bindungen, wie Standard-Ports und Beschreibungen, finden Sie im Abschnitt Standard Socket-Bindungen.

Standalone-Server

Bei der Ausführung als Standalone-Server ist nur eine Gruppe von Socket-Bindungen pro Konfigurationsdatei definiert. Jede Standalone-Konfigurationsdatei (standalone.xml, standalone-ha.xml, standalone-full.xml, standalone-full-ha.xml) definiert Socket-Bindungen für die Technologien, die vom entsprechenden Profil verwendet werden.

Die standardmäßige Standalone-Konfigurationsdatei (standalone.xml) gibt zum Beispiel die unten angeführten Socket-Bindungen an.

<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
    <socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>
    <socket-binding name="management-https" interface="management" port="${jboss.management.https.port:9993}"/>
    <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
    <socket-binding name="http" port="${jboss.http.port:8080}"/>
    <socket-binding name="https" port="${jboss.https.port:8443}"/>
    <socket-binding name="txn-recovery-environment" port="4712"/>
    <socket-binding name="txn-status-manager" port="4713"/>
    <outbound-socket-binding name="mail-smtp">
        <remote-destination host="localhost" port="25"/>
    </outbound-socket-binding>
</socket-binding-group>

<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
    <socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>
    <socket-binding name="management-https" interface="management" port="${jboss.management.https.port:9993}"/>
    <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
    <socket-binding name="http" port="${jboss.http.port:8080}"/>
    <socket-binding name="https" port="${jboss.https.port:8443}"/>
    <socket-binding name="txn-recovery-environment" port="4712"/>
    <socket-binding name="txn-status-manager" port="4713"/>
    <outbound-socket-binding name="mail-smtp">
        <remote-destination host="localhost" port="25"/>
    </outbound-socket-binding>
</socket-binding-group>

Managed Domain

When running in a managed domain, all socket binding groups are defined in the domain.xml file. There are four predefined socket binding groups:

Jede Socket-Bindung Gruppe gibt Socket-Bindungen für die Technologien an, die vom zugehörigen Profil verwendet werden. Zum Beispiel definiert die full-ha-sockets Socket-Bindung Gruppe mehrere jgroups Socket-Bindungen, welche vom full-ha Profil für Hochverfügbarkeit verwendet werden.

<socket-binding-groups>
    <socket-binding-group name="standard-sockets" default-interface="public">
        <!-- Needed for server groups using the 'default' profile  -->
        <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
        <socket-binding name="http" port="${jboss.http.port:8080}"/>
        <socket-binding name="https" port="${jboss.https.port:8443}"/>
        <socket-binding name="txn-recovery-environment" port="4712"/>
        <socket-binding name="txn-status-manager" port="4713"/>
        <outbound-socket-binding name="mail-smtp">
            <remote-destination host="localhost" port="25"/>
        </outbound-socket-binding>
    </socket-binding-group>
    <socket-binding-group name="ha-sockets" default-interface="public">
        <!-- Needed for server groups using the 'ha' profile  -->
    ...
    </socket-binding-group>
    <socket-binding-group name="full-sockets" default-interface="public">
        <!-- Needed for server groups using the 'full' profile  -->
    ...
    </socket-binding-group>
    <socket-binding-group name="full-ha-sockets" default-interface="public">
        <!-- Needed for server groups using the 'full-ha' profile  -->
        <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
        <socket-binding name="http" port="${jboss.http.port:8080}"/>
        <socket-binding name="https" port="${jboss.https.port:8443}"/>
        <socket-binding name="iiop" interface="unsecure" port="3528"/>
        <socket-binding name="iiop-ssl" interface="unsecure" port="3529"/>
        <socket-binding name="jgroups-mping" interface="private" port="0" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45700"/>
        <socket-binding name="jgroups-tcp" interface="private" port="7600"/>
        <socket-binding name="jgroups-tcp-fd" interface="private" port="57600"/>
        <socket-binding name="jgroups-udp" interface="private" port="55200" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45688"/>
        <socket-binding name="jgroups-udp-fd" interface="private" port="54200"/>
        <socket-binding name="modcluster" port="0" multicast-address="224.0.1.105" multicast-port="23364"/>
        <socket-binding name="txn-recovery-environment" port="4712"/>
        <socket-binding name="txn-status-manager" port="4713"/>
        <outbound-socket-binding name="mail-smtp">
            <remote-destination host="localhost" port="25"/>
        </outbound-socket-binding>
    </socket-binding-group>
</socket-binding-groups>

<socket-binding-groups>
    <socket-binding-group name="standard-sockets" default-interface="public">
        <!-- Needed for server groups using the 'default' profile  -->
        <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
        <socket-binding name="http" port="${jboss.http.port:8080}"/>
        <socket-binding name="https" port="${jboss.https.port:8443}"/>
        <socket-binding name="txn-recovery-environment" port="4712"/>
        <socket-binding name="txn-status-manager" port="4713"/>
        <outbound-socket-binding name="mail-smtp">
            <remote-destination host="localhost" port="25"/>
        </outbound-socket-binding>
    </socket-binding-group>
    <socket-binding-group name="ha-sockets" default-interface="public">
        <!-- Needed for server groups using the 'ha' profile  -->
    ...
    </socket-binding-group>
    <socket-binding-group name="full-sockets" default-interface="public">
        <!-- Needed for server groups using the 'full' profile  -->
    ...
    </socket-binding-group>
    <socket-binding-group name="full-ha-sockets" default-interface="public">
        <!-- Needed for server groups using the 'full-ha' profile  -->
        <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
        <socket-binding name="http" port="${jboss.http.port:8080}"/>
        <socket-binding name="https" port="${jboss.https.port:8443}"/>
        <socket-binding name="iiop" interface="unsecure" port="3528"/>
        <socket-binding name="iiop-ssl" interface="unsecure" port="3529"/>
        <socket-binding name="jgroups-mping" interface="private" port="0" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45700"/>
        <socket-binding name="jgroups-tcp" interface="private" port="7600"/>
        <socket-binding name="jgroups-tcp-fd" interface="private" port="57600"/>
        <socket-binding name="jgroups-udp" interface="private" port="55200" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45688"/>
        <socket-binding name="jgroups-udp-fd" interface="private" port="54200"/>
        <socket-binding name="modcluster" port="0" multicast-address="224.0.1.105" multicast-port="23364"/>
        <socket-binding name="txn-recovery-environment" port="4712"/>
        <socket-binding name="txn-status-manager" port="4713"/>
        <outbound-socket-binding name="mail-smtp">
            <remote-destination host="localhost" port="25"/>
        </outbound-socket-binding>
    </socket-binding-group>
</socket-binding-groups>

Bei der Definition einer Socket-Bindung können Sie sowohl port und interface Attribute konfigurieren, als auch Multicast Einstellungen wie multicast-address und multicast-port. Details zu allen verfügbaren Socket-Bindung Attributen finden Sie im Abschnitt Socket-Bindung Attribute.

Socket-Bindungen können über die Management-Konsole oder das Management CLI konfiguriert werden. Die folgenden Schritte helfen Ihnen beim Hinzufügen einer Socket-Bindungen Gruppe, beim Hinzufügen einer Socket-Bindung und beim Konfigurieren der Socket-Bindung Einstellungen über das Management CLI.

Das folgende Beispiel zeigt, wie die XML Konfiguration aussehen könnte, nachdem die vorherigen Schritte durchgeführt wurden.

<socket-binding-groups>
    ...
    <socket-binding-group name="new-sockets" default-interface="public">
        <socket-binding name="new-socket-binding" interface="unsecure" port="1234"/>
    </socket-binding-group>
</socket-binding-groups>

<socket-binding-groups>
    ...
    <socket-binding-group name="new-sockets" default-interface="public">
        <socket-binding name="new-socket-binding" interface="unsecure" port="1234"/>
    </socket-binding-group>
</socket-binding-groups>

Ein Port Offset ist ein numerischer Offset-Wert, der zu allen Port Werten hinzugefügt wurde, die in der Gruppe von Socket-Bindungen für diesen Server angegeben wurden. Dies ermöglicht dem Server die in seiner Gruppe von Socket-Bindungen angegebenen Port Werte zu erben, wobei ein Offset sicherstellt, dass er nicht mit einem anderen Server auf demselben Host in Konflikt steht. Wenn zum Beispiel der HTTP Port der Gruppe von Socket-Bindungen 8080 ist und ein Server ein Port Offset von 100 benutzt, dann ist sein HTTP Port 8180.

Unten finden Sie ein Beispiel für die Einstellung eines Port Offsets von 250 für einen Server in einer Managed Domain unter Verwendung des Management CLI.

/host=master/server-config=server-two/:write-attribute(name=socket-binding-port-offset,value=250)

/host=master/server-config=server-two/:write-attribute(name=socket-binding-port-offset,value=250)

Port Offsets können für Server in einer Managed Domain verwendet werden, sowie für die Ausführung mehrerer Standalone-Server auf demselben Host.

Über die Eigenschaft jboss.socket.binding.port-offset können Sie beim Start eines Standalone-Servers einen Port-Offset übergeben.

EAP_HOME/bin/standalone.sh -Djboss.socket.binding.port-offset=100

$ EAP_HOME/bin/standalone.sh -Djboss.socket.binding.port-offset=100

Die JBoss EAP kommt mit einem umfassenden Satz an Quickstart-Codebeispielen, die den Benutzern beim Schreiben von Anwendungen mittels verschiedener Java EE 7 Technologien helfen sollen. Die Quickstarts können vom Red Hat Kundenportal heruntergeladen werden.

Sobald die Quickstarts heruntergeladen sind, können Sie ins JBoss Developer Studio importiert und in der JBoss EAP bereitgestellt werden.

Build und Bereitstellung von Quickstarts von der Befehlszeile aus sind mit Maven einfach. Wenn Sie Maven noch nicht installiert haben, gehen Sie zum Apache Maven Projekt um es herunterzuladen und zu installieren.

Eine README.md Datei im root Verzeichnis des Quickstarts enthält allgemeine Informationen über Systemanforderungen, über die Konfiguration von Maven, über das Hinzufügen von Benutzern und über die Ausführung von Quickstarts.

Jeder Quickstart enthält zudem seine eigene README.md Datei, die spezifische Anweisungen und Maven-Befehle zur Ausführung des Quickstarts bereitstellt.