Установка Doczilla на Windows ОС

Любая инструкция является примерной,
и создана для того, чтобы показать основные команды и действия,
в связи с очень большим разнообразием linux-систем и windows-систем

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

Для работы приложения Doczilla Pro необходимо в наличии установленное дополнительное ПО, для установки которого можно обратиться к официальной документации или использовать примеры на нашем сайте:

- JAVA JDK 1.8 или OpenJDK 8 (обязательно Java Development Kit) - для работы Doczilla Pro, пример установки  Пример установки JAVA JDK

- NodeJS 16.7 (или версии выше) - для скачивания форматированных документов, пример установки  Пример установки NodeJS

- PostgreSQL 11 (или версии выше) - база данных для работы Doczilla Pro, пример установки  Пример установки PostgreSQL

- LibreOffice 6 (или версии выше) - для скачивания документов в формате PDF

Распаковка

Сборка Doczilla и nodejs-скриптов поставляется в архивных файлах, которые необходимо распаковать, рекомендуем для этого создать отдельную папку на диске, например  C:\DZ\

1. Архив  pro.doczilla-3.0.0-202412312359.zip  необходимо распаковать и переименовать в папку C:\DZ\doczilla

2. Архив  pro.doczilla.nodejs-3.0.0-202412312359.zip  необходимо распаковать и переименовать в папку C:\DZ\doczilla.nodejs

3. Создать директорию  C:\DZ\doczilla\log


Настройка службы автозапуска

1. Для автоматического запуска службы необходимо указать путь в конфиге  .\doczilla\conf\wrapper.conf

#set.JAVA_HOME=/java/path

надо раскомментировать и отредактировать на реальный путь до JAVA (зависит от установленной версии Java JDK), например

set.JAVA_HOME=C:\Program Files\Java\jre1.8.0_321

2. Для установки Doczilla Pro службой необходимо запустить скрипт установки, при срабатывании фильтра SmartScreen - выбрать: "Подробнее" - нажать: "Выполнить в любом случае"

C:\DZ\doczilla\bin\install.bat

3. Дальнейший запуск/остановку осуществлять или через оснастку Службы или через файлы .\bin\start.bat, .\bin\stop.bat (выбирая "Выполнить в любом случае", при срабатывании фильтра SmartScreen)


Создание базы данных и настройка конфигурации

Необходимо на сервере СУБД создать базу данных и её настроить, можно это сделать из командной строки под Администратором

> cd "c:\Program Files\PostgreSQL\15\bin"                             ## переходим в папку с установленной PostgreSQL 
> createdb -U postgres -T template0 doczilla                          ## создание БД doczilla

> psql -U postgres                                                    ## вход в редактор
postgres=# CREATE ROLE doczilla WITH PASSWORD 'doczilla' LOGIN;       ## создание в БД пользователя doczilla с паролем doczilla

postgres=# \c doczilla                                                ## переключение к БД doczilla
doczilla=# CREATE EXTENSION pg_trgm;                                  ## включение расширения для ускорения поиска
doczilla=# CREATE SCHEMA nameschema AUTHORIZATION doczilla;           ## создание схемы NameSchema в БД (лучше сменить на название организации)
doczilla=# \q                                                         ## выход из редактора


Настройка файла конфигурации server.properties

Для настройки Doczilla необходимо отредактировать в текстовом редакторе файл конфигурации .\doczilla\conf\server.properties

notepad.exe  c:\DZ\doczilla\conf\server.properties

Необходимо указать название базы данных, имя схемы, логин и пароль владельца схемы в БД, адрес и порт базы данных, а так же путь до установленной LibreOffice,
 пример отредактированного конфига:

## указать имя схемы в БД (рекомендуем использовать наименование организации)
application.database.schema=nameschema
## указать имя пользователя владельца схемы в БД
application.database.user=doczilla
## указать пароль пользователя БД
application.database.password=doczilla
application.database.driver=org.postgresql.Driver
## указать адрес сервера СУБД, порт и имя БД
application.database.connection=jdbc:postgresql://192.168.0.10:5432/doczilla
.....
## путь до установленной LibreOffice
office.home="c:\\Program Files\\Libreoffice"
.....


Установка и настройка закончена

Необходимо запустить (перезапустить) службу Doczilla через оснастку Службы или через файлы .\bin\start.bat и .\bin\stop.bat

c:\DZ\doczilla\bin\start.bat


Настройка автоматического запуска NodeJS

Необходимо зайти в Панель Управления - Администрирование (Инструменты Windows) - Планировщик задач

Выбрать "Создать простую задачу" - Имя: NodeJS - "Далее" - триггер "При запуске компьютера" - "Далее" - Действие "Запустить программу" - "Далее"
- через "Обзор" выбрать директорию с установленной программой и запускаемый файл node.exe, чаще всего это: "C:\Program Files\nodejs\node.exe"
- добавить в строке аргументы: "C:\DZ\doczilla.nodejs\cluster.js" - нажать "Далее" - выбрать: "Открыть окно "Свойства" после нажатия кнопки Готово" - "Готово"
- на вкладке "Общие" - поле "Параметры безопасности" - выбрать "Выполнять для всех пользователей" - выбрать "Выполнить с наивысшими правами"
- в строке выбора учетной записи - нажать на кнопку "Изменить" - нажать на кнопку "Дополнительно" - нажать на кнопку "Поиск"
- найти в списке учетную запись "СИСТЕМА" - нажать "ОК" - "ОК"
- на вкладке "Параметры" - снять галку в строке "Останавливать задачу, выполняемую дольше 3 дней" - "ОК"

Для запуска необходимо в списке задач выбрать созданную "NodeJS" - в меню "Действия" - выбрать элемент "Включить" (или правой клавишей мыши - Включить)

Первый вход и генерация схемы

Необходимо запустить браузер Google Chrome / Microsoft Edge последних версий и перейти на сайт сервера

http://localhost:9080

при первом входе откроется сайт Doczilla, где в меню "Администрирование" - необходимо выбрать "Генерация схемы".

После успешного выполнения необходимо перелогиниться, в окне авторизации ввести логин Admin поле пароля оставить пустым, нажать "Войти", после этого необходимо дважды задать пароль для учетной записи Администратора.