Wspólne zagadnienia dotyczące instalowania - plik odniesień do zawartości

Serwer Apache Tomcat został zainstalowany w katalogu JazzInstallDir/server/tomcat. Aplikacja WWW (jazz.war) została zainstalowana w katalogu webapps serwera Apache Tomcat. W oknie komend należy ustawić bieżący katalog na JazzInstallDir/server. Skrypty uruchamiania i zamykania systemu serwera znajdują się w tym katalogu.
  • Aby uruchamiać skrypty uruchamiania i zatrzymywania z dowolnego innego katalogu, należy zmodyfikować plik profiles.ini w katalogu JazzInstallDir/server/conf/jazz/provision_profiles tak, aby korzystać ze ścieżki bezwzględnej. Patrz sekcja Modyfikowanie plików profile.ini oraz license_profile.ini.
  • Serwer Apache Tomcat jest skonfigurowany pod kątem korzystania z portów 9080 i 9443 w pliku JazzInstallDir/server/tomcat/conf/server.xml. W razie potrzeby należy zmienić je odpowiednio do własnego systemu. W razie potrzeby należy również zaktualizować ustawienia konfiguracji portów HTTP repozytorium serwera Jazz na stronie konfiguracji (Właściwości zaawansowane) interfejsu WWW administratora produktu Jazz.
  • Katalog JazzInstallDir/server/logs zawiera pliki dziennika serwera. W przypadku wystąpienia problemów z uruchomieniem serwera, należy sprawdzić pliki dziennika.
  • Plik JazzInstallDir/server/tomcat/conf/server.xml zawiera ustawienia SSL określające algorytm dostępny tylko w środowisku JRE firmy IBM®. Aby uruchomić serwer ze środowiskiem JRE firmy Sun, w pliku server.xml należy zmienić ustawienia dla Connector port="9443", tak aby parametr miał wartość sslProtocol="TLS" zamiast "SSL". Należy również usunąć parametr algorithm.

Produkty Jazz Team Server, Rational Team Concert (klient), Build System Toolkit, ClearCase Connector, ClearQuest Connector i inne pliki inkubatora można pobrać z adresu http://jazz.net. Aby zakupić produkt Rational Team Concert, należy przejść pod adres http://www.ibm.com/software/awdtools/rtc/, gdzie możliwe jest pobranie obrazu instalacyjnego lub zamówienie DVD.

Instalacje przy użyciu programu Installation Manager

Ten zestaw kroków i uwag ma zastosowanie do ścieżki instalacji z użyciem programu Installation Manager

Zanim rozpoczniesz

O tym zadaniu

Korzystając z programu IBM Installation Manager, w trakcie procesu instalowania należy zwrócić uwagę na katalog instalacyjny na stronie Położenie. Katalog ten jest nazywany JazzInstallDir.

  • Instalacja sieciowa klientów, serwerów i opcjonalnych składników w programie Installation Manager: Ten plik archiwum zawiera starter programu Installation Manager i predefiniowane położenia repozytoriów instalacyjnych. Jest to plik samorozpakowujący, który po wyodrębnieniu zawartości uruchamia starter programu IBM Installation Manager. Korzyści z używania sieciowego pakietu instalacyjnego są takie, że ogranicza on ilość początkowego pobierania, a proces instalacji pobiera tylko te zasoby, które mają zostać zainstalowane.
    Uwaga: Instalacja sieciowa wymaga połączenia z Internetem na czas trwania procesu instalacji.
  • Plik .zip z pełną zawartością dysku DVD: Ten plik archiwum zawiera starter programu Installation Manager i lokalną kopię wszystkich instalowalnych zasobów. Korzyścią z używania lokalnego pakietu instalacyjnego jest to, że nie wymaga on połączenia z Internetem do przeprowadzenia instalacji. Nie jest to samorozpakowujący plik .zip.
  • Plik .zip z zawartością dysku CD Klienta - Lokalny instalator klienta w programie Installation Manager: Ten plik archiwum zawiera starter programu Installation Manager i lokalną kopię klienta produktuRational Team Concert. Korzyścią z używania lokalnego pakietu instalacyjnego jest to, że nie wymaga on połączenia z Internetem do przeprowadzenia instalacji. Ten plik .zip nie jest samorozpakowujący.
  • Instalacja sieciowa klientów, serwerów i opcjonalnych składników w programie Installation Manager: Ten plik archiwum zawiera starter programu Installation Manager i predefiniowane położenia repozytoriów instalacyjnych. Jest to plik samorozpakowujący, który po wyodrębnieniu zawartości uruchamia starter programu IBM Installation Manager. Korzyści z używania sieciowego pakietu instalacyjnego są takie, że ogranicza on ilość początkowego pobierania, a proces instalacji pobiera tylko te zasoby, które mają zostać zainstalowane.
    Uwaga: Instalacja sieciowa wymaga połączenia z Internetem na czas trwania procesu instalacji.
  • Plik .zip z pełną zawartością dysku DVD: Ten plik archiwum zawiera starter programu Installation Manager i lokalną kopię wszystkich instalowalnych zasobów. Korzyścią z używania lokalnego pakietu instalacyjnego jest to, że nie wymaga on połączenia z Internetem do przeprowadzenia instalacji. Ten plik .zip nie jest samorozpakowujący.

Procedura

  1. Uruchamianie startera.

    Jeśli program Installation Manager nie działa, należy go uruchomić.

    Uwaga: Do uruchomienia startera wymagane są uprawnienia administratora.
    • Korzystając z Instalacji sieciowej programu Installation Manager, uruchom plik wykonywalny. Po wyodrębnieniu plików do katalogu zostanie wyświetlony starter.
      • Aby uruchomić plik w systemie Windows®, wykonaj następującą komendę:
        RTC-edycja-Full-wersja-Win-Web.exe
      • Aby uruchomić plik w systemie Linux®, wykonaj następującą komendę:
        sh RTC-edycja-Full-wersja-Linux-Web.sh
    • Korzystając z Pliku .zip z pełną zawartością dysku DVD, wyodrębnij zawartość archiwum do katalogu tymczasowego i uruchom starter.
      • Aby uruchomić plik w systemie Windows, wykonaj następującą komendę:
        launchpad.exe
      • Aby uruchomić plik w systemie Linux, wykonaj następującą komendę:
        sh launchpad.sh
  2. Uruchamianie startera.

    Jeśli program Installation Manager nie działa, należy wykonać następujące czynności, aby go uruchomić.

    Uwaga: Do uruchomienia startera wymagane są uprawnienia administratora.
    Uwaga: Komendy do uruchomienia startera w systemu Linux dotyczą wyłącznie produktu Rational Team Concert dla środowiska IDE Eclipse.
    Aby uruchomić plik startera:
    • Korzystając z Pliku .zip z zawartością dysku CD Klienta, wyodrębnij zawartość archiwum do katalogu tymczasowego i uruchom starter. Aby uruchomić plik startera:
      • Aby uruchomić plik w systemie Windows, wykonaj następującą komendę:
        launchpad.exe
      • Aby uruchomić plik w systemie Linux, wykonaj następującą komendę:
        sh launchpad.sh
    • Korzystając z Instalacji sieciowej programu Installation Manager, uruchom plik wykonywalny. Po wyodrębnieniu plików do katalogu zostanie wyświetlony starter. Aby uruchomić plik wykonywalny:
      • Aby uruchomić plik w systemie Windows, wykonaj następującą komendę:
        RTC-edycja-Full-wersja-Win-Web.exe
      • Aby uruchomić plik w systemie Linux, wykonaj następującą komendę:
        sh RTC-edycja-Full-wersja-Linux-Web.sh
    • Korzystając z Pliku .zip z pełną zawartością dysku DVD, wyodrębnij zawartość archiwum do katalogu tymczasowego i uruchom starter. Aby uruchomić plik startera:
      • Aby uruchomić plik w systemie Windows, wykonaj następującą komendę:
        launchpad.exe
      • Aby uruchomić plik w systemie Linux, wykonaj następującą komendę:
        sh launchpad.sh

Instalacje z plików .zip

Podczas instalowania z plików .zip używane są następujące elementy.

About this task

Note: Używając skompresowanych plików archiwum do przeprowadzenia instalacji, należy zwrócić uwagę na katalog, do którego wyodrębniane są pliki. Katalog ten jest w kolejnych krokach nazywany JazzInstallDir.

Procedure

  1. Pobieranie pliku (plików) na komputer.
    • Pobierz plik .zip serwera
    • Pobierz plik .zip klienta
    • kOpcjonalnie: Pobierz plik .zip kompilacji
    • Opcjonalnie: Pobierz plik(i) .zip konektora
  2. Wyodrębnianie zawartości pakietu do systemu plików.
    Note: Wyodrębniając pliki, warto wybrać miejsce docelowe zbliżone do katalogu głównego systemu plików. Długie nazwy ścieżek do plików mogą być przyczyną zbędnych ostrzeżeń. Pliki można na przykład wyodrębniać do katalogów c:\IBM w systemie Windows lub /opt/IBM w systemie Linux.

Instalacje klientów

About this task

Note: Aby zainstalować klienta w istniejącym środowisku roboczym Eclipse, należy użyć programu IBM Installation Manager. Program IBM Installation Manager umożliwia podczas instalacji wskazanie środowiska roboczego przeznaczonego do rozszerzenia, a także zarządzanie jego przyszłymi aktualizacjami, wycofaniami zmian i modyfikacjami
Rozwiązywanie problemów: Poniżej przedstawiono sugerowane techniki zarządzania problemami.
  • Rozpoczynaj pracę z pustym obszarem roboczym.
  • Kompilacje klienta i serwera muszą być zgodne. Upewnij się, że identyfikatory dystrybucji klienta i serwera są zgodne.
  • Upewnij się, że serwer jest uruchomiony. Potwierdź status, korzystając z adresu URL: https://przyklad.com:9443/jazz.
  • Aby w systemie Linux uruchomić klienta spoza katalogu JazzInstallDir/client/eclipse, zmień każdy plik w katalogu JazzInstallDir/client/eclipse/links/ i dodaj ścieżkę bezwzględną do tego katalogu. Domyślnie używane są ścieżki względne. Na przykład ścieżka JazzInstallDir/client/eclipse/links/build.link zawiera tekst "path=jazz/build". Jeśli klient jest zainstalowany w katalogu /home/username/teamconcert, zmodyfikuj plik tak, aby wyglądał następująco: "path=/home/username/teamconcert/jazz/client/eclipse/build".

Procedure


  1. Nawiązywanie połączenia z serwerem. Najprostszym sposobem na nawiązanie połączenia z serwerem jest skorzystanie z Zaproszenia zespołowego. Nie mając zaproszenia, można nawiązać połączenie ręcznie.
    1. Kliknij kolejno opcje Plik > Zaakceptuj zaproszenie zespołowe. Kreator ten prowadzi użytkownika przez ten proces.
      Note: Nie mając zaproszenia, należy posiadać identyfikator URI lub adres URL od administratora serwera. Przykładowy format: https://przyklad.com:9443/jazz. Należy kliknąć odsyłacz hipertekstowy nawiązywanie połączenia z istniejącym obszarem projektu wyświetlany w prawym dolnym rogu okna Zaakceptuj zaproszenie zespołowe.
    2. Postępuj zgodnie z instrukcjami kreatora, aby skonfigurować połączenie.

Inne atrybuty conref instalacji

About this task

Important: Produkt Jazz Team Server w połączeniu z bazą danych Derby obsługuje do 10 użytkowników. Aby obsługiwać więcej niż 10 użytkowników, należy użyć bazy danych DB2® Workgroup Server, DB2, Oracle lub Microsoft® SQL Server. Produkt DB2 Workgroup Server jest dołączony do pakietów instalacyjnych edycji Enterprise, Standard i Express®, jeśli korzysta się z programu IBM Installation Manager. Jeśli wybrano instalację za pomocą pliku .zip, produkt DB2 Workgroup Server można pobrać z tego samego serwisu, co produkt Rational Team Concert. Po zainstalowaniu produktu DB2 Workgroup Server należy skonfigurować go zgodnie z opisem w podręczniku konfigurowania instalacji.

Po zapisaniu plików właściwości aplikacja zawsze wykonuje kopię zapasową poprzedniej wersji w tym samym katalogu. Aby usunąć wszystkie pliki zawierające hasła zapisane w jawnym tekście, należy usunąć kopie zapasowe plików właściwości po pierwszym skonfigurowaniu serwera.

Note: Aby korzystać z już istniejącego serwera aplikacji, zamiast dołączonego serwera Apache Tomcat, należy usunąć zaznaczenie z pola wyboru Pakiet Apache Tomcat. W ten sposób zainstalowane zostaną tylko pliki wymagane do korzystania z istniejącego serwera aplikacji. Program Installation Manager umożliwi wskazanie miejsca, w którym mają zostać zainstalowane te pliki.
Note: Baza danych Derby jest dołączona w domyślnej konfiguracji i nie wymaga instalowania, ale obsługuje nie więcej niż 10 użytkowników. Jeśli ma być obsługiwanych więcej niż 10 użytkowników, a nie ma dostępu do istniejącej bazy danych DB2 lub Oracle, należy zainstalować znajdującą się w pakunku edycję DB2 Workgroup Server.

Instalując DB2 Workgroup Server należy zapisać ID użytkownika, hasło i numer portu. Informacje te będą potrzebne później. Akceptacja wartości domyślnych podczas instalacji upraszcza konfigurację produktu Jazz Team Server.

Uruchamianie serwera

About this task

Użytkownik, który zamierza używać dołączonego serwera aplikacji Apache Tomcat, może od razu uruchomić produkt Jazz Team Server.

Chcąc korzystać z WebSphere® Application Server, należy skonfigurować środowisko serwerowe zgodnie z opisem na stronie Konfigurowanie produktu WebSphere Application Server.

Chcąc korzystać z WebSphere Application Server, należy skonfigurować środowisko serwerowe zgodnie z opisem w sekcji Konfigurowanie produktu WebSphere Application Server.

Uruchamianie serwera Apache Tomcat

Teraz można przystąpić do uruchomienia serwera Apache Tomcat.
Serwer Apache Tomcat został zainstalowany w katalogu JazzInstallDir/server/tomcat. Aplikacja WWW (jazz.war) została zainstalowana w katalogu webapps serwera Apache Tomcat. W oknie komend należy ustawić bieżący katalog na JazzInstallDir/server. Skrypty uruchamiania i zamykania systemu serwera znajdują się w tym katalogu.
  • Aby uruchamiać skrypty uruchamiania i zatrzymywania z dowolnego innego katalogu, należy zmodyfikować plik profiles.ini w katalogu JazzInstallDir/server/conf/jazz/provision_profiles tak, aby korzystać ze ścieżki bezwzględnej. Patrz sekcja Modyfikowanie plików profile.ini oraz license_profile.ini.
  • Serwer Apache Tomcat jest skonfigurowany pod kątem korzystania z portów 9080 i 9443 w pliku JazzInstallDir/server/tomcat/conf/server.xml. W razie potrzeby należy zmienić je odpowiednio do własnego systemu. W razie potrzeby należy również zaktualizować ustawienia konfiguracji portów HTTP repozytorium serwera Jazz na stronie konfiguracji (Właściwości zaawansowane) interfejsu WWW administratora produktu Jazz.
  • Katalog JazzInstallDir/server/logs zawiera pliki dziennika serwera. W przypadku wystąpienia problemów z uruchomieniem serwera, należy sprawdzić pliki dziennika.
  • Plik JazzInstallDir/server/tomcat/conf/server.xml zawiera ustawienia SSL określające algorytm dostępny tylko w środowisku JRE firmy IBM. Aby uruchomić serwer ze środowiskiem JRE firmy Sun, w pliku server.xml należy zmienić ustawienia dla Connector port="9443", tak aby parametr miał wartość sslProtocol="TLS" zamiast "SSL". Należy również usunąć parametr algorithm.

Uruchamianie serwera w systemie Windows

Aby uruchomić serwer w systemie Windows, należy uruchomić plik startowy.

O tym zadaniu

Procedura

  1. Aby uruchomić serwer z katalogu JazzInstallDir/server, wykonaj następującą komendę:
    server.startup.bat
    Uwaga: Zostanie otwarte osobne okno konsoli serwera Apache Tomcat. Nie należy zamykać tego okna, ponieważ wówczas serwer zostanie zatrzymany. Ponadto zostaną uruchomione komunikaty informacyjne, w tym o własnej bibliotece serwera Apache Tomcat. Te komunikaty informacyjne pozostają bez wpływu na funkcjonalność produktu Jazz Team Server.
  2. Aby zatrzymać serwer z katalogu JazzInstallDir/server, wykonaj następującą komendę:
    server.shutdown.bat

Co dalej

Uwaga: Powyższe przykłady uruchamiają skrypty uruchamiające i zatrzymujące bezpośrednio z katalogu JazzInstallDir/server. Jeśli produkt Jazz Team Server został zainstalowany za pomocą programu IBM Installation Manager, komendy można również uruchamiać z poziomu folderu produktu Jazz Team Server w menu Start systemu Windows.

Po uruchomieniu serwera należy przejść do sekcji Uruchamianie kreatora konfiguracji.

Uruchamianie serwera w systemie Linux

Aby uruchomić lub zatrzymać serwer w systemie Linux, należy uruchomić poniższy plik startowy.

O tym zadaniu

Procedura

  1. Aby uruchomić serwer z katalogu JazzInstallDir/server, jako administrator wykonaj następującą komendę:
    ./server.startup
    Jeśli ID użytkownika posiada uprawnienia administratora, wykonaj następującą komendę:
    sudo ./server.startup

    Nie jest wyświetlane osobne okno konsoli serwera Apache Tomcat. Postęp uruchamiania serwera można sprawdzić, wyświetlając plik dziennika JazzInstallDir/server/logs/jazz.log.

  2. Aby zatrzymać serwer z katalogu JazzInstallDir/server, jako administrator wykonaj następującą komendę:
    ./server.shutdown
    Jeśli ID użytkownika posiada uprawnienia administratora, wykonaj następującą komendę:
    sudo ./server.shutdown

Co dalej

Uwaga: Ten przykład uruchamia skrypty uruchamiające i zatrzymujące bezpośrednio z katalogu JazzInstallDir/server. Jeśli produkt Jazz Team Server został zainstalowany przy użyciu programu IBM Installation Manager, można również uruchamiać te komendy z poziomu folderu aplikacji Jazz Team Server w menu Start.

Po uruchomieniu serwera należy przejść do sekcji Uruchamianie kreatora konfiguracji.

Konfigurowanie produktu WebSphere Application Server

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:
    1. 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).
    2. 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

  1. 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).
  2. 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/.

  3. 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:

    1. Kliknij kolejno opcje Serwery > Serwery aplikacji.
    2. Kliknij opcję serwer1.
    3. Kliknij kolejno opcje Java i zarządzanie procesami > Definiowanie procesów.
    4. Kliknij opcję Wirtualna maszyna języka Java.
    5. Dodaj wartość 100 do opcji Sterta początkowa.
    6. Dodaj wartość 100 do opcji Maksymalna wielkość sterty.
    7. Kliknij przycisk Zastosuj.
    8. 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.
    9. 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.
    10. 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
    11. 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).
  4. 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.
    • W systemie Windows domyślną wartością dla katalogu instalacyjnego produktu WebSphere jest:
      C:\Program Files\IBM\WebSphere\AppServer
      Do zrestartowania serwera w systemie Windows służą następujące komendy:
      cd WASInstallDir\bin 
      stopServer.bat serwer1 [dla zabezpieczonego serwera dołącz: -username {Uzytkownik_LDAP} -password {Haslo_LDAP}] 
      startServer.bat serwer1
    • W systemie Linux domyślną wartością dla katalogu instalacyjnego produktu WebSphere jest:
      /opt/IBM/WebSphere/AppServer
      Do zrestartowania serwera w systemie Linux służą następujące komendy:
      cd WASInstallDir/bin 
      ./stopServer.sh serwer1 [dla zabezpieczonego serwera dołącz: -username {Uzytkownik_LDAP} -password {Haslo_LDAP}] 
      ./startServer.sh serwer1
    1. Otwórz Konsolę administracyjną WebSphere Application Server.
    2. Kliknij kolejno opcje Aplikacje > Zainstaluj nową aplikację. (W przypadku WebSphere Application Server 7.0.0.7 i nowszych kliknij kolejno opcje Aplikacje > Nowa aplikacja > Nowa aplikacja korporacyjna).
    3. Pod opcją Ścieżka do nowej aplikacji kliknij Lokalny system plików.
    4. Pod opcją Pełna ścieżka wprowadź:
      JazzInstallDir/server/tomcat/webapps/jazz.war
    5. 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.
    6. Kliknij opcję Dalej i kontynuuj przez pozostałe kroki procedury Zainstaluj nową aplikację.
    7. Kliknij przycisk Zakończ.
    8. Sprawdź, czy aplikacja jazz_war została zainstalowana i kliknij przycisk Zapisz, aby zapisać bezpośrednio w głównej konfiguracji.
    9. Kliknij opcje Aplikacje > Aplikacje korporacyjne.
    10. 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.
    11. Wróć do strony Instalowanie nowej aplikacji.
    12. 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.
    13. Klikaj kolejno przycisk Dalej, aż do wyświetlenia ekranu podsumowania, a następnie kliknij przycisk Zakończ, aby zainstalować nową aplikację.
    14. Sprawdź, czy aplikacja help_war została zainstalowana i kliknij przycisk Zapisz, aby zapisać zmiany w pliku Konfiguracji głównej.
    15. Kliknij opcje Aplikacje > Aplikacje korporacyjne.
    16. Wybierz help_ war i kliknij przycisk Uruchom.

Co dalej

Po uruchomieniu serwera należy przejść do sekcji Uruchamianie kreatora konfiguracji.

Uruchamianie kreatora konfiguracji

Uruchomienie kreatora konfiguracji pozwala sprawdzić, czy serwer pracuje prawidłowo, a sam kreator poprowadzi przez kolejne kroki konfiguracji serwera.

O tym zadaniu

Aby sprawdzić, czy produkt Jazz Team Server nawiązuje połączenie z bazą danych, sprawdź dziennik serwera lub wyjście konsoli. Informacje o połączeniu i bazie danych są potwierdzane przy pierwszym uzyskaniu dostępu. Pliki dziennika serwera są zapisywane w katalogu JazzInstallDir/server/logs.

Ta procedura zakłada, że serwer jest dostępny przy użyciu aliasu localhost nazwy hosta i domyślnych portów 9443. W razie potrzeby zastąp alias localhost nazwą hosta serwera i zastąp port 9443.

Procedura

Uruchom kreator konfiguracji, aby skonfigurować serwer. Użyj adresu URL https://localhost:9443/jazz/setup.

W przypadku serwera aplikacji Apache Tomcat zaloguj się przy użyciu domyślnej nazwy użytkownika i hasła (ADMIN/ADMIN). Zarówno w nazwie użytkownika, jak i w haśle rozróżniane są wielkości liter.

W przypadku serwera aplikacji WebSphere i LDAP należy poprawnie skonfigurować odwzorowania użytkowników, aby użytkownicy rejestru użytkowników WAS lub użytkownicy LDAP zostali odwzorowani na odpowiadające im grupy platformy Jazz (na przykład JazzAdmins, JazzUsers itd.). Po poprawnym odwzorowaniu użytkowników można zalogować się w Jazz Team Server przy użyciu własnego konta WAS lub LDAP. Więcej informacji na ten temat zawiera sekcja Zarządzanie użytkownikami przy użyciu LDAP.

Wybierz ścieżkę konfiguracji. Kreator konfiguracji udostępnia dwie główne ścieżki.
  • Fast Path Setup (Konfiguracja szybka) korzysta z domyślnych ustawień. Jeśli chcesz szybko uruchomić serwer, Konfiguracja szybka jest odpowiednim wyborem. W ramach szybkiej konfiguracji konfigurowany jest
    • rejestr użytkowników.
  • Custom Setup (Konfiguracja niestandardowa) poprowadzi przez szczegółową konfigurację serwera, włączając możliwość aktywowania powiadomień e-mail. W ramach konfiguracji niestandardowej konfigurowane są następujące elementy:
    • Baza danych
    • Powiadomienia e-mail
    • Rejestr użytkowników
    Uwaga: Domyślnie serwer jest skonfigurowany do korzystania z bazy danych Derby. Aby korzystać z innej bazy danych, takiej jak DB2, należy wybrać ścieżkę konfiguracji niestandardowej i wykonać Krok 2: Konfiguracja bazy danych. Jeśli nie utworzono własnych tabel bazy danych, będzie można to zrobić po przetestowaniu połączenia. Jeśli wybrano Konfigurację szybką, a nie utworzono własnych tabel bazy danych, będzie można przejść do Kroku 2 i utworzyć je.

Po zakończeniu początkowej konfiguracji można skonfigurować dodatkowe opcje w interfejsie WWW administratora produktu Jazz Team Server, pod adresem URL https://localhost:9443/jazz/admin.

Co dalej

Jeśli kreator konfiguracji serwera nie ładuje się, sprawdź następujące elementy:
  • Sprawdź, czy serwer aplikacji został uruchomiony. Użyj adresu URL http://localhost:9080.
  • Sprawdź, czy produkt Jazz Team Server został uruchomiony, logując się do interfejsu WWW administratora produktu Jazz Team Server, pod adresem URL https://localhost:9443/jazz/admin. Jeśli strona się nie załadowała lub serwer zgłasza błędy, to znaczy, że serwer nie został uruchomiony poprawnie.
  • Głównym identyfikatorem URI dla ścieżki produktu Jazz Team Server musi być /jazz. Na przykład należy użyć raczej https://przyklad.com:9443/jazz niż https://przyklad.com:9443.

Opinia