ActiveScaleинженерная практика

Глоссарий ActiveScale

Основы referenceactivescalearchitectures3dsstape

Коротко. Ниже — рабочий словарь терминов, которые встречаются в GUI samurai, в выводе sherpa, в событиях и в переписке с поддержкой. Термины сгруппированы по слоям: платформа, данные и S3, ёмкость и DSS, установка, эксплуатация, холодное хранение. Английские названия оставлены как есть — именно их показывает продукт.


1. Платформа и архитектура

Термин Что это
ActiveScale Объектное хранилище Quantum. Два слоя — access (метаданные) и data (данные), два класса хранения — активный и холодный — в одном namespace.
AMUR Рабочее имя нашего установочного образа и практики (меню live-среды, сборки вида AMUR-7.3.1.2-…). Не вендорское название продукта.
Access Layer Слой метаданных на NVMe: каталог объектов, права, HEAD/LIST. Быстрый потому, что не трогает тело объекта.
Data Layer Слой данных: NVMe/HDD в активном классе, лента в холодном. Здесь лежат фрагменты объектов и чётность.
Нода (node) Сервер кластера. Минимум — три ноды; у X200 базовая конфигурация — четыре сервера 4U90, по два compute-модуля в каждом.
Колонка (column) Логическая группа нод и дисков, внутри которой раскладываются данные. Имеет состояние (CONFIGURED, NOTINITIALIZED) и видна в модели.
Блокстор (blockstore) Единица раскладки на дисках. Их число N видит DSS, и именно оно ограничивает политику (w + s ≤ N).
DSS Data Storage Subsystem — подсистема хранения: раскладка экстентов, чётность, ремонт, барометр.
Модель (model) База описания системы: машины, сети, диски, приложения, роли, локация. Продукт рендерит из неё конфиги; «поправить в модели» — изменить документ, а не файл на диске.
DDP / DDR Dynamic Data Placement (раскладка без обязательного rebalance при расширении) и Dynamic Data Repair (фоновый контроль целостности и самовосстановление без ожидания замены диска).

2. Данные и S3

Термин Что это
Объект (object) Единица хранения: ключ, тело, метаданные. Неизменяем; «изменение» — это новая версия.
Бакет (bucket) Контейнер объектов со своим именем, политикой доступа и настройками (версионирование, Object Lock, lifecycle).
Ключ (key) Строка-идентификатор объекта внутри бакета. Иерархии нет, есть префиксы — часть ключа до /.
Namespace Уровень DSS, в котором живут объекты; бакет связан с неймспейсом. У неймспейса своя политика и статус заполнения (status: ok).
Multipart upload Загрузка объекта частями. Нужна для больших объектов; у Z200 максимальный размер multipart-объекта — 50 TB (по datasheet).
Версионирование Сохранение предыдущих версий объекта при перезаписи и удалении. Включается на бакете.
Object Lock Запрет удаления и перезаписи объекта на заданный срок (WORM). Не заменяет бэкап.
Lifecycle Правила перевода объектов между классами (например, в Glacier) и удаления по возрасту.
IAM / resource policy IAM — пользователи, ключи, права. Resource policy — политика на конкретный ресурс (бакет). Частый AccessDenied: аккаунт есть, а resource policy нет.
SigV4 Подпись запроса AWS Signature Version 4. Если часы клиента и ноды разошлись больше допустимого окна, запрос получает 403.
Path-style / virtual-hosted Стили адресации бакета: https://<endpoint>/<bucket>/<key> и https://<bucket>.<endpoint>/<key>. Второй требует DNS-записи, в том числе wildcard.

3. Ёмкость и DSS

Термин Что это
w (spread width) Сколько фрагментов данных в полосе раскладки.
s (safety) Сколько фрагментов чётности в полосе.
N Число блоксторов, доступных DSS.
Usable Доля raw-ёмкости, доступная приложению: (w − s) / w. Не путать с raw.
Erasure coding Защита данных фрагментами и чётностью, распределёнными по дискам и нодам, вместо RAID внутри одной полки.
2D erasure coding Двумерная схема для холодного класса: чётность и внутри, и между кассетами, приводами, библиотеками. Overhead — от 15% (по данным Quantum).
Барометр (barometer) Индикатор заполнения DSS: ok или full. full при свободных дисках — почти всегда политика, а не место.
Политика DSS Набор w/s и параметров small files, который продукт применяет к вновь записываемым экстентам. Смена политики не форматирует диск: старые объекты остаются читаемыми.

4. Установка

Термин Что это
PXE Сетевая загрузка узла. Нужны ProxyDHCP (dhcp-boot + pxe-service), HTTP-раздача ISO и url=*.iso.
Stage-1 Установка ОС на диски через iso_installer.py: интерактивные промпты, выбор интерфейса, адрес, роль.
initialize Первый запуск модели (marvin_install): создаёт окружение, кластеры модели, приложения.
install-ng Установщик сервисов: разворачивает модель и приложения по фазам. Признак завершения — /tmp/.unattended_install_finished с кодом внутри, а не код возврата.
Очередь (queue) Каталог queue/<node>/ с восемью файлами описания узла (machine.json, network.json, column.json, environment.json и др.), из которых install-ng строит модель.
Федеративная БД Репликасет модели (federated_model) на порту 27019, общий для нод. Если федерация не смоделирована — install-ng пишет No suitable management server found.
Роль ноды SPXMGMT, SPXCTRLSTORAGE, SPXCTRLSTORAGEMGMT: определяет, какие приложения и сети поднимаются на узле.
Hardware type Профиль железа: regex по плате и CPU, роли дисков, партиции, поддержка ses. Без профиля диски разложатся по generic-шаблону.
NOTCONFIGURED / NOTMANAGED NOTCONFIGURED — узел или приложение не доехало до рабочего состояния. NOTMANAGED — статус в модели, при котором сканер и чекеры порт или диск не трогают; это не поломка.
Decommission Штатный вывод ресурса из системы: диска, ноды, кассеты. Не то же самое, что «выдернуть и забыть».

5. Эксплуатация

Термин Что это
samurai Веб-GUI продукта: дашборд, стойка, ресурсы, события, задачи.
sherpa CLI продукта (/opt/ampli/bin/sherpa) для DSS, S3, IAM.
marvin Служебный пользователь и набор приложений (marvinbase), от которого запускаются установщик и задачи.
Model API REST-интерфейс модели на 8443, mTLS, сертификаты root-only. Через него продукт применяет изменения модели.
mona Чекер модели: периодически сверяет железо, сеть, диски с моделью и поднимает события (NIC_DOWN, PSU_NOT_FOUND и т.п.).
taskmanager Исполнитель задач модели: очередь задач, playbooks, статусы. TASKMANAGER_STALLED — сигнал о его здоровье.
Событие (event) Запись о состоянии в модели: тип, важность, status (LIVE, HANDLED_AUTO, ARCHIVED), число повторов.
CBA Встроенная аналитика продукта; метрики также отдаются в Prometheus и экспортируются в Grafana.

6. Холодное хранение

Термин Что это
Cold Storage Холодный класс хранения на ленте, S3-совместимый с Glacier. Живёт в том же namespace, что и активные данные.
RAIL Redundant Array of Independent Libraries: избыточный массив независимых библиотек. Позволяет пережить отказ библиотеки, а не только кассеты.
Tape Connector Компонент, который связывает кластер с ленточной библиотекой: проверки, каталог кассет, группы, архив и restore.
Библиотека (library) Ленточная библиотека: слоты, приводы, почтовое окно (I/E station), каталог кассет. Может делиться на партиции.
Партиция (partition) Логическое деление библиотеки: своё поколение LTO, свои кассеты и приводы. В разных партициях допустимо смешивать поколения.
Кассета (cassette, medium) Носитель архива. Имеет штрихкод, поколение (LTO), состояние (available, used, marked, decommissioned).
Штрихкод (barcode) Идентификатор кассеты в библиотеке. Продукт сопоставляет реестр с каталогом библиотеки по штрихкоду и отбрасывает LTO-суффикс — отсюда класс проблем «пропавшие кассеты».
Tape group Группа кассет одного класса (data/parity), в которой продукт раскладывает архивы. Группа назначается записи, чей uuid библиотека называет в слоте.
Spread / safety на ленте Аналоги w/s для холодного класса: сколько кассет нужно, чтобы архив был восстановим. При safety = 0 продукт пишет WARNING и архив не защищён.
Archive / restore Archive — перенос объекта в холодный класс с маркером в активном слое. Restore — возврат объекта в активный/staging-слой для чтения; у больших объектов поддерживается ranged restore.
Reclamation Повторное использование ёмкости кассет после удаления объектов. Появилось в 7.3, работает ретроспективно и автоматически.

7. Как пользоваться словарём

  1. Термин из GUI ищите в таблице по точному английскому написанию: продукт не переводит названия.
  2. Если термин связан с ёмкостью — сначала считайте usable, потом смотрите политику: Формула политики DSS.
  3. Если термин связан с лентой — проверьте safety и форму штрихкода до любых действий с реестром: Планирование холодного тира.
  4. Расшифровка не заменяет проверку: у каждого термина есть состояние в модели или метрика, по которой видно факт.

8. Источники


Нужен инженер? Разберу вашу ситуацию и скажу, что делать — по шагам, с проверками.

Обсудить задачу