В этой главе рассматривается настройка Вашей Базы Данных для запуска со службой LiveWire Database Service. Вы должны прочесть эту главу и раздел "Информация Конфигурации" перед тем как использовать LiveWire с Вашими JavaScript-приложениями.
Могут понадобиться изменения в клиентах БД. Дополнительно см. Enterprise Server 4.x Release Notes .
В этой главе имеются следующие разделы:
Одновременно с версиями 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.
Справочник
.
dbadmin
Если соединение установилось, появляется страница Execute Query. Это означает, что ваша БД соответствующим образом сконфигурирована для работы с LiveWire Database Service. Если соединиться не удалось, появится страница Database Connect Error. В этом случае убедитесь, что Вы следовали инструкциям по конфигурированию конкретной БД и "железа".
В следующей таблице дано резюме по конкретным поставщикам БД, поддерживаемых на каждой платформе
Netscape Enterprise Server 3.x (относительно Netscape Enterprise Server 4.0 см.
замечания Enterprise Server 4.0 Release Notes).
Данные поставщики БД не поддерживаются сервером
Netscape FastTrack 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 | |||||
| Informix | ||||||
| Microsoft ODBC |
MS SQL Server 6.5 (драйвер 3.60) | |||||
| Oracle 1 | ||||||
| Sybase |
В следующей таблице дано резюме по поддержке ODBC в Windows NT для Netscape Enterprise Server и Netscape FastTrack Server.
| ODBC-Компонент | Windows NT 4.0 SP4 |
|---|---|
| ODBC-Драйверы | |
Обратите внимание, что ODBC не поддерживается на платформах Unix.
Visigenic больше не обновляет свои существующие ODBC-драйверы или SDK. Вместо этого Visigenic избрал INTERSOLV для предоставления пути для обновления этих драйверов и продуктов. (См. http://www.intersolv.com/ newsstand/pr9711191.html). Visigenic предоставит документ, покрывающий различия между драйверами Visigenic и INTERSOLV ODBC. В таблице перечислены возможности поддерживаемых ODBC-драйверов для NT.
| SQL-БД | Соединение | SQL passthrough/пропуск | Курсор "Только для чтения" | Обновляемый курсор | Хранимые процедуры |
|---|---|---|---|---|---|
Обратите внимание, что ODBC не поддерживается на платформах Unix.
Для использования 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:
При использовании сервера Informix Вы обязаны иметь Netscape Enterprise Server. Вы не можете получить доступ к Informix из Netscape FastTrack Server.
Если серверы БД и web находятся на разных машинах, следуйте инструкциям раздела "Удалённый Informix."
Если серверы БД и web находятся на одной машине, следуйте инструкциям раздела "Локальный Informix."
Только для Unix: Установите Informix ESQL/C Runtime Client 7.22 (называемый также Informix I-Connect), а затем установите следующие переменные окружения:
Вы обязаны также изменить $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-сервера.
Только для Unix: Если Вы используете 7.22 Online Server
для Unix, процесс инсталяции создаёт соответствующую структуру директорий и файл sqlhosts.
Вы обязаны установить переменные окружения, как для удалённого сервера.
Только для NT: Вы должны установить Online Server 7.20. Это установит также и клиента;
дополнительные шаги не нужны. Если Ваш web-сервер запускается как System,
убедитесь, что у вас запущен regcopy.exe.
Все платформы: О возможностях и об используемых 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 connectivity. Источник данных определяется чрез использование ODBC-администратора. Если ODBC установлен, администратор также устанавливается. Каждый ODBC-драйвер требует различной информации для определения источника данных.
Установите брокер запросов 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
|
При установке сервера он запускается как пользователь: root, nobody
или определённый пользователь сервера. Выбранный вами пользователь должен иметь
существующую домашнюю директорию, которую, возможно, понадобится создать.
Например, домашняя директория по умолчанию для пользователя nobody в системе Irix
это /dev/null. Если Вы устанавливаете Ваш сервер в Irix как nobody,
Вы обязаны дать пользователю nobody другую домашнюю директорию.
В этой домашней директории обязан находиться файл .odbc.ini.
Например, если Вы запускаете сервер как root, этот файл находится в корневой директории (/).
Установите следующие переменные окружения:
Visigenic больше не обновляет свои существующие ODBC--драйверы и SDK. Вместо этого Visigenic избрал INTERSOLV для предоставления обновлённого пути для этих драйверов и продуктов. (См. http://www.intersolv.com/ newsstand/pr9711191.html). Visigenic будет предоставлять документ, проясняющий операционные различия между ODBC-драйверами Visigenic и INTERSOLV.
Чтобы использовать сервер Oracle, Вы обязаны иметь Netscape Enterprise Server. Вы не можете получить доступ к Oracle из Netscape FastTrack Server.
Если БД и web-сервер находятся на разных машинах, следуйте инструкциям раздела "Удалённый Oracle."
Если БД и web-сервер находятся на одной машине, следуйте инструкциям раздела "Oracle Local."
Только для Unix: Убедитесь, что Вы можете соединиться с Вашей БД Oracle через SQL*Net. Если
Вы закончили инсталяцию, Вы можете использовать loopback-тест для проверки
корректности соединения. Например,
из sqlplus Вы можете попытаться соединиться с Вашей БД с помощью следующей команды:
connect username/password@service_name
sqlplus username/password@service_name
В этих командах Вы используете service_name из
Вашего файла tnsnames.ora.
Только для 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 возвращает код ошибки ORA-1019 при первой попытке установления соединения. Об обработке ошибок см. Главу 12, "Обработка Ошибок для LiveWire."
Только для Unix: Прежде чем Вы сможете подключиться к Oracle под Irix, Вы обязаны иметь соответствующие патчи для Irix. См. в Enterprise Server 3.x Release Notes информацию о необходимых патчах.
Все платформы: Вы обязаны установить 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, Вы обязаны иметь Netscape Enterprise Server. Вы не можете получить доступ к Sybase из Netscape FastTrack Server.
Если БД и web-сервер находятся на разных машинах, следуйте инструкциям раздела "Удалённый Sybase."
Если БД и web-сервер находятся на одной машине, следуйте инструкциям раздела "Локальный Sybase."
Кроме того, если Вы используете Unix-платформу, и Sybase имеет многопоточный драйвер для этой платформы, следуйте инструкциям раздела "Sybase (только для Unix)." См. в Enterprise Server 3.x Release Notes список Unix-платформ, на которых Sybase имеет многопоточный драйвер.
Только для Unix: Установите следующие переменные окружения:
SYBASE
| Директория верхнего уровня, в которой установлен Sybase. |
LD_LIBRARY_PATH
|
Для Solaris Вы обязаны также следовать инструкциям раздела "Sybase (только для Unix)."
Все платформы: Вы обязаны установить SYBASE Open Client/C. Поддерживаемые поставщики перечислены в разделе "Поддерживаемые Клиенты БД и ODBC-Драйверы."
Вы можете использовать подходящую утилиту Sybase для
ввода в файл sql.ini (NT) и файл interfaces (все
платформы) информации об удалённом сервере, с которым Вы хотите установить
соединение. Дополнительно см. документацию Sybase.
Только для Unix: Установите следующие переменные окружения:
SYBASE
| Директория верхнего уровня, в которой установлен Sybase. |
LD_LIBRARY_PATH
|
(DEC) Обязана содержать
|
Для Solaris Вы обязаны также следовать инструкциям раздела "Sybase (только для Unix)."
Все платформы: Установите Sybase SQL Server версии 11.1; клиентская часть устанавливается вместе с сервером. Поддерживаемые версии перечислены в разделе "Поддерживаемые Клиенты БД и ODBC-Драйверы."
Вы можете использовать подходящую утилиту Sybase для ввода в файл sql.ini (NT)
и файл interfaces (все платформы) информации об удалённом сервере,
с которым Вы хотите установить соединение. Дополнительно см. документацию Sybase.
На некоторых 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.
Дата последнего обновления: 29 сентября 1999 г.
© Copyright ╘ 1999 Sun Microsystems, Inc. Некоторая часть Copyright ╘ 1999 Netscape Communications Corp. Все Права Зарезервированы.