Установка

Материал из Course Orchestra
(перенаправлено с «Установка новых версий Showcase»)
Перейти к: навигация, поиск
Showcase

Создание решений на КУРС:Showcase

Необходимое ПО

Для разворачивания готового проекта на платформе КУРС, Вам понадобятся следующие компоненты:

  1. Сервер приложений Tomcat 7
  2. JDK 1.7 для любой версии Tomcat (portable или service) либо JRE 1.7 для service-версии Tomcat
  3. Клиент Subversion TortoiseSVN (в случае если проект находится в SVN-репозитории)
  4. Одна из поддерживаемых баз.
  5. Сервер аутентификации Mellophone, для локальных пользователей используйте ссылку
  6. Собственно Showcase.war:
Загрузить дистрибутив платформы Course Orchestra
Download.png
Стабильные сборки

Версия Showcase-ext отличается от Showcase наличием библиотек ApachePOI и JasperReports. Данные библиотеки могут быть использованы в Python-скриптах. Основной код Showcase их не вызывает.


Кроме этого Вам необходимо иметь доступ к следующим репозиториям SVN (получить разрешения можно в отделе программистов):

  1. Grains (доступ на чтение) (необязательно)
  2. SVN Вашего решения (доступ на чтение)

Установка необходимого ПО

Установка JDK (JRE)

Скачайте файл установки JDK (JRE) (см.выше), запустите его. Далее следуйте инструкциям инсталятора. После того как вы установили JDK (JRE) необходимо прописать путь к Java в переменную среды JAVA_HOME (JRE_HOME). Необходимо указывать путь именно к папке с JDK (JRE), например C:\Program Files\Java\jdk1.7.0_04. Последовательность действий продемонстрирована на рисунке.

JAVA HOME.png

Установка TortoiseSVN

Для установки TortoiseSVN запустите скачанный файл инсталятора и следуйте инструкциям.




Программные и аппаратные требования

Для работы Showcase обязательно требуются:

  1. Последняя версия JRE7 или JDK 7 (при желании использовать portable Tomcat, известный также под именем «папочный Tomcat», необходимо именно JDK, т. к. portable Tomcat не работает с JRE).
  2. Дистрибутив в виде WAR файла – Showcase.war
  3. Папка с пользовательскими данными (userdata)
  4. Tomcat версии 7 и выше
  5. MSSQL Server версии 2008 и выше или иная поддерживаемая СУБД
  6. Резервная копия БД

Также дополнительно могут быть развернуты компоненты:

  1. mellophone (mellophone.war) – сервер для аутентификации через Active Directory в домене компании или с помощью ApacheDS Server.

Все необходимые файлы можно найти в каталоге \\server\share\ftp\development\Showcase\dist (ftp://share.curs.ru/development/Showcase/dist).

Последняя версия тестовой БД разработчиков и тестовая папка с данными лежит в \\server\share\ftp\development\Showcase\trunk

(ftp://share.curs.ru/development/Showcase/trunk).

Установка и настройка Showcase

Для установки одного экземпляра Showcase выполните следующие действия:

  1. Установить JDK
  2. Установить (или распаковать) Tomcat в папку %TOMCAT%
  3. Скопировать папку с пользовательскими данными в %TOMCAT%\userdata
  4. Скопировать – Showcase.war и mellophone.war в %TOMCAT%\webapps
  5. Установить на рабочий SQL сервер резервную копию БД Showcase
  6. Исправить в %TOMCAT%\userdata\app.properties параметр «rdbms.connection.url», заменив в нем CASTLE\\R2 на имя SQL сервера, CARTRADE - на имя БД Showcase
  7. Запустить Tomcat с помощью %TOMCAT%\bin\startup.bat
  8. Запустить любой браузер и открыть в нем адрес: http://localhost:8080/Showcase
  9. Залогиниться под master-master. Если открылось главное окно с заставкой решения - значит приложение проинсталлировано верно.

В случае проблем, нужно последовательно попробовать следующее:

  1. открыть веб-консоль - http://localhost:8080/Showcase/log/lastLogEvents.jsp и посмотреть информацию об ошибке там
  2. если веб-консоль не открывается - отредактировать файл %webapp%\WEB-INF\classes\logback.xml, настроив там вывод лога программы в файл. Для этого нужно раскомментировать appender с именем "FILE" и ссылку на него в <root>. В течение 30 секунд после сохранения файл новые настройки будут применены. После этого можно будет попробовать обратиться к Showcase еще раз и посмотреть вывод в лог.
  3. открыть ссылку "О программе" в окне логина и изучить представленную там информацию


Настройка контейнера сервлетов tomcat для работы Showcase

Для корректной (предсказуемой) работы системы безопасности необходимо определить как tomcat будет "работать" с сессиями открытыми в Showcase. Необходимо понять и определиться со следующими вариантами:

  • Будет ли авторизованная сессия в Showcase автоматически (с использованием внутреннего функционала tomcat) сохраняться при остановке и включении сервера tomcat (перезагрузке сервера). Тоесть после перезагрузки tomcat вводить пароль и имя пользователя не надо-Showcase будет работать под прежним аутентифицированным пользователем.
  • Сессия будет аннулирована (несохраняться) при перезагрузке tomcat и пользователю после остановки и включения сервера будет предложено заново ввести имя пользователя и пароль.

В первом случае ничего делать не надо-функционал автоматического сохранения сессий при перезагрузке сервера настроен в tomcat по умолчанию.

Для реализации второго случая необходимо в файле конфигурации tomcat (conf/context.xml), либо в файле конфигурации приложения на Showcase (например, conf\Catalina\localhost\showcase.xml) указать:

 <Manager pathname = "" />

PS для программистов: С точки зрения "а как правильно (первый или второй случай)?" можно отметить что оба случая абсолютно верны, а функционал сохранения сессий реализован tomcat-ом и управлять им можно с помощью вышеуказанной настройки, либо из Java кода используя фильтры (что является в какой-то степени заглушкой). То есть правильное управление данным поведением только используя вышеуказанную настройку-тэг.

Задание showcase как root приложения в томкате

http://josefbetancourt.wordpress.com/2011/02/12/tomcat7-change-root-app/ Нужно в файл server.xml в элемент <Host> прописать:

  <Context path="" docBase="novartis">
 
      <!-- Default set of monitored resources -->
      <WatchedResource>WEB-INF/web.xml</WatchedResource>
 
      <!-- Uncomment this to disable session persistence across Tomcat restarts -->
      <!--
      <Manager pathname="" />
##-->
 
      <!-- Uncomment this to enable Comet connection tacking (provides events
           on session expiration as well as webapp lifecycle) -->
      <!--
      <Valve className="org.apache.catalina.valves.CometConnectionManagerValve" />
##-->
    <Parameter name="showcase.rootpath.userdata" value="userdata" override="true"/> 
  </Context>

При этом war файл в папке webapps распаковывается сразу в две папки, с названием приложения и в папку ROOT. При обновлении версии showcase нужно остановить томкат, удалить эти две папки, и положить новый war файл. upd: способ оказался не оптимальным. Из-за копирования в две папки томкат запускается долго. Лучше просто переименовать оригинальный ROOT(если он нужен) во что-то другое, а свое приложение переименовать в ROOT.

Порядок установки новых plugins для КУРС: Showcase

1. Все новые версии выкладываются в систему непрерывной интеграции Дженкинс по адресу http://share.kurs-it.ru:1111/

2. Список изменений доступен по адресу http://share.kurs-it.ru:1111/job/Showcase/changes

3. Плагинсы расположены в файле userdata-[номер версии].zip на странице релиза

4. Для включения (обновления) плагинса в решение разработчику решения необходимо скачать userdata и переписать требуемый плагинс из папки general\plugins в соответствующую папку решения. При необходимости выложите плагинс, находящийся в папке решения, на svn.

Обновление КУРС: Showcase

Для установки новой версии Showcase нужно заменить в директории webapps сервера Tomcat файл Showcase.war или Showcase-ext.war, соответствующие различным версиям Showcase. После запуска Tomcat эти файлы раскрываются в директорию webapps в виде папок Showcase и Showcase-ext.

Версия Showcase-ext отличается от Showcase наличием библиотек ApachePOI и JasperReports. Данные библиотеки могут быть использованы в Python-скриптах. Основной код Showcase их не вызывает.