Update MT DMS (Install Release/Patch)

Last modified: 10 months ago

В статье описан порядок установки

Релиза – обновление версии MT DMS;

Патча (или фикса) - исправление к Релизу.

«Жизненный цикл» Релиза

Release Private («приватный») – самое актуальное по дате выпуска обновление. Функционал не проверен. Выпускается каждые 2 недели.

Release Candidate («кандидат») – проверенное обновление. Содержит исправления, выпущенные с даты выхода «приватного» релиза, по результатам тестирования функционала. Из нескольких «кандидатов», выпущенных за месяц, наиболее стабильный перепаковывается и перемещается в Release, другие – перемещаются в Archive.

Release – максимально проверенное обновление. Содержит исправления по выявленным ошибкам. Из нескольких Release, выпущенных за квартал, один (первый за квартал) перемещается в Quarter, другие – перемещаются в Archive.

Release Quarter («квартальный») – ежеквартальный релиз. Один из релизов (обычно первый), выпущенный за квартал.

Archive («архивный») – архив обновлений.

Информация о выходе нового «приватного» релиза (Release Private), а также о перегруппировке обновлений (Release Candidate, Release, Release Quarter, Archive) и сборке новых «фиксов» (патчей) публикуется в Telegram-канале «MT DMS (VERDI) - DevNote»

Ссылка на Telegram-канал: MT DMS (VERDI) - DevNote

Описания Релизов доступны в базе знаний «Релизы MT DMS»

Доступ к Релизам, Патчам и файлам описания

Собранные релизы MT DMS, с файлами описаний доработок, вошедших в релиз, патчами (фиксами) и файлами описания фиксов (исправлений Релиза) размещаются на FTP-сервере: ftp://ftp.verdi.ru

Доступ к FTP-серверу предоставляется по запросу на support@verdi.ru

Релизы, патчи и файлы описаний хранятся на FTP в соответствующих подкаталогах папки UpdatesMT (ftp://ftp.verdi.ru/UpdatesMT):

Release_Private

Release_Candidate

Release

Release_Quarter

Archive

Файлы с описаниями Релизов MT DMS и описание доработок по Модулям MT также хранятся в Базе знаний «Релизы MT DMS»

Установка Релиза

Определить действующую версию МТ

(какой релиз установлен на рабочей БД)

Открыть рабочую Базу данных МТ DMS.

На верхней панели инструментов нажать → «О программе».

В правой части открывшегося окна нажать

В предпоследнем столбце открывшегося списка установленных Модулей МТ выбрать самую раннюю дату - она соответствует дате выхода установленного Релиза. Другие (более поздние) даты соответствуют датам выхода установленных Патчей (фиксов) к соответствующим Модулям МТ.

Выбрать релиз к установке

Зайти на FTP-сервер по адресу ftp://ftp.verdi.ru/UpdatesMT

Пройти авторизацию (при отсутствии данных для авторизации см. «Доступ к Релизам, Патчам и файлам описания»).

Актуальные версии дистрибутива для обновления МТ хранятся в соответствующих подкаталогах папки UpdatesMT (ftp://ftp.verdi.ru/UpdatesMT):

В подкаталогах папки UpdatesMT (ftp://ftp.verdi.ru/UpdatesMT) выбрать папку релиза к установке.

Если с даты выхода используемого на рабочей БД релиза до даты выхода релиза, который требуется установить, прошло более 3-х месяцев (более 1-го квартала):

перед установкой нового Релиза следует последовательно установить все пропущенные версии КВАРТАЛЬНЫХ релизов (хранятся в папке Release_Quarter), и только после этого установить нужную версию релиза MT DMS

Информация о Дате выпуска Релиза содержится в его Номере: YYYYMMDD

где YYYY – год, MM – месяц, DD – день.

При наличии исправлений (по выявленным ошибкам) к названию релиза добавляется «_Fixed».

Квартальные релизы хранятся в папке Release_Quarter. В названии указывается год и квартал: Q1, Q2, Q3, Q4.

Внутри каждого релизного каталога находятся два подкаталога и один файл с описанием изменений:

MT - содержит обновление для локальной базы МТ.

MTCenter - содержит обновление для центральной базы МТ (используется, если в списке установленных Модулей рабочей Базы данных МТ DMS есть «Центральная БД (MTWSSyncLocal.dll)»).

Описание релиза DD-MM-YYYY.txt - файл с описанием изменений, выпущенных Релизом, по сравнению с предыдущей версией MT DMS.

Внутри каталогов МТ/МТCenter могут находиться следующие файлы:

MTYYYYMMDD.7z - основной архив с обновлением, где YYYY – год, MM – месяц, DD – день;

%MODULENAME%.dll.gz или %MODULENAME%.7z - архив с исправлением (фиксом), где %MODULENAME% - название модуля;

fixinfo.txt - файл с информацией (дата выпуска, название архива, краткая информация об изменениях) о фиксах к указанному релизу.

Файл fixinfo.txt может содержать три вида отметок:

^^^^^^^^^^^^^^^^^ INCLUDED IN CANDIDATE^^^^^^^^^^^^^^^^^^^^

- отметка, выше которой указаны все патчи (фиксы), включенные в архив YYYYMMDD.7z в ходе закрытого тестирования;

^^^^^^^^^^^^^^^^^ INCLUDED IN RELEASE^^^^^^^^^^^^^^^^^^^^^^

- отметка, выше которой указаны все патчи (фиксы), включенные в архив YYYYMMDD.7z в ходе свободного тестирования;

^^^^^^^^^^^^^^^^^ INCLUDED IN RELEASE QURATER ^^^^^^^^^^^^^^^^^^^^

- отметка, выше которой указаны все дополнительные патчи (фиксы), включенные в архив YYYYMMDD.7z по итогам всестороннего тестирования (закрытого и свободного).

При закрытии «Задачи на доработку модуля MT DMS» инициатору доработки по эл.почте направляется информационное письмо с указанием НОМЕРА Релиза MT DMS, в который вошел новый функционал.

Для внедрения нового функционала MT DMS требуется установка соответствующего Релиза.

Отслеживайте в Telegram- канале «MT DMS (VERDI) - DevNote» информацию выходе новых Релизов, изменении их статусов (Private, Candidate, Release, Quarter) и сборке новых «фиксов»

Ссылка на Telegram-канал: MT DMS (VERDI) - DevNote

Создать резервную копию рабочей Базы данных МТ DMS

Перед установкой нового Релиза создайте резервную копию рабочей Базы данных MT DMS средствами MS SQL или средствами МТ

Порядок создания резервной копии Базы данных средствами МТ описан в статье «Создать резервную копию БД / Восстановить БД из резервной копии»

Подготовка к установке выбранного Релиза

Зайти на FTP-сервер по адресу ftp://ftp.verdi.ru/UpdatesMT

Пройти авторизацию (при отсутствии данных для авторизации см. «Доступ к Релизам, Патчам и файлам описания»).

В папке UpdatesMT (ftp://ftp.verdi.ru/UpdatesMT) найти и скачать папку с выбранным к установке Релизом.

Подготовка к обновлению Локальной БД

Основной релизный архив MTYYYYMMDD.7z из папки МТ распаковать во временный каталог.

При наличии в папке МТ архивов фиксов

%MODULENAME%.gz (*.7z, *.zip, *.rar), где %MODULENAME% - название Модуля МТ

распаковать их во временный каталог (с подтверждением замены файлов):

dll - в папку Client,

xml - в папку Update

Подготовка к обновлению Центральной БД

Архив MTCenterYYYYMMDD.7z из папки МТCenter распаковать во временный каталог.

Релиз готов к установке.

Установить выбранный Релиз

Перед установкой нового Релиза на рабочую Базу данных:

установите его на тестовую Базу,

убедитесь в корректности установки и работы Релиза на тестовой Базе,

и только после этого установите Релиз на рабочую Базу

Последовательность действий при установке Релиза:

Запланировать остановку системы

Остановить Службы МТ

Остановить Сервер IIS/пулы приложений МТ

Ограничить сетевой доступ к каталогу с текущим Релизом

Обновить файлы текущей версии МТ

Обновить MTAdmin

Обновить установленные Модули МТ

Переустановить Модуль МТ

Вернуть сетевой доступ к каталогу с обновленным Релизом

Запустить Службы МТ

Запустить Сервер/пулы приложений МТ

Отменить запланированное отключение системы (по необходимости)

Проверить работоспособность установленной версии МТ

Запланировать остановку системы

Открыть программу MTAdmin.

Перейти в раздел «Администрирование → Текущие подключения».

В открывшемся окне «Текущие подключения» нажать на верхней панели инструментов (или «Ctrl+D» на клавиатуре).

Заполнить поля в окне «Предупредить об отключении системы»:

«Остановка»

Указать время отключения системы.

«Длительность»

Указать количество минут, которое программа будет отключена (минимальное рекомендуемое значение – 15 минут).

Сохранить настройки нажатием

Все авторизованные в системе пользователи получат сообщение о запланированной остановке системы.

Закрыть программу MTAdmin.

В назначенное время произойдет автоматическое закрытие МТ на ПК Пользователей.

Запуск программы будет недоступен до окончания указанного в оповещении времени

Остановить Службы МТ

(если они запущены)

Службы МТ:

MTSvc - служба локальной БД (может быть запущено несколько служб, по количеству локальных/тестовых Баз)

MTWSSyncsvc - служба центральной БД

При планировании остановки системы через MTAdmin запущенные Службы МТ будут остановлены автоматически, при наступлении запланированного времени остановки системы (в окне «Предупредить об остановке системы» окно «Остановка»)

Открыть «Пуск → Средства администрирования Windows → Службы».

Последовательно остановить все запущенные службы МТ.

Остановить Сервер IIS или пулы приложений МТ

(если используются IIS-приложения МТ)

В «Диспетчере служб IIS» остановить весь сервер или пулы приложений МТ.

Ограничить сетевой доступ пользователям к каталогу с текущим установленным Релизом МТ

Отключить общий доступ к папке Client в каталоге текущего установленного Релиза МТ.

Обновить файлы текущей версии МТ

Файлы подготовленного к установке Релиза переместить (с заменой) из временного каталога в каталог текущего установленного Релиза.

Корректный вариант переноса: последовательно перезаписать папки Client, Server, Update.

Обновить MTAdmin

Открыть программу MTAdmin.

В случае изменения структуры ядра МТ, произойдет автоматическое обновление MTAdmin, окно программы будет закрыто.

MT DMS имеет модульную структуру, поэтому обновление системы производится через обновление установленных Модулей МТ

Обновить установленные Модули МТ

Запустить MTAdmin.

Перейти в раздел «Конфигурация» → выбрать действие «Обновить установленные модули».

Нажать в окне подтверждения.

Система проведет автоматическую проверка файловой структуры. При выявлении расхождений (сравнение с эталонной файловой структурой) выведет информационное окно со списком проблемных файлов и описанием проблемы:

Проблему «не найден» следует проигнорировать.

Проблему «несоответствия версии» файла необходимо исправить: повторно скопируйте (с заменой) файл из временного каталога новой версии Релиза в каталог текущей версии Релиза.

При повторном возникновении ошибки обратитесь в техподдержку: support@verdi.ru

При нажатии начнется обновление Модулей МТ.

По завершении обновления система выведет информационное окно: напротив названий успешно обновленных Модулей МТ проставляется «ОК».

Нажать (в левом нижнем углу окна) для просмотра списка объектов (Справочники, Параметры, Отчеты и т.д.), добавленных в процессе текущего обновления Базы данных.

Нажать в окне «Обновить установленные модули».

Закрыть программу MTAdmin.

Переустановить Модуль МТ

В некоторых случаях при обновлении МТ может потребоваться переустановка того или иного Модуля.

Переустановка Модуля НЕ ТРЕБУЕТ его удаления. Для сохранения информации (в Базе данных) Модуль устанавливается заново, «поверх» ранее установленного.

При использовании в MTAdmin действия «Удалить модуль» в Базе данных автоматически удаляются все записи из гридов удаленного Модуля

Открыть программу MTAdmin.

Раздел «Конфигурация» → выбрать действие «Установить модуль».

Выбрать файл установки Модуля (хранятся в папке Client).

Система проинформирует о завершении установки Модуля.

Модуль МТ переустановлен.

Вернуть сетевой доступ пользователям к каталогу с обновленным Релизом МТ

Настроить общий доступ на «чтение» к папке Client в каталоге установленного Релиза МТ.

Запустить Службы МТ

Службы МТ:

MTSvc - служба локальной БД (количество запущенных служб должно соответствовать количеству локальных/тестовых Баз)

MTWSSyncsvc - служба центральной БД

Открыть «Пуск → Средства администрирования Windows → Службы».

Последовательно запустить все остановленные службы МТ.

Запустить Сервер или пулы приложений МТ

(если используются IIS-приложения МТ)

В «Диспетчере служб IIS» запустить сервер или пулы приложений МТ.

Отменить запланированное отключение системы

(если обновление МТ завершено ранее, чем было указано в оповещении Пользователям)

Открыть программу MTAdmin.

Перейти в раздел «Администрирование → Текущие подключения».

В открывшемся окне «Текущие подключения» нажать на верхней панели инструментов (или «Ctrl+Z» на клавиатуре).

Подтвердить действие нажатием

Закрыть программу MTAdmin.

Проверить работоспособность установленной версии МТ

Минимальный рекомендуемый объем тестирования:

Зайти в БД через сетевую папку с учетными данными пользователя (не sa).

Через Проводник открыть несколько Разделов МТ, находящихся в «ветках» установленных/обновленных/переустановленных Модулей MT DMS*.

идеально – пройтись по всем установленным Модулям МТ (). Рекомендована проверка не менее 2-х Разделов () из Модуля.

В разделах основных Модулей МТ (Автосалон, MTWorkshop, Бухгалтерия/Финансы) открыть любой Документ** и проверить отсутствие ошибок при переключении между его рабочими вкладками.

** идеально – проверить по одному Документу каждого вида (Заказ-наряд, Сделка, Заказ на автомобили и т.п.).

Список Видов документов Модулей МТ Автосалон, MTWorkshop, Бухгалтерия/Финансы содержится в файле «Виды документов основных модулей МТ».

Установка Патча (фикса к Релизу)

Исправления ошибок, выявленных в ходе закрытого и открытого тестирования функционала МТ в новых Релизах, выпускаются в виде Патчей (фиксов).

Информация о выходе нового Патча (фикса), с указанием

Релиза, к которому он выпущен,

перечня исправлений,

публикуется в Telegram-канале «MT DMS (VERDI) - DevNote»

Выявленные ошибки Релиза устраняются установкой соответствующего Патча (фикса) и переустановкой соответствующего Модуля МТ, но не требуют обновления МТ

Ссылка на Telegram-канал: MT DMS (VERDI) - DevNote

Отслеживайте в Telegram-канале «MT DMS (VERDI) - DevNote» информацию о сборке новых «фиксов» к установленному у Вас Релизу.

Создать резервную копию рабочей Базы данных МТ DMS

Перед установкой Патча (фикса к Релизу) рекомендуется создать резервную копию рабочей Базы данных MTDMS средствами MS SQL или средствами МТ

Подготовка к установке Патча (фикса к Релизу)

Зайти на FTP-сервер по адресу ftp://ftp.verdi.ru/UpdatesMT

Пройти авторизацию (при отсутствии данных для авторизации см. «Доступ к Релизам, Патчам и файлам описания»).

В папке UpdatesMT (ftp://ftp.verdi.ru/UpdatesMT) найти папку с Релизом (Релизы распределены по вложенным каталогам, в соответствии со статусом: Private, Candidate, Release, Quarter), фикс к которому требуется установить.

Подготовка к установке фикса Релиза Локальной БД

Открыть

папку Релиза (YYYYMMDD или YYYYMMDD_Fixed) → папку МТ

где YYYY – год, MM – месяц, DD – день сборки релиза.

Распаковать во временный каталог архивы фиксов Релиза ЛБ

%MODULENAME%.gz (*.7z, *.zip, *.rar), где %MODULENAME% - название Модуля МТ

Подготовка к установке фикса Релиза Центральной БД

Открыть

папку Релиза (YYYYMMDD или YYYYMMDD_Fixed) → папку МТCenter

где YYYY – год, MM – месяц, DD – день сборки релиза.

Распаковать во временный каталог архивы фиксов Релиза ЦБ

%MODULENAME%.gz (*.7z, *.zip, *.rar), где %MODULENAME% - название Модуля МТ

Патч (фикс к Релизу) готов к установке.

Установить Патч

Перед установкой Патча убедитесь, что установленная версия МТ соответствует Релизу, к которому выпущен фикс

См. «Определить действующую версию МТ»

Последовательность действий при установке Патча (фикса к Релизу):

Запланировать остановку системы

Остановить Службы МТ

Остановить Сервер/пулы приложений МТ

Ограничить сетевой доступ к каталогу с текущим Релизом

Сохранить (с заменой) файлы Фикса в соответствующие папки текущей версии МТ

Обновить MTAdmin

Переустановить измененный Модуль

Вернуть сетевой доступ к каталогу с обновленным Релизом

Запустить Службы МТ

Запустить Сервер/пулы приложений МТ

Отменить запланированное отключение системы (по необходимости)

Протестировать функционал, исправленный Патчем