Конфигурация источника данных для Java при использовании IBM WebSphere
Используйте консоль администрирования IBM WebSphere для создания источника данных, поставщика JDBC и определения пользовательских свойств.
Источник данных представляет собой именованное подключение к базе данных. Чтобы опубликовать сервис объектов в ArcGIS Spatial Data Server for the Java platform, необходимо указать источник данных в сервере веб-приложений. Объект источника данных определяется с помощью сервиса наименований в интерфейсе наименований и каталогов Java Naming and Directory Interface (JNDI) API.
Версии драйверов JDBC, установленных с WebSphere драйвера JDBC могут не поддерживаться ArcGIS Spatial Data Server. Драйвер PostgreSQL JDBC не устанавливается с WebSphere. В этих случаях необходимо разместить правильный драйвер JDBC в корневую директорию WebSphere Application Server и создать новый поставщик JDBC. Вы можете создать поставщик JDBC при настройке источника данных или до этого. Инструкции в этом разделе позволяют создать поставщик JDBC одновременно с настройкой источника данных.
Добавление драйвера JDBC
Разместите драйвер JDBC для вашей базы данных в директории lib WAS_INSTALL_ROOT.
Настройка источника данных
DB2
Используйте консоль администрирования WebSphere для создания источника данных DB2, поставщика JDBC и настройки свойств источника данных.
Создание источника данных и поставщика JDBC
Далее описываются действия по созданию источника данных DB2 и поставщика JDBC в консоли администрирования WebSphere.
- Выполните вход в IBM WebSphere Administration Console в качестве пользователя-администратора.
- Откройте JDBC в Ресурсы (Resources) и выберите Источники данных (Data sources).
- Щелкните Создать (New), чтобы создать новый источник данных.
Откроется страница Создать источник данных (Create Data Source).
- Введите имя источника данных и JNDI.
Примечание:
Имя источника данных и имя JNDI должны совпадать. Однако имя JNDI должно начинаться с jdbc/. Например, вы можете ввести atoll_spdb_sdsu в качестве имени источника данных и jdbc/atoll_spdb_sdsu в качестве имени JNDI.
- Вы можете задать псевдонимы безопасности или принять значения по умолчанию на странице Настройка псевдонимов безопасности (Setup security aliases), а затем нажмите кнопку Далее (Next).
- Щелкните Далее (Next).
- Нажмите Создать нового поставщика JDBC.
- Щелкните Далее (Next).
- Выберите DB2 из ниспадающего списка Тип базы данных (Database Type).
- Выберите DB2 с использованием драйвера IBM JCC (DB2 Using IBM JCC Driver) в качестве параметра Тип поставщика (Provider Type).
- Выберите Источник данных пула подключений (Connection pool data source) в качестве параметра Тип реализации (Implementation type).
- Укажите имя и описание поставщика DB2 JDBC и нажмите кнопку Далее (Next).
- Введите путь и имя JAR-файла DB2, чтобы установить переменную $DB2_JCC_DRIVER_PATH в WebSphere.
- Если вы задали переменную $DB2_JCC_DRIVER_NATIVEPATH WebSphere, Путь к собственной библиотеке (Native library path) можно оставить пустым.
- Щелкните Далее (Next).
- Выберите версию драйвера JDBC DB2 в раскрывающемся списке Значение (Value) для параметра Тип драйвера (Driver type).
- Введите имя базы данных, используемой как источник данных, в текстовом поле Имя базы данных (Database name).
- Введите имя сервера, на котором установлена СУБД DB2, в поле Имя сервера (Server name).
- Введите номер порта, по которому осуществляется взаимодействие с базой данных, в поле Номер порта (Port number).
- Отметьте опцию Использовать этот источник данных в CMP (Use this data source in container managed persistence (CMP)).
- Щелкните Далее (Next).
- Вы можете задать псевдонимы безопасности или принять значения по умолчанию на странице Настройка псевдонимов безопасности (Setup security aliases), а затем нажмите кнопку Далее (Next).
- Проверьте краткое описание вашего источника данных и нажмите Готово (Finish).
Список источников данных можно увидеть на консоли WebSphere Administration Console.
Установка пользовательских свойств
Большинство свойств источника данных устанавливаются при его создании. Однако необходимо установить имя пользователя и свойства источника данных на странице Пользовательские свойства (Custom properties) в консоли администрирования WebSphere.
В списке источника данных в консоли администрирования WebSphere откройте созданный источник данных, затем откройте страницу Пользовательские свойства (Custom properties), чтобы определить свойства источника данных.
- Щелкните источник данных, чтобы его открыть.
- В Дополнительные свойства (Additional Properties) щелкните Пользовательские свойства (Custom properties).
Откроется страница Пользовательские свойства (Custom properties).
- Нажмите Создать (New) в Предпочтения (Preferences).
Откроется закладка Конфигурация (Configuration).
- Введите user в текстовое поле Имя (Name) и имя пользователя базы данных, которое будет использоваться для подключения базы данных, в текстовое поле Значение (Value).
- Нажмите OK в закладке Конфигурация (Configuration), чтобы создать свойство.
- Выполните те же шаги чтобы создать пользовательское свойство для пароля пользователя. Введите password в текстовое поле Имя (Name) и пароль пользователя базы данных в текстовое поле Значение (Value).
- Выполните те же шаги чтобы создать пользовательское свойство для перенаправления корневого каталога контекста URI. Введите com.ibm.ws.webcontainer.redirectcontextroot в текстовое поле Имя (Name) и введите true в текстовое поле Значение (Value).
Oracle
Используйте консоль администрирования WebSphere для создания источника данных Oracle, поставщика JDBC и настройки свойств источника данных.
Создание источника данных и поставщика JDBC
Далее описываются действия по созданию источника данных Oracle и поставщика JDBC в консоли администрирования WebSphere.
- Выполните вход в IBM WebSphere Administration Console в качестве пользователя-администратора.
- Откройте JDBC в Ресурсы (Resources) и выберите Источники данных (Data sources).
- Щелкните Создать (New), чтобы создать новый источник данных.
Откроется страница Создать источник данных (Create Data Source).
- Введите имя источника данных и JNDI.
Примечание:
Имя источника данных и имя JNDI должны совпадать. Однако имя JNDI должно начинаться с jdbc/. Например, вы можете ввести porcupine_osid_pubu в качестве имени источника данных и jdbc/porcupine_osid_pubu в качестве имени JNDI.
- Щелкните Далее (Next).
- Нажмите Создать нового поставщика JDBC.
- Щелкните Далее (Next).
- В ниспадающем списке Тип базы данных (Database Type) выберите Oracle.
- Выберите Драйвер Oracle JDBC (Oracle JDBC Driver) в списке Тип поставщика (Provider type).
- Выберите Источник данных пула подключений (Connection pool data source) в списке Тип реализации (Implementation type).
- Укажите имя и описание поставщика JDBC и нажмите кнопку Далее (Next).
- Введите путь и имя JDBC-драйвера Oracle, чтобы установить переменную $ORACLE_JDBC_DRIVER_PATH в WebSphere.
- Щелкните Далее (Next).
- Выберите Вспомогательный класс хранилища данных Oracle11g (Oracle11g data store helper) в списке Имя вспомогательного класса хранилища данных (Data store helper class name).
- Отметьте опцию Использовать этот источник данных в CMP (Use this data source in container managed persistence (CMP)).
- Щелкните Далее (Next).
- Вы можете задать псевдонимы безопасности или принять значения по умолчанию на странице Настройка псевдонимов безопасности (Setup security aliases), а затем нажмите кнопку Далее (Next).
- Проверьте краткое описание вашего источника данных и нажмите Готово (Finish).
Список источников данных можно увидеть на консоли WebSphere Administration Console.
Установка пользовательских свойств
Большинство свойств источника данных устанавливаются при его создании. Однако необходимо установить имя пользователя и свойства источника данных на странице Пользовательские свойства (Custom properties) в консоли администрирования WebSphere.
В списке источника данных в консоли администрирования WebSphere откройте созданный источник данных, затем откройте страницу Пользовательские свойства (Custom properties), чтобы определить свойства источника данных.
- Щелкните источник данных, чтобы его открыть.
- В Дополнительные свойства (Additional Properties) щелкните Пользовательские свойства (Custom properties).
Откроется страница Пользовательские свойства (Custom properties).
- Нажмите Создать (New) в Предпочтения (Preferences).
Откроется закладка Конфигурация (Configuration).
- Введите user в текстовое поле Имя (Name) и имя пользователя базы данных, которое будет использоваться для подключения базы данных, в текстовое поле Значение (Value).
- Нажмите OK в закладке Конфигурация (Configuration), чтобы создать свойство.
- Выполните те же шаги чтобы создать пользовательское свойство для пароля пользователя. Введите password в текстовое поле Имя (Name) и пароль пользователя базы данных в текстовое поле Значение (Value).
- Выполните те же шаги чтобы создать пользовательское свойство для перенаправления корневого каталога контекста URI. Введите com.ibm.ws.webcontainer.redirectcontextroot в текстовое поле Имя (Name) и введите true в текстовое поле Значение (Value).
PostgreSQL
Драйвер PostgreSQL JDBC не является сертифицированным драйвером в WebSphere. Поэтому необходимо настроить заданный пользователем поставщик JDBC при настройке источника данных, чтобы он указывал на базу данных PostgreSQL.
Установка переменной среды драйвера JDBC
Сначала задайте переменную среды драйвера JDBC.
- Выполните вход в IBM WebSphere Administration Console в качестве пользователя-администратора.
- Откройте Среда (Environment) > Переменные Websphere (Websphere Variables) и найдите переменную User-defined_JDBC_DRIVER_PATH.
- Задайте для переменной User-defined_JDBC_DRIVER_PATH значение WAS_INSTALL_ROOT/lib.
Создание источника данных и поставщика JDBC
Затем создайте новый источник данных и определите поставщик JDBC.
- Откройте JDBC в Ресурсы (Resources) и выберите Источники данных (Data sources).
- Щелкните Создать (New), чтобы создать новый источник данных.
Откроется страница Создать источник данных (Create Data Source).
- Введите имя источника данных и JNDI.
Примечание:
Имя источника данных и имя JNDI должны совпадать. Однако имя JNDI должно начинаться с jdbc/. Например, вы можете ввести laverne_pgdb_lri2 в качестве имени источника данных и jdbc/laverne_pgdb_lri2 в качестве имени JNDI.
- Щелкните Далее (Next).
- Нажмите Создать нового поставщика JDBC.
- Щелкните Далее (Next).
- В ниспадающем списке Определенный пользователем (User-defined) выберите Тип базы данных (Database Type).
- Введите org.postgresql.ds.PGConnectionPoolDataSource в поле Имя класса реализации (Implementation class name).
- Укажите имя и описание определенного пользователем поставщика JDBC и нажмите кнопку Далее (Next).
- Введите путь и имя JAR-файла PostgreSQL на сервере WebSphere и нажмите кнопку Далее (Next).
- Введите имя вспомогательного класса хранилища данных.
- Поставьте отметку Использовать этот источник данных в CMP (Use this data source in container managed persistence (CMP)) и нажмите Далее (Next).
- Вы можете задать псевдонимы безопасности или принять значения по умолчанию на странице Настройка псевдонимов безопасности (Setup security aliases), а затем нажмите кнопку Далее (Next).
- Проверьте краткое описание вашего источника данных и нажмите Готово (Finish).
Список источников данных можно увидеть на консоли WebSphere Administration Console.
Установка пользовательских свойств
Вы создали заданный пользователем поставщик JDBC для источника данных PostgreSQL, после этого ряд свойств нужно установить вручную. Сделайте это на странице Пользовательские свойства (Custom properties) в консоли администрирования WebSphere.
В списке источника данных в консоли администрирования WebSphere откройте созданный источник данных, затем откройте страницу Пользовательские свойства (Custom properties), чтобы определить свойства источника данных.
- Щелкните источник данных, чтобы его открыть.
- В Дополнительные свойства (Additional Properties) щелкните Пользовательские свойства (Custom properties).
Откроется страница Пользовательские свойства (Custom properties).
- Нажмите Создать (New) в Предпочтения (Preferences).
Откроется закладка Конфигурация (Configuration).
- Укажите значения для следующих свойств конфигурации:
Имя (Name)
Значение
databaseName
<имя базы данных PostgreSQL, используемое для источника данных>
serverName
<имя сервера, на котором установлен кластер баз данных PostgreSQL>
portNumber
<порт, по которому осуществляется взаимодействие кластера баз данных PostgreSQL>
пользователь
<имя роли входа для подключения>
пароль
<пароль для роли входа>
com.ibm.ws.webcontainer.redirectcontextroot
true
- Нажмите кнопку ОК на закладке Конфигурация (Configuration), чтобы определить свойства.