Entwicklungsumgebung für JBoss vorbereiten

Führen Sie die Anwendung im Modus "Zerlegt" aus, um die Entwicklungsumgebung für JBoss vorzubereiten.

Informationen zu diesem Vorgang

In diesem Abschnitt wird erläutert, wie die Änderungen getestet werden, die bei Verwendung von JBoss an vorgenommen wurden.

Hinweis: IBM® empfiehlt, alle JAR-Dateien aus der extrahierten EAR-Datei direkt in das Verzeichnis WEB-INF/lib zu kopieren. Auf diese Weise kann über JBoss auf die JAR-Dateien zugegriffen werden, die Sie dann auch nicht in die CLASSPATH-Variable von JBoss einschließen müssen.

So konfigurieren Sie JBoss zur Ausführung im Modus "Zerlegt"

Vorgehensweise

Bearbeiten Sie das Script < JBOSS_DOMAIN>/bin/run.cmd für Windows (run.sh für UNIX) und setzen Sie das folgende Argument in den Optionen als Java™ -Parameter:
```
-Dsci.opsproxy.disable=Y -Dvendor=shell
-DvendorFile=/servers.properties
```
Erstellen Sie die EAR-Datei genauso wie während des Installationsprozesses erneut.

Hinweis: Die Anwendung unterstützt keine Dokumentationserweiterungen für die kontextbezogene Hilfe im Modus 'Zerlegt'. Sie können jedoch die EAR-Datei für die Dokumentation zusammen mit der EAR-Datei für die Anwendung erstellen. Die EAR-Datei für die Dokumentation enthält keine Endbenutzerdokumentation wie beispielsweise die kontextbezogenen Hilfedateien. Es enthält nur entwicklungsbezogene Dokumentation, einschließlich API-Javadoc, ERDs und XSDs, die nicht auf einem Produktionsserver implementiert werden sollten.
Wenn Sie die EAR-Datei der Dokumentation erstellen möchten, smcfsdocs.ear zusammen mit der EAR-Datei der Anwendung, bevor Sie den Befehl "buildear" ausführen, fügen Sie die Eigenschaft BUILD_DOC_EAR hinzu und setzen Sie den Wert in der Datei <INSTALL_DIR>/properties/sandbox.cfg auf "true" und führen Sie das Script "setupfiles" aus.
Hinweis: Standardmäßig wird die EAR-Datei der Dokumentation nicht mit der EAR-Datei der Anwendung erstellt und implementiert.

Hinweis: Der Parameter -Dnodocear hat Vorrang vor der Eigenschaft BUILD_DOC_EAR. Wird beispielsweise die BUILD_DOC_EAR-Eigenschaft auf "true" festgelegt, aber der Parameter -Dnodocear-Parameter zusammen mit dem Script "create-ear" verwendet, so wird die EAR-Datei der Dokumentation nicht erstellt.
Stoppen Sie den Anwendungsserver und führen Sie die folgenden Schritte aus.

Wenn Sie beispielsweise einige Anpassungen im Katalogmodul haben, fügen Sie die Dateien im Verzeichnis < JBOSS_HOME>/server/< SERVER_NAME>/deploy/smcfs.ear/smcfs.war/ycm hinzu.

Erstellen Sie ein neues Verzeichnis mit dem Namen smcfs.ear.
Extrahieren Sie die EAR-Datei in das von Ihnen erstellte Verzeichnis smcfs.ear.
Im Verzeichnis smcfs.ear ist eine Datei smcfs.war vorhanden. Benennen Sie diese WAR-Datei um oder kopieren Sie sie in ein anderes Verzeichnis.
Erstellen Sie im Verzeichnis SMCF.ear ein neues Unterverzeichnis mit dem Namen SMCF.war.
Extrahieren und extrahieren Sie alle Dateien aus der Datei smcfs.war in das Unterverzeichnis smcfs.ear/smcfs.war.
Löschen Sie die WAR-Datei smcfs, die Sie in Schritt 5 umbenannt oder kopiert haben.
Kopieren Sie die im Rahmen der Erstellung und Implementierung von Erweiterungen erstellten JAR-Dateien und überschreiben Sie die JAR-Dateien im Verzeichnis < JBOSS_HOME>/server/< SERVER_NAME>/deploy/smcfs.ear.
Beispiel:
- Wenn Sie Ihre Datenbank erweitern, erstellen und implementieren Sie die Datei entities.jar und kopieren Sie die JAR-Datei in das Verzeichnis < JBOSS_HOME>/server/< SERVERNAME>/deploy/smcfs.ear.
- Wenn Sie Benutzerschnittstellenressourcen erweitern, erstellen und implementieren Sie die Datei resources.jarund kopieren die JAR-Datei in das Verzeichnis < JBOSS_HOME>/server/< SERVERNAME>/deploy/smcfs.ear.
Kopieren Sie Ihre angepassten Dateien (z. B. Lokalisierungsliteraldateien, JSPs) in das entsprechende Verzeichnis < JBOSS_HOME>/server/< SERVERNAME>/deploy/smcfs.ear/smcfs.war.
Starten Sie den Anwendungsserver erneut.
Nach der Implementierung können Sie die Dateien ändern, die in das < JBOSS_HOME>/server/< SERVERNAME>/deploy kopiert wurden. Wenn Sie beispielsweise einen angepassten Code erweitern, der als Teil der Datenbankerweiterungen geschrieben wurde, können Sie den erweiterten angepassten Code direkt in das entsprechende Verzeichnis im Verzeichnis < JBOSS_HOME>/server/< SERVER_NAME>/deploy zum Testen verschieben. JBoss identifiziert die Änderungen und stellt die Anwendung erneut bereit (Implementierung während des Betriebs).

Testen Sie Ihre Anpassungen anhand der folgenden JBoss-Standards für den Testmodus "Implementierung während des Betriebs", die in der nachstehenden Tabelle beschrieben werden:

Wenn Sie ändern...	In diesen Dateien...	Dann...
Startparameter	Eigenschaften	Starten Sie JBoss erneut.
Erweiterbarkeit der Benutzerschnittstelle	JSP, JavaScript, CSS, Thema XML	Laden Sie diese Dateien dynamisch.
Lokalisierungsliterale	Alerts und Lokalisierungspaketdateien	Starten Sie JBoss erneut.
Datenbankerweiterungen	Entitäts-XMLs	Erstellen Sie die Datei entities.jar erneut und schließen Sie die JAR-Datei in das Verzeichnis `JBOSS_HOME`/server/`SERVER_NAME`/deploysmcfs.ear ein. Starten Sie anschließend JBoss erneut.
APIs und andere Vorlagendateien	Vorlagen-XMLs	Erstellen Sie die Datei resources.jar erneut und schließen Sie die JAR-Datei in das Verzeichnis `JBOSS_HOME`/server/`SERVER_NAME`/deploy/smcfs.ear ein. Starten Sie anschließend JBoss erneut.
Anwendungskonfigurationsdateien	web.xml, application.xml und Eigenschaftendateien	Starten Sie JBoss erneut.