Deployment der Produktdaten

Deployment mit Wildfly einrichten

Wildfly 11 (oder neuer) von https://www.wildfly.org/downloads/ herunterladen und entpacken.

User für die Management Oberfläche konfigurieren

bin/add-user.sh (oder bin/add-user.bat für Windows)

Es kann ein beliebiger Benutzer für die Management Oberfläche verwendet werden. Hier wird beispielhaft die Einrichtung des Users admin erläutert:

  • Management User (a)

  • Name: admin

  • Existierenden User anpassen? (a)

  • Passwort beliebig

  • Keine weiteren Gruppen

  • Is this new user going to be used for one AS process to connect to another AS process? No

Weitere Einstellungen

Wie in REST-API beschrieben, muss ALLOW_ENCODED_SLASH eingestellt werden:

Datei standalone/configuration/standalone.xml öffnen

Nach </extensions>:

<system-properties>
    <property name="eclipselink.target-server" value="JBoss"/>
    <property name="org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH" value="true"/>
</system-properties>

Wildfly starten und konfigurieren

Skripte zum starten liegen im Ordner bin/ und heißen standalone.sh oder für Windows standalone.bat.

Die Management Oberfläche erreicht man mit: http://localhost:9990

Addressen konfigurieren

Die gebundene Adresse kann in der Datei standalone/configuration/standalone.xml oder per Konsolenparameter eingestellt werden, z.B. -b=0.0.0.0 für alle Adressen. Die Adresse der Management-Konsole (Web-UI oder CLI) wird mit -bmanagement=0.0.0.0 angegeben.

Link zur Dokumentation: https://docs.wildfly.org/12/Admin_Guide.html#controlling-the-bind-address

Datasource einrichten

EclipseLink muss als neues Modul im JBoss integriert werden: https://docs.wildfly.org/12/Developer_Guide.html#migrating-from-eclipselink

In der Management Oberfläche:

  • Configuration

  • Subsystems > Datasources > Non-XA > Add

  • Treiber auswählen, Name beliebig, JNDI Name: java:/ips-product-data

  • Sonstige Einstellungen abhängig vom verwendeten Treiber

  • Zum testen einfach H2 Database auswählen und Treiber Einstellungen bei Default lassen (In Memory)

User einrichten

Um den Service mit Authentifizierung zu testen, muss am Application Server ein User mit der Rolle ipsdeploy eingerichtet werden. Ein User kann bei JBoss und Wildfly über das add-user.bat bzw. add-user.sh Script, welches sich im /bin Verzeichnis der Installation befindet, erstellt werden. Der Benutzer kann als Applikationsbenutzer angelget werden.

Deployment

In der Management Oberfläche

  • Deployments > Add

    • Upload a new deployment

    • WAR auswählen

    • Name beliebig

    • Runtime Name: productdata-jpa-deployment.war

Der Runtime-Name muss mit der Endung ".war" sein, in der URL wird .war dann weg gelassen

Deployment per Eclipse (z.B. zum testen oder Entwickeln)

  • Server View

  • New → Server

  • Wildfly 11 auswählen (ggf. Wildfly Connector nachinstallieren)

  • Weiter → Weiter → Home Verzeichnis auswählen

Beim Deployment über Eclipse funktioniert die generierte API Dokumentation nicht, da diese nur per maven gebaut wird