Czynności dla adaptera produktu Rational ClearQuest na serwerze WebSphere Application Server

Biblioteki współużytkowane produktu IBM® Rational ClearQuest mogą być udostępnione aplikacji Data Services produktu IBM Rational Publishing Engine. Umożliwia to korzystanie z interfejsu API produktu Rational ClearQuest z poziomu produktu Rational Publishing Engine.

Zanim rozpoczniesz

  • Produkt Rational ClearQuest należy zainstalować na tym samym komputerze co serwer aplikacji.
  • Należy wdrożyć aplikację Data Services i adaptery usług danych raportowania produktu Rational Publishing Engine.
  • Przed rozpoczęciem konfigurowania bibliotek współużytkowanych produktu Rational ClearQuest należy usunąć przyczyny wyświetlania ostrzeżeń firewalla i rozwiązać problemy z licencją, jeśli takie wystąpią.

Procedura

  1. Dodaj ścieżki do bibliotek współużytkowanych w instalacji produktu Rational ClearQuest do węzła serwera WebSphere Application Server, w którym została wdrożona aplikacja Data Services produktu Rational Publishing Engine:
    1. Na serwerze WebSphere Application Server kliknij opcję Środowisko > Biblioteki współużytkowane.
    2. Aby określić ustawienie zakresu, wybierz wpis Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer. RationalPublishingEngineNode01 to domyślna nazwa węzła, a RationalPublishingEngineServer to domyślna nazwa serwera.
    3. Aby utworzyć odwołanie do biblioteki współużytkowanej, kliknij opcję Nowy.
    4. Ustaw wartości dla zmiennych Nazwa, Opis i Ścieżka klasy. Upewnij się, że ścieżka klasy odwołuje się do plików w poprawnych położeniach.
      Tabela 1. Pola odwołań do biblioteki współużytkowanej
      Opis Wartości
      Nazwa Interfejs API produktu CM produktu ClearQuest
      Opis Biblioteka współużytkowana adaptera produktu ClearQuest.
      Ścieżka klasy

      pliki_aplikacji\IBM\RationalSDLC\ClearQuest\cqjni.jar
      pliki_aplikacji\IBM\RationalSDLC\ClearQuest\stpcq.jar
      pliki_aplikacji\IBM\RationalSDLC\Common\stpcmmn.jar
      pliki_aplikacji\IBM\RationalSDLC\Common\stpwvcm.jar

      Uwaga: Powyższe wartości to wartości domyślne dla produktu Rational ClearQuest 7.1. Rzeczywiste ścieżki do użycia zależą od miejsca, w którym zainstalowano produkt Rational ClearQuest, oraz od zainstalowanej wersji tego produktu. Należy upewnić się, że ścieżki odwołują się do plików w poprawnych miejscach. Aby wyświetlić miejsce instalacji produktu Rational ClearQuest, należy otworzyć program IBM Installation Manager, klikając opcję Start > Wszystkie programy > IBM Installation Manager > Przeglądaj zainstalowane pakiety.
    5. Kliknij przycisk OK, a następnie kliknij przycisk Zapisz.
  2. Powiąż biblioteki współużytkowane produktu Rational ClearQuest z profilem aplikacji Data Services:
    1. Kliknij opcję Serwery > Serwery aplikacji.
    2. Kliknij serwer, na którym wdrożono aplikację Data Services. Domyślna nazwa serwera to RationalPublishingEngineServer.
    3. Kliknij opcję Infrastruktura serwera > Język Java i zarządzanie procesami > Program ładujący klasy.
    4. Aby utworzyć program ładujący klasy dla bibliotek współużytkowanych, kliknij opcję Nowy > OK.
    5. Aby powiązać odwołania biblioteki współużytkowanej z programem ładującym klasy, kliknij odsyłacz hipertekstowy nowego programu ładującego klasy utworzonego w kroku podrzędnym 2.d.
    6. W przypadku każdej biblioteki, która ma zostać powiązana, kliknij przycisk Dodaj, wybierz bibliotekę i kliknij przycisk OK.
    7. Kliknij opcję Odniesienia bibliotek współużytkowanych.
    8. Aby powiązać każdą bibliotekę, kliknij przycisk Dodaj, wybierz bibliotekę i kliknij przycisk OK.
    9. Kliknij przycisk Zapisz.
  3. Ikona systemu Linux Jeśli używany jest system Linux, skonfiguruj ogólny argument maszyny JVM:
    1. Kliknij opcję Serwery > Typy serwerów > Serwery WebSphere Application Server.
    2. Kliknij nazwę serwera.
    3. W sekcji Infrastruktura serwera rozwiń menu Język Java i zarządzanie procesami, a następnie kliknij opcję Definicja procesu.
    4. Kliknij opcję Wirtualna maszyna języka Java.
    5. W polu Ogólne argumenty maszyny JVM wprowadź wartość: Ogólne argumenty maszyny JVM -Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib
    6. Kliknij przycisk OK.
  4. Ikona systemu Linux Jeśli używany jest system Linux, skonfiguruj zmienną środowiskową LD_LIBRARY_PATH:
    1. Na stronie Definicja procesu kliknij opcję Wpisy środowiskowe, a następnie kliknij opcję LD_LIBRARY_PATH.
    2. Wprowadź nazwę i ścieżkę do biblioteki. Przykład: /opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
  5. Zrestartuj aplikację Data Services.
  6. Sprawdź, czy poprawnie skonfigurowano biblioteki i adapter produktu IBM Rational ClearQuest. W przeglądarce należy wprowadzić adres URL adaptera produktu Rational ClearQuest.
    • Wprowadź adres http://host:port/DataServices/ClearQuest. Jeśli instalacja jest poprawna, zostanie wyświetlona lista połączeń produktu Rational ClearQuest, która jest taka sama, jak wyświetlana w narzędziu konserwacji produktu Rational ClearQuest.
    • Wprowadź adres http://host:port/DataServices/ClearQuest/wersja. Jeśli instalacja jest poprawna, zostanie wyświetlona lista baz danych użytkownika produktu Rational ClearQuest.
    • Wprowadź adres http://host:port/DataServices/ClearQuest/wersja/nazwa_bazy_danych. Jeśli instalacja jest poprawna, zostanie wyświetlona lista zapytań.

Co dalej

Należy skopiować adres URL zapytania, aby dodać go do szablonu lub specyfikacji dokumentu.
Uwaga: Aplikacja Data Services obsługuje tylko zapytania ze statycznymi tabelami wynikowymi. Zapytania dynamiczne nie są obsługiwane.

Przykład:

Za pomocą adresu URL zapytania All Defects wyświetlana jest tabela wynikowa o liczbie trafień, jaką zwróciłoby zapytanie dla klienta produktu Rational ClearQuest. Każdy wynik jest unikalnym identyfikatorem DBID dla konkretnego typu rekordu. Ten proces można kontynuować do czasu, aż zostaną zwrócone dane konkretnego rekordu. Adres URL zapytania należy zachować w celu użycia go podczas tworzenia treści raportów produktu Rational Publishing Engine.

Należy usunąć argumenty znajdujące się po znaku zapytania, wraz z tym znakiem:

Przed:
http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
Po: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


Opinia