Развертывание приложения ITAM

подсказка

Требуемая роль: admin

Развертывание приложения ITAM включает в себя следующие этапы:

1. Установка приложения ITAM.
2. (опционально) Развертывание демоданных.

При первой установке ITAM на платформу используйте пакет с полной версией приложения. При последующих обновлениях – пакеты обновлений.

Развертывание полной версии

внимание

Перед развертыванием версии ITAM 1.4.2 убедитесь, что у вас установлена версия платформы 1.25.0 или более поздняя.

1. Установите основной пакет приложения [ITAM] 1.4.2 full.sop.
2. В приложении Simple вынесите поле Соответствующий актив (corresponding_asset_id) на форму таблицы Конфигурационая единица (sys_cmdb_ci) для корректной визуализации связи актива с текущей конфигурационной единицей.
3. Если на экземпляре установлено приложение ITSM и вам требуется установить связь между этими приложениями, установите файл [ITAM]_ITAM_1_3_1_ITSM_1_12_1_full.sop и настройте Коннектор ITAM-ITSM. Эту настройку необходимо провести только один раз. При последующих обновлениях приложения эти данные будут сохранены.

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

Устанавливайте все версии и патчи по порядку.

Пример:

Чтобы обновить приложение с версии 1.1.1 на 1.4.2, установите последовательно пакеты 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3.0, 1.3.1, 1.3.2, 1.3.3, 1.4.0, 1.4.1 и 1.4.2, следуя инструкции по их установке.

1.4.2

Обновление с версии 1.4.1 до версии 1.4.2

1. Установите файл [ITAM] 1.4.2.sop.
2. В приложении Simple вынесите поле Соответствующий актив (corresponding_asset_id) на форму таблицы Конфигурационая единица (sys_cmdb_ci) для корректной визуализации связи актива с текущей конфигурационной единицей.
3. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

Очищение списка активов в отмененных задачах инвентаризации

В этой версии был исправлен дефект, из-за которого активы, добавленные в задачу инвентаризации, оставались с ней после ее перевода в статус Отменено в случае, если была загружена хотя бы одна версия файла инвентаризации. Такие активы были недоступны для других типов задач и потребностей в активах.

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

1. Откройте список таблицы связей Актив - Задача (itam_m2m_task_asset) с фильтром /list/itam_m2m_task_asset?condition=(task_id.sys_db_table_id%3D168669266704175184%5Etask_id.state%3Dcompleted%5Etask_id.closure_code%3Dcanceled).

   • Если список пуст, никакие дополнительные действия не требуются.

2. Если в этом списке отображаются записи, запустите серверный скрипт To remove assets from canceled inventory, доступный по ссылке {URL вашего экземпляра}/record/sys_script/174557113618984162. Cкрипт уберет активы из отмененных задач инвентаризации и сделает их доступными для задач и потребностей.

3. Перейдите в список из шага 1 снова спустя некоторое время (длительность выполнения скрипта зависит от текущей нагрузки системы и числа записей, которые необходимо удалить). Количество записей, отображаемых в списке Актив - Задача (itam_m2m_task_asset) с фильтром из шага 1, должно постепенно уменьшится до нуля. Активы, убранные из отмененных задач инвентаризации, станут доступны для задач ITAM и потребностей.

1.4.1

Обновление с версии 1.4.0 до версии 1.4.1

1. Установите файл [ITAM] 1.4.1.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

1.4.0

Обновление с версии 1.3.3 до версии 1.4.0

1. Установите файл [ITAM] 1.4.0.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

Заполнение поля Компания-владелец на форме актива

В версии ITAM 1.4.0 на форму актива добавлено обязательное поле Компания-владелец. Запустите скрипт Update assets - set owner company, чтобы заполнить это поле на формах существующих записей активов значением компании-владельца склада, к которому привязан актив.

1. Перейдите в навигаторе в Планировщик → Запланированные скрипты.

2. Откройте запись Update assets - set owner company ({URL экземпляра}/record/sys_schedule_script/173945677010361671) и заполните поля записи, как в таблице ниже:

   Поле	Значение
   Активно	Да
   Частота запуска	Единожды
   Дата и время запуска	Установите время в период минимальной нагрузки на систему, например, ближайшей ночью. Пример: 2024-11-28 01:01:00 Скрипт будет запущен по часовому поясу, указанному в настройках системы, а не вашего устройства. Если они различаются, вы можете изменить часовой пояс в настройках системы для удобства запуска скрипта.

После выполнения скрипта в активных записях активов поле Компания-владелец (company_id) будет заполнено значением поля Склад.Владелец склада (stock_id.consumer_id).

Заполнение поля Компания-владелец на форме задачи регистрации

Также в этой версии ITAM на форму задачи регистрации активов добавлено обязательное поле Компания-владелец. Запустите скрипт Set registration tasks owner company, чтобы заполнить это поле на формах неотмененных записей задач регистрации значением компании-владельца склада, к которому привязан актив.

1. Перейдите в навигаторе в Планировщик → Запланированные скрипты.

2. Откройте запись Set registration tasks owner company ({URL экземпляра}/record/sys_schedule_script/173884402615726716) и заполните поля записи, как в таблице ниже:

   Поле	Значение
   Активно	Да
   Частота запуска	Единожды
   Дата и время запуска	Установите время в период минимальной нагрузки на систему, например, ближайшей ночью. Пример: 2024-11-28 01:01:00 Скрипт будет запущен по часовому поясу, указанному в настройках системы, а не вашего устройства. Если они различаются, вы можете изменить часовой пояс в настройках системы для удобства запуска скрипта.

После выполнения скрипта во всех неотмененных записях задач регистрации значение поля Компания-владелец (owner_company_id) будет заполнено значением поля Склад.Владелец склада (stock_id.consumer_id).

1.3.3

Обновление с версии 1.3.2 до версии 1.3.3

внимание

Перед обновлением до версии ITAM 1.3.3 убедитесь, что у вас установлена версия платформы 1.25.0 или более поздняя.

В этой версии приложения обновлена логика полей Документов и Контрактов на активы. Также появилась возможность создавать записи активов из конфигурационных единиц в соответствии с заданными условиями. Для корректного обновления до версии 1.3.3 следуйте инструкции ниже:

1. Если при первой установке версии 1.3.2 или обновлении до версии 1.3.2 вы применили решение для восстановления работоспособности контрактов на активы на платформе версии 1.25.0, то произведите откат этих изменений.
2. Установите файл [ITAM] 1.3.3.sop.
3. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

Обновление существующих записей в таблице Контракты на активы

В Контрактах на активы поля Валюта, Заказчик и Потребитель теперь согласованы с такими же полями платформы версии 1.25.0. Для обновления имеющихся записей на вашем экземпляре запустите скрипт Update itam contracts, для этого выполните следующие действия:

1. Перейдите в навигаторе в Планировщик → Запланированные скрипты.

2. Откройте запись Update itam contracts ({URL экземпляра}/record/sys_schedule_script/173650151815017134) и заполните поля записи как в таблице ниже:

   Поле	Значение
   Активно	Да
   Частота запуска	Единожды
   Дата и время запуска	Установите время в период минимальной нагрузки на систему, например, ближайшей ночью. Пример: 2024-11-28 01:01:00 Скрипт будет запущен по часовому поясу, указанному в настройках системы, а не вашего устройства. Если они различаются, вы можете изменить часовой пояс в настройках системы для удобства запуска скрипта.

   После выполнения запланированного скрипта Update itam contracts в существующих контрактах на активы произойдут следующие изменения: поле Категория будет заполнено данными, мигрированными из деактивированного поля Категория контракта, обязательное поле Валюта будет заполнено валютой, указанной в системном свойстве currency.default. Также, в активных документах контрактов на активы поле Подтип будет заполнено значением, соответствующим Категории контракта.

3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Обновление существующих записей в таблице Документы

На форме Документов обновлено поле Подтип, которое принимает значение выбранной Категории связанного Контракта на активы. Чтобы обновить данные записей документов на вашем экземпляре, выполните следующие действия:

1. Перейдите в навигаторе в Планировщик → Запланированные скрипты.

2. Откройте запись Set document subtype ({URL экземпляра}/record/sys_schedule_script/173712103517910376) и заполните поля как в таблице ниже:

   Поле	Значение
   Активно	Да
   Частота запуска	Единожды
   Дата и время запуска	Установите время в период минимальной нагрузки на систему, например, ближайшей ночью, но на 1 час позже времени запуска запланированного скрипта Update itam contracts. Пример: 2024-11-28 01:01:00 Скрипт будет запущен по часовому поясу, указанному в настройках системы, а не вашего устройства. Если они различаются, вы можете изменить часовой пояс в настройках системы для удобства запуска скрипта.

3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

После выполнения запланированного скрипта Set document subtype в существующих неактивных документах с типом Контракт поле Подтип будет заполнено значением категории соответствующего контракта.

Создание записей активов из конфигурационных единиц

В этой версии при необходимости вы можете активировать создание записей активов при создании конфигурационных единиц и создать записи активов из уже хранящихся в системе конфигурационных единиц. Читайте подробнее об активации и настройке этой функциональности в статье Регистрация записей активов из конфигурационных единиц.

Заполнение серийных номеров конфигурационных единиц из соответствующих активов

При необходимости вы можете заполнить серийные номера конфигурационных единиц значением поля Серийный номер соответствующих им активов. Для этого запустите запланированный скрипт Set CI serial number from Asset. При помощи этого скрипта в записи конфигурационных единиц будут добавлены серийные номера соответствующих им активов.

1. Перейдите в навигаторе в Планировщик → Запланированные скрипты.

2. Откройте запись Set CI serial number from Asset ({URL экземпляра}/record/sys_schedule_script/173451471416090603) и заполните поля как в таблице ниже:

   Поле	Значение
   Активно	Да
   Частота запуска	Единожды
   Дата и время запуска	Установите время в период минимальной нагрузки на систему, например, ближайшей ночью. Пример: 2024-11-28 01:01:00 Скрипт будет запущен по часовому поясу, указанному в настройках системы, а не вашего устройства. Если они различаются, вы можете изменить часовой пояс в настройках системы для удобства запуска скрипта.

3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

1.3.2

Обновление с версии 1.3.1 до версии 1.3.2

внимание

Перед развертыванием версии ITAM 1.3.2 убедитесь, что у вас установлена версия платформы 1.23.3 или более поздняя.

При обновлении ITAM до версии 1.3.2 и ниже на платформу версии 1.25.0 и выше, функциональность контрактов на активы будет ограничена.

Восстановление работоспособности Контрактов на активы для ITAM 1.3.2:

1. В агентском интерфейсе откройте Настройки → Настройки администратора.
2. В поле Приложение выберите Simple.
3. Выберите или создайте локальный пакет и сделайте его текущим.
4. Откройте запись колонки Категория контракта (contract_category) таблицы Контракт (contract).
5. Установите флажок в поле Активно.
6. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
7. Откройте запись колонки Валюта (currency_id) таблицы Контракт (contract).
8. В связанном списке Переопределение полей нажмите Создать.
9. На форме новой записи в поле Таблица укажите таблицу Контракт на активы (itam_contract) для поля Валюта.
10. Установите флажок Переопределение обязательности.
11. Убедитесь, что флажок Обязательная снят.
12. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
13. (опционально) Завершите созданный локальный пакет. Для этого:
    1. Перейдите в навигаторе в Конфигурация → Локальные пакеты и откройте запись ранее созданного локального пакета.
    2. В поле Статус укажите опцию Завершен.
    3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

1. Установите файл [ITAM] 1.3.2.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

1.3.1

Обновление с версии 1.3.0 до версии 1.3.1

1. Установите файл [ITAM] 1.3.1.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

1.3.0

Обновление с версии 1.2.5 до версии 1.3.0

внимание

Перед установкой обновления до версии ITAM 1.3.0 убедитесь, что у вас установлена версия платформы 1.23.3 или более поздняя.

1. Установите файл [ITAM] 1.3.0.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

Обновление наименования активов

В этой версии ITAM реализован более компактный формат наименования активов.

Прежний формат	Формат начиная с ITAM 1.3.0
A00008531 Серверное оборудование Сервер приложений DELL PowerEdge T40	A00008531 Сервер приложений DELL PowerEdge T40

Чтобы обновить наименование активов, которые были созданы до установки версии ITAM 1.3.0, запустите запланированный скрипт [ITAM] Change name assets. Для этого выполните следующие действия:

1. Перейдите в навигаторе в Планировщик → Запланированные скрипты.

2. Откройте запись скрипта [ITAM] Change name assets (/record/sys_schedule_script/172787324211246773) и заполните поля записи как в таблице ниже:

   Поле	Значение
   Активно	Да
   Частота запуска	Единожды
   Дата и время запуска	Установите время в период минимальной нагрузки на систему, например, ближайшей ночью. Пример: 2024-11-28 01:01:00 Скрипт будет запущен по времени, указанному в настройках системы, а не вашего устройства. Если они различаются, вы можете изменить часовой пояс в настройках системы для удобства запуска скрипта.

3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Присвоение кодов закрытия завершенным задачам регистрации

В этой версии ITAM мы ввели коды закрытия для задач регистрации активов.

Чтобы присвоить коды закрытия задачам регистрации, которые были завершены до установки версии ITAM 1.3.0, запустите запланированный скрипт [ITAM] Add closure code to already completed assets registration tasks. Для этого выполните следующие действия:

1. Перейдите в навигаторе в Планировщик → Запланированные скрипты.

2. Откройте запись [ITAM] Add closure code to already completed assets registration tasks (/record/sys_schedule_script/172985946514168137) и заполните поля записи как в таблице ниже:

   Поле	Значение
   Активно	Да
   Частота запуска	Единожды
   Дата и время запуска	Установите время в период минимальной нагрузки на систему, например, ближайшей ночью. Пример: 2024-11-28 01:02:00 Скрипт будет запущен по времени, указанному в настройках системы, а не вашего устройства. Если они различаются, вы можете изменить часовой пояс в настройках системы для удобства запуска скрипта.

3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

1.2.5

Обновление с версии 1.2.4 до версии 1.2.5

1. Установите файл [ITAM] 1.2.5.sop.
2. Обновите версию коннектора ITAM-ITSM из файла [ITAM]_ITAM.1.2.5_ITSM.1.12.1.sop, если на вашем экземпляре уже был установлен ITSM и коннектор ITAM-ITSM.
3. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

Добавление функции полнотекстового поиска по активам на портале

В этой версии реализована возможность полнотекстового поиска активов в списке активов на портале. Для этого все новые активы будут индексироваться.

Чтобы проиндексировать уже созданные активы, запустите серверный скрипт [ITAM] Reindex Assets table. Для этого выполните следующие действия:

1. Перейдите в навигаторе в Настройка системы → Серверные скрипты.
2. Откройте запись [ITAM] Reindex Assets table (/record/sys_script/172010221518000015)
3. Нажмите Запустить.

1.2.4

Обновление с версии 1.2.3 до версии 1.2.4

1. Установите файл [ITAM] 1.2.4.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

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

Добавление статуса номенклатуры

примечание

Следуйте инструкции ниже, только если на вашем экземпляре уже существуют записи номенклатур на момент обновления.

Запустите запланированный скрипт Set nomenclature state, чтобы установить статус Активна для записей существующих номенклатур. Для этого выполните следующие действия:

1. В агентском интерфейсе перейдите в Планировщик → Запланированные скрипты и откройте запись Set nomenclature state (record/sys_schedule_script/171698291418285351).
2. В поле Частота запуска выберите значение По запросу.
3. Нажмите Выполнить.

Создание связи "родительский актив – дочерний актив" первого уровня

примечание

Следуйте инструкции ниже, только если таблица Активы (itam_asset) содержит записи на момент обновления.

При развертывании обновления вы можете запустить механизм преобразования многоуровневых родительско-дочерних связей между существующими в системе активами. В результате будут созданы пары из актива-родителя и уже привязанного к нему дочернего актива первого уровня. После этого дочерние активы будут повторять этап и статус связанного с ними родительского актива. Дочерние активы следующих уровней будут по-прежнему связаны с указанными для них родительскими активами, однако логика автоматического изменения этапа и статуса не будет к ним применяться.

В версии приложения ITAM 1.2.4 и выше установить связь родительский актив – дочерний актив можно только для одного уровня. Актив, который уже является дочерним, не может быть родительским для другого актива. Настроить многоуровневость наследования повторно будет нельзя.

Чтобы настроить родительско-дочерние связи первого уровня, запустите запланированный скрипт Set relation between Parent and Child assets.

Если в таблице Активы (itam_asset) нет записей или существующие записи активов не связаны как родительский актив – дочерний актив, при обновлении этот алгоритм одноуровневого наследования будет применяться автоматически, запуск скрипта выполнять не нужно.

1.2.3

Обновление с версии 1.2.2 до версии 1.2.3

1. Установите файл [ITAM] 1.2.3.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

В этом обновлении была исправлена ошибка, из-за которой было невозможно при помощи скрипта задавать значения REM-атрибутов для конфигурационных единиц. Чтобы актуализировать значения REM-атрибутов уже существующих конфигурационных единиц, связанных с активами, запустите запланированный скрипт Set re model in CI, как описано ниже. Если записей активов еще нет, скрипт запускать не нужно.

внимание

Следуйте инструкции ниже, только если таблица Активы (itam_asset) содержит записи на момент обновления.

1. Откройте запись запланированного скрипта Set re model in CI (record/sys_schedule_script/171560985413106860).
2. В поле Частота запуска выберите Единожды.
3. Установите флажок Активный и укажите дату и время запуска целым числом минут в будущем.
4. Нажмите Сохранить.
5. Контролируйте процесс выполнения запланированного скрипта по записям в таблице Основной журнал (sys_log).

В результате REM-атрибуты конфигурационных единиц, связанных с существующими активами, обновятся.

1.2.2

Обновление с версии 1.2.1 до версии 1.2.2

1. Установите файл [ITAM] 1.2.2.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.

В этой версии в таблице Активы (itam_asset) появилось поле Активный. Запустите запланированный скрипт Set Active in existing Assets, чтобы установить его значение для всех уже существующих записей активов на вашем экземпляре.

внимание

Следуйте инструкции ниже, только если таблица Активы (itam_asset) содержит записи на момент обновления.

1. Откройте запись запланированного скрипта Set Active in existing Assets (record/sys_schedule_script/170965537611177121).
2. В поле Частота запуска выберите Единожды.
3. Установите флажок Активный и укажите дату и время запуска целым числом минут в будущем.
4. Нажмите Сохранить.
5. Контролируйте процесс выполнения запланированного скрипта по записям в таблице Основной журнал (sys_log).

После выполнения запланированного скрипта поле Активный в существующих активах будет заполнено значением Да или Нет в зависимости от того, находится ли актив в финальном этапе и статусе.

1.2.1

Обновление с версии 1.1.1 до версии 1.2.1

1. Установите пакет обновления [ITAM] 1.2.1.sop.
2. (опционально) Установите коннектор ITAM-ITSM и настройте формы, если это не было сделано ранее.