- Table of contents
- Руководство по установке (обновлению)
Руководство по установке (обновлению)¶
Требования к системе¶
Аппаратные требования¶
- Процессор не является "узким местом" при функционировании системы. Даже 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. Прочитайте описания репозиториев.
На текущий момент доступна установка только комплекта приложений целиком. Раздельная, помодульная установка, "на подходе".
- Установка на сервер приложений
Для этого в Glassfish версии 2.1:
- Открывается консоль администрирования сервера, её адрес выглядит, как правило 'http://<имя_сервера>:4848/'. Используется аккаунт admin (если Вы не изменили пароль администратора, то это “adminadmin”)
- Выбирается пункт “Deploy Enterprise Application (.ear)”
- Указывается архив для загрузки на сервер (Packaged file to be uploaded to the server).
- Нажимается кнопка “OK”.
Первоначальная настройка¶
Собственно, установка закончена. Теперь нам надо (пункты 1-3 в описаны одном документе), после 4 пункта перегружаем сначала MySQL, затем GlassFish:
- Установить время жизни сессии GF (4 минуты)
- Создать листенер для GF
- Создать виртуальный сервер и "привязать" его к листенеру
- Начальные настройки для MySQL. В том числе:
- Установить максимальный размер пакета для MySQL.
- Привести имена таблиц к нижнему регистру
- Выполнить первоначальные настройки для Доцеро
- Имя администратора сервера приложений (как правило, admin).
- Пароль администратора сервера приложений (если не меняли, то adminadmin).
- Укажите DNS имя или IP адрес сервера БД MySQL, если он расположен на том же сервере оставьте localhost.
- Укажите порт сервера MySQL, если Вы его не меняли, то значение уже указано.
- Укажите имя администратора сервера MySQL (как правило, root).
- Укажите пароль администратора сервера MySQL.
- В поле настройка имени схемы и пользователя БД вы можете указать другое имя, это актуально, если Вы намерены запустить более чем один сайт «Доцеро». Имя пользователя, от имени которого работает система «Доцеро», всегда совпадает с именем схемы.
- Внимание!!! Действующее ограничение для версии 1.2.10.b5 включительно — 8 символов, начиная с 1.2.10 — 16 символов (ограничение MySQL)
- Если ошиблись и ввели больше, не расстраивайтесь, это легко исправить
- Измените DNS имя или IP адрес хоста приложения, в случае если сервер MySQL расположен на другом физическом сервере. Это имя используется для ограничения доступа пользователя “docero” к БД, таким образом, даже зная пароль пользователя проблематично получить доступ к БД с другого компьютера.
- Введите название вашей организации и имя сайта, эти наименования в последующем можно будет исправить.
- Нажмите кнопку “OK”.
Проверка корректности
В случае если процедура первичной настройки прошла успешно, Вы сможете зайти по адресу 'http://<имя_сервера>:<port>/'. используя для входа имя admin и пароль администратора сервера приложений (если не меняли, то adminadmin).В консоли администрирования сервера, её адрес выглядит, как правило 'http://<имя_сервера>:4848/' , Вы должны увидеть следующие изменения:
- В разделе “Applications”-“Lifecycle Modules” зарегистрирован модуль “doceroLifecycle”.
- В разделе “Resources”-“JDBC”-“Connection Pools” создан пул соединений “doceroMySQLpool”.
- В разделе “Resources”-“JDBC”-“JDBC Resources” зарегистрирован ресурс “jdbc/docero”.
- Останавливаем 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
Что теперь?¶
- Установка Google Tesseract-ocr - система распознавания текста.
- Возможно, Вы хотите установить дополнительные приложения.
- Посмотрите раздел, посвященный конфигурированию
- Теперь, возможно, стоит почитать о том, что делать дальше...
Установка обновлений¶
- Убедитесь, что сделаны резервные копии баз данных.
- Убедитесь, что у вас есть дистрибутив текущей версии (вдруг придется все вернуть назад).
- Вперед, производим обновление ПО