Руководство администратора

Проверка наличия установленной Java 8 в Linux

Проверка выполняется консольной командой

update-alternatives --list java 2>/dev/null | grep java-8 | head -1

При наличии в системе установленной Java 8 версии будет выведена строка содержащая полный путь к ней. Пустой вывод означает отсутствие установленной Java 8 версии.

Установка Java 8

Выполните команду:

sudo apt install openjdk-8-jdk

и далее создайте файл с переменными окружения:

sudo vi /etc/profile.d/java8jdk.sh

со следующим содержанием:

Выполните следующую команду для их установки в терминале:

sudo –s source /etc/profile.d/java8jdk.sh

Создание пользователя и группы для работы приложения

Создайте пользователя tomcat участником группы tomcat с домашней

директорией /opt/vedoc (куда мы будем устанавливать Ведок) и с оболочкой /bin/false

Установка PostgreSQL в Linux

В том случае если у вас отсутствует установленная СУБД PostgreSQL, установите ее выполнив команду:

Распаковка архива с приложением

Дистрибутив поставляется в виде архива. Создайте каталог /opt/vedoc используя команду:

Распакуйте архив в созданный каталог:

Сделайте пользователя tomcat владельцем всех файлов:

sudo chown tomcat:tomcat /opt/vedoc -R

Установите флаг исполнения на командных файлах:

sudo chmod u+x,o-x /opt/vedoc/tomcat/bin/*.sh

Создание базы данных

Создайте пустую базу средствами СУБД или выполните в терминале команду:

sudo -i -u postgres psql -c "CREATE DATABASE <имя_базы_данных>;"

рекомендуемое имя создаваемой базы данных vedocdb

Проверка конфигурационного файла для подключения к БД

Основной конфигурационный файл приложения имеет имя local.app.properties и располагается по пути /opt/vedoc/tomcat/webapps/vedoc/WEB-INF.

Проверьте параметры в этом файле и при необходимости внесите изменения, в соответствии со своими настройками:

• cuba.dataSource.username = postgres – владелец базы данных (по умолчанию postgres);

• cuba.dataSource.password = postgres – пароль владельца базы данных (задается при установке или настройке СУБД PostgreSQL);

• cuba.dataSource.dbName = vedocdb – имя базы данных, указанной выше;

• cuba.dataSource.port = 5432 – порт используемый СУБД;

• cuba.dataSource.host = localhost – имя сервера СУБД (при установкке СУБД и программы на одном сервере). Имя компьютера или IP адрес, при установке на разных;

Вместо текста <указать_пароль> указать устанавливаемый пароль. Пароль заключается в одинарные кавычки. Вся команда заключается в двойные кавычки.

Более подробное описание состава данного файла по ссылке: https://postgrespro.ru/docs/postgresql/12/auth-pg-hba-conf При внесении изменений в файл pg_hba.conf произведите перезапуск СУБД.

Изменение имени компьютера и номера порта приложения

Для своей работы приложение использует порт 8080 и локальное имя компьютера. При необходимости использования приложения по локальной сети произведите изменения:

• в файле local.app.properties находящемуся по пути /opt/vedoc/tomcat/webapps/vedoc/WEB-INF/ значение localhost в параметре cuba.webAppUrl = http://localhost:8080/vedoc на имя или IP адрес компьютера, где установлена программа. Номер порта 8080 на требуемое вами значение порта. В свойстве приложения cuba.connectionUrlList измените номер порта 8080 на новое.

– в файле opt/vedoc/tomcat/conf/server.xml, найдите блок параметров:

И измените port="8080" на значение, выбранное на предыдущем шаге.

Пробный запуск приложения

Выполните команду для запуска приложения:

sudo /opt/vedoc/tomcat/bin/startup.sh

Для контроля запуска выполните:

sudo tail –f /opt/vedoc/tomcat/logs/catalina.out

Появление строк

означает успешный запуск приложения.

Для доступа к приложению перейдите в браузере по ссылке: http://localhost:8080/vedoc

В случае внесения изменений в имя, например test и/или номера порта, например на 8111, ссылка будет иметь вид: http://test:8111/vedoc

При правильной настройке вы попадете на страницу входа Ведок:

Учетные данные для входа administrator/administrator – логин/пароль соответственно.

Для завершения работы приложения выполните команду:

sudo /opt/vedoc/tomcat/bin/shutdown.sh

Создание системного юнита для автоматического запуска

Для автоматического запуска программы при старте сервера создайте файл vedoc.service в каталоге /etc/systemd/system

sudo vi /etc/systemd/system/vedoc.service

следующего содержания (приведен пример при установки приложения в каталог /opt/vedoc):

После сохранения файла, для внесения изменений в список системных юнитов, выполните:

sudo systemctl daemon-reload.

Включите автоматический запуск приложения при запуске операционной системы

sudo systemctl enable vedoc

Используйте команды запуск/остановка/отслеживание статуса для управления работой приложения:

sudo systemctl start/stop/status vedoc

Проверка наличия Java в Windows

Убедитесь, что на вашем компьютере установлена Java version 8. Для этого откройте раздел «Установка и удаление программ» и найдите в нем Oracle Java версии 8 или Axiom JDK версии 8. Если программа не найдена, перейдите на сайт https://axiomjdk.ru/pages/downloads/ и скачайте сборку для вашей разрядности системы Windows.

Установите скачанный файл c настройками по умолчанию. При наличии Oracle Java проверьте и при отсутствии создайте переменную окружения JAVA_HOME (Мой компьютер - Свойства - Дополнительные параметры системы - Переменные среды...)

В разделе Системные переменные создать новую с именем JAVA_HOME и значением C:\Program Files\Java\jdk1.8.0_321 – данное значение приведено для установленной java версии 1.8.0.321. Имя каталога для вашей версии будет другим.

Распаковка приложения

Дистрибутив поставляется в виде архива. Создайте каталог, в котором будет размещаться программа. Распакуйте архив в созданный каталог.

Особенности при использовании СУБД MS SQL Server

Запустите SQL Management Studio и разверните ветку Безопасность под узлом вашего сервера. В "Имена для входа" выбрать логин sa и посмотреть его свойства.

Скорее всего, у вас там Russian. Это приводит к проблемам выполнения скриптов. По этой причине не загружаются все данные типовых настроек, т.к. в скрипте формат даты интернациональный, а если у sa установлен русский язык, то SQL ожидает даты в формате русской локали. Измените для логина sa язык по умолчанию на English - us_english.

Особенности при использовании СУБД PostgreSQL в Windows

Дистрибутив доступен по ссылке: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

Средство администрирования PgAdmin: https://www.pgadmin.org/download/pgadmin-4-windows/

При установке на шаге выбора локализации выберите:

Остальные пункты изменения не требуют.

Создание базы данных

Средствами СУБД создайте пустую базу (используемое по умолчанию в конфигурационном файле имя базы vedocdb):

В MS SQL Server в создаваемой базе «Параметры сортировки» должны быть «Cyrillic_GeC_AS»

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

Изменение конфигурационного файла для подключения к БД

При создания базы с другим именем – произведите корректировку файла local.app.properties в каталоге tomcat\webapps\vedoc\WEB-INF.

В текущей конфигурации установлены параметры по умолчанию для PostgreSQL:

• cuba.dataSource.username = postgres – владелец базы данных (при создании БД от имени другого пользователя измените это значение );

• cuba.dataSource.password= postgres – пароль владельца базы данных (был задан вами на этапе установки СУБД, при необходимости измените);

• cuba.dataSource.dbName = vedocdb – имя базы данных;

• cuba.dataSource.host = localhost – имя сервера СУБД (при использовании на одном сервере, при использовании отдельного сервера СУБД измените данное поле);

cuba.dataSource.port = 5432 – порт СУБД;

Параметры при использовании MS SQL Server:

Добавьте строку:

• cuba.dbmsType = mssql

Измените:

• cuba.dataSource.username = sa – владелец базы данных;

• cuba.dataSource.password= XXXXXXX – пароль владельца базы данных;

• cuba.dataSource.dbName = vedocdb – имя базы данных;

• cuba.dataSource.host = localhost – имя сервера СУБД (при использовании на одном сервере, при использовании отдельного сервера СУБД измените данное поле);

• cuba.dataSource.port = 1433 – порт СУБД.

Изменение имени компьютера и номера порта приложения

Для своей работы приложение использует порт 8080 и локальное имя компьютера.

Для своей работы приложение использует порт 8080 и локальное имя компьютера. При необходимости использования приложения по локальной сети произведите изменения:

• в файле tomcat\webapps\vedoc\WEB-INF\local.app.properties значение localhost в параметре cuba.webAppUrl = http://localhost:8080/vedoc на имя или IP адрес компьютера, где установлена программа. Номер порта 8080 на требуемое вами значение порта. В свойстве приложения cuba.connectionUrlList измените номер порта 8080 на новое.

• в файле tomcat\conf\server.xml найдите секцию:

• измените port="8080" на новое значение.

Пробный запуск приложения

Запустите на выполнение файл startup.bat из каталога tomcat/bin/

Появление сообщения: INFO: Server strartup in …. ms означает запуск приложения.

Для доступа к приложению перейдите в браузере по ссылке http://localhost:8080/vedoc

В случае внесении изменений в имя, например test и/или номера порта, например на 8111, ссылка будет иметь вид: http://test:8111/vedoc

При правильной настройке вы попадете на страницу входа Ведок:

Учетные данные для входа administrator/administrator – логин/пароль соответственно.

Команды запуск/остановка приложения:

Для запуска приложения перейдите в каталог \tomcat\bin и запустите файл startup.bat. Для остановки приложения запустите файл shutdown.bat в этом же каталоге

Установка запуска/остановки приложения через системную службу

• Откройте «командную строку» от имени администратора.

• Перейдите в папку tomcat\bin внутри распакованного дистрибутива Ведок. Например, если вы распаковали дистрибутив в директорию c:\Vedoc\, то команда будет выглядеть так:

cd c:\Vedoc\tomcat\bin

• Выполните service.bat install

После установки приложения системной службой управление запуском и остановкой выполняется через Панель управления -> Администрирование -> Службы -> ApacheTomcat…

Проверка наличие установленной программы Java

Проверьте наличие установленной программы java, запустив Терминал.

java -version

Ниже приведен вывод данной команды, показывающий установленную версию Java:

Загрузка и установка Java версии 8 от компании BellSoft

При отсутствии произведите загрузку и установку Java версии 8 от компании BellSoft https://axiomjdk.ru/pages/downloads/

Установка PostgreSQL

Доступные ресурсы для загрузки PostgreSQL: https://www.postgresql.org/download/macosx - для загрузки и установки полной версии с утилитами для управления или https://postgresapp.com/downloads.html - приложение, без необходимости установки и без утилит для управления СУБД.

Установите утилиту для администрирования СУБД – pgAdmin:

https://www.pgadmin.org/download/pgadmin-4-macos

Распаковка архива с приложением

Дистрибутив поставляется в виде архива. Создайте каталог /opt/vedoc, в котором будет размещаться программа. Распакуйте архив в созданный каталог.

Создание базы данных

Средствами СУБД или с помощью утилиты pgAdmin создайте пустую базу (по умолчанию имя базы vedocdb, владелец vedoc с паролем vedoc).

Изменение конфигурационного файла для подключения к БД

В случае создания базы с другим именем – измените файл local.app.properties в каталоге /opt/vedoc/webapps/vedoc/WEB-INF, внеся необходимые изменения:

• cuba.dataSource.username = vedoc – владелец базы данных;

• cuba.dataSource.password= vedoc – пароль владельца базы данных;

• cuba.dataSource.dbName = vedocdb – имя базы данных;

• cuba.dataSource.host = localhost – имя сервера СУБД (при использовании на одном сервере);

• cuba.dataSource.port = 5432 – порт СУБД.

Изменение имени компьютера и номера порта приложения

Для своей работы приложение использует порт 8080 и локальное имя компьютера. При необходимости использования приложения по локальной сети произведите изменения:

• в файле /opt/vedoc/tomcat/webapps/vedoc/WEB-INF/local.app.properties значение localhost в параметре cuba.webAppUrl = http://localhost:8080/vedoc на имя или IP адрес компьютера, где установлена программа. Номер порта 8080 на требуемое вами значение порта. В свойстве приложения cuba.connectionUrlList измените номер порта 8080 на новое.

– в файле opt/vedoc/tomcat/conf/server.xml, найдите блок параметров:

И измените port="8080" на значение, выбранное на предыдущем шаге.

Установка бита исполнения у запускаемых файлов

В каталоге /opt/vedoc/tomcat/bin приложения установите бит исполнения на все файлы с расширением .sh (в Терминале sudo chmod u+x /opt/vedoc/tomcat/bin/*.sh)

Запуск и остановка приложения

Выполните startup.sh из каталога /opt/vedoc/tomcat/bin для запуска приложения.

Для доступа к приложению перейдите в браузере по ссылке http://localhost:8080/vedoc В случае внесения изменений в имя, например test и/или номера порта, например на 8111, ссылка будет иметь вид: http://test:8111/vedoc

Остановка приложение производится выполнением команды shutdown.sh из каталога /opt/vedoc/tomcat/bin

Учетные данные для входа administrator/administrator – логин/пароль соответственно.