KLVD: Обслуживание
Документация Клавдия: klvd: обслуживание.
Ежедневный контроль
Администрирование архива
Поиск и индексирование
Проверка состояния поиска
Меню → [Общие настройки → Поиск (Solr)] · Маршрут: #settings/search-admin Как проверить состоян...
Переиндексация архива
{{ВИДЕО}} Нажмите [Реиндексировать ВСЁ]. Подтвердите. Переиндексация выполняется в фоне — перест...
Настройка производительности индексирования
Индексатор (задача archive.search.index) — отдельный шаг конвейера: импортёр сохраняет письмо и с...
Кластер и масштабирование
Проверка состояния узлов
Здесь управляется топология кластера Клавдия: состав узлов, их роли, вес, лимиты и размещение слу...
Изменение ролей и конфигурации узла
Нажмите по плитке узла, затем откройте редактирование. Укажите: Название (или оставьте автомат...
Добавление узла
Перед началом Добавление Linux-узла в существующий кластер Используйте каноническую установоч...
Хранилища
Проверка состояния хранилищ
В таблице групп найдите бейдж статуса: Статус Значение Здорова живых узлов больше требуемо...
Реакция на пропажу узла хранения
Откройте группу на редактирование. В блоке задайте: Пороги по времени: 1 / 5 / 30 / 60 минут. ...
Перераспределение данных между узлами
В строке группы выберите действие [Перераспределить] (кнопка доступна, когда группе требуется пе...
Вывод узла хранения из группы
{{ВИДЕО}} Чтобы безопасно отключить узел хранения (выключить контейнер/сервер) без потери данных,...
Автоматическое восстановление реплик
При обнаружении повреждённого или отсутствующего блока во время deep-health система автоматически...
Ротация ключа шифрования хранилища
{{ВИДЕО}} Ротация ключа шифрования группы хранилищ — регламентная операция, которую рекомендуется...
База данных
Проверка состояния PostgreSQL
Клавдий хранит все данные в реляционной базе данных: настройки, состояние задач, письма, очередь ...
Что делать при исчерпании пула соединений
Увеличьте размер пула (параметр в общих настройках или переменная окружения). Проверьте отсутств...
Контроль миграций и метрик базы данных
Изменения структуры базы (миграции) применяются автоматически при старте узла: если версия схемы ...
Резервное копирование и восстановление
Что необходимо резервировать
Регулярное резервное копирование защищает от потери данных при сбое оборудования, ошибке админист...
Резервная копия PostgreSQL
Локальная PostgreSQL (docker-compose) # Дамп базы (все метаданные, настройки, письма) docker exec...
Резервная копия хранилища писем
# Файловый резервная копия папки хранилища (инкрементально) rsync -a /opt/klvd/data-storage/ /bac...
Резервная копия конфигурации, ключей и сертификатов
Сохраняйте вместе с резервной копией системы конфигурацию запуска, каталог секретов и используемы...
Полное восстановление системы
{{ВИДЕО}} Остановите узел: cd /opt/klvd docker compose down Восстановите секретный ключ в se...
Восстановление отдельных писем
Для восстановления отдельных писем (не из резервной копии, а из архива в почтовый ящик) используй...
Обновление
Обновление системы
Перед началом Что необходимо резервировать Перед обновлением создайте актуальную резервную ко...
Обновление Docker Compose-инсталляции
Перед началом Что необходимо резервировать {{ВИДЕО}} Обновление узла Клавдия до новой версии....
Обновление многоузлового кластера Docker Compose
Перед началом Что необходимо резервировать В многоузловом кластере Docker Compose обновляйте ...
Обновление Kubernetes
Обновление в Kubernetes — это смена версии helm-чарта: helm upgrade klvd oci://registry-ru-2.afi-...
Проверка после обновления
docker-compose: docker compose ps — все контейнеры в статусе Up. В логах docker logs klvd-node ...
Безопасность и сертификаты
Проверка защиты данных и аудита
Меры защиты данных в Клавдии: шифрованные каналы связи, шифрование паролей в базе, контроль целос...
Проверка TLS на каналах Клавдия
Клавдий использует TLS для всех каналов: веб-интерфейс, серверы IMAP и SMTP, внутрикластерный тра...
Замена TLS-сертификата
{{ВИДЕО}} Загрузите новый сертификат в веб-интерфейсе ([Общие настройки → TLS-сертификат → Загру...
Диагностика
С чего начинать диагностику
Сводка типовых проблем: как их обнаружить и устранить. Основной инструмент диагностики — панель с...
Типовые симптомы и решения
{{ВИДЕО}} Источник не собирает письма Признак: карточка источника или задача сбора показывает о...
Утилиты командной строки
Назначение Справочник по командам для эксплуатации Клавдия: доступ к базе данных, управление конт...