Nastavení produktu WebSphere Application Server

Toto téma popisuje, jak nastavit server Jazz Team Server pro práci s aplikačním serverem WebSphere Application Server. Toto nastavení předpokládá, že instalujete server Jazz Team Server na stejný počítač jako aplikační server Websphere Application Server. Pokyny jsou založeny na aplikačním serveru WebSphere Application Server verze 6.1.0.23. U verze 7.0.0.7 a pozdějších jsou drobné odlišnosti. Tyto odlišnosti jsou poznamenány na příslušných místech v textu.

Než začnete

Než začnete tímto postupem, měly by být splněny níže uvedené podmínky:
Tip: Při použití produktu IBM® Installation Manager k instalaci serveru Jazz Team Server pro použití s produktem Rational Team Concert lze soubory serveru Jazz Team Server instalovat do adresáře webové aplikace. Při instalaci byste neměli instalovat aplikační server Apache Tomcat, který je součástí instalačních souborů; produkt Installation Manager se tak zeptá na adresář webové aplikace a nainstaluje pouze soubory potřebné pro WebSphere. Výchozím adresářem je C:\Program Files\IBM\JazzTeamServer na systému Windows®, resp. /opt/IBM/JazzTeamServer na systému Linux®. Instalační adresář se v tomto postupu označuje jako instalační_adresář_Jazz. Používáte-li produkt IBM Installation Manager k instalaci souborů do adresáře webových aplikací serveru WebSphere Application Server, nemusíte soubory přesunovat ručně, jak je popsáno výše.

Informace o této úloze

Poznámka: Tento dokument neobsahuje informace ke konfiguraci ověřování WebSphere či SSL, neboť se jedná o složitější témata. Podrobné informace o různých volbách ověřování a šifrování pro WebSphere najdete v Informačním centru WebSphere. Další informace viz Informační centrum WebSphere, kde hledejte téma Zabezpečení aplikací a jejich prostředí. Webové uživatelské rozhraní Jazz vyžaduje konfiguraci ověřování, aby bylo možné provádět autorizaci a přizpůsobovat aplikaci.

Postup

  1. Přezkoumejte a aktualizujte umístění databáze v souboru teamserver.properties.
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    Poznámka: Toto je ukázka konfigurace DB2. Soubor teamserver.properties by měl být aktualizován v závislosti na dodavateli databáze (Oracle/MS-SQL).
  2. Ověřte nebo aktualizujte úroveň aplikačního serveru WebSphere Application Server.

    Jazz Team Server vyžaduje WebSphere Application Server verze 6.1 se sadou IBM Java SDK 1.5, včetně kumulativní opravy SR5 nebo novější, nebo WebSphere Application Server verze 7.0 s nainstalovanou verzí minimálně 7.0.0.7. Aktualizace IBM Java SDK 1.5 SR6 je k dispozici na adrese http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Při použití WebSphere verze 6.1 a GA IBM Java SDK začne Jazz po určitém počtu operací vykazovat "chyby proxy".

    Musíte získat odpovídající opravy i-fix pro WebSphere Application Server pro opravy IBM Java SDK 1.5 SR9 nebo IBM Java SDK 1.6 SR4, které jsou nezbytné pro správné fungování produktu IBM Rational Team Concert 2.0. Jinak se některé služby na serveru nemusí správně spustit. Opravy i-fix jsou dostupné v rámci příslušných oprav APAR pro WebSphere Application Server. Pro IBM Java SDK 1.5/WebSphere Application Server 6.1 je určena oprava APAR PK85942 a příslušné soubory je možné stáhnout ze stránky ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/. Před instalací opravy i-fix prostředí JRE nainstalujte minimálně WebSphere Application Server 6.1 s opravnou sadou 19. Pro IBM Java SDK 1.6/WebSphere Application Server 7.0 je určena oprava APAR PK 86771 a příslušné soubory je možné stáhnout ze stránky ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.

  3. Aktualizujte argumenty JVM.

    Server Jazz Team Server vyžaduje specifická nastavení virtuálního počítače Java, na kterém je spuštěn.

    První vlastnost, kterou je nutné nastavit v generických argumentech prostředí JVM je výchozí maximální alokace paměti, za pomoci volby -Xmx. Toto nastavení by mělo být založeno na velikosti týmu podporovaného serverem a kapacity paměti serveru, na kterém je spuštěn Jazz Team Server. Typický středně velký tým může použít hodnotu -Xmx1536M, což je paměť haldy 1536 MB pro procesy serveru Jazz Team Server.

    Druhá vlastnost, kterou je nutné nastavit v generických argumentech prostředí JVM, konkrétně pro produkt Rational Quality Manager, je velikost zásobníku podprocesů. Typická velikost zásobníku pro produkt Rational Quality Manager je -Xss786K.

    Pokud se připojujete k databázi Oracle nebo SQL Server, musíte přidat vlastnost s názvem "ORACLE_JDBC" nebo "SQLSERVER_JDBC". Tuto vlastnost nastavte na absolutní cestu k souboru (nikoli adresu URL) pro příslušné ovladače JDBC.

    Následující příklady zobrazují generické argumenty příkazů JVM pro připojení k databázím Oracle a SQL Server, spolu s výchozí maximální alokací paměti a velikostí zásobníku podprocesů. Nahraďte cestu instalační_adresář_Jazz instalačním adresářem produktu Jazz Team Server.

    -DORACLE_JDBC=instalační_adresář_Jazz\server\oracle -Xmx1536M -Xss768k
    -DSQLSERVER_JDBC=instalační_adresář_Jazz\server\sqlserver -Xmx1536M -Xss768k

    Je zde několik dalších systémových vlastností, které je nezbytné nastavit pro řízení určitých chování systému. Jdou uvedeny níže. Zde jsou specifika nastavení těchto vlastností JVM v administrativní konzole WebSphere Administrative Console. Nahraďte cestu instalační_adresář_Jazz instalačním adresářem produktu Jazz Team Server:

    1. Klepněte na volbu Servery > Aplikační servery.
    2. Klepněte na volbu server1.
    3. Klepněte na volbu Java a Správa procesů > Definice procesu.
    4. Klepněte na volbu Java Virtual Machine.
    5. Přidejte hodnotu 100 pod Počáteční halda.
    6. Přidejte hodnotu 1000 pod Maximální velikost haldy.
    7. Klepněte na volbu Použít.
    8. Klepněte na volbu Protokolování a trasování. Klepněte na volbu Změnit úrovně podrobností protokolu. Produkt Jazz Team Server použije stroj vytváření sestav BIRT. Chcete-li zabránit zápisu informačních položek BIRT do souboru protokolu WebSphere, nastavte úroveň protokolování na severe pro balíky org.eclipse.birt.*. Klepněte na volbu Použít.
    9. Klepněte na volbu Aplikační servery > {název_serveru} > Definice procesu > Java Virtual Machine > Přizpůsobené vlastnosti. Jednou z přizpůsobených vlastností, které je nezbytné přidat, je vlastnost JAZZ_HOME, systémová vlastnost, která určuje místo pro hledání určitých konfiguračních souborů. Tato vlastnost používá místo jednoduché cesty adresu URL, takže by měla být hodnota určena jako file://-style URL.
    10. Přidejte tyto vlastnosti: Klepněte na volbu Nový; zadejte Název a Hodnotu; poté klepněte na tlačítko OK.
      • Název: java.awt.headless Hodnota: true.
      • Název: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Hodnota: true.
      • Název: JAZZ_HOME Hodnota: file:///instalační_adresář_Jazz/server/conf.
    11. Klepnutím na tlačítko Uložit se nastavení uloží přímo do hlavní konfigurace.
    Důležité: Pouze v systému Solaris musíte rovněž přidat tento argument Java příkazového řádku:
    -XX:MaxPermSize=256m
    Další informace viz Kapitola 2, "Konfigurace prostředí Solaris pro WebSphere Application Server" v knize Redbook IBM WebSphere Application Server V6.1 v operačním systému Solaris 10.
  4. Restartujte Websphere, aby se nainstalovala aplikace Jazz.
    V následujících příkladech pro příkazový řádek instalační_adresář_WAS představuje umístění aplikačního serveru WebSphere Application Server na vašem serveru.
    • Na systému Windows je výchozí hodnota instalačního adresáře WebSphere:
      C:\Program Files\IBM\WebSphere\AppServer
      Na systému Windows můžete server restartovat pomocí těchto příkazů:
      cd instalační_adresář_WAS\bin 
      stopServer.bat server1 [u zabezpečeného serveru použijte navíc: -username {uživatel_LDAP} -password {heslo_LDAP}] 
      startServer.bat server1
    • Na systému Linux je výchozí hodnota instalačního adresáře WebSphere:
      /opt/IBM/WebSphere/AppServer
      Na systému Linux můžete server restartovat pomocí těchto příkazů:
      cd instalační_adresář_WAS/bin 
      ./stopServer.sh server1 [u zabezpečeného serveru použijte navíc: -username {uživatel_LDAP} -password {heslo_LDAP}] 
      ./startServer.sh server1
    1. Otevřete administrativní konzolu vašeho aplikačního serveru WebSphere Application Server.
    2. Klepněte na volbu Aplikace > Instalovat novou aplikaci. (V případě aplikačního serveru WebSphere Application Server verze 7.0.0.7 a pozdější klepněte na volbu Aplikace > Nová aplikace > Nová podniková aplikace.)
    3. Pod Cesta k nové aplikaci klepněte na volbu Lokální systém souborů.
    4. Pod Úplná cesta zadejte:
      instalační_adresář_Jazz/server/tomcat/webapps/jazz.war
    5. Nastavte Kontextový kořenový adresář na /jazz a klepněte na tlačítko Další.
      Poznámka: V případě aplikačního serveru WebSphere Application Server verze 7.0.0.7 a novější se tento krok objeví ke konci instalace.
    6. Klepněte na tlačítko Další a pokračujte zbývajícími kroky průvodce Instalovat novou aplikaci.
    7. Klepněte na tlačítko Dokončit.
    8. Ověřte, že aplikace jazz_war byla nainstalována, a klepnutím na tlačítko Uložit uložte změny přímo do hlavní konfigurace.
    9. Klepněte na volbu Aplikace > Podnikové aplikace.
    10. Vyberte rámeček vedle jazz_war; klepněte na volbu Spustit.

      Měla by se zobrazit zelená šipka na znamení toho, že aplikace byla úspěšně spuštěna.

      Poznámka: Zbývající kroky jsou pouze pro produkt Rational Quality Manager.
    11. Vraťte se na stránku Instalovat novou aplikaci.
    12. Přejděte do umístění souboru help.war v lokálním systému souborů a vyberte soubor. Zadejte kontextový kořenový adresář jako /help a klepněte na tlačítko Další.
      Poznámka: Soubor help.war naleznete v cestě instalační_adresář_Jazz\server\tomcat\webapps\help.war.
    13. Dále klepejte na tlačítko Další, dokud neuvidíte obrazovku Souhrn, a potom klepnutím na tlačítko Dokončit nainstalujte novou aplikaci.
    14. Ověřte si, že byla aplikace help_war nainstalována, a klepnutím na tlačítko Uložit uložte změny do souboru hlavní konfigurace.
    15. Klepněte na volbu Aplikace > Podnikové aplikace.
    16. Vyberte volbu help_ war a klepněte na tlačítko Spustit.

Jak pokračovat dále

Pokud jste uživatel produktu Rational Team Concert, pokračujte tématem Spuštění průvodce nastavením. V případě produktu Rational Quality Manager pokračujte tématem "Konfigurace LDAP na serveru WebSphere Application Server" a poté tématem "Spuštění průvodce nastavením serveru Jazz Team Server".

Další informace o tomto tématu naleznete v následujících odkazech:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ


Váš názor