12.4. Установка ODBC-драйверов

Установка драйверов ODBC осуществляется в следующей последовательности:

  1. Примечание

    На один и тот же сервер FraudWall при необходимости может быть установлено несколько различных ODBC-драйверов, например, для СУБД Oracle и Microsoft SQL Server.

12.4.1. Установка ODBC-драйверов для Oracle

ODBC-драйвера к Oracle являются частью программного обеспечения Oracle Instant Client, которое можно скачать с сайта Oracle (меню Download, пункт Instant Client). Необходимо выбрать «Instant Client for Linux x86», затем скачать следующие файлы относящиеся к версии 11.2 или 12.x:

  • oracle-instantclient11.2-basic-11.2.0.3.0-1.i386.rpm

  • oracle-instantclient11.2-odbc-11.2.0.3.0-1.i386.rpm

Скаченные файлы необходимо записать на сервер FraudWall (если используется несколько серверов, настройки выполняются на тех серверах, где требуются ODBC-драйвера), затем выполнить в консоли последовательно команды:

  • rpm -i oracle-instantclient11.2-basic-11.2.0.3.0-1.i386.rpm

  • rpm -i oracle-instantclient11.2-odbc-11.2.0.3.0-1.i386.rpm

  • yum install fraudwall-odbc-oracle

Примечание

FraudWall автоматически определяет, какие версии драйверов Oracle были установлены, и использует самую максимальную версию. Деинсталлировать старые версии драйверов при этом не нужно.

После установки, в директории /usr/lib/oracle/NNN/client/network/admin/ (NNN соответствует самой большой установленной версии драйверов Oracle) необходимо в файлах tnsnames.ora и sqlnet.ora прописать параметры для подключения к базе данных (их можно уточнить у администраторов базы данных Oracle).

Внимание

После выполнения настроек необходимо закрыть текущую SSH-сессию и переподключиться к серверу FraudWall повторно (если не уверены, просто перегрузите сервер командой reboot). Если этого не сделать, переменные окружения не обновятся, и в дальнейшем при установке будут ошибки.

12.4.2. Установка ODBC-драйверов для Microsoft SQL Server и Sybase

В качестве ODBC-драйверов к СУБД Microsoft SQL Server и Sybase используются бесплатно распространяемые драйвера проекта FreeTDS.

Для начала установки ODBC-драйверов на сервер FraudWall необходимо выполнить команду: yum install fraudwall-odbc-freetds

12.4.3. Установка ODBC-драйверов для PostgreSQL

Примечание

Несмотря на то, что FraudWall для работы с собственной базой данных использует нативные протоколы обмена с базой данных PostgreSQL, при работе с внешними базами данных (систем ДБО и АБС) используется протокол ODBC, даже если эта база данных работает на СУБД PostgreSQL.

ODBC-драйвера к PostgreSQL входят в комплект программного обеспечения, поставляемого совместно с операционной системой.

Для установки ODBC-драйверов для базы данных PostgreSQL необходимо выполнить команду: yum install fraudwall-odbc-psql

12.4.4. Установка ODBC-драйверов для Firebird

Для установки ODBC-драйверов для базы данных Firebird необходимо выполнить команду: yum install fraudwall-odbc-firebird

12.4.5. Установка ODBC-драйверов для Progress OpenEdge

Начиная с версии 10.0, в комплект СУБД Progress OpenEdge входят бесплатные ODBC-драйвера под названием SQL Client Access. Для установки понадобятся:

  • SQL Client Access версии 11.6 linux 32-bit

  • Progress OpenEdge 11.6.4.0 Service Pack 4

Перед началом установки ODBC-драйвера необходимо выполнить команду: yum install fraudwall-odbc-progress

Внимание

Необходимо закрыть текущую SSH-сессию и переподключиться к серверу FraudWall повторно (если не уверены, просто перегрузите сервер командой reboot). Если этого не сделать, переменные окружения не обновятся, и в дальнейшем при установке будут ошибки.

Затем необходимо открыть файл /usr/lib/progress/silent.cfg на редактирование и указать в нем данные, соответствующие бесплатной лицензии на ODBC-драйвер:

  • в параметре name указывается наименование организации

  • в параметре serial указывается значение Serial Number бесплатного драйвера

  • в параметре control указывается Control Number бесплатного драйвера

Создайте временную папку для установки SQL Client Access командой:

mkdir /var/tmp/pgoe

Скопируйте в /var/tmp/pgoe архив SQL Client Access (имя файла PROGRESS_OE_11.6_LNX_32_SQLCLIENTACCESS.tar.gz), перейдите в эту директорию, и в ней выполните команду:

tar xvf PROGRESS_OE_11.6_LNX_32_SQLCLIENTACCESS.tar.gz

Создайте временную папку для установки SP 4 командой:

mkdir /var/tmp/pgoe4

Скопируйте в /var/tmp/pgoe4 архив SP4 (имя файла PROGRESS_OE_11.6.4_LNX_32.tar.gz), перейдите в эту директорию, и в ней выполните команду:

tar xvf PROGRESS_OE_11.6.4_LNX_32.tar.gz

Перейдите в директорию /tmp

Установите SQL Client Access командой:

TERM=linux /var/tmp/pgoe/proinst -b /usr/lib/progress/silent.cfg

Установите SP4 командой (обратите внимание, папка pgoe4 !):

TERM=linux /var/tmp/pgoe4/proinst -b /usr/lib/progress/sp4.ini

Перейдите в директорию /usr/lib/progress/odbc/lib и посмотрите точное название файла pgoeNNN.so (значение NNN зависит от версии ODBC-драйверов).

Далее необходимо открыть на редактирование файл /etc/odbcinst.ini, и в секции [Progress OpenEdge] исправить значение параметра Driver, указав правильный путь к файлу pgoeNNN.so

Для проверки корректности установки драйверов выполните команду (укажите корректное значение NNN)

ivtestlib /usr/lib/progress/odbc/lib/pgoeNNN.so

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

12.4.6. Установка ODBC-драйверов для Pervasive SQL

ODBC-драйвера к СУБД Pervasive SQL распространяются разработчиком данной СУБД.

Перед началом установки ODBC-драйверов к СУБД Pervasive SQL необходимо с сайта компании-разработчика данной СУБД скачать архив PSQL Client - Linux TAR 32-bit для версии v11 (SP3 и выше).

Данный TAR-файл необходимо записать на сервер Fraudwall в директорию /tmp, затем выполнить команду: yum install fraudwall-odbc-pervasive

Внимание

После выполнения настроек необходимо закрыть текущую SSH-сессию и переподключиться к серверу FraudWall повторно (если не уверены, просто перегрузите сервер командой reboot). Если этого не сделать, переменные окружения не обновятся, и в дальнейшем при установке будут ошибки.

12.4.7. Установка ODBC-драйверов для H2

Взаимодействие с базой данных H2 осуществляется посредством протокола Postgresql.

Для установки ODBC-драйверов для базы данных H2 необходимо выполнить команду: yum install fraudwall-odbc-h2

12.4.8. Установка ODBC-драйверов для MySQL

ODBC-драйвера к MySQL входят в комплект программного обеспечения, поставляемого совместно с операционной системой.

Для установки ODBC-драйверов для базы данных MySQL необходимо выполнить команду: yum install fraudwall-odbc-mysql

Далее необходимо открыть на редактирование файл /etc/odbcinst.ini, и в секции [MySQL] исправить значение параметра Driver, указав правильный путь к файлу libmyodbc3.so (для MySQL до версии 4.1.1) либо libmyodbc5.so (для MySQL версии 4.1.1 и выше)

12.4.9. Редактирование конфигурационного файла /etc/odbc.ini

Начиная с версии 4.3.4, редактирование файла /etc/odbc.ini необходимо осуществлять через вкладку "Базы данных" интерфейса "Система\Конфигурирование".

12.4.10. Диагностика и решение проблем с ODBC-драйверами

Проверить корректность подключения к внешней базе данных можно, выполнив следующую команду (вместо dsn, user и password необходимо соответственно указать присвоенное ODBC DSN - имя (отображатся во вкладке "Базы данных" интерфейса "Система\Конфигурирование"), а также логин и пароль пользователя, созданного в базе данных): isql -v dsn "user" "password"

При корректных настройках будет осуществлено подключение к базе данных и можно будет выполнить SQL-команды. Для выхода из утилиты isql необходимо нажать Ctrl+C, либо ввести команду quit

Для включения диагностического trace-файла необходимо открыть на редактирование файл /etc/odbcinst.ini и в секции [ODBC] раскомментировать (т.е. удалить символ ‘#’ в начале) параметр TraceFile:

[ODBC]
# Для формирования отладочного trace-файла раскомментируйте
# параметры TraceFile, Trace и ForceTrace
TraceFile       = /var/log/fraudwall/odbc.log
Trace           = Yes
ForceTrace      = Yes

После сохранения изменений, необходимо выполнить команды service fw_control restart

service fw_master restart

Внимание

Не забудьте отключить формирование trace-файла после устранения ошибок, закомментировав указанные параметры TraceFile, Trace и ForceTrace и перестартовав сервисы fw_control и fw_master, как указано выше.

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