Процесс обновления СЭД FossDoc

Для чего необходимо обновление FossDoc

Выпуск актуальной версии FossDoc включает в себя новые возможности системы, и исправление ошибок. Учитывая пожелания наших клиентов, мы добавляем в систему новые функции, а также устраняем недоработки.

Вы можете работать с любой версией FossDoc (например, с той, которая была установлена на момент приобретения продукта), но получить продукт с исправленными ошибками или новыми возможностями можно только путем обновления до последней версии.

Право на обновление

Бесплатно обновить FossDoc до последней (актуальной) версии могут:

• Пользователи бесплатной версии
• Пользователи, оплатившие услугу технической поддержки

Стратегия обновления сервера и клиента FossDoc

Перед обновлением FossDoc до последней версии:

• Загрузите с сайта дистрибутив бесплатной версии FossDoc. Распакуйте архив, и найдите файл лицензии License.xml) для данной версии ПО (в папке "FossDoc\Server\Solution"). Это бесплатная лицензия на 5 пользователей. Если открыть файл лицензии браузером, вы можете увидеть номер версии в элементе "Version". Сервер работает в строгой привязке к версии в лицензии, новая лицензия не может быть использована со старым сервером и наоборот. Коммерческая лицензия предоставляется по запросу для организаций, оплачивающих тех.поддержку.
• Сделайте резервную копию базы данных (и убедитесь, что можете ее восстановить на другой машине). Все данные FossDoc находятся в базе, и резервное копирование базы должно производиться регулярно. Если с обновлением ПО возникнут проблемы, вы сможете вернуться на предыдущую версию и восстановить базу из резервной копии.
• Продумайте стратегию обновления программного обеспечения рабочих мест пользователей (клиентов). Если вы используете версию FossDoc 5.6 или выше, клиент сам загружает обновление с серверной машины и в переустановке не нуждается. В этом случае достаточно просто обновить сервер. Если же используется более старая версия продукта, потребуется обновление ПО клиентских машин.
• Тестовая машина для испытаний: рекомендуется подготовить тестовый сервер для знакомства с обновлением. У вас будет достаточно времени, чтобы ознакомиться с новшествами и убедиться, что ваши бизнес-процессы работают без проблем на новой версии. Обновление версии часто затрагивает структуры документов, права доступа и многое другое. Не всегда есть возможность установить старую версию сервера на обновленную базу, и именно здесь вам может пригодиться резервная копия базы данных.

Процесс обновления сервера

Остановка службы сервера

Имя службы имеет вид "FD22 - FossDoc" (вместо FossDoc может быть имя вашего экземпляра сервера документооборота).

Остановите службу.

Резервирование (бекап) базы данных

Когда служба сервера остановлена, сделайте бекап базы данных. Если вы используете "встроенный" MySQL, то ваша база обычно находится в папке "C:\Program Files (x86)\FOSS\FossDoc Application server\Instances\FossDoc\data". Вам достаточно просто скопировать эту папку в другое место на диске. Вы можете установить на другой машине бесплатную версию, остановить службу сервера, и подменить папку data на вашу, чтобы смоделировать "обновление": после запуска службы сервер сам проведет необходимые изменения в базе и вы сможете проверить всю функциональность.

Если вы работатет на MS SQL Server (SQL Express), сделайте резервную копию базы его штатными средствами. Убедитесь, что вы можете "восстановить" его на другой машине (другом SQL Server).

Резерв базы необходим, если в ходе обновления возникнут какие-либо проблемы, а также вы можете проводить обновление с этим бекапом на другом тестовом сервере, чтобы не затрагивать рабочий процесс, и спокойно ознакомиться со всеми новшествами FossDoc.

Обновление лицензии

Если требуется обновить лицензию, то поместите файл License.xml в папку вашего экземпляра сервера до установки новой версии:

В папке Instances находятся экземпляры сервера, поэтому имя подпапки "FossDoc" может отличаться от имени папки у вас.

Запуск инсталляции новой версии сервера

Запустите "setup.exe" из дистрибутива, и следуйте инструкциям по установке необходимых компонентов.

В процессе инсталляции новая версия будет установлена поверх старой.

Запуск службы сервера

Когда процесс инсталляции сервера будет завершен, запустите службу сервера.

Проверка модулей сервера

Когда служба сервера была успешно запущена, и вы смогли подключиться к нему, проверьте состояние модулей сервера. Каждый из них должен быть запущен. В случае, если один или несколько модулей не запущены, остановите службу сервера, очистите логи. Запустите службу. Если проблема не будет решена, скопируйте логи в отдельную папку, запакуйте их в архив и отправьте нашей службе тех.поддержки.

Папка с логами сервера: "C:\Program Files\FOSS\FossDoc Application Server\Instances\FossDoc\Logs". Имя папки-экземпляра "FossDoc" у вас может быть другим.

Возможные проблемы и пути их устранения

Что делать, если при запуске службы сервера вы получили следующее сообщение:

Такое сообщение не обязательно означает, что вообще есть проблема: обновление на новую версию может занимать длительное время, так как сервер при первом старте может производить действия над объектами в системе, создает новые элементы, настраивает права доступа. Просто обратите внимание на статус службы: состояние "Запускается" говорит о том, что процесс идет, также в это время обычно занят процессор (его может использовать сервер баз данных и FossDoc).

Для большой базы процесс обновления может происходить в течении нескольких часов, в зависимости от мощности аппаратной части сервера.

Откройте файл Trace.log, и посмотрите последние строки в данном файле, чтобы примерно оценить причину. Критические ошибки (exception) могут подсказать вам о сути проблемы.

Пришлите данный лог файл в нашу службу технической поддержки, и мы поможем вам в максимально короткий срок.

Удаление и повторная установка сервера

В некоторых случаях, когда после обновления сервера не запускаются отдельные модули, можно попробовать удалить сервер и установить его заново. Во время удаления сервер приложений FossDoc вам будет предложено выбрать действие: