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:
- Aplikační server WebSphere Application Server je již nainstalován.
- Je vytvořena databáze a soubor teamserver.properties je aktualizován podle nastavení databáze.
- Povolení přihlášení bez rozlišení velkých a malých písmen (volitelně): Pokud metoda ověření u aplikačního serveru umožňuje přihlášení bez rozlišení malých
a velkých písmen, můžete přimět aplikaci Jazz, aby toto přihlášení přijala také. Povolení přihlášení bez rozlišení velikosti písmen lze zapnout prostřednictvím
vlastnosti "Použít porovnání ID uživatele bez rozlišení velkých a malých písmen"
na stránce Rozšířené vlastnosti v administrativním webovém UI. Výchozí volba je beze změny; administrátoři musí explicitně tuto
vlastnost přepsat, a tak přihlášení bez rozlišování velkých a malých písmen
povolit.
- Volba zabezpečení Java™ 2
by měla být vypnuta.
Pokud je tato volba na serveru WebSphere Application Server zapnuta, soubor .war serveru Jazz Team
Server se nespustí.
- Ujistěte se, že je zaškrtnuto nastavení zabezpečení serveru WAS "Při přístupu k nechráněnému identifikátoru URI používat dostupná ověřovací data". Pokud používáte konzolu WAS Integrated Solutions Console, můžete postupovat takto:
- Přejděte na volbu Zabezpečení -> Bezpečná administrace, aplikace a infrastruktura -> Zabezpečení webu - Obecná nastavení. (V případě aplikačního serveru WAS 7.0.0.7 přejděte na volbu Zabezpečení -> Globální zabezpečení -> Zabezpečení webu a SIP -> Obecná nastavení.)
- Zaškrtněte políčko "Při přístupu k nechráněnému identifikátoru URI používat dostupná ověřovací data".
- Server Jazz Team
Server obsahuje
soubory nezbytné ke spuštění kompletního serveru založeného na serveru Apache Tomcat. K instalaci WebSphere potřebujete pouze některé ze souborů serveru
Jazz Team
Server a ty byste měli umístit do adresáře na vašem počítači se serverem WebSphere. V dalším pokynech se na tento adresář odkazuje jako na instalační adresář
Jazz Team
Server, nebo krátce jen instalační_adresář_Jazz. V tomto adresáři použijte:
- Soubor instalační_adresář_Jazz/server/tomcat/webapps/jazz.war.
- Adresář instalační_adresář_Jazz/server/update-site.
- Adresář instalační_adresář_Jazz/server/conf.
- Výchozí databázi úložiště v adresáři instalační_adresář_Jazz/repositoryDB.
- Nástroje aplikace Repository Tools v adresáři instalační_adresář_Jazz/repotools.
- Adresář instalační_adresář_Jazzserver/license-update-site.
- Adresář instalační_adresář_Jazz/server/nl1-update-site.
- Adresář instalační_adresář_Jazz/server/nl2-update-site.
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
- 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).
- 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/.
- 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:
- Klepněte na volbu .
- Klepněte na volbu server1.
- Klepněte na volbu .
- Klepněte na volbu Java Virtual Machine.
- Přidejte hodnotu 100 pod Počáteční halda.
- Přidejte hodnotu 1000 pod Maximální velikost haldy.
- Klepněte na volbu Použít.
- 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.
- 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.
- 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.
- Klepnutím na tlačítko Uložit se nastavení uloží přímo do hlavní konfigurace.
- 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.
- Otevřete administrativní konzolu vašeho aplikačního serveru WebSphere Application Server.
- Klepněte na volbu . (V případě aplikačního serveru WebSphere Application Server verze 7.0.0.7 a pozdější klepněte na volbu .)
- Pod Cesta k nové aplikaci klepněte na volbu Lokální systém souborů.
- Pod Úplná cesta zadejte:
instalační_adresář_Jazz/server/tomcat/webapps/jazz.war
- 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.
- Klepněte na tlačítko Další a pokračujte zbývajícími kroky průvodce Instalovat novou aplikaci.
- Klepněte na tlačítko Dokončit.
- 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.
- Klepněte na volbu .
- 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.
- Vraťte se na stránku Instalovat novou aplikaci.
- 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.
- Dále klepejte na tlačítko Další, dokud neuvidíte
obrazovku Souhrn, a potom klepnutím na tlačítko Dokončit
nainstalujte novou aplikaci.
- 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.
- Klepněte na volbu .
- 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