Настройка базы данных Oracle для Rational Engineering Lifecycle Manager и Lifecycle Query Engine

Настройте базу данных Oracle для работы с сервером Jazz Team Server продукта Rational Engineering Lifecycle Manager, продуктом Rational Engineering Lifecycle Manager и приложением Управление конфигурацией.

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

При создании и настройке базы данных Oracle предполагается, что база данных была подготовлена пользователем с правами администратора базы данных, а база данных, хранилище табличного пространства и соответствующая конфигурация хранилища были созданы пользователем с правами системного администратора. На компьютере, который планируется использовать как сервер баз данных, должна быть установлена одна из следующих поддерживаемых редакций Oracle. Это может быть другой компьютер, чем тот, на котором установлен Jazz Team Server:
Прим.: Для применения Oracle 10g или 11g необходим драйвер Java™ Database Connectivity (JDBC) ojdbc6.jar версии 11.2.0.3 или более поздней версии. Кроме того, база данных должна быть обновлена до последней версии. Например, если сервер баз данных использует версию 11.2, то вам необходимо применять версию 11.2.0.3 или выше.
Важное замечание: Приведенные ниже параметры конфигурации и табличного пространства являются примерами и могут не в полной мере соответствовать требованиям вашей среды. Например, если нельзя использовать параметр AUTOEXTEND, то размер файлов должен быть достаточно велик и рассчитан на дальнейший рост. Если для пользователя базы данных Jazz Team Server нельзя установить квоту UNLIMITED, то необходимо предоставить достаточный объем памяти с расчетом на быстрый рост.
Важное замечание: Если приложения Rational Engineering Lifecycle Manager устанавливаются на одном компьютере или на распределенных платформах, то можно создать отдельную базу данных для каждого приложения или использовать одну базу данных для всех приложений. Однако для каждого приложения необходимо создать отдельное табличное пространство и связанного с ним пользователя базы данных.

Приведенные в этом разделе примеры рассчитаны на конфигурацию с одной базой данных Oracle и отдельным пользователем базы данных для каждого приложения.

Прим.: База данных, создаваемая для Jazz Team Server и всех приложений Rational Engineering Lifecycle Manager, должна иметь кодировку UTF-8. Oracle не создает базу данных с кодировкой UTF-8 по умолчанию. При создании новой базы данных необходимо выбрать параметр AL32UTF8 в программе настройки базы данных Oracle.

Процедура

  1. Действуя от имени системного администратора, создайте базу данных с кодировкой UTF8 для Jazz Team Server и всех приложений.
  2. Откройте окно SQL *Plus и создайте табличные пространства базы данных:
    CREATE TABLESPACE <табличное пространство пользователя relmjts> 
    DATAFILE '<имя файла .dbf и путь к нему>' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    CREATE TEMPORARY TABLESPACE <временное табличное пространство пользователя relmjts> 
    TEMPFILE '<имя временного файла .dbf и путь к нему>' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
  3. Если выполняется установка всех приложений Rational Engineering Lifecycle Manager, дважды повторите предыдущий шаг, чтобы создать отдельные табличные пространства для Rational Engineering Lifecycle Manager JTS (relmjts), Rational Engineering Lifecycle Manager (relm) и приложения Управление конфигурацией (vvc). Откройте Oracle Enterprise Manager Database Control и убедитесь в том, что созданные табличные пространства показаны и доступны.
  4. Создайте пользователя базы данных Oracle для каждого нового табличного пространства.

    После создания табличных пространств необходимо создать специального пользователя Oracle, который будет применяться каждым приложением при работе с базой данных Oracle. В том случае, если одна база данных Oracle используется несколькими серверами Jazz, для каждого приложения необходимо создать отдельного пользователя базы данных Oracle. У пользователя базы данных Oracle должна быть возможность создавать объекты базы данных в своем табличном пространстве (неограниченно или в рамках выделенной квоты памяти) и права на создание сеансов, таблиц, процедур и представлений.

    В приведенных примерах замените значения в угловых скобках на фактические значения.
    CREATE USER <пользователь БД relmjts> IDENTIFIED BY <пароль> DEFAULT TABLESPACE <табличное пространство пользователя relmjts> QUOTA UNLIMITED ON <табличное пространство пользователя relmjts> TEMPORARY TABLESPACE <временное табличное пространство пользователя relmjts>;
    После создания пользователя предоставьте ему права доступа, необходимые для инициализации базы данных Jazz. Эти права можно предоставить с помощью следующей команды SQL:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO <пользователь БД relmjts>;
    Прим.: Для создания хранилища в Oracle требуются более обширные права доступа, чем в других базах данных. Пользователь базы данных, указанный в спецификации соединения с хранилищем данных, должен иметь права администратора базы данных. Дополнительные сведения приведены в разделе справки Выполнение установки. Кроме того, предполагается, что существует табличное пространство с именем "USERS". Это стандартное табличное пространство Oracle. Если оно не существует в вашей базе данных Oracle, создайте его с помощью следующей команды.
    CREATE TABLESPACE USERS 
    DATAFILE '<имя файла .dbf и путь к нему>' 
    SIZE <размер табличного пространства> AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Создайте переменную среды с именем ORACLE_JDBC_DRIVER_FILE и укажите в ней расположение драйвера JDDC ojdbc6.jar. Это расположение зависит от версии продукта Oracle и операционной системы. Поддерживаемый драйвер JDBC (ojdbc6.jar 11.2.0.3) можно загрузить с веб-сайта www.oracle.com.
    1. Выберите Пуск > Панель управления > Система.
    2. Откройте вкладку Дополнительно и нажмите кнопку Переменные среды.
    3. В списке Системные переменные нажмите кнопку Создать.
    4. В поле Имя переменной введите значение ORACLE_JDBC_DRIVER_FILE, в поле Значение переменной введите C:\путь-к-драйверу-JDBC\ojdbc6.jar.
    1. В системах Linux добавьте следующее объявление переменной среды:
      ORACLE_JDBC_DRIVER_FILE =.;путь-к-драйверу-JDBC/ojdbc6.jar
      Прим.: Rational Engineering Lifecycle Manager не поддерживает JRE 5.0. Поддерживаются JRE версий 6.0 и 7.0. Для библиотеки классов ojdbc5.jar необходим JRE 5.0, а для библиотеки классов ojdbc6.jar - JRE 6.0 или более поздней версии. В связи с этим необходимо использовать ojdbc6.jar.

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

  6. Для настройки соединения с базой данных и создания таблиц базы данных выполните одно из следующих действий:
    1. Если применяется Tomcat, то запустите сервер и перейдите к разделу справки Работа с мастером настройки Jazz Team Server для приложений Rational Engineering Lifecycle Manager.
    2. Если выполняется развертывание WebSphere Application Server, обратитесь к разделу Работа с мастером настройки Jazz Team Server для приложений Rational Engineering Lifecycle Manager.

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

Об этой задаче

Для настройки соединений с базами данных и создания таблиц баз данных рекомендуется использовать мастер настройки. Для запуска мастера настройки выполните инструкции, приведенные в следующем разделе: Работа с мастером настройки Jazz Team Server для приложений Rational Engineering Lifecycle Manager

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

Процедура

  1. У каждого приложения есть свой файл teamserver.properties, который потребуется открыть и изменить. Каждый файл расположен в своем каталоге (relmjts, relm или vvc), расположенном в каталоге <каталог-установки-Jazz>/server/conf. Откройте каждый файл teamserver.properties и укажите сведения о базе данных и соединении.
    1. Поместите в комментарий следующие строки в разделе Derby Configuration, добавив символ (#) в начале каждой строки:
      # com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/relmjts/derby/repositoryDB
    2. Раскомментируйте следующие строки в разделе Oracle Configuration, удалив символ (#) в начале каждой строки:
      Прим.: Для каждого хранилища предусмотрено 2 строки для ввода расположения базы данных. Одна - для локальных систем, а вторая - для серверов баз данных в удаленных системах. Следует раскомментировать ту строку, которая соответствует конфигурации вашей среды. Ниже приведены примеры для удаленного сервера с удвоенной косой чертой перед URL сервера, @//oracleserver.example.com:1521/ORCL.
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:relmjtsDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=relmjtsDBpswd
    3. Измените следующие значения в строках com.ibm.team.repository.db.jdbc.location и com.ibm.team.datawarehouse.db.jdbc.location:
      • //oracleserver.example.com:1521: введите полное имя хоста сервера баз данных.
      • jtsDBuser: укажите пользователя базы данных.
      • jazzDBuser: укажите пользователя базы данных хранилища данных. Он должен иметь права администратора базы данных.
      • ORCL: введите имя службы Oracle. При подключении к базе данных Oracle убедитесь в том, что имя службы ORCL существует на компьютере сервера.
      Напоминание: URL Oracle может задаваться в различных форматах. Приведенные здесь примеры подходят в большинстве случаев. За дополнительной информацией обратитесь к документации по Oracle.
      Прим.: Не изменяйте текст 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/relmjts/indices/workitemindex на полный путь к полнотекстовому индексу. Например, введите com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/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/relmjts/indices.
  2. После создания базы данных вызовите команду инструментов хранилища для создания таблиц базы данных.
    Важное замечание: Команду createTables следует вызывать только для нового, недавно установленного продукта.
    Прим.: Команда -createWarehouse должна запускаться от имени пользователя, имеющего права администратора базы данных. .
    Прим.: При запуске команды repotools выполняется обновление файла teamserver.properties, а его копия с исходным содержимым сохраняется в том же каталоге. При этом может появиться предупреждение о том, что внешний URI не задан. Его можно проигнорировать, так как внешний URI будет задан на этапе Работа с мастером настройки Jazz Team Server для приложений Rational Engineering Lifecycle Manager.
    1. Для создания таблиц базы данных для Jazz Team Server перейдите в каталог каталог-установки-Jazz/server и запустите следующие команды:
      repotools-relmjts -createTables
    2. Для создания таблиц базы данных для приложения Rational Engineering Lifecycle Manager перейдите в каталог каталог-установки-RELM/server и запустите следующие команды:
      repotools-relm -createTables
    3. Для создания таблиц базы данных для приложения Управление конфигурацией перейдите в каталог каталог-установки-VVC/server и запустите следующие команды:
      repotools-vvc -createTables

Комментарии