Хелен Борри - Firebird РУКОВОДСТВО РАЗРАБОТЧИКА БАЗ ДАННЫХ

Каждой машине удаленного клиента требуется клиентская библиотека, которая соответствует версии сервера Firebird. Обычно допустимым является использование клиентской библиотеки из другой сборки (build) релиза - при условии, что номера версий совпадают. Тем не менее при обновлении сервера прочтите документацию README, поступающую с конкретным релизом, для определения того, где можно использовать более ранние клиентские версии.

Внимательно просмотрите системные пути на каждой клиентской рабочей станции, на которой вы собираетесь инсталлировать клиента Firebird, для удаления при необходимости существующих клиентских инсталляций InterBase или Firebird.

* В Firebird 1.0.x клиентские библиотеки используют те же имена и размещение, что и его двойник InterBase. Хотя возможно так установить приложения, чтобы они использовали переименованную клиентскую библиотеку, тем не менее, строго рекомендуется исключить размещение приложений Firebird 1.0.x и InterBase на одной и той же рабочей станции, если вы не уверены, что ваши приложения сконфигурированы так, чтобы отыскивать и использовать правильную библиотеку.

* Firebird 1.5 и более поздние версии под Windows может сосуществовать с InterBase и Firebird 1,0.x на сервере и клиенте. В Firebird 1.5 все еще имеют значение ручные установки, хотя с меньшими неприятностями, чем в версии 1.0.x. В версиях более поздних, чем 1.5, множество серверов и версий могут быть автоматически инсталлированы в Windows.

Операционные системы POSIX являются весьма своеобразными. Присутствующие в этом разделе советы должны быть полезными в качестве руководства по инсталляции клиентов для большинства разновидностей Linux и UNIX, однако это область, где сомнения являются несомненными!

1. Подключитесь к клиентской машине как пользователь root и найдите клиентскую библиотеку в инсталляции сервера:

• в Firebird 1,0.x ее имя libgds.so.0, размещение по умолчанию /usr/lib;

• в Firebird 1.5 двоичные файлы удаленного клиента libfbclient.so. 1.5.0 инсталлированы по умолчанию в /opt/firebird/lib.

! ! !

ВНИМАНИЕ! В поставке Классического сервера есть клиентская библиотека с именем libfbembed.so.1.5, которая может быть использована для встроенных приложений. Не используйте ее для удаленных клиентов.

. ! .

2. Скопируйте библиотеку в /usr/lib на клиенте и создайте символическую ссылку на нее, используя следующие команды:

• для версии 1.0x:

ln -s /usr/lib/libgds.so.0 /usr/lib/libgds.so

• для версии 1.5 (две ссылки):

In -s /usr/lib/libfbclient.so.1.5 /usr/lib/libfbclient.so.0 In -s /usr/lib/libfbclient.so.0 /usr/lib/libfbclient.so

3. Создайте каталог/opt/firebird (/opt/interbase для версии 1.0.x) на клиенте для файла сообщений и скопируйте этот файл из корневого каталога Firebird на сервере:

• для версии 1,0.x скопируйте interbase.msg в /opt/interbase/;

• для версии 1.5 и выше скопируйте firebird.msg в /opt/firebird/.

4. В системном профайле оболочки по умолчанию или вызовом setenvo создайте переменную окружения, которая позволит найти утилиту для сообщений API:

• для версии 1.0.x создайте переменную INTERBASE и свяжите ее с /opt/interbase/;

• для версии 1.5 и выше создайте переменную FIREBIRD и свяжите ее с /opt/firebird/.

В Windows клиентская библиотека всегда по умолчанию инсталлировалась в системный каталог. По умолчанию это C:\WINNT\system32 для Windows NT и 2000, C:\Windows\system32 для Windows XP и Server 2000 и C:\Windows\ или C:\Windows\system [12] На этих платформах, не имеющих поддержки сервисов, размещение может быть иным. Необходимо проверять, установлены ли предыдущие клиенты Firebird или InterBase. для Windows 9х и ME. В Firebird 1.0.x в качестве временной меры сохраняются старые имена и местоположение.

Самый простой способ инсталлировать клиента Firebird 1.0.x- это скопировать инсталлятор Firebird на компакт-диск или флэш-память и запустить его на клиентской машине, выбрав установку только клиента в диалоговом окне инсталлятора. Вы можете инсталлировать клиента с инструментами командной строки или без них. Большинству клиентов не нужны эти инструменты; не рекомендуется устанавливать их на клиентских рабочих станциях, где не требуется доступ администратора к серверу.

Инсталлятор создаст корневой каталог по умолчанию в C:\Program Files\Firebird; это размещение вы можете изменить в соответствующем диалоге инсталлятора. Сюда он запишет файл сообщений interbase.msg и, если были выбраны для инсталляции инструменты командной строки, создаст каталог \bin, куда поместит эти инструменты.

Он запишет в системный каталог gds32.dll и, если библиотека времени выполнения Microsoft С старая или вовсе отсутствует, запишет туда же msvcrt.dll.

Под конец он запустит программу instreg.exe для инсталляции ключей в системном реестре. Если вы выбрали каталог инсталляции по умолчанию, ключ будет

HKLM\Software\Borland\InterBase. Если какие-нибудь выполняющиеся программы были перезаписаны в процессе инсталляции, вам будет предложено перезагрузить машину.

Инсталляция клиента вручную требует выполнения всех предыдущих шагов. Вам нужно скопировать файлы gds32.dll, interbase.msg и instreg.exe на дискету или флэш- память. Также скопируйте из системного каталога msvcrt.dll, если на ваших клиентах она не установлена.

Создав корневой каталог Firebird, скопируйте туда interbase.msg. Затем запустите с диска instreg.exe, набрав в окне командной строки:

А:\> instreg.exe 'C:\Program Files\Firebird'

Если вы создали корневой каталог Firebird где-нибудь в другом месте, укажите этот путь как аргумент корневого каталога.

Скопируйте gds32.dll и, если нужно msvcrt.dll, в системный каталог.

! ! !

ПРИМЕЧАНИЕ, msvcrt.dll является библиотекой времени выполнения для многих программ, скомпилированных компилятором Windows С. gds32.dll - это имя клиентской библиотеки для серверов InterBase, а также Firebird 1.0.x. В случае если вы не можете скопировать одну из библиотек или обе по причине их использования другой программой, необходимо остановить ту программу и повторить процесс копирования. Если все еще невозможно переписать библиотеки по причине того, что аварийно завершившаяся программа не выгрузила их, перезагрузите компьютер в безопасном режиме и выполните этот шаг.

. ! .

Firebird версии 1.5 и последующие клиентские инсталляции поставляются с большим количеством режимов с целью избежать "ужаса DLL" в системном каталоге Windows.

До тех пор, пока сторонние инструменты, драйверы и компоненты не научатся понимать изменения в клиентской части Firebird 1.5, Firebird 1.5 будет поддерживать собственные "ужасы DLL". Инсталляция клиента по умолчанию почти наверняка будет несовместимой с программным обеспечением, созданным с использованием таких RAD-продуктов Borland, как Delphi или C++ Builder.

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