Dynamics 365. Установка пакета обновления из командной строки

Ключевые понятия при установке обновления Dynamics 365:

1. Разворачиваемый пакет (Deployable package) – это единица разворачивания, которая может применяться в разных средах. Он может содержать исправления в виде бинарных файлов или runtime-компонентов AOS.
   
2. AxUpdateInstaller – это исполняемая программа, которая входит в разворачиваемый пакет.
   
3. Runbook – рабочая книга для разворачивания, представляет собой последовательность шагов. Он генерируется и используется для разворачивания пакета на целевые среды.
   

Установка пакета на приложение для разработки

Пакет содержит кастомизированные элементы и созданные расширения приложения. Для его установки в среду разработки или демо среду, необходимо выполнить ряд шагов:

1. Скачать zip-файл, содержащий пакет, на свою локальную (виртуальную) машину, например, из LCS. Файл должен хранится в папке, не привязанной к пользователю. После скачивания, необходимо зайти в свойства архива, и поставить крыжик «Разблокировать».
   
2. Извлечь содержимое архива.
   
3. Открыть командную строку и перейти в папку с извлеченным пакетом.
   
4. Выполнить команду:
   

   AXUpdateInstaller.exe devinstall
   

   devinstall – это опция установки, которая необходима для разворачивания пакета на локальной (виртуальной) машине. Начиная с platform update 12, опция не требует наличия прав администратора системы.
   

   Данная команда не выполняет синхронизацию базы данных, поэтому ее надо будет запустить отдельно из Visual Studio, после установки пакета.
   

Конфигурирование топологии пакета

Выполнить шаги 1 и 2 из предыдущего пункта.

В извлеченном архиве необходимо найти файл DefaultTopologyData.xml. В нем необходимо указать имя локальной (виртуальной) машины и устанавливаемые пакеты.

1. Чтобы узнать имя компьютера, необходимо посмотреть свойства системы.
   
2. Найти узел в файле и переписать имя компьютера на верное.
   
3. Чтобы указать устанавливаемые компоненты, необходимо:
   
   1. Открыть командную строку и перейти в папку с извлеченным пакетом.
      
   2. Посмотреть список всех устанавливаемых компонентов командой
      

      AXUpdateInstaller.exe list
      

   3. Обновить файл, если необходимо.
      

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

4. Данные шаги необходимо выполнять для каждого системы.

Генерирования runbook из топологии

Основываясь на информации о топологии из DefaultTopologyData.xml, необходимо сгенерировать runbook файл, который будет предоставлять пошаговые инструкции для обновления каждой системы.

Для создания файла runbook, необходимо выполнить из командной строки:

AXUpdateInstaller.exe generate -runbookid=[runbookID] -topologyfile=[topologyFile]

-servicemodelfile=[serviceModelFile] -runbookfile=[runbookFile]

Параметры команды:

1. [runbookID] – параметр, указывается разработчиком, берется из разворачиваемого пакета.
   
2. [topologyFile] – путь к файлу DefaultTopologyData.xml.
   
3. [serviceModelFile] – путь к файлу DefaultServiceModelData.xml, располагается рядом с файлом DefaultTopologyData.xml.
   
4. [runbookFile] – имя создаваемого файла (например, AOSRunbook.xml).
   

Пример:

AXUpdateInstaller.exe generate -runbookid=»VAL200AA2BMEDIU-runbook» -topologyfile=»DefaultTopologyData.xml» -servicemodelfile=»DefaultServiceModelData.xml» -runbookfile=»VAL200AA2BMEDIU-runbook.xml»

Runbook предоставляет последовательность шагов, которые необходимо выполнить при обновлении среды. Пример runbook файла показан на изображении ниже. Каждый шаг ассоциируется с ID, именем компьютера и деталями выполнения.

Установка пакета

1. На первом компьютере, который указан в runbook файле, выполните следующие шаги:
   
   1. Запустите импорт runbook файла командой
      

      AXUpdateInstaller.exe import -runbookfile=[runbookFile]
      

      Пример:
      

      AXUpdateInstaller.exe import -runbookfile=»VAL200AA2BMEDIU-runbook.xml»
      

   2. Проверьте runbook файл
      

      AXUpdateInstaller.exe list
      

   3. Запустите выполнение инструкций runbook файла
      

      AXUpdateInstaller.exe execute -runbookid=[runbookID]
      

      Пример:
      

      AXUpdateInstaller.exe execute -runbookid=»VAL200AA2BMEDIU-runbook»
      

AXUpdateInstaller обновляет runbook файл после выполнения каждого шага. Также пишется лог о выполнении каждого шага.

Если шаги выполняются в ручную, то после завершения шага, необходимо выполнить команду:

AXUpdateInstaller.exe execute -runbookID=[runbookID] -setstepcomplete=[stepID]

Пример:

AXUpdateInstaller.exe execute -runbookid=»VAL200AA2BMEDIU-runbook» -setstepcomplete=2

1. Экспортирование runbook файла
   

AXUpdateInstaller.exe export -runbookid=[runbookID] -runbookfile=[runbookFile]

Пример:

AXUpdateInstaller.exe export -runbookid=»VAL200AA2BMEDIU-runbook» -runbookfile=»VAL200AA2BMEDIU-runbook.xml»

Проверка установки

1. Выполните в командной строке:
   

   AXUpdateInstaller.exe list
   

2. Откройте runbook файл и проверьте статусы каждого шага.
   

Резервирование runbook файла

После выполнения всех шагов и экспорта файла, сохраните его в резервной копии.

Это необходимо в случаях, когда:

1. Необходимо проанализировать время остановки рабочей среды для обновления.
   
2. Необходимо отправить файл в Microsoft, если установка пакета прошла с ошибками.
   

Решение проблем

1. Если какой-либо шаг завершился с ошибкой, можно запустить его еще раз на выполнение командой:
   

   AXUpdateInstaller.exe execute -runbookid=[runbookID] -rerunstep=[stepID]
   

2. Чтобы предотвратить повторную установку пакета, либо понижение версии, либо ее несоответствие, выполните команду:
   

   AXUpdateInstaller.exe execute -runbookid=[runbook ID] -versioncheck=true
   

3. Чтобы проверить синхронизацию базы данных, необходимо в папке aosservce\scripts\, найти и открыть файл dbsync.error.txt.

microsoft.com