Настройте базу данных Server SQL для работы с
Jazz Team Server.
В этой процедуре предполагается, что выполнены следующие
предварительные требования:
- Установите SQL Server.
- Запустите службу SQL Server.
- Установлены драйверы JDBC SQL Server. Дополнительная информация приведена в разделе
http://msdn2.microsoft.com/en-us/data/aa937724.aspx.
- Включите протокол TCP для SQL
Server.
- Пользователь, создающий таблицы базы данных, должен обладать
следующими правами доступа:
- Участник роли sysadmin сервера или владелец базы данных (dbo)
Напоминание: В файле
установочный-каталог-jazz/server/teamserver.properties по
умолчанию указаны следующие идентификационные данные пользователя
базы данных SQL Server: имя пользователя
- jazzDBuser, пароль -
jazzDBpswd. Эти
значения применяются ниже для создания базы данных. При
необходимости их
можно заменить идентификационными данными базы данных.
Настройка базы данных
В этом разделе
рассмотрена процедура настройки базы данных SQL Server с
помощью утилиты командной строки sqlcmd, входящей
в состав SQL Server. Кроме того, допустимо применение визуальной
утилиты, такой как SQL Server Studio Management, которая также
доступна для версии Express
(SQL Server Studio Management Express).
За дополнительной информацией обратитесь к документации по SQL Server
или администратору базы данных (DBA) SQL Server.
Для
настройки базы данных SQL Server с помощью команды
sqlcmd выполните следующие действия:
- Создайте базу данных
Jazz Team Server.
В командной строке введите следующую команду:
CREATE DATABASE jazz
Выполнить
- Создайте пользователя и пароль и измените владельца базы
данных Jazz Team Server.
В командной строке введите следующую команду:
CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBpswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
Выполнить
- Измените способ упорядочения базы данных Jazz Team Server.
В командной строке введите следующую команду:
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
GO
Настройка сервера
Напоминание: По умолчанию файл teamserver.properties, расположенный в
каталоге установочный-каталог-jazz/server, не настроен для
подключения к базе данных SQL Server. Все параметры по умолчанию (в том числе параметры SQL Server)
содержатся в файле teamserver.sqlserver.properties, который
расположен в том же каталоге.
Для настройки сервера выполните следующие
действия:
- Переименуйте следующие файлы:
- Измените имя файла
установочный-каталог-jazz/server/conf/jazz/teamserver.properties
на teamserver.OtherDBProvider.properties
- Измените имя файла
teamserver.sqlserver.properties на teamserver.properties
Совет: При необходимости с помощью переименованного файла
teamserver.properties можно восстановить предыдущую версию файла. По
умолчанию применяется провайдер DB
derby.
- При необходимости укажите в файле конфигурации сервера другое имя
пользователя, пароль, имя базы данных, порт или систему, в которой
установлен сервер SQL. Откройте файл teamserver.properties в
каталоге установочный-каталог-jazz/server/conf/jazz
и измените следующую информацию с учетом текущей
конфигурации.
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
Важное замечание: Не изменяйте текст password={password} в свойстве
com.ibm.team.repository.db.jdbc.location.
Пароль пользователя должен быть указан в свойстве
com.ibm.team.repository.db.jdbc.password.
Важное замечание: Только в Windows®. Убедитесь, что для сервера указан смешанный режим
защиты. Для этого проверьте защиту сервера. Должен быть задан
"Режим идентификации
Windows SQL Server".
Укажите расположение файла jar для
JDBC:
- В каталоге сценариев сервера
(установочный-каталог-jazz/server) создайте каталог
sqlserver.
- Найдите файл драйвера JDBC SQL Server с именем
sqljdbc.jar.
Расположение зависит от каталога, в котором были
установлены драйверы (см. раздел предварительных требований). Скопируйте файл в созданный каталог sqlserver.
- Укажите расположение файла jar для JDBC. Для этого
выполните следующую задачу:
- В переменной среды SQLSERVER_ABSPATH укажите
каталог, содержащий файл JAR. Если путь к каталогу содержит
пробелу, то его необходимо заключить в кавычки.
Совет: В случае применения WebSphere
Application Server настройте свойство
SQLSERVER_JDBC; укажите в нем полный путь к
каталогу (не URL), содержащему драйверы JDBC SQL, например,
если файл sqljdbc.jar расположен в каталоге
JazzInstallDir/server/sqlserver.
За дополнительной информацией обратитесь к инструкциям по
настройке
WebSphere Application
Server. Запомните путь к файлу.
устранение неполадок
Если в ходе выполнения команды repotools возникнут ошибки,
проверьте файл протокола repotools_createTables.log, расположенный в
каталоге
установочный-каталог-jazz/server.
Кроме того, проверьте следующие
условия:
- SQL Server разрешает устанавливать соединения по протоколу
TCP/IP. При необходимости перезапустите службу SQL.
- В файле teamserver.properties указаны правильные имя хоста и
номер порта системы SQL Server.
- В файле teamserver.properties указаны правильные имя
пользователя, пароль и имя базы данных.
- Брандмауэр не запрещает доступ к SQL Server.
Подключитесь к системе с помощью команды telnet, указав имя хоста и
номер порта из файла teamserver.properties.
- Созданный пользователь обладает необходимыми правами доступа к базе
данных
Jazz Team Server.
Прим.: Код базы данных
Jazz Team Server
был разработан для поддержки разных
платформ баз данных; однако разные вендоры баз данных
используют разный синтаксис, стратегии оптимизации и семантику
блокировки. Тестирование
сервера выполнялось на сервере SQL Server с помощью набора
автоматизированных тестов, а также имитаций обычных и пиковых
нагрузок. Имитация
обычных нагрузок показала приемлемую производительность. В некоторых
случаях были обнаружены тупики базы данных в ходе выполнения
автоматических параллельных тестов; однако на разном аппаратном
обеспечении не удалось добиться их устойчивого воспроизведения.
Сервер разработан для обслуживания большого
числа параллельных запросов. В исключительных случаях могут возникать
тупиковые ситуации в базе данных хранилища при параллельном
обновлении аналогичных или одинаковых объектов в транзакциях,
связанных с запросами. Это редкие, но допустимые события. Система обеспечивает защиту от
таких ситуаций, сохраняя целостность данных; данные не теряются.
В
ходе выполнения отдельных задач, таких как служба
компоновки, в протоколах могут регистрироваться тупиковые ситуации. В
общем случае при обнаружении такого условия задача
повторяется.
Тупиковая ситуация может привести к сбою компоновки. В очень редких
случаях для устранения тупиковой ситуации может потребоваться
отменить действие пользователя, например,
при работе с заданиями или исходным кодом. Действие пользователя не
будет выполнено с выдачей сообщения об ошибке, вызванной тупиковой
ситуацией. Пользователь может повторить действие.
Все
обнаруженные тупиковые ситуации регистрируются в протоколах сервера
вместе с дополнительной информацией. Запись протокола выглядит
следующим образом: com.ibm.team.repository.common.RetryableDatabaseException:
Сбой сериализации.
В случае обнаружения
тупиковых ситуаций обратитесь к протоколу ошибок по следующему
адресу:
https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.
Если
тупиковые ситуации возникают часто, обратитесь в службу поддержки
продукта. Кроме того, в форумах на веб-сайте jazz.net можно найти
последнюю информацию, обновления и
методики миграции.