Установка приложения и вход в систему

Для установки приложения необходимо:

Состав дистрибутива

Дистрибутив приложения ecm-solution-1.0.0.zip состоит из следующих файлов:

Необходимо создать на диске папку ecm и распаковать в нее содержимое дистрибутива.

Установка БД PostgreSQL

Для операционной систем семейства Debian

1
sudo apt-get install postgresql

Для операционной систем семейства Windows

Скачать и установить дистрибутив с сайта https://www.postgresql.org/

Настройка удаленного доступа (опционально)

Если сервер БД находится на отдельном сервере,
необходимо разрешить удаленное подключение к нему.

В файле postgresql.conf найти строку
#listen_addresses =’localhost’ и заменить ее на listen_addresses = ’*’
(вместо * могут быть IP адреса)

В файле pg.hba.conf добавить в конце строчку
host all all 192.168.7.0/24 md5
для того чтобы разрешить доступ к БД внешним хостам.

Пример скрипта для автоматизации предоставления удаленного доступа

1
2
3
sed -i '/listen_address/alisten_addresses = \x27*\x27' /etc/postgresql/9.5/main/postgresql.conf
echo 'host all all 192.168.7.0/24 md5' >> /etc/postgresql/9.5/main/pg_hba.conf
service postgresql restart

После завершения настройки удаленного доступа необходимо перезапустить postrges.

Создание пользователя и базы данных

Необходимо создать пользователя, под которым приложение будет подключаться к БД

Создание БД и запуск скриптов можно производить с использованием утилиты psql либо с помощью программы pgAdmin

Пример создания пользователя и БД утилитой psql

1
2
3
4
su - postgres
psql
CREATE ROLE galantis_ecm WITH LOGIN PASSWORD '<password>' CREATEDB VALID UNTIL 'infinity';
CREATE DATABASE galantis_ecm WITH ENCODING='UTF8' CONNECTION LIMIT=-1 OWNER galantis_ecm;

Необходимо создать базу данных, для этого нужно выполнить скрипты из папки scripts/ru дистрибутива.

Важно! Скрипты нужно запускать под пользователем galantis_ecm

Пример запуска скриптов утилитой psql

1
psql -U galantis_ecm -h localhost galantis_ecm -f /<path>/1__base_descriptions.sql

Установка Java

Необходимо установить Oracle Java SE версии 8.

Для операционных систем семейства Debian можно использовать скрипт:

1
2
3
4
sudo apt-get install software-properties-common
sudo add-apt-repository "deb http://ppa.launchpad.net/webupd8team/java/ubuntu xenial main"
sudo apt-get update
sudo apt-get install oracle-java8-installer

Для операционных систем Windows можно скачать дистрибутив на сайте

Установка Apache Tomcat

Необходимо установить сервер приложений Apache Tomcat 9, под которым будет запускаться приложение

Нужно скачать дистрибутив на официальном сайте и распаковать его в папку ecm

Конфигурация и запуск приложения

1. Скопировать файлы

Скопировать библиотеки из папки дистрибутива /libs в папку Tomcat /lib

2. Настроить подключение к БД

В файле Tomcat conf/server.xml в секции GlobalNamingResources добавить Resource

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<GlobalNamingResources>

<Resource
name="jdbc/ecm"
auth="Container"
type="javax.sql.DataSource"
factory="com.zaxxer.hikari.HikariJNDIFactory"
maximumPoolSize="30"
leakDetectionThreshold="2000"
driverClassName="org.postgresql.Driver"
dataSource.user="galantis_ecm"
dataSource.password="<password>"
jdbcUrl="jdbc:postgresql://localhost:5432/ecm"
/>

</GlobalNamingResources>

В папке Tomcat создать файл conf/Catalina/localhost/ecm.xml со следующим содержимым:

1
2
3
<Context docBase="${catalina.base}/../ecm-solution-1.0.0/ecm-solution-1.0.0.war" reloadable="true">
<ResourceLink name="jdbc/ecm" global="jdbc/ecm" type="javax.sql.DataSource"/>
</Context>

3. Настроить опции Java

Необходимо создать файл в папке Tomcat bin/setenv.sh либо bin/setenv.bat, в зависимости от типа операционной системы.

Содержимое файла (для Linux):

1
2
3
4
5
6
7
8
export JAVA_OPTS="
-Xms4000m -Xmx4000m
-XX:PermSize=512m
-Dgrails.env=production
-Dfile.encoding=UTF-8
-Decm.db.dialect=org.hibernate.dialect.PostgreSQLDialect
-Decm.db.jndiName=java:/comp/env/jdbc/ecm
"

Содержимое файла для Windows:

1
2
SET JRE_HOME=C:\Program Files\Java\jre1.8.0_171
SET "JAVA_OPTS=-Xms4000m -Xmx4000m -XX:PermSize=512m -Dgrails.env=production -Dfile.encoding=UTF-8 -Decm.db.dialect=org.hibernate.dialect.PostgreSQLDialect -Decm.db.jndiName=java:/comp/env/jdbc/ecm"

Перед запуском приложения, в папке ecm должна получиться структура файлов следующего вида:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
.
├── apache-tomcat-9.0.8
│   ├── bin
│   │   └── setenv.sh
│   ├── conf
│   │   ├── Catalina
│   │   │   └── localhost
│   │   │   └── ecm.xml
│   │   └── server.xml
│   ├── lib
│   │   └── postgresql-42.2.2.jar
└── ecm-solution-1.0.0
   ├── ecm-solution-1.0.0.war
├── libs
└── scripts

Для Linux - раздать права на запуск файлам *.sh в папке Tomcat bin - chmod +x *.sh

Запустите сервер приложения Tomcat путем запуска файла startup.sh
либо startup.bat в зависимости от типа операционной системы.

Проверка работоспособности приложения

  1. Открыть в браузере ссылку http://localhost:8080/ecm/
    Ожидаемый результат: открылась страница входа в приложение

  2. Войти в приложение под пользователем по умолчанию, логин и пароль - admin / test123
    Ожидаемый результат: сообщение “Для данного интерфейса и пользователя
    отсутствует конфигурация папок. Перейдите в интерфейс Системный администратор для изменения конфигурации.”