Установка и поддержка IBM RTC 3.0.1

1. Практическое руководство
IBM Rational Team Concert
3.0.1
Установка и поддержка
Шамрай А.В.
[Выберите дату]

2. 1
Оглавление
1 Установка IBM Installation Manager......................................................................................................... 2
2 Подготовка баз данных MS SQL .............................................................................................................. 3
3 Установка IBM Rational Jazz..................................................................................................................... 8
4 Настройка подключения к SQL Server................................................................................................... 12
5 Первая настройка.................................................................................................................................. 12
6 Настройка запуска сервера в виде сервиса.......................................................................................... 18
6.1 Предварительные шаги................................................................................................................. 18
6.2 Установка сервиса ......................................................................................................................... 18
7 Отключение использования сертификата безопасности ..................................................................... 20
8 Подключение к Active Directory ............................................................................................................ 21
8.1 Предварительные шаги................................................................................................................. 21
8.2 Настройка....................................................................................................................................... 22
9 Настройка сбора отчетных данных....................................................................................................... 25
10 Управление лицензионными ключами. ........................................................................................... 25
11 Управление пользователями ............................................................................................................ 26
11.1 Создание пользователей............................................................................................................... 26
11.2 Управление лицензиями клиента ................................................................................................. 27
11.3 Присвоение лицензии по умолчанию........................................................................................... 28
11.4 Архивирование и восстановление пользователей....................................................................... 29
12 Резервное копирование баз данных ................................................................................................ 29
12.1 Выполнение резервного копирования ......................................................................................... 29
12.2 Восстановление резервной копии ................................................................................................ 29
13 Обновление до версии 4................................................................................................................... 30

3. 2
1 Установка IBM Installation Manager
1. Перейти на сетевой ресурс с разархивированным дистрибутивом и запустить на исполнение
install.exe:
2. В появившемся диалоговом окне выбрать необходимые компоненты и нажать Далее.
3. Согласиться с лицензионным соглашением и нажать Далее.
4. Выбрать необходимый каталог для установки и нажать Далее.

4. 3
5. На последнем шаге нужно нажать кнопку Установить.
6. После окончания установки нажать Перезапустить Installation Manager.
2 Подготовка баз данных MS SQL
1. Запустить диспетчер конфигурации SQL Server

5. 4
2. Проверить доступность протокола TCP/IP
3. По необходимости перезапустить службу SQL Server
4. Запустить средство управления SQL Server

6. 5
5. Проверить наличие смешанного режима авторизации
6. Создать новую базу данных и проверить у нее установку case-sensitive кодировки

7. 6
7. Создать базы данных ccm, qm, warehouse.
8. Установить с помощью запроса для всех новых баз данных параметр уровня изоляции
моментальных снимков.

8. 7
9. Создать нового пользователя для подключения к базе данных и задать ему роль владельца для
новой базы данных

9. 8
10. Создать нового пользователя RPTUSER без привязки к базам данных.
3 Установка IBM Rational Jazz
1. Запустить IBM Installation Manager
2. Выбрать пункт меню ФайлПараметры.
3. Добавить в расположение хранилища репозитория.

10. 9
4. Сохранить изменения.
5. Запустить процесс установки.
6. Выбрать необходимые компоненты и нажать Далее.
7. Принять условия лицензионного соглашения и нажать Далее..
8. Указать расположение общих ресурсов и нажать Далее.

11. 10
9. Указать расположение сервера Jazz и нажать Далее.
10. Выбрать необходимые языки пользовательского интерфейса и нажать Далее.
11. Выбрать необходимые пакеты и нажать Далее.

12. 11
12. Указать необходимые общие параметры и нажать Далее.
13. На заключительном этапе нажать Установить.
14. После установки выбрать необходимые действия и нажать Готово.

13. 12
4 Настройка подключения к SQL Server
1. Найти файл драйвера JDBC SQL Server с именем sqljdbc.jar. Расположение зависит от каталога, в
котором были установлены драйверы
(http://www.microsoft.com/downloads/details.aspx?FamilyID=99b21b65-e98f-4a61-b811-
19912601fdc9&displaylang=en). Скопировать файл в созданный каталог sqlserver.
2. Указать расположение файла jar для JDBC через системную переменную. Для этого выполнить
следующее:
5 Первая настройка
1. Запустить Jazz Team Server

14. 13
2. Дождаться загрузки сервера
3. Запустить браузер и перейти по адресу https://localhost:9443/jts/setup
4. Ввести учетные данные ADMIN/ADMIN.
5. На странице приветствия нажать кнопку Далее.
6. Ввести внешний адрес, по которому будет доступен сервер, согласить с предупреждением и нажать
Далее.

15. 14
7. По необходимости повторить ввод логина и пароля.
8. На следующем шаге указать параметры подключения и нажать Создать таблицы на следующей
странице.
9. После успешного создания таблиц нажать Далее.
10. Задать параметры уведомления по необходимости, нажать Проверить соединение и затем нажать
Далее.

16. 15
11. На следующем шаге необходимо дождаться окончания поиска приложений.
12. На следующем шаге нужно нажать Зарегистрировать приложения.

17. 16
13. После окончания регистрации нажать Далее.
14. На следующем шаге нужно ввести данные о базе пользователей, внести информацию об учетной
записи администратора и по необходимости удалить учетную запись по умолчанию. После
настройки нажать Далее.
15. На странице определения хранилища данных указать необходимые данные и нажать кнопку
Создать таблицы.

18. 17
16. Выполнить настройку баз данных для каждого приложения.
Примечание: Приложение управления требованиями будет использовать ту же базу, что и
приложение JTS, поэтому для него не нужно будет указывать базы данных и хранилище.
Примечание: Для каждой базы сбора данных необходимо указать разных пользователей, которые
запускают задания по сбору данных.
17. На завершении настройки нажать Предоставить права доступа, а затем Завершить настройку
приложения.

19. 18
6 Настройка запуска сервера в виде сервиса
6.1 Предварительные шаги
1. Для каждого установленного сервиса (jts, ccm, qm, rm) выполнить следующие действия:
1.1. Открыть файл<JazzInstallDir>serverconf<приложение>log4j.properties.
1.2. Изменить строку log4j.appender.file.File=logs/<приложение.log> на
log4j.appender.file.File=C:/PROGRA~2/IBM/JazzTeamServer/server/logs/<приложение.log>.
1.3. Изменить строку log4j.appender.etl.File=logs/<приложение.log> на
log4j.appender.etl.File=C:/PROGRA~2/IBM/JazzTeamServer/server/logs/<приложение-etl.log>.
Примечание: для путей использовать косую черту (/).
6.2 Установка сервиса
1. Установить переменную среды CATALINA_HOME и перезагрузить систему:
1.1. Перейти к настройке переменных среды.
1.2. Создать новую переменную среды CATALINA_HOME со значением C:<Путь установки
Jazz>servertomcat

20. 19
1.3. Перезагрузить систему.
2. Установить запуск сервера как сервис с помощью команды в каталоге <Путь установки
Jazz>servertomcatbin:
service.bat install tomcat5
3. Запустить программу <Путь установки Jazz>servertomcatbintomcat5w.exe для конфигурирования
сервиса.
4. Установить тип запуска автоматический.
5. Указать расположение java machine
6. Добавить опции к Java Options:

21. 20
-DJAZZ_HOME=file:///C:/PROGRA~2/IBM/JazzTeamServer/server/conf
-Djava.awt.headless=true
-Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true
-Dcom.ibm.team.repository.tempDir=%TEMP%
-Djazz.connector.sslProtocol=SSL_TLS
-Djazz.connector.algorithm=IbmX509
-Dlog4j.configuration=file:///C:/PROGRA~2/IBM/JazzTeamServer/server/conf/startup_log4j.properties
7. Добавить опцию к Java Options, которая указывает расположение библиотеки для подключения к
серверу SQL.
-DSQLSERVER_JDBC_DRIVER_FILE=C:jdbcsqljdbc_2.0enusqljdbc.jar
8. Установить значение Maximum memory pool 4000.
9. Проверить у значения режимов Mode как jvm для Startup и Shutdown.
10. Перезагрузить сервер и проверить работоспособность.
7 Отключение использования сертификата безопасности
1. Если установка была уже выполнена отключить сертификат невозможно. Этот метод может быть
выполнен перед настройкой сервера после его установки
2. Остановить сервер jazz.
3. Перейти в каталог КаталогJazz/server/tomcat/webapps/jts/WEB-INF.
4. Открыть на редактирование файл web.xml и изменить все значения CONFIDENTIAL на NONE.
5. Повторить эти шаги для всех установленных приложений:
Приложение Путь к файлу web.xml
Управление изменениями и
конфигурациями
КаталогJazz /server/tomcat/webapps/ccm/WEB-
INF/web.xml
Управление качеством КаталогJazz /server/tomcat/webapps/qm/WEB-
INF/web.xml
Управление требованиями КаталогJazz /server/tomcat/webapps/rm/WEB-
INF/web.xml
Дополнения к управлению
требованиями
КаталогJazz /server/tomcat/webapps/rm/WEB-
INF/web.addons.xml
Администрирование управления
проектами
КаталогJazz /server/tomcat/webapps/admin/WEB-
INF/web.xml

22. 21
Приложение Путь к файлу web.xml
Информационный центр КаталогJazz /server/tomcat/webapps/clmhelp/WEB-
INF/web.xml
6. Перейти JazzInstallDir/server/tomcat/conf directory и отредактировать файл server.xml.
7. Удалить атрибут redirectPort из элементов подключения 9080:
<Connector port="9080" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"
URIEncoding="UTF-8"/>
8. Перезапустить сервер.
9. Запустить дальнейшую установку http://hostname.example.com:9080/jts/setup.
8 Подключение к Active Directory
8.1 Предварительные шаги
Перед настройкой необходимо проверить и запомнить важные параметры реестра.
1. Скачать и установить утилиту LDAP Browser с сайта http://www.softerra.com/download.htm
2. Добавить новый профиль.
3. На следующем шаге необходимо внести наименование профиля и нажать далее.
4. На следующем шаге нужно указать узел LDAP.

23. 22
5. Указать используемый метод идентификации.
6. Нажать Готово
7. В появившемся дереве найти любого пользователя и скопировать отличительное свойство.
8.2 Настройка
1. Запустить конфигуратор https://localhost:9443/jts/setup
2. Для входа использовать запись ADMIN.
3. Дойти до шага конфигурирования пользователей и выбрать тип реестра пользователей LDAP.
4. Настроить доступ к дереву LDAP.

24. 23
5. Указать метод идентификации пользователей.
6. Указать метод идентификации групп.

25. 24
7. Проверить соединение.
8. Проверить пользователя.
9. Сохранить конфигурацию Tomcat.
10. Заменить стандартные файлы server.xml и web.xml

26. 25
9 Настройка сбора отчетных данных
1. Перейти на страницу управления отчетами и запустить задания на исполнение.
2. Переключиться на страницу состояния заданий сбора и проверить результат.
10 Управление лицензионными ключами.
1. Перейти в раздел СерверУправление ключами лицензий.
2. Для добавления новых ключей нажать Добавить…

27. 26
3. Указать расположение файла лицензий и нажать кнопку Готово.
11 Управление пользователями
11.1 Создание пользователей
1. Перейти на страницу пользователей и выбрать пункт Создать пользователя
2. Ввести имя пользователя, идентификатор, адрес электронной почты и указать права хранилища.
3. Указать лицензии доступа к клиенту.

28. 27
4. Нажать кнопку Сохранить
11.2 Управление лицензиями клиента
1. Перейти в раздел управления лицензиями доступа клиента.
2. Выбрать ключ клиентской лицензии.
3. Удалить для пользователей лицензии по необходимости.

29. 28
11.3 Присвоение лицензии по умолчанию
1. Перейти в раздел управления лицензиями.
2. Выбрать редактирование поля Ключ активации лицензий по умолчанию в разделе Информация о
сервере.
3. Выбрать необходимый ключ.

30. 29
11.4 Архивирование и восстановление пользователей
1. Перейти в раздел Активных пользователей.
2. Выбрать пользователя и нажать кнопку Архивировать.
3. Перейти в раздел Архивные пользователи и восстановить заархивированного пользователя.
12 Резервное копирование баз данных
12.1 Выполнение резервного копирования
1. Приостановить работу службы индексации хранилища с помощью команды repotools-jts -
suspendIndexer.
2. Завершить работу Jazz Team Server, для того чтобы операция резервного копирования выполнялась с
неизменной базой данных и без сбоев.
3. Создать полную копию каталога, содержащего индексы и файлы конфигурации
(JazzInstallDir/server/conf/)
4. Создать полную копию каталога, содержащего сервер Tomcat, веб-приложения и файлы
конфигурации. Расположение по умолчанию: JazzInstallDir/server/tomcat. В следующем списке
перечислены основные каталоги и файлы:
4.1. ◦JazzInstallDir/server/tomcat/conf
4.2. ◦JazzInstallDir/server/tomcat/bin
4.3. ◦(если существует) JazzInstallDir/server/tomcat/webapps/ccm/WEB-INF/web.xml
4.4. ◦(если существует) JazzInstallDir/server/tomcat/webapps/clmhelp/WEB-INF/web.xml
4.5. ◦(если существует) JazzInstallDir/server/tomcat/webapps/converter/WEB-INF/web.xml
4.6. ◦(если существует) JazzInstallDir/server/tomcat/webapps/jazz/WEB-INF/web.xml
4.7. ◦(если существует) JazzInstallDir/server/tomcat/webapps/jts/WEB-INF/web.xml
4.8. ◦(если существует) JazzInstallDir/server/tomcat/webapps/qm/WEB-INF/web.xml
4.9. ◦(если существует) JazzInstallDir/server/tomcat/webapps/rdm/WEB-INF/web.xml
4.10. ◦(если существует) JazzInstallDir/server/tomcat/webapps/rm/WEB-INF/web.xml
5. Выполнить резервное копирование баз данных.
6. Перезапустить Jazz Team Server.
7. Возобновить работу службы индексации хранилища с помощью команды repotools-jts -
resumeIndexer.
12.2 Восстановление резервной копии
1. Приостановить работу службы индексации хранилища с помощью команды repotools-jts -
suspendIndexer.
2. Остановить Jazz Team Server.
3. Восстановить каталог конфигурации из резервной копии в каталог JazzInstallDir/server/conf/jts.
4. Восстановить файлы конфигурации сервера. (В случае загрузки нового набора файлов сервера
Tomcat и приложений запустить сервер Tomcat для извлечения файлов веб-приложений .war в

31. 30
каталог JazzInstallDir/server/tomcat/webapps, затем восстановить различные файлы WEB-
INF/web.xml.)
5. Восстановить базу данных.
6. Перезапустить Jazz Team Server.
7. Возобновить работу службы индексации хранилища с помощью команды repotools-jts -
resumeIndexer.
13 Обновление до версии 4
1. Установить версию 4.0
2. Остановить сервер.
3. Удалить службу Tomcat.
4. Выполнить резервное копирование баз и данных.
5. Установить драйвера для сервера SQL http://www.microsoft.com/en-
us/download/details.aspx?id=11774
6. Изменить переменную среды для SQL сервера:
7. Запустить скрипты обновления из директории Установочный_каталог_JTS_4.0server:
7.1. На каждом шаге, приведенном ниже, необходимо будет устанавливать актуальный полный путь
к файлу индексов:
7.2. upgradejtsjts_upgrade.bat -oldJTSHome Установочный_каталог_JTS_3.0.1serverconf
7.3. upgradeccmccm_upgrade.bat -oldApplicationHome
Установочный_каталог_CCM_3.0.1serverconf
7.4. upgradeqmqm_upgrade.bat -oldApplicationHome Установочный_каталог_QM_3.0.1serverconf
7.5. upgradermrm_upgrade.bat -oldApplicationHome Установочный_каталог_RM_3.0.1serverconf
8. Запустить сервер.
server.startup.bat
9. Активировать пробные лицензии в панели администрирования.
10. Обновить сервер управления требованиями.
10.1. Запустить браузер и ввести адрес
https://hostname.example.com:port/rm/web/projects/migration.
10.2. Перейти на панель обновления и дождаться окончания процесса обновления.
10.3. Выполнить инициализацию сервера через адрес
https://[hostname.example.com]:9443/[application context root]/publish/initialize
11. Установить запуск нового сервера как сервиса.

32. 31
11.1. Исправить пути для приложений jts, ccm, qm.
11.1.1. Открыть JazzInstallDirserverconfapp nameteamserver.properties .
11.1.2. Изменить com.ibm.team.repository.db.jdbc.location=conf/app name/derby/repositoryDB на
com.ibm.team.repository.db.jdbc.location=C:/JazzInstallDir/server/conf/app
name/derby/repositoryDB. Использовать прямой слеш (/) в путях.
11.1.3. Также изменить
com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB
entry на
com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/C:/JazzInstallDir/server/conf/j
ts/derby/warehouseDB для приложений. И запись
com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB на
com.ibm.team.datawarehouse.db.jdbc.location=C:/JazzInstallDir/server/conf/jts/derby/warehou
seDB для JTS. Использовать прямой слеш (/) в путях.
11.2. Изменить расположения файлов логирования для jts, ccm, qm, rm, admin.
11.2.1. Открыть файл JazzInstallDirserverconfapp namelog4j.properties.
11.2.2. Изменить запись log4j.appender.file.File=logs/appName.log на
log4j.appender.file.File=C:/JazzInstallDir/server/logs/appName.log. Использовать прямой слеш
(/) в путях.
11.2.3. Изменить запись log4j.appender.etl.File=logs/appName-etl.log на
log4j.appender.etl.File=C:/JazzInstallDir/server/logs/appName-etl.log. Использовать прямой
слеш (/) в путях.
11.3. Установить переменную среды CATALINA_HOME с значением
C:JazzInstallDirservertomcat
11.4. Перезагрузить систему.
11.5. Зарегистрировать сервис для нового севера Tomcat
service.bat install tomcat7
11.6. Запустить JazzInstallDirservertomcatbintomcat7w.exe для настройки сервиса.
11.7. Указать запуск виртуальной машины.
JazzInstallDirserverjrebinj9vmjvm.dll
11.8. Указать свойства для запуска виртуальной машины установив правильные относительные
пути.
-DJAZZ_HOME=file:///C:/JazzInstallDir/server/conf
-Djava.awt.headless=true
-Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true
-Dcom.ibm.team.repository.tempDir=C:JazzInstallDirservertomcattemp
-Djazz.connector.sslProtocol=SSL_TLS
-Djazz.connector.algorithm=IbmX509
-Dlog4j.configuration=file:///C:/JazzInstallDir/server/conf/startup_log4j.properties
-Xmx4g

33. 32
-Xms4g
-Xgcpolicy:gencon
-Xcompressedrefs
11.9. Добавить к свойствам путь к файлу драйверу SQL.
-DSQLSERVER_JDBC_DRIVER_FILE=C:SQLJDBCLocationsqljdbc4.jar
11.10. Установить для Maximum memory pool значение 4000
11.11. Установить режим для запуска и остановки как jvm.
11.12. Установить автоматический запуск.