如何无需导出导入将Artifactory二进制存储从文件系统迁移至分片？

1. 是否无需导出/导入二进制文件即可修改binarystore.xml？ #

可以。通过state-aware类型的存储提供者，Artifactory能够直接识别并访问原有磁盘上已存在的二进制文件，无需通过导出/导入的方式迁移数据，只需正确配置新的存储链即可。

2. 给出的配置是否可行？ #

该配置整体可行，但需注意以下细节：

配置合理性分析 #

• 版本兼容：使用version="4"符合Artifactory 7.x的配置规范，适配当前7.55.9版本。
• 存储链结构：cache-fs + sharding + state-aware的组合设计合理：
  • cache-fs用于本地缓存，提升文件读写性能；
  • sharding实现多磁盘分片存储，percentageFreeSpace写入策略会优先将新文件写入剩余空间更多的磁盘，刚好适配旧磁盘空间耗尽的场景；
  • state-aware提供者可直接识别原有磁盘的文件结构，无需迁移历史数据。
• 路径配置：
  • disk1的fileStoreDir指向原有二进制文件的实际存储路径/var/opt/jfrog/artifactory/data/data，与原配置的baseDataDir+fileStoreDir完全匹配，配置正确；
  • disk2的路径指向新磁盘目录，符合新增存储的需求。

关键操作注意事项 #

• 修改前必须停服：热修改binarystore.xml会导致数据损坏，务必先停止Artifactory服务再修改配置。
• 确保新磁盘目录权限正确：为新磁盘目录设置Artifactory运行用户（通常为jfrog）的读写权限，示例命令：

  mkdir -p /disk2/artifactory/shard-fs-2
  chown -R jfrog:jfrog /disk2/artifactory/shard-fs-2
  chmod -R 755 /disk2/artifactory/shard-fs-2
  

• 备份原有配置：修改前复制一份原binarystore.xml作为备份，避免配置错误导致服务无法启动。
• 启动后验证：启动Artifactory后，检查日志文件（/var/opt/jfrog/artifactory/logs/artifactory.log）确认无存储相关报错，同时测试原有文件和新上传文件的可访问性。
• 清理旧磁盘空间：切换配置后，新文件会优先写入新磁盘，但历史文件仍在旧磁盘。后续可通过Artifactory的清理任务删除未被引用的二进制文件，释放旧磁盘空间。

内容的提问来源于stack exchange，提问作者Sergey Kuznetsov