Инструкция по миграции на Firebird 5

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

Подготовительные действия

1. Сделать резервную копию базы данных на текущем сервере Firebird.
2. Сделать резервную копию файла firebird.conf из папки текущей версии Firebird.

Установка Firebird

1. Отключить все активные службы Firebird
2. Удалить старые версии Firebird с компьютера
3. Скачать выполняемый (exe) файл с оффициального сайта Firebird: https://www.firebirdsql.org/en/firebird-5-0
4. Выполнить установку. Особых условий к установке нет, но рекомендуется выбрать:

• тип сервера: Classic

• не запускать сервер по окончанию установки:

5. Перезагрузить компьютер
6. Открыть папку, в которую была установлена новая версия Firebird. По умолчанию: C:\Program Files\Firebird\Firebird_5_0
7. Создать новую папку "UDF". По умолчанию путь до нее будет: C:\Program Files\Firebird\Firebird_5_0\UDF
8. Cкопировать библиотеку gudf.dll в папку "UDF". (Библиотеку gudf.dll можно скачать с официального сайта Гедымин)

Настройка Firebird

1. Открыть файл firebird.conf.

2. Добавить в firebird.conf следующие настройки:

  AuthServer = Srp256, Srp, Legacy_Auth
  UserManager = Legacy_UserManager, Srp 
  WireCrypt = Enabled
  UdfAccess = Restrict UDF
  DataTypeCompatibility = 2.5
  ServerMode = Classic
  MaxParallelWorkers = 4
  ParallelWorkers = 1
  OuterJoinConversion = false

Дополнительные настройки (необязательные, для опытных пользователей):

DefaultTimeZone = Europe/Moscow #Устанавливает временную зону для работы с временем (по умолчанию устанавливает настройки системы)
RemoteServicePort = 3055 #Задает порт, на котором будет работать Firebird (по умолчанию 3050)

3. Сохранить файл firebird.conf.
   Если у Вас возникла проблема с доступом (ошибка чтения/записи), то есть 3 способа решения этой проблемы:

   • открыть файл от имени Администратора
   • предоставить на этот файл права на полный доступ для текущего пользователя
   • переместить файл в другую папку (или на рабочий стол), произвести необходимые действия, сохранить, скопировать с заменой в исходную папку

4. Запустить сервер Firebird:

   • Диспетчер задач ➝ Службы ➝ Найти службу FirebirdServerDefaultInstance ➝ Правый клик мыши по этой службе ➝ Запустить
   • Выполнить команду instsvc start в командной строке

Восстановление базы данных

1. Открыть программу Гедымин
2. Выполнить стандартное восстановление базы данных из резервной копии
3. Протестировать работу

Потенциальные проблемы и их решение

1. В процессе восстановления базы данных возможно будут сообщения данного содержания:

gbak: WARNING: function <function_name> is not defined.

Например:

Если Вы заметили такие сообщения при восстановлении своей базы данных, то необходимо:
1.1) Скачать специальную утилиту с сайта Гедымин для удаления зависимостей от встроенных функций Firebird
1.2) Открыть утилиту
1.3) Заполнить необходимые данные
1.4) Нажать кнопку "Пуск"

Пример работы утилиты:

2. Поле "Количество потоков" при восстановлении базы данных заблокировано. Необходимо:
   2.1) Cкачать Firebird в ZIP формате для windows 32 бит (это архитектура x86)
   2.2) Скопировать с заменой все DLL файлы в папку программы.
   Чтобы избежать конфликта версий, рекомендуется удалить старые версии этих файлов из программы.
   Например: при копировании файла icudt63.dll удалить файл icudt30.dll из папки программы.

Установка второго сервера Firebird на один компьютер

Предупреждение: Это очень плохая идея. Скорее всего, периодически будут возникать странные проблемы, решения у которых не будет. Все такие действия Вы выполняете на свой страх и риск.

1. Выполнить все действия из блока "Установка Firebird", кроме удаления старых версий Firebird
2. Скачать Firebird в ZIP формате
3. Чтобы избежать запретов на копирование и изменение файлов, произвольного удаления файлов, ожидание проверок и так далее, рекомендуется отключать антивирус!
4. Скопировать с заменой все файлы из архива в папку, в которую был установлен Firebird
5. Открыть консоль. Перейти в папку Firebird командой:

cd <путь до файла> 

Пример:

cd C:\Program Files\Firebird\Firebird_5_0

6. Создать пользователя SYSDBA

isql security.db -user SYSDBA

CREATE USER SYSDBA PASSWORD 'masterkey';

exit;

Пример результата работы:

7. Произвести манипуляции с файлов firebird.conf, указанные в блоке "Настройка Firebird"
8. Выполнить команды по запуску сервера:

#Установить сервер
instsvc install -n fb50

#Запустить сервер
instsvc start -n fb50

Дополнительные команды, которые могут пригодится:

#Остановить сервер
instsvc stop -n fb50

#Удалить сервер
instsvc remove -n fb50

#Просмотреть список всех запущенных серверов
instsvc query

Пример запуска сервера:

9. Включить антивирус

05.05.2025