Изменяемые файлы и директории в установке сервера AggreGate

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

Не размещайте всю директорию AggreGate на постоянном хранилище. Сохраняйте только те пути, в которых хранятся конфигурация, активы, управляемые пользователем, операционные данные среды выполнения или состояние встроенной СУБД.

Процедуры установки и обновления см. в разделе Установка и обновление. Информацию о запуске контейнера и локальном выполнении Docker см. в разделе Работа в контейнере Docker. Информацию об архитектуре отказоустойчивого кластера и ролях узлов см. в разделе Отказоустойчивый кластер.

Обзор

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

В общем случае:

  • сохраняйте конфигурацию, модифицированную после развертывания;

  • сохраняйте управляемые пользователем активы, которые должны пережить перезапуск;

  • сохраняйте директории встроенных СУБД только когда используется соответствующий режим хранения;

  • не сохраняйте всю директорию для установки;

  • не использовать хранилище встроенной СУБД совместно между одновременно работающими узлами.

Сохранение и общее использование узлов — это не одно и то же.

  • Сохранение означает, что путь сохраняется после перезапуска того же экземпляра, например, через том или постоянный том.

  • «Общее использование» означает, что несколько экземпляров могут одновременно выполнять чтение и запись в одном и том же хранилище в многопоточном режиме.

  • Репликация означает, что содержимое копируется между узлами с помощью механизма репликации или управления конфигурациями, а не через общую файловую систему.

Пути конфигурации

Путь

Объект

Сохраняется когда

Назначение

Дополнительные заметки

AggreGate/server.xml

Файл

Всегда

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

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

AggreGate/logging.xml

Файл

Когда выполняются настройки

Хранит конфигурацию ведения журнала.

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

AggreGate/ag_server.vmoption

Файл

Для активного режима запуска

Хранит опции виртуальной машины на время Runtime.

Сохраняйте файл, который фактически используется активным компонентом или режимом запуска.

AggreGate/ag_server_console.vmoptions

Файл

Для активного режима запуска

Хранит параметры виртуальной машины для режима запуска консоли.

Обеспечивает согласованность действующих параметров виртуальной машины на всех узлах резервных элементов.

AggreGate/ag_server_service.vmoptions

Файл

Для режима активного запуска

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

Обеспечьте согласованность действующих параметров виртуальной машины на всех узлах резервных элементов.

Активы, управляемые пользователем

Путь

Объект

Сохраняется когда

Назначение

Дополнительные заметки

AggreGate/plugins/

Директория

Когда плагины устанавливаются или обновляются после развертывания

Хранит сторонние и пользовательские плагины, которые не фиксированы в базовом образе.

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

AggreGate/mib/

Директория

Когда файлы SNMP MIB импортируются после развертывания

Хранит импортированные MIB-файлы.

Обеспечьте согласованность между резервными элементами. В случае утери импортированных MIB может потребоваться восстановить вручную.

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

Данные выполнения и эксплуатации

Путь

Объект

Сохраняется когда

Назначение

Дополнительные заметки

AggreGate/logs/

Директория

Когда требуются файловые журналы

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

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

AggreGate/statistics/

Директория

Когда данные статистики должны сохраняться после перезапуска

Хранит статистические данные, сгенерированные сервером.

Не используйте совместно между одновременно запущенными экземплярами.

AggreGate/search_index/

Директория

Когда индекс поиска должен сохраняться после перезапуска

Хранит поисковый индекс, используемый сервером.

Не следует использовать совместно с многопоточными экземплярами.

AggreGate/scripts/

Директория

Когда пользовательские функции или содержимое движка скриптов должны сохраняться после перезапуска

Хранит пользовательские функции и содержимое движка скриптов.

Не следует использовать совместно между одновременно запущенными экземплярами.

AggreGate/cluster/

Директория

Когда конфигурация кластера модифицируется после развертывания

Хранит конфигурацию кластера, которая должна сохраняться при перезапуске.

Не используйте совместно между одновременно запущенными экземплярами.

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

Пути к базе данных

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

Путь

Объект

Сохранить когда

Назначение

Дополнительные заметки

AggreGate/data/

Директория

Когда используется файловое хранилище

Хранит состояние файловой базы данных.

Не следует использовать совместно с многопоточными экземплярами.

AggreGate/database/

Директория

Когда используется хранилище встроенной базы данных SQL

Хранит состояние встроенной базы данных SQL.

Не следует использовать совместно для одновременно запущенных экземпляров.

AggreGate/nosql_data/

Директория

Когда используется встроенная Cassandra

Хранит данные встроенной Cassandra.

Никогда не используйте совместно между многопоточными узлами. Используйте только семантику доступа с одним записывающим устройством.

Если используется внешняя Cassandra, хранение данных в устойчивой базе данных осуществляется за пределами директории для установки AggreGate. В этом случае AggreGate/nosql_data/ не является расположением постоянной базы данных, а конфигурацией, в которой хранятся настройки подключения к внешней Cassandra, такие как AggreGate/server.xml, все равно должна быть сохранена.

Рекомендации по окружению

При развертывании с помощью Docker сохраняйте те же пути, что указаны на этой странице. На этой странице определено, что должно сохраняться при перезапуске; сами шаги развертывания описаны отдельно.

Для развертываний в Kubernetes:

  • используйте постоянные тома для конфигурации с правом записи и состояния, которые должны сохраняться при перезапуске или перепланировании под;

  • если конфигурация неизменяема, AggreGate/server.xml и AggreGate/logging.xml ее можно передать через ConfigMap или Secret вместо постоянного тома с возможностью записи;

  • для встроенной Cassandra используйте семантику доступа с одним записывающим процессом, как правило, ReadWriteOnce;

  • не монтируйте одну и ту же директорию встроенной СУБД в несколько запущенных под.

Для окружений с резервными элементами:

  • обеспечьте согласованность файлов конфигурации и ресурсов, управляемых пользователем, на всех узлах;

  • в большинстве случаев это включает AggreGate/server.xml, AggreGate/logging.xml Когда проводятся настройки AggreGate/plugins/, и AggreGate/mib/;

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

Рекомендуемый минимальный набор постоянных ресурсов для Kubernetes

Для многих развертываний Kubernetes практический минимальный набор постоянных ресурсов выглядит следующим образом:

Path

Сохранить когда

Причина

AggreGate/server.xml

Всегда

Основная конфигурация сервера

AggreGate/logging.xml

Когда проводятся настройки

Настраиваемая конфигурация ведения журнала

AggreGate/plugins/

Когда плагины устанавливаются или обновляются после развертывания

Набор плагинов, управляемый пользователем

AggreGate/mib/

Когда файлы MIB-файлов импортируются после развертывания

Управляемый пользователем репозиторий MIB

AggreGate/logs/

Когда требуются файловые журналы

Операционные журналы

AggreGate/nosql_data/

Когда используется встроенная Cassandra

Данные встроенной Cassandra

Сводка

Путь

Сохраняются когда

Почему это важно

AggreGate/server.xml

Всегда

Основная конфигурация сервера

AggreGate/logging.xml

Когда выполняются настройки

Настраиваемая конфигурация ведения журнала

AggreGate/ag_server.vmoption

Для режима активного запуска

Параметры виртуальной машины во время Runtime

AggreGate/ag_server_console.vmoptions

Для активного режима запуска

Параметры виртуальной машины во время выполнения Runtime

AggreGate/ag_server_service.vmoptions

Для активного режима запуска

Опции виртуальной машины Runtime

AggreGate/plugins/

Когда плагины меняются после развертывания

Установленные или обновленные плагины

AggreGate/mib/

Когда MIBs импортируются после развертывания

Импортированные MIB-файлы SNMP

AggreGate/logs/

Когда требуются файловые журналы

Журналы работы

AggreGate/statistics/

Когда используется

Данные статистики

AggreGate/search_index/

Когда используется

Поисковый индекс

AggreGate/scripts/

Когда используется

Пользовательские функции и содержимое скриптов

AggreGate/cluster/

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

Конфигурация кластера

AggreGate/data/

Когда файловое хранилище используется

Состояние файловой базы данных

AggreGate/database/

Когда используется встроенное хранилище базы данных SQL

Состояние встроенной базы данных SQL

AggreGate/nosql_data/

Когда используется встроенная Cassandra

Данные встроенной Cassandra

Was this page helpful?