Aktualizowanie do produktu Rational Team Concert 2.0.0.2

Zazwyczaj klienty i serwery Rational Team Concert można aktualizować, przeprowadzając instalację z pliku zip lub za pomocą programu IBM® Installation Manager.
Uwaga: Jeśli produkt Rational Team Concert 2.0.0.2 jest instalowany za pomocą programu IBM Installation Manager na komputerze, na którym produkt Rational Team Concert nie jest aktualnie zainstalowany, program Installation Manager poprosi o wybór języka, który ma być zainstalowany. Jeśli przeprowadzana jest aktualizacja z wcześniejszej wersji, program IBM Installation Manager przyjmuje, że mają być używane języki bieżące. Aby po aktualizacji do wersji 2.0.0.2 wybrać dodatkowe języki, na głównym ekranie programu IBM Installation Manager należy wybrać opcję Modyfikuj, a następnie określić produkt. Na następnym ekranie zostanie wyświetlona lista obsługiwanych języków. Należy wybrać wymagane.
Jeśli produkt Jazz Team Server zostanie uruchomiony po zaktualizowaniu do wersji 2.0.0.2, a przed wybraniem opcji Modyfikuj w celu dodania lub usunięcia języków, należy go zrestartować w następujący sposób:
  1. W przeglądarce WWW przejdź do strony
    https://<host_serwera>:<port_jazz>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
  2. Kliknij opcję Request Server Reset (Żądaj zresetowania serwera).
  3. Wyłącz serwer.

Aby dodać lub usunąć języki, można teraz wybrać opcję Modyfikuj w programie IBM Installation Manager .

Zgodność klientów i serwerów produktu Rational Team Concert

Poniższa tabela przedstawia zgodność wersji klienta produktu Rational Team Concert z wersjami produktu Jazz Team Server.
Tabela 1. Zgodność klienta i serwera
Wersja klienta produktu Rational Team Concert Zgodna wersja produktu Jazz Team Server
1.0.x dla środowiska Eclipse 0.6.x
2.0.x dla środowiska Eclipse 1.0.x
2.0.0.0 dla środowiska Microsoft® Visual Studio 1.0.0.0
2.0.x dla środowiska Microsoft Visual Studio 1.0.x

Aktualizowanie klienta produktu Rational Team Concert dla środowiska IDE Eclipse

Jeśli używane są wersje 1.0, 1.0.1 lub 1.0.1.1 klienta dla środowiska IDE IDE, aby połączyć się z nową wersją serwera 2.0.x, należy uzyskać klienta w wersji 2.0.x. Można go zainstalować korzystając z pliku zip lub zaktualizować wcześniejszą instalację programu IBM Installation Manager.

Instalowanie klienta produktu Rational Team Concert dla środowiska IDE Microsoft Visual Studio

Jeśli używana jest wersja 1.0.1.1 klienta dla środowiska IDE Microsoft Visual Studio, aby połączyć się z nową wersją serwera 2.0.x, należy uzyskać klienta w wersji 2.0.x.
Zapamiętaj: W przypadku klienta dla produktu Microsoft Visual Studio, plik .zip nie jest dostępny. Aby zainstalować lub zaktualizować do wersji 2.0.x, należy użyć programu IBM Installation Manager.

Aktualizowanie serwera z wersji próbnej lub Early Access do wersji trwałej

Jeśli używana jest wersja Early Access produktu Rational Team Concert, najpierw należy przeprowadzić aktualizację do wersji próbnej 2.0.0.2.

Wersję próbną 2.0.0.2 można zmienić w trwałą kupując i instalując pakiet aktywacyjny serwera dla danego wydania, dostępy pod adresem: http://www.ibm.com/software/awdtools/rtc/. Pakiet aktywacyjny składa się z pliku JAR zawierającego trwały klucz serwera. Instaluje się go na stronie Zarządzanie kluczami licencyjnymi interfejsu WWW administrowania serwerem.

Aktualizowanie serwera z wersji 1.0, 1.0.1, 1.0.1.1 lub 2.0

Aktualizację do wersji 2.0.0.2 produktu Rational Team Concert można przeprowadzić bezpośrednio z poprzednich wersji. W przypadku aktualizacji z wersji 1.x do 2.x wymagana jest migracja bazy danych. Informacje na temat przeprowadzania migracji bazy danych zawiera temat Migracja repozytorium Jazz po zaktualizowaniu produktu Jazz Team Server.

Uwaga: Przed rozpoczęciem aktualizowania produktu WebSphere Application Server, należy zrestartować serwer, przechodząc do strony https://{nazwa_serwera}:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset i klikając opcję Request Server Reset (Żądaj zresetowania serwera).

Jeśli poprzednia wersja została zainstalowana za pomocą pliku zip, przecięcie z poprzednią instalacją nie występuje. Wersję 2.0.0.2 można zainstalować z pliku zip w nowym miejscu lub skorzystać z programu IBM Installation Manager, aby zainstalować instancję wersji 2.0.0.2.

Jeśli do zainstalowania poprzedniej wersji użyto programu IBM Installation Manager, wersję 2.0.0.2 można zainstalować jako osobną instancję lub zaktualizować poprzednią wersję. Jeśli instalowana jest osobna instancja serwera dla wersji 2.0.0.2, na stronie Pakiety instalacyjne kreatora instalacji należy wybrać opcję Utwórz nową grupę pakietów.

Uwaga: Aby zaktualizować instalację WebSphere Application Server produktu Jazz Team Server, należy usunąć poprzedni plik jazz.war i wdrożyć plik jazz.war w wersji 2.0.0.2.

Informacje dotyczące kończenia aktualizacji zawierają sekcje Kopiowanie wymaganych plików konfiguracyjnych z poprzedniej instalacji serwera i Instalowanie kluczy aktywacyjnych w wersji 2.0.0.2.

Aktualizowanie serwera z jednej edycji produktu Rational Team Concert do innej

Istnieje możliwość przeprowadzania aktualizacji z jednej edycji produktu Rational Team Concert do innej. Typowe aktualizacje dotyczą przejścia z edycji Express-C do edycji Express lub z edycji Express do edycji Standard. Korzystając z tego samego procesu można także przeprowadzić operację przejścia na starszą wersję.

Jeśli przeprowadzana jest operacja przejścia z edycji Express-C do edycji Express lub Standard, migracja bazy danych Derby do bazy danych DB2 lub Oracle nie jest konieczna, ponieważ wszystkie edycje produktu Rational Team Concert 2.0.0.2 obsługują bazy danych Derby. Jeśli migracja bazy danych jest konieczna, zaleca się przeprowadzić najpierw migrację edycji serwera, upewnić się, czy w połączeniu z aktualną bazą danych działa poprawnie, a następnie przeprowadzić migrację bazy danych. Należy pamiętać, że baza danych Derby obsługuje tylko 10 użytkowników. Informacje na temat migracji bazy danych zawiera sekcja Migracja repozytorium platformy Jazz po przeprowadzeniu aktualizacji produktu Jazz Team Server .

Jeśli zainstalowano edycję produktu Rational Team Concert 2.0.0.2, która ma zostać zaktualizowana do innej, należy pobrać i zainstalować nową edycję obok tej istniejącej, a następnie skopiować wymagane pliki konfiguracyjne i uruchomić nową edycję. Poniższe sekcje opisują wymagane pliki konfiguracyjne.

Jeśli poprzednia edycja została zainstalowana za pomocą pliku zip, wtedy przecięcie z poprzednią instalacją nie występuje. Nową edycję można zainstalować z pliku zip w nowym miejscu lub skorzystać z programu IBM Installation Manager. W przypadku serwerów produkcyjnych zalecane jest użycie programu IBM Installation Manager, który zapewnia możliwość zastosowania przyszłych aktualizacji.

Jeśli do przeprowadzenia poprzedniej instalacji serwera użyto programu IBM Installation Manager, który ma być także użyty do zainstalowania nowej edycji, w trakcie nowej instalacji za pomocą programu Installation Manager nie należy tworzyć nakładki na poprzednią edycję. Na stronie Pakiety instalacyjne kreatora instalacji należy wybrać opcję Utwórz nową grupę pakietów.

Spowoduje to zainstalowanie nowej edycji w innej lokalizacji oraz utworzenie skrótów korzystających z nazwy nowej grupy pakietów.

Pominięcie tego zadania spowoduje, że instalacja nie powiedzie się z powodu kolizji plików. Wystąpienie kolizji sygnalizuje okno dialogowe błędu Installation Failed (Instalacja nie powiodła się) wraz z następującymi informacjami:
Installation failed.
  Error during "install" phase:
    Failed to extract zip standard 1.0.1.I20081018-1820.  File
    D:\JazzTeamServer\server\license-update-site\site.xml already exists.

Ten błąd nie jest krytyczny. Po jego wystąpieniu można zrestartować instalację i poprawnie utworzyć nową grupę pakietów.

Aktualizacje konfiguracji produktu WebSphere Application Server

Do poprawnego skonfigurowania produktu WebSphere Application Server w środowisku Rational Team Concert 2.0.0.2, należy wykonać następujące kroki.
  1. Upewnij się, czy jest zainstalowany najnowszy pakiet poprawek dla produktów WAS i WASDK. W przypadku wdrażania na serwerze WAS 7.0 koniecznie musi być zainstalowana co najmniej wersja WebSphere Application Server 7.0.0.3.
  2. Usuń poprzednie niestandardowe właściwości maszyny JVM:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Dodaj nową niestandardową właściwość maszyny JVM JAZZ_HOME i ustaw dla niej wartość:
    file:///<JazzInstallDir>/server/conf
  4. Upewnij 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.
    2. Zaznacz pole wyboru "Użyj dostępnych danych uwierzytelniania przy uzyskiwaniu dostępu do niezabezpieczonych identyfikatorów URI".

Kopiowanie wymaganych plików konfiguracyjnych z poprzedniej instalacji serwera

Z serwera źródłowego na serwer docelowy należy skopiować przedstawione poniżej pliki. Najpierw należy zmienić nazwy oryginalnych plików na zaktualizowanym serwerze, aby utworzyć ich kopie zapasowe. Jeśli do aktualizacji z wersji 1.0, 1.0.1, 1.0.1.1 lub 2.0 do wersji 2.0.0.2 użyto programu IBM Installation Manager, w podkatalogu serwera w miejscu instalacji został utworzony katalog kopii zapasowej, o nazwie backup-config-datownik, zawierający pliki konfiguracyjne wersji 1.0.x lub 2.0.

W przypadku aktualizowania do edycji Standard lub Enterprise i korzystania z pakietu Developer Client Activation Kit dla edycji Express, należy zakupić i zainstalować pakiet Developer Client Activation Kit dla edycji Standard lub Enterprise. Umożliwi to skorzystanie z odpowiednich licencji klienta. Przypisania licencji Developer będą nadal obowiązywać, ale licencje Developer zostaną zdezaktywowane do czasu zainstalowania poprawnego pakietu aktywacyjnego.

Instalowanie kluczy aktywacyjnych w wersji 2.0.0.2

Wersja 2.0.0.2 wykorzystuje klucze aktywacyjne w wersji 2.0.0.2. Jeśli serwer jest aktualizowany z wersji 1.0.x.x do wersji 2.0.x, po aktualizacji przywracany jest do wersji próbnej. Z centrum kluczy IBM Rational License Key Center należy uzyskać klucze aktywacyjne dla wersji 2.0 lub 2.0.0.2.

Więcej informacji na temat centrum kluczy IBM Rational License Key Center zawiera serwis wsparcia dotyczącego licencjonowania produktów IBM Rational oraz powiązana Wskazówka techniczna (Tech Tip) w serwisie jazz.net.

Poniżej znajdują się nazwy kluczy dla każdego pakietu:

  • IBM Rational Team Concert Express Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Standard Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Enterprise Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBMRational Team Concert Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Express Edition Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Developer Client Access Activation Kit V2.0, 2.0.0.2

Ustawianie osi czasu projektu

W przypadku produktu Rational Team Concert w wersji 1.x projekty mogły mieć wiele osi czasu (poprzednio nazywanych "liniami programistycznymi"), a wszystkie osie czasu były traktowane równo.

W przypadku produktu Rational Team Concert w wersji 2.0 projekty nadal mogą mieć wiele osi czasu, ale jedna z nich może być oznaczona jako "oś czasu projektu". W trakcie migracji bazy danych do wersji 2.0 główna oś czasu projektu nie jest znana, dlatego w projektach nie będzie ona ustawiona. Po zaktualizowaniu do wersji 2.0 można ręcznie zaktualizować swoje projekty i ustawić oś czasu projektu.

Konfigurowanie obrazu stanu zarządzania kontrolą źródła (Source Control Management - SCM)

Obraz stanu zarządzania kontrolą źródła (Source Control Management - SCM) dla hurtowni danych gromadzi dane o strumieniach, łącznie z informacjami o ich wielkości i wewnętrznej aktywności (zbiór zmian i zmiany pliku/folderu). W wersji 1.0 ten obraz stanu automatycznie gromadził informacje o wszystkich strumieniach. Ponieważ operacja ta jest kosztowna, w wersji 2.0 dodano opcje konfiguracyjne dla obrazu stanu SCM, które umożliwiają użytkownikom decydowanie, dla których strumieni mają być gromadzone dane. Bezpośrednim skutkiem takiej zmiany jest zaniechanie gromadzenia jakichkolwiek danych do czasu przeprowadzenia konfiguracji.

Aby skonfigurować obraz stanu SCM:
  1. Do gromadzenia danych z danego strumienia wymagane są odpowiednie uprawnienia do zapisu do tego strumienia.
  2. Przejdź do strony Raporty interfejsu WWW.
  3. Na lewym panelu nawigacyjnym wybierz Administruj obrazem stanu SCM. Zostanie wyświetlona lista strumieni.
  4. Zaznacz pole wyboru dla jednego lub więcej strumieni, a następnie kliknij przycisk Zapisz zmiany.

We wszystkich kolejnych obrazach stanu gromadzone będą dane dla wybranych strumieni.

Niezgodne zmiany w raportach narzędzi BIRT

Jeśli do utworzenia własnych szablonów raportów użyto projektanta raportów narzędzi BIRT, podczas próby użycia tych raportów w wersji 2.0 mogą pojawić się problemy. Należy pamiętać o następujących zagadnieniach:
  • Zmiany kolejności rozstrzygania klas języka Java™ i JavaScript™. Jeśli w raporcie narzędzi BIRT użyto kodu w języku JavaScript, który korzysta z instrukcji importPackage() do importowania pakietu java.lang, należy pamiętać, że niekwalifikowane odwołania do obiektu w kodzie, który był używany do odwołań do klasy języka Java, mogą teraz odwoływać się do klasy języka JavaScript (i w rezultacie mogą nie działać poprawnie). Podobny problem może wystąpić w przypadku pozostałych klas, które mają identyczne nazwy w języku JavaScript i Java, na przykład java.util.Date. Rozwiązaniem jest pełne kwalifikowanie odwołania do klasy języka Java i usunięcie instrukcji importPackage().
  • Zmiany przetwarzania zestawów danych. W przeszłości proste działanie polegające na wiązaniu elementu (takiego jak etykieta) z zestawami danych powodowało, że zestaw danych był przetwarzany w całości w trakcie renderowania elementu. Było to wygodne, ponieważ można było wymusić kolejność przetwarzania zestawów danych korzystając z (ukrytych) etykiet powiązanych z zestawami danych. Teraz tego rodzaju powiązanie spowoduje przetworzenie tylko pierwszego wiersza zestawu danych. Aby uzyskać poprzednie zachowanie, należy użyć elementu tekstu dynamicznego i wywołać kod języka JavaScript, który wymusi przetwarzanie całego zestawu danych. Dobrym wyborem jest funkcja Total.count().
  • Możliwość utraty danych spowodowana defektami projektanta raportów narzędzi BIRT. Problemy mogą się pojawić, gdy plik projektu raportu narzędzi BIRT, utworzony za pomocą narzędzi BIRT 2.2.2 (np. z wersji 1.0 produktu RTC), jest otwierany za pomocą projektanta raportów narzędzi BIRT 2.3.2 (np. z wersji 2.0 produktu RTC). Zaobserwowano następujące sytuacje:
    • W trakcie edytowania zestawu danych za pomocą narzędzi BIRT 2.3.2 po raz pierwszy, utracone zostają wartości pól Default Value (Wartość domyślna) i Report Parameter (Parametr raportu) na stronie Parameters (Parametry). Sposobem obejścia problemu jest ponowne wprowadzenie wartości lub skopiowanie i wklejenie wartości z poprzedniej wersji edytora. Po zapisaniu pliku z wprowadzonymi nowymi wartościami problem nie wystąpi ponownie.
    • W trakcie edytowania pliku projektu raportu za pomocą narzędzi BIRT 2.3.2 po raz pierwszy, utracone zostają wartości domyślne parametrów raportu. Problem taki towarzyszy często sytuacji opisanej powyżej. Sposobem obejścia problemu jest ponowne wprowadzenie wartości lub skopiowanie i wklejenie wartości z poprzedniej wersji edytora. Po zapisaniu pliku z wprowadzonymi nowymi wartościami problem nie wystąpi ponownie.

    Jeśli opisane problemy nie zostaną zauważone, mogą mieć bardzo poważne konsekwencje, gdyż raporty mogą zbierać niepoprawne dane. Zaleca się sprawdzanie każdego zestawu danych oraz każdego parametru raportu w trakcie edytowania raportu za pomocą projektanta raportów narzędzi BIRT 2.3.2 po raz pierwszy. Opisane problemy nie występują w przypadku nowych raportów utworzonych za pomocą narzędzi BIRT 2.3.2.

    Powyższe zmiany zostały wprowadzone do wszystkich standardowych raportów produktu Rational Team Concert 2.0 - nie jest wymagane żadne działanie użytkownika. Jeśli jednak w obszarze projektu ręcznie utworzono szablony raportów, korzystając z raportów standardowych i nie określono odpowiedniego identyfikatora (spójnego ze składnią), po migracji szablon raportu nie zostanie odświeżony. Oznacza to, że zawartość będzie nieaktualna i nie będzie działać. W takim przypadku należy przesłać dla tych szablonów nową treść, korzystając z odpowiedniego pliku (standardowego) .rptdesign.

Importowanie danych elementów pracy w hurtowni danych

W produkcie Rational Team Concert 2.0 wprowadzono kilka zmian schematu w tabelach elementów pracy w hurtowni danych. W ich wyniku w czasie migracji z wersji 1.0 do 2.0 program importujący zignoruje wszystkie dane elementów pracy hurtowni danych. W związku z tym, po pierwszym uruchomieniu serwera w wersji 2.0 raporty elementów pracy mogą nie działać poprawnie. Aby obejść ten problem, należy poczekać na pierwsze wykonanie obrazu stanu lub uruchomić je ręcznie po uruchomieniu serwera. Pierwsze uruchomienie po migracji spowoduje, że obraz stanu elementów pracy ponownie ustanowi wszystkie informacje historyczne o elementach pracy w hurtowni danych. Oznacza to, że pierwsze uruchomienie obrazu stanu po migracji potrwa znacznie dłużej niż czas średniego conocnego uruchamiania.

Poznawanie nowych raportów

Do produktu Rational Team Concert 2.0 dodano kilka nowych raportów. Raporty te pojawiają się w nowych szablonach procesu, dostarczanych razem z produktem, ale w trakcie migracji nie są automatycznie dodawane do istniejących obszarów projektu. Dodane zostało nowe działanie, które pomaga poznać i wdrożyć nowe szablony raportów do istniejących obszarów projektu. Aby wdrożyć nowe szablony raportów:
  1. W pełnym kliencie otwórz widok Artefakty zespołu.
  2. Rozwiń obszar projektu, a następnie rozwiń element Raporty.
  3. Kliknij prawym przyciskiem myszy pozycję Szablony raportów i wybierz opcję Wdrażaj nowe szablony.

Okno dialogowe pomaga poznać wszystkie szablony raportów, które są dostępne, ale jeszcze nie zostały wdrożone w obszarze projektu. Użytkownik może wybrać jeden lub więcej szablonów raportów, które zostaną utworzone. Umożliwi to tworzenie nowych raportów za pomocą działań dostępnych w menu.

Dostosowania

Aktualizacja z wersji 1.x do 2.0 zachowuje wszystkie zmiany wprowadzone do typów elementów pracy, atrybutów, przepływów pracy, ról oraz procedur obsługi zdarzeń. Jeśli wstępnie zdefiniowany szablon procesu (taki jak Scrum) został wcześniej dostosowany, należy pamiętać, że ponowne wdrożenie predefiniowanego szablonu (w widoku Szablony procesu) spowoduje nadpisanie dostosowań. Jeśli ponowne wdrożenie predefiniowanego szablonu jest konieczne, należy najpierw zmienić nazwę i identyfikator dostosowanego szablonu. Pozwoli to uniknąć jego nadpisania.


Opinia