Установка Railo 3.2 на OpenSUSE 11.3 с Apache2 и Tomcat 6 (виртуальный хост)

Введение

Railo Server 3.2 Final (3.2.1.000) — это Open Source CFML-движок (ColdFusion). В версии 3.2 по умолчанию используется Tomcat вместо Resin. Команда Railo подготовила установочный скрипт, который разворачивает Railo на Tomcat 6 и настраивает связь с Apache2 через mod_jk.

В этом руководстве мы не будем перекомпилировать Apache с Tomcat — используем готовый инсталлятор Railo и стандартные средства OpenSUSE. Вместо использования папки webapps Tomcat мы изменим server.xml так, чтобы DocumentRoot указывал на корневую директорию Apache, определённую в конфигурации виртуального хоста.

Важно: автор не гарантирует успешное выполнение всех шагов на вашей системе — при возникновении вопросов пишите на [email protected]

Требования и подготовка

• OpenSUSE 11.3 (i386) установлен и доступен; в статье использовалась виртуальная машина VMware Player.
• Права root или sudo для установки пакетов и правки системных файлов.
• Доступ в интернет для загрузки Railo.

Ключевые шаги:

1. Установить Java
2. Установить Apache2
3. Установить Railo/Tomcat
4. Интегрировать Apache + Tomcat + Railo в named-based виртуальный хост
5. Протестировать

1. Установка Java

Скачайте и запустите бинарный инсталлятор JDK в /usr/local:

cd /usr/local

bash jdk-6u21-linux-i586.bin

Добавьте в /etc/profile две строки (пример пути версии JDK у вас может отличаться):

export JAVA_HOME=/usr/local/jdk1.6.0_21
export PATH=$PATH:/usr/local/jdk1.6.0_21/bin

Затем примените изменения:

source /etc/profile

Важно: убедитесь, что java доступна в PATH через команду java -version.

2. Установка Apache2 и менеджера пакетов

Установите apache2 стандартным способом:

zypper install apache2

Примечание: при возникновении конфликтов пакетов проверьте репозитории zypper и наличие необходимых разрешений.

3. Загрузка и установка Railo 3.2

Загрузите инсталлятор Railo 3.2 (Tomcat 6) на машину, например в /tmp. В источнике используется версия 3.2.1.000 (пример ссылки):

http://www.getrailo.org/down.cfm?item=/railo/remote/download/3.2.1.000/tomcat/linux/railo-3.2.1.000-pl0-linux-installer.run

Сделайте файл исполняемым и запустите:

chmod +x /tmp/railo-3.2.1.000-pl0-linux-installer.run

Следуйте интерактивному установщику. По умолчанию он разворачивает Tomcat 6 и Railo в каталог, указанный инсталлятором. Запомните путь установки для дальнейшей настройки server.xml и конфигурации mod_jk.

4. Интеграция Apache2 + Tomcat + Railo (named-based виртуальный хост)

Общая идея: Apache остаётся фронтендом (статичное содержимое и виртуальные хосты), Tomcat обрабатывает CFML через Railo. Соединение обычно реализуют через модуль mod_jk или mod_proxy_ajp.

Базовые шаги:

• Установите или включите модуль mod_jk (или используйте mod_proxy_ajp как альтернативу).
• Настройте workers.properties и модуль mod_jk для проксирования запросов к AJP-коннектору Tomcat.
• Измените server.xml Tomcat или добавьте Context, чтобы docBase указывал на директорию DocumentRoot, используемую Apache для данного виртуального хоста (если вы хотите, чтобы Tomcat обслуживал содержимое из этой директории).
• В конфигурации виртуального хоста Apache укажите обработку запросов для нужных URL через JkMount или проксирование.

Важно: конкретные строки конфигурации зависят от структуры ваших каталогов и версии Tomcat. Перед правкой сделайте резервную копию server.xml и конфигураций Apache.

5. Тестирование и базовые проверки

После установки и настройки выполните минимальные проверки:

• Проверить запущен ли Tomcat: ps aux | grep tomcat или проверка порта AJP (обычно 8009) и HTTP Tomcat (обычно 8080).
• Перезапустить Apache: sudo service apache2 restart или sudo /etc/init.d/apache2 restart.
• Откройте в браузере домен виртуального хоста: базовая страница должна корректно обрабатываться. Для проверки Railo можно разместить простой CFML-файл (например, index.cfm с выводом Hello, Railo) в DocumentRoot и запросить его.

Критерии приёмки

• Java отвечает на java -version.
• Службы Apache и Tomcat запущены.
• CFML-страница отдает ожидаемый результат через Apache (WF корректно проксируется на Tomcat).

Отладка и частые ошибки

• Если Apache отвечает, а CFML не отрабатывает — проверьте соответствие JkMount (или ProxyPass) и наличие worker-а в workers.properties.
• Ошибки 404 — проверьте пути DocumentRoot и docBase в server.xml.
• Проблемы с правами — проверьте владельца и права на файлы в DocumentRoot и папках Railo/Tomcat.

Важно: лог-файлы — ваши лучшие друзья: /var/log/apache2/error_log, лог Tomcat (logs/catalina.out) и лог Railo — изучайте их при ошибках.

Рекомендации, альтернативы и лучшие практики

• Альтернатива mod_jk: использовать mod_proxy_ajp или mod_proxy_http — они проще в конфигурации, но имеют свои особенности по производительности и безопасности.
• Резервное копирование конфигураций перед изменениями.
• На продуктиве ограничьте доступ к AJP-порту (файрвол и локальные интерфейсы).

Факто-бокс

• Railo 3.2 использует Tomcat 6 как контейнер по умолчанию.
• OpenSUSE 11.3 — устаревшая версия дистрибутива; планируйте миграцию на поддерживаемые релизы для получения обновлений безопасности.

Роль-based чеклист (оператор / разработчик)

• Оператор: проверить запуск служб, права, логи, перезапуск apache/tomcat.
• Разработчик: разместить тестовый index.cfm, проверить корректность CFML, кэширования Railo.

Глоссарий (1 строка)

• AJP — протокол для проксирования сервлетов между Apache и Tomcat.
• docBase — параметр Tomcat, определяющий корень веб-приложения.

Краткое резюме

Вы установили Java, Apache2 и Railo/Tomcat, интегрировали их между собой и получили рабочую платформу для запуска CFML-приложений на OpenSUSE 11.3. Для стабильной эксплуатации следите за логами, правами и безопасностью AJP-портов.

Примечание: этот материал ориентирован на общее руководство; конкретные строки конфигурации server.xml, workers.properties и виртуальных хостов зависят от вашей инфраструктуры и пути установки Railo.