Проблемы индексации

Решение Проблем с Индексацией

1. Введение

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

2. Недостаточно Дискового Места

Симптом

Не запускается или останавливается индексация.
Система выдает ошибку: "невозможно начать индексирование".

Решение

Проверьте, достаточно ли свободного места на диске сервера.
Если место ограничено:

Очистите ненужные файлы.
Расширьте ёмкость хранилища.
Переместите индексы на диск с большим объёмом.

3. Ошибка "Не удалось начать индексирование" (failed to start index)

Симптом

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

Решение

Запишите путь к индексу из предупреждения.
Остановите сервер АРХИВА.
Удалите содержимое папки индексов для неисправного тома:
- Через проводник или командную строку (например, rm -rf * в bash).
Запустите сервер снова.
Выполните переиндексацию проблемного тома через интерфейс АРХИВА.

4. Неверный Пароль Шифрования

Симптом

Переиндексация завершается с нулевым количеством сообщений.
В логе (debug.log) появляются ошибки шифрования.

Причина

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

Решение

Убедитесь, что все тома зашифрованы одним и тем же паролем, указанным в разделе Настройка → Тома.
Если это не так, перешифруйте данные с использованием правильного пароля.
- Подробнее см. раздел [Перешифрование тома].

5. Неверная Версия Формата Тома

Симптом

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

Причина

Неверно указана версия формата тома в файле volumeinfo.

Решение

Откройте файл volumeinfo в корне пути к хранилищу тома.
Убедитесь, что указано:
- V1 — если в хранилище нет файлов .zz.
- V2 — если в хранилище есть файлы .zz.
Сохраните изменения.
Перезапустите сервер.
Выполните переиндексацию тома.

6. Ошибка: "Не удалось снять блокировку"

Симптом

В логе переиндексации появляется ошибка:
2014-05-06 12:53:55,669 reindex 125482f9c75bb851 failed: attempt to unlock read lock, not locked by current thread

Причина

Известная проблема в версии АРХИВА v3.8.20.

Решение

Обновите АРХИВА до версии 3.8.21 или выше.

7. Медленная Переиндексация

Возможные Причины и Решения

Причина	Решение
Медленный диск	Убедитесь, что индексы находятся на быстрых дисках SAS или SSD.
Недостаток оперативной памяти	Проверьте, что `АРХИВА` имеет достаточный объем RAM и параметры памяти настроены правильно.
Индексация вложений	Отключите индексацию вложений, если она не требуется, во вкладке Настройка → Настройки индекса.
Устаревшая версия	Обновите `АРХИВА` до последней доступной версии.

8. Заключение

Правильная работа индексации в АРХИВА критически важна для производительности и функциональности системы.
Большинство проблем можно решить путём проверки дискового пространства, актуальности версии, корректности настроек шифрования и формата тома.

15 May 2025