Необходимо удалить информацию, которая дублирует информацию в документе "Инструкция по установке CBS-3plus v3.8".
Аннотация
По сравнению с документом "Инструкция по установке CBS-3plus v3.8" данный документ содержит информацию по настройке приложений.
Содержание
Требования к программной и аппаратной платформе
Серверная часть трехуровневой архитектуры представляет собой Java EE приложение для сервера приложений IBM WebSphere Community Edition. Минимальные требования к аппаратной и программной платформе определяются сервером приложений и могут быть найдены в документации от IBM - http://publib.boulder.ibm.com/wasce/V2.1.0/ru/system-requirements.html.
Установка IBM WebSphere Community Edition
Для установки и запуска необходимо следовать инструкции от IBM. Рекомендуется брать версию с 1.6 Java SDK.
Подготовка окружения и дистрибутива для запуска приложения трехуровневой архитектуры
Установка параметров соединения на сервере приложений
Для соединения с базой данных приложению трехуровневой архитектуры требуется настройка пула соединения с базой данных. Настройка происходит через консоль управления (http://localhost:8080/console):
- Добавление драйвера Oracle в репозиторий.
- Создание пула соединений.
Добавление драйвера Oracle в репозиторий
Заходим в пункт меню Services → Repository. В поле File выбираем файл драйвера (мы используем драйвер от 11 Oracle ojdbc6.jar). Group: colvir; Artifact: oracle; Version: 1.0; Type: jar. Нажимаем кнопку Install.
Создание пула соединений
Для создания пула соединений используется типы баз данных: «Oracle Local» и «Oracle XA». Первый тип (Local) используется в обычном режиме, в котором мы сейчас работаем, когда транзакция фиксируется в одной базе данных. Тип XA нужен, если необходимо работать в режиме распределенных многофазных транзакций. В данный момент требуется настроить все пулы соединений (cbs, cbs3, cbs4) с типом Oracle Local.
Ниже приводится последовательность действий по настройке:
- Открываем консоль управления сервером http://localhost:8080/console.
- Заходим в пункт меню Services → Database Pools.
- Удаляем старый пул, если таковой имеется.
- Выбираем Create a new database pool: Using the Geronimo database pool wizard.
- В поле Name of Database Pool вводим имя пула.
- Database Type выбираем Oracle Local.
- Нажимаем Next.
- В поле Driver JAR находим и выбираем colvir/oracle/1.0/jar.
- Заполняем поля User Name, Password, Confirm Password.
- В поле Driver Type вводим thin.
- В поле TNS Entry Name вводим (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP) (Host = 1.1.1.100)(Port = 1521))(CONNECT_DATA = (SID = cbs40))), заменяя Host, Port и SID на требуемые (в данном случае инстация cbs40).
- Нажимаем Deploy.
- Проверяем правильность настройки пула, исполняя команды в окне Run Sql выбрав новый пул в поле Use DataSource.
В некоторых версиях wasce (например, 2.1.1.6) требуется указывать URL. Для этого в данном поле необходимо указать jdbc:oracle:thin:@{Host}:{Port}:{SID}, заменяя Host, Port и SID на требуемые (в данном примере: Host = 1.1.1.100, Port = 1521, SID = cbs40).
Для работы с приложением cbs, необходимо наличие пула с именем cbs. Параметры его настройки аналогичны параметрам пула cbs4.
Для работы с приложением CBS-3plus, необходимо наличие пула с именем cbs3. Параметры его настройки:
- TNS Entry Name = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP) (Host = 1.1.1.40)(Port = 1521))(CONNECT_DATA = (SID = hgdev)));
- userName/password: colvir/colvir.
В случае, если требуется работа с другими базами данных, может потребоваться настройка дополнительных пулов для этих баз данных.
Настройка кодировки
Для правильного преобразования символов не латинского алфавита, полученных в GET-запросе следует указать кодировку UTF-8, при помощи которой сервер будет декодировать полученную строку. Для этого необходимо зайти в консоль управления (http://localhost:8080/console) и перейти в раздел Server→WebServer, там выбрать нужный коннектор (обычно это TomcatWebConnector) и перейти по ссылке «Edit». Найти параметр под названием «uriEncoding» и прописать для него значение UTF-8 (регистр имеет значение), далее нажать кнопку «Save». Для вступления изменений в силу необходимо вернуться к списку коннекторов и выполнить действие «Restart» для соответствующего коннектора.
Было обнаружено, что из задачи «Измененные объекты системы» export объектов может выполняться, создавая файлы в кодировке ANSI. В процессе работы над устранением проблемы выяснилось, что за это отвечает параметр file.encoding сервера приложений: если он равен UTF-8, то все работает нормально. Если он имеет другое значение (например, cp1251), то файлы будут формироваться не в юникоде. Поэтому для корректного экспорта объектов из этой задачи необходимо, чтобы параметр file.encoding был равен UTF-8.
Проверить это можно, открыв в консоли веб-сервера пункт "Java System Info" и найдя там этот параметр. Если он имеет некорректное значение, следует установить его принудительно. Для этого в файл \IBM\WebSphere\AppServerCommunityEdition\bin\setjavaenv.bat в конце необходимо прописать: set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8.
Также немаловажно, чтобы сервер запускался с помощью startup.bat (start-sever.bat, как выяснилось, этот параметр не прописывает).
И еще один момент насчет кодировок: для корректной работы необходимо указать кодировку UTF-8.
Настройка приложений
Настройка всех приложений Colvir, запущенных на сервере происходит через общий файл конфигурации.
Путь к файлу конфигурации должен быть задан через переменную окружения COLVIR_SETTINGS. Эту переменную можно указать в файле ...\IBM\WebSphere\AppServerCommunityEdition\bin\setjavaenv.bat. Например, если файл называется settings.xml и находится в корне диска C:, то в setjavaenv.bat необходимо добавить:
set JAVA_OPTS=%JAVA_OPTS% -DCOLVIR_SETTINGS="C:/settings.xml"
Настройка очистки кэша
Для настройки очистки кэша по уведомлению необходимо описать параметры соединения с СУБД в виде подсекции параметра oracle_notifier в общем файле конфигурации. Файл должен содержать имя очереди сообщений (параметр name), URL-адрес СУБД (параметр url), имя пользователя БД и пароль (параметры login и password). Указанный пользователь должен иметь соответствующие права для доступа к заданной очереди сообщений. Пример файла конфигурации с секцией для настройки уведомлений:
Если возникает необходимость остановить обработку очереди, необходимо установить параметр disable равным "true":
<property key="disable" value="true"/>
Настройка таймаута
Для настройки таймаутов для сессии в целом и для отдельных запросов необходимо указать значения параметров session и query соответственно в виде подсекции параметра timeout в общем файле конфигурации. Пример секции timeout для настройки таймаутов:
Для настройки таймаутов для сессии в целом и для отдельных запросов необходимо указать значения параметров session и query соответственно в виде подсекции параметра timeout в общем файле конфигурации. Пример секции timeout для настройки таймаутов:
Таким образом, таймаут сессии равен 30 минут, таймаут запроса равен 5 секунд.
Настройка хоста
В файл /etc/hosts добавить строку: 127.0.0.1 service.colvir.ru
Запуск приложения трехуровневой архитектуры
Запуск приложения происходит через разворачивание (deployment) подготовленных на предыдущем шаге war файлов. WebSphere допускает множество способов такого разворачивания. Один из самых простых доступен через консоль управления ({+}http://localhost:8080/console+).
В консоли необходимо в подменю Applications выбрать пункт Deploy new. На экране появится диалог загрузки приложения. В поле Archive необходимо выбрать необходимый war файл. Поле Plan оставляем пустым. Оставляем признак Start app after install. Если это повторное разворачивание (т.е. на сервере уже запущено приложение трехуровневой архитектуры), то ставим признак Redeploy application.
Нажимаем кнопку «Install». Через некоторое время сверху появится либо зеленая надпись с сообщением о успешном разворачивании, либо - красная с протоколом ошибки.
Проверить, что приложение запустилось, можно перейдя по адресу {+}http://localhost:8080/appName/Json+, где appName − имя приложения.
В случае правильной установки будет получен ответ {"r":null}.
Также, развертывание приложения можно производить копируя war-файл в директорию deploy сервера приложений. За успехом операции разворачивания можно следить по сообщениям сервера приложений в логе.
Комментариев нет:
Отправить комментарий