Konfigurieren des WebSphere Application Servers zum Ausführen vonBuild Forge®-Anwendungen

Konfigurieren von WebSphere Application Server zum Ausführen der Services- und der Hilfeanwendung.

Informationen zu diesem Vorgang

Führen Sie die Schritte dieses Verfahrens in der WebSphere Application Server-Administrationskonsole aus.
Unter WebSphere Application Server Version 8.0 hat sich die Benutzerschnittstelle der WebSphere Application Server-Administrationskonsole leicht verändert. Die unten aufgeführten Anweisungen beziehen sich auf Version 7 und frühere Versionen. Die folgenden Unterschiede der Version 8.0 haben Auswirkungen auf dieses Verfahren:
  • Für den Zugriff auf eine Anwendung klicken Sie auf Anwendungen > Anwendungstypen > Unternehmensanwendungen.
  • Legen Sie nach Auswählen einer Anwendung das Kontextstammverzeichnis fest.
Hinweise:
  • Das Kontrollkästchen Erstellen von MBeans für Ressourcen wird nicht angezeigt.
  • Um Build Forge® auf WAS erneut zu implementieren, löschen Sie die zuvor implementierte Instanz von Build Forge®.

Vorgehensweise

  1. Öffnen Sie die WebSphere Application Server-Administrationskonsole. Die URLs für die Konsole lauten wie folgt:
    • http://<was_host>:<was_port>/ibm/console; Der Standardport ist 9060.
    • https://<was_host>:<was_port>/ibm/console; der Standardport ist 9043. Verwenden Sie diese URL, wenn WebSphere Application Server-Verwaltungssicherheit aktiviert ist.
  2. So konfigurieren Sie die Unterstützung für Ihren JDBC-Treiber:
    1. Erstellen Sie eine neue Variable mit dem Namen RBF_JDBC_DRIVER_PATH. Erstellen Sie die Variable in Umgebung > WebSphere-Variablen. Der Bereich der Variablen sollte den WebSphere Application Server-Knoten und den Server umfassen. Legen Sie den Wert auf das Verzeichnis fest, das die JAR-Dateien des Datenbanktreibers enthält.
    2. Speichern Sie die an der Hauptkonfiguration vorgenommene Änderung.
    3. Stoppen und starten Sie WebSphere Application Server erneut, um die neue Variable verfügbar zu machen.
    4. Erstellen Sie eine neue gemeinsam genutzte Bibliothek mit dem Namen RBF_JDBC_LIBRARY.

      Erstellen Sie die Bibliothek in Umgebung > Gemeinsam genutzte Bibliotheken. Fügen Sie die Namen der JAR-Dateien für den JDBC-Einheitentreiber mithilfe der soeben erstellten Variablen RBF_JDBC_DRIVER_PATH hinzu. Sind mehrere JAR-Dateien aufzulisten, setzen Sie jede JAR-Datei in eine eigene Zeile (wie nachstehend bei DB2 angegeben).

      Das folgende Beispiel bezieht sich auf einen MySQL-Datenbanktreiber:

      ${RBF_JDBC_DRIVER_PATH}\mysql-connector-java-5.0.5-bin.jar

      Dieses Beispiel betrifft DB2:

      ${RBF_JDBC_DRIVER_PATH}\db2jcc.jar
      ${RBF_JDBC_DRIVER_PATH}\db2jcc_license_cu.jar

      Verwenden Sie unter UNIX oder Linux in vorstehenden Beispielen einen Schrägstrich (/) anstelle eines umgekehrten Schrägstrichs (\).

    5. Speichern Sie die an der Hauptkonfiguration vorgenommene Änderung.
  3. Wenn WebSphere Application Server unter Solaris implementiert wird, muss die JVM des WAS-Anwendungsservers aktualisiert werden, damit DevPollSelectorProvider für den E/A-Prozess verwendet werden kann.

    Wechseln Sie zur WAS-Managementkonsole. Öffnen Sie Servers > Servertypen > WebSphere Application Server > Server1 > Java- und Prozessmanagement > Prozessdefinition > Java Virtual Machine > Generische JVM-Argumente.

    Der Inhalt der generischen JVM-Argumente lautet wie folgt:
    -Djava.nio.channels.spi.SelectorProvider=sun.nio.ch.DevPollSelectorProvider 

    Der Standardservername ist Server1. Wenn Ihr Anwendungsserver, auf dem Build Forge® implementiert ist, über einen anderen Namen verfügt, verwenden Sie diesen Namen.

  4. Installieren Sie die WAR-Datei für die Build Forge®-Anwendung.
    1. Öffnen Sie Anwendungen > Unternehmensanwendungen.
    2. Klicken Sie auf Installieren.
    3. Navigieren Sie zur Datei jas.war. Verwenden Sie /jas als Kontextstammverzeichnis.
      • Windows-Systeme:
        <bf-installationsverzeichnis>\PrepForExternal\jas.war
      • UNIX- und Linux-Systeme:
        <bf-installationsverzeichnis>/Platform/PrepForExternal/jas.war
    4. Klicken Sie auf Weiter und heben Sie die Markierung für das Kontrollkästchen MBeans für Ressourcen erstellen auf, sofern es ausgewählt ist.
    5. Klicken Sie auf Weiter und anschließend auf Fertig stellen.
    6. Klicken Sie am Ende des Installationstexts auf Speichern.
  5. Installieren Sie die WAR-Datei für die Build Forge®-Hilfe.
    1. Klicken Sie auf 'Anwendungen > Unternehmensanwendungen'.
    2. Klicken Sie auf Installieren.
    3. Zeigen Sie die Datei BuildForgeHelp.war im Build Forge®-Installationsverzeichnis an. Verwenden Sie /BuildForgeHelp als Kontextstammverzeichnis.
    4. Klicken Sie auf Weiter und heben Sie die Markierung für das Kontrollkästchen MBeans für Ressourcen erstellen auf, sofern es ausgewählt ist:
    5. Klicken Sie auf Weiter, bis die Schaltfläche Fertig stellen angezeigt wird. Klicken Sie dann auf Fertig stellen.
    6. Klicken Sie unter dem Installationstext auf Speichern.
  6. Legen Sie RBF_JDBC_LIBRARY als Verweis auf die gemeinsam genutzte Bibliothek fest.
    1. Klicken Sie auf Anwendungen > Unternehmensanwendungen.
    2. Klicken Sie auf die Verknüpfung jas.war.
    3. Klicken Sie auf Referenzen auf gemeinsam genutzte Bibliotheken.
    4. Wählen Sie das Feld jas.war aus.
    5. Klicken Sie auf Gemeinsam genutzte Bibliotheken referenzieren.
    6. Fügen Sie RBF_JDBC_LIBRARY zur Liste hinzu.
  7. Legen Sie die Class-Loader-Reihenfolge fest:
    1. Wählen Sie unter Module verwalten jas.war aus und wählen Sie aus dem Dropdown-Menü die Option Reihenfolge der Klassenladeprogramme aus.
    2. Ändern Sie diesen Wert in Mit dem lokalen Klassenlader geladene Klassen zuerst (übergeordnete zuletzt).
  8. Speichern Sie die an der Hauptkonfiguration vorgenommenen Änderungen.
  9. Überprüfen Sie die Build Forge®-Konfigurationsdatei. Vergewissern Sie sich, dass der Eintrag services_url in der Datei auf die richtige URL verweist. Wenn Sie WebSphere Application Server verwenden, muss der Wert für diese Eigenschaft in buildforge.conf wie folgt aussehen: https://<hostname>:9443/jas oder https://<hostname>:9080/jas. Die Datei "buildforge.conf" befindet sich an folgender Speicherposition:
    • Windows-Systeme
      <bf-installationsverzeichnis>\
    • UNIX- und Linux-Systeme
      <bf-installationsverzeichnis>/Plattform/
  10. Fügen Sie für UNIX- und Linux-System Ausführungsberechtigungen für alle Dateien im Verzeichnis bin für jas hinzu.

    In diesem Beispiel wird das Profil AppSrv01 verwendet. Ist Ihr Profilname nicht AppSrv01, verwenden Sie Ihren Profilnamen.

    chmod -R 755 <WAS-install>/AppServer/profiles/AppSrv01/installedApps/<knoten>/jas_war.ear/jas.war/bin
  11. Aktualisieren Sie die Bibliotheksvariable PATH, sodass die folgenden Verzeichnisse enthalten sind:
    • Windows-System, PATH enthält:
      <bf-installationsverzeichnis>\token_libs
    • AIX-Systeme, LIBPATH enthält:
      <bf-installationsverzeichnis>/Platform/token_libs
    • Linux/Solaris, LD_LIBRARY_PATH enthält:
      <bf-installationsverzeichnis>/Platform/token_libs
  12. Wenn Sie den 64-Bit-Linux- oder WebSphere Application Server verwenden, führen Sie die folgenden Schritte aus, um die bereitgestellten 64-Bit-Bibliotheken zu kopieren:
    1. Benennen Sie die Bibliotheksdatei um.
      • Windows-Systeme: benennen Sie <bf-installationsverzeichnis>\token_libs\rcl_rational.dll in <bf-installationsverzeichnis>\token_libs\rcl_rational.dll.old um.
      • UNIX- und Linux-Systeme: benennen Sie <bf-installationsverzeichnis>/Platform/token_libs/librcl_rational.so in <bf-installationsverzeichnis>/Platform/token_libs/librcl_rational.so.old um.
    2. Kopieren Sie die 64-Bit-Bibliotheksdateien aus token_libs_64 nach token_libs. Verwenden Sie keine Zeilenumbrüche in Befehlen. Sie werden hier lediglich zur besseren Lesbarkeit verwendet.
      • Windows-Systeme
        Kopieren Sie <bf-installationsverzeichnis>\token_libs_64\rcl_rational.dll 
             <bf-installationsverzeichnis>\token_libs\rcl_rational.dll
      • UNIX- und Linux-Systeme
        cp <bf-installationsverzeichnis>/Platform/token_libs_64/librcl_rational.so 
           <bf-installationsverzeichnis>/Platform/token_libs/librcl_rational.so

Feedback