[ELMA3] Обновление системы ELMA3 на ELMA4
Чтобы обновить систему на ELMA4, выполните следующие шаги:
- Скачайте нужный дистрибутив из личного кабинета.
- Выполните резервное копирование базы данных и убедитесь в наличии актуальных резервных копий папок [Каталог установки ELMA]/UserConfig, [Каталог установки ELMA]/Web/bin, [Каталог установки ELMA]/Packages.
- Удалите текущую версию системы ELMA3.
- Установите нужную вам версию ELMA4 на чистую базу данных.
- Если были установлены какие-либо дополнительные модули, также установите их на чистую базу данных.
- Проверьте корректность запуска сервера на чистой базе данных со всеми установленными компонентами.
- Подключите прежнюю базу данных или восстановите её из резервной копии, сделанной до переустановки системы.
- В случае ошибок при запуске после восстановления можно попробовать подставить ранее сохранённые папки [Каталог установки ELMA]/Web/bin/, [Каталог установки ELMA]/Packages. Этот шаг можно пропустить, если ошибок нет.
- Замените содержимое папки UserConfig на содержимое из сохранённой копии этой папки. При необходимости откройте конфигурационный файл configuration.config в папке [Каталог установки ELMA]/UserConfig и пропишите в нём путь до базы данных.
- Запустите веб-сервер IIS, систему и дизайнер.
- Проверьте работоспособность функционала, который вы используете.
В целях снижения простоя рабочего сервера рекомендуется производить обновление сначала на тестовом сервере.
После обновления вы сможете работать с новым веб-дизайнером, который установится автоматически при запуске ELMA4.
Важные изменения
Платформа .Net Framework
В ELMA4 используется версия .NET Framework 4.8. С информацией о требованиях к системе можно ознакомиться на официальном сайте Microsoft.
При необходимости в процессе установки ELMA4 автоматически производится попытка загрузить требуемую версию .NET Framework. Если попытка была неуспешной, установите .NET Framework 4.8 самостоятельно.
При наличии собственных доработок системы следует учесть возможные отличия функционала системных библиотек. Прочитать об изменениях платформы можно в списке изменений.
Индексация и полнотекстовый поиск
В ELMA4 версия сервера Elasticsearch, используемая для полнотекстового поиска, повышена с 1.7.3 до 7.6.2. Вы можете использовать только эту версию, другие версии несовместимы с ELMA4.
Кроме того, для ELMA3 используется собственная урезанная сборка сервера Elasticsearch, которую можно скачать из личного кабинета. Подробнее об этом можно прочитать здесь. В ELMA4 используется полная версия сервера Elasticsearch. Вы можете скачать ее на официальном сайте Elastic.
После обновления ELMA и установки нового сервера Elasticsearch требуется настроить подключение к нему и произвести повторную индексацию. Подробнее о том, как это сделать, можно прочитать в справке по ELMA3.
Подробнее об установке и конфигурировании Elasticsearch читайте в этой статье и на официальном сайте Elastic.
Прекращение поддержки функционала
Прекращение поддержки БД FireBird
Поддержка базы данных FireBird прекращена.
Прекращение поддержки внутреннего сервера ELMA
Поддержка запуска ELMA на внутреннем сервере прекращена. При обновлении осуществляется попытка включить веб-сервере IIS и запустить ELMA4 на нем.
Когда вы обновляете систему ELMA3, которая развернута на внутреннем сервере, рекомендуется предварительно самостоятельно включить веб-сервер IIS, если он был отключен. Подробнее о работе с IIS можно прочитать в этом разделе.
Прекращение поддержки локального Дизайнера ELMA
В ELMA4 прекращается поддержка локального Дизайнера ELMA. Его функционал сохранен частично на переходный период. Упрощенная версия локального Дизайнера ELMA, как и раньше, загружается и обновляется при установке дистрибутива.
Новый веб-дизайнер устанавливается автоматически при запуске ELMA после обновления.
Прочее
Дополнительную информацию об изменениях можно получить в списке критичных изменений.
Обновление кодовой базы
Общая информация
В ELMA4 был изменен ряд публичных типов, и удален устаревший код. Перед обновлением ознакомьтесь с внесенными правками. Дополнительную информацию о возможных конфликтах можно получить при запуске установки на этапе проверки системных требований и в списке критичных изменений.
Обновление скриптов метаданных
Перед обновлением для скриптов справочников, документов, проектов требуется внести возможные для ELMA3 правки и переопубликовать их.
Если после обновления на ELMA4 при первом запуске будет обнаружено наличие несовместимого кода скриптов метаданных, ELMA будет запущена в ограниченном режиме.
Доступ к серверу будет иметь только администратор после того, как он введет специально сгенерированный ключ (кодовую фразу). Кодовая фраза расположена в текстовом файле. Путь этого файла указан в окне.

В этом режиме нужно исправить все несовместимые с ELMA4 скрипты и переопубликовать метаданные.
Рекомендуется предварительно запустить обновление на тестовом сервере, чтобы подготовить код скриптов. Это сократит время, в течение которого продуктовый сервер будет недоступен.
Обновление скриптов данных
Перед обновлением для скриптов процессов, отчетов и т. д. следует внести возможные для ELMA3 правки и переопубликовать их. После обновления нужно исправить все несовместимые с ELMA4 скрипты и переопубликовать объекты.
При работе с процессами обновления нужно производить для версий, экземпляры которых запущены и исполняются.
Рекомендуется предварительно запускать обновление на тестовом сервере, чтобы подготовить код скриптов. Это сократит время, в течение которого продуктовый сервер будет недоступен.
Обновление компонентов BPM Apps
При наличии BPM Apps, установленных из ELMA Store, требуется получить их новую версию из ELMA Store или через запрос на сайте технической поддержки ELMA. При наличии компонентов, разработанных самостоятельно, их требуется доработать и актуализировать для ELMA4 перед обновлением. Подробнее об этом читайте в статье «Обновление компонентов для перехода на ELMA4».
Обновление интерфейса
В ELMA4 произведен редизайн интерфейса. При наличии собственных разработок, в которых используются представления, требуется доработать их. Подробнее о редизайне можно прочитать в списке критичных изменений и в разделе «Описание компонентов пользовательского интерфейса и методов работы с ними в ELMA4».
Вы можете обновить систему самостоятельно или обратиться к специалистам ELMA в рамках заказной услуги. Мы можем осуществить обновление с ELMA3 на ELMA4 полностью или выполнить отдельные этапы перехода, например, написание сценариев. Если данная услуга вас заинтересует, обратитесь к вашему менеджеру или создайте запрос на сайте технической поддержки ELMA.