Обновление ЕдиногоАгента

Материал из Документация Ключ-АСТРОМ

ЕдиныйАгент имеет встроенный настраиваемый механизм автоматического обновления.

Автоматические обновления ЕдиногоАгента — это просто

Если автоматическое обновление включено, вам не нужно беспокоиться об обновлении вручную экземпляров ЕдиногоАгента, работающих в вашей среде. Каждый раз, когда выпускается новая версия, ЕдиныйАгент автоматически загружает все необходимые двоичные файлы и библиотеки и устанавливает их для вас. Ручная настройка не требуется.

После автоматических обновлений ЕдиногоАгента вам необходимо перезапустить все серверные процессы. Это связано с тем, что некоторые компоненты ЕдиногоАгента продолжают работать в процессах, отслеживаемых Ключ-Астром (например, Java, .NET, Apache и IIS).

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

Гибкие автоматические обновления ЕдиногоАгента

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

  • Обновляйтесь автоматически, независимо от периодов обслуживания.
  • Автоматическое обновление в течение выбранного периода обслуживания.
  • Не обновлять автоматически. При использовании этого параметра мы не уведомляем вас об устаревании экземпляров ЕдиногоАгента.

Кроме того:

  • На уровне группы хостов вы можете наследовать глобальные настройки обновления ЕдиногоАгента.
  • На уровне хоста вы можете наследовать настройки обновления ЕдиногоАгента для группы хостов.

Параметры узла имеют приоритет над параметрами группы узлов, а параметры группы узлов имеют приоритет над глобальными параметрами.

Автоматические обновления ЕдиногоАгента безопасны

  • Связь с ЕдинымАгентом зашифрована.
  • Установщики ЕдиногоАгента подписаны, и подпись проверяется для каждого загруженного пакета установщика. Если проверка не пройдена, попытка автоматического обновления прерывается.

Обновлениями ЕдиногоАгента также можно управлять через API Ключ-Астром.

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

  • Уровень хоста
  • Уровень группы хостов
  • Уровень окружения

Мониторинг обновлений ЕдиногоАгента

Чтобы отслеживать обновления ЕдиногоАгента, в меню Ключ-Астром выберите Настройки > Настройки > Обновления ЕдиногоАгента:

  • Проверьте или измените параметры автоматического обновления на уровне среды.
  • Мониторинг состояния обновления для каждой операционной системы (Linux, AIX и Windows)
  • Проверьте или измените статус автообновления реальной пользовательской библиотеки JavaScript, отслеживающей
    • Мониторинг глобального обновления ЕдиногоАгента
    • Статусы обновления ЕдиногоАгента

Мониторинг глобального обновления ЕдиногоАгента

Для мониторинга обновлений ЕдиногоАгента в масштабах всей среды выберите Настройки > Предпочтения > Обновления ЕдиногоАгента.

Обновления ЕдиногоАгента

Используйте этот раздел, чтобы проверить или изменить настройку уровня среды:

  • Автоматические обновления при первой же возможности
    • Обновляйте все экземпляры ЕдиногоАгента автоматически, независимо от периодов обслуживания.
  • Автоматические обновления во время периодов обслуживания
    • Обновляйте все экземпляры ЕдиногоАгента автоматически в течение выбранного периода обслуживания.
      • При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
      • Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента , выберите Настройки > Период обслуживания > Обновления ЕдиногоАгента.
  • Нет автоматических обновлений
    • Не обновляйте все экземпляры ЕдиногоАгента автоматически.

Статус автоматических обновлений

Используйте этот раздел, чтобы проверить состояние автоматических обновлений для каждой операционной системы. Для каждой операционной системы на этой странице отображается количество экземпляров ЕдиногоАгента с разбивкой по статусу обновления ЕдиногоАгента.

Библиотека JavaScript для мониторинга реальных пользователей

Включите параметр Автоматически обновлять библиотеку JavaScript для мониторинга реальных пользователей, чтобы библиотека JavaScript для мониторинга реальных пользователей автоматически обновлялась. Текущая версия библиотеки указана под переключателем.

Статусы обновления ЕдиногоАгента

  • Несовместимо — автоматическое обновление невозможно. Для этого хоста/версии может потребоваться ручное обновление.
  • Доступно обновление — для этой версии ЕдиногоАгента доступно обновление.
  • Подавлено — загрузка невозможна, поскольку для этого развертывания не поддерживается автоматическое обновление.
  • Неизвестно — это может означать, например, что хост не найден или для него недоступно автообновление.
  • Актуально — актуальна версия установщика.
  • Выполняется обновление — этот хост запросил и загрузил установщик, но еще не подключился с ожидаемой новой версией.
  • Ожидание обновления — для этого хоста настроено обновление.
  • Проблема с обновлением. Возникла проблема при выполнении обновления. Пожалуйста, ознакомьтесь с деталями.
  • Запланировано — обновление запланировано на время настроенного окна обновления.

Настройка обновлений ЕдиногоАгента

Вы можете настроить обновление ЕдиногоАгента глобально, для каждой группы хостов и для каждого хоста.

Настройка глобального обновления ЕдиногоАгента

Когда автоматические обновления включены глобально, всякий раз, когда становится доступной новая версия ЕдиногоАгента , все установленные вами экземпляры ЕдиногоАгента , за исключением случаев, когда вы отключили автоматическое обновление на уровне группы хостов или на уровне хоста, автоматически загружают обновление и обновляют свои двоичные файлы и файлы конфигурации.

Параметры обновления ЕдиногоАгента на уровне группы хостов и на уровне хоста переопределяют эти глобальные параметры.

1. В меню Ключ-Астром выберите Настройки > Свойства > Обновления ЕдиногоАгента.

2. Выберите один из вариантов обновления:

  • Автоматические обновления при первой же возможности
    • Обновляйте все агенты ЕдиногоАгента автоматически, независимо от периодов обслуживания.
  • Автоматические обновления во время периодов обслуживания
    • Обновляйте все агенты ЕдиногоАгента автоматически в течение выбранного периода обслуживания.
      • При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
      • Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента , выберите Настройки > Период обслуживания > Обновления ЕдиногоАгента.
  • Нет автоматических обновлений
    • Не обновляйте ЕдиныйАгент автоматически.

Настройка обновления группы узлов ЕдиногоАгента

Параметры обновления ЕдиногоАгента на уровне группы узлов переопределяют глобальные параметры и переопределяются параметрами на уровне хоста.

1. Откройте страницу настроек группы хостов.

Альтернативы доступа:

  • Перейдите в Настройки > Мониторинг > Обзор мониторинга, найдите любой хост в группе хостов, которую вы хотите настроить, и выберите имя группы хостов (не имя хоста).
  • Перейдите в раздел Хосты, откройте страницу хоста и разверните раздел Свойства и теги. Если узел принадлежит к группе, ссылка на него есть в разделе Группа хостов.
  • Перейдите в раздел Статус развертывания > ЕдиныйАгент. Если хост входит в группу хостов, под именем хоста отображается ссылка на страницу настроек группы хостов.

2. На странице настроек группы хостов выберите обновления ЕдиногоАгента в левой части страницы.

3. Выберите один из вариантов обновления:

  • Наследовать глобальные настройки обновления
    • Следуйте глобальным параметрам обновления для обновления экземпляров ЕдиногоАгента в этой группе узлов.
      • Текущая глобальная настройка отображается в скобках в этой строке.
      • Чтобы перейти на страницу глобальной конфигурации, выберите глобальную ссылку.
  • Автоматические обновления при первой же возможности
    • Обновляйте все экземпляры ЕдиногоАгента в этой группе узлов автоматически, независимо от периодов обслуживания. Игнорировать глобальные настройки обновления.
  • Автоматические обновления во время периодов обслуживания
    • Автоматически обновляйте все экземпляры ЕдиногоАгента в этой группе хостов в течение выбранного периода обслуживания. Игнорировать глобальные настройки обновления.
      • При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
      • Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента , выберите Настройки > Период обслуживания > Обновления ЕдиногоАгента.
  • Нет автоматических обновлений
    • Не обновлять автоматически экземпляры ЕдиногоАгента в этой группе хостов. Игнорировать глобальные настройки обновления.

Настройка обновления ЕдиногоАгента на уровне хоста

Параметры обновления ЕдиногоАгента на уровне хостапереопределяют параметры обновления ЕдиногоАгента на глобальном уровне и уровне группы хостов.

1. Откройте страницу хост для хоста, который вы хотите настроить.

Варианты доступа:

  • Выберите Хосты в меню навигации, а затем выберите хост.
  • Перейдите в «Настройки» > «Мониторинг» > «Обзор мониторинга», выберите вкладку «Хосты», а затем выберите хост.

2. На странице хоста откройте меню обзора (…) и выберите «Настройки».

3. Выберите обновления ЕдиногоАгента в левой части страницы.

4. Выберите один из вариантов обновления:

  • Наследовать
    • Следуйте группе узлов или глобальным параметрам обновления для обновления этого агента ЕдиногоАгента.
      • Если выбранный хост принадлежит к группе хостов, текущая настройка группы хостов отображается в скобках в этой строке, а имя группы является ссылкой на страницу конфигурации группы хостов.
      • Если выбранный хост не принадлежит к группе хостов, глобальный параметр отображается в скобках в этой строке, а «глобальный» — это ссылка на страницу глобальной конфигурации («Настройки» > «Предпочтения» > «Обновления ЕдиногоАгента»).
  • Автоматические обновления при первой же возможности
    • Обновляйте этот ЕдиногоАгента автоматически, независимо от периодов обслуживания. Игнорировать настройки обновления группы хостов.
  • Автоматические обновления во время периодов обслуживания
    • Обновляйте этот ЕдиныйАгент автоматически в течение выбранного периода обслуживания. Игнорировать глобальные настройки обновления.
      • При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
      • Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента, выберите «Настройки» > «Период обслуживания» > «Обновления ЕдиногоАгента».
  • Нет автоматических обновлений
    • Не обновляйте этот ЕдиныйАгент автоматически. Игнорировать глобальные настройки обновления.

Вручную обновите ЕдиныйАгент на отдельных хостах

Чтобы вручную обновить ЕдиныйАгент, работающий на отдельном хосте:

1. В меню Ключ-Астром выберите «Настройки» > «Мониторинг» > «Обзор мониторинга».

2. Выберите вкладку Хосты.

3. Чтобы обновить ЕдиныйАгент или загрузить последнюю версию, выберите «Обновить» рядом с именем интересующего вас хоста.

Примечание: Кнопка «Обновить» появляется только в том случае, если установленная версия ЕдиногоАгента на определенном хосте устарела и является ЕдинымАгентом с полным стеком. Эта кнопка не отображается при использовании PaaS и автономных экземпляров ЕдиногоАгента.

4. Выберите Обновить сейчас.

Если кнопка «Обновить сейчас» отключена, у вас нет прав на загрузку установщика.

Кроме того, вы можете загрузить последнюю версию программы установки ЕдиногоАгента, вручную скопировать ее на целевой хост и выполнить установку непосредственно на целевом хосте.

Примечание: ЕдиныйАгент не будет автоматически обновляться при первой установке. По умолчанию Ключ-Астром ждет 1440 минут (24 часа), прежде чем разрешать обновления на хостах EC2, и 120 минут (2 часа) на хостах, отличных от EC2.

Выберите версию ЕдиногоАгента для установки на новые хосты.

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

1. Выберите «Настройки» > «Настройки» > «Обновления ЕдиногоАгента».

2. Выберите Без автоматических обновлений, чтобы отключить автоматические обновления ЕдиногоАгента.

3. В стандартной версии для всех новых хостов выберите версию ЕдиногоАгента для установки на все новые хосты.

Примечание: Выбранная версия ЕдиногоАгента также используется для интеграции PaaS.

Настройка периодов обслуживания

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

Список всех периодов обслуживания обновлений ЕдиногоАгента

1. Выберите «Настройки» > «Период обслуживания» > «Обновления ЕдиногоАгента».

2. Просмотрите список всех существующих периодов обслуживания обновлений ЕдиногоАгента.

Включить или отключить период обслуживания обновлений ЕдиногоАгента

1. Выберите «Настройки» > «Период обслуживания» > «Обновления ЕдиногоАгента».

2. Найдите период обслуживания, который вы хотите включить или отключить.

3. Включите или выключите переключатель.

Удалить период обслуживания обновлений ЕдиногоАгента

1. Выберите «Настройки» > «Период обслуживания» > «Обновления ЕдиногоАгента».

2. Найдите период обслуживания, который хотите удалить.

3. Выберите X в столбце Удалить.

Создайте или обновите окно обслуживания обновлений ЕдиногоАгента

1. Выберите «Настройки» > «Период обслуживания» > «Обновления ЕдиногоАгента».

2. Откройте окно обслуживания для редактирования:

  • Чтобы создать новое окно обслуживания, выберите Создать период обслуживания.
  • Чтобы отредактировать существующий период обслуживания, разверните Сведения о периоде обслуживания, который вы хотите изменить.

3. Задайте Name имя, под которым вы хотите указать этот период обслуживания в веб-интерфейсе и API Ключ-Астром.

4. Опишите период обслуживания:

  • Чтобы указать один неповторяющийся период обслуживания:
    • Установите Повторение на один раз
    • Установите Время обновления на одну дату и время для обновления ЕдиногоАгента.
  • Чтобы запланировать период обслуживания каждые x дней:
    • Установите Повторение на Ежедневные интервалы
    • Установите Каждые x дней на количество дней между обновлениями (1 = каждый день, 2 = каждые два дня, 3 = каждые три дня и т. д.)
    • Установите Время обновления на время в течение указанных дней, когда вы хотите обновить ЕдиныйАгент.
  • Чтобы запланировать период обслуживания каждые x недель в определенные дни недели:
    • Установите Повторение на Еженедельные интервалы
    • Включите каждый день недели, который вы хотите добавить в период обслуживания.
    • Установите Каждые x недель количество недель между обновлениями (1 = каждую неделю, 2 = каждые две недели, 3 = каждые три недели и т. д.)
    • Установите Время обновления на время в течение указанных дней, когда вы хотите обновить ЕдиныйАгент.
  • Чтобы запланировать период обслуживания каждые x месяцев в определенный день месяца:
    • Установите Повторение на Ежемесячные интервалы
    • Установите День месяца на день месяца, в который нужно обновить ЕдиныйАгент.
    • Установите Каждые x месяцев количество месяцев между обновлениями (1 = каждый месяц, 2 = каждые два месяца, 3 = каждые три месяца и т. д.)

5. Выберите Сохранить изменения.

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

Применение окна обслуживания обновлений ЕдиногоАгента

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

Окружение

1. Выберите «Настройки» > «Обновления ЕдиногоАгента».

2. Выберите Автоматические обновления во время периодов обслуживания.

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

Группа хостов

1. Выберите «Настройки» > «Мониторинг» > «Обзор мониторинга».

2. Найдите любой хост, входящий в группу хостов, которую вы хотите настроить.

3. Выберите имя группы хостов (не имя хоста).

4. На странице настроек группы хостов выберите обновления ЕдиногоАгента в левой части страницы.

5. Выберите Автоматические обновления во время периодов обслуживания.

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

Хост

1. Откройте страницу Хост для хоста, который вы хотите настроить.

Варианты доступа:

  • Выберите Хосты в меню навигации, а затем выберите хост.
  • Перейдите в «Настройки» > «Мониторинг» > «Обзор мониторинга», выберите вкладку «Хосты», а затем выберите хост.

2. На странице хоста откройте меню обзора (…) и выберите «Настройки».

3. Выберите обновления ЕдиногоАгента в левой части страницы.

4. Выберите Автоматические обновления во время периодов обслуживания.

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

API
Эквиваленты API см. в разделе ЕдиныйАгент конфигурации API.

Отключить автоматические обновления

Мы не рекомендуем отключать автоматические обновления ЕдиногоАгента . Для устранения неполадок вы можете временно отключить автоматические обновления с помощью веб-интерфейса Ключ-Астром в меню «Настройки» > «Настройки» > «Обновления ЕдиногоАгента». Однако если у вас очень строгие правила развертывания программного обеспечения, вы можете навсегда отключить автоматические обновления с помощью интерфейса командной строки ЕдиногоАгента .