# ActiveScale: инженерная практика > Независимая инженерная практика: установка, эксплуатация и разбор проблем объектного хранилища Quantum ActiveScale. База знаний и полевые заметки. ## Разделы - [Главная](https://guru.activescale.ru/) - [База знаний](https://guru.activescale.ru/kb/) - [Заметки](https://guru.activescale.ru/notes/) - [О практике](https://guru.activescale.ru/about/) - [Связаться](https://guru.activescale.ru/contact/) ## База знаний - [Основы](https://guru.activescale.ru/kb/basics/) — 6 статей - [Проектирование](https://guru.activescale.ru/kb/design/) — 5 статей - [Установка](https://guru.activescale.ru/kb/install/) — 9 статей - [Эксплуатация](https://guru.activescale.ru/kb/operate/) — 9 статей - [Обслуживание](https://guru.activescale.ru/kb/maintain/) — 7 статей - [Диагностика](https://guru.activescale.ru/kb/troubleshoot/) — 19 статей - [Справочники](https://guru.activescale.ru/kb/reference/) — 6 статей - [Кейсы](https://guru.activescale.ru/kb/cases/) — 4 статей ## Все статьи - [Классы Active и Cold](https://guru.activescale.ru/kb/basics/active-vs-cold/) — Active — рабочие данные на NVMe/HDD, доступ мгновенный, класс S3 Standard. Cold — архив на ленте… - [Durability и erasure coding](https://guru.activescale.ru/kb/basics/durability-and-erasure-coding/) — Durability — вероятность не потерять данные при отказах. ActiveScale использует erasure coding… - [Глоссарий ActiveScale](https://guru.activescale.ru/kb/basics/glossary/) — Ниже — рабочий словарь терминов, которые встречаются в GUI samurai, в выводе sherpa, в событиях и в… - [Объектное хранилище и NAS: в чём разница и когда NFS достаточно](https://guru.activescale.ru/kb/basics/object-storage-vs-nas/) — NAS отдаёт файлы и папки по NFS/SMB и масштабируется контроллером; объектное хранилище отдаёт… - [S3-совместимость ActiveScale](https://guru.activescale.ru/kb/basics/s3-compatibility/) — ActiveScale предоставляет S3-совместимый REST API (S3 Standard) и холодный класс, совместимый с S3… - [Что такое ActiveScale и зачем он нужен](https://guru.activescale.ru/kb/basics/what-is-activescale/) — Quantum ActiveScale — объектное хранилище для больших объёмов неструктурированных данных. Оно даёт… - [Планирование ёмкости: usable против raw](https://guru.activescale.ru/kb/design/capacity-planning/) — Заявленная ёмкость дисков (raw) никогда не равна ёмкости, которую увидит приложение. Часть съедает… - [Планирование холодного тира: лента, кассеты и бюджет restore](https://guru.activescale.ru/kb/design/cold-storage-sizing/) — Холодный класс ActiveScale хранит объекты на ленте и совместим с S3 Glacier: запись идёт… - [Формула политики DSS](https://guru.activescale.ru/kb/design/dss-policy-formula/) — Политика раскладки задаёт ширину полосы w и число фрагментов чётности s. Продукт требует w + s ≤ N… - [Сеть ActiveScale: роли портов и VLAN до установки](https://guru.activescale.ru/kb/design/network-roles-and-vlans/) — У ActiveScale три сети с разными задачами: management/public (управление и клиенты)… - [Стойка, питание и охлаждение: что проверить до монтажа](https://guru.activescale.ru/kb/design/rack-power-and-cooling/) — Требования площадки считаются до закупки и проверяются до монтажа: сколько юнитов занимает каждая… - [Федерация: путь A и путь B](https://guru.activescale.ru/kb/install/federation-path-a-b/) — Федеративная БД (federatedmodel) может жить внутри окружения (путь A) или в отдельной базовой… - [initialize: первый запуск модели через marvin_install](https://guru.activescale.ru/kb/install/initialize-marvin/) — Stage-2 (initialize) поднимает management-слой: пакеты, MongoDB, marvinweb, task manager. Запускает… - [Приёмка после установки: 11 проверок](https://guru.activescale.ru/kb/install/install-acceptance/) — Код возврата установщика ничего не доказывает: единственный надёжный признак завершения — маркер… - [install-ng: фазы, флаги и маркер завершения](https://guru.activescale.ru/kb/install/install-ng-phases/) — install-ng.py разворачивает модель и сервисы после initialize. Запускается от пользователя marvin… - [Чек-лист подготовки к установке](https://guru.activescale.ru/kb/install/install-preparation-checklist/) — Большинство проблем установки возникают до install-ng: сеть, MAC, профиль железа, BootOrder, NTP… - [Очередь установки: файлы, поля и ловушки](https://guru.activescale.ru/kb/install/install-queue/) — Очередь — это каталог /opt/ampli/apps/marvinbase/queue/ / с набором JSON/INI, из которого… - [Роли нод: SPXMGMT, SPXCTRLSTORAGE, SPXCTRLSTORAGEMGMT](https://guru.activescale.ru/kb/install/node-roles/) — Роль — поле role в документе машины модели, и оно определяет, какие приложения вообще будут… - [PXE и загрузка live AMUR: что должно работать, чтобы узел поднялся](https://guru.activescale.ru/kb/install/pxe-and-live-boot/) — Чтобы узел поднялся в live-среду по сети, нужны три независимые вещи: ProxyDHCP с TFTP… - [Stage-1: установка ОС через iso_installer](https://guru.activescale.ru/kb/install/stage1-os-install/) — Stage-1 — интерактивный мастер isoinstaller.py: он определяет профиль железа, раскладывает ОС на… - [CLI sherpa: базовые команды DSS/S3/IAM](https://guru.activescale.ru/kb/operate/cli-sherpa/) — /opt/ampli/bin/sherpa — вендорская инженерная консоль: это IPython (Python 2.7) с уже… - [Бэкап конфигурации и модели: что снимать перед изменениями](https://guru.activescale.ru/kb/operate/config-backup/) — «Конфигурация» ActiveScale — это модель в modeldb, очередь установки, groupvars плейбуков и файлы в… - [События и задачи: что значит LIVE, ARCHIVED и QUEUED](https://guru.activescale.ru/kb/operate/events-and-tasks/) — В ActiveScale два независимых журнала: события (modeldb.event) говорят о состоянии системы, задачи… - [GUI samurai: что где находится и почему картинка не сходится с моделью](https://guru.activescale.ru/kb/operate/gui-samurai-overview/) — Web-интерфейс ActiveScale System Management («samurai») — тонкая оболочка над моделью системы: он… - [IAM и resource policy: почему AccessDenied](https://guru.activescale.ru/kb/operate/iam-and-resource-policy/) — Аккаунт, пользователь и ключ созданы — но S3 отвечает 403 AccessDenied даже на листинг бакета… - [Model API: mTLS, GET/PUT и задачи](https://guru.activescale.ru/kb/operate/model-api-basics/) — Model API — REST-интерфейс к модели системы на порту 8443, только по mTLS: без клиентского… - [Мониторинг: Prometheus, Grafana и CBA — где смотреть метрики](https://guru.activescale.ru/kb/operate/monitoring-prometheus-grafana/) — Метрики ActiveScale идут по цепочке: экспортёр на каждой ноде (:1234/metrics) → Prometheus на… - [NTP и время: почему S3 отдаёт 403 при зелёном GUI](https://guru.activescale.ru/kb/operate/ntp-and-time/) — Подпись S3 (SigV4) содержит время запроса. Если часы ноды расходятся с часами клиента больше чем на… - [S3-домен, сертификат и DNS](https://guru.activescale.ru/kb/operate/s3-domain-and-tls/) — S3-фронт слушает 443 и терминирует TLS на узле. Клиент «не подключается» по трём независимым… - [Диск вышел из строя: замена, decommission и ввод нового](https://guru.activescale.ru/kb/maintain/disk-replacement-and-decommission/) — Замена диска в ActiveScale — не «выдернуть и вставить»: сначала диск надо вывести из раскладки… - [Вентиляторы NOTFOUND и лишние NIC: почему модель врёт и как это чинить](https://guru.activescale.ru/kb/maintain/fan-and-nic-model-hygiene/) — Два класса ложных тревог растут из одного места — из модели оборудования. BMC отдаёт алиасы… - [Узел живой? Полевой health-check за 30 секунд](https://guru.activescale.ru/kb/maintain/health-check-field/) — Полевой хелпер as-field-health.sh за ~30 секунд отвечает на вопрос «узел живой, время верное, S3… - [Как часто обслуживать ActiveScale и что именно проверять](https://guru.activescale.ru/kb/maintain/maintenance-regimen/) — ActiveScale обслуживает себя сам: DDR постоянно проверяет и ремонтирует данные, DSS ведёт фоновую… - [Апгрейд ActiveScale OS: с какой версии можно, как проверить и почему назад нельзя](https://guru.activescale.ru/kb/maintain/os-upgrade-planning/) — Апгрейд ActiveScale OS — необратимая операция: даунгрейда после него нет. Разрешённые пути описаны… - [Добавление ноды в кластер: scale-out без переустановки и без сюрпризов](https://guru.activescale.ru/kb/maintain/scale-out-add-node/) — Новая нода ставится только до stage-1 — без собственной федерации, иначе у неё будет свой… - [Кассеты «пропали», safety = 0: форма штрихкода и реестр кассет](https://guru.activescale.ru/kb/maintain/tape-cassettes-and-barcodes/) — Продукт сверяет кассеты по штрихкоду, но при чтении из библиотеки отбрасывает последние два знака… - [DISK_NOT_FOUND на SSD: ложная тревога чекера](https://guru.activescale.ru/kb/troubleshoot/disk-not-found-false/) — DISKNOTFOUND по SSD — чаще всего не отказ диска, а невозможность чекера продукта сопоставить диск… - [Пустая страница «Ресурсы» при зелёной плитке](https://guru.activescale.ru/kb/troubleshoot/empty-resources-page/) — Раздел «Ресурсы» в GUI рисует стойку по данным модели, и первым делом читает location.serial у… - [Лишние NIC сыплют NIC_DOWN](https://guru.activescale.ru/kb/troubleshoot/extra-nics-events/) — NICDOWN по портам без кабеля — не поломка: чекер считает состояние DOWN отказом, а порт просто не… - [GUI «не принимает пароль»: сначала латентность модели](https://guru.activescale.ru/kb/troubleshoot/gui-wrong-password-latency/) — Если вход в GUI samurai висит и обрывается, а пароль «не подходит», в большинстве случаев пароль… - [HAPROXY_DOWN: битый конфиг шлюза](https://guru.activescale.ru/kb/troubleshoot/haproxy-down/) — HAPROXYDOWN — CRITICAL «шлюз высокой доступности не поднялся, S3 на этой ноде затронут». Причины… - [install-ng: No suitable management server found](https://guru.activescale.ru/kb/troubleshoot/install-ng-no-management-server/) — install-ng падает на configuring machines failed: No suitable management server found, когда… - [MACHINE_DOWN при живой ноде: разорвано storage-кольцо](https://guru.activescale.ru/kb/troubleshoot/machine-down-storage-ring/) — MACHINEDOWN по ноде, которая пингуется и отвечает по SSH, почти всегда означает не отказ железа, а… - [mongod не поднялся: модель тормозит, GUI молчит](https://guru.activescale.ru/kb/troubleshoot/mongod-not-started/) — Model API и GUI читают модель из MongoDB; если mongod после включения не собрал реплика-сет, каждый… - [Узел красный / NOTCONFIGURED: с чего начать](https://guru.activescale.ru/kb/troubleshoot/node-red-notconfigured/) — NOTCONFIGURED — не поломка железа, а залипшее промежуточное состояние «идёт правка конфигурации»… - [NOTMANAGED на диске: капкан, а не статус](https://guru.activescale.ru/kb/troubleshoot/notmanaged-disks/) — NOTMANAGED на диске — не «промежуточное состояние», а ловушка: инвентаризация ставит его, когда… - [PSU/FAN NOT_FOUND: платформа не отдаёт датчики](https://guru.activescale.ru/kb/troubleshoot/psu-fan-not-found/) — PSUNOTFOUND и FANNOTFOUND приходят всплесками по 10–15 секунд и обычно не означают отказа питания… - [PXE не грузится](https://guru.activescale.ru/kb/troubleshoot/pxe-not-booting/) — Три частые причины: url= в casper не оканчивается на .iso (загрузка молча игнорируется), BMC… - [S3 403 «request time too large»: часы ноды, а не ключи](https://guru.activescale.ru/kb/troubleshoot/s3-403-time-skew/) — Подпись SigV4 живёт в окне ±15 минут: если системные часы ноды ушли дальше, любой подписанный… - [S3 501 на query-параметр: шлюз не знает этот параметр](https://guru.activescale.ru/kb/troubleshoot/s3-501-unknown-query/) — HEAD или GET с дополнительным query-параметром отдаёт 501 Not Implemented, а тот же запрос без… - [S3 507 Storage is full при свободных дисках](https://guru.activescale.ru/kb/troubleshoot/s3-507-storage-full/) — 507 Insufficient Storage на PUT — не про занятое место, а про решение раскладки: политика DSS не… - [S3 AccessDenied на листинг: у аккаунта нет resource policy](https://guru.activescale.ru/kb/troubleshoot/s3-access-denied-policy/) — Ключи и аккаунт созданы, бакет существует, GUI зелёный — а клиент получает 403 AccessDenied уже на… - [TAPE_CONNECTOR_UNAVAILABLE при живом коннекторе ленты](https://guru.activescale.ru/kb/troubleshoot/tape-connector-unavailable/) — Продукт строит адреса проверок коннектора ленты из поля tapeconnector.server, а это голый хост без… - [«Пропавшие» кассеты: библиотека их видит, продукт считает missing](https://guru.activescale.ru/kb/troubleshoot/tape-missing-cassettes/) — Продукт читает штрихкод из библиотеки и отбрасывает два последних символа (000281L8 → 000281), а… - [COLD_STORAGE_TAPE_SAFETY_EQUALS_ZERO](https://guru.activescale.ru/kb/troubleshoot/tape-safety-zero/) — Продукт рендерит схему ленты сам: spreadwidth = 2 плюс safety = 1 требуют трёх кассет в группах… - [Чек-листы: установка, приёмка, обслуживание, авария](https://guru.activescale.ru/kb/reference/checklists/) — Четыре коротких списка для поля: подготовка, установка, приёмка, авария. Каждый пункт — это гейт с… - [Словарь событий: имя → смысл → действие](https://guru.activescale.ru/kb/reference/event-names/) — Имя события в ActiveScale — это имя чекера, а не приговор железу. Часть CRITICAL-событий означает… - [Коды возврата и маркеры завершения](https://guru.activescale.ru/kb/reference/exit-codes-and-markers/) — Установка ActiveScale состоит из трёх независимых процессов с тремя разными маркерами… - [Частые вопросы по ActiveScale](https://guru.activescale.ru/kb/reference/faq/) — Десять вопросов, которые задают чаще всего: что это за система, чем отличаются классы, что значит… - [Флаги install-ng: словарь и ловушки](https://guru.activescale.ru/kb/reference/install-ng-flags/) — install-ng.py — не «одна кнопка установки», а набор фаз, каждая из которых включается своим флагом… - [Карта портов ActiveScale](https://guru.activescale.ru/kb/reference/ports-map/) — У ActiveScale три плоскости портов: управление (10443 GUI, 8443 Model API по mTLS), данные (443… - [Кейс: часы уехали — S3 отдаёт 403 всем клиентам при зелёном GUI](https://guru.activescale.ru/kb/cases/case-clock-skew/) — Кластер из трёх нод был здоров по GUI: узлы ONLINE, службы работают, внутренние запросы с самой… - [Кейс: федерация не смоделирована — install-ng падает на management server](https://guru.activescale.ru/kb/cases/case-federation/) — Кластер из трёх нод ставили с нуля. Первую ноду запустили с флагом scale-out — «на всякий случай… - [Кейс: узел не грузится с диска после stage-1 — Legacy вместо UEFI](https://guru.activescale.ru/kb/cases/case-pxe-uefi/) — Установка ОС прошла, установщик сделал жёсткий ребут — и узел «пропал»: не пингуется, не отвечает… - [Кейс: кассеты «пропали» из реестра — форма штрихкода и LTO-суффикс](https://guru.activescale.ru/kb/cases/case-tape-barcode/) — В ленточной библиотеке кассеты на месте, а продукт считает их отсутствующими и показывает safety =… ## Правила цитирования - Вендорские факты — со ссылкой на Quantum; наши замеры — с условиями. - Товарные знаки Quantum, ActiveScale принадлежат Quantum. - Сайт не является официальным сайтом вендора.