Неофициальное руководство по развертыванию Testing Grid

Неофициальное руководство по развертыванию Testing Grid
Небольшое вступление.
Нами были выпущены несколько RPM-пакетов, с помощью которых следует
разворачивать систему Testing Grid на Linux-серверах. Т.к. в поставке таких Linuxдистрибутивов, как Fedora Core, Ubuntu и др. используется GNU реализация Java (которая
содержит множество ошибок и сервер Tomcat часто некорректно работает) мы требуем для
развертывания системы использовать JDK от компании Sun Microsystems.
Т.к. в стандартных поставках этих дистрибутивов Linux сервер Tomcat зависит от GNU
реализации Java - мы выпустили свой RPM-пакет Tomcat 5.5.17 с исправленными
зависимостями. Т.к. Нами используется приложение jsvc (из поставки Tomcat) которое
должно быть сконфигурировано под конкретный путь до JDK мы предполагаем, что будет
использован JDK 1.5.0_08. Инструкции по переводу системы на другой JDK будут в конце.
Итак! Что необходимо:
1) Java 2 SE (Sun Microsystems) v.1.5.0 update 8 (в виде rpm-пакета)
2) PostgreSQL v. >= 8.1
3) RPM-пакет testgrid
4) RPM-пакет Apache Tomcat >= 5.5.17 (нашего розлива)
Последовательность действий для Fedora Core 5:
1) Убедитесь, что в системе не установлен сервер Tomcat и GNU реализация Java:
yum list installed | grep gcj
yum list installed | grep tomcat
Не должно быть установлено НИЧЕГО!
2) Убедитесь, что установлен и работает сервер PostgreSQL.
См. документ PostgreSQL-8.1-HowTO.doc
3) Установите JDK 1.5.0 update 8
rpm -iv jdk-1_5_0_08-linux-i586.rpm
Sun распространяет JDK в виде rpm.bin, и показывает лицензию, перед тем как
распаковать rpm-пакет. Мы пропустили этот этап :)
4) Установите Tomcat из нашей поставки.
rpm -iv tomcat-5.5.17-1.noarch.rpm
Внимание! RPM-пакет выдаст сообщение о том, что домашняя директория пользователя
есть и не скопирована из шаблона. Это нормально.
tomcat5 уже
Для администратора:
Login:
Administrator
Password:
tomcat
5) Установите testgrid. При этом БД НЕ будет инициализирована. (Инициализация
происходит при первом обращении к системе, создаются таблицы, добавляется
учетная запись администратора системы 'testgrid' с паролем 'testgrid')
rpm -iv testgrid-1.0-1.noarch.rpm
6) Запустите сервер tomcat:
/etc/init.d/tomcat5 start
7) Проверьте, что сервер запущен и работает
Откройте в браузере URL: <http://localhost:8080/>
Появится стандартная страница сервера Tomcat
Зайдите в Administratiom/Tomcat Manager: <http://localhost:8080/manager/html>
Вы должны увидеть запущенное приложение Tgrid (started).
8) Авторизуйтесь, чтобы убедиться, что соединение в БД нормально функционирует:
<http://localhost/TGrid/ui/login>
Login:
'testgrid'
Password:
'testgrid'
Все! Сервер системы установлен!
Небольшой сборник HOW-TO:
Настройка параметров пула соединений с БД
При запуске Tomcat создает JNDI-ресурс с пулом соединений к БД. Описание этого
ресурса должно находиться здесь:
/usr/local/tomcat/webapps/TGrid/META-INF/context.xml
И по-умолчанию выглядит так:
<Context>
<Resource
name="jdbc/TGridDB"
auth="Container"
type="javax.sql.DataSource"
username="testgrid"
password="testgrid"
driverClassName="org.postgresql.Driver"
url="jdbc:postgresql://localhost/testgrid"
maxIdle="5"
maxWait="10000"
/>
</Context>
Красным цветом отмечены поля, изменение которых вызовет крах системы! Никогда не
редактируйте их!
Зеленым цветом отмечены параметры, которые можно редактировать. Это параметры
аутентификации при соединении с БД+параметры пула соединений.
Подробнее о настройке последних - читайте в документации к Tomcat в разделе JNDI.
Изменение невыделенных параметров не тестировалось.
Установка более новой версии Tomcat
Вы можете установить новую версию Tomcat поверх уже установленного в
/usr/local/tomcat сервера. Это можно объяснить тем, что необходимо соблюсти
зависимости пакета testgrid, иначе он просто не установится. Устанавливать tomcat
проще всего, следуя инструкциям на http://tomcat.apache.org.
Переход на другую версию JDK
Внимание! Не пробуйте переходить на JDK версии < 1.5 Это невозможно!
Версии Tomcat версии<=5.5.0 не поддерживаются (скорее всего, запуск возможен с
учетом особенностей более ранних версий Tomcat)
В настоящий момент возможен переход в рамках JDK 1.5 компании Sun Microsystems. JDK от
других производителей не исследовались, но существует мнение, что возможно
использование JDK от BEA.
Как осуществить переход? для этого необходимо исправить сценарий запуска tomcat здесь:
/etc/init.d/tomcat5
После этого необходимо пересобрать утилиту jsvc, которая поставляется вместе с Tomcat.
(это платформенно-зависимый код, который конфигурируется для заданного пути до JDK)
Найти эту утилиту можно в поставке Tomcat.
После пересборки этой утилиты - поместите её в директорию /usr/local/tomcat/bin/