АРХИВА 10 Help

Тома

Общее описание

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

Том — это логическая единица представления данных, которая упрощает управление ими.

Он состоит из двух основных компонентов:

  • Хранилища, где сами данные хранятся в сжатом и зашифрованном виде;

  • Индекса, который представляет собой структуру для быстрого поиска нужной информации.

Для управления томами и их настройки перейдите в раздел Настройка -> Тома в консоли сервиса.

Установить пароль для шифрования почты

  1. Перейдите в раздел Настройка -> Тома в консоли сервиса

  2. Введите пароль для шифрования почты в первое поле, а затем повторите его ввод во втором поле.

  3. После проверки правильности ввода нажмите Сохранить

При создании тома вы можете указать любое место на файловой системе для размещения хранилища и индекса. Если выбран формат хранения EXTERNAL, необходимо указать UID клиента хранилища объектов.

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

  • Пути к хранилищу и индексу не должны пересекаться с путями других томов.

  • Если указанный путь не существует, он будет создан автоматически.

Создание нового тома

  1. Перейдите в раздел Настройка -> Тома в консоли сервиса

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

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

  4. После проверки данных нажмите Сохранить

Автоматическое переключение

Вы можете настроить АРХИВА на автоматическое создание и переход на новые тома через определенные интервалы времени (ежемесячно, ежеквартально, ежегодно). Это позволяет систематизировать информацию в хронологическом порядке.

При переключении система автоматически формирует пути к новому индексу и хранилищу на основе путей последнего активного или созданного тома.

Доступны два способа формирования путей:

  • По дате. В конец строки пути добавляется дата в формате YYYYMM (например, /opt/vol/store/vol202406 и /opt/vol/index/vol202406). Следующий том получит новую дату. Если путь уже существует, в конце будет добавлена буква (например, store/vol202406a, store/vol202406b), чтобы сохранить шаблон. Поиск даты осуществляется по регулярному выражению (.*\\D)([0-9]{6,6})([a-z]{0,1}).*$

  • По номеру. К строке пути добавляется порядковый номер (например, /opt/vol/store/vol1). Для следующего тома номер будет увеличен (.../store/vol2 и т.д.), согласно регулярному выражению (.*\\D)(\\d{1,3})$.

Варианты переключения:

  • По размеру — переход на новый том при достижении установленного лимита объема.

  • Ежемесячно — переход на новый том каждый месяц.

  • Ежеквартально — переход на новый том каждую четверть года.

  • Ежегодно — переход на новый том каждый год.

Для успешного переключения должны быть выполнены следующие условия:

  • В системе имеется хотя бы один активный или закрытый том.

  • Новые пути доступны для записи и обладают достаточным свободным местом.

  • По предполагаемым путям отсутствуют существующие хранилища или индексы.

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

Если активный том переполнен, система автоматически переключится на следующий доступный том со статусом UNUSED. Если такая опция включена, АРХИВА самостоятельно создаст новый том, обеспечивая непрерывность работы.

Вновь созданный том получает статус NEW. После сохранения конфигурации статус меняется на UNUSED.

В момент начала архивирования система выбирает том со статусом UNUSED с наивысшим приоритетом и переводит его в состояние ACTIVE. Данные записываются в этот том до тех пор, пока не закончится место на диске или пока администратор не закроет том вручную.

Поиск осуществляется по всем томам со статусами ACTIVE и CLOSED.

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

Хранилище

Все сообщения электронной почты хранятся в зашифрованном виде с использованием алгоритма AES-256 (форматы: V3, EXTERNAL).

Формат хранения

Формат хранения определяет способ организации данных внутри тома.

Изменить формат хранения

  1. Настройте клиента хранилища объектов

  2. Перейдите в раздел Настройка | Основной | Архив в консоли сервиса

  3. Выберите желаемый Новый формат тома из списка

  4. Нажмите Сохранить

V3, EXTERNAL

  • Данные хранятся в отдельных файлах (blob-контейнерах). Имя файла представляет собой хэш сообщения. Пример пути: 12/34/1234567890abcdefghijk.

  • Blob-контейнер — это сжатый файл, зашифрованный AES256 и содержащий системные заголовки.

  • Структура папок представляет собой сбалансированное дерево (162 на первом уровне, 162 на втором), что дает в сумме 65 536 папок. Общее количество inode равно 65 536 плюс количество blob-контейнеров.

  • В формате EXTERNAL вместо локальной файловой системы используется бакет облачного хранилища.

Устаревшие форматы V1, V2

  • V1 - Данные (.mrc) и вложения (.att) хранятся в разных файлах. Имя файла — хэш сообщения. Пример пути: 123/456/1234567890abcdefghijk.mrc. Шифрование TripleDES. Доступен только для чтения.

  • V2 - Данные хранятся в zip-контейнерах (.zz), максимум 4096 контейнеров. Шифрование AES128. Доступен только для чтения.

Использование внешних хранилищ объектов

АРХИВА поддерживает архивацию в современные хранилища объектов, такие как Yandex S3, VK S3, Backblaze B2, Amazon S3/Glacier, EMC Atmos, OpenStack Swift, Azure Blob Storage, Azure Archival Storage, Rackspace Cloud Files, Minio и другие сервисы, работающие по протоколу S3.

Мастер установки АРХИВА по умолчанию создает локальный том формата V3. Система может одновременно работать как с локальными, так и с удаленными томами.

Вы можете использовать множество удаленных томов на разных облачных сервисах. Расположение данных регулируется UID клиента хранилища объектов, настроенным в параметрах тома.

Изменить формат хранения

  1. Настройте клиента хранилища объектов

  2. Перейдите в раздел Настройка | Основной | Архив в консоли сервиса

  3. Выберите Новый формат тома EXTERNAL

  4. Нажмите Сохранить

  5. Перейдите в раздел Настройка | Тома в консоли сервиса

  6. Создайте новый том, выбрав соответствующий UID клиента хранилища объектов. При вводе пути к хранилищу используйте кнопку со стрелкой вниз для выбора подключения. Для индекса укажите локальный путь на диске, так как индексные данные не предназначены для объектных хранилищ.

  7. Нажмите Сохранить

Индекс

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

Статус тома

Статус

Описание

NEW

Том только что создан и ещё не сохранён.

UNUSED

Том сохранён, но не содержит никаких данных.

ACTIVE

Текущий активный том, в который записываются новые данные архивации.

CLOSED

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

UNMOUNTED

Том временно отключен. Поиск по нему недоступен до повторного монтирования.

EJECTED

Критическая ошибка: файл volumeinfo отсутствует или недоступен из-за проблем с правами доступа.

BACKUP

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

UNREADABLE

Том не читается. Вероятная причина — использование другого ключа шифрования при создании.

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

Если активный том (ACTIVE) становится недоступным, АРХИВА попытается автоматически активировать следующий доступный том со статусом UNUSED. Если подходящий том не будет найден, архивирование остановится, а новые сообщения будут накапливаться в очереди до её заполнения.

Файл volumeinfo

Этот файл содержит критически важную системную информацию о томе. Ручное редактирование файла не предусмотрено.

Расположение файла зависит от формата тома:

  • В папке с индексом — для формата EXTERNAL;

  • В папке с хранилищем — для всех остальных форматов.

# Archiva Volume Volume Information # note: this file is crucial - do not delete it! format:V3 id:effee159-7ab4-4ffe-bee1-597ab40ffe82 status:ACTIVE appid:ROOT created:20240216183659 sig:r5Mx6tcRv5/xR83ajBnSazjjPTLG091vAUClLqqeSJUG38rFoThX8g==

Действия с томом

volume_action.png

В зависимости от текущего статуса тома, доступны следующие операции:

  • Закрыть: статус меняется на CLOSED, запись новых данных в том прекращается.

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

  • Экспорт данных: выгрузка данных тома в формате RFC822 на локальный диск.

  • Резервная копия: создание копии тома согласно настройкам в разделе бекапа.

  • Построить аналитику: запуск генерации индексов для модуля аналитики.

  • Переиндексировать: полное удаление текущих индексов тома и их создание заново на основе данных хранилища.

  • Обновить индекс: частичное обновление индексов без их удаления. Данные остаются доступными для поиска в процессе обновления.

  • Отмонтировать: перевод тома в статус UNMOUNTED. Поиск по такому тому становится недоступен.

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

Объединить тома

  1. Выберите несколько томов, которые необходимо объединить, включая целевой том (куда будут перенесены данные).

  2. Нажмите кнопку Слить.

  3. Подтвердите выбор целевого тома для слияния.

  4. Нажмите кнопку Слить повторно для запуска процесса.

Подключение недоступного тома

Тома в АРХИВА шифруются с использованием парольной фразы, заданной при установке. Если том стал недоступен, его можно подключить двумя способами:

  • используя оригинальный файл server.conf (см. вариант a);

  • зная исходную текстовую парольную фразу (см. вариант b).

a) Подключение тома с использованием парольной фразы из старого server.conf

Если у вас сохранился файл server.conf, который использовался при создании тома:

  1. Убедитесь, что том отключён (нажмите Отключить в разделе Настройки → Тома).

  2. Откройте старый файл server.conf в текстовом редакторе и скопируйте значение параметра security.passphrase. Пример:

    security.passphrase=rtQAVHuVq3RejKo5ViHRsttwImTOUjyM/6B72uA+amU=

  3. Откройте файл volumeinfo в корне каталога тома.

  4. Добавьте в файл строку с параметром:

    passphrase:rtQAVHuVq3RejKo5ViHRsttwImTOUjyM/6B72uA+amU=

  5. Удалите строку signature (если она присутствует) и сохраните файл.

  6. Подключите том в разделе Настройки → Тома или импортируйте его заново.

Пример итогового содержимого файла volumeinfo:

# Archiva 9.3.5 Volume Information # note: this file is crucial - do not delete it! format:V3 id:0127fb21-bab3-418b-8766-6ffac67a3a1c status:CLOSED passphrase:rtQAVHuVq3RejKo5ViHRsttwImTOUjyM/6B72uA+amU= created:20121120074936

b) Подключение тома с использованием текстовой парольной фразы

Если вам известна исходная парольная фраза в открытом виде:

  1. Убедитесь, что том отключён (нажмите Отключить в разделе Настройки → Тома).

  2. Откройте файл volumeinfo в корне каталога тома.

  3. Добавьте строку с параметром:

    passphrase:[plaintext-password]

    (замените [plaintext-password] на вашу фактическую парольную фразу).

  4. Удалите строку signature (если она есть) и сохраните файл.

  5. Подключите том в разделе Настройки → Тома или импортируйте его заново.

Несовместимый формат тома

В редких случаях АРХИВА может не считать данные из-за некорректно указанного формата в метаданных.

  • Если в каталоге тома присутствуют файлы с расширением .zz, установите в файле volumeinfo значение format:V2.

  • Если в подкаталогах находятся файлы .MRC, укажите format:V1.

  • В большинстве остальных случаев используйте format:V3.

  • Если доступ к данным всё ещё ограничен, попробуйте установить format:V0.

Пример содержимого файла volumeinfo:

# Archiva 10.0.0 Volume Information # note: this file is crucial - do not delete it! format:V0 id:0127fb21-bab3-418b-8766-6ffac67a3a1c status:CLOSED created:20121120074936
24 August 2026
ДоменыАвторизация