5. Состав файлов сервера

5.1. Файлы конфигурации, лог-файлы и базы данных

databases.conf

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

directories.conf

В данном файле задаются алиасы каталогов, в которых хранятся:

• файлы, заполненные BLOB-данными, к которым обращаются функции CREATE_FILE, READ_FILE и DELETE_FILE;

• файлы табличных пространств.

Структура файла:

database [= </путь/к/бд> | <псевдоним базы данных>]
{
  blobs
  {
    <алиас_каталога_для_BLOB> = <существующий/путь/к/каталогу>
    ...
  }

  tablespaces
  {
    <алиас_каталога_для_tablespace> = <существующий/путь/к/каталогу>
    ...
  }
}

Секции database состоят из двух подсекций: blobs и tablespaces. В секции blobs указываются псевдонимы директорий для храниения BLOB. В секции tablespaces указываются псевдонимы директорий для храниения табличных пространств.

Алиасы каталогов можно настроить для конкретной базы данных отдельно. Для этого нужно указать путь к нужной базе данных. При этом в качестве имени базы данных можно указать регулярное выражение на основе SIMILAR TO. Синтаксис SIMILAR TO см. в Руководстве по SQL.

Примечание

В старых версиях РЕД Базы Данных файл directories.conf имел другую структуру:

database
{
   <алиас_каталога_для_BLOB> = <существующий/путь/к/каталогу>
   ...
}

где в секций database перечислялись алиасы и пути к каталогам для хранения файлов с BLOB (но не файлов табличных пространств). Записи такого типа поддерживаются и сейчас. Таким образом, пути к каталогам с BLOB файлами можно задавать как в подсекции blobs, так и вне её.

Настройки перечитывается для каждого подключения к базе данных.

fbtrace.conf

Файл с шаблоном настроек fbtrace.conf находится в корневом каталоге и содержит список отслеживаемых событий и указывает размещение логов трассировки для каждого события. Это позволяет достаточно гибко настроить параметры аудита различных событий для любой базы данных, при этом логирование будет осуществляться в отдельные файлы.

Настройки перечитываются при старте сессии аудита. Сессии системного аудита запускаются сервером в соответствии с файлами конфигураций, перечисленными в параметре AuditTraceConfigFile в firebird.conf. Пользовательскую сессию аудита необходимо запускать явно. Перед записью каждого события файл fbtrace.conf проверяется на наличие изменений. Если они есть, то настройки будут перечитаны.

fbtrace_dba.conf

Файл конфигурирования для аудита действий пользователя SYSDBA. Имеет такую же структуру, что и fbtrace.conf, и на его основе создается дополнительная системная сессия аудита.

fbtrace_sec.conf

Файл конфигурирования для аудита событий безопасности. Имеет такую же структуру, что и fbtrace.conf, и на его основе создается дополнительная системная сессия аудита.

firebird.conf

Файл содержит параметры настройки сервера. Параметры, распространяющиеся на соединение (per-connection) перечитываются при каждом соединении. Все остальные параметры считываются при запуске сервера.

plugins.conf

Файл используется для настройки различных плагинов. Если в файле не указана конфигурация для плагина, то для него будут действовать настройки по умолчанию. Настройки считаются один раз при старте сервера.

replication.conf

Используется для настройки системы репликации. На мастере настройки перечитываются при каждом подключении к мастер-базе. На реплике настройки считываются один раз при старте сервера.

scheduler.conf

Файл с настройками планировщика заданий.

scheduler.fdb

База данных планировщика заданий. В ней хранятся сами задания и регистрируемые события, связанные с ними. Настройки считаются один раз при старте сервера.

java-security.fdb

База данных безопасности для пользователей Java. Здесь хранятся права доступа пользователей, использующих код Java.

Предупреждение

Механизм java-security устарел и будет удален в РЕД Базе Данных 6.

security5.fdb

База данных безопасности. В этой базе хранятся параметры пользователей системы и политики доступа.

jvm.args

Список аргументов для JVM.

firebird.msg

Файл с сообщениями сервера (в основном об ошибках).

firebird.log

Лог-файл сервера.

5.2. Инструменты администрирования и сервисы РЕД Базы Данных

rdblogmgr [.exe]

Утилита настройки журнала репликации. Данная утилита предназначена для вывода детализации текущего состояния журнала для заданной базы (общее состояние журнала, настройки репликации, список используемых сегментов). Дополнительно утилита rdblogmgr позволяет выполнить ручное архивирование заданного сегмента журнала или всех сегментов, а также принудительно помечает используемый сегмент как полный для возможности его архивирования.

rdbrepldiff [.exe]

Утилита сравнения мастер-базы и реплики.

rdbreplmgr [.exe]

Утилита для применения журналов к реплике в ручном режиме. Также выводит информацию о состоянии асинхронной репликации, создает копию мастер-базы, если определен параметр конфигурации db_copy_command.

gbak [.exe]

Утилита предназначена для создания резервных копий баз данных и восстановления из резервных копий. Позволяет создать переносимую резервную копию.

gfix [.exe]

Утилита администрирования базы данных. Утилита выполняет проверку базы данных и исправляет некоторые ошибки, позволяет запустить принудительную сборку мусора, управлять зависшими (limbo) транзакциями, создавать и удалять теневые копии, переводить базу данных в режим shutdown и т.д.

gpre [.exe]

Это препроцессор, который конвертирует исходный код, написанный на различных языках, в корректный отформатированный вызов функций Firebird API.

gsec [.exe]

Этот инструмент поддержки списка пользователей и их паролей является интерфейсом командной строки для базы данных security5.fdb; он управляет записями пользователей на сервере. Утилита GSEC устарела. Вместо неё лучше использовать SQl-команды для управления пользователями или Services API.

gstat [.exe]

Этот инструмент получения статистики собирает и отображает статистические сведения по индексам и данным базы данных.

hashgen [.exe]

Используется для проверки целостности компонентов СУБД РЕД База Данных на внешних накопителях и в оперативной памяти во время загрузки и динамически.

instclient.exe

Назначение утилиты instclient состоит в том, что она:

• позволяет установить клиентскую часть РЕД Базы Данных одной командой;

• позволяет установить клиентскую часть как fdbclient.dll, либо как gds32.dll;

• позволяет проверить наличие установленной библиотеки fdbclient или gds32;

• позволяет удалить уже установленный в системе fdbclient или gds32.

instreg.exe

Эта утилита прописывает необходимую информацию в реестр Windows, указывая стандартное расположение остальных файлов сервера.

instsvc.exe

Утилита записывает, удаляет или меняет информацию о запуске сервера в базе сервисов операционной системы Windows.

isql [.exe]

Интерактивный инструмент, который позволяет выполнять запросы к базе данных.

mint [.exe]

Утилита осуществляет контроль за целостностью метаданных в БД. Эта утилита предназначена для извлечения и хэширования метаданных из баз данных, а также для проверки ранее полученного хэша метаданных.

nbackup <.exe>

Утилита позволяет создавать резервные копии и восстанавливать из резервных копий также, как gbak, и дополнительно позволяет создавать инкрементные копии и восстанавливать из них БД.

rdbguard [.exe]

Исполняемый файл приложения Guardian. Он контролирует состояние сервера. Если сервер был остановлен по какой-либо причине, Guardian автоматически перезапускает его.

rdbserver [.exe]

Исполняемый файл в случае архитектуры Classic, SuperClassic или SuperServer.

rdb_lock_print [.exe]

Эта утилита формирует статистические данные файла блокировок, который поддерживается в РЕД Базе Данных для управления последовательностью изменений базы данных несколькими транзакциями. Она может быть полезным инструментом анализа проблем взаимной блокировки.

rdbsvcmgr [.exe]

Утилита предоставляет интерфейс командной строки для Services API, обеспечивая доступ к любой службе, которая реализуется в СУБД.

rdbtracemgr [.exe]

Утилита для работы в интерактивном режиме с трассировкой.

5.3. Плагины РЕД Базы Данных

aggtrace.dll

Плагин агрегатного аудита.

certificate.dll

Плагин аутентификации по сертификату.

chacha.dll

Плагин для шифрования данных, передаваемых по сети, алгоритмом ChaCha.

crypto_api.dll

Плагин криптографического менеджера.

default_profiler.dll

Плагин PSQL-профайлера.

engine13.dll

Ядро СУБД

extauth.dll

Плагин доверенной аутентификации ExtAuth.

fbtrace.dll

Плагин трейса.

gostpassword.dll

Плагин аутентификации с шифрованием по ГОСТ.

gostpassword_manager.dll

Плагин управления пользователями с паролем с шифрованием по ГОСТ.

gss.dll

Плагин аутентификации по протоколу GSSAPI.

ldap.dll

Плагин для взаимодействия с сервером LDAP.

legacy_auth.dll

Плагин аутентификации по традиционному протоколу (Legacy).

legacy_usermanager.dll

Плагин управления пользователями с традиционным паролем.

license.dll

Плагин лицензии для промышленной редакции.

license_open.dll

Плагин лицензии для открытой редакции.

license_std.dll

Плагин лицензии для стандартной редакции.

policy.dll

Плагин, реализующий политики доступа пользователей.

rdbcrypt.dll

Плагин шифрования по ГОСТ-алгоритму.

srp.dll

Плагин аутентификации по протоколу SRP.

udr_engine.dll

Плагин вызова пользовательских процедур (UDR).

verifyserver.dll

Плагин проверки подлинности сервера со стороны клиента при многофакторной аутентификации.

wire_wincrypt.dll

Плагин шифрования трафика по ГОСТ-алгоритму.

zlibcompressor.dll

Плагин сжатия по алгоритму deflate.

zstd.dll

Плагин сжатия по алгоритму Zstandard.