Инструкция по обновлению DIP 3.0

Note

Данная инструкция разработана для обновления Сервера DIP 3.0 на локальной машине и последующего тестирования системы.

Предварительные требования

  1. Ознакомьтесь с Принятыми соглашениями.
  2. Убедитесь, что развернутая версия платформы, которую собираетесь обновлять, работоспособна. Смотри раздел Контрольный список проверки работоспособности.
  3. Убедитесь, что у вас есть доступ к ресурсам сервера сборок ESB \\by01-fsrvcl01.topsoft.local\share\tfs\build\DIP\.
  4. Зафиксируйте в виде памятки номера сборок компонент платформы, которые собираетесь установить при обновлении. Они вам понадобятся при настройке программных пакетов и кофигурационных файлов.
Ресурс Описание
Сборки и файлы ресурсов для развертывания \\by01-fsrvcl01.topsoft.local\share\tfs\build\DIP\
Каталог установки DIP 3.0 D:\T2.DIP\
Warning

Установка ручная. Следуйте рекомендациям, описанным в настоящем руководстве.

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

1. Остановите работающие сервисы

Остановите и удалите работающие на момент обновления сервисы Сервера DIP 3.0:

2. Обновите локальные пакеты

Обновите компоненты ядра платформы в Локальная папка пакетов.

  • В папке с ресурсами сборки \\by01-fsrvcl01.topsoft.local\share\tfs\build\DIP\Core\ выберите нужную вам сборку для обновления.
  • Скопируйте ее содержимое в папку D:\T2.DIP\LocalPackages\ с заменой повторяющихся файлов, если они есть.

3. Обновите Сервер насройки

Обновите компоненты Сервера насройки

  • В папке с ресурсами сборки Сервера настройки \\by01-fsrvcl01.topsoft.local\share\tfs\build\DIP\Server\ выберите нужную вам сборку для обновления.
  • Скопируйте ее содержимое в папку D:\T2.DIP\Nginx\html\nomad\ с заменой повторяющихся файлов, если они есть.

4. Обновите адаптеры

Обновите Адаптеры, включенных в процесс интеграции.

  • Скопируйте в папку D:\T2.DIP\Nginx\html\nomad\ файлы новых версий адаптеров, соответственно из папок:
Описание Ресурс
\\by01-fsrvcl01.topsoft.local\share\tfs\build\DIP\Adapters\
для адаптера ERP \\by01-fsrvcl01.topsoft.local\share\tfs\build\DIP\Atlantis\
для адаптеров SPM, APM \\by01-fsrvcl01.topsoft.local\share\tfs\build\DIP\XAF\

5. Настройте конфигурационные файлы

Замените номер сборки в конфигурационном файле сервиса T2.DIP.ServerWebApi

  • Выберите файл по пути D:\T2.DIP\Cluster\nomad_files\T2DIPServerWebApi.nomad и откройте его для редактирования.
  • В секции group "T2DIP" > task "T2DIPServerWebApi" найдите параметр artifact, содежащий строку http://localhost:880/nomad/T2.DIP.Server.Web.Api
  • Замените в url номер сборки компонент на новый - номер сборки до которой вы обновляете платформу DIP 3.0.
artifact {
  source = "http://localhost:880/nomad/damon.exe.zip"
  #destination = "local/.."
}
artifact {
  source = "http://localhost:880/nomad/T2.DIP.Server.Web.Api-3.0.46-Beta-13734-develop.zip"
}
artifact {
  source = "http://localhost:880/nomad/$CustomConfig-T2.DIP.Server.Web.Api.zip"
}

	"artifact {
       source = "http://localhost:880/nomad/**T2.DIP.Server.Web.Api-3.0.31-Beta-12180-develop.zip**"
    }"

5.1 Обновите XUM.Web.Host

Note

Обычно при изменении версии Xafari

  • В папке с ресурсами сборки Xafari \\by01-fsrvcl01.topsoft.local\share\tfs\build\Ranet\Xafari\trunk_ESB\ выберите нужную вам сборку для обновления. `` По пути: D:\T2.DIP\Cluster\nomad_files\, в файле XUM_WebHost.nomad,заменить версию на ту, до которой необходимо обновить.
Warning

Если в новой сборке есть обновления адаптеров, либо система переведена на новую версию APM, SPM, ERP, то адаптеры собрать заново непосредственно на локальной машине. Подробности в разделе Сборка адаптера.

6. Обновление адаптеров

Обновление адаптеров рассмотрим на примере адаптера SPM. Остальные адаптеры обновляются по аналогии.

Note

Если не хватает пакетов .nupkg (ругается при сборке адаптеров), их нужно скачать на сайте https://www.nuget.org/packages

Для Spm.net синхронизировать файл T2.Dip.Starter.spmnet.exe.config с файлом из поставки D:\T2.DIP\Nginx\html\nomad\T2.DIP.Starter.SPM.Net-3.0.0-Beta-ХХХХХ-develop.zip за исключением первой секции с 9 по 38 строки

  1. В папке D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net\ создать специальную папку $Build.

  2. В папке D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net\$Build\ создать 2 папки: Source и Target.

Warning

Если ранее обновление уже производилось и данные папки существуют, то содержимое папок Source и Target нужно удалить. НЕ ПАПКИ, ТОЛЬКО СОДЕРЖИМОЕ!!!

  1. В папку D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net\$Build\Source\ скопировать содержимое архива T2.DIP.Starter.SPM.Net-3.0.0-Beta-12176-develop.zip (!!! последнюю, нужную вам версию!!!), из D:\T2.DIP\Nginx\html\nomad\.

  2. Если обновление производится первый раз, в папке: D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net\$CustomConfig-T2.DIP.Adapter.SPM.Net.Services\ создать папку Model.

  3. В файле StartInNomad.cmd, по пути D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net\$CustomConfig-T2.DIP.Adapter.SPM.Net.Services\Services\BusinessModelService\, в блоке кода: в секции group "T2DIP" > artifact > # zip with model dlls

добавить параметр в виде строки:

    echo        destination = "local/Model"

результат настройки должет быть таким:

    echo      artifact {
    echo        # zip with model dlls
    echo        source = "http://localhost:880/nomad/%ModelZipName%"
    echo        destination = "local/Model"
    echo      }"
  1. В папку "D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net$Build\Source" копировать содержимое папки: "D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net$CustomConfig-T2.DIP.Adapter.SPM.Net", а затем содержимое папки: "D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net$CustomConfig-T2.DIP.Adapter.SPM.Net.Services"
Warning

!!! Именно в этом порядке!!!

  1. Выполните сборку адаптера SPM в соответствии с той версией SPM, которая установлена на вашей машине и теми изменениями, что внесены в адаптер разработчиком DIP 3.0. Сборка запускается по команде __run_prepare.cmd. Для чего:
    1. Из папки D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net\$Build\Source\ в командной строке TotalComander запустить cmd
    2. В открывшемся окне
    • Нажать _ (нижнее подчеркивание)
    • Далее нажать Tab. В результате отобразится команда _run_prepare.cmd.
    • Далее нажать Enter

По команде выполняется сборка адаптера SPM:

  • в соответствии с той версией SPM, которая установлена на вашей машине
  • и c теми изменениями, что внесены в адаптер разработчиком DIP 3.0.
Warning

Проконтролируйте результат сборки на предмет ошибок (они будут выделены красным). Ошибок быть не должно. При их наличии обратитесь к разделу Ошибки сборки адаптера.

  1. По завершении п. 6.7 (если не будет ошибок с красным текстом) копировать содержимое папки: "D:\T2.DIP\Config\T2.DIP.Adapter.SPM.Net$Build\Source" в архив "D:\T2.DIP\Nginx\html\nomad\T2.DIP.Starter.SPM.Net.zip" с заменой файлов.

  2. Если в процессе выполнения п. 6.7 появляются сообщения об отсутствии пакетов необходимой версии, то по адресу: "https://ng.topsoft.by/" скачиваются необходимые пакеты и переносятся в папку "D:\T2.DIP\LocalPackages".

  3. Если п. 6.9 был актуален, то заново повторяются операции п.п. 6.2-6.9.

7. Install Cluster

В папке D:\T2.DIP\Cluster\ выполняется _installcluster.cmd.

8. Запуск системы

По порядку выполняется запуск системы "cmd" файлами из папки "D:\T2.DIP\Cluster".

Такие дела...

в номад файле xum.web.host там есть

env {
"DAMON_CPU_LIMIT" = "20000"
"ASPNETCORE_URLS" = "https://*:1111"
"ASPNETCORE_ENVIRONMENT" = "Development"
}

Development надо заменить на Production

Внешние пакеты TopSoft искать по ссылке https://ng.topsoft.by и https://nuget.topsoft.local

    <assemblyIdentity name="Microsoft.AspNetCore.Hosting.Abstractions" publicKeyToken="adb9793829ddae60" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-2.2.0.0" newVersion="2.2.0.0" />
  </dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
  <dependentAssembly>
    <assemblyIdentity name="Microsoft.AspNetCore.Http" publicKeyToken="adb9793829ddae60" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-2.2.2.0" newVersion="2.2.2.0" />
  </dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
  <dependentAssembly>
    <assemblyIdentity name="Microsoft.AspNetCore.Http.Abstractions" publicKeyToken="adb9793829ddae60" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-2.2.0.0" newVersion="2.2.0.0" />
  </dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
  <dependentAssembly>
    <assemblyIdentity name="Microsoft.AspNetCore.Http.Features" publicKeyToken="adb9793829ddae60" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-2.2.0.0" newVersion="2.2.0.0" />
  </dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
  <dependentAssembly>
    <assemblyIdentity name="Microsoft.AspNetCore.Routing.Abstractions" publicKeyToken="adb9793829ddae60" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-2.2.0.0" newVersion="2.2.0.0" />
  </dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
  <dependentAssembly>

Смотри также: