Ten temat zawiera opis sposobu konfiguracji produktu Jazz Team Server do
pracy z WebSphere Application Server. Zakłada się, że produkt
Jazz Team Server jest instalowany na tej samej
maszynie, na której zainstalowany jest Websphere Application Server. Instrukcje te zostały utworzone
w oparciu o WebSphere Application Server w wersji 6.1.0.23. W odniesieniu do wersji 7.0.0.7 i nowszych instrukcje nieznacznie się różnią. Różnice te zostały
zostały w tekście odpowiednio wskazane.
Zanim rozpoczniesz
Przed przystąpieniem do dalszych kroków należy upewnić się, że poniższe czynności zostały już wykonane:
- WebSphere Application Server jest już zainstalowany.
- Baza danych jest utworzona, a plik teamserver.properties jest zaktualizowany ustawieniami bazy danych.
- Włączanie logowania bez rozróżniania wielkości liter (opcjonalne): Jeśli metoda uwierzytelniania
serwera aplikacji umożliwia logowanie bez rozróżniania wielkości liter, to również
aplikacja Jazz może je zaakceptować. Zgoda na logowanie bez rozróżniania
wielkości liter może zostać włączona przy użyciu właściwości "Użyj dopasowywania ID użytkownika bez rozróżniania wielkości liter", na stronie Właściwości zaawansowane interfejsu WWW administratora. Wartość domyślna pozostaje niezmieniona; administratorzy muszą jawnie nadpisać tę właściwość, aby umożliwić logowanie bez rozróżniania wielkości liter.
- Opcja Java™ 2 Security powinna być wyłączona. Pozostawienie tej opcji włączonej w WebSphere Application Server spowoduje niepowodzenie uruchamiania pliku .war produktu Jazz Team Server.
- Upewniono się, że opcja zabezpieczeń WAS "Użyj dostępnych danych uwierzytelniania przy uzyskiwaniu dostępu do niezabezpieczonych identyfikatorów URI" jest zaznaczona. Skorzystaj w tym celu z konsoli Integrated Solutions Console serwera WAS:
- Wybierz kolejno opcje Zabezpieczenia -> Bezpieczne administrowanie, aplikacje i infrastruktura -> Zabezpieczenia WWW - Ustawienia ogólne.(W produkcie WAS 7.0.0.7, przechodząc kolejno do Zabezpieczenia -> Zabezpieczenia globalne -> Zabezpieczenia WWW i protokołu SIP ->
Ustawienia ogólne).
- Zaznacz pole wyboru "Użyj dostępnych danych uwierzytelniania przy uzyskiwaniu dostępu do niezabezpieczonych identyfikatorów URI".
- Produkt Jazz Team Server zawiera
pliki wymagane do uruchomienia kompletnego serwera w oparciu o Apache Tomcat. Instalacja
WebSphere wymaga tylko pewnego podzbioru plików produktu Jazz Team Server, które powinny znaleźć się w katalogu w systemie plików maszyny serwera WebSphere. W dalszej części instrukcji zwane jest to katalogiem instalacyjnym produktu Jazz Team Server lub krócej JazzInstallDir. Z tego katalogu użyj:
- Pliku JazzInstallDir/server/tomcat/webapps/jazz.war.
- Katalogu JazzInstallDir/server/update-site.
- Katalogu JazzInstallDir/server/conf.
- Domyślnej bazy danych repozytorium w JazzInstallDir/repositoryDB.
- Narzędzi repozytorium w JazzInstallDir/repotools.
- Katalogu JazzInstallDirserver/license-update-site.
- Katalogu JazzInstallDir/server/nl1-update-site.
- Katalogu JazzInstallDir/server/nl2-update-site.
Wskazówka: Korzystając z programu IBM® Installation
Manager do instalowania produktu Jazz Team Server do
pracy z produktem Rational Team Concert,
można instalować pliki produktu Jazz Team Server w katalogu
aplikacji sieci WWW. W trakcie procesu instalowania nie należy instalować dołączonego serwera aplikacji Apache Tomcat; w takim przypadku program Installation Manager oczekiwałby podania katalogu aplikacji sieci WWW, a następnie zainstalował tylko pliki wymagane przez WebSphere. Domyślnym katalogiem jest C:\Program Files\IBM\JazzTeamServer w systemie Windows® lub /opt/IBM/JazzTeamServer w systemie Linux®.
Katalog instalacyjny jest w tej procedurze nazywany JazzInstallDir. Jeśli do instalowania plików w katalogu aplikacji sieci WWW WebSphere Application Server używany jest program
IBM Installation Manager, to nie ma potrzeby ręcznego przenoszenia tych plików w opisany powyżej sposób.
O tym zadaniu
Uwaga: Dokument ten nie omawia złożonych zagadnień, takich jak konfiguracji uwierzytelniania lub SSL w produkcie WebSphere. Szczegółowe informacje na temat różnych opcji uwierzytelniania i szyfrowania w produktach WebSphere zawiera Centrum informacyjne produktu WebSphere. Więcej informacji
można uzyskać przechodząc do
Centrum informacyjnego WebSphere i wyszukując tematu
Securing applications and their environment (Zabezpieczanie aplikacji i ich środowisk). Interfejs WWW produktu Jazz wymaga skonfigurowania uwierzytelniania, aby umożliwiać autoryzację i personalizację aplikacji.
Procedura
- Przejrzyj i zaktualizuj położenie bazy danych w pliku 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
Uwaga: To jest przykładowa konfiguracja bazy danych DB2.
Plik teamserver.properties powinien być aktualizowany
zależnie od dostawcy bazy danych (Oracle/MS-SQL).
- Zweryfikuj lub zaktualizuj poziom WebSphere Application
Server.
Produkt Jazz Team Server wymaga WebSphere Application Server, wersja 6.1
z pakietem IBM Java SDK
1.5 z zastosowaną zbiorczą poprawką SR5 lub nowszą, albo WebSphere Application
Server, wersja 7.0 z zainstalowanym pakietem poprawek przynajmniej w wersji 7.0.0.7. Aktualizacja pakietuIBM Java SDK 1.5 SR6 SDK jest dostępna pod adresem http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. W połączeniu z WebSphere 6.1
i stabilną wersją pakietu IBM Java SDK, produkt Jazz
po wykonaniu pewnej liczby operacji zaczyna zgłaszać "błędy proxy".
Należy pozyskać odpowiednie dla WebSphere Application
Server poprawki przyrostowe (i-fix) do poprawek dla pakietu IBM Java SDK
1.5 SR9 lub IBM Java SDK
1.6 SR4, które są niezbędne do prawidłowej pracy produktu IBM Rational Team Concert 2.0. W przeciwnym razie pewne usługi na serwerze mogą nie zostać prawidłowo uruchomione. Poprawki przyrostowe są dostępne pod odpowiednimi autoryzowanymi raportami analizy problemu (Authorized Problem Analysis Report - APAR) WebSphere Application Server. Dla pakietu IBM Java SDK 1.5/WebSphere Application
Server 6.1, odpowiedni APAR to PK85942, a pliki można pobrać z ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/.
Przed zainstalowaniem środowiska JRE i i-fix należy zainstalować przynajmniej WebSphere Application Server
6.1 z pakietem poprawek 19. Dla pakietu IBM Java SDK 1.6/WebSphere Application
Server 7.0, odpowiedni APAR to PK 86771, a pliki można pobrać z ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.
- Zaktualizuj argumenty maszyny wirtualnej Java (JVM).
Produkt Jazz Team Server wymaga
pewnych określonych ustawień maszyny wirtualnej Java, w której jest uruchomiony.
Pierwszą właściwością, która wymaga ustawienia w ogólnych argumentach JVM, jest domyślny maksymalny przydział pamięci, przy użyciu parametru -Xmx. Wartość ta powinna być ustawiona w oparciu o wielkość zespołu obsługiwaną przez serwer oraz wielkość pamięci serwera, na którym uruchomiono produkt Jazz Team Server. Typowy zespół średniej wielkości może używać wartości -Xmx1536M, zapewniając 1536 MB pamięci sterty dla procesu produktu Jazz Team Server.
Drugą właściwością, która wymaga ustawienia w ogólnych argumentach JVM, szczególnie dla produktów rodziny
Rational Quality Manager,
jest wielkość stosu wątku. Typową wielkością stosu dla produktu rodziny Rational Quality Manager jest
-Xss786K.
Przy łączeniu się z bazami danych Oracle lub SQL Server wymagane jest dodanie
właściwości "ORACLE_JDBC" lub "SQLSERVER_JDBC".
Właściwości tej należy nadać wartość odpowiadającą bezwzględnej ścieżki (nie adresu URL) do odpowiednich sterowników jdbc.
Poniższe przykłady pokazują ogólne argumenty JVM na potrzeby
łączenia się z bazami danych Oracle i SQL Server, wraz z domyślnym
maksymalnym przydziałem pamięci i wielkością stosu wątku. Zmienną JazzInstallDir należy zastąpić
własnym katalogiem instalacyjnym produktu Jazz Team Server.
-DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
-DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k
Istnieje kilka innych właściwości systemowych, które należy ustawić, aby kontrolować
określone działania serwera. Przedstawiono je poniżej. Oto szczegóły ustawiania tych właściwości JVM w Konsoli administracyjnej produktu WebSphere. Zmienną JazzInstallDir należy
zastąpić własnym katalogiem instalacyjnym produktu Jazz Team Server:
- Kliknij kolejno opcje .
- Kliknij opcję serwer1.
- Kliknij kolejno opcje .
- Kliknij opcję Wirtualna maszyna języka Java.
- Dodaj wartość 100 do opcji Sterta początkowa.
- Dodaj wartość 100 do opcji Maksymalna wielkość sterty.
- Kliknij przycisk Zastosuj.
- Kliknij opcję Rejestrowanie i śledzenie. Kliknij opcję Zmień poziomy szczegółowości rejestrowania. Produkt Jazz Team Server korzysta
z mechanizmu raportowania BIRT. Aby zapobiec zapisaniu wpisów informacyjnych mechanizmu BIRT do pliku dziennika
produktu WebSphere, ustaw poziom rejestrowania severe (poważne) dla pakietów org.eclipse.birt.*. Kliknij przycisk Zastosuj.
- Kliknij kolejno opcje Serwery aplikacji > {nazwa_serwera} > Definiowanie
procesów > Wirtualna maszyna języka Java > Właściwości niestandardowe. Jedną z niestandardowych właściwości wymagających dodania jest JAZZ_HOME,
właściwość systemowa określająca położenie określonych plików konfiguracyjnych. Właściwość ta korzysta raczej z adresu URL niż zwykłej ścieżki, więc wartość powinna być podana w formie file://-styl adresu URL.
- Dodaj następujące właściwości: Kliknij opcję Nowa;
wprowadź wartości Nazwa i Wartość, a następnie kliknij przycisk OK.
- Nazwa: java.awt.headless Wartość: true
- Nazwa: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Wartość:
true
- Nazwa: JAZZ_HOME Wartość: file:///JazzInstallDir/server/conf
- Kliknij opcję Zapisz bezpośrednio do konfiguracji głównej.
Ważne: Wyłącznie w przypadku systemu Solaris należy dodać następujące
argumenty wiersza komend Java:
-XX:MaxPermSize=256m
Informacje dodatkowe zawiera rozdział
2 "Configuring a Solaris environment for WebSphere Application Server" (Konfigurowanie środowiska systemu Solaris dla WebSphere Application serwer dokumentacji technicznej (Redbook)
IBM WebSphere Application Server
V6.1 on the Solaris 10 Operating System (IBM WebSphere Application Serwer, wersja 6.1 w systemie operacyjnym Solaris).
- Zrestartuj produkt WebSphere, aby zainstalować aplikację Jazz.
W poniższych przykładach wiersza komend zmienna
WASInstallDir
reprezentuje miejsce, w którym na serwerze zainstalowano WebSphere Application Server.
- Otwórz Konsolę administracyjną WebSphere Application
Server.
- Kliknij kolejno opcje . (W przypadku WebSphere Application Server 7.0.0.7
i nowszych kliknij kolejno opcje ).
- Pod opcją Ścieżka do nowej aplikacji kliknij
Lokalny system plików.
- Pod opcją Pełna ścieżka wprowadź:
JazzInstallDir/server/tomcat/webapps/jazz.war
- Opcji Kontekstowy katalog główny nadaj wartość /jazz,
a następnie kliknij przycisk Dalej.
Uwaga: Ten krok występuje na końcu procesu instalowania w przypadku
WebSphere Application
Server 7.0.0.7 i nowszych.
- Kliknij opcję Dalej i kontynuuj przez pozostałe kroki procedury Zainstaluj nową aplikację.
- Kliknij przycisk Zakończ.
- Sprawdź, czy aplikacja jazz_war została zainstalowana
i kliknij przycisk Zapisz, aby zapisać bezpośrednio w głównej konfiguracji.
- Kliknij opcje .
- Wybierz prostokąt obok jazz_war; kliknij przycisk Uruchom.
Powinna zostać wyświetlona zielona strzałka wskazująca, że aplikacja została pomyślnie uruchomiona.
Uwaga: Pozostałe kroki dotyczą wyłącznie produktu Rational Quality Manager.
- Wróć do strony Instalowanie
nowej aplikacji.
- Przejdź do położenia pliku
help.war w lokalnym systemie plików
i wybierz ten plik. Wpisz /help jako kontekstowy katalog główny
i kliknij przycisk Dalej.
Uwaga: Do pliku
help.war prowadzi ścieżka JazzInstallDir\server\tomcat\webapps\help.war.
- Klikaj kolejno przycisk Dalej, aż do
wyświetlenia ekranu podsumowania, a następnie kliknij przycisk Zakończ,
aby zainstalować nową aplikację.
- Sprawdź, czy aplikacja help_war
została zainstalowana i kliknij przycisk
Zapisz, aby zapisać zmiany w pliku
Konfiguracji głównej.
- Kliknij opcje .
- Wybierz help_
war i kliknij przycisk Uruchom.
Co dalej
Jeśli jesteś użytkownikiem rodziny produktów
Rational Team Concert, przejdź do tematu
Uruchamianie kreatora konfiguracji. W przypadku produktu
Rational Quality Manager
przejdź do tematu "Konfigurowanie LDAP w produkcie WebSphere Application Server", a następnie do tematu
"Uruchamianie kreatora konfiguracji produktu Jazz Team Server".
Więcej
informacji na ten temat można znaleźć pod adresem:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ