FAQ

Частые вопросы

Просмотр логов и выгрузка в файл

В операционной системе Linux логи хранятся в системном журнале, для просмотра необходимо выполнить команды

## просмотр логов на экране
journalctl -xeu doczilla

## выгрузка всех логов в файл
journalctl -u doczilla >> /tmp/dz.log

## выгрузка логов за определенный период времени в файл
journalctl -u doczilla --since '2024-01-15 10:08:00' --until '2024-01-16 15:00:00' >> /tmp/dz.log

Для хранения логов в файле можно изменить скрипт запуска ./doczilla/bin/service.sh

## хранение логов в системном журнале
JAVA_OPTS="$JAVA_OPTS -Dorg.slf4j.simpleLogger.logFile=System.out"

## хранение логов в файле
JAVA_OPTS="$JAVA_OPTS -Dorg.slf4j.simpleLogger.logFile=/opt/dz.log"

В операционной системе Windows логи хранятся в файле .\doczilla\log\wrapper.log 

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

Для поиска где хранится документ в файловой системе Doczilla, необходимо знать его documentId, далее логинимся на сервер приложения, и выполняем команду поиска 

##  указываем где искать, потом указываем искать директорию по documentID (можно по полному ID или первой части, но указать символ * звездочка)
find /opt/doczilla/work/documents/ -type d -iname '1A20DD57-8684*'

##  в ответ выдаст строку где расположен файл.

Изменить web-порт используемый в Doczilla

По умолчанию Doczilla использует HTTP порт 9080, который можно сменить в файле 

## Linux - файл ./doczilla/work/server.properties
 ## добавить строку и указать порт
web.server.http.port=80

 ## Windows - файл ./doczilla/conf/wrapper.conf
 ## найти строку и заменить порт
wrapper.java.additional.3=-Dz8.web.server.http.port=80

Увеличение заголовка для Kerberos

Ошибки в браузере: 431 Request Header Fields Too Large / 400 Request Header OR Cookie Too Large

Ошибка в логах: WARN:oejh.HttpParser:qtp891095110-76159: Header is too large 8193>8192

Учетная запись пользователя была смигрирована из другого домена или состоит в очень большом количестве доменных групп, поэтому получается слишком большой заголовок токена Kerberos. Для изменения размера заголовка необходимо прописать в файлы:

## файл /etc/nginx/conf.d/doczilla.conf
server {
...
large_client_header_buffers 8 64k;
...
}

## файл ./doczilla/work/server.properties
web.server.request.header.size=64536
web.server.response.header.size=64536

И перезапустить службу nginx и службу doczilla.

Запуск двух сборок на одном сервере

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

Веб порт Докзилла по умолчанию:  9080

## Linux - файл ./doczilla/work/server.properties
 ## добавить строку и указать порт
web.server.http.port=80

 ## Windows - файл ./doczilla/conf/wrapper.conf
 ## найти строку и заменить порт
wrapper.java.additional.3=-Dz8.web.server.http.port=80
 ## найти строки и заменить название службы
wrapper.name=Doczilla2
wrapper.displayname=Doczilla Standalone Server 2
wrapper.description=Doczilla Standalone Server 2

Порт NodeJs по умолчанию:   3000

## Linux / Windows - файл ./doczilla.nodejs/server.js
 ## найти строку и заменить порт
var port = normalizePort(process.env.PORT || '3001');

Порт LibreOffice по умолчанию:  8100

## Linux / Windows - файл ./doczilla/work/server.properties
 ## добавить строку и указать порт
office.port=8101

Не забываем так же  указать на другую схему или новую базу данных

## Windows/Linux - файл ./doczilla/work/server.properties
application.database.schema=newnameschema
...
application.database.connection=jdbc:postgresql://localhost/newnamebase

После всех изменений необходимо перезапустить службу Докзилла

Ошибка при генерации схемы "operator class 'gist_trgm_ops' does not exit for method 'gist'"

В базе данных нет плагина pg_trgm, который устанавливается файлом postgresql-contrib. Плагин включается командой:

su - postgres
psql doczilla
CREATE EXTENSION pg_trgm;
\q

Добавление шрифтов

В Doczilla шрифт "Times New Roman" подменяется бесплатным шрифтом "XO Thames", чтобы использовать оригинальный шрифт, его необходимо установить и поправить конфиг в файле fonts.mjs:

## в файле /opt/doczilla/web/css/fonts/fonts.mjs
## настройка для замены шрифтов по умолчанию

  'Times New Roman': {
        'alt': [
            'XO Thames'
        ]
    },

## чтобы убрать замену шрифта, необходимо изменить конфиг

  'Times New Roman': {},

Пример установки шрифтов в Debian / Astra Linux

## скачиваем шрифты из репозитория debian
wget http://ftp.de.debian.org/debian/pool/contrib/m/msttcorefonts/ttf-mscorefonts-installer_3.7_all.deb 

## устанавливаем скаченные шрифты
apt install ./ttf-mscorefonts-installer_3.7_all.deb 

## обновляем кэш шрифтов
fc-cache

Пример установки шрифтов в CentOS 7/8/9 / Rocky Linux / Ред ОС

## устанавливаем для CentOS 7 необходимые утилиты для работы с шрифтами
yum install curl cabextract xorg-x11-font-utils fontconfig

## скачать нужную утилиту для версий 8/9 можно по ссылке
https://pkgs.org/download/xorg-x11-font-utils

## скачиваем шрифты для всех версий из репозитория
wget https://downloads.sourceforge.net/project/mscorefonts2/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm
## или
wget https://rpmfind.net/linux/sourceforge/m/ms/mscorefonts2/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

## устанавливаем скаченные шрифты
yum install ./msttcore-fonts-installer-2.6-1.noarch.rpm

## обновляем кэш шрифтов
fc-cache