Установка JasperSoft BI Server на Tomcat

Ниже приведена короткая инструкция как установить JasperSoft BI Server на уже установленный Tomcat.

В моем случае я использовал JasperSoft BI Server Community версии 5.1.0 и tomcat 7.0.27 (идущий в Liferay Tomcat Bundle).

Архив для установки скачивается с сервера JasperSoft, необходимо скачать и разархивировать файл "JasperServer WAR File Installer". Корень архива назовем <js-install>

Копирование драйверов базы данных

В моем случае я использую MySQL, так что я положил в папку <js-install>/buildomatic/conf_source/db/mysql/jdbc jar с драйверами mysql. там на самом деле лежит уже драйвер MariaDB - но так как я с ним никогда не работал - я для верности все-таки положил родные драйвера MySQL.

Подготовка к установке

Убеждаемся что сервер базы данных запущен, а томкат остановлен, после чего копируем файл с настройками специфичный для нашей базы (в нашем случае это <js-install>/buildomatic/sample_conf/mysql_master.properties) в <js-install>/buildomatic/default_master.properties  и редактируем его, исправив:

  • переменную appServerDir что бы указывала правильно на наш томкат
  • настройки базы dbHost, dbUsername, dbPassword

Запускаем установку

Переходим в папку <js-install>/buildomatic и выполняем следующие команды:

  • Создаем базу данных jasperserver (проверено - база создается с поддержкой UTF8 - так что проблем с русским не будет)
#js-ant create-js-db
  • Опционально - создаем и загружаем данные в тестовые базы
#js-ant create-sugarcrm-db
#js-ant create-foodmart-db
#js-ant load-sugarcrm-db
#js-ant load-foodmart-db
#js-ant update-foodmart-db
  • Инициализируем и загружаем начальными данными саму базу JasperServer

 

js-ant init-js-db-ce
js-ant import-minimal-ce
js-ant import-sample-data-ce   
  • Деплоим приложение в томкат (при этом копируется папка jasperserver в webapps,  а так же различные драйверы баз данных в <tomcat>/lib
js-ant deploy-webapp-ce
  • Стартуем сервер (томкат)

Если все прошло хорошо, то по адресу http://localhost:8080/jasperserver вы получите окно JasperSoft BI Server

Для входа вы можете использовать jasperadmin / jasperadmin

Возможные проблемы

В моем случае, по каким то причинам не скопировался контекст с коннектами к базе из <tomcat>webapps/jasperserver/META-INF/context в <tomcat>/conf/Catalina/localhost/jasperserver.xml -  в результате чего  приложение при старте выдавало ошибку "java:comp not bound" - после копирования файла ручками все завелось. Кстати - в этом файле настройки доступа к базам данных - если вдруг что-то бузет необходимо исправить