Каталог документации / Раздел "Web мастеру, CGI, Perl, PHP, Apache" / Оглавление документа

Оглавление | Назад | Вперёд | Индекс

Глава 10
Конфигурирование Базы Данных

В этой главе рассматривается настройка Вашей Базы Данных для запуска со службой LiveWire Database Service. Вы должны прочесть эту главу и раздел "Информация Конфигурации" перед тем как использовать LiveWire с Вашими JavaScript-приложениями.

ПРИМЕЧАНИЕ:

Могут понадобиться изменения в клиентах БД. Дополнительно см. Enterprise Server 4.x Release Notes .

В этой главе имеются следующие разделы:

О Службе LiveWire Database Service
Проверка Конфигурации Вашей БД
Поддерживаемые Клиенты БД и ODBC-Драйверы
DB2
Informix
ODBC
Oracle
Sybase

О Службе LiveWire Database Service

Одновременно с версиями 3.x и 4.x Netscape-серверов Вы обязаны установить клиентскую библиотеку БД (и к тому же - определённую версию), если хотите использовать LiveWire Database Service. Вы также обязаны сконфигурировать эту клиентскую библиотеку для работы с LiveWire.

Netscape-серверы не поставляются вместе клиентскими библиотеками БД. Вам нужно связаться с поставщиком Вашей БД на предмет получения соответствующей библиотеки. Вам необходимо установить и сконфигурировать клиентские библиотеки только тех БД, которые Вы будете использовать.

Если Вы устанавливаете БД на другую машину (не на ту, где установлен web-сервер), Вы обязаны иметь установленную клиентскую библиотеку БД на машине с web-сервером. Вы обязаны получить соответствующее лицензионное разрешение от поставщика Вашей БД. Netscape не сделает это за Вас.

Требования по конфигурированию Вашей БД могут отличаться в зависимости от того, находятся ли БД и web-сервер на одной или на разных машинах. Если они на одной машине, последующая информация будет касаться локальной конфигурации; если на разных машинах - удалённой конфигурации.

В этой главе рассмотрены только те аспекты установки клиента БД, которые имеют отношение к использованию с LiveWire. Для получения общей информации об установке клиента БД обратитесь к соответствующей документации поставщика БД.

Проверка Конфигурации Вашей БД

После выполнения установки, описанной в данной главе, Вы можете использовать приложение-образец dbadmin для проверки правильности работы Вашего соединения с БД. Вы используете это приложение JavaScript для соединения с Вашим сервером БД и выполнения различных несложных задач, таких как выполнение оператора SELECT и отображение результатов или отправки произвольных SQL-команд серверу.

Поскольку dbadmin может использоваться для модификации и удаления таблиц БД, доступ к ней автоматически ограничен, если Вы выбрали защищённый режим Application Manager. Дополнительно об ограничении Application Manager см. "Управление Доступом к Приложению".

Первое, что Вы обязаны сделать при использовании dbadmin, это соединиться с БД. Выберите Connect to Database. Появится форма, показанная на Рисунке 10.1, где вы можете ввести информацию о соединении. Введите параметры и щёлкните Connect, чтобы попытаться установить соединение с сервером. О параметрах соединения см. "Пулы Соединений Базы Данных", а также описание метода connect в книге Серверный JavaScript. Справочник .

Рисунок 10.1 Страница соединения `dbadmin`

Если соединение установилось, появляется страница Execute Query. Это означает, что ваша БД соответствующим образом сконфигурирована для работы с LiveWire Database Service. Если соединиться не удалось, появится страница Database Connect Error. В этом случае убедитесь, что Вы следовали инструкциям по конфигурированию конкретной БД и "железа".

Поддерживаемые Клиенты БД и ODBC-Драйверы

В следующей таблице дано резюме по конкретным поставщикам БД, поддерживаемых на каждой платформе Netscape Enterprise Server 3.x (относительно Netscape Enterprise Server 4.0 см. замечания Enterprise Server 4.0 Release Notes).
Данные поставщики БД не поддерживаются сервером Netscape FastTrack Server.

Таблица 10.1 Клиентские библиотеки поставщиков БД, поддерживаемые на каждой платформе сервером Netscape Enterprise Server

Поставщик БД	AIX	DEC	Irix 6.2	>HP-UX 11.0	Solaris 2.5.1/2.6	Windows NT 4.0 w/ SP4
DB2	CAE 2.1.2	Не поддерживается	Не поддерживается	V5.2	V5.2	V5.2
Informix	Informix Client 7.22	Informix Client 7.22	Informix Client 7.22	SDK 2.10 (ESQL 9.16)	SDK 2.10 (ESQL 9.16)	SDK 2.10 TC1 (ESQL 9.16)
Microsoft ODBC	ODBC Mgr Visigenic 2.0	Не поддерживается	ODBC Mgr Visigenic 2.0	Не поддерживается	Поддерживается только на Solaris 2.5.1	MS SQL Server 6.5 (драйвер 3.60) SQL Anywhere 5.5 (драйвер 5.00) MS Access 7.0 (драйвер 3.51.171300)
Oracle ¹	Oracle Client 7.3.x	Oracle Client 7.3.x	Oracle Client 7.3.x	Oracle Client 8.0.5	Oracle Client 8.0.5	Oracle Client 8.0.5
Sybase	Open Client /C 11.1	Open Client /C 11.1	Open Client /C 11.1	11.1.1	11.1.1	11.1.1

¹ Версия Oracle SQL*Net 1.1 больше не поддерживается.

В следующей таблице дано резюме по поддержке ODBC в Windows NT для Netscape Enterprise Server и Netscape FastTrack Server.

Таблица 10.2 Поддержка ODBC в Windows NT

ODBC-Компонент	Windows NT 4.0 SP4
ODBC Manager	MS ODBC Manager 3.51 MCAD 2.0 SP2
ODBC-Драйверы
MS SQL Server 6.5	MS SQL Server Driver 3.60 (sqlsrv32.dll)
MS Access 7.0	MS Access Driver 3.51.171300 (odbcjt32.dll)
Sybase SQL Anywhere 5.5	Sybase SQL Anywhere Driver 5.00.0003 (wod50t.dll)

Обратите внимание, что ODBC не поддерживается на платформах Unix.

ПРИМЕЧАНИЕ:

Visigenic больше не обновляет свои существующие ODBC-драйверы или SDK. Вместо этого Visigenic избрал INTERSOLV для предоставления пути для обновления этих драйверов и продуктов. (См. http://www.intersolv.com/ newsstand/pr9711191.html). Visigenic предоставит документ, покрывающий различия между драйверами Visigenic и INTERSOLV ODBC. В таблице перечислены возможности поддерживаемых ODBC-драйверов для NT.

Таблица 10.3 Возможности ODBC-драйверов в NT

SQL-БД	Соединение	SQL passthrough/пропуск	Курсор "Только для чтения"	Обновляемый курсор	Хранимые процедуры
MS-SQL Server 6.5	Да	Да	Да	Да	Да
Sybase SQL Anywhere	Да	Да	Да	Да	Не проверено
Access	Да	Да	Да	Нет	N/A

Обратите внимание, что ODBC не поддерживается на платформах Unix.

DB2

Для использования DB2-сервера у вас должен быть Netscape Enterprise Server. Вы не можете получить доступ к DB2 из Netscape FastTrack Server.

Все платформы: Установить DB2-клиент версии 2.1.2. Для Solaris Вам нужен APAR #JR10150. См. DB2-документацию http://www.software.ibm.com/data/db2/.

Если серверы БД и web находятся на разных машинах: Чтобы определить возможность соединения с DB2-сервером, вы можете выполнить следующую команду из командной строки DB2:


DB2 TERMINATE # эта команда даёт возможность работы команды catalog

DB2 CONNECT TO имяБД USERID idпользователя USING пароль

Если вы используете в приложении типы данных BLOB или CLOB, вы обязаны установить опцию longdatacompat в Вашем файле $DB2PATH/db2cli.ini в 1. Например:


[Database name]
longdatacompat=1

Если Вы сделали изменения в файле db2cli.ini, Вы обязаны рестартовать Ваш web-сервер, чтобы они начали действовать.

Только для Unix: Вы обязаны установить следующие переменные окружения/environment variables:

DB2INSTANCE	Специфицирует имя порта соединения, определённое и на сервере, и на клиенте. Это имя имеется также и в файле конфигурации `dbm` для параметра конфигурации `SVCENAME`.
DB2PATH	Специфицирует директорию верхнего уровня, в которой установлен DB2. Например: `/home/$DB2INSTANCE/sqllib`
DB2COMM	Проверяет, что данная переменная специфицирует протокол, который будет использоваться. Например: DB2COMM=TCPIP
PATH	Обязана включать пути `$DB2PATH/misc:$DB2PATH/adm:$DB2PATH/bin`
LD_LIBRARY_PATH	(Solaris и Irix) Обязана включать директорию DB2 `lib`. Например, на Solaris обязана включать `/opt/IBMdb2/v2.1/lib`.
SHLIB_PATH	(HP-UX) Обязана включать директорию DB2 `lib`.
LIBPATH	(AIX) Обязана включать директорию DB2 `lib`.

Informix

При использовании сервера Informix Вы обязаны иметь Netscape Enterprise Server. Вы не можете получить доступ к Informix из Netscape FastTrack Server.

Если серверы БД и web находятся на разных машинах, следуйте инструкциям раздела "Удалённый Informix."

Если серверы БД и web находятся на одной машине, следуйте инструкциям раздела "Локальный Informix."

Удалённый Informix

Только для Unix: Установите Informix ESQL/C Runtime Client 7.22 (называемый также Informix I-Connect), а затем установите следующие переменные окружения:

INFORMIXDIR	Специфицирует верхнюю директорию, в которой установлен Informix.
INFORMIXSERVER	Специфицирует имя Informix-сервера по умолчанию.
INFORMIXSQLHOSTS	Специфицирует путь файла `sqlhosts`, если Вы поместили его куда-нибудь кроме `$INFORMIXDIR/etc/sqlhosts`. Эту переменную устанавливать не нужно, если Вы оставили файл `sqlhosts` в этой директории.
SHLIB_PATH	(HP-UX) Обязана содержать `$INFORMIXDIR/lib` и `$INFORMIXDIR/lib/esql`.

Вы обязаны также изменить $INFORMIXDIR/etc/sqlhosts, чтобы оно соответствовал имени службы в файле /etc/services. О том, как это сделать, см. документацию Informix.

Только для NT: Установите Informix ESQL/C Runtime Client 7.20 (называемый также Informix I-Connect.) В процессе установки все необходимые переменные окружения также устанавливаются. Вы используете подходящую утилиту Informix для ввода нужной информации об удалённом сервере, с которым Вы хотите устанавливать соединение.

Если Ваш web-сервер запускается как System, убедитесь, что у вас запущен regcopy.exe.

Все платформы: В зависимости от используемой службы имён, Вам может понадобиться также отредактировать соответствующий файл - добавить IP-адрес удалённой хост-машины, с которой Вы соединяетесь. В NT это файл winnt\system32\drivers\etc\hosts ниже директории NT SystemRoot. На Unix это файл /etc/hosts.

В той же директории добавьте следующую строку к файлу services:




ifmx_srvc
 
port
/tcp # Informix Online Server

где ifmx_srvc это имя Вашей службы, а port - номер порта. Номер порта обязан совпадать с номером порта на удалённой машине, который прослушивается Informix-сервером. Чтобы эта строка начала действовать, Вы обязаны либо вставить как минимум один пробел после tcp, либо поместить комментарий в конце этой строки. Например, если Ваша служба Informix называется ifmx1 и номер порта 1321, Вы добавляете следующую строку:


ifmx1 1321/tcp # Informix Online Server

Локальный Informix

Если вы устанавливаете Informix локально, Вы обязаны установить клиента Informix до установки Informix-сервера.

Только для Unix: Если Вы используете 7.22 Online Server для Unix, процесс инсталяции создаёт соответствующую структуру директорий и файл sqlhosts. Вы обязаны установить переменные окружения, как для удалённого сервера.

Только для NT: Вы должны установить Online Server 7.20. Это установит также и клиента; дополнительные шаги не нужны. Если Ваш web-сервер запускается как System, убедитесь, что у вас запущен regcopy.exe.

ODBC

Все платформы: О возможностях и об используемых ODBC-драйверах см. "Поддерживаемые Клиенты БД и ODBC-Драйверы."

Вам необходимо иметь соответствующие ODBC-драйверы для БД, с которой Вы устанавливаете соединение. Также необходимо иметь дополнительные файлы ODBC-соединений/connectivity.

Большинство программных продуктов, предоставляющие ODBC connectivity, поддерживают ODBC-драйвер или драйверы и ODBC connectivity.

Только для NT: В настоящее время Netscape сертифицирован с ODBC Manager версии 2.5. Если у вас имеется доступ к ODBC-драйверу, но не к файлам ODBC connectivity, Вы можете получить их в MS ODBC SDK. Чтобы получить обновлённые файлы для Access, Foxpro и Excel, Вам может понадобиться патч WX1350 от Microsoft.

Только для Unix: Для ODBC на Unix вы можете использовать драйвер от Visigenic либо от OpenLink. Если Вы используете драйвер от Visigenic, следуйте инструкциям раздела "Visigenic ODBC-Драйвер (только Unix)." Если Вы используете драйвер от OpenLink, следуйте инструкциям раздела "OpenLink ODBC-Драйвер (только Solaris)."

ODBC Data Source Names/Имена Источников Данных (только NT)

Могут быть созданы два типа источников данных:

System/Системное DSN: Если вы используете системное DSN, web-сервер обязан стартовать в бюджете System.
User/Пользовательское DSN: Если вы используете пользовательское DSN, web-сервер обязан стартовать в соответствующем пользовательском бюджете NT (user account).

Источник данных описывает параметры соединения для каждой БД, необходимые для ODBC connectivity. Источник данных определяется чрез использование ODBC-администратора. Если ODBC установлен, администратор также устанавливается. Каждый ODBC-драйвер требует различной информации для определения источника данных.

OpenLink ODBC-Драйвер (только Solaris)

Установите брокер запросов OpenLink Workgroup Edition ODBC Driver на сервер БД. Он должен быть запущен, до того как Вы сможете соединиться с БД с использованием агента запросов OpenLink.

Установите агента запросов (request agent) в клиенте OpenLink Generic ODBC версии 1.5 на клиентской машине БД.

Переименуйте или скопируйте файл драйвера менеджера агента запросов из libiodbc.so в libodbc.so в директории $ODBCDIR/lib, где $ODBCDIR это директория, в которой установлен ODBC.

Когда Вы устанавливаете Ваш сервер, Вы делаете так, чтобы он запускался как некоторый пользователь: root, nobody или конкретный пользователь сервера. Выбранный Вами пользователь должен иметь домашнюю директорию, которую, возможно, понадобится создать. Например, по умолчанию домашняя директория для пользователя nobody на Irix это /dev/null. Если Вы устанавливаете Ваш сервер на Irix как nobody, Вы обязаны создать для пользователя nobody другую домашнюю директорию.

В этой домашней директории Вы обязаны иметь файл .odbc.ini. Например, если сервер запускается как root, этот файл находится в директории (/).

Установите следующие переменные окружения:

LD_LIBRARY_PATH	(Solaris и Irix) Добавляет размещение ODBC-библиотек к данной переменной.
UDBCINI	Специфицирует местонахождение файла `.odbc.ini`.

Visigenic ODBC-Драйвер (только Unix)

При установке сервера он запускается как пользователь: root, nobody или определённый пользователь сервера. Выбранный вами пользователь должен иметь существующую домашнюю директорию, которую, возможно, понадобится создать. Например, домашняя директория по умолчанию для пользователя nobody в системе Irix это /dev/null. Если Вы устанавливаете Ваш сервер в Irix как nobody, Вы обязаны дать пользователю nobody другую домашнюю директорию.

В этой домашней директории обязан находиться файл .odbc.ini. Например, если Вы запускаете сервер как root, этот файл находится в корневой директории (/).

Установите следующие переменные окружения:

LD_LIBRARY_PATH	(Solaris и Irix) Добавьте местонахождение ODBC-библиотек в данную переменную. В предыдущем примере это может быть `/u/my-user/odbcsdk/lib`.
SHLIB_PATH	(HP-UX) Добавьте местонахождение ODBC-библиотек в данную переменную.
LIBPATH	(AIX) Добавьте местонахождение ODBC-библиотек в данную переменную.

ПРИМЕЧАНИЕ:

Visigenic больше не обновляет свои существующие ODBC--драйверы и SDK. Вместо этого Visigenic избрал INTERSOLV для предоставления обновлённого пути для этих драйверов и продуктов. (См. http://www.intersolv.com/ newsstand/pr9711191.html). Visigenic будет предоставлять документ, проясняющий операционные различия между ODBC-драйверами Visigenic и INTERSOLV.

Oracle

Чтобы использовать сервер Oracle, Вы обязаны иметь Netscape Enterprise Server. Вы не можете получить доступ к Oracle из Netscape FastTrack Server.

Если БД и web-сервер находятся на разных машинах, следуйте инструкциям раздела "Удалённый Oracle."

Если БД и web-сервер находятся на одной машине, следуйте инструкциям раздела "Oracle Local."

Только для Unix: Убедитесь, что Вы можете соединиться с Вашей БД Oracle через SQL*Net. Если Вы закончили инсталяцию, Вы можете использовать loopback-тест для проверки корректности соединения. Например, из sqlplus Вы можете попытаться соединиться с Вашей БД с помощью следующей команды:


connect username/password@service_name

Или из командной строки Unix:


sqlplus username/password@service_name

В этих командах Вы используете service_name из Вашего файла tnsnames.ora.

Удалённый Oracle

Только для NT: Вы обязаны установить клиентское программное обеспечение Oracle 7.3.2 для NT. Клиенты Oracle 7.1 и 7.2 не поддерживаются. Вы обязаны также создать файлы конфигурации Oracle, используемые соответствующей утилитой конфигурирования Oracle.

Только для Unix: Прежде чем Вы сможете подключиться к Oracle под Irix, Вы обязаны иметь соответствующие патчи для Irix. См. в Enterprise Server 3.x Release Notes информацию о необходимых патчах.

Вы обязаны установить клиентов Oracle 7.3.x для Unix. Клиенты Oracle 7.1 и 7.2 не поддерживаются.

Вы обязаны установить следующие переменные окружения:


ORACLE_HOME

Специфицирует директорию верхнего уровня, в которой установлен Oracle.


TNS_ADMIN

Специфицирует место размещения файлов конфигурации, например, $ORACLE_HOME/network/admin. После инсталяции Oracle создаёт файлы конфигурации под /var/opt/oracle. Если listener.ora и tnsnames.ora находятся в этой директории, Вам может не понадобиться устанавливать TNS_ADMIN, поскольку по умолчанию Oracle использует /var/opt/oracle.

Если эти переменные не установлены надлежащим образом, Oracle возвращает код ошибки ORA-1019 при первой попытке установления соединения. Об обработке ошибок см. Главу 12, "Обработка Ошибок для LiveWire."

Локальный Oracle

Все платформы: Вы обязаны установить Oracle Workgroup Enterprise Server 7.3.2 (NT) или Enterprise Server 7.3.x (Unix). Клиенты Oracle 7.1 и 7.2 не поддерживаются. Уточните у вашего поставщика сервера, совместима ли Ваша версия Oracle-сервера с Oracle-клиентом.

Вы обязаны установить следующие переменные окружения:

ORACLE_HOME	Специфицирует директорию верхнего уровня, в которой установлен Oracle.
ORACLE_SID	Специфицирует Oracle System Identifier (Системный Идентификатор).

Если у Вас локальный сервер БД Oracle, Вы обязаны передавать пустую строку в качестве второго аргумента методу connect объектов database или DbPool или конструктору DbPool. Таким образом, эти методы используют значение переменной окружения ORACLE_SID. Например:


database.connect ("ORACLE", "" "user", "password", "");

Об инсталяции Oracle см. дополнительно документацию по Oracle.

Sybase

Чтобы использовать сервер Sybase, Вы обязаны иметь Netscape Enterprise Server. Вы не можете получить доступ к Sybase из Netscape FastTrack Server.

Если БД и web-сервер находятся на разных машинах, следуйте инструкциям раздела "Удалённый Sybase."

Если БД и web-сервер находятся на одной машине, следуйте инструкциям раздела "Локальный Sybase."

Кроме того, если Вы используете Unix-платформу, и Sybase имеет многопоточный драйвер для этой платформы, следуйте инструкциям раздела "Sybase (только для Unix)." См. в Enterprise Server 3.x Release Notes список Unix-платформ, на которых Sybase имеет многопоточный драйвер.

Удалённый Sybase

Только для Unix: Установите следующие переменные окружения:

SYBASE	Директория верхнего уровня, в которой установлен Sybase.
LD_LIBRARY_PATH	(DEC) Обязана содержать `$SYBASE/lib`.

Для Solaris Вы обязаны также следовать инструкциям раздела "Sybase (только для Unix)."

Все платформы: Вы обязаны установить SYBASE Open Client/C. Поддерживаемые поставщики перечислены в разделе "Поддерживаемые Клиенты БД и ODBC-Драйверы."

Вы можете использовать подходящую утилиту Sybase для ввода в файл sql.ini (NT) и файл interfaces (все платформы) информации об удалённом сервере, с которым Вы хотите установить соединение. Дополнительно см. документацию Sybase.

Локальный Sybase

Только для Unix: Установите следующие переменные окружения:

SYBASE	Директория верхнего уровня, в которой установлен Sybase.
LD_LIBRARY_PATH	(DEC) Обязана содержать `$SYBASE/lib`.

Для Solaris Вы обязаны также следовать инструкциям раздела "Sybase (только для Unix)."

Все платформы: Установите Sybase SQL Server версии 11.1; клиентская часть устанавливается вместе с сервером. Поддерживаемые версии перечислены в разделе "Поддерживаемые Клиенты БД и ODBC-Драйверы."

Sybase (только для Unix)

На некоторых Unix-платформах Sybase имеет и однопоточный, и многопоточный драйверы. Если Sybase имеет многопоточный драйвер для конкретной Unix-машины, Вы обязаны использовать этот многопоточный драйвер с LiveWire. На этих платформах Ваш web-сервер будет вести себя непредсказуемо с однопоточным драйвером. Это требование применяется как для локальных, так и для удалённых соединений. оно не применяется к Windows-платформам.

См. в Enterprise Server 3.x Release Notes список Unix-платформ, на которых Sybase имеет многопоточный драйвер.

Чтобы убедиться в том, что Вы используете многопоточный драйвер, вы обязаны отредактировать Ваш файл $SYBASE/config/libtcl.cfg. Он содержит пару строк, которые включают однопоточный, либо многопоточный драйвер. Вы обязаны иметь одну из этих строк закомментированную, а другую активную. Например, на Solaris найдите эти строки:


[DRIVERS]
;libtli.so=tcp unused ; Это беспоточный tli-драйвер.

libtli_r.so=tcp unused ; Это поточный tli-драйвер.

Удостоверьтесь, что строка для однопоточного драйвера закомментирована, а строка многопоточного драйвера - не закомментирована. Имена файлов различаются на разных платформах, но эти строки всегда расположены в разделе DRIVERS и всегда закомментированы, чтобы различать однопоточный и многопоточный драйверы.

ПРИМЕЧАНИЕ:

Если вы хотите использовать утилиту Sybase isql, Вы обязаны использовать беспоточный tli -драйвер. В этом случае строка для libtli_r.so обязана быть закомментирована. Об использовании этого драйвера см. документацию по Sybase.