Design Management Server auf WebSphere Application Server implementieren

Alternativ zum Apache Tomcat-Server, der mit dem Server geliefert wird, können Sie Design Management Server auf WebSphere Application Server implementieren. Die Anweisungen basieren auf WebSphere Application Server Version 8.0 mit geringfügigen Varianten für Version 7.0 und 6.1.

Vorbereitende Schritte

Stellen Sie sicher, dass Ihre Umgebung ordnungsgemäß eingerichtet ist.

Vorgehensweise

  1. Geben Sie in der WebSphere Application Server-Administrationskonsole die folgenden Sicherheitseinstellungen an:
    1. Inaktivieren Sie die Java 2-Sicherheit, indem Sie auf Sicherheit > Globale Sicherheit klicken und das Kontrollkästchen Java-2-Sicherheit verwenden, um den Anwendungszugriff auf lokale Ressourcen zu beschränken abwählen.
    2. Stellen Sie im Feld Aktuelle Realm-Definition sicher, dass der richtige Sicherheitsrealm konfiguriert und als aktueller Realm festgelegt ist. Wählen Sie anschließend die Kontrollkästchen Verwaltungssicherheit aktivieren und Anwendungssicherheit aktivieren aus.
    3. Klicken Sie auf Sicherheit > Globale Sicherheit > Web- und SIP-Sicherheit > Allgemeine Einstellungen und wählen Sie das Kontrollkästchen Verfügbare Authentifizierungsdaten beim Zugriff auf einen ungeschützten URI verwenden aus.
  2. Geben Sie die JVM-Einstellungen (JVM - Java Virtual Machine) für WebSphere Application Server an:
    1. Klicken Sie in der Administrationskonsole auf Server > Servertypen > WebSphere-Anwendungsserver und klicken Sie dann auf Ihren Server. Standardmäßig hat der Server den Namen server1.
    2. Klicken Sie unter Serverinfrastruktur auf Java- und Prozessverwaltung > Prozessdefinition.
    3. Klicken Sie unter Weitere Eigenschaften auf Java Virtual Machine.
    4. Geben Sie im Feld Anfangsgröße des Heap-Speichers den Wert 100 an.
    5. Geben Sie im Feld Maximale Größe des Heap-Speichers die maximale Speichergröße für den Server in MB an. Für 64-Bit-Computer geben Sie die Speichergröße an, die Ihrer Umgebung entspricht, zum Beispiel 4096 für einen Speicher von 4 GB.
    6. Nur für Solaris-Betriebssysteme: Fügen Sie im Feld Generische JVM-Argumente die Angabe -XX:MaxPermSize=384m hinzu. Weitere Informationen zur Konfiguration einer Solaris-Umgebung für WebSphere Application Server finden Sie in Kapitel 2 des Redbooks IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System.
    7. Klicken Sie auf Apply.
    8. Klicken Sie auf der Seite Java Virtual Machine unter Weitere Eigenschaften auf Angepasste Eigenschaften.
    9. Klicken Sie auf Neu und definieren Sie die Eigenschaft JAZZ_HOME, die die Position von Konfigurationsdateien für Design Management Server, einschließlich der Ordner jts und dm, angibt.
      Diese Eigenschaft verwendet einen URI und keinen einfachen Dateipfad und beginnt immer mit der Zeichenfolge file:///. Auf einem Windows-System gilt die folgende Standardposition:
      file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf
      Auf einem Linux-System gilt die folgende Standardposition:
      file:///opt/ibm/JazzTeamServer/server/conf
      Anmerkung: Verwenden Sie in Dateipfaden keine Leerzeichen, um Probleme zu vermeiden. Für Ordner unter Programme in 32-Bit-Installationen von Windows können Sie PROGRA~1 verwenden. Für Ordner unter Program Files (x86) in 64-Bit-Installationen von Windows können Sie PROGRA~2 verwenden.
    10. Klicken Sie erneut auf Neu und geben Sie eine Eigenschaft mit dem Namen log4j.configuration an. Verwenden Sie als Wert die Speicherposition der Datei startup_log4j.properties. Diese Eigenschaft verwendet das gleiche Format wie die Eigenschaft JAZZ_HOME. In den meisten Fällen befindet sich diese Datei im Ordner JAZZ_HOME. Auf einem Windows-System gilt der folgende Standardwert:
      file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf/startup_log4j.properties
      Auf einem Linux-System gilt der folgende Standardwert:
      file:///opt/ibm/JazzTeamServer/server/conf/startup_log4j.properties
      Anmerkung: Die Einstellungen in der Datei startup_log4j.properties werden in den frühen Phasen des Startprozesses verwendet, um Nachrichten an die Datei SystemOut.log zu senden. Nach den frühen Phasen wechselt jede Anwendung zur Verwendung der anwendungsspezifischen Einstellung aus der Datei server/conf/<anwendungskontext>/log4j.properties.
    11. Klicken Sie erneut auf Neu und geben Sie eine Eigenschaft mit dem Namen java.awt.headless mit dem Wert true an.
    12. Klicken Sie erneut auf Neu und geben Sie eine Eigenschaft mit dem Namen org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin mit dem Wert true an.
    13. Wenn Sie eine Oracle-Datenbank verwenden, klicken Sie erneut auf Neu und geben Sie eine Eigenschaft mit dem Namen ORACLE_JDBC_DRIVER_FILE mit der Position der Datei ojdbc6.jar an.
    Die angepassten Eigenschaften sehen in etwa wie in der folgenden Abbildung aus. Beachten Sie, dass außer den Eigenschaften, die Sie hinzufügen, standardmäßig auch einige andere Eigenschaften vorhanden sind.
    Ein Beispiel für die Eigenschaften für die Java Virtual Machine
  3. Speichern Sie die Änderungen in der Masterkonfiguration und starten Sie WebSphere Application Server erneut.
    Jetzt ist der Server für die Implementierung der Anwendungsdateien für Design Management Server bereit.
    Anmerkung: Wenn auf einem UNIX- oder Linux-System WebSphere Application Server in einer Nicht-Root-Umgebung installiert ist, muss der Benutzer, der Design Management Server installiert, über Lese- und Schreibzugriff auf das Installationsverzeichnis und alle zugehörigen Unterverzeichnisse verfügen.
  4. Installieren Sie die Jazz Team Server-Anwendung:
    1. Klicken Sie in der Administrationskonsole auf Anwendungen > Neue Anwendung > Neue Unternehmensanwendung. (In WebSphere Application Server 6.1 klicken Sie auf Anwendungen > Neue Anwendung installieren.)
    2. Klicken Sie unter Pfad der neuen Anwendung auf Durchsuchen, um den Speicherort für die Datei jts.war anzugeben und klicken Sie dann auf Weiter. Wenn Sie Apache Tomcat bei der Installation von Design Management Server nicht installiert haben, ist die Standardposition dieser Datei installationsverzeichnis/server/webapps. Wenn Sie Tomcat installiert haben, ist die Standardposition installationsverzeichnis/server/tomcat/webapps.
    3. Klicken Sie unter Wie soll die Anwendung installiert werden? auf Fast Path und anschließend auf Weiter.
    4. Akzeptioeren Sie auf der Seite Schritt 1: Installationsoptionen auswählen die Standardoptionen und klicken Sie auf Weiter.
    5. Wählen Sie auf der Seite Schritt 2: Module zu Servern zuordnen das Kontrollkästchen neben jts.war aus, überprüfen Sie, ob der Zielserver oder -cluster korrekt ist, und klicken Sie auf Weiter.
    6. Wählen Sie auf der Seite Schritt 3: Virtuelle Hosts für Webmodule zuordnen das Kontrollkästchen neben jts.war aus und klicken Sie auf Weiter.
    7. Geben Sie auf der Seite Schritt 4: Kontextstammverzeichnisse für Webmodule zuordnen für Kontextstammverzeichnis (bzw. 'Stammkontext') den Wert /jts an und klicken Sie auf Weiter.
    8. Klicken Sie auf Fertigstellen.
  5. Wiederholen Sie die Installationsschritte für die folgenden WAR-Dateien und die entsprechenden Kontextstammverzeichnisse:
    Option Bezeichnung
    dm.war /dm
    admin.war /admin
    vvc.war /vvc
    rdmhelp.war /rdmhelp
    clmhelp.war /clmhelp
  6. Ordnen Sie die Sicherheitsrollen für die Jazz Team Server-Anwendung den Benutzern und Gruppen in Ihrem Sicherheitsrealm zu. Die Einstellung der Sicherheit geht über den Rahmen dieser Task hinaus. In den meisten Fällen, in denen Ihr globaler Sicherheitsrealm mit einer LDAP-Registry arbeitet, ordnen Sie Gruppen im LDAP-Registry den folgenden Sicherheitsrollen für die Anwendung zu:
    • JazzAdmins
    • JazzDWAdmins
    • JazzProjectAdmins
    • JazzGuests
    • JazzUsers
    1. Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen > jts_war.
    2. Klicken Sie unter Detaileigenschaften auf Zuordnung von Sicherheitsrollen zu Benutzern/Gruppen. Diese Seite zeigt die Benutzergruppen für Design Management Server an, die Sie Benutzern oder Gruppen in Ihrem Sicherheitsrealm.
    3. Wählen Sie eine Rolle aus und klicken Sie dann auf Gruppen zuordnen, um diese Rolle einer Gruppe in Ihrem Sicherheitsrealm zuzuordnen.
      Anmerkung: Aktivieren Sie nicht die Option Alle Authentifizierten?.
  7. Überprüfen Sie, ob die Anwendungen erfolgreich installiert wurden und speichern Sie anschließend die Änderungen in der Masterkonfiguration für WebSphere Application Server.
  8. Nachdem Sie die Masterkonfiguration gespeichert haben, beenden Sie den Server und starten ihn anschließend neu.
  9. Klicken Sie in der WebSphere Application Server-Administrationskonsole auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen, um zu bestätigen, dass alle Anwendungen aktiv sind.

Ergebnisse

Neben den Anwendungen werden grüne Pfeile angezeigt, die besagen, dass die Anwendungen ordnungsgemäß gestartet wurden. Die Seite Unternehmensanwendungen sieht in etwa wie in der folgenden Abbildung aus:
Grüne Pfeile geben an, dass die Anwendungen ordnungsgemäß gestartet wurden.

Nächste Schritte

Jetzt können Sie Design Management Server wie im Abschnitt Design Management Server installieren und konfigurieren beschrieben konfigurieren.

Feedback