# ЗАПУСК КМАЗС-ОФИС на Linux - описание режимов запуска Программу КМАЗС-ОФИС можно запускать в различных режимах: 1) В графическом режиме под администратором (оператор должен состоять в группе "kmazs-admins") 2) В графическом режиме под оператором (оператор НЕ состоит в группе "kmazs-admins") 3) В режиме "служба" (служба запускается под системным пользователем "kmazs-service") # Запуск КМАЗС-ОФИС в графическом режиме под администратором 1. Убедитесь, что учётная запись администратора (допустим, она называется ivanov_ap) состоит в группе "kmazs-admins". Для проверки используйте команду: groups ivanov_ap в результате будет отображаться перечень групп, в которых состоит администратор. Если "kmazs-admins" в этом перечене отсутствует, то выполните команду: sudo usermod -aG kmazs-admins ivanov_ap Внимание! После добавления пользователя в группу "kmazs-admins" необходимо завершить сеанс (выйти из системы) и залогиниться заново. Иначе группа "kmazs-admins" не применится и программа работать не будет. 2. Убедитесь, что служба firebird запущена. Запуск firebird требуется только для основного рабочего места. Если вы настраиваете дополнительное рабочее место, то запускать службу firebird не требуется. Для проверки используйте команду: systemctl status firebird В результате будет отображаться подробная информация о запущенной службе. Важно убедиться, что отображается строка "Active: active (running)", например: Active: active (running) since Mon 2026-04-06 15:47:06 MSK; 6 days ago 3. Для запуска программы КМАЗС-ОФИС из командной строки используйте команду: cd /opt/kmazs ./KMAZSOfficeQt5 либо одной командой: /opt/kmazs/KMAZSOfficeQt5 Если при попытке запуска программы возникнет ошибка, то попытайтесь её устранить. Если самостоятельно устранить не получается, то обратитесь к разработчику. 4. Если с программой КМАЗС-ОФИС будет работать пользователь, включенный в группу "kmazs-admins", то рекомендуется создать ярлык на рабочем столе. 4.1 Создание ярлыка в ОС РЕД ОС Для создания ярлыка в ОС РЕД ОС можно создать в папке "Рабочий стол" (в каталоге пользователя) файл КМАЗС-ОФИС.desktop и вставить в него следующее содержимое: [Desktop Entry] Name=КМАЗС-ОФИС Exec=/opt/kmazs/KMAZSOfficeQt5 Icon=/opt/kmazs/Icons/kmazs.png Type=Application Terminal=false Для этих целей выполните следующие действия: 1) перейдите в каталог "Рабочий стол": cd ~/Рабочий\ стол/ 2) откройте файл КМАЗС-ОФИС.desktop на редактирование с помощью текстового редактора "pluma": pluma КМАЗС-ОФИС.desktop 3) вставьте в него содержимое, указанное выше (см. п. 4.1). 4) сохраните изменения (пункт меню Файл / Сохранить). После этого найдите созданный ярлык на рабочем столе, выполните двойной щелчок мышкой и убедитесь, что программа запускается. В качестве рабочего каталога программа будет использовать папку "/opt/kmazs/". Настройки подключения к базе данных будут браться из файла "/opt/kmazs/KMConfig.ini". Логи будут писаться в папку "/opt/kmazs/LogFiles". # Запуск КМАЗС-ОФИС в режиме службы Для запуска в режиме службы используется исполняемый файл "/opt/kmazs/KMAZSOfficeService". Внимание! Вы можете пропустить этот пункт, если файл "/opt/kmazs/KMAZSOfficeService" отсутствует (в сокращённой версии инсталлятора). Рекомендуется убедиться, что на ключе защиты достаточно лицензий для запуска в режиме службы, т.к. при запуске в этом режиме расходуется одна лицензия (если на ключе защиты лишь одна лицения и программа уже запущена в графическом режиме, то запустить её в режиме "служба" не получится). Кроме того, если вы решили запускать программу в режиме "служба" то она будет использовать настройки подключения к базе данных, а также настройки обмена с КМАЗС, заданные в файле "/opt/kmazs/KMConfig.ini". Это может приводить к конфликту, поэтому, если вы запускаетсе службу, то не следует одновременно запускать программу в графическом режиме, т.к. она загрузит настройки из файла "/opt/kmazs/KMConfig.ini" и будет производить те же самые автоматически операции (например, обмен с КМАЗС, выгрузку в файлы), что и служба. Для решения этой проблемы в команде запуска программы следует явно указывать папку, из которой программа будет загрузать файл "KMConfig.ini". Для явного указания папки используется ключ -appdatapath, после которого следует указать полный путь к папке. Перед тем, как запускать службу, необходимо убедиться, что программа КМАЗС-ОФИС корректно запускается, в ней настроена конфигурация КМАЗС и настроен автоматический обмен с КМАЗС. Только убедившись в работоспобности программы в графическом режиме, есть смысл запускать службу. Для запуска службы необходимо: 1. Обновить информацию о службах: sudo systemctl daemon-reload 2. Включить автозапуск службы "kmazs-office.service": sudo systemctl enable kmazs-office.service 3. Запустить службу "kmazs-office.service": sudo systemctl start kmazs-office Внимание! Служба стартует с небольшой задержкой (5 секунд), иначе она может загрузиться раньше, чем firebird и это может привести к проблемам. 4. Убедиться, что служба запустилась: sudo systemctl status kmazs-office 5. Убедитесь, что появился файл "/opt/kmazs/LogFiles/KMAZSOfficeService.log" # Запуск КМАЗС-ОФИС в графическом режиме под ограниченным пользователем Перед настройкой данного режима необходимо убедиться, что программа корректно запускается в режиме под администратором (см. раздел "Запуск КМАЗС-ОФИС в графическом режиме под администратором"). После запуска под администратором будет сформирован файл "/opt/kmazs/KMConfig.ini". В нём будут сохранены параметры подключения к базе данных. Далее необходимо выполнить следующие действия: 1. Создать папку "kmazs" в профиле пользователя: mkdir ~/kmazs Если требуется настроить запуск не для текущего пользователя, то следует явно указать имя пользователя: mkdir /home/ivanov_ap/kmazs 2. Скопировать файл "/opt/kmazs/KMConfig.ini" в папку пользователя: cp /opt/kmazs/KMConfig.ini ~/kmazs либо: cp /opt/kmazs/KMConfig.ini /home/ivanov_ap/kmazs 3. Создать ярлык для запуска КМАЗС-ОФИС с рабочим каталогом "kmazs" в профиле пользователя. 3.1 Для создания ярлыка в ОС РЕД ОС необходимо в папке "Рабочий стол" создать файл "КМАЗС-ОФИС.desktop" и вставить в него следующее содержимое: [Desktop Entry] Name=КМАЗС-ОФИС Exec=/opt/kmazs/KMAZSOfficeQt5 -appdatapath "/home/ivanov_ap/kmazs" Icon=/opt/kmazs/Icons/kmazs.png Type=Application Terminal=false Обратите внимание: в тэге "Exec" указан домашний каталог пользователя "ivanov_ap". Вместо него следует указать реального пользователя. Подробная информация о создании ярлыка в РЕД ОС приведена выше, в п. 4.1 раздела "Запуск КМАЗС-ОФИС в графическом режиме под администратором". 3.2 Кроме того, вы можете создать ярлык на рабочем столе вручную (в графическом режиме). Для этого следует щелкнуть на рабочем столе правой кнопкой мыши и выбрать пункт "Создать кнопку запуска" либо "Создать ярлык" в зависимости от дистрибутива Linux. 4. Дважды щелкните мышкой ярлык на рабочем столе и убедитесь, что программа запускается. 4.1 Войдите в программу с использованием админской учётной записи. 5. Скорректируйте настройки программы, чтобы были исключены автоматические операции, которые настроены для основного экземпляра программы. 5.1 откройте окно "Настройки программы" (меню Настройки / Настройки программы), 5.2 отключите автоматический обмен для каналов RS-485, Ethernet/Wi-Fi, Модем, GPRS. 5.3 Отключите автоматический экспорт в разделе "Параметры экспорта". 5.4 В разделе "Резервирование" снимите флаг "Выполнять резервирование каждые ...". 5.5 В разделе "Размещение данных" скорректируйте название рабочего места. Например, вместо пути /OPT/KMAZS укажите ФИО оператора. 5.6 В разделе "Обмен с КМАЗС" включите пункт "обмен с КМАЗС производить не напрямую (формировать команду обмен данными для другой программы)".