Nastavte databázi SQL Server, aby fungovala s produktem Jazz Team Server.
U tohoto postupu se předpokládá, že byly splněny následující nezbytné předpoklady:
- Máte nainstalovanou databázi SQL Server.
- Je spuštěna služba SQL Server.
- Máte nainstalované ovladače JDBC pro SQL Server. Další informace viz http://msdn2.microsoft.com/en-us/data/aa937724.aspx.
- Je povolený protokol TCP pro SQL Server.
- Uživatel, který vytváří tabulku DB, musí mít některé z následujících oprávnění:
- Členství v pevné serverové roli sysadmin nebo vlastnictví databáze (dbo).
Zapamatujte si: Výchozí přihlašovací jméno definované v souboru JazzInstallDir/server/teamserver.properties pro databázi SQL Server je jazzDBuser a výchozí heslo je jazzDBpswd. V níže uvedených krocích pro vytvoření databáze se používají tyto hodnoty. Tyto hodnoty můžete nahradit jménem uživatele a heslem pro vaši databázi.
Nastavení databáze
Tento oddíl popisuje, jak nastavit databázi SQL Server za pomoci nástroje příkazového řádku sqlcmd, který je poskytován s instalací databáze SQL Server. Můžete také použít vizuální nástroj, jako např. SQL Server Studio Management, který je dostupný i pro verzi Express jako SQL Server Studio Management Express. Další informace viz dokumentace databáze SQL Server nebo administrátor databáze SQL Server (DBA).
Chcete-li nastavit databázi SQL pomocí nástroje příkazu sqlcmd:
- Vytvořte databázi produktu Jazz Team Server.
Z příkazového řádku zadejte:
CREATE DATABASE jazz
GO
- Vytvořte uživatele a heslo a změňte vlastnictví databáze pro produkt Jazz Team Server.
Z příkazového řádku zadejte:
CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBpswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
GO
- Změňte řazení databáze produktu Jazz Team Server.
Z příkazového řádku zadejte:
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
GO
Konfigurace serveru
Zapamatujte si: Standardně není soubor teamserver.properties v adresáři JazzInstallDir/server nastaven pro připojení k databázi SQL Server. Veškerá výchozí nastavení spolu s nastaveními specifickými pro SQL Server jsou uložena v souboru teamserver.sqlserver.properties ve stejném adresáři.
Chcete-li nakonfigurovat server:
- Přejmenujte tyto soubory:
- Přejmenujte soubor JazzInstallDir/server/conf/jazz/teamserver.properties na teamserver.OtherDBProvider.properties.
- Přejmenujte soubor teamserver.sqlserver.properties na teamserver.properties.
Tip: Přejmenování původního souboru teamserver.properties vám umožní obnovit předchozí fungující verzi soubor. Poskytovatel DB standardně používá derby.
- Upravte konfigurační soubor serveru, pokud jste použili jiné jméno uživatele, heslo nebo název db, nainstalovali databázi SQL Server na jiný počítač než produkt Jazz Team Server nebo používáte jiný než výchozí port. Otevřete soubor teamserver.properties v adresáři JazzInstallDir/server/conf/jazz a změňte níže uvedené informace tak, aby odpovídaly vašemu nastavení.
com.ibm.team.repository.db.vendor = SQLSERVER
com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
Důležité: Neměňte text password={password} ve vlastnosti com.ibm.team.repository.db.jdbc.location.
Musí být zadáno heslo uživatele ve vlastnosti com.ibm.team.repository.db.jdbc.password.
Důležité: Pouze pro systém Windows. Ujistěte se, že je zabezpečení vašeho
serveru v kombinovaném režimu. Můžete to ověřit kontrolou zabezpečení
serveru. Mělo by být nastaveno na "Režim ověření SQL Server
a Windows".
Určení umístění souboru jar pro JDBC:
- V adresáři, kde se nacházejí skripty serveru (JazzInstallDir/server), vytvořte adresář s názvem sqlserver.
- Vyhledejte soubor JAR s ovladačem JDBC pro SQL Server nazvaný sqljdbc.jar.
Umístění se může lišit v závislosti na tom, kam byly ovladače nainstalovány, jak je uvedeno v oddíle nezbytných položek. Zkopírujte soubor do nově vytvořeného adresáře sqlserver.
- Určete umístění souboru JDBC JAR pro JDBC pomocí následující úlohy:
- Nastavte proměnnou prostředí SQLSERVER_ABSPATH tak, aby ukazovala na adresář, který obsahuje soubor JAR. Pokud jsou součástí cesty mezery, musíte cestu uvést v uvozovkách.
Tip: Pokud
používáte produkt WebSphere Application Server, nakonfigurujte
vlastnost s názvem SQLSERVER_JDBC; potom ji nastavte
na absolutní cestu k adresáři (ne adresu URL), která obsahuje ovladače JDBC
SQL Serveru, například pokud se váš soubor sqljdbc.jar
nachází v adresáři JazzInstallDir/server/sqlserver.
Další informace viz návod k nastavení produktu WebSphere Application Server.
Poznamenejte si cestu k souboru - použijete ji dále v těchto pokynech.
Odstraňování problémů
Pokud příkaz nástrojů Repotool není úspěšný, zkontrolujte soubor protokolu s názvem repotools_createTables.log v adresáři JazzInstallDir/server.
Také ověřte následující:
- Produkt SQL Server je nakonfigurovaný tak, aby umožňoval připojení použitím protokolu TCP/IP. V případě potřeby restartujte službu SQL.
- Název hostitelského počítače produktu SQL Server a port je správně uveden v souboru teamserver.properties.
- Přihlašovací jméno, heslo a název databáze jsou správně uvedeny v souboru teamserver.properties.
- Brána firewall vám nebrání v přístupu k produktu SQL Server.
Pomocí příkazu programu telnet se připojte k počítači s použitím názvu hostitele a portu ze souboru teamserver.properties.
- Vytvořený uživatel má v databázi produktu Jazz Team Server náležitá oprávnění.
Poznámka: Kód databáze pro produkt
Jazz Team Server byl navržen jako generický a standardní, aby jej bylo možné spouštět na různých databázových platformách; mezi dodavateli podnikových databázi však existují rozdíly v syntaxi, strategiích optimalizace a sémantice zamykání. Server byl otestován na produktu SQL Server použitím kombinace automatizovaných testů a simulací normální pracovní zátěže a zátěžového testování. Simulace normální pracovní zátěže vykázala přijatelný výkon. V některých instancích byla v automatických testech souběžnosti pozorována uváznutí databáze; ta však nebyla na jiném hardwaru serveru konzistentně reprodukována.
Server je určen pro obsluhu velkého počtu současných požadavků. Ve výjimečných případech může docházet k uváznutí v databázi úložiště, když jsou v transakcích přidružených k požadavkům souběžně aktualizovány podobné nebo stejné objekty. Tyto události jsou vzácné, ale normální. Systém je navržen tak, aby se proti tomu bránil, a integrita dat zůstává zachována; žádná data nejsou ztracena.
Občas je uváznutí zaprotokolováno úlohou, jako např. provedením sestavovacího stroje. Tento stav je obvykle zjištěn a úloha zopakována.
Uváznutí může způsobit nezdar sestavení. Ve velmi vzácných případech může být kvůli vyřešení uváznutí zrušena akce uživatele, například práce s pracovními položkami nebo se zdrojovým kódem. V takovém případě se akce uživatele nezdaří a uživateli se zobrazí chyba s podrobnostmi o uváznutí. Potom může uživatel akci zopakovat.
Všechna rozpoznaná uváznutí jsou serverem zaprotokolována, aby byly k dispozici informace o tom, k čemu při uváznutí došlo. Položka protokolu obsahuje přibližně tento text: com.ibm.team.repository.common.RetryableDatabaseException:
Serialization failure.
Pokud ve vašem systému dochází k uváznutí, prostudujte protokol chyb, který je dostupný na adrese https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.
Pokud se s výjimkami spojenými s uváznutím setkáváte často, obraťte se na podporu produktu nebo navštivte fóra a webu jazz.net, kde naleznete nejnovější informace, aktualizace či metody zmírnění dopadů.