База знаний: устранение ошибки неполного поискового индекса Enterprise Server, вызванной нехваткой места на диске

Altium On-Prem Enterprise Server Altium On-Prem Enterprise Server
Пользователи могут столкнуться с тем, что некоторые компоненты не отображаются в Altium Designer из-за неполного поискового индекса на сервере Enterprise Server. При этом Health Monitor обычно показывает несоответствие между количеством ревизий в хранилище и в поисковом индексе. Эта проблема возникает при нехватке места на диске: Elasticsearch переходит в режим «только чтение», чтобы предотвратить повреждение данных. Для устранения проблемы необходимо освободить место на диске, при необходимости увеличить его ёмкость и выполнить полную переиндексацию хранилища. Для предотвращения подобных ситуаций рекомендуется контролировать свободное место на диске, архивировать старые журналы и настраивать пороговые значения заполнения диска в Elasticsearch.

Подробности решения

Заказчик обнаружил, что в Altium Designer отсутствуют компоненты. При проверке Enterprise Server в мониторе состояния (Health Monitor) была выявлена ошибка поискового индекса. Попытки переиндексации не устранили проблему: количество ревизий в поисковом индексе оставалось меньше количества ревизий в хранилище (например, ревизий в хранилище: 29 112; ревизий в поисковом индексе: 7 842).

Root Cause

Из-за нехватки места на диске Elasticsearch превысил верхний порог заполнения диска (~95%), что привело к переходу в режим «только чтение» и блокировке операций индексирования. На это указывает ошибка:

cluster_block_exception reason: blocked by :[FORBIDDEN/12/Index read-only / allow delete].

Solution Steps

Чтобы устранить проблему:

  • Проверьте свободное место на диске, на котором установлен сервер (обычно C:).
  • Освободите место, удалив временные файлы и переместив старые журналы на другой диск.
  • При необходимости увеличьте емкость диска с помощью средства «Управление дисками» Windows, обратившись за помощью в ИТ-отдел.
  • Выполните полную переиндексацию содержимого сервера.
  • Проверьте в Health Monitor, что количество ревизий в поисковом индексе совпадает с количеством ревизий в хранилище.

Detailed Resolution Procedure

Verify Disk Space

  1. Откройте Проводник » Щелкните правой кнопкой мыши системный диск (обычно C:) » Выберите «Свойства».
  2. Обеспечьте не менее 10–15 ГБ свободного места для операций индексирования.

Check Enterprise Server Health Monitor

  1. Откройте Server Health Monitor в интерфейсе Enterprise Server.
  2. Убедитесь в наличии сообщения об ошибке «Search index incomplete» (Поисковый индекс неполон) и сравните количество ревизий.

Review Elasticsearch Logs

  1. Найдите журналы службы поиска в папке установки Enterprise Server.
  2. Найдите сообщения cluster_block_exception или предупреждения «Index read-only / allow delete».

Free Up Disk Space

  1. Удалите ненужные временные файлы и старые резервные копии. 
  2. Переместите архивные файлы журналов из папки установки на другой диск.
  3. Для дополнительной очистки используйте средство «Очистка диска» Windows.

Increase Disk Space (If Needed)

  1. Обратитесь в ИТ-отдел для увеличения емкости диска с помощью средства «Управление дисками»:
  2. Откройте окно «Выполнить» » Введите diskmgmt.msc » Выберите системный том » Выберите «Расширить том».

Perform Full Reindex

Чтобы переиндексировать содержимое сервера (например, после переноса данных):

  1. Остановите пулы приложений IIS, связанные с локальным сервером.
  2. Остановите службу AltiumElasticSearch.
  3. Удалите содержимое папки SearchData:
    Для Concord Pro:
    C:\ProgramData\Altium\ConcordProData\SearchData
    Для устаревшего Vault:
    C:\ProgramData\Altium\VaultServerData\SearchData
  4. Перезапустите службу AltiumElasticSearch.
  5. Перезапустите пулы приложений IIS.

Сервер автоматически перестроит поисковый индекс, когда обнаружит пустую папку SearchData.
(Время перестроения зависит от размера базы данных; во время этого процесса работа поиска может быть ограничена.)
Подробные инструкции см. в статье: База знаний: устранение проблем после обновления локального сервера и переноса данных

Validate Index Status

  1. После переиндексации снова проверьте Health Monitor.
  2. Убедитесь, что количество ревизий в поисковом индексе совпадает с количеством ревизий в хранилище. Рядом с надписью «Search Index:» должна отображаться зеленая галочка. 

Preventive Tips

  • Регулярно проверяйте свободное место на диске и настройте оповещения.
  • Настройте пороговые значения заполнения диска для Elasticsearch.
  • Периодически архивируйте старые журналы и неиспользуемые данные.
  • Планируйте емкость диска с учетом роста хранилища.
  • Автоматизируйте очистку временных файлов и резервных копий.
  • Регулярно проверяйте Health Monitor в Enterprise Server на наличие предупреждений о ресурсах.
  • Поддерживайте в актуальном состоянии документированную стандартную рабочую процедуру (SOP) переиндексации и управления дисковым пространством.

Maintenance Schedule Recommended - Example

Чтобы предотвратить проблемы в будущем, соблюдайте график обслуживания. Ниже приведен пример.

  • Weekly: Проверьте свободное место на диске, на котором установлен сервер. Проверьте Health Monitor на наличие предупреждений.
  • Monthly: Перенесите старые журналы и резервные копии в архив на дополнительном носителе. Запустите средство «Очистка диска», чтобы удалить временные файлы.
  • Quarterly: Проверьте настройки порогов заполнения диска для Elasticsearch. Оцените рост хранилища и при необходимости увеличьте емкость диска.
  • Annually: Выполните полную проверку состояния системы, включая свободное место на диске, производительность индексирования и целостность резервных копий.

Additional Notes

⚠️ Warnings & Best Practices:

  • Выполняйте работы в часы низкой нагрузки: переиндексация может занять некоторое время и повлиять на работу поиска.
  • Создайте резервную копию перед началом работ: всегда создавайте полную резервную копию сервера перед удалением любых файлов.
  • Не прерывайте процесс: после запуска переиндексации дождитесь ее завершения, чтобы избежать несогласованности данных.
  • Регулярно проверяйте свободное место на диске: поддерживайте достаточный объем свободного места, чтобы предотвратить переход Elasticsearch в режим «только чтение».

Related Articles

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.