# ЗАПУСК КМАЗС-ОФИС на Linux - установка и настройка СУБД Firebird для ОС "РЕД ОС"

В данной инструкции предоставлена информация - как установить Firebird из репозитория Ред ОС.
Firebird 4.0 имеется в базовом репозитории. На июль 2026г актуальная версия: 4.0.7.
Версия Firebird 5.0 более популярна, однако в "РЕД ОС" для его использования потребуется установить пакет "redos-firebird5-release" для подключения расширенного репозитория "firebird5". Есть вероятность, что репозиторий "firebird5" окажется недоступен (если РЕД ОС установлен у компании с собственными репозиториями).
Невозможно установить одновременно пакеты firebird (для Firebird 4.0) и firebird5, поскольку у них одинаковые пути к 
исполняемым файлам, библиотекам и файлам конфигурации. Рекомендуется использовать Firebird 5.0 (версии не ниже 5.0.3).
Обратите внимание: компания РЕД СОФТ разрабатывает собственную СУБД "Ред База Данных". Она почти на 100% совместима с Firebird (но формат файла базы данных немного отличается), является коммерческим решением и имеется в реестре Российского программного обеспечения.

Внимание! Если вы устанавливаете дополнительное рабочее место, то не следует устанавливать Firebird.
Достаточно установить клиентскую часть Firebird (пакет libfbclient2). Команды:
Проверка наличия пакета и его версии:
dnf list installed libfbclient2
Установка / обновление пакета:
sudo dnf install libfbclient2

Внимание! Если вы устанавливаете Firebird на отдельный сервер, где не планируется ставить программу КМАЗС-ОФИС, то не следует включать пользователя firebird в группу "kmazs-admins". Группа "kmazs-admins" в этом случае не требуется.

# 1. Установка и настройка Firebird 4.0

1.1. Проверить, какая версия Firebird сейчас установлена:
	dnf list installed firebird
	на июль 2026г актуальной является версия 4.0.7 (старые версии менее надёжны).
1.2. Для удаления пакета firebird (если возникнет необходимость) можно использовать команду:
	sudo dnf remove firebird
	Примечание. Удалять пакет может потребоваться в крайнем случае. Обычно достаточно выполнить обновление.
1.3. Для установки наиболее свежего пакета firebird использовать команду:
	sudo dnf install firebird
	На июль 2026 г. актуальной в РедОС является версия 4.0.7
1.4. Убедиться в том, что установлен пакет libfbclient2:
	dnf list installed libfbclient2
	Пример результата команды:
		Установленные пакеты
		libfbclient2.x86_64                4.0.6.3221-1.red80                 @update	
1.4.1 Если пакет 	libfbclient2 не установлен, то использовать команду:
	sudo dnf install libfbclient2
1.5. Исправить (при необходимости) симлинк "/usr/lib64/libfbclient.so.2", чтобы он указывал на "/usr/lib64/libfbclient.so.4.0.6", а не на "/usr/lib64/libgds.so.0"
1.5.1 Проверить, куда указывает симлинк "/usr/lib64/libfbclient.so.2" можно командой:
    ls -l /usr/lib64/libfbclient.so.2
1.5.2 Исправить симлинк (при необходимости) можно командой:	
	sudo ln -sf /usr/lib64/libfbclient.so.4.0.6 /usr/lib64/libfbclient.so.2	
1.6. Установить пакет с утилитами firebird-utils:
    Сперва проверить, установлен ли данный пакет: 
	dnf list installed firebird-utils
	Можно ознакомиться со списком файлов из этого пакета: dnf repoquery -l firebird-utils
	Установить / обновить пакет можно с помощью команды:
	sudo dnf install firebird-utils
1.7. Создать пользователя SYSDBA с безопасным паролем (английские символы, дефис, подчеркивание, цифры):
1.7.1 Остановить службу firebird:
	sudo systemctl stop firebird.service
1.7.2 Запустить команду "isql-fb" с повышенными правами:
	sudo /usr/bin/isql-fb -user SYSDBA
1.7.3 Выполнить команды (точка с запятой в конце команды - обязательна):
	CONNECT '/var/lib/firebird/secdb/security4.fdb';
	CREATE USER SYSDBA PASSWORD 'YourSecurePassword';
	COMMIT;
	EXIT;
	
	Примечание: стандартным паролем для пользователя SYSDBA является "masterkey" (использовать его допускается только в закрытой корпоративной сети);
1.8. Скорректировать настройки в файле /etc/firebird/firebird.conf	
   См. ниже раздел 3 (Коррекция настроек в файле "/etc/firebird/firebird.conf")
1.9. Снова запустить firebird: 
    sudo systemctl start firebird	


	
# 2. Установка и настройка Firebird 5.0

2.1. Установить пакет с адресами репозитория с пакетами firebird5:
	sudo dnf install redos-firebird5-release
2.2. Определить перечень пакетов из репозитория firebird5:
   dnf list "firebird*"
   Результат:   	
	firebird5.x86_64              5.0.3.1683-1.red80      firebird5
	firebird5-devel.x86_64        5.0.3.1683-1.red80      firebird5
	firebird5-doc.noarch          5.0.3.1683-1.red80      firebird5
	firebird5-examples.noarch     5.0.3.1683-1.red80      firebird5
	firebird5-utils.x86_64        5.0.3.1683-1.red80      firebird5
   dnf list "*fbclient*"
   Результат:   
	libfbclient2.x86_64            5.0.3.1683-1.red80      firebird5
	libfbclient2-devel.x86_64      5.0.3.1683-1.red80      firebird5
2.3. Удалить старые пакеты firebird и firebird-utils, если они установлены
	sudo dnf remove firebird
	sudo dnf remove firebird-utils
2.4. Установить пакет firebird5
	sudo dnf install firebird5
2.5. Установить пакет firebird5-utils - НЕ ТРЕБУЕТСЯ, т.к. он ставится автоматически!
	sudo dnf install firebird5-utils - НЕ ТРЕБУЕТСЯ
2.6. Установить пакет libfbclient2 - НЕ ТРЕБУЕТСЯ, т.к. он ставится автоматически!
2.7. Проверить, запущена ли служба firebird:	
	sudo systemctl stop firebird
	sudo systemctl start firebird
 	sudo systemctl status firebird
	Если служба не запускается, то вероятно потребуется исправить симлинк "/usr/lib64/libfbclient.so.2"
2.7.1 Проверить симлинк "libfbclient.so.2" - выполнить команду:
		ls -l /usr/lib64/libfbclient.so.2
	В результате должно быть: 
	lrwxrwxrwx. 1 root root 20 окт 29 11:15 /usr/lib64/libfbclient.so.2 -> libfbclient.so.5.0.3
2.7.2 Если вместо "libfbclient.so.5.0.X" указан другой файл, то следует вручную исправить симлинк:		
		sudo ln -sf /usr/lib64/libfbclient.so.5.0.3 /usr/lib64/libfbclient.so.2
2.8. Создать пользователя SYSDBA с безопасным паролем (английский символы, дефис, подчеркивание, цифры):
2.8.1 Остановить службу firebird:
	sudo systemctl stop firebird
2.8.2 Запустить команду "isql-fb" с повышенными правами:
	sudo /usr/bin/isql-fb -user SYSDBA
	
2.8.3 Выполнить команды (точка с запятой в конце команды - обязательна):
	CONNECT '/var/lib/firebird/secdb/security5.fdb';
	CREATE USER SYSDBA PASSWORD 'YourSecurePassword';
	COMMIT;
	EXIT;
	
	Примечание: стандартным паролем для пользователя SYSDBA является "masterkey" (использовать его допускается только в закрытой корпоративной сети);	
	
2.9. Скорректировать настройки в файле /etc/firebird/firebird.conf	
   См. ниже раздел 3 (Коррекция настроек в файле "/etc/firebird/firebird.conf")
2.10. Снова запустить firebird: 
    sudo systemctl start firebird

# 3. Коррекция настроек в файле "/etc/firebird/firebird.conf"
    3.1 Открыть файл с помощью стандартного текстового редактора nano:
	Примечание. См. команды редактора nano в файле "readme-nano-editor.txt"
	
	sudo nano /etc/firebird/firebird.conf

    3.2 Добавить в начало файла следующие параметры (можно использовать буфер обмена):
   
#------------------------------- начало блока --------------------------
# Firebird будет "слушать" TCP-порт 3050
RemoteServicePort = 3050

# В ОЗУ будет храниться 16384 страниц (примерно 250 МБ)
# Если на компьютере много ОЗУ, то можно увеличить это значение (либо наоборот уменьшить)
DefaultDbCachePages = 16384		

# Отключение "современных" типов данных, которые отсутствовали в Firebird 3.0
DataTypeCompatibility = 3.0

# Максимальное количество параллельных потоков (например, при восстановлении БД)
# Если процессор многоядерный, то можно увеличить данное значение
MaxParallelWorkers = 2

# Лимит памяти ОЗУ, используемой для выполнения запросов. 
# Если на компьютере много ОЗУ, то можно увеличить это значение, например указать =1G
TempCacheLimit = 200M
#------------------------------- конец блока --------------------------
		
	3.3 Нажать комбинацию "Ctrl+X", затем "Y" (Yes), затем Enter. 

# 4. Создание группы kmazs-admins

	Внимание! Если вы установили firebird / reddatabase на сервер, где не будет программы "КМАЗС-ОФИС", то группа "kmazs-admins" там не требуется. В этом случае не выполняйте данный пункт.

	Если вы ещё не запускали установку rpm-пакета программы КМАЗС-ОФИС, то группа kmazs-admins отсутствует. Эта группа необходима для доступа к файлу базы данных. Для создания группы "kmazs-admins" используйте команду:
	sudo groupadd kmazs-admins

# 5. Добавление пользователя firebird / reddatabase в группу kmazs-admins

	Внимание! Если вы установили firebird / reddatabase на сервер, где не будет программы "КМАЗС-ОФИС", то группа "kmazs-admins" там не требуется. В этом случае не выполняйте данный пункт.

    Внесение изменений в папке "/opt/kmazs" доступна только пользователям, состоящим в группе "kmazs-admins". Для того, чтобы СУБД Firebird / RedDatabase могла
	работать с файлом базы данных, необходимо соответствующего пользователя (firebird либо reddatabase) включить в группу "kmazs-admins".

	Если вы установили firebird, но ещё не запускали установку rpm-пакета программы КМАЗС-ОФИС, то добавьте пользователя "firebird" в группу "kmazs-admins" с помощью команды:
	
	sudo usermod -aG kmazs-admins firebird
	
	Если вы установили RedDatabase, то добавьте пользователя "reddatabase" в группу "kmazs-admins" с помощью команды:
	
	sudo usermod -aG kmazs-admins reddatabase	
	
# 6. Перезапуск службы firebird: 
	После изменения файла "firebird.conf", а также после добавления firebird / reddatabase в группу kmazs-admins необходимо перезапустить службу firebird:
	sudo systemctl stop firebird
	sudo systemctl start firebird
	При этом, если установлен RedDatabase, то будет перезапущен именно RedDatabase
	
# 7. Автоматический запуск службы firebird
    Для включения режима автоматического запуска службы firebird (при включении компьютера) необходимо использовать команду:
	sudo systemctl enable firebird
	В результате выполнения команды будет создана символическая ссылка на файл firebird.service и выдано сообщение "Created symlink".
	Данная команда не запускает службу firebird автоматически. Для запуска используйте параметр "start" (см. выше).
	
# 8. Программа КМАЗС-ОФИС может использовать символическую ссылку "/opt/kmazs/libfbclient.so" для загрузки клиентской библиотеки, с помощью которой производится подключение к базе данных. Данный симлинк может потребоваться в том случае, если в системе отсутствует стандартный симлинк "/usr/lib64/libfbclient.so", либо он указывает не некорректный файл клиентской библиотеки. Обычно с файлом "/usr/lib64/libfbclient.so" никаких проблем не возникает.
	
	Заранее убедитесь в наличии каталога "/opt/kmazs" (если его ещё нет, то создайте его с помощью "sudo mkdir /opt/kmazs/").
	Для создания символической ссылки используйте одну из команд (в зависимости от способа установки firebird / RedDatabase):
	
	Если установлен firebird из репозитория:
	sudo ln -sf /usr/lib64/libfbclient.so.2 /opt/kmazs/libfbclient.so	
	
	Если установлен RedDatabase:
	sudo ln -sf /opt/RedDatabase/lib/libfbclient.so.2 /opt/kmazs/libfbclient.so
	
	Если установлен firebird с использованием инсталлятора с официального сайта:
	sudo ln -sf /opt/firebird/lib/libfbclient.so.2 /opt/kmazs/libfbclient.so
	
# 9. В составе архива программы КМАЗС-ОФИС присутствуют файлы базы данных под следующие версии Firebird:
	KMAZSBASE_CLEAR_FB3.FDB - для Firebird 3.0
	KMAZSBASE_CLEAR_FB4.FDB - для Firebird 4.0
	KMAZSBASE_CLEAR_FB5.FDB - для Firebird 5.0
	KMAZSBASE_CLEAR_RED3.FDB - для RedDatabase 3.0
	KMAZSBASE_CLEAR_RED5.FDB - для RedDatabase 5.0
	После распаковки архива они появятся в каталоге /opt/kmazs/kmazs-clear-db
	Это связано с тем, что заранее неизвестно, какую версию Firebird пользователь сможет установить на Линукс.
	Файлы появятся в папке "/opt/kmazs/kmazs-clear-db" после распаковки архива с программой КМАЗС-ОФИС.
	В дальнейшем необходимо скопировать нужный файл в папку "/opt/kmazs/DataBase", а затем переименовать файл (убрать слово "CLEAR").
	Для копирования файла использовать команду:
	
	sudo cp /opt/kmazs/kmazs-clear-db/KMAZSBASE_CLEAR_FB5.FDB /opt/kmazs/DataBase/KMAZSBASE.FDB
	
# 10. Настройка группы "firebird" для файла базы данных

	Внимание! Если вы установили Firebird на сервере, на котором не планируется использование программы КМАЗС-ОФИС, то установите в качестве владельца для папки "/opt/kmazs/DataBase" и файла "KMAZSBASE.FDB" группу "firebird" и дайте ей права на запись:
	
	Команда для установки группы "firebird" в качестве владельца папки "DataBase" и её содержимого:
	sudo chown -R :firebird /opt/kmazs/DataBase
	
	Команда для выдачи флагов "rwx" группе-владельцу для папки DataBase и её содержимого:
	sudo chmod -R g+rwx /opt/kmazs/DataBase	
	
	Флаг "x" будет выставлен также для файла "KMAZSBASE.FDB" (это рекомендация от разработчиков).

# 11. Проверка TCP-порта 3050

	По умолчанию firewall в РЕД ОС выключен. При необходимости можно его включить.

	Убедитесь, что Firebird слушает порт 3050 на всех сетевых интерфейсах.
	Выполните команду:
		sudo ss -tlpn | grep :3050
	Должно быть 0.0.0.0:3050 (либо *:3050).

	Проверьте статус службы firewalld:
	systemctl status firewalld
	
	Если служба запущена, то убедитесь, что порт 3050 разрешён:
	sudo firewall-cmd --query-port=3050/tcp
	(Команда должна вернуть yes. Если вернула no — порт заблокирован).
	
	Также можно посмотреть весь список открытых портов и служб:
	sudo firewall-cmd --list-all
	Ищите значение 3050/tcp в строке ports.	





	

# Дополнительные команды:
  Определить, где находится файл настроек firebird.conf
	sudo find / -name "firebird.conf" 2>/dev/null
  Определить, запущен ли процесс firebird:
	ps aux | grep [f]irebird  
  Определить версию ODS (при использовании Firebird 5.0):
  /usr/bin/gstat-fb "/opt/kmazs/DataBase/KMAZSBASE_CLEAR_FB5.FDB" -h
  Определить версию ODS (при использовании RedDatabase 5.0):
  /opt/RedDatabase/bin/gstat "/opt/kmazs/DataBase/KMAZSBASE_CLEAR_RED5.FDB" -h
	

Список файлов пакета "firebird":
Команда:
dnf repoquery -l firebird

Результат:
/etc/firebird
/etc/firebird/databases.conf
/etc/firebird/fbtrace.conf
/etc/firebird/firebird.conf
/etc/firebird/plugins.conf
/etc/firebird/replication.conf
/etc/logrotate.d/firebird
/run/firebird
/run/firebird/fb_guard
/usr/bin/fbtracemgr
/usr/sbin/fb_lock_print
/usr/sbin/fbguard
/usr/sbin/firebird
/usr/share/doc/firebird/IDPLicense.txt
/usr/share/doc/firebird/IPLicense.txt
/usr/share/doc/firebird/README.RedOS
/usr/share/firebird
/var/log/firebird
/var/log/firebird/firebird.log
/etc/logrotate.d/firebird
/usr/lib/systemd/system/firebird.service
/usr/lib64/firebird
/usr/lib64/firebird/intl
/usr/lib64/firebird/intl/fbintl
/usr/lib64/firebird/intl/fbintl.conf
/usr/lib64/firebird/plugins
/usr/lib64/firebird/plugins/libChaCha.so
/usr/lib64/firebird/plugins/libEngine13.so
/usr/lib64/firebird/plugins/libLegacy_Auth.so
/usr/lib64/firebird/plugins/libLegacy_UserManager.so
/usr/lib64/firebird/plugins/libSrp.so
/usr/lib64/firebird/plugins/libfbtrace.so
/usr/lib64/firebird/plugins/libudr_engine.so
/usr/lib64/firebird/plugins/udr
/usr/lib64/firebird/plugins/udr/libudf_compat.so
/usr/lib64/firebird/plugins/udr/libudrcpp_example.so
/usr/lib64/firebird/plugins/udr/udf_compat.sql
/usr/lib64/firebird/plugins/udr_engine.conf
/usr/sbin/fb_lock_print
/usr/sbin/fbguard
/usr/sbin/firebird
/usr/lib/systemd/system/firebird.service
/var/lib/firebird
/var/lib/firebird/data
/var/lib/firebird/secdb
/var/lib/firebird/secdb/security4.fdb
/var/lib/firebird/system
/var/lib/firebird/system/firebird.msg
/var/lib/firebird/system/help.fdb
/var/lib/firebird/tzdata
/var/lib/firebird/tzdata/metaZones.res
/var/lib/firebird/tzdata/timezoneTypes.res
/var/lib/firebird/tzdata/windowsZones.res
/var/lib/firebird/tzdata/zoneinfo64.res
/etc/logrotate.d/firebird
/usr/bin/fbtracemgr
/usr/lib/systemd/system/firebird.service
/etc/logrotate.d/firebird
/usr/bin/fbtracemgr
/usr/lib/systemd/system/firebird.service
/etc/firebird
/etc/logrotate.d/firebird
/usr/bin/fbtracemgr
/usr/lib/systemd/system/firebird.service

Определение имени пакета с файлом "libfbclient.so":
dnf provides "*/libfbclient.so*"
Результат:
	Пакет libfbclient2:
	libfbclient2-4.0.6.3221-1.red80.x86_64 : Firebird SQL server client library
	Репозиторий        : @System
	Совпадения с:
	Имя файла   : /usr/lib64/libfbclient.so.2
	Имя файла   : /usr/lib64/libfbclient.so.4.0.6
/usr/lib64/libfbclient.so.2 - ссылка на клиентскую библиотеку, к которой обращается firebird
/usr/lib64/libfbclient.so.4.0.6 - непосредственно клиентская библиотека (версии 4.0.6)

Список файлов пакета firebird-utils
dnf repoquery -l firebird-utils
Результат:
/usr/bin/fbsvcmgr
/usr/bin/gbak  - утилита для резервирования/восстановления БД (БД резервируется полностью)
/usr/bin/gfix  - утилита для ремонта повреждённой базы данных
/usr/bin/gpre
/usr/bin/gsec
/usr/bin/gsplit
/usr/bin/gstat-fb  - утилита для запроса статистики
/usr/bin/isql-fb  - утилита для консольного выполнения SQL-запросов
/usr/bin/nbackup - утилита для продвинутого резервирования/восстановления БД (разностное)
/usr/bin/qli

dnf repoquery -l firebird5
Результат:
Тот же

dnf repoquery -l firebird5-utils
Результат:
Тот же