Konfigurowanie bazy danych Oracle do pracy z produktem Jazz Team Server.
Zanim rozpoczniesz
Założono że spełnione są następujące wymagania wstępne. Aby uzyskać pomoc, należy
skonsultować się z administratorem bazy danych Oracle (DBA) lub sprawdzić w dokumentacji bazy danych Oracle.
- Baza danych Oracle jest zainstalowana na maszynie, która ma być używana jako serwer bazy danych. Może to być komputer inny niż ten, na którym uruchomiono produkt
Jazz Team Server.
- Domyślna baza danych istnieje na serwerze Oracle.
Wskazówka: Instalując bazę danych Oracle,
można automatycznie utworzyć bazę danych.
Ważne: Aby zapewnić prawidłową obsługę treści Unicode, zestaw znaków bazy danych musi być kodowany w UTF-8.
- Użytkownik wykonujący te instrukcje posiada uprawnienia administrowania systemem na bazie danych Oracle.
Uruchamiając produkt Jazz Team Server na
bazie danych Oracle, utwórz obszar tabel bazy danych Oracle, aby zwiększyć wydajność. Należy utworzyć użytkownika powiązanego z tym obszarem tabel.
Zapamiętaj: Żaden
z tych kroków nie jest wykonywany przez program budujący bazy danych przy użyciu narzędzi repozytorium.
O tym zadaniu
Aby skonfigurować bazę danych Oracle:
Procedura
- Utwórz obszar tabel. Położenie obszaru tabel musi być odpowiednie dla maszyny i napędu dysków.
Ten krok musi zostać wykonany przez użytkownika z uprawnieniami administratora DBA.
Uwaga: Obszar tabel może posiadać dowolne z poniższych właściwości:
- Nazwę inną niż oracle_tbs
- Położenie w innym katalogu
- Wielkość przekraczająca 1GB. Dla większych instalacji należy przydzielić więcej miejsca.
Poniższy przykład ilustruje instrukcję create wykonywaną na komputerze z systemem Windows®:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
Ważne: Ścieżka do katalogu (w tym przykładzie D:\oracle_tbs)
musi istnieć. Nie jest konieczne tworzenie osobnego specjalnego obszaru tabel.
Można użyć domyślnego obszaru tabel Oracle (USERS),
ale baza danych Oracle osiąga większą wydajność, korzystając z wstępnie przydzielonego obszaru na dysku, którym zarządza.
- Utwórz użytkownika bazy danych Oracle.
Po utworzeniu obszaru tabel należy utworzyć specjalnego użytkownika bazy danych Oracle, aby produkt Jazz mógł
korzystać z bazy danych Oracle.
W tym przykładzie użytkownikowi przypisano nazwę jazzDBuser oraz hasło (IDENTIFIED
BY w terminologii Oracle) jazzDBpswd; użytkownik ten
istnieje w obszarze tabel utworzonym w sekcji 1.
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs;
Po utworzeniu
użytkownika należy nadać mu wymagane uprawnienia niezbędne do zainicjowania bazy danych platformy Jazz. Do nadania odpowiednich uprawnień można użyć poniższych komend SQL:
GRANT CREATE SESSION TO jazzDBuser;
GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
GRANT CREATE PROCEDURE TO jazzDBuser;
GRANT CREATE VIEW TO jazzDBuser;
- Znajdź plik teamserver.properties w kataloguJazzInstallDir/server/conf/jazz i
zmień jego nazwę na teamserver.OtherDBProvider.properties.
- Znajdź plik teamserver.oracle.properties w kataloguJazzInstallDir/server/conf/jazz i
zmień jego nazwę na teamserver.properties.
Wskazówka: Zmiana nazwy oryginalnego pliku teamserver.properties umożliwia
odtworzenie pliku do poprzedniej, działającej wersji. Domyślnym dostawcą bazy danych jest derby.
- Skonfiguruj serwer
- Jeśli użyta została inna nazwa użytkownika, hasło lub nazwa bazy danych, jeśli serwer bazy danych Oracle
został zainstalowany na maszynie innej niż ta, na której zainstalowano produkt Jazz Team Server lub
jeśli używany jest port inny niż domyślny, przeprowadź edycję pliku konfiguracyjnego serwera. Otwórz plikteamserver.properties znajdujący się w katalogu JazzInstallDir/server/conf/jazz
i zmień pokazane poniżej informacje, tak aby odpowiadały bieżącej konfiguracji.
com.ibm.team.repository.db.vendor
= ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
Zastąp jazzDBuser nazwą użytkownika utworzonego dla produktuJazz do korzystania z bazy danych Oracle. Jeśli korzystasz z hosta lokalnego, usuń znak komentarza (#) na początku tego wiersza i wstaw go na początku następnego wiersza opisującego położenie. Łańcuchy określające połączenie z hostem lokalnym nie powinny zawierać poprzedzających podwójnych ukośników //. Zamień port 1521 na port TCIP serwera bazy danych Oracle. Zamień ORCL na własną nazwę bazy danych Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//serweroracle.przyklad.pl:1521/ORCLZapamiętaj: Adresy URL położenia bazy danych Oracle mogą przyjmować różne formy. Przedstawione przykłady działają w większości przypadków. Więcej szczegółów można znaleźć w dokumentacji interfejsu JDBC bazy danych Oracle.
Jeśli korzystasz z połączenia z hostem innym niż lokalny, usuń znak komentarza (#) na początku tego wiersza i wstaw go na początku poprzedniego wiersza opisującego położenie. Łańcuchy określające połączenie z hostem innym niż lokalny muszą zawierać poprzedzające podwójne ukośniki //.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Zastąp jazzDBpswd hasłem użytkownika utworzonego dla produktu Jazz do korzystania z bazy danych Oracle.
Ważne: Nie zmieniaj tekstu {password}
we właściwości com.ibm.team.repository.db.jdbc.location.
Hasło użytkownika musi zostać określone we właściwościcom.ibm.team.repository.db.jdbc.password.
W przypadku produktu Oracle Express podaj 1521 jako port TCIP i XE jako nazwę bazy danych Oracle:
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
- W katalogu zawierającym skrypty serwera (JazzInstallDir/server)
utwórz katalog o nazwie oracle.
- Znajdź plik JAR sterownika interfejsu JDBC Oracle o nazwie ojdbc14.jar.
Położenie może się różnić, zależnie od produktu Oracle i systemu operacyjnego. Skopiuj ten plik do katalogu o nazwieoracle.
Uwaga: Korzystając z WebSphere Application Server,
skonfiguruj właściwość o nazwie "ORACLE_JDBC"; następnie nadaj jej wartość odpowiadającą bezwzględnej ścieżce do katalogu (nie adresowi URL) zawierającego sterowniki interfejsu JDBC Oracle, np. jeśli plik ojdbc14.jar znajduje się w kataloguJazzInstallDir/server/oracle.
To zadanie jest opisane w sekcji Instalowanie WebSphere Application Server. Zanotuj ścieżkę do pliku na potrzeby późniejszego użycia w tych instrukcjach.
- Otwórz okno SQL plus i wpisz następującą komendę:
GRANT DBA TO jazzDBuser;