Nach dem Upgrade des Application Engine-Servers von Version 3.5 müssen Sie JBoss Application Server für die Arbeit mit Application Engine konfigurieren. Sie können auch Änderungen für optionale Modi wie SSO (Single Sign-on) konfigurieren.
Wichtig: In einer Hochverfügbarkeitsumgebung müssen Sie die Upgrades für
Application Engine auf dem Anwendungsserver auf allen Knoten konfigurieren.
So konfigurieren Sie JBoss Application Server für Application Engine:
- Stoppen Sie JBoss Application Server, falls der Server aktiv ist.
- Erstellen Sie je nach Plattform eine Backup-Kopie der Datei run.conf und des Startscripts:
Option |
Bezeichnung |
UNIX® |
run.sh |
Windows® |
run.bat |
- Bearbeiten Sie die Java-Einstellungen in der Datei run.conf.
- Fügen Sie eine Zeile hinzu, um den Pfad zu dem von JBoss Application Server bereitgestellten JDK (Java Development Kit) anzugeben, wie in folgendem Beispiel gezeigt (Windows): set
JAVA_HOME=C:\Programme\Java\jdk1.5.0_06
Wichtig: Falls Sie ein anderes JDK als Version 1.5.0 haben, geben Sie Ihre Version anstelle der oben aufgeführten Version an.
- Aktualisieren Sie die JAVA_OPTS-Speichereinstellungen.
Durch Anpassen dieser Einstellung wird verhindert, dass ein Speicherplatzproblem beim Anwendungsserver auftritt. Wäre nicht genügend Hauptspeicher verfügbar, könnten sich die Benutzer nicht mehr an Workplace anmelden.
Ändern Sie in der Zeile JAVA_OPTS die Werte -Xms und -Xmx für Ihre Konfiguration.
Beispiel
(Windows): set JAVA_OPTS=%JAVA_OPTS% -Xms 128m -Xmx 512
m
Beachten Sie die Empfehlungen Ihres Anwendungsserveranbieters in Bezug auf die Anfangs- und Maximalwerte für die Größe des Heapspeichers. IBM spezifische Empfehlungen finden Sie in IBM® FileNet P8 Performance Tuning
Guide.
- (Nur für Sun JVM-Benutzer) Setzen Sie wie folgt den Wert für MaxPermSize in JAVA_OPTS auf 128m:
UNIX
JAVA_OPTS=%JAVA_OPTS%
-Xms128m -Xmx512m -XX:MaxPermSize=128m
Windows
set JAVA_OPTS=%JAVA_OPTS%
-Xms128m -Xmx512m -XX:MaxPermSize=128m
Durch die Erhöhung dieses Werts wird verhindert, dass Speicherfehler auftreten, die JBoss Application Server stoppen können.
- Wenn Ihr Anwendungsserver die IBM Java Virtual Machine (JVM) verwendet, bearbeiten Sie die Variable JAVA_OPTS in der Datei run.conf direkt nach der Zeile des vorherigen Unterschritts. Diese Änderung von JAVA_OPTS bewirkt eine Verbesserung der Leistung.
- UNIX
- Suchen Sie die folgende Zeile in der Datei run.conf:
JAVA_OPTS="$JAVA_OPTS
und ändern Sie sie wie folgt (ohne Zeilenumbrüche):
JAVA_OPTS="$JAVA_OPTS
-Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5"
- Windows
- Suchen Sie die folgende Zeile in der Datei run.conf:
set
JAVA_OPTS=%JAVA_OPTS%
und ändern Sie sie wie folgt (ohne Zeilenumbrüche):
set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2
-Dfilenet.pe.peorb.pool.max=5
- Speichern Sie die Änderungen.
- Konfigurieren Sie die JAAS-Anmeldung.
Fügen Sie einen der folgenden Einträge direkt nach dem Eintrag
"$JAVA" $JAVA_OPTS
(UNIX) bzw. "%JAVA%" %JAVA_OPTS (Windows) in der Datei run.sh
(für UNIX) oder run.bat (für Windows) hinzu.
Wichtig: Geben Sie den jaas_login-Eintrag in einer einzelnen Zeile ohne Zeilenumbrüche ein. Geben Sie den Eintrag nicht ein, indem Sie ihn aus vorliegender Dokumentation kopieren und einfügen, da verdeckte Formatierungen zu Problemen im Zusammenhang mit dem Eintrag führen können. Geben Sie den Eintrag stattdessen manuell ein.
Tipp: Abhängig von der Version Ihrer Clientinstallationen, oder wenn Sie einen benutzerdefinierten Pfad für die Installation verwendet haben, kann Ihr Pfad von dem hier angegebenen Pfad geringfügig abweichen. Prüfen Sie die Speicherposition der Datei, bevor Sie den Pfad eingeben.
- UNIX
"$JAVA" $JAVA_OPTS
-Djava.security.auth.login.config=
"/opt/FileNet/AE/CE_API/config/jaas.conf.JBoss"
"-Djava.endorsed.dirs=$JBOSS_ENDORSED_DIRS" -classpath
"$JBOSS_CLASSPATH" org.jboss.Main $@
- Windows
"%JAVA%" %JAVA_OPTS%
"-Djava.security.auth.login.config=C:\Program
Files\FileNet\AE\CE_API\config\jaas.conf.JBoss"
"-Djava.endorsed.dirs=%JBOSS_ENDORSED_DIRS%" -classpath
"%JBOSS_CLASSPATH%" org.jboss.Main %*
- Speichern und schließen Sie die Datei run.sh bzw.
run.bat.
- Konfigurieren Sie LDAP-Einstellungen von Application Engine so, dass sie genau mit den Content Engine-Einstellungen übereinstimmen.
- Öffnen Sie auf dem Application Engine-Server die Datei login-config.xml (inJBoss-Ausgangsverzeichnis/server/Servername/conf) zum Bearbeiten.
- Setzen Sie den Eintrag <application-policy name="FileNet"> auf den entsprechenden
Eintrag in der Datei login-config.xml auf dem
Content Engine-Server.
- Setzen Sie den Eintrag <application-policy name="FileNetP8Engine"> auf den entsprechenden
Eintrag in der Datei login-config.xml auf dem
Content Engine-Server.
- Kopieren Sie den neuen Eintrag <application-policy name="FileNetP8Engine"> und fügen Sie ihn direkt über dem von Ihnen kopierten Eintrag ein (<application-policy
name="FileNetP8Engine">).
- Ändern Sie die erste Instanz von <application-policy
name="FileNetP8Engine"> in <application-policy
name="FileNetP8">.
- Speichern Sie die Änderungen in der Datei login-config.xml auf dem
Application Engine-Server.
- Starten Sie JBoss Application Server erneut.
- Legen Sie die Berechtigungen für den Benutzer fest, der den Anwendungsserver ausführt.
Für Windows ist dies nur für NTFS-formatierte Partitionen erforderlich.
Falls der Benutzer, der den Anwendungsserver später ausführen wird, ein anderer Benutzer ist, als der, der Application Engine installiert hat, müssen Sie dem Benutzer die Lese- und Schreibberechtigungen für den Ordner erteilen, in dem Sie Application Engine (AE-Installationspfad) installiert haben.
- (Optional) Inaktivieren Sie die JBoss Application Server-Protokollierung.
Im Entwicklungsmodus erstellt JBoss Application Server zahlreiche Protokollnachrichten zu HTTP Access, "INFO", "DEBUG" und "TRACE".
Dies kann ein nicht erwartetes Verhalten in der implementierten IBM FileNet-Software verursachen.
Mithilfe der folgenden Prozedur können Sie diesen Typ der übermäßigen JBoss Application Server-Protokollierung begrenzen.
Ist die Protokollierung inaktiviert, werden weiterhin Fehlernachrichten in der JBoss Application Server-Konsole angezeigt.
- Öffnen Sie die Datei log4j.xml (in JBOSS-Ausgangsverzeichnis/server/Servername/conf/log4j.xml)
zum Bearbeiten.
- Ändern Sie alle Schwellenwerte und Prioritätswerte von "INFO", "DEBUG",
oder "TRACE" in "ERROR".
- Löschen Sie den Abschnitt "Preserve messages in
a local file" bzw. setzen Sie ihn auf Kommentar, um das Serverprotokoll zu inaktivieren.
- Öffnen Sie die Datei jboss-service.xml mit einem Texteditor und löschen Sie den Abschnitt "Access logger" oder setzten Sie ihn auf Kommentar, um das HTTP-Zugriffsprotokoll zu inaktivieren.
Position der Datei jboss-service.xml:
JBoss-Ausgangsverzeichnis/server/Servername/deploy/jbossweb-tomcat55.sar/META-INF
- Öffnen Sie die Datei web.xml zum Bearbeiten und ändern Sie logVerbosityLevel in "FATAL".
Position der Datei web.xml:
JBoss-Ausgangsverzeichnis/server/Servername/deploy/jbossweb-tomcat55.sar/conf
- Starten Sie JBoss Application Server erneut.