Сборка сервера JBoss 3.x из исходного кода

Yuriy Larin aka Blandger
Оригинал статьи - на сайте http://blandger.pisem.net

Компиляция и сборка сервера JBoss выполняется довольно легко. Вы сами это увидите, когда прочтете эту статейку и попробуете сделать это самостоятельно.

Что касается любых версий сервера 3.x.x, то по информации от создателей (также проверено самостоятельно), он компилируется как на JDK 1.3.x, так и на JDK 1.4.x. При этом вы конечно же получаете либо один, либо другой код. Запускать его лучше на той же версии JDK, на которой он собирался, хотя это и не "железно". Код из 1.3 без проблем исполняется на 1.4, и можно попробовать кажется и наоборот (не помню, но кажется вполне получалось это делать с кодом JBoss-а). А вот что касается JBoss версии 4.x, то он "завязан" на определенные фичи JDK 1.4 и компилиться под 1.3 - НЕ БУДЕТ (думаю что это так, хотя сам не проверял).

Допустим вы уже скачали последний дистрибутив исходников сервера JBoss с sourceforge.org. Это должен быть архив, что-то типа jboss-3.x.x-src.zip , где x.x - подномера версии (или tar архив). Кроме этого на вашем ПК должен быть установлен какой-либо JDK, скорее всего это не меньше чем JDK 1.3 или 1.4. Пусть это будет каталог: D:\j2sdk1.4.2

Шаг 1. Распаковываем исходники в удобный каталог.

Пусть это: D:\jboss-3.2.1-src\

После распаковки в каталоге D:\jboss-3.2.1-src\ у вас должно появиться масса подкаталогов, что-то типа такого вида:

На картинке я дополнительно выделил пару каталогов.

Каталог ..\build\.. - обозначен ( ! ) Это место, где мы будем запускать сборку, а потом найдем собранный сервер.

Каталог ..\build\output\jboss-3.x.x\... - обозначен ( птичкой ), сначала НЕ существует, а после сборки в нем появляется готовый к применению "сервер". В данном случае это был ...\jboss-3.2.1\

 

Шаг 2. Переходим к следующему важному шагу - настройка ANT-а.

Если вы не знаете, что это за инструмент, то для сборки J2EE проектов, особенно больших, я крайне рекомендую освоить его. Потратив на это время, вы его потом сэкономите в будущем.

Я предалагаю, на мой взгляд, самый простой и быстрый способ настройки ANT-а для сборки JBoss, хотя этот способ и НЕ единственный.

При работе на Windows наобходимо в каталоге, куда вы распаковали исходники JBoss, найти файл - D:\jboss-3.2.1-src\tools\bin\ant.bat

Для UNIX (Linux) - это будет скрип файл D:\jboss-3.2.1-src\tools\bin\ant , но КАК в нем настроить значение переменной указывающей на JDK - тут я пас, плохо знаком с Linux.

В его начало, перед выполением основных иструкций, поместите переменную со значением, где находиться требуемое для компиляции и сборки JDK:

set JAVA_HOME=D:\j2sdk1.4.2

Проверьте, чтобы в конце строки каталога НЕ БЫЛО ЛИШНИХ ПРОБЕЛОВ ! А то иначе вы можете быть сконфужены, фактом что "ничего не получилось".

Стоит еще сказать, что исходники сервера "внутри себя" содержат ВСЕ необходимые для его сборки сторонние библиотеки. Сам ANT скрипт написан "как правило" без ошибок, когда-то ошибки наверное и бывали, но мне встречаться с таким не приходилось. Приходилось встречать ошибку в одной из версий, когда при последующем запуске "свеженького" JBoss - "ТомКат" падал при загрузке сервера и поэтому Web-контейнер НЕ поднимался.

Шаг 3. Сборка сервера.

Запускаем файл - D:\jboss-3.2.1-src\build\build.bat - Именно из этого каталога ! При этом НИЧЕГО в нем не меняем - оставляем его исходным.

После этого, если путь к JDK был настроен правильно, в консоль окна будут сыпаться лог-сообщения. Признак успешного завершения компиляции такой:

BUILD SUCCESSFUL
  Total time: 2 minutes 34 seconds

Из каталога D:\jboss-3.2.1-src\build\output - можно "забирать свежачок". Время компиляции зависит от процессора и памяти, указанное время получено при первой сборке (при повторной немного меньше) на: WinXP Pro, Atlon XP 1.7, 512 Мб.

 

Что делать, если сборка не удалась?

Первое - еще раз проверить : set JAVA_HOME=... , второе - то что переменная указана в "нужном файле", остальные файлы менять НЕ надо.

Что же делать, если НЕ помогло? - Скорее всего менять JDK.

У меня был печальный случай, когда готовый сервер версии 3.2.1, выкачанный с сайта, НЕ запускался под JDK 1.3 на FreeBSD 4.?.?. Выпадала совершенно глупейшая ошибка при загрузке сервера. По типу ошибки можно было только понять, что она происходит на уровне JVM. Обследование форума сайта jboss.org показал, что очень похожую по симптомам ошибку получило еще пару человек на похожей конфигурации. Т.к. сервер нужен был версии 3.2.1, то была предпринята попытка "сборки" из исходников. Эта попытка НЕ увенчалась успехом, сборка тоже падала с глупейшей ошибкой компиляции, при этом прекрасно собираясь на Windows. Из этого был сделан вывод, что JDK "сырое" и с багами. А так как данная версия JDK для указанной версии FreeBSD была "заморожена" и ее апдейтов или пачей к ней не предвидиться, то стало ясно, что "не судьба" и от затеи пришлось отказаться до лучших времен.