Product 关闭

知识库:解决磁盘空间不足导致的 Enterprise Server 搜索索引不完整错误

Altium On-Prem Enterprise Server Altium On-Prem Enterprise Server
Enterprise Server 上的搜索索引不完整,可能导致用户在 Altium Designer 中找不到元件。运行状况监视器通常会显示 Vault 修订版数量与搜索索引修订版数量不一致。此问题是由于磁盘空间不足,导致 Elasticsearch 切换到只读模式以防止数据损坏。 解决方法包括释放磁盘空间、必要时扩容,以及对 Vault 执行完整的索引重建。预防措施包括监控磁盘空间、归档旧日志,以及配置 Elasticsearch 的磁盘水位阈值。

解决方案详情

客户发现 Altium Designer 中缺少元件。检查 Enterprise Server 后发现,健康监视器中存在搜索索引错误。尝试重建索引未能解决问题;搜索索引修订版本数始终低于 Vault 修订版本数(例如,Vault 修订版本数:29,112;搜索索引修订版本数:7,842)。

Root Cause

磁盘空间不足导致 Elasticsearch 超过磁盘高水位阈值(约 95%),迫使其进入只读模式并阻止索引操作。以下错误表明了这一情况:

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

Solution Steps

要解决此问题:

  • 检查服务器安装盘(通常为 C:)的磁盘空间。
  • 删除临时文件,并将旧日志移至其他驱动器,以释放空间。
  • 如有需要,在 IT 人员的协助下使用 Windows 磁盘管理工具扩展磁盘容量。
  • 对服务器内容执行完整的索引重建。
  • 检查健康监视器,确保搜索索引修订版本数与 Vault 修订版本数一致。

Detailed Resolution Procedure

Verify Disk Space

  1. 打开文件资源管理器 » 右键单击系统盘(通常为 C:)» 选择“属性”。
  2. 确保至少有 10–15 GB 的可用空间供索引操作使用。

Check Enterprise Server Health Monitor

  1. 在 Enterprise Server 界面中导航至服务器健康监视器。
  2. 确认错误消息为“搜索索引不完整”,并比较修订版本数。

Review Elasticsearch Logs

  1. 在 Enterprise Server 安装文件夹中找到搜索服务日志。
  2. 查找 cluster_block_exception 或“索引只读 / 允许删除”警告。

Free Up Disk Space

  1. 删除不需要的临时文件和旧备份。 
  2. 将已归档的日志文件从安装文件夹移至其他驱动器。
  3. 使用 Windows 中的磁盘清理工具进行进一步清理。

Increase Disk Space (If Needed)

  1. 联系 IT 团队,使用磁盘管理工具扩展磁盘容量:
  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. 索引重建完成后,再次检查健康监视器。
  2. 确保搜索索引修订版本数与 Vault 修订版本数一致。“搜索索引:”旁应显示绿色勾号。 

Preventive Tips

  • 定期监控磁盘空间并设置警报。
  • 配置 Elasticsearch 磁盘水位阈值。
  • 定期归档旧日志和不再使用的数据。
  • 根据 Vault 的增长情况规划磁盘容量。
  • 自动清理临时文件和备份。
  • 定期检查 Enterprise Server 健康监视器中的资源警告。
  • 为索引重建和磁盘空间管理制定并维护书面的标准操作规程(SOP)。

Maintenance Schedule Recommended - Example

为防止今后出现问题,请按计划执行维护。以下是一个示例。

  • Weekly: 检查服务器安装盘的磁盘空间。查看健康监视器中是否存在警告。
  • Monthly: 将旧日志和备份归档至辅助存储。运行磁盘清理工具以删除临时文件。
  • Quarterly: 验证 Elasticsearch 水位设置。检查 Vault 的增长情况,并根据需要调整磁盘容量。
  • Annually: 执行全面的系统健康审核,包括磁盘空间、索引性能和备份完整性。

Additional Notes

⚠️ Warnings & Best Practices:

  • 在使用量较低的时段执行:索引重建可能需要较长时间,并且可能影响搜索功能。
  • 开始前先备份:删除任何文件之前,务必为服务器创建完整备份。
  • 请勿中断过程:索引重建开始后,请等待其完成,以免造成数据不一致。
  • 定期监控磁盘空间:保持充足的可用空间,防止 Elasticsearch 进入只读模式。

Related Articles

AI-LocalizedAI 翻译
如您发现任何问题,请选中相关文本/图片,并按 Ctrl + Enter 键向我们提交反馈。