Deploy — различия между версиями
Материал из archestra.info
(→Последовательность deploy объектов SP2014R2) |
Vasily (обсуждение | вклад) (→Проблема - после деплоя платформа не появляется в Platform Manager.) |
||
(не показано 18 промежуточных версии 2 участников) | |||
Строка 61: | Строка 61: | ||
**Информацию о версии сборки (build) | **Информацию о версии сборки (build) | ||
**Состояние при локальном или удаленном развертывании | **Состояние при локальном или удаленном развертывании | ||
+ | |||
+ | *Регистрирует [[Platform Engine]] <ref>Platform Engine - процесс [[aaEngine]] относящийся к [[WinPlatform]]</ref> на удаленном узле | ||
+ | *Стартует [[Platform Engine]] | ||
+ | *Получает и отправляет состояние удаленной [[Platform]] | ||
== aaPIM == | == aaPIM == | ||
Строка 72: | Строка 76: | ||
*Вызывает Framework для извлечения файлов из '''wwPlatform.aaPKG''' | *Вызывает Framework для извлечения файлов из '''wwPlatform.aaPKG''' | ||
*Создает экземпляр FileCopyService.dll и передает для удаленной платформы информацию об экземпляре | *Создает экземпляр FileCopyService.dll и передает для удаленной платформы информацию об экземпляре | ||
− | *Запускает Runtime | + | *Запускает развертывание Runtime файлов |
===== FileCopyService.dll ===== | ===== FileCopyService.dll ===== | ||
*Добавляет [[ArchestrA User Account]] информацию в поток | *Добавляет [[ArchestrA User Account]] информацию в поток | ||
Строка 88: | Строка 92: | ||
===== FileCopyService.dll ===== | ===== FileCopyService.dll ===== | ||
− | *Сравнивает информацию об [[ | + | *Сравнивает информацию об [[ArchestrA User Account]], пароль с локальным паролем. Если данные не совпадают deploy прерывается с ошибкой |
*Конвертирует поток данных в оригинальные файлы/каталоги/прочее | *Конвертирует поток данных в оригинальные файлы/каталоги/прочее | ||
*Вызывает [[aaPim]] при запросе установки файлов | *Вызывает [[aaPim]] при запросе установки файлов | ||
Строка 116: | Строка 120: | ||
</references> | </references> | ||
+ | |||
+ | ==Ошибки при деплое== | ||
+ | |||
+ | ====Проблема - после деплоя платформа не появляется в Platform Manager.==== | ||
+ | |||
+ | '''Процесс:''' | ||
+ | |||
+ | При корректной работе, узел GR после деплоя отправляет PlatformMapping.xml файл на каждую платформу. В зависимости от роли узла (GR или другой) | ||
+ | *PlatformMapping файл расположен здесь: | ||
+ | ''для x86 ОС'' | ||
+ | **C:\Program Files\ArchestrA\Framework\Bin\GobalDataCache\PlatformMapping | ||
+ | **C:\Program Files\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\DistributionRepository\PlatformMapping | ||
+ | **C:\Program Files\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\Repository\PlatformMapping | ||
+ | ''для x64 ОС'' | ||
+ | **C:\Program Files (x86)\ArchestrA\Framework\Bin\GlobalDataCache\PlatformMapping | ||
+ | **C:\Program Files (x86)\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\DistributionRepository\PlatformMapping | ||
+ | **C:\Program Files (x86)\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\Repository\PlatformMapping | ||
+ | |||
+ | |||
+ | Основываясь на информации из файла PlatformMapping система делает записи в реестр каждой машины, в ветку: | ||
+ | |||
+ | ''для x86 OC'' | ||
+ | *HKEY_LOCAL_MACHINE\SOFTWARE\ArchestrA\Framework\Platform\PlatformNodes | ||
+ | ''для x64 ОС'' | ||
+ | *HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ArchestrA\Framework\Platform\PlatformNodes | ||
+ | |||
+ | Затем базовая служба WW – Bootstrap считывает эти данные и отображает в Platform manager. | ||
+ | |||
+ | '''При таких проблемах стоит проверить:''' | ||
+ | *Есть ли записи о платформе(ах) в реестре? | ||
+ | *Если нет, есть ли файл PlatformMapping.xml по пути указанному выше? | ||
+ | *Если нет, выполнить передеплой целевого узла, проверить, если результата нет - передеплой GR node. Происходит ли заполнение предыдущих пунктов? Если нет, у вас проблемы со связью и/или правами пользователей м/у узлами ( ArchestrA account, UAC, Simple File sharing и другие проверки нужно сделать см. Tech Note 461/876/482,478/589,517). | ||
+ | *Если не помогает и это – следует переустановить софт соблюдая все инструкции из ReadMe файла в дистрибутиве на ПО | ||
+ | |||
+ | ==== General Deployment Error ==== | ||
+ | |||
+ | Варианты решений: | ||
+ | *This problem got resolved after '''changing the Network Address''' of the AOS platform from '''host name''' to '''IP Address''' and then undeploy & redeploy of the platform. | ||
+ | *Add '''hosts file''' on all platforms in the galaxy | ||
+ | *'''Repair''' the installation from Programs & Features/Wonderware Application Server. If the repair does not resolve the issue, then '''uninstall and reinstall Wonderware Application Server'''. | ||
+ | |||
+ | ==== Failed to deploy <Platform_Name>: Access Denied, Invalid Credentials ==== | ||
+ | |||
+ | Решение: | ||
+ | *Для WSP 2017 Update 3 - Запросить у техподдержки и установить HF L00152139 на всех узлах куда деплоится платформа в том числе на узел GR, а HF L00152161 - только на узле GR. | ||
+ | |||
+ | ==== Failed to deploy RemotePlatformName : Remote Node's UserId/Password don't match GR Node's ==== | ||
+ | Описание: aaPim is removed from the Administrator group on System Platform 2017 Update 3 | ||
+ | |||
+ | Решение: | ||
+ | * See [https://softwaresupportsp.aveva.com/#/okmimarticle/docid/ta405 TA405]. '''aaPIM''' is the platform installation manager that is responsible for installing platforms. In previous versions aaPIM is launched on demand as a process with Adminintrator privilege. However, in System Platform 2017 Update 3, it is changed into a windows service and added to the Administrators group as a service account. It's important not to remove the NTService\aaPim account from the Administrators group unless you follow recommendations outlined in [https://softwaresupportsp.aveva.com/#/okmimarticle/docid/tn10297 TN10297] Managing Service Accounts with Group Policy for System Platform 2017 Update 3. Use exceptions in your IT Policies or Scripts to not delete the required Virtual Service Accounts or follow workaround recommendations outlined in TN10297. | ||
+ | |||
+ | ==== Информация о проблемах и решениях при деплое ==== | ||
+ | |||
+ | https://knowledge.insourcess.com/Wonderware_Application_Server/Tech_Notes/Common_platform_errors_during_deployment |
Текущая версия на 17:17, 4 декабря 2020
Deploy - развертывание приложения. Копирование файлов и настроек на целевой узел
Содержание
- 1 WWPackageServer
- 2 wwPackageManager.dll
- 3 WWFsObject
- 4 wwCdi.dll
- 5 PlatformCategory.dll
- 6 EngineCategory.dll
- 7 ApplicationCategory.dll
- 8 PlatformCategoryPackage.dll
- 9 aaBootstrap.exe
- 10 aaPIM
- 11 Последовательность deploy объектов SP2014R2
- 12 Последовательность deploy объектов AS 3.1
- 13 Примечания
- 14 Ошибки при деплое
- 14.1 Проблема - после деплоя платформа не появляется в Platform Manager.
- 14.2 General Deployment Error
- 14.3 Failed to deploy <Platform_Name>: Access Denied, Invalid Credentials
- 14.4 Failed to deploy RemotePlatformName : Remote Node's UserId/Password don't match GR Node's
- 14.5 Информация о проблемах и решениях при деплое
WWPackageServer
- WWPackageServer.dll
- Конфигурирует и определяет связи fsObjects и GR
- с GR взаимодействует посредством WWCdi.dll
- Безопасность через xxSecurity.dll
- Выполняет операции fsObject такие как check in/check out, deploy через fsObjects
- WWPackageServer и WWFsObject предоставляют информацию о Galaxy и account для компонентов развертывания
wwPackageManager.dll
- Используется IDE и GRAccess для взаимодействия с WWPackageServer
WWFsObject
- Запускает PlatformCategory.dll для локальной или удаленной платформы
- Используется для Deploy/Undeploy операций
- Выполняет примитивные операции, операции с атрибутами такие как "Добавить UDA"
- Выполняет gObject операции, такие как "Добавить Экземпляр"
- Проверяет разрешения
- Выполняет операции правки такие как Update/delete UDA
wwCdi.dll
- Выполняет stored procedure
- Обзор атрибутов связанных с операциями с БД
PlatformCategory.dll
- Проверяет связь с удаленным узлом
EngineCategory.dll
ApplicationCategory.dll
PlatformCategoryPackage.dll
- Получение информации о Galaxy
- Galaxy ID, Galaxy Name, Galaxy Version
- GR Host name, GR host IP адрес
- GR Platform ID
- Получение информации об удаленной Platform
- Platform ID, Name
- MxPort(5026), PMCPort (30000), SMCPort (30001)
- Получение локальной информации о сборке (build)
- Получение удаленной информации о сборке (build) - DCOM
- Сравнение версий GR и удаленного узла
- Получение данных реестра удаленного узла (GetRemoteRegister)
- Проверка задеплоина ли на удаленный узел Platform
- Регистрация ASB (RegisterASB)
- GetOSAdminAccountInfo - получение данных об ASBService account
- Запуск ASB Utility для регистрации ASB служб
- Получение информации по deploy
- primitive list
- Конфигурационные атрибуты
- Динамические атрибуты
aaBootstrap.exe
- см. Bootstrap
- Bootstrap - это основной сервис ArchestrA. Базовое программное обеспечение для развертывания платформы
- ОС Windows проверяет DCOM Security настройки для aaBootstrap.exe для разрешения:
- Аутенфикации
- Доступа
- Запуска
- Через канал DCOM aaBootstrap.exe возвращает GR Node (при deploy/undeploy)
- Информацию о версии сборки (build)
- Состояние при локальном или удаленном развертывании
- Регистрирует Platform Engine [1] на удаленном узле
- Стартует Platform Engine
- Получает и отправляет состояние удаленной Platform
aaPIM
- Компонент aaPIM (Platform Install Manager) отвечает за операции deploy, undeploy и редактирование ArchestrA объектов. PIM означает Платформа менеджер инсталляции.
- Tech Note 473 Troubleshooting Platform Install Manager (aaPIM) Errors
- см. aaPIM
Поведение при deploy
на GR Node
- Вызывает Framework для извлечения файлов из wwPlatform.aaPKG
- Создает экземпляр FileCopyService.dll и передает для удаленной платформы информацию об экземпляре
- Запускает развертывание Runtime файлов
FileCopyService.dll
- Добавляет ArchestrA User Account информацию в поток
- Копирует каждый файл в поток
- Отправляет поток на удаленный узел через DCOMTransport.exe
DCOMTransport.exe
- Получает данные от aaPIM пакет за пакетом
- Копирует каждый пакет на удаленный узел
на Platform Node
- Запускает процесс deploy создавая новый экземпляр FileCopyService.dll
- Выполняет установку MSI [2]
- Выполняет установку Merge Module MSMFiles [3]
- Запускает установку Runtime фалов
FileCopyService.dll
- Сравнивает информацию об ArchestrA User Account, пароль с локальным паролем. Если данные не совпадают deploy прерывается с ошибкой
- Конвертирует поток данных в оригинальные файлы/каталоги/прочее
- Вызывает aaPim при запросе установки файлов
DCOM Transport
- Принимает поток данных с GR
- Выполняет соединение с FileCopyService.dll
- Передает данные потока в FileCopyService.dll
Последовательность deploy объектов SP2014R2
- Platform
- Engine
- Area
- Копирование Объектов пакетами по 200 шт
- Запуск OnScan объектов пакетами по 500 шт
- Area
- Engine
Последовательность deploy объектов AS 3.1
- Копирование Объектов пакетами по 1000 шт
- Запуск OnScan объектов пакетами по 1000 шт
Примечания
- ↑ Platform Engine - процесс aaEngine относящийся к WinPlatform
- ↑ MSI - файлы Windows Installer (установщик Windows)
- ↑ Windows Installer Merge Module База данных "модуля объединения", содержащего настройки инсталляции и свойства для определенного инсталлятора программы. Включает в себя файлы, ресурсы, входные данные регистра и информацию о настройке. Часто содержится в файле расширения .MSI. Файлы MSM также носят название "файлов пакета объединения". Поскольку они являются частью пакета установки, файлы MSM не должны открываться вручную.
Ошибки при деплое
Проблема - после деплоя платформа не появляется в Platform Manager.
Процесс:
При корректной работе, узел GR после деплоя отправляет PlatformMapping.xml файл на каждую платформу. В зависимости от роли узла (GR или другой)
- PlatformMapping файл расположен здесь:
для x86 ОС
- C:\Program Files\ArchestrA\Framework\Bin\GobalDataCache\PlatformMapping
- C:\Program Files\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\DistributionRepository\PlatformMapping
- C:\Program Files\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\Repository\PlatformMapping
для x64 ОС
- C:\Program Files (x86)\ArchestrA\Framework\Bin\GlobalDataCache\PlatformMapping
- C:\Program Files (x86)\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\DistributionRepository\PlatformMapping
- C:\Program Files (x86)\ArchestrA\Framework\Bin\GalaxyData\GalaxyName\GobalDataRepository\Repository\PlatformMapping
Основываясь на информации из файла PlatformMapping система делает записи в реестр каждой машины, в ветку:
для x86 OC
- HKEY_LOCAL_MACHINE\SOFTWARE\ArchestrA\Framework\Platform\PlatformNodes
для x64 ОС
- HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ArchestrA\Framework\Platform\PlatformNodes
Затем базовая служба WW – Bootstrap считывает эти данные и отображает в Platform manager.
При таких проблемах стоит проверить:
- Есть ли записи о платформе(ах) в реестре?
- Если нет, есть ли файл PlatformMapping.xml по пути указанному выше?
- Если нет, выполнить передеплой целевого узла, проверить, если результата нет - передеплой GR node. Происходит ли заполнение предыдущих пунктов? Если нет, у вас проблемы со связью и/или правами пользователей м/у узлами ( ArchestrA account, UAC, Simple File sharing и другие проверки нужно сделать см. Tech Note 461/876/482,478/589,517).
- Если не помогает и это – следует переустановить софт соблюдая все инструкции из ReadMe файла в дистрибутиве на ПО
General Deployment Error
Варианты решений:
- This problem got resolved after changing the Network Address of the AOS platform from host name to IP Address and then undeploy & redeploy of the platform.
- Add hosts file on all platforms in the galaxy
- Repair the installation from Programs & Features/Wonderware Application Server. If the repair does not resolve the issue, then uninstall and reinstall Wonderware Application Server.
Failed to deploy <Platform_Name>: Access Denied, Invalid Credentials
Решение:
- Для WSP 2017 Update 3 - Запросить у техподдержки и установить HF L00152139 на всех узлах куда деплоится платформа в том числе на узел GR, а HF L00152161 - только на узле GR.
Failed to deploy RemotePlatformName : Remote Node's UserId/Password don't match GR Node's
Описание: aaPim is removed from the Administrator group on System Platform 2017 Update 3
Решение:
- See TA405. aaPIM is the platform installation manager that is responsible for installing platforms. In previous versions aaPIM is launched on demand as a process with Adminintrator privilege. However, in System Platform 2017 Update 3, it is changed into a windows service and added to the Administrators group as a service account. It's important not to remove the NTService\aaPim account from the Administrators group unless you follow recommendations outlined in TN10297 Managing Service Accounts with Group Policy for System Platform 2017 Update 3. Use exceptions in your IT Policies or Scripts to not delete the required Virtual Service Accounts or follow workaround recommendations outlined in TN10297.