понеділок, 28 липня 2008 р.

Перенесення баз Firebird 2 в Ubuntu AMD64: ODS і backup/restore

Працюючи у 2008 році з Firebird 2 в Ubuntu 8 AMD64, я зіткнувся з проблемою відкриття баз старішого формату. У Windows такі файли в моєму середовищі відкривалися, а під час перенесення на Linux знадобилося створити резервну копію й відновити базу.

Що визначає ODS

ODS — On-Disk Structure, формат структури бази на диску. Для Firebird 2.0 нові бази мають ODS 11, а для 2.1 — 11.1. У нотатках Firebird 2.1 також зазначено можливість читання нижчих ODS, хоча частина нових функцій потребує нового формату.

Тому підтримку не можна визначати лише словом Windows або Linux. Важливі конкретний сервер, його збірка та архітектура. Окремо слід відрізняти Firebird 2.0 від Firebird Vulcan: документація сумісності прямо описує різницю між ними щодо старіших ODS.

Шлях перенесення через резервну копію

Практична порада з мого випадку — backup/restore. Послідовність така:

  1. Зберегти вихідну базу без змін і створити резервну копію засобами сумісного вихідного сервера.
  2. Відновити копію на цільовому сервері в окрему базу.
  3. Перевірити відновлені дані та роботу застосунку перед переходом.

Посібник gbak описує створення копії утилітою старої версії та відновлення утилітою нової; під час відновлення база отримує ODS цільової версії. Це не означає автоматичної зміни SQL-діалекту.

rfunc для Firebird 2 в Ubuntu 8: історична збірка UDF-бібліотеки

У 2008 році я компілював rfunc для Firebird 2 в Ubuntu 8. Інструкція спиралася на встановлення Firebird у /opt/firebird за попередньою нотаткою, а не на стандартні шляхи конкретного пакета репозиторію.

Зміни rfunc.conf

GDS_NAME    = fbclient
#GDS_NAME    = gds32

Зміни makefile.linux

#RFUNCIBUTILLIB    = /usr/lib/libib_util.so
RFUNCIBUTILLIB    = /opt/firebird/lib/libib_util.so

#INCLUDE        = -I/usr/include -I"$(IBASE)$(SDKDIR)/include"
INCLUDE        = -I/usr/include -I/opt/firebird/include

Залежність і компіляція

apt-get install uuid-dev
make -f makefile.linux rfunc

Розміщення готової бібліотеки

За первинним описом, у каталозі збірки з’являвся файл rfunc. Я пропонував перейменувати його на rfunc.so, скопіювати до /opt/firebird/UDF та перезапустити сервер. Це опис конкретної процедури, а не достатня перевірка сумісності: архітектура бібліотеки, клієнта й сервера та правила завантаження мають відповідати середовищу.

UDF у новіших версіях Firebird

Від Firebird 4 старі UDF оголошено застарілими, а типовий UdfAccess дорівнює None. Тому цю процедуру не слід механічно переносити на новий сервер або змінювати його захист лише заради повторення старого прикладу. Офіційна довідка Firebird про UdfAccess і заміни UDF.

Firebird 2 на Ubuntu 8: як я вирішував проблему UDF

У липні 2008 року в моїй інсталяції Ubuntu 8 виникла проблема з Firebird із пакетів системи: потрібні UDF-бібліотеки не підключалися. Причину тоді не встановив, а обхідний спосіб знайшов у матеріалі HowtoForge про встановлення Firebird 2.0.3 на Ubuntu 7.10. Первісна адреса джерела:

http://www.howtoforge.com/installing-firebird-2.0.3-database-server-on-ubuntu-7.10

Послідовність для Firebird 2.0.3

У процедурі спочатку встановлювали libstdc++5, потім завантажували й розпаковували сервер та запускали інсталятор. Рядки для 32- і 64-бітної ОС — альтернативні варіанти, а не дві послідовні установки. Назву каталогу для команди cd потрібно звіряти з фактично розпакованим архівом.

apt-get install libstdc++5

# Варіант для 32-бітної ОС
sudo wget http://downloads.sourceforge.net/firebird/FirebirdSS-2.0.3.12981-1.nptl.i686.tar.gz
sudo tar -xvf FirebirdSS-2.0.3.12981-1.nptl.i686.tar.gz
cd FirebirdSS-2.0.3.12981-1.i686

# Альтернативний варіант для 64-бітної ОС
sudo wget http://downloads.sourceforge.net/firebird/FirebirdSS-2.0.3.12981-1.amd64.tar.gz
sudo tar -xvf FirebirdSS-2.0.3.12981-1.amd64.tar.gz
cd FirebirdSS-2.0.3.12981-1.amd64

# Подальші команди старої процедури
sudo ./install.sh
sudo chown root:root /opt/firebird/UDF/*
sudo chmod 444 /opt/firebird/UDF/*
sudo /etc/init.d/firebird reload

Сам файл UDF теж потрібен

І, звичайно, у тодішньому рішенні не можна було забути розмістити потрібну UDF-бібліотеку в каталозі UDF. Команди з * змінюють усі відповідні файли, а старі HTTP-адреси не забезпечують перевірки цілісності завантаження.

Що змінилося в Firebird 4

Механізм UDF позначено застарілим у Firebird 4: за типової конфігурації доступ до нього вимкнено, а бібліотеки ib_udf і fbudf не входять до комплекту. Для переходу слід вивчити вбудовані функції та заміни UDR/PSQL у офіційних примітках до Firebird 4, а не переносити цю давню процедуру без змін.

Безкоштовна хмара K2 ERP: модель, можливості й старт

Іноді найперспективніша бізнес-ідея починається з рішення не брати гроші там, де всі звикли їх заробляти. Саме так ми підійшли до створення...