Установка Atlassian STASH, грабли при установке в CentOS

Установка указанного продукта достаточно проста. Но я всё таки нашёл для себя грабли.

Отчасти это было связано с тем, что ставил я на CentOS. С этим дистрибутивом я до недавнего времени опыта почти не имел.

Фактически данная статья это вольный перевод Getting Started руководства с сайта Atlassian в разделе установки в Linux.

Возможно кому то пригодится.



Примечание:

Все команды ниже вводятся в коммандной строке под пользователем root

Данный вариант установки рекомендован для тестовой эксплуатации! Для запуска сервера в промышленную эксплуатацию необходимо выполнить ряд дополнительных мер. Это всё расписано в статье по установке.

Позже постараюсь дополнить статью порядком перевода сервера в боевой режим

Вначале нам нужно проверить наличие нужных версий дополнительного ПО. Тут мы можем увидеть поддерживаемые версии.

1. Java

Сначала нам предлагается проверить версию Java установленную на вашем сервере

java -version

Поставил OpenJDK версия 1.7.0 (java-1.7.0-openjdk.x86_64), всё было отлично, за исключением того, что сколько я не ждал доступ к web-странице отсутствовал. Просто отображалась белая пустая страница.

Решение проблемы с Java

Пришлось снести OpenJDK и поставить OracleJDK. Его скачиваем отсюда.

Через волшебный Google откопал занятное замечание:

Stash Fails to Startup after installation when Running on OpenJDK

Symptoms

The following exception is reported when starting up Stash:

A fatal error has occurred

The following problem occurred which prevents Atlassian Stash from starting correctly:

OpenJDK 64-Bit Server VM is an unsupported JVM.

Cause

OpenJDK is not a supported environment for Stash.

Resolution

Switch to the latest version of Oracle JDK to help resolve the problem.

Правда у меня то всё стартануло с OpenJDK и никак не руганулось, но всё равно не заработало. Странненько в общем.

2. Git

Так же проверяем версию установленного пакета:

git --version

Вот тут меня ждала засада. В CentOs 6.5 в base репозитории находится git 1.7.1, а минимальное требование: 1.7.6+

Всё было бы отлично, но тут сразу сошлись все факторы моего малого опыта работы с CentOS и yum.

Необходимо добавить дополнительный репозиторий rpmforge, есть такая статься, о том как его добавить. Если кратко, то:

rpm --import apt.sw.be/RPM-GPG-KEY.dag.txt

rpm -K rpmforge-release-0.5.3-1.el6.rf.*.rpm

rpm -i rpmforge-release-0.5.3-1.el6.rf.*.rpm

Везде где я находил рекомендации по его добавлению указано, что необходимо перевести rpmforge в enable.

Сделал.

yum update

и ничего не обновилось.

yum install git

git так и остался старой версии.

решение

Решение оказалось простым, но искал я его, почему то, долго.

достаточно активировать репозиторий [rpmforge-extras] в файле /etc/yum.repos.d/rpmforge.repo

Выставляем enable=1, и вот удача:

# git --version

git version 1.7.12.4

3.Perl

С этим в CentOS 6.5 оказалось всё в порядке.

# perl --version

This is perl, v5.10.1 (*) built for x86_64-linux-thread-multi

минимальные требования: >= 5.8.8

4.Stash

Теперь ставим сам Stash.

Качаем архив дистрибутивом с этой страницы. И разворачиваем архив в желаемое место установки. Например в /usr/local/stash Это у нас будет \<Stash installation directory\>

Перед запуском нам необходимо поправить файл \<Stash installation directory\>/bin/setenv.sh

Раскомментируем параметр STASH_HOME и укажем место для хранения данных STASH

например

STASH_HOME="/home/stash-home-data"

!!! ВАЖНО!!!

Разработчики советуют не помещать данные в папку \<Stash installation directory\>

Это связано с тем, что когда потребуется обновить STASH, то данные, в папке \<Stash installation directory\> , будут перезаписаны.


Всё, установка завершена. Теперь просто запускаем stash.

перейдите в папку в которую установлен stash (это у нас \<Stash installation directory\>)

bin/start-stash.sh

Если всё запустилось корректно, то мы увидим

# bin/start-stash.sh

To run Stash in the foreground, start the server with start-stash.sh -fg

Starting Atlassian Stash as current user

Detecting JVM PermGen support…

PermGen switch is supported. Setting to 256m\n

Using STASH_HOME: /home/stash-home-data

Using CATALINA_BASE: /usr/local/etc/stash/atlassian-stash-2.10.1

Using CATALINA_HOME: /usr/local/etc/stash/atlassian-stash-2.10.1

Using CATALINA_TMPDIR: /usr/local/etc/stash/atlassian-stash-2.10.1/temp

Using JRE_HOME: /usr

Using CLASSPATH: /usr/local/etc/stash/atlassian-stash-2.10.1/bin/bootstrap.jar:/usr/local/etc/stash/atlassian-stash-2.10.1/bin/tomcat-juli.jar

Using CATALINA_PID: /usr/local/etc/stash/atlassian-stash-2.10.1/work/catalina.pid

Success! You can now use Stash at the following address:

localhost:7990/

If you cannot access Stash at the above location within 3 minutes, or encounter any other issues starting or stopping Atlassian Stash, please see the troubleshooting guide at:

confluence.atlassian.com/display/STASHKB/Troubleshooting+Installation

Как и указано, доступ к web интерфейсу появляется не сразу, а в течении нескольких минут. Это связано с подготовкой данных.

Далее мы открываем http://<ip(dns)_вашего_сервера>:7990/ и следуем через мастер установки. Этот процесс я описывать не буду, т.к. там всё элементарно.

PS: Обсуждение статьи и замечания жду в комментариях.

This entry passed through the Full-Text RSS service — if this is your content and you're reading it on someone else's site, please read the FAQ at fivefilters.org/content-only/faq.php#publishers.