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

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


Opinia