Oracle WebLogic 10.3 и 12
Для настройки распределения памяти на сервере необходимо зайти в корневой каталог домена (по умолчанию \user_projects\domains\)\bin, открыть файл setDomainEnv.cmd и увеличить количество памяти WL. Для этого в файл необходимо добавить строку:
set MEM_ARGS= -Xms768m -Xmx1500m set MEM_PERM_SIZE= -XX:PermSize=256m
set MEM_MAX_PERM_SIZE= -XX:MaxPermSize=256m
set JAVA_PROPERTIES=-Dfile.encoding=UTF8
Tomcat 7
Для настройки распределения памяти на сервере необходимо зайти в поддиректорию bin директории, в которую установлен сервер приложений, открыть файл catalina.bat на изменение. В нем перед строкой @REM Execute Java with the applicable properties Добавить строку: set JAVA_OPTS=-Xmx1024m -XX:+CMSClassUnloadingEnabled -XX:+CMSPermGenSweepingEnabled -XX:MaxPermSize=256m -Dfile.encoding=UTF8
Настройка выделения памяти JVM для сервиса генерации отчётов
Для корректной и производительной работы сервиса генерации отчётов ReportWS необходимо размещать сервис ReportWS в отдельном профиле сервера приложений, либо выделять профилю, где установлен данный сервис больше памяти, при этом во избежание постоянного перераспределения памяти между сервисами необходимо устанавливать максимальный и минимальный размер «кучи» одинаковыми, например: -Xmn=512m -Xmx=512m
Настройка источников данных JNDI
Для использования источника данных JNDI, необходимо зарегистрировать источник на сервере приложений.
IBM WebSphere Community Edition 2.1 Запустите браузер и откройте в нем административную консоль сервера. Формы административной консоли зачастую содержат важные данные, поэтому для их защиты используйте соединение SSL. Обычно URL административной консоли выглядит следующим образом:
http://host:port/console
где
http: Протокол запроса. Поддерживается http или https. Для защиты важных данных, передаваемых между браузером и сервером, используйте https.
host: Имя хоста, на котором запущен целевой сервер. Зачастую в качестве имени хоста можно указать localhost, если сервер расположен в той же системе, что и браузер.
port: Порт, на который сервер принимает запросы, поступающие по указанному протоколу. Изначально сервер прослушивает порт 8080 для запросов http и порт 8443 для запросов https, но настройки вашего сервера могут отличаться. Например, следующий URL позволяет обратиться к административной консоли локального хоста по соединению SSL.
https://localhost:8443/console
На странице входа в систему войдите в web-консоль, указав имя и пароль пользователя, имеющего права доступа для работы с административной консолью. По умолчанию используется имя пользователя system и пароль manager.
На странице административной консоли найдите опцию Навигация консоли и в категории Службы выберите Пулы баз данных.
В рабочем поле, на который мы перешли, можно создать новый пул базы данных, а также изменить или удалить существующий пул базы данных.
Добавление источника данных состоит из нескольких этапов. . На этапе 1: "Введение основной информации об источнике данных" следует заполнить следующие поля (обратить внимание на Name of Database Pool):
На следующем этапе вводим параметры JDBC: класс драйвера JDBC, имя пользователя, пароль, URL JDBC, хост, сид и порт базы. Нажимаем NEXT.
На последнем шаге работы с мастером разработчик окончательно формирует нужный URL (URL формируется на основе ранее введенных данных, но здесь его можно изменить) и задает параметры – минимальный (0 по умолчанию) и максимальный (10 по умолчанию) размер пула, время ожидания (в мсек, 5000 по умолчанию) до возбуждения исключения в случае, когда пользователь запрашивает соединение, но свободных соединений в пуле нет, и время ожидания (в минутах, 15 по умолчанию) до удаления из пула неиспользуемого соединения и уменьшения его текущего размера.
Проверяем коннект и убеждаемся, что соединение настроено верно:
Скопировать дистрибутивы всех платформенных и продуктовых сервисов. Для каждого продуктового и платформенного сервиса (кроме richclientproxy, webclient и timer) выполнить следующие действия: открыть файл сервиса (*.war) с помощью менеджера архивов (например winrar), в каталоге WEB-INF править файлы web.xml и geronimo-web.xml ниже описанным способом.
Править web.xml в *.war, а именно добавить блок (res-ref-name равен Pool name созданного соединения):
jdbc/auditws
javax.sql.DataSource
Container
Shareable
Править geronimo-web.xml в *.war, а именно добавить блок (подставить в тэги Pool name созданного соединения):
jdbc/auditws
jdbc/auditws
и
console.dbpool
jdbc_auditws
В конфиге сервиса (например auditws-config.xml) добавляем настройку (вместо jdbc/auditws подставить Pool name созданного соединения):
java:comp/env/jdbc/auditws
Задеплоить модифицированные сервисы на сервер приложений (с удалением старых сервисов).
Выполнить рестарт сервера приложений.
IBM WebSphere Application Server 7.0 и 8.5
Для подключения к источнику данных JNDI необходимо выполнить следующие действия:
Удостовериться, что БД создана и доступна с сервера, где развёрнуто решение.
Создать alias аутентификации
Создать Комплекс связи JDBC (JDBC provider)
Создать Источник данных.
Проверить соединение с источником данных
Настроить конфигурационные файлы сервисов и обновить лицензию.
Ниже каждый из пунктов будет рассмотрен более подробно.
Проверка БД (создана и доступна с сервера, где развёрнуто решение)
Проверить соединение можно с помощью любой СУБД – подключиться к БД и выполнить любой простой запрос. Этот шаг необязательный, важно знать, что БД доступна.
Создание aliasа аутентификации
2.1. Войти в консоль Администрирования (в строке браузера ввести URL: http:// <имя сервера (или localhost)>:<порт>/ibm/console. Логин/пароль: system/manager)
2.2. В меню слева выбрать «Защита» – «Глобальная защита»
2.2. Раскрыть список «Служба идентификации и проверки прав доступа Java» и выбрать «Идентификационные данные J2С»
2.3. Нажать «Создать»
2.4. Ввести Псевдоним – имя alias, ИД Пользователя – имя пользователя БД, Пароль – пароль пользователя БД
2.5. Нажать ОК
2.6. Нажать «Сохранить» 2.7. alias готов
Создание комплекса связи JDBC (JDBC provider).
3.1. Войти в меню Ресурсы -> JDBC выбрать Комплексы связи JDBC
3.2. Выбрать Область. Узел=<Название узла>, Сервер=<Название сервера > 3.3. Нажать «Создать»
3.4. Этап 1. Выбрать тип БД – выбрать тип БД, который планируется использовать (к БД какого типа создаётся подключение). В данном руководстве рассматривается подключение к MS SQL Server 2008, соответственно в типе БД необходимо выбрать SQL Server. Далее выбрать из выпадающего списка Тип комплекса связи и Тип реализации. Нажать «Далее».
3.5. Этап 2. Путь к классам. На данном этапе необходимо указать путь к классам БД. А) Скачать с официального сайта последнюю версию требуемого драйвера (имя драйвера указано под цифрой 1 на рисунке, для каждого типа БД - своё)
Б) Подложить драйвер в папку %Папка сферы%\AppServer\java\jre\lib
В) Указать полный путь к драйверу в соответствующих полях (цифры 2 и 3 на рисунке)
| Примечание. На данном этапе имя используемого драйвера невозможно отредактировать. Отредактировать его можно будет после создания комплекса связи.
|
Для сферы IBM WAS 7.0.0.19, работающей на java 1.6, предлагаемый по-умолчанию драйвер для работы с MS SQL не подходит (похожая проблема может быть и при использовании БД другого типа, решается по аналогии с описанным ниже примером), поэтому необходимо подложить не sqljdbc.jar, а драйвер jtds.jar. 3.6. Нажать «Далее» 3.7. Этап 3. Проверить правильность заполнения всех полей и нажать «Готово»
3.8. Созданный провайдер появится в списке Комплексов связи JDBC
3.8. Сохранить сделанные изменения.
3.9. Комплекс связи JDBC готов.
| Примечание. Для изменения имени драйвера (поле Путь к классам (или Class path в англ. локали) на рисунке ниже) необходимо кликнуть по имени созданного Комплекса связи JDBC и отредактировать поле «Путь к классам», указав имя используемого драйвера (например, изменить sqljdbc.jar на jtds.jar), изменить значение используемого имени класса реализации (для jtds это net.sourceforge.jtds.jdbcx.JtdsDataSource ). Нажать ОК и сохранить сделанные изменения.
|
| Примечание. Новый драйвер начнет работу только после перезапуска сферы.
|
| Примечание. Все локальные переменные (например, MICROSOFT_JDBC_DRIVER_PATH) можно отредактировать в соответствующем меню Среда -> Переменные WebSphere
|
Создание источника данных
4.1. Раскрыть меню Ресурсы->JDBC в дереве навигации (слева) и выбрать Источники данных
4.2. Выбрать Область, см. п. 3.2
4.3. Нажать «Создать»
4.4. Этап 1. Ввести Имя источника данных (желательно, чтобы имя ассоциировалось с именем БД на которую указывает источник) и Имя JNDI в формате jdbc/< имя источника данных> (это имя будет использоваться при настройке файлов конфигурации сервисов). 4.5. Этап 2. Выбрать комплекс связи JDBC. Из выпадающего списка выбрать созданный в п.3 Комплекс связи JDBC.
4.6. Этап 3. Введите конкретные свойства БД для источника данных. Заполнить необходимые поля. Имя БД – имя БД, к которой осуществляется коннект. Номер порта – номер порта БД, к которой осуществляется коннект. Имя сервера – имя сервера, на котором находится БД. Нажать «Далее».
4.7. Этап 4. Настройте псевдонимы защиты. В выпадающем списке Псевдоним идентификации, управляемой компонентом выбрать alias, созданный в п.2. В выпадающем списке Псевдоним идентификации, управляемой контейнером выбрать alias, созданный в п.2. Нажать «Далее».
4.8. Этап 5. Обзор. Проверить правильность введённых данных. Нажать «Готово».
4.9. Сохранить изменения.
Проверка соединения с источником данных.
5.1. Перезагрузить сферу. (Необходимо для того, чтобы «подтянулся» новый драйвер).
5.2. После перезапуска войти в консоль администрирования, в меню Ресурсы->JDBC выбрать Источники данных.
5.3. Выделить созданный в п.4 источник данных (цифра 1 на сл. рисунке). Нажать «Проверить соединение» (цифра 2 на рисунке). Должно появиться сообщение об успешной проверке соединения (цифра 3 на рисунке)
| Примечание. При проверке соединения могут появиться предупреждения:
|
| , они не повлияют на работу источника данных.
|
Настройка конфигурационных файлов сервисов и обновление лицензии. 6.1. В конфигурационных файлах, в которых указывается путь к базе данных (*-config.xml), вместо тэгов
dataSourceUrl> путь к БД
логин к БД
пароль к БД
надо указать
ИМЯ_JNDI_из_пункта_4
6.2. Обновить лицензию. Подробно порядок обновления лицензии описан в документации к платформе, FLEXTERA - BFG Userguide.docx.
| Примечание. Для корректной работы BFG должна быть установлена версия платформы 7.01.01-SP15-HF2
|
| Примечание. Для настройки работы адаптера к ГИС ГМП с источником данных JNDI, необходимо обновить его до версии ftgmpadtws-4.03.03-HF3 или более поздней
|
Oracle WebLogic 10.3 и 12
Настройка источников данных JNDI для версий 10.3 и 12 имеют схожий механизм. Ниже описан процесс настройки на примере версии Oracle WebLogic 10.3
Осуществить переход по дереву настроек "Services/JDBC/Data Sources". В рабочей области отобразится форма с таблицей источников данных (рис. 7.2.3.1).
Рис. 7.2.3.1. Консоль администратора Oracle WebLogic. Закладка "Источники данных". Список JDBC-источников данных.
Для регистрации нового источника БД следует щелкнуть по кнопке "New" ( рис. 7.2.3.1).
На экране появится форма добавления нового источника данных (рис. 7.2.3.2). Рис. 7.2.3.2. Добавление источника данных
Добавление источника данных состоит из нескольких этапов:
На этапе 1: "Введение основной информации об источнике данных" следует заполнить следующие поля (рис. 7.2.3.2):
Имя источника данных (Name)— ввести имя ресурса, например, "JNDIDataSource";
Имя JNDI (JNDI Name)— ввести имя JNDI источника данных "jdbc/JNDIDataSource";
Тип базы данных (Database Type)— выбрать из выпадающего списка тип базы данных;
Драйвер базы данных (Database Driver)— выбрать из выпадающего списка подходящий драйвер для базы данных; И нажать кнопку "Next". На 2 этапе: "Выбор опций выполнения запросов к базе данных" следует выбрать интересующие опции: (рис. 7.2.3.3).
Рис. 7.2.3.3. Выбор способа выполнения запросов к базе данных. И нажать кнопку "Next".
На этапе 3: "Опции подключения к базе данных" следует заполнить следующие поля (рис. 7.2.3.4): (рис. 7.2.3.4) Опции подключения к базе данных. Имя базы данных (Database Name)— ввести имя базы данных к которой будет выполняться подключение;
Имя сервера базы данных (Host Name)— ввести имя сервера;
Порт (Port)— ввести номер порта;
Имя пользователя базы данных (Database User Name)— ввести имя пользователя базы данных;
Пароль для подключения к базе данных (Password)— ввести пароль;
Подтверждение пароля для подключения к базе данных (Confirm Password)— подтвердить введенный пароль; И нажать кнопку "Next". На этапе 4: "Проверка подключения к базе данных" есть возможность проверить соединение с базой данных (рис. 7.2.3.5) для этого необходимо ввести SQL-запрос и нажать кнопку "Test Connection":
(рис. 7.2.3.5) Проверка соединения с базой данных. В случае успешного соединения вы увидите сообщение об успешном выполнении подключения к базе данных. По окончании проверки необходимо нажать кнопку "Finish".
|