Ez a témakör leírja, hogy hogyan állíthatja
be a
Jazz
Team Server
alkalmazás és a
WebSphere
Application Server együttműködését. A beállítás feltételezi, hogy a
Jazz
Team Server
terméket és a WebSphere Application Servert ugyanarra a számítógépre
telepíti. Az útmutató a WebSphere
Application Server 6.1.0.23-as verziójához készült.
A 7.0.0.7-es és újabb verzióknál kisebb eltérések vannak. Ezeket az
eltéréseket a szöveg a megfelelő helyeken jelzi.
Mielőtt elkezdené
A lépések megkezdése előtt teljesülnie kell a
következőknek:
- A WebSphere
Application Server már telepítve van.
- Az adatbázist létrehozta, és a
teamserver.properties fájlban szerepelnek az
adatbázis beállításai.
- Kis- és nagybetűket nem megkülönböztető bejelentkezés engedélyezése
(nem kötelező): Ha az alkalmazáskiszolgáló hitelesítési módja lehetővé
teszi a kis- és nagybetűket nem megkülönböztető bejelentkezést, akkor ez
beállítható a Jazz alkalmazásban is. A kis- és nagybetűket nem
megkülönböztető bejelentkezés az adminisztrátori webes felhasználói
felület Speciális beállítások lapjának "Felhasználói azonosító egyeztetése
a kis- és nagybetűk megkülönböztetése nélkül" tulajdonságán keresztül
állítható be. A beállítás alapértelmezés szerint nincs bekapcsolva. A
rendszergazdának kifejezetten felül kell bírálnia ezt a tulajdonságot,
hogy engedélyezze a kis- és nagybetűket nem megkülönböztető
bejelentkezést.
- A
Java™ 2
biztonsági beállítást ki kell kapcsolni.
Ha ez a beállítás be van kapcsolva a WebSphere Application Serverben,
akkor meghiúsítja a
Jazz
Team Server
.war webalkalmazás indítását.
- Győződjön meg róla, hogy "Az elérhető hitelesítési adatok használata
nem védett URI elérésekor" WAS biztonsági beállítás be van jelölve. Ha a
WAS integrált megoldások konzolját használja, akkor ezt a következőképpen
teheti meg:
- Nyissa meg a Biztonság -> Biztonságos adminisztráció, alkalmazások
és infrastruktúra -> Webes biztonság - Általános beállítások lapot. (A
WAS 7.0.0.7-es verziója esetén nyissa meg a Biztonság -> Globális
biztonság -> Webes és SIP biztonság -> Általános beállítások lapot.)
- Jelölje be "Az elérhető hitelesítési adatok használata nem védett
URI elérésekor" jelölőnégyzetet.
- A
Jazz
Team Server
minden olyan fájlt tartalmaz, amely egy teljes Apache Tomcat alapú
kiszolgáló futtatásához szükséges. A
WebSphere
telepítéshez a
Jazz
Team Server
fájljainak egy részére van csak szüksége. Ezeket a
WebSphere
kiszolgáló számítógépének egyik könyvtárába kell helyeznie. A további
útmutatások a
Jazz
Team Server
telepítési könyvtáraként, vagy röviden
JazzTelepítésiKönyvtárként
hivatkoznak erre. Ebből a könyvtárból a következőkre van szükség:
- A
JazzTelepítésiKönyvtár/server/tomcat/webapps/jazz.war
fájl.
- A
JazzTelepítésiKönyvtár/server/update-site
könyvtárra.
- A
JazzTelepítésiKönyvtár/server/conf
könyvtárra.
- A
JazzTelepítésiKönyvtár/repositoryDB
könyvtárban található alapértelmezett lerakat-adatbázisra.
- A
JazzTelepítésiKönyvtár/repotools
könyvtárban található lerakateszközökre.
- A
JazzTelepítésiKönyvtár/server/license-update-site
könyvtárra.
- A
JazzTelepítésiKönyvtár/server/nl1-update-site
könyvtárra.
- A
JazzTelepítésiKönyvtár/server/nl2-update-site
könyvtárra.
Tipp: Ha az
IBM®
Installation Managerrel telepíti a
Jazz
Team Server
a
Rational Team Concert
termékhez, akkor a
Jazz
Team Server
fájljait egy webes alkalmazáskönyvtárba telepítheti. A telepítés során ne
telepítse az Apache Tomcat alkalmazáskiszolgálót. Ekkor az Installation
Manager rákérdez a webalkalmazás könyvtárára, és csak a
WebSphere
rendszerhez szükséges fájlokat telepíti.
Az alapértelmezett könyvtár
Windows®
rendszereken a C:\Program Files\IBM\JazzTeamServer,
Linux®
rendszereken pedig az /opt/IBM/JazzTeamServer.
Ez az eljárás a telepítés könyvtárára
JazzTelepítésiKönyvtárként
hivatkozik. Ha az IBM Installation Managerrel telepíti a fájlokat a
WebSphere
Application Server webalkalmazásainak könyvtárába, akkor nem kell a fent
leírt módon saját kezűleg áthelyeznie a fájlokat.
Erről a feladatról
Megjegyzés: Ez a dokumentum nem mutatja be a
WebSphere
hitelesítés és az SSL konfigurálását, mivel ez egy tág témakör. A
WebSphere
rendszeren elérhető különféle hitelesítési és titkosítási lehetőségekről a
WebSphere
információs központban talál részletes információkat. A további
információkért nyissa meg a
WebSphere
információs központot, és keressen rá a
Securing
applications and their environment kifejezésre.
A
Jazz
webes felhasználói felülete megköveteli a hitelesítés beállítását, hogy
kezelni tudja a jogosultságokat, illetve személyre szabhassa az
alkalmazást.
Eljárás
- Ellenőrizze és frissítse az adatbázis helyét a
teamserver.properties fájlban.
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
Megjegyzés: Ez a DB2 egy mintakonfigurációja. A teamserver.properties fájlt az
adatbázis-szállítónak (Oracle/MS-SQL) megfelelően kell frissíteni.
- Ellenőrizze és frissítse a
WebSphere
Application Server szintjét.
A
Jazz
Team Server
alkalmazáshoz a
WebSphere
Application Server 6.1-es verziójának és az
IBM
Java
SDK 1.5 SR5 vagy későbbi összesített javításának, vagy a
WebSphere
Application Server 7.0-s verziójának (legalább 7.0.0.7) telepítése
szükséges. Az
IBM
Java
SDK 1.5 SR6 SDK frissítés a következő címen érhető el:
http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. A
WebSphere
6.1 és a GA
IBM
Java
SDK verzió esetén a
Jazz
"proxyhibákat" kezd jelenteni bizonyos számú művelet után.
Az
IBM
Java
SDK 1.5 SR9 és az
IBM
Java
SDK 1.6 SR4 javításaihoz be kell szereznie a megfelelő
WebSphere
Application Server azonnali javításokat. Ezek az
IBM
Rational Team
Concert
2.0 megfelelő futtatásához szükségesek. Ha ezt nem teszi meg, akkor a
kiszolgáló egyes szolgáltatásai nem indulnak el megfelelően. Az azonnali
javítások a megfelelő
WebSphere
Application Server APAR alatt érhetők el. Az
IBM
Java
SDK
1.5/WebSphere
Application Server 6.1 esetén az APAR jele PK85942. A fájlok az
ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/
címen tölthetők le.
Telepítse a
WebSphere
Application Server 6.1 legalább 19-es javítócsomagját, mielőtt telepíti a
JRE azonnali javítását. Az
IBM
Java
SDK
1.6/WebSphere
Application Server 7.0 esetén az APAR jele PK86771. A fájlok az
ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/
címen tölthetők le.
- Frissítse a JVM argumentumokat.
A
Jazz
Team Server
bizonyos speciális beállításokat igényel a
Java
virtuális gépen, amelyen fut.
Az első beállítandó tulajdonság az általános JVM argumentumok között az
alapértelmezett maximális lefoglalt memória (-Xmx beállítás). Ezt a
kiszolgáló által támogatott csoport méretének, illetve a
Jazz
Team Server
alkalmazást futtató kiszolgáló memóriakapacitásának megfelelően kell
beállítani. Egy jellemző közepes méretű csoport az -Xmx1536M értéket
használhatja, amely 1536 MB halommemóriát biztosít a
Jazz
Team Server
folyamata számára.
A második beállítandó tulajdonság az általános JVM argumentumok között
a szálverem mérete, amely kifejezetten a
Rational Quality Manager
alkalmazáshoz szükséges. A
Rational Quality Manager
egy jellemző veremméret-beállítása az -Xss786K.
Ha Oracle vagy SQL Server adatbázishoz csatlakozik, akkor be kell
jegyeznie az "ORACLE_JDBC" vagy "SQLSERVER_JDBC" nevű tulajdonságot.
A tulajdonságban a megfelelő jdbc-illesztőprogramok fájljainak abszolút
elérési útját állítsa be (ne az URL-t).
Az alábbi példák bemutatják az Oracle és SQL Server
adatbázis-kapcsolatokhoz használt általános JVM argumentumokat, valamint
az alapértelmezett maximális memóriafoglalást és a szálverem méretét. A
JazzTelepítésiKönyvtár
helyébe a saját
Jazz
Team Server
program telepítési könyvtárát helyettesítse be.
-DORACLE_JDBC=JazzTelepítésiKönyvtár\server\oracle
-Xmx1536M -Xss768k
-DSQLSERVER_JDBC=JazzTelepítésiKönyvtár\server\sqlserver -Xmx1536M -Xss768k
A kiszolgáló bizonyos funkcióinak vezérléséhez több más
rendszertulajdonságot is be kell állítani. Ezek az alábbiakban
láthatók. A következő részletek az említett JVM tulajdonságok beállítását
írják le a
WebSphere
adminisztrációt konzolján. A
JazzTelepítésiKönyvtár
helyébe a saját
Jazz
Team Server
program telepítési könyvtárát helyettesítse be:
- Kattintson a
parancsra.
- Kattintson a szerver1 elemre.
- Kattintson a
parancsra.
- Kattintson a Java virtuális gép lehetőségre.
- Adja meg a 100 értéket a Kezdeti halom
mezőben.
- Adja meg az 1000 értéket a Maximális
halomméret mezőben.
- Kattintson az Alkalmaz gombra.
- Kattintson a Naplózás és nyomonkövetés
lehetőségre. Kattintson a Napló részletességi szintjének
módosítása parancsra. A
Jazz
Team Server
a BIRT jelentéskezelő alrendszert használja. Ha meg szeretné akadályozni a
BIRT információs bejegyzések WebSphere naplófájlba írását, akkor állítsa
be a súlyos naplózási szintet az org.eclipse.birt.*
csomagokhoz. Kattintson az Alkalmaz gombra.
- Kattintson az Alkalmazáskiszolgálók > {kiszolgáló_neve} >
Folyamatmeghatározás > Java virtuális gép > Egyéni tulajdonságok
lehetőségre. Az egyik bejegyzendő egyéni tulajdonság a JAZZ_HOME. Ez egy
rendszertulajdonság, amely meghatározza, hogy hol találhatók bizonyos
konfigurációs fájlok. A tulajdonság nem egyszerű útvonalat, hanem URL-t ad
meg, tehát az értéket file:// formájú URL-ként kell megadni.
- Vegye fel a következő tulajdonságokat: Kattintson az Új gombra. Töltse ki a
Név és az Érték mezőt, majd
kattintson az OK gombra.
- Név: java.awt.headless Érték: true
- Név:
org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin
Érték:
true
- Név: JAZZ_HOME Érték:
file:///JazzTelepítésiKönyvtár/server/conf
- Kattintson a Mentés gombra közvetlenül az
elsődleges beállítás után.
- Indítsa újra a Websphere rendszert a
Jazz
alkalmazás telepítéséhez.
Az alábbi parancssori példákban a
WASTelepítésiKönyvtár
azt a helyet jelzi a kiszolgálón, ahová telepítve van a
WebSphere
Application Server.
- Nyissa meg a
WebSphere
Application Server adminisztrációs konzolját.
- Kattintson az
parancsra. (A
WebSphere
Application Server 7.0.0.7-es és későbbi verziói esetén az
parancsra kell kattintania.)
- Az Új alkalmazás elérési útja területen
kattintson a Helyi fájlrendszer lehetőségre.
- A Teljes elérési út mezőben adja meg a
következőt:
JazzTelepítésiKönyvtár/server/tomcat/webapps/jazz.war
- Állítsa be a Kontextusgyökér mezőben a /jazz
értéket, majd kattintson a Tovább gombra.
Megjegyzés: Ez a lépés a
WebSphere
Application Server 7.0.0.7-es és későbbi verziói esetén a telepítés
későbbi pontján jelenik meg.
- Kattintson a Tovább gombra, és hajtsa végre az
Új alkalmazás telepítése folyamat hátralévő lépéseit.
- Kattintson a Befejezés gombra.
- Ellenőrizze, hogy a jazz_war alkalmazás telepítése megtörtént-e, majd
kattintson a Mentés gombra közvetlenül az
elsődleges konfiguráció mellett.
- Kattintson az
lehetőségre.
- Jelölje be a jazz_war melletti jelölőnégyzetet, és kattintson az
Indítás gombra.
Az alkalmazás sikeres indítását a megjelenő zöld nyíl jelzi.
Megjegyzés: A hátralévő lépések csak a
Rational Quality Manager
termékre vonatkoznak.
- Térjen vissza az Új alkalmazás telepítése
oldalra.
- Keresse meg a help.war fájl a helyi fájlrendszerben, és jelölje ki. A
kontextus gyökereként adja meg a /help beállítást,
majd kattintson a Tovább gombra.
Megjegyzés: A help.war fájl a
JazzTelepítésiKönyvtár\server\tomcat\webapps\help.war
elérési úton található.
- Kattintson a Tovább gombra mindaddig, amíg meg
nem jelenik az Összegzés képernyő. A Befejezés
gombra kattintva telepítse az új alkalmazást.
- Ellenőrizze a help_war alkalmazás telepítését, majd kattintson a
Mentés gombra, hogy az elsődleges konfigurációs
fájlba
mentse a változtatásokat.
- Kattintson az
lehetőségre.
- Jelölje ki a help_ war alkalmazást, majd
kattintson az Indítás gombra.
Mi a következő lépés?
Ha Ön
Rational Team Concert
felhasználó, akkor lépjen tovább
A beállítás varázsló futtatása témakörhöz.
A
Rational Quality Manager
esetén lépjen tovább a "LDAP beállítása
WebSphere
Application Serveren", majd "A Jazz Team Server beállítás varázslójának
futtatása" című témakörre.
A témakörrel kapcsolatos további információkat a következő
hivatkozásokon keresztül érheti el:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ