Санкт-Петербургский государственный университет информационных технологий, механики и оптики Кафедра “Компьютерные технологии” Book store house Руководство по установке Санкт-Петербург 2007 Оглавление Оглавление 2 Введение 3 1. Содержимое инсталляционного диска 3 2. Требования к компьютеру, на который устанавливается система 3 2.1. База данных 3 2.2. Сервер приложений 4 3. Установка системы на сервер приложений 4 3.1. Стандартная установка 4 3.2. “Быстрая” установка 7 4. Инициализация базы данных 7 2 Введение Приложение Book Store House представляет собой систему заказов для книжного склада. Руководство по установке содержит описание процесса установки данной системы. 1. Содержимое инсталляционного диска Инсталляционный диск приложения содержит: 1. Документацию: a. Install.doc – настоящий документ. Содержит описание процесса установки приложения; b. UserGuide.doc – руководство пользователя приложением. Содержит описание gui интерфейсов; c. DesignXC.doc – содержит архитектуры системы и особенностей ее реализации. 2. Файл приложения book-app.ear 3. Сервер приложений jboss-4.0.4.GA-Patch1-installer.jar 4. Сервер приложений jboss-quick.zip, сконфигурированный для работы с базой данных Oracle10g и содержащий приложение book-app.ear 2. Требования к компьютеру, на который устанавливается система Для работы системы необходим сервер приложений (JBoss) и база данных (Oracle10g). В основном требования к аппаратной части компьютера, на который устанавливается система, определяются требованиями базы данных, поскольку JBoss достаточно “легкий” сервер приложений. 2.1. База данных В качестве базы данных предполагается Oracle 10g. В действительности приложение Book Store House за счет использования технологии EJB3 может работать с любой базой данных, для которой определен соответствующий Dialect. Например, Oracle 9, 8, MS SQL 2005, MySQL, HSQLDB. 3 В базе данных должна быть учетная запись пользователя с правами на соединение и редактирование таблиц. Назовем ее jboss. 2.2. Сервер приложений В качестве сервера приложений предполагается JBoss 4.0.4.GA или любая другая версия JBoss, которая поддерживает EJB3. В сервере приложений должен быть добавлен источник данных OracleDS (процесс описан ниже), в котором настроено соединение с базой данных от имени упомянутой учетной записи jboss. 3. Установка системы на сервер приложений 3.1. Стандартная установка Для установки системы на сервер приложений необходимо: 1. Установить сервер приложений JBoss с поддержкой технологии EJB3. Для этого требуется выполнить java –jar jboss-4.0.4.GA-Patch1-installer.jar а затем, в соответствующем пункте меню выбрать ejb3 - рис. 2. 2. Стартовать базу данных Oracle 10g с учетной записью jboss. Убедится в том, что база данных готова к работе можно (Db_1\BIN\sqlplusw.exe) - рис. 1. Рис 1. Проверка готовности базы 4 запустив SQL Plus Рис 2. Процесс установки сервера приложений JBoss 3. Cкопировать файл book-app.ear в каталог deploy сервера приложений. 4. Скопировать jdbc драйвер Db_1\jdbc\lib\ojdbc14.jar в каталог lib сервера приложений. 5. Сконфигурировать сервер приложений для работы с базой данных – настроить источник данных OracleDS. Приведем ссылку на ресурс с описанием данного процесса: http://www.onjava.com/pub/a/onjava/2004/02/25/jbossjdbc.html 6. Включить поддержку русского языка, заменив строку set JAVA_OPTS=%JAVA_OPTS% -Dprogram.name=%PROGNAME% на set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=cp866 -Dprogram.name=%PROGNAME% в файле run.bat каталога bin сервера приложений. 5 7. Запустить сервер приложений, выполнить run.bat. Появившееся приложения должно выглядеть примерно как на рис 3. Рис 3. Консоль сервера приложений после старта 6 окно 3.2. “Быстрая” установка Предусмотрен вариант “быстрой” установки приложения. Для этого достаточно: 1. Стартовать базу данных Oracle 10g с учетной записью jboss 2. Распаковать архив jboss-quick.zip 3. Запустить файл jboss-quick/bin/run.bat Все! 4. Инициализация базы данных Для инициализации базы данных не требуется выполнять какие-либо SQL запросы. Таблицы базы данных будут созданы автоматически сервером приложений на основе классов, помеченных атрибутом @Entity. Список книг, изначально содержащихся в базе, автоматически загрузится при выполнении сервером приложений файла import.sql, находящегося в архиве приложения book-app.ear. 7