Установка WAR файла Project Kaiser

Установка WAR файла Project Kaiser

В данной статье описаны действия по установке WAR файла в сервер приложений tomcat. Инструкции по обновлению WAR файла описаны в другой статье.

К установке программы вручную следует прибегать в следующих случаях:

• Программа устанавливается не на ОС Windows;
• Программа устанавливается на уже работающий и/или настроенный сервер приложений.
  

При установке на ОС Windows по возможности следует воспользоваться автоматической установкой дистрибутива Win32, который включает в себя сервер приложений Tomcat и осуществляет инсталляцию и обновление программы в автоматическом режиме.

Файлы WAR (Web-archive) - это архивы содержащие веб-приложения, готовые для публикации на веб-сервера поддерживающие Java приложения, такие как Tomcat, JBOSS и другие. Ниже рассматривается пример установки Project Kaiser на сервер приложений Tomcat.

1. Установка веб-приложения на сервер Tomcat

Будем исходить из того, что Tomcat установлен и работает на порту 8080, то есть доступен с локальной машины по адресу "http://localhost:8080".

• Перейдите в каталог с установленным Tomcat (Например C:\Program Files\Apache Software Foundation\Tomcat 8.0)
• Создайте в каталоге "webapps" подкаталог "pk" (C:\Program Files\Apache Software Foundation\Tomcat 8.0\webapps\pk)
• Разархивируйте в этот каталог (любым архиватором поддерживающим zip) содержимое WAR файла и перезапустите сервис Tomcat.

Если возникли проблемы

В случае возникновения проблем с установленным веб-приложением (например, Tomcat не может стартовать приложение) найти причину можно обратившись к файлам журналов (т.н. log-файлы), которые располагаются в подкаталоге "logs" каталога tomcat. Помимо журналов, создаваемых сервером tomcat (catalina.log, jakarta-service.log,...) там содержатся журналы Project Kaiser: messages.pk.log и errors.pk.log. В случае возникновения ошибки в одном из журналов скорее всего будет информация о причине.

2. Создание базы данных Project Kaiser

После установки веб-приложения следует создать базу данных

1. Откройте в браузере "localhost:8080/pk/admin". Появится диалог создания базы данных.
   
2. Укажите параметры новой базы данных. Для создания базы данных с параметрами по-умолчанию достаточно указать каталог для расположения данных программы. Для продвинутых пользователей доступна кнопка "More...", которая открывает раздел подробных настроек БД.
   

Указанный каталог не должен существовать или должен быть пустым.

Как только база данных будет создана, откроется окно установки параметров сервера (см. ниже)

3. Установка параметров сервера

Данное окно позволяет настроить такие параметры сервера, как настройки сервера для отправки почты, адрес и название сервера, используемые в почтовой корреспонденции

В дальнейшем Вы можете использовать этот же путь (localhost:8080/pk/admin) для доступа к настройкам сервера, или для того чтобы обновить структуру базы данных после очередного обновления программы

Теперь Project Kaiser доступен по адресу "localhost:8080/pk".