Настройка базы данных SQL Server для Rational Engineering Lifecycle Manager

Настройте базу данных SQL Server для работы с Jazz Team Server, Rational Engineering Lifecycle Manager и приложением Configuration Management.

Прежде чем начать

Перед выполнением этой процедуры следует убедиться в соблюдении следующих требований для SQL Server:

Прим.: Если на сервере SQL настроен язык, отличный от английского, то перед созданием хранилища данных необходимо выбрать английский язык:
  1. В SQL Server Management Studio щелкните правой кнопкой мыши на соединении с сервером базы данных.
  2. Во всплывающем окне выберите Свойства.
  3. В окне Свойства сервера выберите Дополнительно и укажите для записи Язык по умолчанию значение Английский.
  4. Сохраните изменения.

Процедура

  1. Создайте базу данных для каждого экземпляра Jazz Team Server, Rational Engineering Lifecycle Manager и приложения Configuration Management. Создайте базу данных для хранилища данных, связанного с сервером Jazz Team Server. Например, в случае применения одного Rational Engineering Lifecycle Manager, одного приложения Configuration Management, одного Jazz Team Server и одного хранилища данных следует создать четыре базы данных. В следующем примере создается база данных Jazz Team Server. Для создания баз данных Rational Engineering Lifecycle Manager и приложения Configuration Management замените jts на имя базы данных, например relm и vvc:
    CREATE DATABASE jts 
    GO 
  2. Создайте пользователя и пароль и измените владельца каждой базы данных.
    Выполните следующие команды:
    CREATE LOGIN jtsDBuser
    WITH PASSWORD = 'jtsDBpswd';
    USE jts;
    exec sp_changedbowner 'jtsDBuser'
    GO 
  3. Измените последовательность упорядочения баз данных Jazz Team Server, Rational Engineering Lifecycle Manager и приложения Configuration Management. В командной строке введите следующую команду для Jazz Team Server. Для баз данных Rational Engineering Lifecycle Manager и приложения Configuration Management замените jts на relm или vvc.
    ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO
  4. Измените систему учета версий строк в базах данных Jazz Team Server, Rational Engineering Lifecycle Manager и приложения Configuration Management. В командной строке введите следующую команду для Jazz Team Server. Для баз данных Rational Engineering Lifecycle Manager и приложения Configuration Management замените jts на relm или vvc.
    Прим.: Перед выполнением этой команды убедитесь, что соединение с базой данных открыто.
    ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
    GO
  5. Измените подборку базы данных хранилища данных. В командной строке введите:
    ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
    GO
  6. Создайте переменную среды SQLSERVER_JDBC_DRIVER_FILE и укажите в ней драйвер JDBC sqljdbc4.jar. Расположение драйвера зависит от установки.
    Windows
    1. Выберите Пуск > Панель управления > Система.
    2. Откройте вкладку Дополнительно и нажмите кнопку Переменные среды.
    3. В списке Системные переменные нажмите кнопку Создать.
    4. В поле Имя переменной введите SQLSERVER_JDBC_DRIVER_FILE; в поле Значение переменной введите C:\путь-к-драйверу-JDBC\sqljdbc4.jar.
    Linux В системах UNIX добавьте следующее объявление переменной среды:
    SQLSERVER_JDBC_DRIVER_FILE =.:путь-к-драйверу-JDBC/sqljdbc4.jar
    Прим.: Rational Engineering Lifecycle Manager не поддерживает JRE 5.0. Поддерживаются JRE версий 6.0 и 7.0.

    В случае применения WebSphere Application Server также необходимо добавить пользовательское свойство, которое указывает на драйвер JDBC sqljdbc4.jar. Дополнительная информация приведена в разделе Настройка WebSphere Application Server для Rational Engineering Lifecycle Manager.

  7. Для настройки соединений с базами данных и создания таблиц базы данных выполните одно из следующих действий:
    1. Если применяется Tomcat или развертывается WebSphere Application Server, то запустите сервер и перейдите к разделу справки Работа с мастером настройки Jazz Team Server для приложений Rational Engineering Lifecycle Manager.
    2. Если вы предпочитаете вручную внести изменения в файл teamserver.properties для соединения с базой данных, выполните команды repotools для создания таблиц базы данных. Дополнительная информация приведена в разделе Настройка базы данных SQL Server вручную.
    3. В случае обновления предыдущей версии продолжите выполнение сценариев обновления для миграции существующих соединений с базой данных. Дополнительная информация об обновлении приведена в разделе Rational Engineering Lifecycle Manager.

Настройка базы данных SQL Server вручную

Для настройки соединений с базами данных и создания таблиц баз данных рекомендуется использовать мастер настройки. Если эту процедуру требуется выполнить вручную, измените файл teamserver.properties для настройки соединения с базой данных SQL Server и создания таблиц базы данных с помощью команды -createTables.

Procedure

  1. Для каждого приложения откройте и измените отдельный файл teamserver.properties. Каждый файл расположен в своем каталоге (jts, relm или vvc), расположенном в каталоге <каталог-установки-Jazz>/server/conf. Откройте каждый файл teamserver.properties и укажите сведения о базе данных и соединении.
    1. Поместите в комментарий следующие строки в разделе Derby Configuration, добавив символ (#) в начале каждой строки. Пример для файла teamserver.properties JTS:
      # com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/jts/derby/repositoryDB
    2. Раскомментируйте следующие строки в разделе SQL Server Configuration, удалив символ (#) в начале каждой строки:
      com.ibm.team.repository.db.vendor = SQLSERVER
      com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    3. Измените следующие значения в свойствах com.ibm.team.repository.db.jdbc.location и com.ibm.team.datawarehouse.db.jdbc.location:
      • //localhost:1433: введите полное имя хоста сервера баз данных.
        Note: С помощью инструмента SQL Server Configuration следует вручную установить статический порт равным 1443.
      • jazz: введите имя базы данных.
      • jazzDBuser: введите имя пользователя.
      Note: Не изменяйте текст password={password} в свойствах com.ibm.team.repository.db.jdbc.location и com.ibm.team.datawarehouse.db.jdbc.location.
    4. Укажите пароль пользователя в свойствах com.ibm.team.repository.db.jdbc.password и com.ibm.team.datawarehouse.db.jdbc.password.
    5. Измените значение в строке com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex на полный путь к полнотекстовому индексу. Например, введите com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/indices/workitemindex.
    6. Измените значение в строке com.ibm.team.jfs.index.root.directory=indices на полный путь к корневому каталогу индекса Jazz Foundation Service. Например, введите com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/indices.
  2. После создания базы данных запустите команду repotools, чтобы создать табличные пространства.
    Important: Команду createTables следует вызывать только для нового, недавно установленного продукта.
    Note: При запуске команды repotools выполняется обновление файла teamserver.properties, а его копия с исходным содержимым сохраняется в том же каталоге. При этом может появиться предупреждение о том, что внешний URI не задан. Его можно проигнорировать, поскольку внешний URI был указан в мастере настройки Jazz Team Server для приложений Rational Engineering Lifecycle Manager.
    1. Для создания таблиц базы данных для Jazz Team Server перейдите в каталог каталог-установки-Jazz/server и выполните следующую команду:
      repotools-jts -createTables 
    2. Для создания таблиц базы данных для приложения Rational Engineering Lifecycle Manager перейдите в каталог каталог-установки-RELM/server и выполните следующую команду:
      repotools-relm -createTables
    3. Для создания таблиц базы данных для приложения Управление конфигурацией перейдите в каталог каталог-установки-VVC/server и выполните следующую команду:
      repotools-vvc -createTables 

устранение неполадок

Procedure

  • Если не удается выполнить команду repotools, проверьте файлы протокола, расположенные в каталоге установочный-каталог-Jazz/server.
  • Проверьте правильность следующих условий:
    • SQL Server разрешает устанавливать соединения по протоколу TCP/IP. При необходимости перезапустите службу SQL.
    • В файлах teamserver.properties указаны правильные имя хоста и номер порта системы SQL Server.
    • В файлах teamserver.properties указаны правильные имя пользователя, пароль и имя базы данных.
    • Брандмауэр не запрещает доступ к SQL Server. Подключитесь к серверу с помощью команды Telnet. Введите имя хоста и номер порта из файла teamserver.properties.
    • Созданный пользователей обладает правильными правами доступа к базе данных Jazz Team Server.
    • В переменных среды драйвера JDBC должны быть указаны правильные значения.
    Note: Jazz Team Server может работать на разных платформах баз данных; однако разные базы данных используют разный синтаксис, стратегии оптимизации и семантику блокировки. Тестирование сервера выполнялось на сервере SQL Server с помощью набора автоматизированных тестов, а также имитаций обычных и пиковых нагрузок. Имитация обычных нагрузок показала приемлемую производительность. В некоторых случаях были обнаружены тупики базы данных в ходе выполнения автоматических параллельных тестов; однако на разном аппаратном обеспечении не удалось добиться их устойчивого воспроизведения.

    Сервер разработан для обработки большого числа параллельных запросов. В исключительных случаях могут возникать тупиковые ситуации в базе данных хранилища при параллельном обновлении аналогичных или одинаковых объектов в транзакциях, связанных с запросами. Это редкие, но допустимые события. Система обеспечивает защиту от тупиковых ситуаций, сохраняя целостность данных; данные не теряются. В ходе выполнения отдельных задач, таких как служба компоновки, в протоколах могут регистрироваться тупиковые ситуации. В общем случае при обнаружении такого условия задача повторяется.

    Все тупиковые ситуации регистрируются в протоколах сервера вместе с дополнительной информацией. Запись протокола выглядит следующим образом: com.ibm.team.repository.common.RetryableDatabaseException: Сбой сериализации.

    В случае обнаружения тупиковых ситуаций обратитесь к протоколу ошибок по адресу https://имя-сервера:9443/jts/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.

    Если тупиковые ситуации возникают часто, обратитесь в службу поддержки продукта. Кроме того, в форумах на веб-сайте jazz.net можно найти последнюю информацию, обновления и методики миграции.


Комментарии