=====================================================================================
# ЗАПУСК КМАЗС-ОФИС на Linux - установка программы КМАЗС-ОФИС на AstraLinux из DEB-пакета
=====================================================================================

Инсталляционный DEB-пакет установки программы КМАЗС-ОФИС v.5 для РЕД ОС доступен по ссылке:
https://www.automatikaplus.ru/ftp/KMAZS/OFFICE%20PROGRAM/INSTALL/Version5.xx/for-linux-astra/

deb-пакет называется "kmazs-office-qt5", однако файл пакета содержит в своём имени также номер версии (например "5.4"), версию сборки rpm-пакета (например, "1") и архитектуру процессора (x86_64).
Пример названия deb-файла: kmazs-office-qt5_5.4.0_amd64.deb

Вы можете заранее скачать deb-файл с помощью браузера, а затем установить на компьютер вручную.
Например, если вы скачали файл "kmazs-office-qt5_5.4.0_amd64.deb" и разместили его в папке "Загрузки" домашнего каталога,
то для установки программы КМАЗС-ОФИС используйте команды:

cd ~/Загрузки/
sudo apt install ./kmazs-office-qt5_5.4.0_amd64.deb

Внимание! Не забудьте учесть актуальный номер версии пакета перед выполнением команды установки пакета!
Внимание! Для установки пакета требуются права администратора, т.к. используется команда "sudo".

Если браузер не установлен, то для скачивания rpm-файла в папку "Загрузки" используйте команду:

wget -P ~/Загрузки 'https://www.automatikaplus.ru/ftp/KMAZS/OFFICE%20PROGRAM/INSTALL/Version5.xx/for-linux-astra/kmazs-office-qt5_5.4.0_amd64.deb'

## Решение проблемы с установкой DEB-пакета

В каталоге "https://www.automatikaplus.ru/ftp/KMAZS/OFFICE%20PROGRAM/INSTALL/Version5.xx/for-linux-astra" находится файл с контрольной суммой sha256 (например, "kmazs-office-qt5_5.4.0_amd64.deb.sha256"). Если установщик выдаёт ошибку контрольной суммы sha256, то выполните команду: 

cd ~/Загрузки/
sha256sum ./kmazs-office-qt5*.deb

В результате будет отображаться контрольная сумма deb-файла в формате HEX. Сравните его с содержимым файла с контрольной суммой.

Проверку контрольной суммы файла вы можете выполнить и на Windows с помощью команды:
certutil -hashfile kmazs-office-qt5_5.4.0_amd64.deb SHA256

Если контрольная сумма не совпадает, значит deb-файл скачался с ошибкой (скачался не полностью либо в него внёс изменение антивирус).

## Удаление программы КМАЗС-ОФИС

Если вы установили программу КМАЗС-ОФИС по ошибке либо она больше не нужна, то для удаления используйте команду:
sudo apt remove kmazs-office-qt5

## Зависимости программы КМАЗС-ОФИС

deb-пакет "kmazs-office-qt5" зависит от следующих пакетов:
- libc6,
- libglib2.0-0,
- libx11-6,
- libqt5pas1,
- libtommath1

Указанные пакеты (в случае их отсутствуя в АстраЛинукс) будут установлены автоматически при установке пакета kmazs-office-qt5.

Внимание! Если у администратора, который будет производить установку ПО, доступ к репозиторию отсутствует, то необходимо ЗАРАНЕЕ скачать необходимые пакеты (для этого специалист может установить АстраЛинукс на виртуальной машине своего компьютера) и сохранить их на флешку.

Кроме того, для работы программы КМАЗС-ОФИС требуется пакет "grdcontrol" (см. install-guardant-drivers-rpm.txt).
Также требуется установить СУБД Firebird (см. setup-firebird-AstraLinux.txt), причем если устанавливается ПО для дополнительного рабочего
места (без собственной базы данных), то достаточно установить только клиентскую библиотеку (пакет libfbclient2).

Список пакетов для СУБД Firebird 4: firebird, firebird-utils, libfbclient2
Список пакетов для СУБД Firebird 5: firebird5, firebird5-utils, libfbclient2

Если используется карт-ридер ACR-1281, то потребуется установить ещё несколько пакетов (см. setup-reader-acr1281.txt и setup-reader-acr1281-RedOS.txt)

## Каталог программы КМАЗС-ОФИС

Программа КМАЗС-ОФИС устанавливается в каталог "/opt/kmazs/"
- /opt/kmazs - корневой каталог программы КМАЗС-ОФИС
- /opt/kmazs/DataBase - каталог базы данных. По умолчанию файл базы данных отсутствует, т.к. на этапе установки пакета неизвестна версия СУБД Firebird
- /opt/kmazs/LogFiles - каталог в логами
- /opt/kmazs/TEMP - каталог в временными файлами программы
- /opt/kmazs/FormPatterns - каталог с файлами шаблонов отчётоов
- /opt/kmazs/KMAZSOfficeQt5 - исполняемый файл графической программы КМАЗС-ОФИС (Qt5 говорит о том, что используются графические элементы библиотеки Qt5)
Внимание! К каталогу "/opt/kmazs" имеют доступ только пользователи, состоящие в группе "kmazs-admins". Рекомендуется заранее добавить в группу "kmazs-admins" тех пользователей, которые будут запускать программу КМАЗС-ОФИС из корневого каталога. Это требуется для административных целей. Обычных операторов добавлять в группу "kmazs-admins" не требуется, лучше для них создать индивидуальный каталог "kmazs" в домашнем каталоге (см. start-kmazs-office.txt).

## Добавление пользователя в группу "kmazs-admins"

Для добавления конкретного пользователя в группу "kmazs-admins" используйте команду:
sudo usermod -aG kmazs-admins user_name
где user_name - имя (логин) конкретного пользователя.
Если требуется добавить в группу "kmazs-admins" текущего пользователя, то используйте команду:
sudo usermod -aG kmazs-admins $USER

Внимание! После добавления пользователя в группу "kmazs-admins" новая группа НЕ ПРИМЕНЯЕТСЯ автоматически. Для того, чтобы группа применилась, необходимо начать новый сеанс. Самый надежный способ - выйти из системы и заново войти. Если вы работаете из терминала, то в качестве временного решения, не требующего перелогина, можно использовать команду временного применения группы "newgrp kmazs-admins", однако эта команда дейстует только на текущей сеанс в терминале.