Firebird как изменить пароль sysdba

Как изменить пароль SYSDBA

Важно

В некоторых инсталляциях Firebird запуск утилиты
gsec возможен только при входе в систему от имени
привилегированного пользователя (например, root в системе Linux) или
пользователя, от имени которого происходит запуск серверного
процесса Firebird. На серверных системах Windows для использования
утилиты gsec, обычно, Вы должны быть
членом группы Power User
или другой правомочной группы.

Если Вы уверены, что у Вас достаточно привилегий, но
использование gsec заканчивается
сообщениями типа «unavailable database —
unable to open database» — возможно, сервер
не запущен. Вернитесь к разделу Тестируем то, что
установили и попробуйте устранить причину.

Если Вы уверены, что у Вас достаточно привилегий, но
использование gsec заканчивается
сообщениями типа «unavailable database —
unable to open database»:

1. Перейдите к интерпретатору командной строки и смените
   текущую директорию на ту, в которой находятся утилиты командной
   строки. Если Вы не знаете, где они находятся, обратитесь за
   подсказкой к таблице Компоненты Firebird 1.5 и их расположение.

2. Наберите следующее, если Вы не
   используете Windows Classic Server:

   gsec -user sysdba -password
   masterkey

   В случае использования Windows Classic Server, Вы
   должны указывать полное сетевое расположение
   базы данных безопасности (к сожалению!):

   gsec -user sysdba -password masterkey -database
   «localhost:C:Program
   FilesFirebirdFirebird_1_5security.fdb» (при
   необходимости измените путь)

   Замечание

   • В Linux, лучше писать ./gsec, чем
     просто gsec. Иначе есть шанс, что
     запуститься «не та»
     gsec, или она просто не
     найдется.

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

   В любом случае, после нажатия клавиши
   Enter, Вы должны наблюдать
   приглашение утилиты gsec:

3. Наберите команду:

   modify sysdba -pw icuryy4me

4. Нажмите Enter. Новое значение пароля —
   icuryy4me, зашифровывается и сохраняется,
   предыдущее значение — masterkey, теперь
   недействительно.

5. Для выхода из gsec, используйте
   команду:

Замечание

Firebird игнорирует в значении пароля любые символы после
восьмого, поэтому icuryy4m подходит так же, как,
например, и icuryy4monkeys.

1.1. Инициализация SYSDBA

Начиная с Firebird 3.0 пользователь SYSDBA не инициализирован по умолчанию (для плагина управления пользователями SRP), поэтому необходимо явно создать пользователя и указать ему пароль.
Это можно сделать двумя способами:
с использованием консольного инструмента для выполнения интерактивных запросов isql.exe и консольного инструмента для управления базой данных безопасности gsec.exe.

CREATE USER SYSDBA PASSWORD '<password>';

c:Firebird4.0>isql

Use CONNECT or CREATE DATABASE to specify a database

SQL> connect security.db user SYSDBA; Database: security.db, User: SYSDBA
SQL> CREATE USER SYSDBA PASSWORD 'm8ku234pp';
SQL> exit;

c:Firebird4.0>

add SYSDBA -pw <password>

c:Firebird4.0>gsec -user SYSDBA -database security.db

* gsec is deprecated, will be removed soon *

GSEC> add SYSDBA -pw m8ku234pp
GSEC> quit

c:Firebird4.0>

1.2. Конфигурация

Перед тем как установить и запустить Firebird как службу необходимо выбрать режим работы сервера.

AuthServer = Srp256, Srp, Legacy_Auth
UserManager = Srp, Legacy_UserManager
WireCrypt = Enabled

c:Firebird4.0>isql
Use CONNECT or CREATE DATABASE to specify a database
SQL> connect security.db user sysdba;
Database: security.db, User: SYSDBA
SQL> ALTER USER SYSDBA SET PASSWORD 'er34gfde' USING PLUGIN Legacy_UserManager;
SQL> exit;

c:Firebird4.0>

DefaultTimeZone = Europe/Moscow

1.3. Установка и запуск Firebird как службы

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

Если запустить её без параметров, то будет выведена справка по командам и параметрам.

instsvc
Usage:
  instsvc i[nstall]
                    [ -a[uto]* | -d[emand] ]
                    [ -g[uardian] ]
                    [ -l[ogin] username [password] ]
                    [ -n[ame] instance ]
                    [ -i[nteractive] ]

          sta[rt]   [ -b[oostpriority] ]
                    [ -n[ame] instance ]
          sto[p]    [ -n[ame] instance ]
          q[uery]
          r[emove]  [ -n[ame] instance ]


  '*' denotes the default values
  '-z' can be used with any other option, prints version
  'username' refers by default to a local account on this machine.
  Use the format 'domainusername' or 'serverusername' if appropriate.

Для установки сервиса необходимо ввести команду

В этом случае Firebird будет установлен в качестве службы с именем «Firebird Server – DefaultInstance».
Эта служба будет запускаться автоматически при старте ОС, под учётной записью LocalSystem, предназначенной для служб.

Если необходимо чтобы было установлено несколько экземпляров Firebird работающих как службы, то необходимо задать им разные имена с помощью опции -n

Для запуска службы воспользуйтесь командой

Если служба была установлена с именем отличным от умолчательного, то необходимо воспользоваться переключателем -n

Для остановки службы воспользуйтесь командой

Если служба была установлена с именем отличным от умолчательного, то необходимо воспользоваться переключателем -n

Для удаления сервиса необходимо ввести команду

Если служба была установлена с именем отличным от умолчательного, то необходимо воспользоваться переключателем -n

Для просмотра всех служб Firebird установленных в системе воспользуйтесь командой

Firebird Server - fb30 IS installed.
  Status  : running
  Path    : C:Firebird3.0firebird.exe -s fb30
  Startup : automatic
  Run as  : LocalSystem

Firebird Server - fb40 IS installed.
  Status  : running
  Path    : C:Firebird4.0firebird.exe -s fb40
  Startup : automatic
  Run as  : LocalSystem

uninstall_service.bat fb40

1.4. Установка клиента

Если речь идёт об установке только клиентской части, то обязательно требуется файл fbclient.dll.
Клиент Firebird 4.0 обязательно требует наличия установленного Microsoft Runtime C++ 2017 соответствующей разрядности.
Если данная библиотека не установлена, то можно скопировать дополнительные библиотеки, которые поставляются в ZIP архиве под Windows msvcp140.dll и vcruntime140.dll.

Желательно, чтобы рядом с fbclient.dll был расположен файл сообщений firebird.msg.
Большинство сообщений об ошибках уже содержатся в fbclient.dll, однако если вы собираетесь пользоваться консольными утилитами файл firebird.msg обязательно должен присутствовать.

В отличие от Firebird 2.5 и Firebird 3.0 клиентской библиотеки так же требуются файлы ICU (icudt63.dll, icuin63.dll, icuuc63.dll и icudt63l.dat).
Ранее ICU библиотека требовалась только серверу.
Теперь она может потребоваться клиентской части, если вы собираетесь работать с типами данных TIMESTAMP WITH TIME ZONE и TIME WITH TIME ZONE.
ICU библиотека также требуется при вызове функций UtilInterface::decodeTimeTz() и UtilInterface::decodeTimestampTz().

Если необходимо сжатие трафика при работе по TCP/IP, то потребуется библиотека zlib1.dll.

Вам может потребоваться библиотека plugins/chacha.dll, если вы собираетесь использовать плагин шифрования трафика ChaCha.

Для того чтобы клиентское приложение могло загрузить библиотеку fbclient.dll она должна располагаться либо рядом с приложением,
либо в одной из директорий в которой производится поиск, например добавленной в PATH или системной директории для размещения общедоступных библиотек (system32 или SysWOW64).

Для развёртывания клиентской библиотеки Firebird в системном каталоге Windows воспользуйтесь командой

instclient install fbclient

1.5. Установка embedded версии

Embedded версия теперь требует большего количества файлов.
Минимальная структура файлов и каталогов для Firebird 4.0 embedded следующая:

При необходимости вы также можете скопировать исполняемые файлы утилит fbsvcmgr.exe, fbtracemgr.exe,
gbak.exe, gfix.exe, gstat.exe, isql.exe, nbackup.exe.

2.1. Список несовместимостей на уровне языка SQL

Проблемы совместимости языка SQL возможны как для объектов самой базы данных (PSQL процедуры и функции), так и в DSQL запросах, используемых в вашем приложении.

Перечислим некоторые наиболее часто встречающиеся проблемы совместимости на уровне SQL которые вы можете исправить ещё до перехода на новую ODS.
Полный список несовместимостей вы можете прочитать в Release Notes 3.0 (для тех кто переходит с Firebird 2.5) и Release Notes 4.0 в главе «Compatibility Issues».

create procedure sp_test
returns (n int)
as
  declare c cursor for (select 1 /* as a */ from rdb$database);
begin
  open c;
  fetch c into n;
  close c;
  suspend;
end

Statement failed, SQLSTATE = 42000
unsuccessful metadata update
-ALTER PROCEDURE SP_TEST failed
-Dynamic SQL Error
-SQL error code = -104
-Invalid command
-no column name specified for column number 1 in derived table C

..
DECLARE VARIABLE moment TIMESTAMP;
..
SELECT TIMESTAMP 'NOW' FROM RDB$DATABASE INTO :moment;

/* здесь переменная: moment будет "заморожена" как отметка времени
в момент последней компиляции процедуры или функции  */
..

2.2. Поддержка внешних функций (UDF) объявлена устаревшей

Поддержка внешних функций (UDF) в Firebird 4 объявлена устаревшей.
Эффект от этого заключается в том, что UDF нельзя использовать с конфигурацией по умолчанию, поскольку для параметра UdfAccess в firebird.conf
значение по умолчанию теперь None.
Библиотеки UDF ib_udf и fbudf изъяты из дистрибутива.

Большинство функций в этих библиотеках уже устарели в предыдущих версиях Firebird и были заменены встроенными аналогами.
Теперь доступны безопасные замены для некоторых из оставшихся функций либо в новой библиотеке определяемых пользователем подпрограмм (UDR) с именем [lib]udf_compat.[dll/so/dylib]
(это делается после смены ODS), либо в виде преобразований по сценарию в сохраненные функции PSQL.

Рекомендуем заранее (до перехода на новую ODS) заменить UDF функции на их встроенные аналоги.
Если вы делаете миграцию с Firebird 3.0, вы также можете переписать часть функций на PSQL.

Если после этих шагов у вас остались UDF функции, то необходимо изменить параметр конфигурации

2.3. Преобразование базы данных к новой ODS

После предварительной подготовки, вы можете попробовать преобразовать базу данных к новой ODS с помощью инструмента gbak.

В данном примере предполагается, что на одной машине стоят Firebird 3.0 и Firebird 4.0. Firebird 3.0 работает используя TCP порт 3053, а Firebird 4.0 — 3054.

Прежде всего необходимо создать резервную копию вашей базы данных на текущей версии Firebird с помощью следующей команды.

gbak -b -g -V -user <username> -pas <password> -se <service> <database> <backup_file> -Y <log_file>

gbak -b -g -V -user SYSDBA -pas 8kej712 -se server/3053:service_mgr my_db d:fb30_backupmy_db.fbk -Y d:fb30_backupbackup.log

Далее необходимо восстановить вашу копию на Firebird 4.0 с помощью команды

gbak -c -v -user <username> -pas <password> -se <service> <backup_file> <database_file> -Y <log_file>

gbak -c -v -user SYSDBA -pas 8kej712 -se server/3054:service_mgr d:fb30_backupmy_db.fbk d:fb40_datamy_db.fdb -Y d:fb40_datarestore.log

После восстановления внимательно изучите restore.log на предмет ошибок.

gbak: WARNING:function UDF_FRAC is not defined
gbak: WARNING: module name or entrypoint could not be found

isql -user sysdba -pas masterkey -i udf_replace.sql {your-database}

1. Сделайте резервную копию базы данных безопасности на Firebird 3.0

   c:Firebird3.0>gbak -b -g -user SYSDBA security.db d:fb30_backupsecurity.fbk

2. Восстановите резервную копию на Firebird 4.0 под новым именем

   c:Firebird4.0>gbak -с -user SYSDBA -pas 8kej712 -se localhost/3054:service_mgr d:fb30_backupsecurity.fbk d:fb40_datasecurity_30.fdb

3. Сохраните следующий скрипт для переноса пользователей в файл copy_user.sql

   set term ^;
   
   EXECUTE BLOCK
   AS
     -- замените на параметры вашей копии БД безопасности
     DECLARE SRC_SEC_DB     VARCHAR(255) = 'd:fb40_datasecurity_30.fdb';
     DECLARE SRC_SEC_USER   VARCHAR(63) = 'SYSDBA';
     ---------------------------------------------------
     DECLARE PLG$USER_NAME  SEC$USER_NAME;
     DECLARE PLG$VERIFIER   VARCHAR(128) CHARACTER SET OCTETS;
     DECLARE PLG$SALT       VARCHAR(32) CHARACTER SET OCTETS;
     DECLARE PLG$COMMENT    BLOB SUB_TYPE TEXT CHARACTER SET UTF8;
     DECLARE PLG$FIRST      SEC$NAME_PART;
     DECLARE PLG$MIDDLE     SEC$NAME_PART;
     DECLARE PLG$LAST       SEC$NAME_PART;
     DECLARE PLG$ATTRIBUTES BLOB SUB_TYPE TEXT CHARACTER SET UTF8;
     DECLARE PLG$ACTIVE     BOOLEAN;
     DECLARE PLG$GROUP_NAME SEC$USER_NAME;
     DECLARE PLG$UID        PLG$ID;
     DECLARE PLG$GID        PLG$ID;
     DECLARE PLG$PASSWD     PLG$PASSWD;
   BEGIN
     -- перемещаем пользователей из плагина SRP
     FOR EXECUTE STATEMENT Q'!
         SELECT
             PLG$USER_NAME,
             PLG$VERIFIER,
             PLG$SALT,
             PLG$COMMENT,
             PLG$FIRST,
             PLG$MIDDLE,
             PLG$LAST,
             PLG$ATTRIBUTES,
             PLG$ACTIVE
         FROM PLG$SRP
         WHERE PLG$USER_NAME <> 'SYSDBA'
   !'
             ON EXTERNAL :SRC_SEC_DB
             AS USER :SRC_SEC_USER
             INTO :PLG$USER_NAME,
                  :PLG$VERIFIER,
                  :PLG$SALT,
                  :PLG$COMMENT,
                  :PLG$FIRST,
                  :PLG$MIDDLE,
                  :PLG$LAST,
                  :PLG$ATTRIBUTES,
                  :PLG$ACTIVE
     DO
     BEGIN
       INSERT INTO PLG$SRP (
           PLG$USER_NAME,
           PLG$VERIFIER,
           PLG$SALT,
           PLG$COMMENT,
           PLG$FIRST,
           PLG$MIDDLE,
           PLG$LAST,
           PLG$ATTRIBUTES,
           PLG$ACTIVE)
       VALUES (
           :PLG$USER_NAME,
           :PLG$VERIFIER,
           :PLG$SALT,
           :PLG$COMMENT,
           :PLG$FIRST,
           :PLG$MIDDLE,
           :PLG$LAST,
           :PLG$ATTRIBUTES,
           :PLG$ACTIVE);
     END
     -- перемещаем пользователей из плагина Legacy_UserManager
     FOR EXECUTE STATEMENT Q'!
         SELECT
             PLG$USER_NAME,
             PLG$GROUP_NAME,
             PLG$UID,
             PLG$GID,
             PLG$PASSWD,
             PLG$COMMENT,
             PLG$FIRST_NAME,
             PLG$MIDDLE_NAME,
             PLG$LAST_NAME
         FROM PLG$USERS
         WHERE PLG$USER_NAME <> 'SYSDBA'
   !'
             ON EXTERNAL :SRC_SEC_DB
             AS USER :SRC_SEC_USER
             INTO :PLG$USER_NAME,
                  :PLG$GROUP_NAME,
                  :PLG$UID,
                  :PLG$GID,
                  :PLG$PASSWD,
                  :PLG$COMMENT,
                  :PLG$FIRST,
                  :PLG$MIDDLE,
                  :PLG$LAST
     DO
     BEGIN
       INSERT INTO PLG$USERS (
           PLG$USER_NAME,
           PLG$GROUP_NAME,
           PLG$UID,
           PLG$GID,
           PLG$PASSWD,
           PLG$COMMENT,
           PLG$FIRST_NAME,
           PLG$MIDDLE_NAME,
           PLG$LAST_NAME)
       VALUES (
           :PLG$USER_NAME,
           :PLG$GROUP_NAME,
           :PLG$UID,
           :PLG$GID,
           :PLG$PASSWD,
           :PLG$COMMENT,
           :PLG$FIRST,
           :PLG$MIDDLE,
           :PLG$LAST);
     END
   END^
   
   set term ;^
   
   commit;
   
   exit;

   Важно Не забудьте заменить значение переменной SRC_SEC_DB на путь к копии вашей БД безопасности.

   Замечание Мы исключили копию пользователя SYSDBA, поскольку инициализировали его при установке.

4. Выполните скрипт на Firebird 4.0 подключившись к БД безопасности в embedded режиме

   c:Firebird4.0>isql -i "d:fb40_datacopy_users.sql" -u SYSDBA -ch UTF8 security.db

4.2.1. Копирование списка пользователей в плагин SRP

Из-за новой модели аутентификации в Firebird 3 обновление базы данных безопасности версии 2.5 (security2.fdb) напрямую для использования в Firebird 4 невозможно.
Однако существует процедура обновления, позволяющая сохранить данные учетной записи пользователя — имя пользователя, имя и т. Д., Но не пароли — из базы данных security2.fdb, которая использовалась на серверах версии 2.x.

Процедура требует запуска сценария security_database.sql, который находится в каталоге misc/upgrade вашей установки Firebird 3. Эти инструкции предполагают, что у вас есть временная копия этого сценария в том же каталоге, что и исполняемый файл isql.

4.2.2. Копирование списка пользователей в плагин Legacy_UserManager

В отличие от предыдущего варианта, данный скрипт сохранит ваши исходные пароли.
Однако, мы советуем вам в будущем всё равно перейти на плагин Srp.

Поздравляем! Ваши пользователи перенесены с сохранением всех атрибутов и паролей.

1. Первым делом необходимо подключить плагин доверительной аутентификации в файле конфигурации firebird.conf или databases.conf
   в параметре AuthServer (по умолчанию он отключен).
   Для этого необходимо добавить плагин с именем Win_Sspi, и будем использовать его совместно с Srp256.

   AuthServer = Srp256, Win_Sspi

2. Следующим шагом необходимо включить отображение пользователей из Win_Sspi на CURRENT_USER.
   Для этого необходимо создать отображение в целевой базе данных с помощью следующего запроса

   CREATE MAPPING TRUSTED_AUTH
   USING PLUGIN WIN_SSPI
   FROM ANY USER
   TO USER;

   Данный SQL запрос создаёт отображение только на уровне текущей базе данных.
   Отображение не будет применяться к другим базам данных расположенных на том же сервере.
   Если вы хотите создать общее отображение для всех баз данных, то добавьте ключевое слово GLOBAL.

   CREATE GLOBAL MAPPING TRUSTED_AUTH
   USING PLUGIN WIN_SSPI
   FROM ANY USER
   TO USER;

3. Включение SYSDBA-подобного доступа для администраторов Windows (если он нужен).

   Для включения такого доступа необходимо создать следующее отображение

   CREATE MAPPING WIN_ADMINS
   USING PLUGIN WIN_SSPI
   FROM Predefined_Group
   DOMAIN_ANY_RID_ADMINS
   TO ROLE RDB$ADMIN;

   Вместо включения SYSDBA-подобного доступа для всех администраторов Windows, вы можете дать административные привилегии конкретному пользователю с помощью следующего отображения

   create global mapping cto_sysdba
   using plugin win_sspi
   from user "STATION9DEVELOPER"
   to user SYSDBA;

6.1. Новые типы данных

Как уже говорилось ранее, некоторые выражения могут возвращать новые типы данных, которые не могут быть интерпретированы вашим приложением без его доработки.
Такая доработка может занять существенное время или оказаться вам не по силам.
Для упрощения миграции на новые версии вы можете установить параметр DataTypeCompatibility в режим совместимости с необходимой версией в firebird.conf или databases.conf.

DataTypeCompatibility = 3.0

Это самый быстрый путь добиться совместимости с новыми типами данных.
Однако со временем вы можете начать внедрять поддержку новых типов в своё приложение.
Естественно, это будет происходить постепенно — сначала один тип, потом другой и так далее.
В этом случае вам надо настроить отображение тех типов, поддержку которых вы ещё не доделали, на другие типы данных.
Для этого используется оператор SET BIND OF.

SET BIND OF { <type-from> | TIME ZONE } TO { <type-to> | LEGACY | NATIVE | EXTENDED }

Подробное описание этого оператора есть в «Firebird 4.0 Release Notes» и «Руководство по языку SQL СУБД Firebird 4.0».
С помощью него вы можете управлять отображением новых типов в вашем приложении выполнив соответствующий запрос сразу после подключения, и даже написать AFTER CONNECT триггер в котором использовать несколько таких операторов.

Например, предположим, что вы добавили в ваше приложение поддержку даты и времени с часовыми поясами, но у вас до сих пор не поддерживаются типы INT128 и DECFLOAT.
В этом случае вы можете написать следующий триггер.

create or alter trigger tr_ac_set_bind
on connect
as
begin
  set bind of int128 to legacy;
  set bind of decfloat to legacy;
end

6.2. Согласованное чтение в транзакциях READ COMMITTED

Firebird 4 не только вводит согласованность чтения (READ CONSISTENCY) для запросов в транзакциях READ COMMITTED, но также делает его режимом по умолчанию для всех транзакций READ COMMITTED, независимо от их свойств RECORD VERSION или NO RECORD VERSION.
Это сделано для того, чтобы обеспечить пользователям лучшее поведение — как соответствующее спецификации SQL, так и менее подверженное конфликтам.
Однако это новое поведение может также иметь неожиданные побочные эффекты.
Пожалуй самый важный из них это так называемые рестарты при обработке конфликтов обновления.
Это может привести к тому, что некоторый код, не подверженный транзакционному контролю, может выполняться многократно в рамках PSQL.
Примерами такого кода может быть:

Подробнее о согласованном чтении в транзакциях READ COMMITTED вы можете прочитать «Firebird 4.0 Release Notes».

Другим важным эффектом является то, что недофетченные курсоры в транзакциях READ COMMITTED READ CONSISTENCY в Read Only режиме теперь удерживают сборку мусора.
Рекомендуем вам отказаться от использования в приложении единой длинной READ COMMITTED READ ONLY транзакции, и заменить её на несколько таких транзакций, каждая из которых активна ровно столько времени сколько это необходимо.

Если особенности режима READ CONSISTENCY по каким-либо причинам нежелательны, то параметр конфигурации ReadConsistency можно изменить, чтобы разрешить устаревшее поведение.

6.3. INSERT … RETURNING требует привилегию SELECT

Если какой-либо оператор INSERT содержит предложение RETURNING, которое ссылается на столбцы базовой таблицы, то вызывающей стороне должна быть предоставлена соответствующая привилегия SELECT.