Установка¶

Протестировано на следующих операционных системах x86-64:

Astra Linux
RED OS
Alt Linux
ROSA
Ubuntu 20+
Red Hat 8+
Debian 10+

Установка¶

mkdir -p /usr/local/xsquare.xreports

Перенос контента¶

scp -r  xreports assets/ templates/  root@[host]/usr/local/xsquare.xreports

Установка Libre Office¶

Рекомендуем устанавливать дистирибутив Libre Office версии 7.4.7.2 с сайта производителя(не из репозитория OS):

tar -xvzf LibreOffice_7.4.7.2_Linux_x86-64_rpm.tar.gz
cd LibreOffice_7.4.7.2_Linux_x86-64_rpm/
cd RPMS/
yum install *.rpm
find  / -name "soffice"
vi /usr/local/xsquare.xreports/config.json

Настройка Systemctl¶

vi /etc/systemd/system/xsquare.xreports.service

[Unit]
Description=XSQUARE-Reports
After=syslog.target
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/xsquare.xreports/xreports
WorkingDirectory=/usr/local/xsquare.xreports
User=root

[Install]
WantedBy=multi-user.target

Запуск служб¶

systemctl daemon-reload
systemctl enable xsquare.xreports
systemctl start xsquare.xreports
systemctl status xsquare.xreports

Установка Шрифтов для RED OS¶

dnf install msttcore-fonts-installer
fc-cache –fv

Файл конфигурации config.json¶

Для работы сервера отчетов необходимо, чтобы в директории с сервисом присутствовал файл конфигурации config.json. Файл конфигурации содержит 3 раздела:

Описатель App, где можно определить базовые настройки сервиса:

    {
"app": {
    "port": "8087",
    "debug": false
},

«port» - строка. Определяет номер сетевого порта, на котором будет запущен сервис (по умолчанию - 8087)
«debug» - логическое значение. Включает режим отладки, при котором доступен подробный лог обработки запросов, а также происходит сохранение всех запросов и готовых документов в локальной директории reports_debug сервиса (аналогично действию флага enable-debug-report-save в свойствах запроса). Значение по умолчанию - false.

Описатель formatConversion, где определяются настройки для приложения Libre Office soffice:

"formatConversion": {
        "format-conversion-dir": "",
        "soffice-max-process-count": 0,
        "soffice-path": ""
},

«format-conversion-dir» - строка. Определяет директорию для хранения временных файлов (по умолчанию - «/tmp»)
«soffice-max-process-count» - число. Определяет количество ядер процессора, которое может использовать soffice для конвертации ( по умолчанию - «0», использовать все доступные ядра)
«soffice-path» - строка. Определяет путь до исполняемого файла soffice (по умолчанию - путь, записанный в переменные окружения при установке Libre Office)

Описатель license, где определяются настройки в соответствии с лицензионным соглашением:

"license": {
        "TAX_ID": "tax id",
        "TAX_NAME": "name",
        "WORKER_COUNT": 5,
        "CORE_COUNT": 3,
        "LICENSE_ID": "61c06e5d",
        "LICENSE_EXPIRATION_DATE": "10.10.2073",
        "SUPPORT_EXPIRATION_DATE": "11.11.2023",
        "SIGNATURE": "yQLpwB54SSgDgVh1LX9sUxR7o7EyZC//JmEtlEYOvtM7XY="
        }
}