Руководство по установке (обновлению)

Требования к системе

Аппаратные требования

  • Процессор не является "узким местом" при функционировании системы. Даже Celeron-а будет достаточно.
  • Минимум 500MB оперативной памяти. Желательно >1 GB
  • 100 MB свободного места в разделе базы данных MySQL
  • 2 GB (это с запасом) - в разделе, куда поставится GlassFish

Зависимости ПО

Docero-pack MySQL jdk Glasshfish MySQL-connector-java
Текущая версия 5.X 1.6 2.X 5.X

Эксплуатировалось на MS Windows XP, Debian Linux (x86, amd64). Теоритически должо работать везде, где запустится связка GF+MySQL. Версия JDK Зависит от выбранной версии GF. До сих пор последние версии JDK+GF всегда работали :)

Мы проверяли инсталляцию (список не полон):
Docero-pack OS MySQL jdk1.6
1.2.10.8 Debian(wheezy) 5.5.31-0+wheezy1-log update31
1.2.10.3 Debian(wheezy) 5.5.30-1-log update31
1.2.10 Debian(Squeeze) 5.5.24-2-log update31
1.2.10.b1 WinXP(SP3) 5.0 update30
1.2.10.b1 Debian(Squeeze) 5.1.61-0+squeeze1 update31
1.2.10.b1 Debian(Squeeze) 5.5.24-2-log update31
1.2.8.2 WinXP(SP3) 5.0 update30
1.2.8.2 Debian(Squeeze) 5.1.61-0+squeeze1 update31
Docero-pack OS MySQL openjdk-6-jdk
1.2.11 Debian(wheezy) 5.5.31-0+wheezy1-log 6b27-1.12.6-1~deb7u1
1.2.10.8 Debian(wheezy) 5.5.31-0+wheezy1-log 6b27-1.12.6-1~deb7u1
1.2.10.b1 Debian(Squeeze) 5.5.24-2 1.6.0_24
1.2.10.b1 FreeBSD 8.3-RELEASE 5.5.21-log 1.6.0_30-b24

Замечания о доменном имени сервера

Если Вы планируете использовать Sun Java Access Manager Server, он будет очень кстати если в Вашей локальной сети рабочие станции входят в домен Windows, в этом случае может использоваться SPNEGO для прозрачной аутентификации пользователей. Единственная загвоздка — Sun Java Access Manager Server не понимает хостов в корневом домене. Таким образом если ваши сервера имеют в DNS имена myhost.myorg то работать это не будет, придётся поднимать ещё одну зону в которой он будет называться myhost.myorg.ru (или что-то типа того).

Установка

Несколько общих замечаний:
  • Можно установить пакет, "два в одном" — GlassFish и MySQL. Версии старые, но рабочие. http://java.sun.com/javaee/downloads/previous/index.jsp — выбираем вариант языка "English". Но JDK все равно придется устанавливать отдельно.
  • Краткое описания процесса инсталляции для:
    • Debian, писалось для lenny, работает и для squeeze. Сюда же — замечания к установке на Fedora.
    • FreeBSD — мы взяли 8.3, но, наверное, должно работать и на других.
    • Microsoft Windows XP — нашелся только такой дистрибутив...
    • Переустановка на Microsoft Windows XP — что делать, если инсталляция закончилась с ошибкой, или порушили все.
    • Бывает, что инсталлятор глючит или что-то в системе не так. Наши рекомендации — куда смотреть, что делать.
  • В этом документе запись <имя_сервера> означает DNS имя сервера, куда будет ставиться Доцеро, <port> — соответственно, выбранный Вами порт.

MySQL

По установке и первичной настройке MySQL существует достаточно много материала — пересказывать смысла нет. Только пара ссылок:
http://www.mysql.ru/docs/
http://www.mysql.ru/docs/instadm.html

JDK

Для работы необходимым и достаточным является JDK. http://java.sun.com/javase/downloads/index.jsp

GlassFish

https://glassfish.dev.java.net/downloads/v2.1.1-final.html или с нашего сервера http://dist.docero.org/soft/

Запускаем консоль администрирования сервера, её адрес выглядит, как правило 'http://<имя_сервера>:4848/'. Заходим админом - ( admin | adminadmin ). Настоятельно рекомендуем поменять пароль пользователя admin - раздел Application Server, закладка Administrator Password !!!

MySQL-connector

http://dev.mysql.com/downloads/connector/j/ - инсталляция, собственно, сводится к копированию в каталог, который есть в CLASSPATH .

Доцеро

  • Получение дистрибутива

Текущий дистрибутив системы «Доцеро» вы можете получить по адресу http://dist.docero.org/latest/docero.pack.ear . На этом же сервере доступны другие версии системы, ее компонентов, документации. Вы можете посмотреть описание структуры каталогов.
Важно:

Когда GlassFish устанавливает приложение, он использует имя архива как наименование приложения. То есть, установка, например docero.pack.123.ear повлияет на корректную работу LifeCycle - модуля. С этим связано и ограничение, что в одном домене GF можно установить только одну версию Доцеро.

Репозитории проекта доступны по адресу http://hg.docero.org/ , репозитории базируются на ПО Mercurial. Прочитайте описания репозиториев.
На текущий момент доступна установка только комплекта приложений целиком. Раздельная, помодульная установка, "на подходе".

  • Установка на сервер приложений
Полученный или скомпилированный самостоятельно, архив приложения docero.pack.ear необходимо установить на сервер приложений.
Для этого в Glassfish версии 2.1:
  1. Открывается консоль администрирования сервера, её адрес выглядит, как правило 'http://<имя_сервера>:4848/'. Используется аккаунт admin (если Вы не изменили пароль администратора, то это “adminadmin”)
  2. Выбирается пункт “Deploy Enterprise Application (.ear)”
  3. Указывается архив для загрузки на сервер (Packaged file to be uploaded to the server).
  4. Нажимается кнопка “OK”.

Первоначальная настройка

Собственно, установка закончена. Теперь нам надо (пункты 1-3 в описаны одном документе), после 4 пункта перегружаем сначала MySQL, затем GlassFish:

  1. Установить время жизни сессии GF (4 минуты)
  2. Создать листенер для GF
  3. Создать виртуальный сервер и "привязать" его к листенеру
  4. Начальные настройки для MySQL. В том числе:
    1. Установить максимальный размер пакета для MySQL.
    2. Привести имена таблиц к нижнему регистру
  5. Выполнить первоначальные настройки для Доцеро
Для выполнения первоначальных настроек необходимо в открывшейся по адресу 'http://<имя_сервера>:<port>/'. (или 'http://<имя_сервера>/', как сделали, в общем.) форме настроек, заполнить следующие поля:
  1. Имя администратора сервера приложений (как правило, admin).
  2. Пароль администратора сервера приложений (если не меняли, то adminadmin).
  3. Укажите DNS имя или IP адрес сервера БД MySQL, если он расположен на том же сервере оставьте localhost.
  4. Укажите порт сервера MySQL, если Вы его не меняли, то значение уже указано.
  5. Укажите имя администратора сервера MySQL (как правило, root).
  6. Укажите пароль администратора сервера MySQL.
  7. В поле настройка имени схемы и пользователя БД вы можете указать другое имя, это актуально, если Вы намерены запустить более чем один сайт «Доцеро». Имя пользователя, от имени которого работает система «Доцеро», всегда совпадает с именем схемы.
    1. Внимание!!! Действующее ограничение для версии 1.2.10.b5 включительно — 8 символов, начиная с 1.2.10 — 16 символов (ограничение MySQL)
    2. Если ошиблись и ввели больше, не расстраивайтесь, это легко исправить
  8. Измените DNS имя или IP адрес хоста приложения, в случае если сервер MySQL расположен на другом физическом сервере. Это имя используется для ограничения доступа пользователя “docero” к БД, таким образом, даже зная пароль пользователя проблематично получить доступ к БД с другого компьютера.
  9. Введите название вашей организации и имя сайта, эти наименования в последующем можно будет исправить.
  10. Нажмите кнопку “OK”.

Проверка корректности

В случае если процедура первичной настройки прошла успешно, Вы сможете зайти по адресу 'http://<имя_сервера>:<port>/'. используя для входа имя admin и пароль администратора сервера приложений (если не меняли, то adminadmin).
В консоли администрирования сервера, её адрес выглядит, как правило 'http://<имя_сервера>:4848/' , Вы должны увидеть следующие изменения:
  1. В разделе “Applications”-“Lifecycle Modules” зарегистрирован модуль “doceroLifecycle”.
  2. В разделе “Resources”-“JDBC”-“Connection Pools” создан пул соединений “doceroMySQLpool”.
  3. В разделе “Resources”-“JDBC”-“JDBC Resources” зарегистрирован ресурс “jdbc/docero”.
Необходимо перезапустить сервер Glassfish, поскольку модули “Lifecycle Modules” загружаются в момент загрузки сервера. В этот момент можно выставить максимальный размер документа (помните, устанавливали для MySQL) в файле docero.xml.
  • Останавливаем GF
  • Добавляем в файл <GF_корень_инсталляции>/domains/domain1/config/docero.xml параметр maxPostSize. Значение задается в байтах
    <entry key="maxPostSize">
    10485760
    </entry>
    
  • Запускаем GF

После перезагрузки сервера стоит ещё раз проверить возможность входа в портал, бывает так, что перечисленные, созданные автоматически, ресурсы и пулы соединений с БД нужно ещё раз, вручную, пересохранить.

Автозапуск

Заставить систему запускаться в момент загрузки сервера можно разными способами. Для Unix это, например, добавить строчку в файл /etc/rc.local

su - gf -c "asadmin start-domain domain1" 

Это, если мы запускаем GF от имени пользователя gf. Мы были бы благодарны, если бы кто-то написал скрипты и инструкцию по правильному запуску/останову. Чтоб работало:

  • конфигурирование через rcconf
  • запуск/останов/статус через service

Что теперь?

Установка обновлений

  • Убедитесь, что сделаны резервные копии баз данных.
  • Убедитесь, что у вас есть дистрибутив текущей версии (вдруг придется все вернуть назад).
  • Вперед, производим обновление ПО